2270 lines
111 KiB
HTML
2270 lines
111 KiB
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 Vsnapshot">
|
||
<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.33.1 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="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">
|
||
<span class="returnvalue">GScanner</span> *
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">gchar</span> **
|
||
</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">
|
||
<span class="returnvalue">guint</span>
|
||
</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">
|
||
<span class="returnvalue">guint</span>
|
||
</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">
|
||
<span class="returnvalue">guint</span>
|
||
</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">
|
||
<span class="returnvalue">guint</span>
|
||
</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">
|
||
<span class="returnvalue">gchar</span> *
|
||
</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">
|
||
<span class="returnvalue">gchar</span> *
|
||
</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">
|
||
<span class="returnvalue">gchar</span> *
|
||
</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">
|
||
<span class="returnvalue">gchar</span> *
|
||
</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">
|
||
<span class="returnvalue">gchar</span> *
|
||
</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">
|
||
<span class="returnvalue">gchar</span> *
|
||
</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"> GObject
|
||
<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="w"> </span><span class="s">"mywindow.*.GtkEntry"</span><span class="w"> </span><span class="n">style</span><span class="w"> </span><span class="s">"my-entry-class"</span><span class="w"></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="w"> </span><span class="s">"*<GtkMenuItem>.GtkLabel"</span><span class="w"> </span><span class="n">style</span><span class="w"> </span><span class="s">"my-style"</span><span class="w"></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="w"> </span><span class="s">"GtkButton"</span><span class="w"> </span><span class="n">style</span><span class="w"> </span><span class="s">"my-style"</span><span class="w"></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="w"> </span><span class="s">"Foo"</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">foo_content</span><span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="n">class</span><span class="w"> </span><span class="s">"X"</span><span class="w"> </span><span class="n">style</span><span class="w"> </span><span class="s">"Foo"</span><span class="w"></span>
|
||
<span class="n">style</span><span class="w"> </span><span class="s">"Bar"</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">bar_content</span><span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="n">class</span><span class="w"> </span><span class="s">"X"</span><span class="w"> </span><span class="n">style</span><span class="w"> </span><span class="s">"Bar"</span><span class="w"></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="w"> </span><span class="s">"FooBar"</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">foo_content</span><span class="w"> </span><span class="n">bar_content</span><span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="n">class</span><span class="w"> </span><span class="s">"X"</span><span class="w"> </span><span class="n">style</span><span class="w"> </span><span class="s">"FooBar"</span><span class="w"></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
|
||
<code class="function">pango_font_description_from_string()</code>.</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="w"> </span><span class="p">(</span><span class="mf">0.5</span><span class="p">,</span><span class="w"> </span><span class="s">"red"</span><span class="p">,</span><span class="w"> </span><span class="s">"blue"</span><span class="p">)</span><span class="w"></span>
|
||
<span class="n">shade</span><span class="w"> </span><span class="p">(</span><span class="mf">1.5</span><span class="p">,</span><span class="w"> </span><span class="n">mix</span><span class="w"> </span><span class="p">(</span><span class="mf">0.3</span><span class="p">,</span><span class="w"> </span><span class="s">"#0abbc0"</span><span class="p">,</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="mf">0.3</span><span class="p">,</span><span class="w"> </span><span class="mf">0.5</span><span class="p">,</span><span class="w"> </span><span class="mf">0.9</span><span class="w"> </span><span class="p">}))</span><span class="w"></span>
|
||
<span class="n">lighter</span><span class="w"> </span><span class="p">(</span><span class="err">@</span><span class="n">foreground</span><span class="p">)</span><span class="w"></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="w"> </span><span class="o">=</span><span class="w"></span>
|
||
<span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"itemltr.png"</span><span class="p">,</span><span class="w"> </span><span class="n">LTR</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="p">},</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"itemrtl.png"</span><span class="p">,</span><span class="w"> </span><span class="n">RTL</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="p">}</span><span class="w"></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="w"> </span><span class="o">=</span><span class="w"></span>
|
||
<span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"itemltr.png"</span><span class="p">,</span><span class="w"> </span><span class="n">LTR</span><span class="w"> </span><span class="p">},</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"itemrtl.png"</span><span class="p">,</span><span class="w"> </span><span class="n">RTL</span><span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="p">}</span><span class="w"></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="w"> </span><span class="o">=</span><span class="w"></span>
|
||
<span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"itemmenusize.png"</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="p">,</span><span class="w"> </span><span class="s">"gtk-menu"</span><span class="w"> </span><span class="p">},</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"itemtoolbarsize.png"</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="p">,</span><span class="w"> </span><span class="s">"gtk-large-toolbar"</span><span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"itemgeneric.png"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">// implicit *, *, * as a fallback</span>
|
||
<span class="p">}</span><span class="w"></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="w"> </span><span class="o">=</span><span class="w"></span>
|
||
<span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"itemprelight.png"</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="p">,</span><span class="w"> </span><span class="n">PRELIGHT</span><span class="w"> </span><span class="p">},</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"iteminsensitive.png"</span><span class="p">,</span><span class="w"> </span><span class="o">*</span><span class="p">,</span><span class="w"> </span><span class="n">INSENSITIVE</span><span class="w"> </span><span class="p">},</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s">"itemgeneric.png"</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">// implicit *, *, * as a fallback</span>
|
||
<span class="p">}</span><span class="w"></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="w"> </span><span class="n">name</span><span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">bind</span><span class="w"> </span><span class="n">key</span><span class="w"> </span><span class="p">{</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">signalname</span><span class="w"> </span><span class="p">(</span><span class="n">param</span><span class="p">,</span><span class="w"> </span><span class="p">...)</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">...</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">}</span><span class="w"></span>
|
||
<span class="w"> </span><span class="p">...</span><span class="w"></span>
|
||
<span class="p">}</span><span class="w"></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 <code class="function">g_signal_new()</code>). 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"><span class="returnvalue">GScanner</span> *
|
||
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="The data is owned by the callee, which is responsible of freeing it."><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><span class="type">GType</span> 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="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">,</span><span class="w"> </span><span class="nb">NULL</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">path</span><span class="p">,</span><span class="w"> </span><span class="nb">NULL</span><span class="p">);</span><span class="w"></span>
|
||
<span class="n">gtk_widget_class_path</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">,</span><span class="w"> </span><span class="nb">NULL</span><span class="p">,</span><span class="w"> </span><span class="o">&</span><span class="n">class_path</span><span class="p">,</span><span class="w"> </span><span class="nb">NULL</span><span class="p">);</span><span class="w"></span>
|
||
<span class="n">gtk_rc_get_style_by_paths</span><span class="w"> </span><span class="p">(</span><span class="n">gtk_widget_get_settings</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">),</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">path</span><span class="p">,</span><span class="w"> </span><span class="n">class_path</span><span class="p">,</span><span class="w"></span>
|
||
<span class="w"> </span><span class="n">G_OBJECT_TYPE</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">));</span><span class="w"></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 <code class="literal">NULL</code> 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 <code class="literal">NULL</code> 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 <span class="type">G_TYPE_NONE</span></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 <code class="literal">NULL</code> 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 <code class="function">g_object_ref()</code> 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="The data is owned by the callee, which is responsible of freeing it."><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 <span class="type">gchar</span> *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 <span class="type">gchar</span> *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"><span class="returnvalue">gboolean</span>
|
||
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> <code class="literal">TRUE</code> 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"><span class="returnvalue">gboolean</span>
|
||
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><span class="type">gboolean</span> 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> <code class="literal">TRUE</code> 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 <span class="type">GdkScreen</span>, 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 <span class="type">gchar</span> *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"><span class="returnvalue">gchar</span> **
|
||
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 <code class="literal">NULL</code>-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="The data is owned by the callee, which is responsible of freeing it."><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><span class="type">gchar</span> **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
|
||
<code class="literal">NULL</code>-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"><span class="returnvalue">guint</span>
|
||
gtk_rc_parse_color (<em class="parameter"><code><span class="type">GScanner</span> *scanner</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkColor</span> *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 <span class="type">GScanner</span></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 <span class="type">GdkColor</span> 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> <code class="literal">G_TOKEN_NONE</code> 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"><span class="returnvalue">guint</span>
|
||
gtk_rc_parse_color_full (<em class="parameter"><code><span class="type">GScanner</span> *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><span class="type">GdkColor</span> *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 <code class="literal">NULL</code>, 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 <span class="type">GScanner</span></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 <code class="literal">NULL</code>. </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 <span class="type">GdkColor</span> 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> <code class="literal">G_TOKEN_NONE</code> 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"><span class="returnvalue">guint</span>
|
||
gtk_rc_parse_state (<em class="parameter"><code><span class="type">GScanner</span> *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 <span class="type">GScanner</span> (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> <code class="literal">G_TOKEN_NONE</code> 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"><span class="returnvalue">guint</span>
|
||
gtk_rc_parse_priority (<em class="parameter"><code><span class="type">GScanner</span> *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 <span class="type">GScanner</span> (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> <code class="literal">G_TOKEN_NONE</code> 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"><span class="returnvalue">gchar</span> *
|
||
gtk_rc_find_module_in_path (<em class="parameter"><code>const <span class="type">gchar</span> *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 <code class="function">g_free()</code>), otherwise <code class="literal">NULL</code>. </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"><span class="returnvalue">gchar</span> *
|
||
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><span class="type">GScanner</span> *scanner</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *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
|
||
<code class="function">g_warning()</code> and returns <code class="literal">NULL</code>.</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 <code class="literal">NULL</code></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"><span class="returnvalue">gchar</span> *
|
||
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 <code class="function">g_free()</code>). </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"><span class="returnvalue">gchar</span> *
|
||
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"><span class="returnvalue">gchar</span> *
|
||
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"><span class="returnvalue">gchar</span> *
|
||
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 <code class="function">g_free()</code>).</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="The caller owns the data, and is responsible for free it."><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><span class="type">gchar</span> *<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><span class="type">gchar</span> *<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><span class="type">PangoFontDescription</span> *<em class="structfield"><code><a name="GtkRcStyle-struct.font-desc"></a>font_desc</code></em>;</p></td>
|
||
<td class="struct_member_description"><p>A <span class="type">PangoFontDescription</span></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><span class="type">GdkColor</span> <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><span class="type">GdkColor</span> <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><span class="type">GdkColor</span> <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><span class="type">GdkColor</span> <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><span class="type">gint</span> <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><span class="type">gint</span> <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.33.1</div>
|
||
</body>
|
||
</html> |