gtk_rc_scanner_new ()

GScanner *
gtk_rc_scanner_new (void);

gtk_rc_get_style ()

GtkStyle *
gtk_rc_get_style (GtkWidget *widget);

Finds all matching RC styles for a given widget, composites them together, and then creates a GtkStyle representing the composite appearance. (GTK+ actually keeps a cache of previously created styles, so a new style may not be created.)

gtk_rc_get_style_by_paths ()

GtkStyle *
gtk_rc_get_style_by_paths (GtkSettings *settings,
                           const char *widget_path,
                           const char *class_path,
                           GType type);

Creates up a GtkStyle from styles defined in a RC file by providing the raw components used in matching. This function may be useful when creating pseudo-widgets that should be themed like widgets but don't actually have corresponding GTK+ widgets. An example of this would be items inside a GNOME canvas widget.

The action of gtk_rc_get_style() is similar to:

1
2
3
4
5

gtk_widget_path (widget, NULL, &path, NULL);
gtk_widget_class_path (widget, NULL, &class_path, NULL);
gtk_rc_get_style_by_paths (gtk_widget_get_settings (widget), 
                           path, class_path,
                           G_OBJECT_TYPE (widget));

gtk_rc_add_widget_name_style ()

void
gtk_rc_add_widget_name_style (GtkRcStyle *rc_style,
                              const gchar *pattern);

gtk_rc_add_widget_class_style ()

void
gtk_rc_add_widget_class_style (GtkRcStyle *rc_style,
                               const gchar *pattern);

gtk_rc_add_class_style ()

void
gtk_rc_add_class_style (GtkRcStyle *rc_style,
                        const gchar *pattern);

gtk_rc_parse_string ()

void
gtk_rc_parse_string (const gchar *rc_string);

gtk_rc_reparse_all ()

gboolean
gtk_rc_reparse_all (void);

If the modification time on any previously read file for the default GtkSettings has changed, discard all style information and then reread all previously read RC files.

gtk_rc_reparse_all_for_settings ()

gboolean
gtk_rc_reparse_all_for_settings (GtkSettings *settings,
                                 gboolean force_load);

If the modification time on any previously read file for the given GtkSettings has changed, discard all style information and then reread all previously read RC files.

gtk_rc_reset_styles ()

void
gtk_rc_reset_styles (GtkSettings *settings);

This function recomputes the styles for all widgets that use a particular GtkSettings object. (There is one GtkSettings object per GdkScreen, see gtk_settings_get_for_screen()); It is useful when some global parameter has changed that affects the appearance of all widgets, because when a widget gets a new style, it will both redraw and recompute any cached information about its appearance. As an example, it is used when the default font size set by the operating system changes. Note that this function doesn't affect widgets that have a style set explicitely on them with gtk_widget_set_style().

Since: 2.4

gtk_rc_get_default_files ()

gchar **
gtk_rc_get_default_files (void);

Retrieves the current list of RC files that will be parsed at the end of gtk_init().

gtk_rc_parse_color ()

guint
gtk_rc_parse_color (GScanner *scanner,
                    GdkColor *color);

Parses a color in the format expected in a RC file.

Note that theme engines should use gtk_rc_parse_color_full() in order to support symbolic colors.

gtk_rc_parse_color_full ()

guint
gtk_rc_parse_color_full (GScanner *scanner,
                         GtkRcStyle *style,
                         GdkColor *color);

Parses a color in the format expected in a RC file. If style is not NULL, it will be consulted to resolve references to symbolic colors.

Since: 2.12

gtk_rc_parse_state ()

guint
gtk_rc_parse_state (GScanner *scanner,
                    GtkStateType *state);

gtk_rc_parse_priority ()

guint
gtk_rc_parse_priority (GScanner *scanner,
                       GtkPathPriorityType *priority);

gtk_rc_find_module_in_path ()

gchar *
gtk_rc_find_module_in_path (const gchar *module_file);

Searches for a theme engine in the GTK+ search path. This function is not useful for applications and should not be used.

gtk_rc_find_pixmap_in_path ()

gchar *
gtk_rc_find_pixmap_in_path (GtkSettings *settings,
                            GScanner *scanner,
                            const gchar *pixmap_file);

Looks up a file in pixmap path for the specified GtkSettings. If the file is not found, it outputs a warning message using g_warning() and returns NULL.

gtk_rc_get_module_dir ()

gchar *
gtk_rc_get_module_dir (void);

Returns a directory in which GTK+ looks for theme engines. For full information about the search for theme engines, see the docs for GTK_PATH in

gtk_rc_get_im_module_path ()

gchar *
gtk_rc_get_im_module_path (void);

Obtains the path in which to look for IM modules. See the documentation of the GTK_PATH environment variable for more details about looking up modules. This function is useful solely for utilities supplied with GTK+ and should not be used by applications under normal circumstances.

gtk_rc_get_im_module_file ()

gchar *
gtk_rc_get_im_module_file (void);

Obtains the path to the IM modules file. See the documentation of the GTK_IM_MODULE_FILE environment variable for more details.

gtk_rc_get_theme_dir ()

gchar *
gtk_rc_get_theme_dir (void);

gtk_rc_style_new ()

GtkRcStyle *
gtk_rc_style_new (void);

gtk_rc_style_copy ()

GtkRcStyle *
gtk_rc_style_copy (GtkRcStyle *orig);

Makes a copy of the specified GtkRcStyle. This function will correctly copy an RC style that is a member of a class derived from GtkRcStyle.

gtk_rc_style_ref ()

void
gtk_rc_style_ref (GtkRcStyle *rc_style);

gtk_rc_style_unref ()

void
gtk_rc_style_unref (GtkRcStyle *rc_style);

GtkRcStyle

typedef struct {
  gchar *name;
  gchar *bg_pixmap_name[5];
  PangoFontDescription *font_desc;

  GtkRcFlags color_flags[5];
  GdkColor   fg[5];
  GdkColor   bg[5];
  GdkColor   text[5];
  GdkColor   base[5];

  gint xthickness;
  gint ythickness;
} GtkRcStyle;

enum GtkRcFlags

enum GtkRcTokenType

gtk_rc_parse

#define gtk_rc_parse gtk_rc_parse_utf8

gtk_rc_add_default_file

#define gtk_rc_add_default_file gtk_rc_add_default_file_utf8

Adds a file to the list of files to be parsed at the end of gtk_init().

gtk_rc_set_default_files

#define gtk_rc_set_default_files gtk_rc_set_default_files_utf8

Sets the list of files that GTK+ will read at the end of gtk_init().