Gtk::RC Class Reference

## Public Member Functions

| RC (const Glib::ustring& filename)

## Static Public Member Functions

static Glib::RefPtr< Style > | get_style (const Widget& widget)
| Finds all matching RC styles for a given widget, composites them together, and then creates a Gtk::Style representing the composite appearance. More...
static void | parse_string (const Glib::ustring& rc_string)
static void | add_default_file (const Glib::ustring& filename)
| Adds a file to the list of files to be parsed at the end of gtk_init(). More...
static void | set_default_files (const Glib::StringArrayHandle& filenames)
| Sets the list of files that GTK+ will read at the end of gtk_init(). More...
static Glib::StringArrayHandle | get_default_files ()
| Retrieves the current list of RC files that will be parsed at the end of gtk_init(). More...
static bool | reparse_all ()
| If the modification time on any previously read file for the default Gtk::Settings has changed, discard all style information and then reread all previously read RC files. More...
static bool | reparse_all (const Glib::RefPtr< Settings >& settings, bool force_load=true)
| If the modification time on any previously read file for the given Gtk::Settings has changed, discard all style information and then reread all previously read RC files. More...
static void | reset_styles (const Glib::RefPtr< Settings >& settings)
| This method recomputes the styles for all widgets that use a particular Gtk::Settings object. More...
static Glib::ustring | find_pixmap_in_path (const Glib::RefPtr< Settings >& settings, GScanner* scanner, const Glib::ustring& pixmap_file)
| Looks up a file in pixmap path for the specified Gtk::Settings. More...
static Glib::ustring | find_pixmap_in_path (const Glib::RefPtr< Settings >& settings, const Glib::ustring& pixmap_file)
| Looks up a file in pixmap path for the specified Gtk::Settings. More...
static Glib::ustring | find_module_in_path (const Glib::ustring& pixmap_file)
| Searches for a theme engine in the GTK+ search path. More...
static Glib::ustring | get_theme_dir ()
static Glib::ustring | get_module_dir ()
| Returns a directory in which GTK+ looks for theme engines. More...

## Constructor & Destructor Documentation

Gtk::RC::RC | ( | const Glib::ustring & | filename | ) |

explicit

## Member Function Documentation

static void Gtk::RC::add_default_file | ( | const Glib::ustring & | filename | ) |

static

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

Parameters

  filename | the pathname to the file. If filename is not absolute, it is searched in the current directory.

static Glib::ustring Gtk::RC::find_module_in_path | ( | const Glib::ustring & | pixmap_file | ) |

static

Searches for a theme engine in the GTK+ search path.

This function is not useful for applications and should not be used.

Parameters

  pixmap_file | name of a theme engine.

Returns
  The filename, if found, otherwise an empty string.

static Glib::ustring Gtk::RC::find_pixmap_in_path | ( | const Glib::RefPtr< Settings >& | settings,
|  | GScanner * | scanner,
|  | const Glib::ustring & | pixmap_file
| ) |  |

static

Looks up a file in pixmap path for the specified Gtk::Settings.

If the file is not found, it outputs a warning message using g_warning() and returns an empty string.

Parameters

  settings | a Gtk::Settings
  scanner | Scanner used to get line number information for the warning message.
  pixmap_file | name of the pixmap file to locate.

Returns
  the filename.

static Glib::ustring Gtk::RC::find_pixmap_in_path | ( | const Glib::RefPtr< Settings >& | settings,
|  | const Glib::ustring & | pixmap_file
| ) |  |

static

Looks up a file in pixmap path for the specified Gtk::Settings.

If the file is not found, it outputs a warning message using g_warning() and returns an empty string.

Parameters

  settings | a Gtk::Settings
  pixmap_file | name of the pixmap file to locate.

Returns
  the filename.

static Glib::StringArrayHandle Gtk::RC::get_default_files | ( |  | ) |

static

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

Returns
  An array of filenames.

static Glib::ustring Gtk::RC::get_module_dir | ( |  | ) |

static

Returns a directory in which GTK+ looks for theme engines.

For full information about the search for theme engines, see the GTK+ docs.

Returns
  the directory.

static Glib::RefPtr<Style> Gtk::RC::get_style | ( | const Widget& | widget | ) |

static

Finds all matching RC styles for a given widget, composites them together, and then creates a Gtk::Style representing the composite appearance.

Parameters

  widget | a Gtk::Widget.

Returns
  the resulting style.

static Glib::ustring Gtk::RC::get_theme_dir | ( |  | ) |

static

static void Gtk::RC::parse_string | ( | const Glib::ustring & | rc_string | ) |

static

static bool Gtk::RC::reparse_all | ( |  | ) |

static

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

Returns
  true if the files were reread.

static bool Gtk::RC::reparse_all | ( | const Glib::RefPtr< Settings >& | settings,
|  | bool | force_load = `true`
| ) |  |

static

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

Parameters

  settings | a Gtk::Settings
  force_load | load whether or not anything changed

Returns
  true if the files were reread.

static void Gtk::RC::reset_styles | ( | const Glib::RefPtr< Settings >& | settings | ) |

static

This method recomputes the styles for all widgets that use a particular Gtk::Settings object.

(There is one Gtk::Settings object per Gdk::Screen - 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().

Parameters

  settings | a Gtk::Settings

Since gtkmm 2.4:

static void Gtk::RC::set_default_files | ( | const Glib::StringArrayHandle & | filenames | ) |

static

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

Parameters

  filenames | A list of filenames.

The documentation for this class was generated from the following file:

- gtkmm/rc.h