⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.10
Server IP:
157.245.101.34
Server:
Linux skvinfotech-website 5.4.0-131-generic #147-Ubuntu SMP Fri Oct 14 17:07:22 UTC 2022 x86_64
Server Software:
Apache/2.4.41 (Ubuntu)
PHP Version:
7.4.33
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
proc
/
self
/
root
/
usr
/
share
/
doc
/
libgtk-3-doc
/
gtk3
/
View File Name :
gtk3-Resource-Files.html
<!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: GTK+ 3 Reference Manual</title> <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> <link rel="home" href="index.html" title="GTK+ 3 Reference Manual"> <link rel="up" href="DeprecatedObjects.html" title="Deprecated"> <link rel="prev" href="gtk3-GtkGradient.html" title="GtkGradient"> <link rel="next" href="GtkStyle.html" title="GtkStyle"> <meta name="generator" content="GTK-Doc V1.32 (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="5"><tr valign="middle"> <td width="100%" align="left" class="shortcuts"> <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> <a href="#gtk3-Resource-Files.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> <a href="#gtk3-Resource-Files.object-hierarchy" class="shortcut">Object Hierarchy</a></span> </td> <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> <td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> <td><a accesskey="p" href="gtk3-GtkGradient.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> <td><a accesskey="n" href="GtkStyle.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></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 class="gallery_image" valign="top" align="right"></td> </tr></table></div> <div class="refsect1"> <a name="gtk3-Resource-Files.functions"></a><h2>Functions</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="functions_proto_type"> <col class="functions_proto_name"> </colgroup> <tbody> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#GScanner"><span class="returnvalue">GScanner</span></a> * </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-scanner-new" title="gtk_rc_scanner_new ()">gtk_rc_scanner_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="returnvalue">GtkStyle</span></a> * </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-get-style" title="gtk_rc_get_style ()">gtk_rc_get_style</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="returnvalue">GtkStyle</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse" title="gtk_rc_parse ()">gtk_rc_parse</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-string" title="gtk_rc_parse_string ()">gtk_rc_parse_string</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-reparse-all" title="gtk_rc_reparse_all ()">gtk_rc_reparse_all</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-reset-styles" title="gtk_rc_reset_styles ()">gtk_rc_reset_styles</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-color" title="gtk_rc_parse_color ()">gtk_rc_parse_color</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-state" title="gtk_rc_parse_state ()">gtk_rc_parse_state</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-parse-priority" title="gtk_rc_parse_priority ()">gtk_rc_parse_priority</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * </td> <td class="function_name"> <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> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="returnvalue">GtkRcStyle</span></a> * </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-style-new" title="gtk_rc_style_new ()">gtk_rc_style_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="returnvalue">GtkRcStyle</span></a> * </td> <td class="function_name"> <a class="link" href="gtk3-Resource-Files.html#gtk-rc-style-copy" title="gtk_rc_style_copy ()">gtk_rc_style_copy</a> <span class="c_punctuation">()</span> </td> </tr> </tbody> </table></div> </div> <a name="GtkRcStyle"></a><div class="refsect1"> <a name="gtk3-Resource-Files.other"></a><h2>Types and Values</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="other_proto_type"> <col class="other_proto_name"> </colgroup> <tbody> <tr> <td class="datatype_keyword"> </td> <td class="function_name"><a class="link" href="gtk3-Resource-Files.html#GtkRcStyle-struct" title="GtkRcStyle">GtkRcStyle</a></td> </tr> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="gtk3-Resource-Files.html#GtkRcStyleClass" title="struct GtkRcStyleClass">GtkRcStyleClass</a></td> </tr> <tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="gtk3-Resource-Files.html#GtkRcFlags" title="enum GtkRcFlags">GtkRcFlags</a></td> </tr> <tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="gtk3-Resource-Files.html#GtkRcTokenType" title="enum GtkRcTokenType">GtkRcTokenType</a></td> </tr> <tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="gtk3-Resource-Files.html#GtkPathPriorityType" title="enum GtkPathPriorityType">GtkPathPriorityType</a></td> </tr> <tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="gtk3-Resource-Files.html#GtkPathType" title="enum GtkPathType">GtkPathType</a></td> </tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="gtk3-Resource-Files.object-hierarchy"></a><h2>Object Hierarchy</h2> <pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> <span class="lineart">╰──</span> GtkRcStyle </pre> </div> <div class="refsect1"> <a name="gtk3-Resource-Files.includes"></a><h2>Includes</h2> <pre class="synopsis">#include <gtk/gtk.h> </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> <div class="blockquote"><blockquote class="blockquote"><p>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>.</p></blockquote></div> <div class="refsect2"> <a name="id-1.3.25.4.8.4"></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="literal">SYSCONFDIR/gtk-2.0/gtkrc</code> and <code class="literal">.gtkrc-3.0</code> in the users home directory. (<code class="literal">SYSCONFDIR</code> defaults to <code class="literal">/usr/local/etc</code>. It can be changed with the <code class="literal">--prefix</code> or <code class="literal">--sysconfdir</code> options when configuring GTK+.)</p> <p>The set of these “default” 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="literal">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> </div> <hr> <div class="refsect2"> <a name="locale-specific-rc"></a><h3>Locale Specific Files</h3> <p>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="literal">LANG</code> is set to <code class="literal">ja_JP.ujis</code>, when loading the default file <code class="literal">~/.gtkrc</code> then GTK+ looks for <code class="literal">~/.gtkrc.ja_JP</code> and <code class="literal">~/.gtkrc.ja</code>, and parses the first of those that exists.</p> </div> <hr> <div class="refsect2"> <a name="id-1.3.25.4.8.6"></a><h3>Pathnames and Patterns</h3> <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> <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="n">widget</span> <span class="s">"mywindow.*.GtkEntry"</span> <span class="n">style</span> <span class="s">"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 “widget path” matches the “pattern” <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 “class path” 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 <classname> 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="n">widget_class</span> <span class="s">"*<GtkMenuItem>.GtkLabel"</span> <span class="n">style</span> <span class="s">"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="n">class</span> <span class="s">"GtkButton"</span> <span class="n">style</span> <span class="s">"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> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"><p><code class="literal">highest</code></p></li> <li class="listitem"><p><code class="literal">rc</code></p></li> <li class="listitem"><p><code class="literal">theme</code></p></li> <li class="listitem"><p><code class="literal">application</code></p></li> <li class="listitem"><p><code class="literal">gtk</code></p></li> <li class="listitem"><p><code class="literal">lowest</code></p></li> </ul></div> <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> <hr> <div class="refsect2"> <a name="id-1.3.25.4.8.7"></a><h3>Theme gtkrc Files</h3> <p>Theme RC files are loaded first from under the <code class="literal">~/.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="literal">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="literal">gtk-3.0/gtkrc-dark</code> will be loaded first, and if not present <code class="literal">gtk-3.0/gtkrc</code> will be loaded.</p> </div> <hr> <div class="refsect2"> <a name="id-1.3.25.4.8.8"></a><h3>Optimizing RC Style Matches</h3> <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> <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="n">style</span> <span class="s">"Foo"</span> <span class="p">{</span> <span class="n">foo_content</span> <span class="p">}</span> <span class="n">class</span> <span class="s">"X"</span> <span class="n">style</span> <span class="s">"Foo"</span> <span class="n">style</span> <span class="s">"Bar"</span> <span class="p">{</span> <span class="n">bar_content</span> <span class="p">}</span> <span class="n">class</span> <span class="s">"X"</span> <span class="n">style</span> <span class="s">"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="n">style</span> <span class="s">"FooBar"</span> <span class="p">{</span> <span class="n">foo_content</span> <span class="n">bar_content</span> <span class="p">}</span> <span class="n">class</span> <span class="s">"X"</span> <span class="n">style</span> <span class="s">"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> </div> <hr> <div class="refsect2"> <a name="id-1.3.25.4.8.9"></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> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"> <p><code class="literal">binding name { ... }</code></p> <p>Declares a binding set.</p> </li> <li class="listitem"> <p><code class="literal">class pattern [ style | binding ][ : priority ] name</code></p> <p>Specifies a style or binding set for a particular branch of the inheritance hierarchy.</p> </li> <li class="listitem"> <p><code class="literal">include filename</code></p> <p>Parses another file at this point. If filename 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" title="Locale Specific Files">locale-specific variant</a> of the included file.</p> </li> <li class="listitem"> <p><code class="literal">module_path path</code></p> <p>Sets a path (a list of directories separated by colons) that will be searched for theme engines referenced in RC files.</p> </li> <li class="listitem"> <p><code class="literal">pixmap_path path</code></p> <p>Sets a path (a list of directories separated by colons) that will be searched for pixmaps referenced in RC files.</p> </li> <li class="listitem"> <p><code class="literal">im_module_file pathname</code></p> <p>Sets the pathname for the IM modules file. Setting this from RC files is deprecated; you should use the environment variable <code class="literal">GTK_IM_MODULE_FILE</code> instead.</p> </li> <li class="listitem"> <p><code class="literal">style name [ = parent ] { ... }</code></p> <p>Declares a style.</p> </li> <li class="listitem"> <p><code class="literal">widget pattern [ style | binding ][ : priority ] name</code></p> <p> Specifies a style or binding set for a particular group of widgets by matching on the widget pathname.</p> </li> <li class="listitem"> <p><code class="literal">widget_class pattern [ style | binding ][ : priority ] name</code></p> <p> Specifies a style or binding set for a particular group of widgets by matching on the class pathname.</p> </li> <li class="listitem"> <p>setting = value</p> <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> </li> </ul></div> </div> <hr> <div class="refsect2"> <a name="id-1.3.25.4.8.10"></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> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"> <p><code class="literal">bg[state] = color</code></p> <p>Sets the color used for the background of most widgets.</p> </li> <li class="listitem"> <p><code class="literal">fg[state] = color</code></p> <p>Sets the color used for the foreground of most widgets.</p> </li> <li class="listitem"> <p><code class="literal">base[state] = color</code></p> <p> Sets the color used for the background of widgets displaying editable text. This color is used for the background of, among others, <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a>, <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p> </li> <li class="listitem"> <p><code class="literal">text[state] = color</code></p> <p> Sets the color used for foreground of widgets using <code class="literal">base</code> for the background color.</p> </li> <li class="listitem"> <p><code class="literal">xthickness = number</code></p> <p> Sets the xthickness, which is used for various horizontal padding values in GTK+.</p> </li> <li class="listitem"> <p><code class="literal">ythickness = number</code></p> <p> Sets the ythickness, which is used for various vertical padding values in GTK+.</p> </li> <li class="listitem"> <p><code class="literal">bg_pixmap[state] = pixmap</code></p> <p> Sets a background pixmap to be used in place of the <code class="literal">bg</code> color (or for <span class="type">GtkText</span>, in place of the <code class="literal">base</code> color. The special value <code class="literal">"&lt;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">"&lt;none>"</code> may be used to indicate no background pixmap.</p> </li> <li class="listitem"> <p><code class="literal">font = font</code></p> <p> Starting with GTK+ 2.0, the “font” and “fontset” declarations are ignored; use “font_name” declarations instead.</p> </li> <li class="listitem"> <p><code class="literal">fontset = font</code></p> <p> Starting with GTK+ 2.0, the “font” and “fontset” declarations are ignored; use “font_name” declarations instead.</p> </li> <li class="listitem"> <p><code class="literal">font_name = font</code></p> <p> Sets the font for a widget. font must be a Pango font name, e.g. “Sans Italic 10” . For details about Pango font names, see <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-from-string"><code class="function">pango_font_description_from_string()</code></a>.</p> </li> <li class="listitem"> <p><code class="literal">stock["stock-id"] = { icon source specifications }</code></p> <p> Defines the icon for a stock item.</p> </li> <li class="listitem"> <p><code class="literal">color["color-name"] = color specification</code></p> <p> Since 2.10, this element can be used to defines symbolic colors. See below for the syntax of color specifications.</p> </li> <li class="listitem"> <p><code class="literal">engine "engine" { engine-specific settings }</code></p> <p> Defines the engine to be used when drawing with this style.</p> </li> <li class="listitem"> <p><code class="literal">class::property = value</code></p> <p> Sets a style property for a widget class.</p> </li> </ul></div> <p>The colors and background pixmaps are specified as a function of the state of the widget. The states are:</p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"> <p><code class="literal">NORMAL</code></p> <p> A color used for a widget in its normal state.</p> </li> <li class="listitem"> <p><code class="literal">ACTIVE</code></p> <p> A variant of the <code class="literal">NORMAL</code> color used when the widget is in the <a class="link" href="GtkWidget.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.</p> </li> <li class="listitem"> <p><code class="literal">PRELIGHT</code></p> <p> A color used for widgets in the <a class="link" href="GtkWidget.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.</p> </li> <li class="listitem"> <p><code class="literal">SELECTED</code></p> <p> 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.</p> </li> <li class="listitem"> <p><code class="literal">INSENSITIVE</code></p> <p> 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>.</p> </li> </ul></div> <div class="refsect3"> <a name="color-format"></a><h4>Color Format</h4> <p>Colors can be specified as a string containing a color name (GTK+ knows all names from the X color database <code class="literal">/usr/lib/X11/rgb.txt</code>), in one of the hexadecimal forms <code class="literal">#rrrrggggbbbb</code>, <code class="literal">#rrrgggbbb</code>, <code class="literal">#rrggbb</code>, or <code class="literal">#rgb</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">{ r, g, b}</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="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"> <p>mix (factor, color1, color2)</p> <p> Computes a new color by mixing color1 and color2. The factor determines how close the new color is to color1. A factor of 1.0 gives pure color1, a factor of 0.0 gives pure color2.</p> </li> <li class="listitem"> <p>shade (factor, color)</p> <p> Computes a lighter or darker variant of color. A factor of 1.0 leaves the color unchanged, smaller factors yield darker colors, larger factors yield lighter colors.</p> </li> <li class="listitem"> <p>lighter (color)</p> <p> This is an abbreviation for <code class="literal">shade (1.3, color)</code>.</p> </li> <li class="listitem"> <p>darker (color)</p> <p> This is an abbreviation for <code class="literal">shade (0.7, color)</code>.</p> </li> </ul></div> <p>Here are some examples of color expressions:</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="n">mix</span> <span class="p">(</span><span class="mf">0.5</span><span class="p">,</span> <span class="s">"red"</span><span class="p">,</span> <span class="s">"blue"</span><span class="p">)</span> <span class="n">shade</span> <span class="p">(</span><span class="mf">1.5</span><span class="p">,</span> <span class="n">mix</span> <span class="p">(</span><span class="mf">0.3</span><span class="p">,</span> <span class="s">"#0abbc0"</span><span class="p">,</span> <span class="p">{</span> <span class="mf">0.3</span><span class="p">,</span> <span class="mf">0.5</span><span class="p">,</span> <span class="mf">0.9</span> <span class="p">}))</span> <span class="n">lighter</span> <span class="p">(</span><span class="err">@</span><span class="n">foreground</span><span class="p">)</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> <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="n">stock</span><span class="p">[</span><span class="s">"my-stock-item"</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span> <span class="p">{</span> <span class="s">"itemltr.png"</span><span class="p">,</span> <span class="n">LTR</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="o">*</span> <span class="p">},</span> <span class="p">{</span> <span class="s">"itemrtl.png"</span><span class="p">,</span> <span class="n">RTL</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="o">*</span> <span class="p">}</span> <span class="p">}</span></pre></td> </tr> </tbody> </table> </div> <p></p> <p>This could be abbreviated as follows:</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="n">stock</span><span class="p">[</span><span class="s">"my-stock-item"</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span> <span class="p">{</span> <span class="s">"itemltr.png"</span><span class="p">,</span> <span class="n">LTR</span> <span class="p">},</span> <span class="p">{</span> <span class="s">"itemrtl.png"</span><span class="p">,</span> <span class="n">RTL</span> <span class="p">}</span> <span class="p">}</span></pre></td> </tr> </tbody> </table> </div> <p></p> <p>You can specify custom icons for specific sizes, as follows:</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="n">stock</span><span class="p">[</span><span class="s">"my-stock-item"</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span> <span class="p">{</span> <span class="s">"itemmenusize.png"</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="s">"gtk-menu"</span> <span class="p">},</span> <span class="p">{</span> <span class="s">"itemtoolbarsize.png"</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="s">"gtk-large-toolbar"</span> <span class="p">}</span> <span class="p">{</span> <span class="s">"itemgeneric.png"</span> <span class="p">}</span> <span class="c1">// implicit *, *, * as a fallback</span> <span class="p">}</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> <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="n">stock</span><span class="p">[</span><span class="s">"my-stock-item"</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span> <span class="p">{</span> <span class="s">"itemprelight.png"</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">PRELIGHT</span> <span class="p">},</span> <span class="p">{</span> <span class="s">"iteminsensitive.png"</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">INSENSITIVE</span> <span class="p">},</span> <span class="p">{</span> <span class="s">"itemgeneric.png"</span> <span class="p">}</span> <span class="c1">// implicit *, *, * as a fallback</span> <span class="p">}</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> </div> <hr> <div class="refsect2"> <a name="id-1.3.25.4.8.11"></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> <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="n">binding</span> <span class="n">name</span> <span class="p">{</span> <span class="n">bind</span> <span class="n">key</span> <span class="p">{</span> <span class="n">signalname</span> <span class="p">(</span><span class="n">param</span><span class="p">,</span> <span class="p">...)</span> <span class="p">...</span> <span class="p">}</span> <span class="p">...</span> <span class="p">}</span></pre></td> </tr> </tbody> </table> </div> <p></p> <p><code class="literal">key</code> is a string consisting of a series of modifiers followed by the name of a key. The modifiers can be:</p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"><p><code class="literal"><alt></code></p></li> <li class="listitem"><p><code class="literal"><ctl></code></p></li> <li class="listitem"><p><code class="literal"><control></code></p></li> <li class="listitem"><p><code class="literal"><meta></code></p></li> <li class="listitem"><p><code class="literal"><hyper></code></p></li> <li class="listitem"><p><code class="literal"><super></code></p></li> <li class="listitem"><p><code class="literal"><mod1></code></p></li> <li class="listitem"><p><code class="literal"><mod2></code></p></li> <li class="listitem"><p><code class="literal"><mod3></code></p></li> <li class="listitem"><p><code class="literal"><mod4></code></p></li> <li class="listitem"><p><code class="literal"><mod5></code></p></li> <li class="listitem"><p><code class="literal"><release></code></p></li> <li class="listitem"><p><code class="literal"><shft></code></p></li> <li class="listitem"><p><code class="literal"><shift></code></p></li> </ul></div> <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="/usr/share/gtk-doc/html/gobject/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> </div> <div class="refsect1"> <a name="gtk3-Resource-Files.functions_details"></a><h2>Functions</h2> <div class="refsect2"> <a name="gtk-rc-scanner-new"></a><h3>gtk_rc_scanner_new ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/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"> <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.</p> <p>Use <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> instead</p> </div> <p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p> </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"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-get-style.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>widget</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-get-style.returns"></a><h4>Returns</h4> <p>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. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </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="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>);</pre> <div class="warning"> <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.</p> <p>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="n">gtk_widget_path</span> <span class="p">(</span><span class="n">widget</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> <span class="o">&</span><span class="n">path</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span> <span class="n">gtk_widget_class_path</span> <span class="p">(</span><span class="n">widget</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> <span class="o">&</span><span class="n">class_path</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span> <span class="n">gtk_rc_get_style_by_paths</span> <span class="p">(</span><span class="n">gtk_widget_get_settings</span> <span class="p">(</span><span class="n">widget</span><span class="p">),</span> <span class="n">path</span><span class="p">,</span> <span class="n">class_path</span><span class="p">,</span> <span class="n">G_OBJECT_TYPE</span> <span class="p">(</span><span class="n">widget</span><span class="p">));</span></pre></td> </tr> </tbody> </table> </div> <p></p> <div class="refsect3"> <a name="gtk-rc-get-style-by-paths.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>settings</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a> object</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>widget_path</p></td> <td class="parameter_description"><p>the widget path to use when looking up the style, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no matching against the widget path should be done. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>class_path</p></td> <td class="parameter_description"><p>the class path to use when looking up the style, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no matching against the class path should be done. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>type</p></td> <td class="parameter_description"><p>a type that will be used along with parent types of this type when matching against class styles, or <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-TYPE-NONE:CAPS"><span class="type">G_TYPE_NONE</span></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-get-style-by-paths.returns"></a><h4>Returns</h4> <p>A style created by matching with the supplied paths, or <a href="/usr/share/gtk-doc/html/glib/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="/usr/share/gtk-doc/html/gobject/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. </p> <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre> <div class="warning"> <p><code class="literal">gtk_rc_parse</code> has been deprecated since version 3.0 and should not be used in newly-written code.</p> <p>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="refsect3"> <a name="gtk-rc-parse.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>filename</p></td> <td class="parameter_description"><p>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.</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *rc_string</code></em>);</pre> <div class="warning"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-parse-string.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>rc_string</p></td> <td class="parameter_description"><p>a string to parse.</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="gtk-rc-reparse-all"></a><h3>gtk_rc_reparse_all ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/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"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-reparse-all.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the files were reread.</p> </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="/usr/share/gtk-doc/html/glib/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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> force_load</code></em>);</pre> <div class="warning"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-reparse-all-for-settings.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>settings</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>force_load</p></td> <td class="parameter_description"><p>load whether or not anything changed</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-reparse-all-for-settings.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the files were reread.</p> </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"> <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.</p> <p>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="../html/GdkScreen.html#GdkScreen-struct"><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 explicitly 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="refsect3"> <a name="gtk-rc-reset-styles.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>settings</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre> <div class="warning"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-add-default-file.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>filename</p></td> <td class="parameter_description"><p>the pathname to the file. If <em class="parameter"><code>filename</code></em> is not absolute, it is searched in the current directory. </p></td> <td class="parameter_annotations"><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> </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="/usr/share/gtk-doc/html/glib/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"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-get-default-files.returns"></a><h4>Returns</h4> <p>A <a href="/usr/share/gtk-doc/html/glib/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. </p> <p><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></p> </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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **filenames</code></em>);</pre> <div class="warning"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-set-default-files.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>filenames</p></td> <td class="parameter_description"><p>A <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of filenames. </p></td> <td class="parameter_annotations"><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> </div> <hr> <div class="refsect2"> <a name="gtk-rc-parse-color"></a><h3>gtk_rc_parse_color ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gtk_rc_parse_color (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, <em class="parameter"><code><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre> <div class="warning"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-parse-color.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>scanner</p></td> <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>color</p></td> <td class="parameter_description"><p>a pointer to a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> in which to store the result. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-parse-color.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#G-TOKEN-NONE:CAPS"><code class="literal">G_TOKEN_NONE</code></a> if parsing succeeded, otherwise the token that was expected but not found</p> </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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gtk_rc_parse_color_full (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *color</code></em>);</pre> <div class="warning"> <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.</p> <p>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="/usr/share/gtk-doc/html/glib/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="refsect3"> <a name="gtk-rc-parse-color-full.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>scanner</p></td> <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>style</p></td> <td class="parameter_description"><p>a <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><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 class="parameter_name"><p>color</p></td> <td class="parameter_description"><p>a pointer to a <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> in which to store the result. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-parse-color-full.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#G-TOKEN-NONE:CAPS"><code class="literal">G_TOKEN_NONE</code></a> if parsing succeeded, otherwise the token that was expected but not found</p> </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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gtk_rc_parse_state (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> *state</code></em>);</pre> <div class="warning"> <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.</p> <p>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="GtkWidget.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> variable from the format expected in a RC file.</p> <div class="refsect3"> <a name="gtk-rc-parse-state.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>scanner</p></td> <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> (must be initialized for parsing an RC file)</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>state</p></td> <td class="parameter_description"><p>A pointer to a <a class="link" href="GtkWidget.html#GtkStateType" title="enum GtkStateType"><span class="type">GtkStateType</span></a> variable in which to store the result. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-parse-state.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#G-TOKEN-NONE:CAPS"><code class="literal">G_TOKEN_NONE</code></a> if parsing succeeded, otherwise the token that was expected but not found.</p> </div> </div> <hr> <div class="refsect2"> <a name="gtk-rc-parse-priority"></a><h3>gtk_rc_parse_priority ()</h3> <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gtk_rc_parse_priority (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/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#GtkPathPriorityType" title="enum GtkPathPriorityType"><span class="type">GtkPathPriorityType</span></a> *priority</code></em>);</pre> <div class="warning"> <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.</p> <p>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-Resource-Files.html#GtkPathPriorityType" title="enum GtkPathPriorityType"><span class="type">GtkPathPriorityType</span></a> variable from the format expected in a RC file.</p> <div class="refsect3"> <a name="gtk-rc-parse-priority.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>scanner</p></td> <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> (must be initialized for parsing an RC file)</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>priority</p></td> <td class="parameter_description"><p>A pointer to <a class="link" href="gtk3-Resource-Files.html#GtkPathPriorityType" title="enum GtkPathPriorityType"><span class="type">GtkPathPriorityType</span></a> variable in which to store the result.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-parse-priority.returns"></a><h4>Returns</h4> <p> <a href="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#G-TOKEN-NONE:CAPS"><code class="literal">G_TOKEN_NONE</code></a> if parsing succeeded, otherwise the token that was expected but not found.</p> </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="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_rc_find_module_in_path (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *module_file</code></em>);</pre> <div class="warning"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-find-module-in-path.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>module_file</p></td> <td class="parameter_description"><p>name of a theme engine</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-find-module-in-path.returns"></a><h4>Returns</h4> <p>The filename, if found (must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>), otherwise <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p> </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="/usr/share/gtk-doc/html/glib/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="/usr/share/gtk-doc/html/glib/glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> *scanner</code></em>, <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pixmap_file</code></em>);</pre> <div class="warning"> <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.</p> <p>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="/usr/share/gtk-doc/html/glib/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a> and returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p> <div class="refsect3"> <a name="gtk-rc-find-pixmap-in-path.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>settings</p></td> <td class="parameter_description"><p>a <a class="link" href="GtkSettings.html" title="Settings"><span class="type">GtkSettings</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>scanner</p></td> <td class="parameter_description"><p>Scanner used to get line number information for the warning message, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>pixmap_file</p></td> <td class="parameter_description"><p>name of the pixmap file to locate.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-find-pixmap-in-path.returns"></a><h4>Returns</h4> <p>the filename. </p> <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p> </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="/usr/share/gtk-doc/html/glib/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"> <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.</p> <p>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="literal">GTK_PATH</code> in <a class="link" href="gtk-running.html" title="Running GTK+ Applications">Running GTK+ Applications</a>.</p> <div class="refsect3"> <a name="gtk-rc-get-module-dir.returns"></a><h4>Returns</h4> <p>the directory. (Must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>). </p> <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p> </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="/usr/share/gtk-doc/html/glib/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"> <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.</p> <p>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="literal">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="refsect3"> <a name="gtk-rc-get-im-module-path.returns"></a><h4>Returns</h4> <p>a newly-allocated string containing the path in which to look for IM modules. </p> <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p> </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="/usr/share/gtk-doc/html/glib/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"> <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.</p> <p>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="literal">GTK_IM_MODULE_FILE</code> environment variable for more details.</p> <div class="refsect3"> <a name="gtk-rc-get-im-module-file.returns"></a><h4>Returns</h4> <p>a newly-allocated string containing the name of the file listing the IM modules available for loading. </p> <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p> </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="/usr/share/gtk-doc/html/glib/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"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-get-theme-dir.returns"></a><h4>Returns</h4> <p> The directory (must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>).</p> </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"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-style-new.returns"></a><h4>Returns</h4> <p> the newly-created <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a></p> </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"> <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.</p> <p>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="refsect3"> <a name="gtk-rc-style-copy.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>orig</p></td> <td class="parameter_description"><p>the style to copy</p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-rc-style-copy.returns"></a><h4>Returns</h4> <p>the resulting <a class="link" href="gtk3-Resource-Files.html#GtkRcStyle"><span class="type">GtkRcStyle</span></a>. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> </div> </div> <div class="refsect1"> <a name="gtk3-Resource-Files.other_details"></a><h2>Types and Values</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-struct" title="GtkRcStyle"><span class="type">GtkRcStyle</span></a> 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-struct" title="GtkRcStyle"><span class="type">GtkRcStyle</span></a><!-- -->s to form a <a class="link" href="GtkStyle.html" title="GtkStyle"><span class="type">GtkStyle</span></a>.</p> <div class="refsect3"> <a name="GtkRcStyle.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="struct_members_name"> <col class="struct_members_description"> <col width="200px" class="struct_members_annotations"> </colgroup> <tbody> <tr> <td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GtkRcStyle-struct.name"></a>name</code></em>;</p></td> <td class="struct_member_description"><p>Name</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GtkRcStyle-struct.bg-pixmap-name"></a>bg_pixmap_name</code></em>[5];</p></td> <td class="struct_member_description"><p>Pixmap name</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontDescription-struct"><span class="type">PangoFontDescription</span></a> *<em class="structfield"><code><a name="GtkRcStyle-struct.font-desc"></a>font_desc</code></em>;</p></td> <td class="struct_member_description"><p>A <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontDescription-struct"><span class="type">PangoFontDescription</span></a></p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><a class="link" href="gtk3-Resource-Files.html#GtkRcFlags" title="enum GtkRcFlags"><span class="type">GtkRcFlags</span></a> <em class="structfield"><code><a name="GtkRcStyle-struct.color-flags"></a>color_flags</code></em>[5];</p></td> <td class="struct_member_description"><p><a class="link" href="gtk3-Resource-Files.html#GtkRcFlags" title="enum GtkRcFlags"><span class="type">GtkRcFlags</span></a></p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkRcStyle-struct.fg"></a>fg</code></em>[5];</p></td> <td class="struct_member_description"><p>Foreground colors</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkRcStyle-struct.bg"></a>bg</code></em>[5];</p></td> <td class="struct_member_description"><p>Background colors</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkRcStyle-struct.text"></a>text</code></em>[5];</p></td> <td class="struct_member_description"><p>Text colors</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> <em class="structfield"><code><a name="GtkRcStyle-struct.base"></a>base</code></em>[5];</p></td> <td class="struct_member_description"><p>Base colors</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GtkRcStyle-struct.xthickness"></a>xthickness</code></em>;</p></td> <td class="struct_member_description"><p>X thickness</p></td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GtkRcStyle-struct.ythickness"></a>ythickness</code></em>;</p></td> <td class="struct_member_description"><p>Y thickness</p></td> <td class="struct_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="GtkRcStyleClass"></a><h3>struct GtkRcStyleClass</h3> <pre class="programlisting">struct GtkRcStyleClass { GObjectClass parent_class; /* Create an empty RC style of the same type as this RC style. * The default implementation, which does * g_object_new (G_OBJECT_TYPE (style), NULL); * should work in most cases. */ GtkRcStyle * (*create_rc_style) (GtkRcStyle *rc_style); /* Fill in engine specific parts of GtkRcStyle by parsing contents * of brackets. Returns G_TOKEN_NONE if successful, otherwise returns * the token it expected but didn't get. */ guint (*parse) (GtkRcStyle *rc_style, GtkSettings *settings, GScanner *scanner); /* Combine RC style data from src into dest. If overridden, this * function should chain to the parent. */ void (*merge) (GtkRcStyle *dest, GtkRcStyle *src); /* Create an empty style suitable to this RC style */ GtkStyle * (*create_style) (GtkRcStyle *rc_style); }; </pre> <div class="refsect3"> <a name="GtkRcStyleClass.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="struct_members_name"> <col class="struct_members_description"> <col width="200px" class="struct_members_annotations"> </colgroup> <tbody> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkRcStyleClass.create-rc-style"></a>create_rc_style</code></em> ()</p></td> <td class="struct_member_description"> </td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkRcStyleClass.parse"></a>parse</code></em> ()</p></td> <td class="struct_member_description"> </td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkRcStyleClass.merge"></a>merge</code></em> ()</p></td> <td class="struct_member_description"> </td> <td class="struct_member_annotations"> </td> </tr> <tr> <td class="struct_member_name"><p><em class="structfield"><code><a name="GtkRcStyleClass.create-style"></a>create_style</code></em> ()</p></td> <td class="struct_member_description"> </td> <td class="struct_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="GtkRcFlags"></a><h3>enum GtkRcFlags</h3> <p>Deprecated</p> <div class="refsect3"> <a name="GtkRcFlags.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> <col class="enum_members_description"> <col width="200px" class="enum_members_annotations"> </colgroup> <tbody> <tr> <td class="enum_member_name"><p><a name="GTK-RC-FG:CAPS"></a>GTK_RC_FG</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-BG:CAPS"></a>GTK_RC_BG</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TEXT:CAPS"></a>GTK_RC_TEXT</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-BASE:CAPS"></a>GTK_RC_BASE</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="GtkRcTokenType"></a><h3>enum GtkRcTokenType</h3> <div class="warning"> <p><code class="literal">GtkRcTokenType</code> has been deprecated since version 3.0 and should not be used in newly-written code.</p> <p>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 class="refsect3"> <a name="GtkRcTokenType.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> <col class="enum_members_description"> <col width="200px" class="enum_members_annotations"> </colgroup> <tbody> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-INVALID:CAPS"></a>GTK_RC_TOKEN_INVALID</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-INCLUDE:CAPS"></a>GTK_RC_TOKEN_INCLUDE</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-NORMAL:CAPS"></a>GTK_RC_TOKEN_NORMAL</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-ACTIVE:CAPS"></a>GTK_RC_TOKEN_ACTIVE</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-PRELIGHT:CAPS"></a>GTK_RC_TOKEN_PRELIGHT</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-SELECTED:CAPS"></a>GTK_RC_TOKEN_SELECTED</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-INSENSITIVE:CAPS"></a>GTK_RC_TOKEN_INSENSITIVE</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-FG:CAPS"></a>GTK_RC_TOKEN_FG</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-BG:CAPS"></a>GTK_RC_TOKEN_BG</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-TEXT:CAPS"></a>GTK_RC_TOKEN_TEXT</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-BASE:CAPS"></a>GTK_RC_TOKEN_BASE</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-XTHICKNESS:CAPS"></a>GTK_RC_TOKEN_XTHICKNESS</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-YTHICKNESS:CAPS"></a>GTK_RC_TOKEN_YTHICKNESS</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-FONT:CAPS"></a>GTK_RC_TOKEN_FONT</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-FONTSET:CAPS"></a>GTK_RC_TOKEN_FONTSET</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-FONT-NAME:CAPS"></a>GTK_RC_TOKEN_FONT_NAME</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-BG-PIXMAP:CAPS"></a>GTK_RC_TOKEN_BG_PIXMAP</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-PIXMAP-PATH:CAPS"></a>GTK_RC_TOKEN_PIXMAP_PATH</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-STYLE:CAPS"></a>GTK_RC_TOKEN_STYLE</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-BINDING:CAPS"></a>GTK_RC_TOKEN_BINDING</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-BIND:CAPS"></a>GTK_RC_TOKEN_BIND</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-WIDGET:CAPS"></a>GTK_RC_TOKEN_WIDGET</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-WIDGET-CLASS:CAPS"></a>GTK_RC_TOKEN_WIDGET_CLASS</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-CLASS:CAPS"></a>GTK_RC_TOKEN_CLASS</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-LOWEST:CAPS"></a>GTK_RC_TOKEN_LOWEST</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-GTK:CAPS"></a>GTK_RC_TOKEN_GTK</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-APPLICATION:CAPS"></a>GTK_RC_TOKEN_APPLICATION</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-THEME:CAPS"></a>GTK_RC_TOKEN_THEME</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-RC:CAPS"></a>GTK_RC_TOKEN_RC</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-HIGHEST:CAPS"></a>GTK_RC_TOKEN_HIGHEST</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-ENGINE:CAPS"></a>GTK_RC_TOKEN_ENGINE</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-MODULE-PATH:CAPS"></a>GTK_RC_TOKEN_MODULE_PATH</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-IM-MODULE-PATH:CAPS"></a>GTK_RC_TOKEN_IM_MODULE_PATH</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-IM-MODULE-FILE:CAPS"></a>GTK_RC_TOKEN_IM_MODULE_FILE</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-STOCK:CAPS"></a>GTK_RC_TOKEN_STOCK</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-LTR:CAPS"></a>GTK_RC_TOKEN_LTR</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-RTL:CAPS"></a>GTK_RC_TOKEN_RTL</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-COLOR:CAPS"></a>GTK_RC_TOKEN_COLOR</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-UNBIND:CAPS"></a>GTK_RC_TOKEN_UNBIND</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-RC-TOKEN-LAST:CAPS"></a>GTK_RC_TOKEN_LAST</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="GtkPathPriorityType"></a><h3>enum GtkPathPriorityType</h3> <div class="warning"><p><code class="literal">GtkPathPriorityType</code> has been deprecated since version 3.0 and should not be used in newly-written code.</p></div> <p>Priorities for path lookups. See also <a class="link" href="gtk3-Bindings.html#gtk-binding-set-add-path" title="gtk_binding_set_add_path ()"><code class="function">gtk_binding_set_add_path()</code></a>.</p> <div class="refsect3"> <a name="GtkPathPriorityType.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> <col class="enum_members_description"> <col width="200px" class="enum_members_annotations"> </colgroup> <tbody> <tr> <td class="enum_member_name"><p><a name="GTK-PATH-PRIO-LOWEST:CAPS"></a>GTK_PATH_PRIO_LOWEST</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-PATH-PRIO-GTK:CAPS"></a>GTK_PATH_PRIO_GTK</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-PATH-PRIO-APPLICATION:CAPS"></a>GTK_PATH_PRIO_APPLICATION</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-PATH-PRIO-THEME:CAPS"></a>GTK_PATH_PRIO_THEME</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-PATH-PRIO-RC:CAPS"></a>GTK_PATH_PRIO_RC</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-PATH-PRIO-HIGHEST:CAPS"></a>GTK_PATH_PRIO_HIGHEST</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> <hr> <div class="refsect2"> <a name="GtkPathType"></a><h3>enum GtkPathType</h3> <div class="warning"><p><code class="literal">GtkPathType</code> has been deprecated since version 3.0 and should not be used in newly-written code.</p></div> <p>Widget path types. See also <a class="link" href="gtk3-Bindings.html#gtk-binding-set-add-path" title="gtk_binding_set_add_path ()"><code class="function">gtk_binding_set_add_path()</code></a>.</p> <div class="refsect3"> <a name="GtkPathType.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> <col class="enum_members_description"> <col width="200px" class="enum_members_annotations"> </colgroup> <tbody> <tr> <td class="enum_member_name"><p><a name="GTK-PATH-WIDGET:CAPS"></a>GTK_PATH_WIDGET</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-PATH-WIDGET-CLASS:CAPS"></a>GTK_PATH_WIDGET_CLASS</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> <td class="enum_member_name"><p><a name="GTK-PATH-CLASS:CAPS"></a>GTK_PATH_CLASS</p></td> <td class="enum_member_description"> <p>Deprecated</p> </td> <td class="enum_member_annotations"> </td> </tr> </tbody> </table></div> </div> </div> </div> </div> <div class="footer"> <hr>Generated by GTK-Doc V1.32</div> </body> </html>