diff options
Diffstat (limited to 'gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Resource-Files.html')
| -rw-r--r-- | gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Resource-Files.html | 1734 |
1 files changed, 0 insertions, 1734 deletions
diff --git a/gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Resource-Files.html b/gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Resource-Files.html deleted file mode 100644 index 6f535cc..0000000 --- a/gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Resource-Files.html +++ /dev/null @@ -1,1734 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>Resource Files</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> -<link rel="home" href="index.html" title="GTK+ 3 Reference Manual"> -<link rel="up" href="theming.html" title="Part III. Theming in GTK+"> -<link rel="prev" href="GtkNumerableIcon.html" title="GtkNumerableIcon"> -<link rel="next" href="GtkStyle.html" title="GtkStyle"> -<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)"> -<link rel="stylesheet" href="style.css" type="text/css"> -</head> -<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> -<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> -<tr valign="middle"> -<td><a accesskey="p" href="GtkNumerableIcon.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> -<td><a accesskey="u" href="theming.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> -<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> -<th width="100%" align="center">GTK+ 3 Reference Manual</th> -<td><a accesskey="n" href="GtkStyle.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> -</tr> -<tr><td colspan="5" class="shortcuts"> -<a href="#gtk3-Resource-Files.synopsis" class="shortcut">Top</a> - | - <a href="#gtk3-Resource-Files.description" class="shortcut">Description</a> - | - <a href="#gtk3-Resource-Files.object-hierarchy" class="shortcut">Object Hierarchy</a> -</td></tr> -</table> -<div class="refentry"> -<a name="gtk3-Resource-Files"></a><div class="titlepage"></div> -<div class="refnamediv"><table width="100%"><tr> -<td valign="top"> -<h2><span class="refentrytitle"><a name="gtk3-Resource-Files.top_of_page"></a>Resource Files</span></h2> -<p>Resource Files — Deprecated routines for handling resource files</p> -</td> -<td valign="top" align="right"></td> -</tr></table></div> -<div class="refsynopsisdiv"> -<a name="gtk3-Resource-Files.synopsis"></a><h2>Synopsis</h2> -<a name="GtkRcStyle"></a><pre class="synopsis"> -#include <gtk/gtk.h> - - <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle-struct" title="GtkRcStyle">GtkRcStyle</a>; -enum <a class="link" href="gtk3-Resource-Files.html#GtkRcFlags" title="enum GtkRcFlags">GtkRcFlags</a>; -enum <a class="link" href="gtk3-Resource-Files.html#GtkRcTokenType" title="enum GtkRcTokenType">GtkRcTokenType</a>; -<a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="returnvalue">GScanner</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-scanner-new" title="gtk_rc_scanner_new ()">gtk_rc_scanner_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a class="link" href="GtkStyle.html" title="GtkStyle"><span class="returnvalue">GtkStyle</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-style" title="gtk_rc_get_style ()">gtk_rc_get_style</a> (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>); -<a class="link" href="GtkStyle.html" title="GtkStyle"><span class="returnvalue">GtkStyle</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-style-by-paths" title="gtk_rc_get_style_by_paths ()">gtk_rc_get_style_by_paths</a> (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *widget_path</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *class_path</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse" title="gtk_rc_parse ()">gtk_rc_parse</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-string" title="gtk_rc_parse_string ()">gtk_rc_parse_string</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *rc_string</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-reparse-all" title="gtk_rc_reparse_all ()">gtk_rc_reparse_all</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-reparse-all-for-settings" title="gtk_rc_reparse_all_for_settings ()">gtk_rc_reparse_all_for_settings</a> (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> force_load</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-reset-styles" title="gtk_rc_reset_styles ()">gtk_rc_reset_styles</a> (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-add-default-file" title="gtk_rc_add_default_file ()">gtk_rc_add_default_file</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-default-files" title="gtk_rc_get_default_files ()">gtk_rc_get_default_files</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<span class="returnvalue">void</span> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-set-default-files" title="gtk_rc_set_default_files ()">gtk_rc_set_default_files</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **filenames</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-color" title="gtk_rc_parse_color ()">gtk_rc_parse_color</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-color-full" title="gtk_rc_parse_color_full ()">gtk_rc_parse_color_full</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a> *style</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-state" title="gtk_rc_parse_state ()">gtk_rc_parse_state</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> *state</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-priority" title="gtk_rc_parse_priority ()">gtk_rc_parse_priority</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPathPriorityType" title="enum GtkPathPriorityType"><span class="type">GtkPathPriorityType</span></a> *priority</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-find-module-in-path" title="gtk_rc_find_module_in_path ()">gtk_rc_find_module_in_path</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *module_file</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-find-pixmap-in-path" title="gtk_rc_find_pixmap_in_path ()">gtk_rc_find_pixmap_in_path</a> (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pixmap_file</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-module-dir" title="gtk_rc_get_module_dir ()">gtk_rc_get_module_dir</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-im-module-path" title="gtk_rc_get_im_module_path ()">gtk_rc_get_im_module_path</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-im-module-file" title="gtk_rc_get_im_module_file ()">gtk_rc_get_im_module_file</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-theme-dir" title="gtk_rc_get_theme_dir ()">gtk_rc_get_theme_dir</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="returnvalue">GtkRcStyle</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-style-new" title="gtk_rc_style_new ()">gtk_rc_style_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="returnvalue">GtkRcStyle</span></a> * <a class="link" href="gtk3-Resource-Files.html#gtk-rc-style-copy" title="gtk_rc_style_copy ()">gtk_rc_style_copy</a> (<em class="parameter"><code><a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a> *orig</code></em>); -</pre> -</div> -<div class="refsect1"> -<a name="gtk3-Resource-Files.object-hierarchy"></a><h2>Object Hierarchy</h2> -<pre class="synopsis"> - <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> - +----GtkRcStyle -</pre> -</div> -<div class="refsect1"> -<a name="gtk3-Resource-Files.description"></a><h2>Description</h2> -<p> -GTK+ provides resource file mechanism for configuring -various aspects of the operation of a GTK+ program -at runtime. -</p> -<p> -</p> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -In GTK+ 3.0, resource files have been deprecated and replaced -by CSS-like style sheets, which are understood by <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>. -</div> -<p> -</p> -<p> -</p> -<div class="refsect2"> -<a name="id484194"></a><h3>Default files</h3> -<p> -An application can cause GTK+ to parse a specific RC -file by calling <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse" title="gtk_rc_parse ()"><code class="function">gtk_rc_parse()</code></a>. In addition to this, -certain files will be read at the end of <a class="link" href="gtk3-General.html#gtk-init" title="gtk_init ()"><code class="function">gtk_init()</code></a>. -Unless modified, the files looked for will be -<code class="filename"><SYSCONFDIR>/gtk-2.0/gtkrc</code> -and <code class="filename">.gtkrc-3.0</code> in the users home directory. -(<code class="filename"><SYSCONFDIR></code> defaults to -<code class="filename">/usr/local/etc</code>. It can be changed with the -<code class="option">--prefix</code> or <code class="option">--sysconfdir</code> options when -configuring GTK+.) -</p> -<p> -The set of these <em class="firstterm">default</em> files -can be retrieved with <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-default-files" title="gtk_rc_get_default_files ()"><code class="function">gtk_rc_get_default_files()</code></a> -and modified with <a class="link" href="gtk3-Resource-Files.html#gtk-rc-add-default-file" title="gtk_rc_add_default_file ()"><code class="function">gtk_rc_add_default_file()</code></a> and -<a class="link" href="gtk3-Resource-Files.html#gtk-rc-set-default-files" title="gtk_rc_set_default_files ()"><code class="function">gtk_rc_set_default_files()</code></a>. -Additionally, the <code class="envar">GTK2_RC_FILES</code> environment variable -can be set to a <span class="type">G_SEARCHPATH_SEPARATOR_S-separated</span> list of files -in order to overwrite the set of default files at runtime. -</p> -<p><a name="locale-specific-rc"></a> -For each RC file, in addition to the file itself, GTK+ will look for -a locale-specific file that will be parsed after the main file. -For instance, if <code class="envar">LANG</code> is set to <code class="literal">ja_JP.ujis</code>, -when loading the default file <code class="filename">~/.gtkrc</code> then GTK+ looks -for <code class="filename">~/.gtkrc.ja_JP</code> and <code class="filename">~/.gtkrc.ja</code>, -and parses the first of those that exists.</p> -<p> -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id677908"></a><h3>Pathnames and patterns</h3> -<a name="gtkrc-pathnames-and-patterns"></a><p> -A resource file defines a number of styles and key bindings and -attaches them to particular widgets. The attachment is done -by the <code class="literal">widget</code>, <code class="literal">widget_class</code>, -and <code class="literal">class</code> declarations. As an example -of such a statement: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">widget </span><span class="string">"mywindow.*.GtkEntry"</span><span class="normal"> style </span><span class="string">"my-entry-class"</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -attaches the style <code class="literal">"my-entry-class"</code> to all -widgets whose <em class="firstterm">widget path</em> matches the -<em class="firstterm">pattern</em> <code class="literal">"mywindow.*.GtkEntry"</code>. -That is, all <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> widgets which are part of a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> named -<code class="literal">"mywindow"</code>. -</p> -<p> -The patterns here are given in the standard shell glob syntax. -The <code class="literal">"?"</code> wildcard matches any character, while -<code class="literal">"*"</code> matches zero or more of any character. -The three types of matching are against the widget path, the -<em class="firstterm">class path</em> and the class hierarchy. Both the -widget path and the class path consist of a <code class="literal">"."</code> -separated list of all the parents of the widget and the widget itself -from outermost to innermost. The difference is that in the widget path, -the name assigned by <a class="link" href="GtkWidget.html#gtk-widget-set-name" title="gtk_widget_set_name ()"><code class="function">gtk_widget_set_name()</code></a> is used if present, otherwise -the class name of the widget, while for the class path, the class name is -always used. -</p> -<p> -Since GTK+ 2.10, <code class="literal">widget_class</code> paths can also contain -<code class="literal"><classname></code> substrings, which are matching -the class with the given name and any derived classes. For instance, -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">widget_class </span><span class="string">"*<GtkMenuItem>.GtkLabel"</span><span class="normal"> style </span><span class="string">"my-style"</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -will match <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widgets which are contained in any kind of menu item. -</p> -<p> -So, if you have a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> named <code class="literal">"myentry"</code>, inside of a -horizontal box in a window named <code class="literal">"mywindow"</code>, then the -widget path is: <code class="literal">"mywindow.GtkHBox.myentry"</code> -while the class path is: <code class="literal">"GtkWindow.GtkHBox.GtkEntry"</code>. -</p> -<p> -Matching against class is a little different. The pattern match is done -against all class names in the widgets class hierarchy (not the layout -hierarchy) in sequence, so the pattern: -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">class </span><span class="string">"GtkButton"</span><span class="normal"> style </span><span class="string">"my-style"</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -will match not just <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> widgets, but also <a class="link" href="GtkToggleButton.html" title="GtkToggleButton"><span class="type">GtkToggleButton</span></a> and -<a class="link" href="GtkCheckButton.html" title="GtkCheckButton"><span class="type">GtkCheckButton</span></a> widgets, since those classes derive from <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>. -</p> -<p> -Additionally, a priority can be specified for each pattern, and styles -override other styles first by priority, then by pattern type and then -by order of specification (later overrides earlier). The priorities -that can be specified are (highest to lowest): -</p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><code class="literal">highest</code></td></tr> -<tr><td><code class="literal">rc</code></td></tr> -<tr><td><code class="literal">theme</code></td></tr> -<tr><td><code class="literal">application</code></td></tr> -<tr><td><code class="literal">gtk</code></td></tr> -<tr><td><code class="literal">lowest</code></td></tr> -</table> -<p> -<code class="literal">rc</code> is the default for styles -read from an RC file, <code class="literal">theme</code> -is the default for styles read from theme RC files, -<code class="literal">application</code> -should be used for styles an application sets -up, and <code class="literal">gtk</code> is used for styles -that GTK+ creates internally. -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id681395"></a><h3>Theme gtkrc files</h3> -<a name="theme-gtkrc-files"></a><p> -Theme RC files are loaded first from under the <code class="filename">~/.themes/</code>, -then from the directory from <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-theme-dir" title="gtk_rc_get_theme_dir ()"><code class="function">gtk_rc_get_theme_dir()</code></a>. The files looked at will -be <code class="filename">gtk-3.0/gtkrc</code>. -</p> -<p> -When the application prefers dark themes -(see the <a class="link" href="GtkSettings.html#GtkSettings--gtk-application-prefer-dark-theme" title='The "gtk-application-prefer-dark-theme" property'><span class="type">"gtk-application-prefer-dark-theme"</span></a> property for details), -<code class="filename">gtk-3.0/gtkrc-dark</code> will be loaded first, and if not present -<code class="filename">gtk-3.0/gtkrc</code> will be loaded. -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id681458"></a><h3>Optimizing RC Style Matches</h3> -<a name="optimizing-rc-style-matches"></a><p> -Everytime a widget is created and added to the layout hierarchy of a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> -("anchored" to be exact), a list of matching RC styles out of all RC styles read -in so far is composed. -For this, every RC style is matched against the widgets class path, -the widgets name path and widgets inheritance hierarchy. -As a consequence, significant slowdown can be caused by utilization of many -RC styles and by using RC style patterns that are slow or complicated to match -against a given widget. -The following ordered list provides a number of advices (prioritized by -effectiveness) to reduce the performance overhead associated with RC style -matches: -</p> -<p> -</p> -<div class="orderedlist"><ol class="orderedlist" type="1"> -<li class="listitem"><p> - Move RC styles for specific applications into RC files dedicated to those - applications and parse application specific RC files only from - applications that are affected by them. - This reduces the overall amount of RC styles that have to be considered - for a match across a group of applications. - </p></li> -<li class="listitem"> -<p> - Merge multiple styles which use the same matching rule, for instance: - </p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">style </span><span class="string">"Foo"</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> foo_content </span><span class="cbracket">}</span> -<span class="normal">class </span><span class="string">"X"</span><span class="normal"> style </span><span class="string">"Foo"</span> -<span class="normal">style </span><span class="string">"Bar"</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> bar_content </span><span class="cbracket">}</span> -<span class="normal">class </span><span class="string">"X"</span><span class="normal"> style </span><span class="string">"Bar"</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> - is faster to match as: - </p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">style </span><span class="string">"FooBar"</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="usertype">foo_content</span><span class="normal"> bar_content </span><span class="cbracket">}</span> -<span class="normal">class </span><span class="string">"X"</span><span class="normal"> style </span><span class="string">"FooBar"</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> - </p> -</li> -<li class="listitem"><p> - Use of wildcards should be avoided, this can reduce the individual RC style - match to a single integer comparison in most cases. - </p></li> -<li class="listitem"><p> - To avoid complex recursive matching, specification of full class names - (for <code class="literal">class</code> matches) or full path names (for - <code class="literal">widget</code> and <code class="literal">widget_class</code> matches) - is to be preferred over shortened names - containing <code class="literal">"*"</code> or <code class="literal">"?"</code>. - </p></li> -<li class="listitem"><p> - If at all necessary, wildcards should only be used at the tail or head - of a pattern. This reduces the match complexity to a string comparison - per RC style. - </p></li> -<li class="listitem"><p> - When using wildcards, use of <code class="literal">"?"</code> should be preferred - over <code class="literal">"*"</code>. This can reduce the matching complexity from - O(n^2) to O(n). For example <code class="literal">"Gtk*Box"</code> can be turned into - <code class="literal">"Gtk?Box"</code> and will still match <a class="link" href="GtkHBox.html" title="GtkHBox"><span class="type">GtkHBox</span></a> and <a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a>. - </p></li> -<li class="listitem"><p> - The use of <code class="literal">"*"</code> wildcards should be restricted as much - as possible, because matching <code class="literal">"A*B*C*RestString"</code> can - result in matching complexities of O(n^2) worst case. - </p></li> -</ol></div> -<p> -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id681639"></a><h3>Toplevel declarations</h3> -<p> -An RC file is a text file which is composed of a sequence -of declarations. <code class="literal">'#'</code> characters delimit comments and -the portion of a line after a <code class="literal">'#'</code> is ignored when parsing -an RC file. -</p> -<p> -The possible toplevel declarations are: -</p> -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><code class="literal">binding <em class="replaceable"><code>name</code></em> - { ... }</code></span></p></td> -<td><p>Declares a binding set.</p></td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">class <em class="replaceable"><code>pattern</code></em> - [ style | binding ][ : <em class="replaceable"><code>priority</code></em> ] - <em class="replaceable"><code>name</code></em></code></span></p></td> -<td><p>Specifies a style or binding set for a particular - branch of the inheritance hierarchy.</p></td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">include <em class="replaceable"><code>filename</code></em></code></span></p></td> -<td> -<p>Parses another file at this point. If - <em class="replaceable"><code>filename</code></em> is not an absolute filename, - it is searched in the directories of the currently open RC files.</p> -<p>GTK+ also tries to load a - <a class="link" href="gtk3-Resource-Files.html#locale-specific-rc">locale-specific variant</a> of - the included file.</p> -</td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">module_path <em class="replaceable"><code>path</code></em></code></span></p></td> -<td><p>Sets a path (a list of directories separated - by colons) that will be searched for theme engines referenced in - RC files.</p></td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">pixmap_path <em class="replaceable"><code>path</code></em></code></span></p></td> -<td><p>Sets a path (a list of directories separated - by colons) that will be searched for pixmaps referenced in - RC files.</p></td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">im_module_file <em class="replaceable"><code>pathname</code></em></code></span></p></td> -<td><p>Sets the pathname for the IM modules file. Setting this from RC files - is deprecated; you should use the environment variable <code class="envar">GTK_IM_MODULE_FILE</code> - instead.</p></td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">style <em class="replaceable"><code>name</code></em> [ = - <em class="replaceable"><code>parent</code></em> ] { ... }</code></span></p></td> -<td><p>Declares a style.</p></td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">widget <em class="replaceable"><code>pattern</code></em> - [ style | binding ][ : <em class="replaceable"><code>priority</code></em> ] - <em class="replaceable"><code>name</code></em></code></span></p></td> -<td><p>Specifies a style or binding set for a particular - group of widgets by matching on the widget pathname.</p></td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">widget_class <em class="replaceable"><code>pattern</code></em> - [ style | binding ][ : <em class="replaceable"><code>priority</code></em> ] - <em class="replaceable"><code>name</code></em></code></span></p></td> -<td><p>Specifies a style or binding set for a particular - group of widgets by matching on the class pathname.</p></td> -</tr> -<tr> -<td><p><span class="term"><em class="replaceable"><code>setting</code></em> = <em class="replaceable"><code>value</code></em></span></p></td> -<td><p>Specifies a value for a <a class="link" href="GtkSettings.html" title="Settings">setting</a>. - Note that settings in RC files are overwritten by system-wide settings - (which are managed by an XSettings manager on X11).</p></td> -</tr> -</tbody> -</table></div> -<p> -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id675392"></a><h3>Styles</h3> -<p> -A RC style is specified by a <code class="literal">style</code> -declaration in a RC file, and then bound to widgets -with a <code class="literal">widget</code>, <code class="literal">widget_class</code>, -or <code class="literal">class</code> declaration. All styles -applying to a particular widget are composited together -with <code class="literal">widget</code> declarations overriding -<code class="literal">widget_class</code> declarations which, in -turn, override <code class="literal">class</code> declarations. -Within each type of declaration, later declarations override -earlier ones. -</p> -<p> -Within a <code class="literal">style</code> declaration, the possible -elements are: -</p> -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><code class="literal">bg[<em class="replaceable"><code>state</code></em>] = - <em class="replaceable"><code>color</code></em></code></span></p></td> -<td> - Sets the color used for the background of most widgets. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">fg[<em class="replaceable"><code>state</code></em>] = - <em class="replaceable"><code>color</code></em></code></span></p></td> -<td> - Sets the color used for the foreground of most widgets. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">base[<em class="replaceable"><code>state</code></em>] = - <em class="replaceable"><code>color</code></em></code></span></p></td> -<td> - Sets the color used for the background of widgets displaying - editable text. This color is used for the background - of, among others, <a href="http://library.gnome.org/devel/gtk3/GtkText.html"><span class="type">GtkText</span></a>, <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>, <a href="http://library.gnome.org/devel/gtk3/GtkList.html"><span class="type">GtkList</span></a>, and <a href="http://library.gnome.org/devel/gtk3/GtkCList.html"><span class="type">GtkCList</span></a>. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">text[<em class="replaceable"><code>state</code></em>] = - <em class="replaceable"><code>color</code></em></code></span></p></td> -<td> - Sets the color used for foreground of widgets using - <code class="literal">base</code> for the background color. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">xthickness = - <em class="replaceable"><code>number</code></em></code></span></p></td> -<td> - Sets the xthickness, which is used for various horizontal padding - values in GTK+. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">ythickness = - <em class="replaceable"><code>number</code></em></code></span></p></td> -<td> - Sets the ythickness, which is used for various vertical padding - values in GTK+. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">bg_pixmap[<em class="replaceable"><code>state</code></em>] = - <em class="replaceable"><code>pixmap</code></em></code></span></p></td> -<td> - Sets a background pixmap to be used in place of - the <code class="literal">bg</code> color (or for <a href="http://library.gnome.org/devel/gtk3/GtkText.html"><span class="type">GtkText</span></a>, - in place of the <code class="literal">base</code> color. The special - value <code class="literal">"<parent>"</code> may be used to indicate that the widget should - use the same background pixmap as its parent. The special value - <code class="literal">"<none>"</code> may be used to indicate no background pixmap. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">font = <em class="replaceable"><code>font</code></em></code></span></p></td> -<td> - Starting with GTK+ 2.0, the "font" and "fontset" - declarations are ignored; use "font_name" declarations instead. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">fontset = <em class="replaceable"><code>font</code></em></code></span></p></td> -<td> - Starting with GTK+ 2.0, the "font" and "fontset" - declarations are ignored; use "font_name" declarations instead. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">font_name = <em class="replaceable"><code>font</code></em></code></span></p></td> -<td> - Sets the font for a widget. <em class="replaceable"><code>font</code></em> must be - a Pango font name, e.g. <code class="literal">"Sans Italic 10"</code>. - For details about Pango font names, see - <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-from-string"><code class="function">pango_font_description_from_string()</code></a>. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">stock[<em class="replaceable"><code>"stock-id"</code></em>] = { <em class="replaceable"><code>icon source specifications</code></em> }</code></span></p></td> -<td> - Defines the icon for a stock item. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">color[<em class="replaceable"><code>"color-name"</code></em>] = <em class="replaceable"><code>color specification</code></em></code></span></p></td> -<td> - Since 2.10, this element can be used to defines symbolic colors. See below for - the syntax of color specifications. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">engine <em class="replaceable"><code>"engine"</code></em> { <em class="replaceable"><code>engine-specific -settings</code></em> }</code></span></p></td> -<td> - Defines the engine to be used when drawing with this style. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal"><em class="replaceable"><code>class</code></em>::<em class="replaceable"><code>property</code></em> = <em class="replaceable"><code>value</code></em></code></span></p></td> -<td> - Sets a <a class="link" href="GtkWidget.html#style-properties" title="Style Properties">style property</a> for a widget class. - </td> -</tr> -</tbody> -</table></div> -<p> -</p> -<p> -The colors and background pixmaps are specified as a function of the -state of the widget. The states are: -</p> -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><code class="literal">NORMAL</code></span></p></td> -<td> - A color used for a widget in its normal state. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">ACTIVE</code></span></p></td> -<td> - A variant of the <code class="literal">NORMAL</code> color used when the - widget is in the <a class="link" href="gtk3-Standard-Enumerations.html#GTK-STATE-ACTIVE:CAPS"><code class="literal">GTK_STATE_ACTIVE</code></a> state, and also for - the trough of a ScrollBar, tabs of a NoteBook - other than the current tab and similar areas. - Frequently, this should be a darker variant - of the <code class="literal">NORMAL</code> color. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">PRELIGHT</code></span></p></td> -<td> - A color used for widgets in the <a class="link" href="gtk3-Standard-Enumerations.html#GTK-STATE-PRELIGHT:CAPS"><code class="literal">GTK_STATE_PRELIGHT</code></a> state. This - state is the used for Buttons and MenuItems - that have the mouse cursor over them, and for - their children. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">SELECTED</code></span></p></td> -<td> - A color used to highlight data selected by the user. - for instance, the selected items in a list widget, and the - selection in an editable widget. - </td> -</tr> -<tr> -<td><p><span class="term"><code class="literal">INSENSITIVE</code></span></p></td> -<td> - A color used for the background of widgets that have - been set insensitive with <a class="link" href="GtkWidget.html#gtk-widget-set-sensitive" title="gtk_widget_set_sensitive ()"><code class="function">gtk_widget_set_sensitive()</code></a>. - </td> -</tr> -</tbody> -</table></div> -<p> -</p> -<p> -<a name="color-format"></a> -Colors can be specified as a string containing a color name (GTK+ knows -all names from the X color database <code class="filename">/usr/lib/X11/rgb.txt</code>), -in one of the hexadecimal forms <code class="literal"><span class="type">rrrrggggbbbb</span></code>, -<code class="literal"><span class="type">rrrgggbbb</span></code>, <code class="literal"><span class="type">rrggbb</span></code>, -or <code class="literal"><span class="type">rgb</span></code>, where <code class="literal">r</code>, -<code class="literal">g</code> and <code class="literal">b</code> are -hex digits, or they can be specified as a triplet -<code class="literal">{ <em class="replaceable"><code>r</code></em>, <em class="replaceable"><code>g</code></em>, -<em class="replaceable"><code>b</code></em>}</code>, where <code class="literal">r</code>, -<code class="literal">g</code> and <code class="literal">b</code> are either integers in -the range 0-65535 or floats in the range 0.0-1.0. -</p> -<p> -Since 2.10, colors can also be specified by refering to a symbolic color, as -follows: <code class="literal">@color-name</code>, or by using expressions to combine -colors. The following expressions are currently supported: - </p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term">mix (<em class="replaceable"><code>factor</code></em>, <em class="replaceable"><code>color1</code></em>, <em class="replaceable"><code>color2</code></em>)</span></p></td> -<td><p> - Computes a new color by mixing <em class="replaceable"><code>color1</code></em> and - <em class="replaceable"><code>color2</code></em>. The <em class="replaceable"><code>factor</code></em> - determines how close the new color is to <em class="replaceable"><code>color1</code></em>. - A factor of 1.0 gives pure <em class="replaceable"><code>color1</code></em>, a factor of - 0.0 gives pure <em class="replaceable"><code>color2</code></em>. - </p></td> -</tr> -<tr> -<td><p><span class="term">shade (<em class="replaceable"><code>factor</code></em>, <em class="replaceable"><code>color</code></em>)</span></p></td> -<td><p> - Computes a lighter or darker variant of <em class="replaceable"><code>color</code></em>. - A <em class="replaceable"><code>factor</code></em> of 1.0 leaves the color unchanged, smaller - factors yield darker colors, larger factors yield lighter colors. - </p></td> -</tr> -<tr> -<td><p><span class="term">lighter (<em class="replaceable"><code>color</code></em>)</span></p></td> -<td><p> - This is an abbreviation for - <code class="literal">shade (1.3, <em class="replaceable"><code>color</code></em>)</code>. - </p></td> -</tr> -<tr> -<td><p><span class="term">darker (<em class="replaceable"><code>color</code></em>)</span></p></td> -<td><p> - This is an abbreviation for - <code class="literal">shade (0.7, <em class="replaceable"><code>color</code></em>)</code>. - </p></td> -</tr> -</tbody> -</table></div> -<p> -</p> -<p> -Here are some examples of color expressions: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="function">mix</span><span class="normal"> </span><span class="symbol">(</span><span class="number">0.5</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"red"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"blue"</span><span class="symbol">)</span> -<span class="function">shade</span><span class="normal"> </span><span class="symbol">(</span><span class="number">1.5</span><span class="symbol">,</span><span class="normal"> </span><span class="function">mix</span><span class="normal"> </span><span class="symbol">(</span><span class="number">0.3</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"<GTKDOCLINK HREF="</span><span class="normal">0abbc0</span><span class="string">">0abbc0</GTKDOCLINK>"</span><span class="symbol">,</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="number">0.3</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.5</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.9</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">))</span> -<span class="function">lighter</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">@foreground</span><span class="symbol">)</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -In a <code class="literal">stock</code> definition, icon sources are specified as a -4-tuple of image filename or icon name, text direction, widget state, and size, in that -order. Each icon source specifies an image filename or icon name to use with a given -direction, state, and size. Filenames are specified as a string such -as <code class="literal">"itemltr.png"</code>, while icon names (looked up -in the current icon theme), are specified with a leading -<code class="literal">@</code>, such as <code class="literal">@"item-ltr"</code>. -The <code class="literal">*</code> character can be used as a -wildcard, and if direction/state/size are omitted they default to -<code class="literal">*</code>. So for example, the following specifies different icons to -use for left-to-right and right-to-left languages: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">stock</span><span class="symbol">[</span><span class="string">"my-stock-item"</span><span class="symbol">]</span><span class="normal"> </span><span class="symbol">=</span> -<span class="cbracket">{</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"itemltr.png"</span><span class="symbol">,</span><span class="normal"> LTR</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"itemrtl.png"</span><span class="symbol">,</span><span class="normal"> RTL</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal"> </span><span class="cbracket">}</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -This could be abbreviated as follows: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">stock</span><span class="symbol">[</span><span class="string">"my-stock-item"</span><span class="symbol">]</span><span class="normal"> </span><span class="symbol">=</span> -<span class="cbracket">{</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"itemltr.png"</span><span class="symbol">,</span><span class="normal"> LTR </span><span class="cbracket">}</span><span class="symbol">,</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"itemrtl.png"</span><span class="symbol">,</span><span class="normal"> RTL </span><span class="cbracket">}</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -You can specify custom icons for specific sizes, as follows: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">stock</span><span class="symbol">[</span><span class="string">"my-stock-item"</span><span class="symbol">]</span><span class="normal"> </span><span class="symbol">=</span> -<span class="cbracket">{</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"itemmenusize.png"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*,</span><span class="normal"> </span><span class="symbol">*,</span><span class="normal"> </span><span class="string">"gtk-menu"</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"itemtoolbarsize.png"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*,</span><span class="normal"> </span><span class="symbol">*,</span><span class="normal"> </span><span class="string">"gtk-large-toolbar"</span><span class="normal"> </span><span class="cbracket">}</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"itemgeneric.png"</span><span class="normal"> </span><span class="cbracket">}</span><span class="normal"> </span><span class="comment">// implicit *, *, * as a fallback</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -The sizes that come with GTK+ itself are <code class="literal">"gtk-menu"</code>, -<code class="literal">"gtk-small-toolbar"</code>, <code class="literal">"gtk-large-toolbar"</code>, -<code class="literal">"gtk-button"</code>, <code class="literal">"gtk-dialog"</code>. Applications -can define other sizes. -</p> -<p> -It's also possible to use custom icons for a given state, for example: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">stock</span><span class="symbol">[</span><span class="string">"my-stock-item"</span><span class="symbol">]</span><span class="normal"> </span><span class="symbol">=</span> -<span class="cbracket">{</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"itemprelight.png"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*,</span><span class="normal"> PRELIGHT </span><span class="cbracket">}</span><span class="symbol">,</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"iteminsensitive.png"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*,</span><span class="normal"> INSENSITIVE </span><span class="cbracket">}</span><span class="symbol">,</span> -<span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"itemgeneric.png"</span><span class="normal"> </span><span class="cbracket">}</span><span class="normal"> </span><span class="comment">// implicit *, *, * as a fallback</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -When selecting an icon source to use, GTK+ will consider text direction most -important, state second, and size third. It will select the best match based on -those criteria. If an attribute matches exactly (e.g. you specified -<code class="literal">PRELIGHT</code> or specified the size), GTK+ won't modify the image; -if the attribute matches with a wildcard, GTK+ will scale or modify the image to -match the state and size the user requested. -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id676431"></a><h3>Key bindings</h3> -<p> -Key bindings allow the user to specify actions to be -taken on particular key presses. The form of a binding -set declaration is: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">binding </span><span class="symbol"><</span><span class="usertype">em</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"replaceable"</span><span class="symbol">><</span><span class="normal">code</span><span class="symbol">></span><span class="normal">name</span><span class="symbol"></</span><span class="normal">code</span><span class="symbol">></</span><span class="normal">em</span><span class="symbol">></span><span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> bind </span><span class="symbol"><</span><span class="usertype">em</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"replaceable"</span><span class="symbol">><</span><span class="normal">code</span><span class="symbol">></span><span class="normal">key</span><span class="symbol"></</span><span class="normal">code</span><span class="symbol">></</span><span class="normal">em</span><span class="symbol">></span><span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="symbol"><</span><span class="usertype">em</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"replaceable"</span><span class="symbol">><</span><span class="normal">code</span><span class="symbol">></span><span class="normal">signalname</span><span class="symbol"></</span><span class="normal">code</span><span class="symbol">></</span><span class="normal">em</span><span class="symbol">></span><span class="normal"> </span><span class="symbol">(<</span><span class="usertype">em</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"replaceable"</span><span class="symbol">><</span><span class="normal">code</span><span class="symbol">></span><span class="normal">param</span><span class="symbol"></</span><span class="normal">code</span><span class="symbol">></</span><span class="normal">em</span><span class="symbol">>,</span><span class="normal"> </span><span class="symbol">...)</span> -<span class="normal"> </span><span class="symbol">...</span> -<span class="normal"> </span><span class="cbracket">}</span> -<span class="normal"> </span><span class="symbol">...</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -<em class="replaceable"><code>key</code></em> is a string consisting of a -series of modifiers followed by the name of a key. The -modifiers can be: -</p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><code class="literal"><alt></code></td></tr> -<tr><td><code class="literal"><ctl></code></td></tr> -<tr><td><code class="literal"><control></code></td></tr> -<tr><td><code class="literal"><meta></code></td></tr> -<tr><td><code class="literal"><hyper></code></td></tr> -<tr><td><code class="literal"><super></code></td></tr> -<tr><td><code class="literal"><mod1></code></td></tr> -<tr><td><code class="literal"><mod2></code></td></tr> -<tr><td><code class="literal"><mod3></code></td></tr> -<tr><td><code class="literal"><mod4></code></td></tr> -<tr><td><code class="literal"><mod5></code></td></tr> -<tr><td><code class="literal"><release></code></td></tr> -<tr><td><code class="literal"><shft></code></td></tr> -<tr><td><code class="literal"><shift></code></td></tr> -</table> -<p> -<code class="literal"><shft></code> is an alias for -<code class="literal"><shift></code>, -<code class="literal"><ctl></code> is an alias for -<code class="literal"><control></code>, - and -<code class="literal"><alt></code> is an alias for -<code class="literal"><mod1></code>. -</p> -<p> -The action that is bound to the key is a sequence -of signal names (strings) followed by parameters for -each signal. The signals must be action signals. -(See <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-new"><code class="function">g_signal_new()</code></a>). Each parameter can be -a float, integer, string, or unquoted string -representing an enumeration value. The types of -the parameters specified must match the types of the -parameters of the signal. -</p> -<p> -Binding sets are connected to widgets in the same manner as styles, -with one difference: Binding sets override other binding sets first -by pattern type, then by priority and then by order of specification. -The priorities that can be specified and their default values are the -same as for styles. -</p> -</div> -<p> -</p> -</div> -<div class="refsect1"> -<a name="gtk3-Resource-Files.details"></a><h2>Details</h2> -<div class="refsect2"> -<a name="GtkRcStyle-struct"></a><h3>GtkRcStyle</h3> -<pre class="programlisting">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; -</pre> -<p> -The <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a> structure is used to represent a set -of information about the appearance of a widget. -This can later be composited together with other -<a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a> structures to form a <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a>. -</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkRcFlags"></a><h3>enum GtkRcFlags</h3> -<pre class="programlisting">typedef enum { - GTK_RC_FG = 1 << 0, - GTK_RC_BG = 1 << 1, - GTK_RC_TEXT = 1 << 2, - GTK_RC_BASE = 1 << 3 -} GtkRcFlags; -</pre> -</div> -<hr> -<div class="refsect2"> -<a name="GtkRcTokenType"></a><h3>enum GtkRcTokenType</h3> -<pre class="programlisting">typedef enum { - GTK_RC_TOKEN_INVALID = G_TOKEN_LAST, - GTK_RC_TOKEN_INCLUDE, - GTK_RC_TOKEN_NORMAL, - GTK_RC_TOKEN_ACTIVE, - GTK_RC_TOKEN_PRELIGHT, - GTK_RC_TOKEN_SELECTED, - GTK_RC_TOKEN_INSENSITIVE, - GTK_RC_TOKEN_FG, - GTK_RC_TOKEN_BG, - GTK_RC_TOKEN_TEXT, - GTK_RC_TOKEN_BASE, - GTK_RC_TOKEN_XTHICKNESS, - GTK_RC_TOKEN_YTHICKNESS, - GTK_RC_TOKEN_FONT, - GTK_RC_TOKEN_FONTSET, - GTK_RC_TOKEN_FONT_NAME, - GTK_RC_TOKEN_BG_PIXMAP, - GTK_RC_TOKEN_PIXMAP_PATH, - GTK_RC_TOKEN_STYLE, - GTK_RC_TOKEN_BINDING, - GTK_RC_TOKEN_BIND, - GTK_RC_TOKEN_WIDGET, - GTK_RC_TOKEN_WIDGET_CLASS, - GTK_RC_TOKEN_CLASS, - GTK_RC_TOKEN_LOWEST, - GTK_RC_TOKEN_GTK, - GTK_RC_TOKEN_APPLICATION, - GTK_RC_TOKEN_THEME, - GTK_RC_TOKEN_RC, - GTK_RC_TOKEN_HIGHEST, - GTK_RC_TOKEN_ENGINE, - GTK_RC_TOKEN_MODULE_PATH, - GTK_RC_TOKEN_IM_MODULE_PATH, - GTK_RC_TOKEN_IM_MODULE_FILE, - GTK_RC_TOKEN_STOCK, - GTK_RC_TOKEN_LTR, - GTK_RC_TOKEN_RTL, - GTK_RC_TOKEN_COLOR, - GTK_RC_TOKEN_UNBIND, - GTK_RC_TOKEN_LAST -} GtkRcTokenType; -</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">GtkRcTokenType</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -The <a class="link" href="gtk3-Resource-Files.html#GtkRcTokenType" title="enum GtkRcTokenType"><span class="type">GtkRcTokenType</span></a> enumeration represents the tokens -in the RC file. It is exposed so that theme engines -can reuse these tokens when parsing the theme-engine -specific portions of a RC file. -</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-scanner-new"></a><h3>gtk_rc_scanner_new ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="returnvalue">GScanner</span></a> * gtk_rc_scanner_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_scanner_new</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead</p> -</div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-get-style"></a><h3>gtk_rc_get_style ()</h3> -<pre class="programlisting"><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="returnvalue">GtkStyle</span></a> * gtk_rc_get_style (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_get_style</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> instead</p> -</div> -<p> -Finds all matching RC styles for a given widget, -composites them together, and then creates a -<a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> representing the composite appearance. -(GTK+ actually keeps a cache of previously -created styles, so a new style may not be -created.) -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the resulting style. No refcount is added -to the returned style, so if you want to save this style around, -you should add a reference yourself. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-get-style-by-paths"></a><h3>gtk_rc_get_style_by_paths ()</h3> -<pre class="programlisting"><a class="link" href="GtkStyle.html" title="GtkStyle"><span class="returnvalue">GtkStyle</span></a> * gtk_rc_get_style_by_paths (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *widget_path</code></em>, - <em class="parameter"><code>const <span class="type">char</span> *class_path</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_get_style_by_paths</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> instead</p> -</div> -<p> -Creates up a <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a> 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. -</p> -<p> -The action of <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-style" title="gtk_rc_get_style ()"><code class="function">gtk_rc_get_style()</code></a> is similar to: -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkWidget.html#gtk-widget-path">gtk_widget_path</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">path</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span> -<span class="function"><a href="GtkWidget.html#gtk-widget-class-path">gtk_widget_class_path</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">class_path</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span> -<span class="function"><a href="gtk3-Resource-Files.html#gtk-rc-get-style-by-paths">gtk_rc_get_style_by_paths</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkWidget.html#gtk-widget-get-settings">gtk_widget_get_settings</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">),</span> -<span class="normal"> path</span><span class="symbol">,</span><span class="normal"> class_path</span><span class="symbol">,</span> -<span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#G-OBJECT-TYPE:CAPS">G_OBJECT_TYPE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">));</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td> -<td>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget_path</code></em> :</span></p></td> -<td>the widget path to use when looking up the -style, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no matching against the widget path should be done. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>class_path</code></em> :</span></p></td> -<td>the class path to use when looking up the style, -or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no matching against the class path should be done. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> -<td>a type that will be used along with parent types of this type -when matching against class styles, or <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-NONE:CAPS"><span class="type">G_TYPE_NONE</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>A style created by matching with the -supplied paths, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if nothing matching was specified and the -default style should be used. The returned value is owned by GTK+ -as part of an internal cache, so you must call <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> on -the returned value if you want to keep a reference to it. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-parse"></a><h3>gtk_rc_parse ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_rc_parse (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_parse</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Parses a given resource file. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td> -<td>the filename of a file to parse. If <em class="parameter"><code>filename</code></em> is not absolute, it -is searched in the current directory.</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-parse-string"></a><h3>gtk_rc_parse_string ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_rc_parse_string (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *rc_string</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_parse_string</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Parses resource information directly from a string. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>rc_string</code></em> :</span></p></td> -<td>a string to parse.</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-reparse-all"></a><h3>gtk_rc_reparse_all ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_rc_reparse_all (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_reparse_all</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -If the modification time on any previously read file for the -default <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> has changed, discard all style information -and then reread all previously read RC files. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the files were reread.</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-reparse-all-for-settings"></a><h3>gtk_rc_reparse_all_for_settings ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_rc_reparse_all_for_settings (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> force_load</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_reparse_all_for_settings</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -If the modification time on any previously read file -for the given <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> has changed, discard all style information -and then reread all previously read RC files. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td> -<td>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>force_load</code></em> :</span></p></td> -<td>load whether or not anything changed</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the files were reread.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-reset-styles"></a><h3>gtk_rc_reset_styles ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_rc_reset_styles (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_reset_styles</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -This function recomputes the styles for all widgets that use a -particular <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object. (There is one <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object -per <a href="http://developer.gnome.org/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a>, see <a class="link" href="GtkSettings.html#gtk-settings-get-for-screen" title="gtk_settings_get_for_screen ()"><code class="function">gtk_settings_get_for_screen()</code></a>); 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 <a class="link" href="GtkWidget.html#gtk-widget-set-style" title="gtk_widget_set_style ()"><code class="function">gtk_widget_set_style()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td> -<td>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-add-default-file"></a><h3>gtk_rc_add_default_file ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_rc_add_default_file (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_add_default_file</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> with a custom <a class="link" href="GtkStyleProvider.html" title="GtkStyleProvider"><span class="type">GtkStyleProvider</span></a> instead</p> -</div> -<p> -Adds a file to the list of files to be parsed at the -end of <a class="link" href="gtk3-General.html#gtk-init" title="gtk_init ()"><code class="function">gtk_init()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td> -<td>the pathname to the file. If <em class="parameter"><code>filename</code></em> -is not absolute, it is searched in the current directory. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-get-default-files"></a><h3>gtk_rc_get_default_files ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** gtk_rc_get_default_files (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_get_default_files</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> instead</p> -</div> -<p> -Retrieves the current list of RC files that will be parsed -at the end of <a class="link" href="gtk3-General.html#gtk-init" title="gtk_init ()"><code class="function">gtk_init()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of filenames. This memory is owned -by GTK+ and must not be freed by the application. If you want -to store this information, you should make a copy. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename]</span> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-set-default-files"></a><h3>gtk_rc_set_default_files ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_rc_set_default_files (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **filenames</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_set_default_files</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> with a custom <a class="link" href="GtkStyleProvider.html" title="GtkStyleProvider"><span class="type">GtkStyleProvider</span></a> instead</p> -</div> -<p> -Sets the list of files that GTK+ will read at the -end of <a class="link" href="gtk3-General.html#gtk-init" title="gtk_init ()"><code class="function">gtk_init()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>filenames</code></em> :</span></p></td> -<td>A -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of filenames. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename]</span> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-parse-color"></a><h3>gtk_rc_parse_color ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gtk_rc_parse_color (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_parse_color</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead</p> -</div> -<p> -Parses a color in the format expected -in a RC file. -</p> -<p> -Note that theme engines should use <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-color-full" title="gtk_rc_parse_color_full ()"><code class="function">gtk_rc_parse_color_full()</code></a> in -order to support symbolic colors. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>scanner</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td> -<td>a pointer to a <a href="http://developer.gnome.org/gdk/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> structure in which to store -the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<code class="literal">G_TOKEN_NONE</code> if parsing succeeded, otherwise the token -that was expected but not found</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-parse-color-full"></a><h3>gtk_rc_parse_color_full ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gtk_rc_parse_color_full (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a> *style</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_parse_color_full</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead</p> -</div> -<p> -Parses a color in the format expected -in a RC file. If <em class="parameter"><code>style</code></em> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it will be consulted to resolve -references to symbolic colors. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>scanner</code></em> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td> -<td>a <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td> -<td>a pointer to a <a href="http://developer.gnome.org/gdk/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> structure in which to store -the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<code class="literal">G_TOKEN_NONE</code> if parsing succeeded, otherwise the token -that was expected but not found</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-parse-state"></a><h3>gtk_rc_parse_state ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gtk_rc_parse_state (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> *state</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_parse_state</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead</p> -</div> -<p> -Parses a <a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> variable from the format expected -in a RC file. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>scanner</code></em> :</span></p></td> -<td>a <span class="type">GtkScanner</span> (must be initialized for parsing an RC file)</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>state</code></em> :</span></p></td> -<td>A pointer to a <a class="link" href="gtk3-Standard-Enumerations.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> variable in which to -store the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<code class="literal">G_TOKEN_NONE</code> if parsing succeeded, otherwise the token -that was expected but not found.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-parse-priority"></a><h3>gtk_rc_parse_priority ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gtk_rc_parse_priority (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPathPriorityType" title="enum GtkPathPriorityType"><span class="type">GtkPathPriorityType</span></a> *priority</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_parse_priority</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead</p> -</div> -<p> -Parses a <a class="link" href="gtk3-Standard-Enumerations.html#GtkPathPriorityType" title="enum GtkPathPriorityType"><span class="type">GtkPathPriorityType</span></a> variable from the format expected -in a RC file. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>scanner</code></em> :</span></p></td> -<td>a <span class="type">GtkScanner</span> (must be initialized for parsing an RC file)</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td> -<td>A pointer to <a class="link" href="gtk3-Standard-Enumerations.html#GtkPathPriorityType" title="enum GtkPathPriorityType"><span class="type">GtkPathPriorityType</span></a> variable in which -to store the result.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<code class="literal">G_TOKEN_NONE</code> if parsing succeeded, otherwise the token -that was expected but not found.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-find-module-in-path"></a><h3>gtk_rc_find_module_in_path ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_rc_find_module_in_path (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *module_file</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_find_module_in_path</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Searches for a theme engine in the GTK+ search path. This function -is not useful for applications and should not be used. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>module_file</code></em> :</span></p></td> -<td>name of a theme engine</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The filename, if found (must be -freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>), otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-find-pixmap-in-path"></a><h3>gtk_rc_find_pixmap_in_path ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_rc_find_pixmap_in_path (<em class="parameter"><code><a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> *settings</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pixmap_file</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_find_pixmap_in_path</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Looks up a file in pixmap path for the specified <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a>. -If the file is not found, it outputs a warning message using -<a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a> and returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td> -<td>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>scanner</code></em> :</span></p></td> -<td>Scanner used to get line number information for the -warning message, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>pixmap_file</code></em> :</span></p></td> -<td>name of the pixmap file to locate.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the filename. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-get-module-dir"></a><h3>gtk_rc_get_module_dir ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_rc_get_module_dir (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_get_module_dir</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Returns a directory in which GTK+ looks for theme engines. -For full information about the search for theme engines, -see the docs for <code class="envar">GTK_PATH</code> in -<a class="xref" href="gtk-running.html" title="Running GTK+ Applications"><span class="refentrytitle">Running GTK+ Applications</span>(3)</a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the directory. (Must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>). <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-get-im-module-path"></a><h3>gtk_rc_get_im_module_path ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_rc_get_im_module_path (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_get_im_module_path</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Obtains the path in which to look for IM modules. See the documentation -of the <code class="envar">GTK_PATH</code> -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. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a newly-allocated string containing the -path in which to look for IM modules. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-get-im-module-file"></a><h3>gtk_rc_get_im_module_file ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_rc_get_im_module_file (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_get_im_module_file</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Obtains the path to the IM modules file. See the documentation -of the <code class="envar">GTK_IM_MODULE_FILE</code> -environment variable for more details. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a newly-allocated string containing the -name of the file listing the IM modules available for loading. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-get-theme-dir"></a><h3>gtk_rc_get_theme_dir ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_rc_get_theme_dir (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_get_theme_dir</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Returns the standard directory in which themes should -be installed. (GTK+ does not actually use this directory -itself.) -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The directory (must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>).</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-style-new"></a><h3>gtk_rc_style_new ()</h3> -<pre class="programlisting"><a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="returnvalue">GtkRcStyle</span></a> * gtk_rc_style_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_style_new</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Creates a new <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a> with no fields set and -a reference count of 1. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the newly-created <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a> -</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-rc-style-copy"></a><h3>gtk_rc_style_copy ()</h3> -<pre class="programlisting"><a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="returnvalue">GtkRcStyle</span></a> * gtk_rc_style_copy (<em class="parameter"><code><a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a> *orig</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_rc_style_copy</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead.</p> -</div> -<p> -Makes a copy of the specified <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a>. This function -will correctly copy an RC style that is a member of a class -derived from <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>orig</code></em> :</span></p></td> -<td>the style to copy</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the resulting <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -</div> -</div> -<div class="footer"> -<hr> - Generated by GTK-Doc V1.18.1</div> -</body> -</html>
\ No newline at end of file |