Gtk::RC Class Reference

List of all members.

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.
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().
static void	set_default_files (const Glib::StringArrayHandle& filenames)
	Sets the list of files that GTK+ will read at the end of gtk_init().
static Glib::StringArrayHandle	get_default_files ()
	Retrieves the current list of RC files that will be parsed at the end of gtk_init().
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.
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.
static void	reset_styles (const Glib::RefPtr< Settings >& settings)
	This method recomputes the styles for all widgets that use a particular Gtk::Settings object.
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.
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.
static Glib::ustring	find_module_in_path (const Glib::ustring& pixmap_file)
	Searches for a theme engine in the GTK+ search path.
static Glib::ustring	get_theme_dir ()
static Glib::ustring	get_module_dir ()
	Returns a directory in which GTK+ looks for theme engines.

---

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,
		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::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::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	(	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 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 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