gtkrc.sgml 32.8 KB
Newer Older
Owen Taylor's avatar
Owen Taylor committed
1
2
3
4
5
6
7
<!-- ##### SECTION Title ##### -->
Resource Files

<!-- ##### SECTION Short_Description ##### -->
Routines for handling resource files

<!-- ##### SECTION Long_Description ##### -->
8
<para>
Owen Taylor's avatar
Owen Taylor committed
9
10
11
12
13
14
15
16
17
18
GTK+ provides resource file mechanism for configuring
various aspects of the operation of a GTK+ program
at runtime.
</para>

<refsect2><title>Default files</title>
<para>
An application can cause GTK+ to parse a specific RC
file by calling gtk_rc_parse(). In addition to this,
certain files will be read at the end of gtk_init().
Matthias Clasen's avatar
Matthias Clasen committed
19
20
21
22
23
24
Unless modified, the files looked for will be 
<filename>&lt;SYSCONFDIR&gt;/gtk-2.0/gtkrc</filename> 
and <filename>.gtkrc-2.0</filename> in the users home directory.
(<filename>&lt;SYSCONFDIR&gt;</filename> defaults to 
<filename>/usr/local/etc</filename>. It can be changed with the
<option>--prefix</option> or <option>--sysconfdir</option> options when 
25
26
configuring GTK+.) Note that although the filenames contain the version 
number 2.0, all 2.x versions of GTK+ look for these files.  
Owen Taylor's avatar
Owen Taylor committed
27
28
29
30
31
32
</para>
<para>
The set of these <firstterm>default</firstterm> files
can be retrieved with gtk_rc_get_default_files()
and modified with gtk_rc_add_default_file() and
gtk_rc_set_default_files().
33
Additionally, the <envar>GTK2_RC_FILES</envar> environment variable
Matthias Clasen's avatar
Matthias Clasen committed
34
35
can be set to a #G_SEARCHPATH_SEPARATOR_S-separated list of files
in order to overwrite the set of default files at runtime.
Owen Taylor's avatar
Owen Taylor committed
36
</para>
Matthias Clasen's avatar
Matthias Clasen committed
37
<para><anchor id="locale-specific-rc"/>
38
39
40
41
42
43
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 <envar>LANG</envar> is set to <literal>ja_JP.ujis</literal>,
when loading the default file <filename>~/.gtkrc</filename> then GTK+ looks 
for <filename>~/.gtkrc.ja_JP</filename> and <filename>~/.gtkrc.ja</filename>, 
and parses the first of those that exists.
Owen Taylor's avatar
Owen Taylor committed
44
45
46
</para>
</refsect2>

47
48
49
50
51
52
53
<refsect2><title>Pathnames and patterns</title>
<para>
A resource file defines a number of styles and key bindings and
attaches them to particular widgets. The attachment is done
by the <literal>widget</literal>, <literal>widget_class</literal>,
and <literal>class</literal> declarations. As an example
of such a statement:
54

Matthias Clasen's avatar
Matthias Clasen committed
55
<informalexample><programlisting>
56
widget "mywindow.*.GtkEntry" style "my-entry-class"
Matthias Clasen's avatar
Matthias Clasen committed
57
</programlisting></informalexample>
58

59
attaches the style <literal>"my-entry-class"</literal>
60
to all widgets whose <firstterm>widget path</firstterm>
61
matches the <firstterm>pattern</firstterm>
62
63
<literal>"mywindow.*.GtkEntry"</literal>. That is, all
#GtkEntry widgets which are part of a #GtkWindow named <literal>"mywindow"</literal>.
64
</para>
65

66
67
68
69
70
71
72
<para>
The patterns here are given in the standard shell glob
syntax. The <literal>"?"</literal> wildcard matches
any character, while <literal>"*"</literal> matches
zero or more of any character. The three types of
matching are against the widget path, the
<firstterm>class path</firstterm> and the class
73
hierarchy. Both the widget path and the class path consist of a
74
75
76
77
<literal>"."</literal> 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
Matthias Clasen's avatar
Matthias Clasen committed
78
gtk_widget_set_name() is used
79
if present, otherwise the class name of the widget, while
Matthias Clasen's avatar
Matthias Clasen committed
80
for the class path, the class name is always used.
81
82
</para>
<para>
Matthias Clasen's avatar
Matthias Clasen committed
83
So, if you have a #GtkEntry named
84
<literal>"myentry"</literal>, inside of a horizontal box in a window
85
named <literal>"mywindow"</literal>, then the
86
widget path is: <literal>"mywindow.GtkHBox.myentry"</literal>
Matthias Clasen's avatar
Matthias Clasen committed
87
while the class path is: <literal>"GtkWindow.GtkHBox.GtkEntry"</literal>.
88
89
90
91
</para>
<para>
Matching against class is a little different. The pattern
match is done against all class names in the widgets
Matthias Clasen's avatar
Matthias Clasen committed
92
class hierarchy (not the layout hierarchy) in sequence, so the
93
pattern:
Matthias Clasen's avatar
Matthias Clasen committed
94
<informalexample><programlisting>
95
class "GtkButton" style "my-style"
Matthias Clasen's avatar
Matthias Clasen committed
96
</programlisting></informalexample>
Matthias Clasen's avatar
Matthias Clasen committed
97
98
99
100
will match not just #GtkButton widgets,
but also #GtkToggleButton and
#GtkCheckButton widgets, since
those classes derive from #GtkButton.
101
</para>
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
<para>
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):
<simplelist>
<member><literal>highest</literal></member>
<member><literal>rc</literal></member>
<member><literal>theme</literal></member>
<member><literal>application</literal></member>
<member><literal>gtk</literal></member>
<member><literal>lowest</literal></member>
</simplelist>
<literal>rc</literal> is the default for styles
read from an RC file, <literal>theme</literal>
is the default for styles read from theme RC files,
<literal>application</literal> 
should be used for styles an application sets
up, and <literal>gtk</literal> is used for styles
that GTK+ creates internally.
</para>

124
125
</refsect2>

126
127
128
<refsect2>
<anchor id="optimizing-rc-style-matches"/>
<title>Optimizing RC Style Matches</title>
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
<para>
Everytime a widget is created and added to the layout hierarchy of a #GtkWindow
("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 sytle 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:

<orderedlist>

  <listitem><para>
  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.
  </para></listitem>

  <listitem><para>
  Merge multiple styles which use the same matching rule, for instance:
<informalexample><programlisting>
     style "Foo" { foo_content }
     class "X" style "Foo"
     style "Bar" { bar_content }
     class "X" style "Bar"
</programlisting></informalexample>
   is faster to match as:
<informalexample><programlisting>
     style "FooBar" { foo_content bar_content }
     class "X" style "FooBar"
</programlisting></informalexample>
  </para></listitem>

  <listitem><para>
  Use of wildcards should be avoided, this can reduce the individual RC style
  match to a single integer comparison in most cases.
  </para></listitem>

  <listitem><para>
  To avoid complex recursive matching, specification of full class names
  (for <literal>class</literal> matches) or full path names (for
  <literal>widget</literal> and <literal>widget_class</literal> matches)
  is to be preferred over shortened names
  containing <literal>"*"</literal> or <literal>"?"</literal>.
  </para></listitem>

  <listitem><para>
  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.
  </para></listitem>

  <listitem><para>
  When using wildcards, use of <literal>"?"</literal> should be preferred
  over <literal>"*"</literal>. This can reduce the matching complexity from
  O(n^2) to O(n). For example <literal>"Gtk*Box"</literal> can be turned into
  <literal>"Gtk?Box"</literal> and will still match #GtkHBox and #GtkVBox.
  </para></listitem>

  <listitem><para>
  The use of <literal>"*"</literal> wildcards should be restricted as much
  as possible, because matching <literal>"A*B*C*RestString"</literal> can
195
  result in matching complexities of O(n^2) worst case.
196
197
198
199
200
201
  </para></listitem>
</orderedlist>

</para>
</refsect2>

Owen Taylor's avatar
Owen Taylor committed
202
203
204
<refsect2><title>Toplevel declarations</title>
<para>
An RC file is a text file which is composed of a sequence
Matthias Clasen's avatar
Matthias Clasen committed
205
206
of declarations. <literal>'#'</literal> characters delimit comments and
the portion of a line after a <literal>'#'</literal> is ignored when parsing
Owen Taylor's avatar
Owen Taylor committed
207
208
209
210
211
212
213
214
215
216
217
an RC file.
</para>

<para>
The possible toplevel declarations are:

<variablelist>
  <varlistentry>
    <term><literal>binding <replaceable>name</replaceable>
     { ... }</literal></term>
    <listitem>
Matthias Clasen's avatar
Matthias Clasen committed
218
      <para>Declares a binding set.</para>
Owen Taylor's avatar
Owen Taylor committed
219
220
    </listitem>
  </varlistentry>
221

Owen Taylor's avatar
Owen Taylor committed
222
223
  <varlistentry>
    <term><literal>class <replaceable>pattern</replaceable> 
224
          [ style | binding ][ : <replaceable>priority</replaceable> ]
Owen Taylor's avatar
Owen Taylor committed
225
226
          <replaceable>name</replaceable></literal></term>
    <listitem>
Matthias Clasen's avatar
Matthias Clasen committed
227
     <para>Specifies a style or binding set for a particular
Matthias Clasen's avatar
Matthias Clasen committed
228
     branch of the inheritance hierarchy.</para>
Owen Taylor's avatar
Owen Taylor committed
229
230
    </listitem>
  </varlistentry>
231

Owen Taylor's avatar
Owen Taylor committed
232
233
234
  <varlistentry>
    <term><literal>include <replaceable>filename</replaceable></literal></term>
    <listitem>
235
236
237
238
239
240
241
242
      <para>Parses another file at this point. If
        <replaceable>filename</replaceable> is not an absolute filename, 
        it is searched in the directories of the currently open RC files.
      </para>
      <para>GTK+ also tries to load a 
        <link linkend="locale-specific-rc">locale-specific variant</link> of
        the included file.
       </para>
Owen Taylor's avatar
Owen Taylor committed
243
244
    </listitem>
  </varlistentry>
245

Owen Taylor's avatar
Owen Taylor committed
246
  <varlistentry>
Matthias Clasen's avatar
Matthias Clasen committed
247
    <term><literal>module_path <replaceable>path</replaceable></literal></term>
Owen Taylor's avatar
Owen Taylor committed
248
249
250
251
252
253
    <listitem>
      <para>Sets a path (a list of directories separated
      by colons) that will be searched for theme engines referenced in
      RC files.</para>
    </listitem>
  </varlistentry>
254

Owen Taylor's avatar
Owen Taylor committed
255
  <varlistentry>
Matthias Clasen's avatar
Matthias Clasen committed
256
    <term><literal>pixmap_path <replaceable>path</replaceable></literal></term>
Owen Taylor's avatar
Owen Taylor committed
257
258
259
260
261
262
    <listitem>
      <para>Sets a path (a list of directories separated
      by colons) that will be searched for pixmaps referenced in
      RC files.</para>
    </listitem>
  </varlistentry>
263
264
265
266
267
268
269
270
271
272

  <varlistentry>
    <term><literal>im_module_file <replaceable>pathname</replaceable></literal></term>
    <listitem>
      <para>Sets the pathname for the IM modules file. Setting this from RC files
      is deprecated; you should use the environment variable <envar>GTK_IM_MODULE_FILE</envar>
      instead.</para>
    </listitem>
  </varlistentry>

Owen Taylor's avatar
Owen Taylor committed
273
274
275
276
  <varlistentry>
    <term><literal>style <replaceable>name</replaceable> [ =
    <replaceable>parent</replaceable> ] { ... }</literal></term>
    <listitem>
Matthias Clasen's avatar
Matthias Clasen committed
277
      <para>Declares a style.</para>
Owen Taylor's avatar
Owen Taylor committed
278
279
    </listitem>
  </varlistentry>
280

Owen Taylor's avatar
Owen Taylor committed
281
282
  <varlistentry>
    <term><literal>widget <replaceable>pattern</replaceable> 
283
          [ style | binding ][ : <replaceable>priority</replaceable> ]
Owen Taylor's avatar
Owen Taylor committed
284
285
          <replaceable>name</replaceable></literal></term>
    <listitem>
Matthias Clasen's avatar
Matthias Clasen committed
286
     <para>Specifies a style or binding set for a particular
287
     group of widgets by matching on the widget pathname.</para>
Owen Taylor's avatar
Owen Taylor committed
288
289
    </listitem>
  </varlistentry>
290

Owen Taylor's avatar
Owen Taylor committed
291
292
  <varlistentry>
    <term><literal>widget_class <replaceable>pattern</replaceable> 
293
          [ style | binding ][ : <replaceable>priority</replaceable> ]
Owen Taylor's avatar
Owen Taylor committed
294
295
          <replaceable>name</replaceable></literal></term>
    <listitem>
Matthias Clasen's avatar
Matthias Clasen committed
296
     <para>Specifies a style or binding set for a particular
297
     group of widgets by matching on the class pathname.</para>
Owen Taylor's avatar
Owen Taylor committed
298
299
    </listitem>
  </varlistentry>
300
301

  <varlistentry>
302
    <term><replaceable>setting</replaceable> = <replaceable>value</replaceable></term>
303
    <listitem>
Matthias Clasen's avatar
Matthias Clasen committed
304
305
306
      <para>Specifies a value for a <link linkend="GtkSettings">setting</link>.
        Note that settings in RC files are overwritten by system-wide settings 
        (which are managed by an XSettings manager on X11).</para>
307
308
    </listitem>
  </varlistentry>
Owen Taylor's avatar
Owen Taylor committed
309
310
</variablelist>
</para>
Owen Taylor's avatar
Owen Taylor committed
311
</refsect2>
Owen Taylor's avatar
Owen Taylor committed
312
313
314
315
316
317
318
319
320
321

<refsect2><title>Styles</title>
<para>
A RC style is specified by a <literal>style</literal> 
declaration in a RC file, and then bound to widgets
with a <literal>widget</literal>, <literal>widget_class</literal>,
or <literal>class</literal> declaration. All styles
applying to a particular widget are composited together
with <literal>widget</literal> declarations overriding
<literal>widget_class</literal> declarations which, in
322
turn, override <literal>class</literal> declarations.
Owen Taylor's avatar
Owen Taylor committed
323
324
325
326
327
328
329
330
331
332
333
334
335
336
Within each type of declaration, later declarations override
earlier ones.
</para>

<para>
Within a <literal>style</literal> declaration, the possible
elements are:

<variablelist>
  <varlistentry>
    <term><literal>bg[<replaceable>state</replaceable>] =
      <replaceable>color</replaceable></literal></term>
     <listitem>
       <para>
Matthias Clasen's avatar
Matthias Clasen committed
337
         Sets the color used for the background of most widgets.
Owen Taylor's avatar
Owen Taylor committed
338
339
340
341
342
343
344
345
       </para>
     </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>fg[<replaceable>state</replaceable>] =
      <replaceable>color</replaceable></literal></term>
     <listitem>
       <para>
Matthias Clasen's avatar
Matthias Clasen committed
346
         Sets the color used for the foreground of most widgets.
Owen Taylor's avatar
Owen Taylor committed
347
348
349
350
351
352
353
354
       </para>
     </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>base[<replaceable>state</replaceable>] =
      <replaceable>color</replaceable></literal></term>
     <listitem>
       <para>
Matthias Clasen's avatar
Matthias Clasen committed
355
         Sets the color used for the background of widgets displaying
Owen Taylor's avatar
Owen Taylor committed
356
         editable text. This color is used for the background
357
         of, among others, #GtkText, #GtkEntry, #GtkList, and #GtkCList.
Owen Taylor's avatar
Owen Taylor committed
358
359
360
361
362
363
364
365
       </para>
     </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>text[<replaceable>state</replaceable>] =
      <replaceable>color</replaceable></literal></term>
     <listitem>
       <para>
Matthias Clasen's avatar
Matthias Clasen committed
366
         Sets the color used for foreground of widgets using
Owen Taylor's avatar
Owen Taylor committed
367
368
369
370
         <literal>base</literal> for the background color.
       </para>
     </listitem>
  </varlistentry>
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
  <varlistentry>
    <term><literal>xthickness =
      <replaceable>number</replaceable></literal></term>
     <listitem>
       <para>
         Sets the xthickness, which is used for various horizontal padding
         values in GTK+.
       </para>
     </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>ythickness =
      <replaceable>number</replaceable></literal></term>
     <listitem>
       <para>
         Sets the ythickness, which is used for various vertical padding
         values in GTK+.
       </para>
     </listitem>
  </varlistentry>

Owen Taylor's avatar
Owen Taylor committed
392
  <varlistentry>
393
394
    <term><literal>bg_pixmap[<replaceable>state</replaceable>] =
      <replaceable>pixmap</replaceable></literal></term>
Owen Taylor's avatar
Owen Taylor committed
395
396
     <listitem>
       <para>
Matthias Clasen's avatar
Matthias Clasen committed
397
         Sets a background pixmap to be used in place of
Owen Taylor's avatar
Owen Taylor committed
398
         the <literal>bg</literal> color (or for #GtkText,
399
         in place of the <literal>base</literal> color. The special
Matthias Clasen's avatar
Matthias Clasen committed
400
         value <literal>"&lt;parent&gt;"</literal> may be used to indicate that the widget should
401
         use the same background pixmap as its parent. The special value
Matthias Clasen's avatar
Matthias Clasen committed
402
         <literal>"&lt;none&gt;"</literal> may be used to indicate no background pixmap.
Owen Taylor's avatar
Owen Taylor committed
403
404
405
406
407
408
409
       </para>
     </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>font = <replaceable>font</replaceable></literal></term>
     <listitem>
       <para>
410
411
         Starting with GTK+ 2.0, the "font" and "fontset"
         declarations are ignored; use "font_name" declarations instead.
Owen Taylor's avatar
Owen Taylor committed
412
413
414
415
416
417
418
       </para>
     </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>fontset = <replaceable>font</replaceable></literal></term>
     <listitem>
       <para>
419
420
         Starting with GTK+ 2.0, the "font" and "fontset"
         declarations are ignored; use "font_name" declarations instead.
Owen Taylor's avatar
Owen Taylor committed
421
422
423
       </para>
     </listitem>
  </varlistentry>
424
425
426
427
  <varlistentry>
    <term><literal>font_name = <replaceable>font</replaceable></literal></term>
     <listitem>
       <para>
428
429
430
431
         Sets the font for a widget. <replaceable>font</replaceable> must be 
         a Pango font name, e.g. <literal>"Sans Italic 10"</literal>. 
         For details about Pango font names, see 
         pango_font_description_from_string().
432
433
434
       </para>
     </listitem>   
  </varlistentry>
Havoc Pennington's avatar
Havoc Pennington committed
435
  <varlistentry>
436
    <term><literal>stock[<replaceable>"stock-id"</replaceable>] = { <replaceable>icon source specifications</replaceable> }</literal></term>
Havoc Pennington's avatar
Havoc Pennington committed
437
438
439
440
441
442
     <listitem>
       <para>
        Defines the icon for a stock item.
       </para>
     </listitem>
  </varlistentry>
443
444
445
446
447
448
449
450
451
  <varlistentry>
    <term><literal>color[<replaceable>"color-name"</replaceable>] = <replaceable>color specification</replaceable></literal></term>
     <listitem>
       <para>
        Since 2.10, this element can be used to defines symbolic colors. See below for
        the syntax of color specifications. 
       </para>
     </listitem>
  </varlistentry>
452
453
454
455
456
457
458
459
  <varlistentry>
    <term><literal>engine <replaceable>"engine"</replaceable> { <replaceable>engine-specific
settings</replaceable> }</literal></term>
     <listitem>
       <para>
        Defines the engine to be used when drawing with this style.
       </para>
     </listitem>
460
461
462
463
464
  </varlistentry>
  <varlistentry>
    <term><literal><replaceable>class</replaceable>::<replaceable>property</replaceable> = <replaceable>value</replaceable></literal></term>
     <listitem>
       <para>
Matthias Clasen's avatar
Matthias Clasen committed
465
        Sets a <link linkend="style-properties">style property</link> for a widget class.
466
467
       </para>
     </listitem>
468
  </varlistentry>
Owen Taylor's avatar
Owen Taylor committed
469
470
471
472
473
474
475
476
477
478
479
</variablelist>
</para>
<para>
The colors and background pixmaps are specified as a function of the
state of the widget. The states are:

<variablelist>
  <varlistentry>
    <term><literal>NORMAL</literal></term>
    <listitem>
      <para>
Matthias Clasen's avatar
Matthias Clasen committed
480
        A color used for a widget in its normal state.
Owen Taylor's avatar
Owen Taylor committed
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>ACTIVE</literal></term>
    <listitem>
      <para>
        A variant of the <literal>NORMAL</literal> color used when the
        widget is in the %GTK_STATE_ACTIVE 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 <literal>NORMAL</literal> color.
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>PRELIGHT</literal></term>
    <listitem>
      <para>
        A color used for widgets in the %GTK_STATE_PRELIGHT state. This
        state is the used for Buttons and MenuItems
        that have the mouse cursor over them, and for 
        their children.
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>SELECTED</literal></term>
    <listitem>
      <para>
        A color used to highlight data selected by the user.
Matthias Clasen's avatar
Matthias Clasen committed
513
514
        for instance, the selected items in a list widget, and the
        selection in an editable widget.
Owen Taylor's avatar
Owen Taylor committed
515
516
517
518
519
520
521
522
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><literal>INSENSITIVE</literal></term>
    <listitem>
      <para>
        A color used for the background of widgets that have
Matthias Clasen's avatar
Matthias Clasen committed
523
        been set insensitive with gtk_widget_set_sensitive().
Owen Taylor's avatar
Owen Taylor committed
524
525
526
527
528
529
      </para>
    </listitem>
  </varlistentry>
</variablelist>
</para>

Matthias Clasen's avatar
Matthias Clasen committed
530
<para><anchor id="color-format"/>
Matthias Clasen's avatar
Matthias Clasen committed
531
Colors can be specified as a string containing a color name (GTK+ knows
532
all names from the X color database <filename>/usr/lib/X11/rgb.txt</filename>),  
533
534
535
in one of the hexadecimal forms <literal>&num;rrrrggggbbbb</literal>,
<literal>&num;rrrgggbbb</literal>, <literal>&num;rrggbb</literal>,
or <literal>&num;rgb</literal>, where <literal>r</literal>,
Matthias Clasen's avatar
Matthias Clasen committed
536
537
<literal>g</literal> and <literal>b</literal> are
hex digits, or they can be specified as a triplet 
Owen Taylor's avatar
Owen Taylor committed
538
<literal>{ <replaceable>r</replaceable>, <replaceable>g</replaceable>,
Matthias Clasen's avatar
Matthias Clasen committed
539
540
<replaceable>b</replaceable>}</literal>, where <literal>r</literal>,
<literal>g</literal> and <literal>b</literal> are either integers in 
541
the range 0-65535 or floats in the range 0.0-1.0.
Owen Taylor's avatar
Owen Taylor committed
542
</para>
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
<para>
Since 2.10, colors can also be specified by refering to a symbolic color, as
follows: <literal>@<!-- -->color-name</literal>, or by using expressions to combine
colors. The following expressions are currently supported:
  <variablelist>
    <varlistentry>
      <term>mix (<replaceable>factor</replaceable>, <replaceable>color1</replaceable>, <replaceable>color2</replaceable>)</term>
      <listitem><para>
        Computes a new color by mixing <replaceable>color1</replaceable> and 
        <replaceable>color2</replaceable>. The <replaceable>factor</replaceable> 
        determines how close the new color is to <replaceable>color1</replaceable>. 
        A factor of 1.0 gives pure <replaceable>color1</replaceable>, a factor of 
        0.0 gives pure <replaceable>color2</replaceable>.  
      </para></listitem>        
    </varlistentry>

    <varlistentry>
      <term>shade (<replaceable>factor</replaceable>, <replaceable>color</replaceable>)</term>
      <listitem><para>
        Computes a lighter or darker variant of <replaceable>color</replaceable>. 
        A <replaceable>factor</replaceable> of 1.0 leaves the color unchanged, smaller 
        factors yield darker colors, larger factors yield lighter colors.
      </para></listitem>
    </varlistentry>

    <varlistentry>
      <term>lighter (<replaceable>color</replaceable>)</term>
      <listitem><para>
        This is an abbreviation for 
        <literal>shade (1.3, <replaceable>color</replaceable>)</literal>.
      </para></listitem>
    </varlistentry>

    <varlistentry>
      <term>darker (<replaceable>color</replaceable>)</term>
      <listitem><para>
        This is an abbreviation for 
        <literal>shade (0.7, <replaceable>color</replaceable>)</literal>.
      </para></listitem>
    </varlistentry>
  </variablelist>      
</para>
<para>
Here are some examples of color expressions:
<informalexample><programlisting>  
 mix (0.5, "red", "blue")
 shade (1.5, mix (0.3, "&num;0abbc0", { 0.3, 0.5, 0.9 }))
 lighter (@<!-- -->foreground)
</programlisting></informalexample>
</para>
Havoc Pennington's avatar
Havoc Pennington committed
593
594
595

<para>
In a <literal>stock</literal> definition, icon sources are specified as a
Owen Taylor's avatar
Owen Taylor committed
596
597
598
599
600
601
602
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 <literal>"itemltr.png"</literal>, while icon names (looked up
in the current icon theme), are specified with a leading
<literal>@</literal>, such as <literal>@"item-ltr"</literal>.
The <literal>*</literal> character can be used as a
Havoc Pennington's avatar
Havoc Pennington committed
603
604
605
wildcard, and if direction/state/size are omitted they default to
<literal>*</literal>. So for example, the following specifies different icons to
use for left-to-right and right-to-left languages:
Matthias Clasen's avatar
Matthias Clasen committed
606
<informalexample><programlisting>
Havoc Pennington's avatar
Havoc Pennington committed
607
608
609
610
611
stock["my-stock-item"] = 
{
  { "itemltr.png", LTR, *, * },
  { "itemrtl.png", RTL, *, * }
}
Matthias Clasen's avatar
Matthias Clasen committed
612
</programlisting></informalexample>
Havoc Pennington's avatar
Havoc Pennington committed
613
This could be abbreviated as follows:
Matthias Clasen's avatar
Matthias Clasen committed
614
<informalexample><programlisting>
Havoc Pennington's avatar
Havoc Pennington committed
615
616
617
618
619
stock["my-stock-item"] = 
{
  { "itemltr.png", LTR },
  { "itemrtl.png", RTL }
}
Matthias Clasen's avatar
Matthias Clasen committed
620
</programlisting></informalexample>
Havoc Pennington's avatar
Havoc Pennington committed
621
622
623
624
</para>

<para>
You can specify custom icons for specific sizes, as follows:
Matthias Clasen's avatar
Matthias Clasen committed
625
<informalexample><programlisting>
Havoc Pennington's avatar
Havoc Pennington committed
626
627
628
629
630
631
stock["my-stock-item"] = 
{
  { "itemmenusize.png", *, *, "gtk-menu" },
  { "itemtoolbarsize.png", *, *, "gtk-large-toolbar" }
  { "itemgeneric.png" } /* implicit *, *, * as a fallback */
}
Matthias Clasen's avatar
Matthias Clasen committed
632
</programlisting></informalexample>
Havoc Pennington's avatar
Havoc Pennington committed
633
634
635
636
637
638
639
640
The sizes that come with GTK+ itself are <literal>"gtk-menu"</literal>,
<literal>"gtk-small-toolbar"</literal>, <literal>"gtk-large-toolbar"</literal>,
<literal>"gtk-button"</literal>, <literal>"gtk-dialog"</literal>. Applications
can define other sizes.
</para>

<para>
It's also possible to use custom icons for a given state, for example:
Matthias Clasen's avatar
Matthias Clasen committed
641
<informalexample><programlisting>
Havoc Pennington's avatar
Havoc Pennington committed
642
643
644
645
646
647
stock["my-stock-item"] = 
{
  { "itemprelight.png", *, PRELIGHT },
  { "iteminsensitive.png", *, INSENSITIVE }, 
  { "itemgeneric.png" } /* implicit *, *, * as a fallback */
}
Matthias Clasen's avatar
Matthias Clasen committed
648
</programlisting></informalexample>
Havoc Pennington's avatar
Havoc Pennington committed
649
650
651
652
653
654
655
656
657
658
659
</para>

<para>
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
<literal>PRELIGHT</literal> 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.
</para>

Owen Taylor's avatar
Owen Taylor committed
660
661
662
663
664
665
666
667
668
</refsect2>

<refsect2><title>Key bindings</title>
<para>
Key bindings allow the user to specify actions to be 
taken on particular key presses. The form of a binding
set declaration is:
</para>

Matthias Clasen's avatar
Matthias Clasen committed
669
<informalexample><programlisting>
Owen Taylor's avatar
Owen Taylor committed
670
671
672
673
674
675
676
binding <replaceable>name</replaceable> {
  bind <replaceable>key</replaceable> { 
    <replaceable>signalname</replaceable> (<replaceable>param</replaceable>, ...)
    ...
  }
  ...
}
Matthias Clasen's avatar
Matthias Clasen committed
677
</programlisting></informalexample>
Owen Taylor's avatar
Owen Taylor committed
678
679
680
681
682
683
684

<para>
<replaceable>key</replaceable> is a string consisting of a 
series of modifiers followed by the name of a key. The
modifiers can be:
<simplelist>
<member><literal>&lt;alt&gt;</literal></member>
Matthias Clasen's avatar
Updates    
Matthias Clasen committed
685
<member><literal>&lt;ctl&gt;</literal></member>
Owen Taylor's avatar
Owen Taylor committed
686
<member><literal>&lt;control&gt;</literal></member>
Matthias Clasen's avatar
Updates    
Matthias Clasen committed
687
688
689
<member><literal>&lt;meta&gt;</literal></member>
<member><literal>&lt;hyper&gt;</literal></member>
<member><literal>&lt;super&gt;</literal></member>
Owen Taylor's avatar
Owen Taylor committed
690
691
692
693
694
695
696
697
698
699
<member><literal>&lt;mod1&gt;</literal></member>
<member><literal>&lt;mod2&gt;</literal></member>
<member><literal>&lt;mod3&gt;</literal></member>
<member><literal>&lt;mod4&gt;</literal></member>
<member><literal>&lt;mod5&gt;</literal></member>
<member><literal>&lt;release&gt;</literal></member>
<member><literal>&lt;shft&gt;</literal></member>
<member><literal>&lt;shift&gt;</literal></member>
</simplelist>
<literal>&lt;shft&gt;</literal> is an alias for 
Matthias Clasen's avatar
Updates    
Matthias Clasen committed
700
701
702
703
<literal>&lt;shift&gt;</literal>,
<literal>&lt;ctl&gt;</literal> is an alias for 
<literal>&lt;control&gt;</literal>,
 and 
Owen Taylor's avatar
Owen Taylor committed
704
705
706
707
708
709
710
711
<literal>&lt;alt&gt;</literal> is an alias for
<literal>&lt;mod1&gt;</literal>.
</para>

<para>
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.
Matthias Clasen's avatar
Matthias Clasen committed
712
(See g_signal_new()). Each parameter can be
Owen Taylor's avatar
Owen Taylor committed
713
714
715
716
717
718
719
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.
</para>

<para>
720
721
722
723
724
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.
Owen Taylor's avatar
Owen Taylor committed
725
726
727
728
729
730
731
732
</para>
</refsect2>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

Matthias Clasen's avatar
2.7.0    
Matthias Clasen committed
733
734
735
<!-- ##### SECTION Stability_Level ##### -->


Owen Taylor's avatar
Owen Taylor committed
736
737
738
739
740
741
742
743
744
745
<!-- ##### STRUCT GtkRcStyle ##### -->
<para>
The #GtkRcStyle structure is used to represent a set
of information about the appearance of a widget.
This can later be composited together with other
#GtkRcStyle structures to form a #GtkStyle.
</para>

@name: 
@bg_pixmap_name: 
746
@font_desc: 
Owen Taylor's avatar
Owen Taylor committed
747
748
749
750
751
@color_flags: 
@fg: 
@bg: 
@text: 
@base: 
752
753
754
@xthickness: 
@ythickness: 

Owen Taylor's avatar
Owen Taylor committed
755
756
757
758
759
760
761
<!-- ##### ENUM GtkRcFlags ##### -->
<para>
The #GtkRcFlags enumeration is used as a bitmask
to specify which fields of a #GtkRcStyle have been
set for each state.
</para>

Matthias Clasen's avatar
Matthias Clasen committed
762
763
764
765
@GTK_RC_FG: If present, the foreground color has been set for this state.
@GTK_RC_BG: If present, the background color has been set for this state.
@GTK_RC_TEXT: If present, the text color has been set for this state.
@GTK_RC_BASE: If present, the base color has been set for this state.
Owen Taylor's avatar
Owen Taylor committed
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784

<!-- ##### ENUM GtkRcTokenType ##### -->
<para>
The #GtkRcTokenType 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.
</para>

@GTK_RC_TOKEN_INVALID: 
@GTK_RC_TOKEN_INCLUDE: 
@GTK_RC_TOKEN_NORMAL: 
@GTK_RC_TOKEN_ACTIVE: 
@GTK_RC_TOKEN_PRELIGHT: 
@GTK_RC_TOKEN_SELECTED: 
@GTK_RC_TOKEN_INSENSITIVE: 
@GTK_RC_TOKEN_FG: 
@GTK_RC_TOKEN_BG: 
@GTK_RC_TOKEN_TEXT: 
785
786
787
@GTK_RC_TOKEN_BASE: 
@GTK_RC_TOKEN_XTHICKNESS: 
@GTK_RC_TOKEN_YTHICKNESS: 
Owen Taylor's avatar
Owen Taylor committed
788
789
@GTK_RC_TOKEN_FONT: 
@GTK_RC_TOKEN_FONTSET: 
790
@GTK_RC_TOKEN_FONT_NAME: 
Owen Taylor's avatar
Owen Taylor committed
791
792
793
794
795
796
797
798
799
800
801
@GTK_RC_TOKEN_BG_PIXMAP: 
@GTK_RC_TOKEN_PIXMAP_PATH: 
@GTK_RC_TOKEN_STYLE: 
@GTK_RC_TOKEN_BINDING: 
@GTK_RC_TOKEN_BIND: 
@GTK_RC_TOKEN_WIDGET: 
@GTK_RC_TOKEN_WIDGET_CLASS: 
@GTK_RC_TOKEN_CLASS: 
@GTK_RC_TOKEN_LOWEST: 
@GTK_RC_TOKEN_GTK: 
@GTK_RC_TOKEN_APPLICATION: 
802
@GTK_RC_TOKEN_THEME: 
Owen Taylor's avatar
Owen Taylor committed
803
804
805
806
@GTK_RC_TOKEN_RC: 
@GTK_RC_TOKEN_HIGHEST: 
@GTK_RC_TOKEN_ENGINE: 
@GTK_RC_TOKEN_MODULE_PATH: 
807
808
@GTK_RC_TOKEN_IM_MODULE_PATH: 
@GTK_RC_TOKEN_IM_MODULE_FILE: 
Havoc Pennington's avatar
Havoc Pennington committed
809
810
811
@GTK_RC_TOKEN_STOCK: 
@GTK_RC_TOKEN_LTR: 
@GTK_RC_TOKEN_RTL: 
812
@GTK_RC_TOKEN_COLOR: 
Owen Taylor's avatar
Owen Taylor committed
813
814
@GTK_RC_TOKEN_LAST: 

815
816
817
818
819
820
821
822
<!-- ##### FUNCTION gtk_rc_scanner_new ##### -->
<para>

</para>

@Returns: 


Owen Taylor's avatar
Owen Taylor committed
823
824
825
826
<!-- ##### FUNCTION gtk_rc_get_style ##### -->
<para>
</para>

827
828
@widget: 
@Returns: 
Owen Taylor's avatar
Owen Taylor committed
829
830


831
832
833
834
835
836
837
838
839
840
841
842
<!-- ##### FUNCTION gtk_rc_get_style_by_paths ##### -->
<para>

</para>

@settings: 
@widget_path: 
@class_path: 
@type: 
@Returns: 


Owen Taylor's avatar
Owen Taylor committed
843
844
<!-- ##### FUNCTION gtk_rc_add_widget_name_style ##### -->
<para>
Matthias Clasen's avatar
Matthias Clasen committed
845
Adds a #GtkRcStyle that will be looked up by a match against
Owen Taylor's avatar
Owen Taylor committed
846
the widget's pathname. This is equivalent to a:
Matthias Clasen's avatar
Matthias Clasen committed
847
<literal>
Owen Taylor's avatar
Owen Taylor committed
848
widget PATTERN style STYLE
Matthias Clasen's avatar
Matthias Clasen committed
849
</literal>
Owen Taylor's avatar
Owen Taylor committed
850
851
852
853
854
855
856
857
858
statement in a RC file.
</para>

@rc_style: the #GtkRcStyle to use for widgets matching @pattern
@pattern: the pattern


<!-- ##### FUNCTION gtk_rc_add_widget_class_style ##### -->
<para>
Matthias Clasen's avatar
Matthias Clasen committed
859
Adds a #GtkRcStyle that will be looked up by a match against
Owen Taylor's avatar
Owen Taylor committed
860
the widget's class pathname. This is equivalent to a:
Matthias Clasen's avatar
Matthias Clasen committed
861
<literal>
Owen Taylor's avatar
Owen Taylor committed
862
widget_class PATTERN style STYLE
Matthias Clasen's avatar
Matthias Clasen committed
863
</literal>
Owen Taylor's avatar
Owen Taylor committed
864
865
866
867
868
869
870
871
872
statement in a RC file.
</para>

@rc_style: the #GtkRcStyle to use for widgets matching @pattern
@pattern: the pattern


<!-- ##### FUNCTION gtk_rc_add_class_style ##### -->
<para>
Matthias Clasen's avatar
Matthias Clasen committed
873
Adds a #GtkRcStyle that will be looked up by a matching against
Matthias Clasen's avatar
Matthias Clasen committed
874
875
the class hierarchy of the widget. This is equivalent to a:
<literal>
Owen Taylor's avatar
Owen Taylor committed
876
class PATTERN style STYLE
Matthias Clasen's avatar
Matthias Clasen committed
877
</literal>
Owen Taylor's avatar
Owen Taylor committed
878
879
880
881
882
883
884
885
886
statement in a RC file.
</para>

@rc_style: the #GtkRcStyle to use for widgets deriving from @pattern
@pattern: the pattern


<!-- ##### FUNCTION gtk_rc_parse ##### -->
<para>
Matthias Clasen's avatar
Matthias Clasen committed
887
Parses a given resource file.
Owen Taylor's avatar
Owen Taylor committed
888
889
</para>

890
891
@filename: the filename of a file to parse. If @filename is not absolute, it
  is searched in the current directory.
Owen Taylor's avatar
Owen Taylor committed
892
893
894
895


<!-- ##### FUNCTION gtk_rc_parse_string ##### -->
<para>
Matthias Clasen's avatar
Matthias Clasen committed
896
Parses resource information directly from a string.
Owen Taylor's avatar
Owen Taylor committed
897
898
899
900
901
902
903
904
905
</para>

@rc_string: a string to parse.


<!-- ##### FUNCTION gtk_rc_reparse_all ##### -->
<para>
</para>

906
@Returns: 
Owen Taylor's avatar
Owen Taylor committed
907
908


909
910
911
912
913
914
915
916
917
918
<!-- ##### FUNCTION gtk_rc_reparse_all_for_settings ##### -->
<para>

</para>

@settings: 
@force_load: 
@Returns: 


919
920
921
922
923
924
925
926
<!-- ##### FUNCTION gtk_rc_reset_styles ##### -->
<para>

</para>

@settings: 


Owen Taylor's avatar
Owen Taylor committed
927
928
929
930
<!-- ##### FUNCTION gtk_rc_add_default_file ##### -->
<para>
</para>

931
@filename: 
Owen Taylor's avatar
Owen Taylor committed
932
933
934
935
936
937


<!-- ##### FUNCTION gtk_rc_get_default_files ##### -->
<para>
</para>

938
@Returns: 
Owen Taylor's avatar
Owen Taylor committed
939
940
941
942
943
944


<!-- ##### FUNCTION gtk_rc_set_default_files ##### -->
<para>
</para>

945
@filenames: 
Owen Taylor's avatar
Owen Taylor committed
946
947
948
949


<!-- ##### FUNCTION gtk_rc_parse_color ##### -->
<para>
Matthias Clasen's avatar
Matthias Clasen committed
950
Parses a color in the <link linkend="color-format">format</link> expected in a RC file.
Owen Taylor's avatar
Owen Taylor committed
951
952
953
954
</para>

@scanner: a #GtkScanner
@color: a pointer to a #GtkColor structure in which to store the result
Matthias Clasen's avatar
Matthias Clasen committed
955
@Returns: %G_TOKEN_NONE if parsing succeeded, otherwise the token
Owen Taylor's avatar
Owen Taylor committed
956
957
958
959
960
961
962
963
964
965
966
967
that was expected but not found.


<!-- ##### FUNCTION gtk_rc_parse_state ##### -->
<para>
Parses a #GtkStateType variable from the format expected
in a RC file.
</para>

@scanner: a #GtkScanner (must be initialized for parsing an RC file)
@state: A pointer to a #GtkStateType variable in which to
store the result.
Matthias Clasen's avatar
Matthias Clasen committed
968
@Returns: %G_TOKEN_NONE if parsing succeeded, otherwise the token
Owen Taylor's avatar
Owen Taylor committed
969
970
971
972
973
974
975
976
977
978
979
980
that was expected but not found.


<!-- ##### FUNCTION gtk_rc_parse_priority ##### -->
<para>
Parses a #GtkPathPriorityType variable from the format expected
in a RC file.
</para>

@scanner: a #GtkScanner (must be initialized for parsing an RC file)
@priority: A pointer to #GtkPathPriorityType variable in which
to store the result.
Matthias Clasen's avatar
Matthias Clasen committed
981
@Returns: %G_TOKEN_NONE if parsing succeeded, otherwise the token
Owen Taylor's avatar
Owen Taylor committed
982
983
984
985
986
987
988
989
that was expected but not found.


<!-- ##### FUNCTION gtk_rc_find_module_in_path ##### -->
<para>
</para>

@module_file: The name of the module to search for.
990
@Returns: 
Owen Taylor's avatar
Owen Taylor committed
991
992
993
994
995
996


<!-- ##### FUNCTION gtk_rc_find_pixmap_in_path ##### -->
<para>
</para>

Owen Taylor's avatar
Owen Taylor committed
997
@settings: 
Owen Taylor's avatar
Owen Taylor committed
998
999
1000
@scanner: a #GtkScanner. Used for printing out warning messages
if the file is not found.
@pixmap_file: The name of the file to search for.
Matthias Clasen's avatar
Matthias Clasen committed
1001
@Returns: The filename, if found (must be freed with g_free()),
Owen Taylor's avatar
Owen Taylor committed
1002
otherwise %NULL.
Owen Taylor's avatar
Owen Taylor committed
1003
1004
<!-- # Unused Parameters # -->
@context: 
Owen Taylor's avatar
Owen Taylor committed
1005
1006
1007
1008
1009
1010


<!-- ##### FUNCTION gtk_rc_get_module_dir ##### -->
<para>
</para>

Matthias Clasen's avatar
Matthias Clasen committed
1011
@Returns: 
Owen Taylor's avatar
Owen Taylor committed
1012
1013


1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
<!-- ##### FUNCTION gtk_rc_get_im_module_path ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION gtk_rc_get_im_module_file ##### -->
<para>

</para>

@Returns: 


Owen Taylor's avatar
Owen Taylor committed
1030
1031
1032
1033
1034
1035
1036
<!-- ##### FUNCTION gtk_rc_get_theme_dir ##### -->
<para>
Returns the standard directory in which themes should
be installed. (GTK+ does not actually use this directory
itself.)
</para>

Matthias Clasen's avatar
Matthias Clasen committed
1037
@Returns: The directory (must be freed with g_free()).
Owen Taylor's avatar
Owen Taylor committed
1038
1039
1040
1041


<!-- ##### FUNCTION gtk_rc_style_new ##### -->
<para>
Matthias Clasen's avatar
Matthias Clasen committed
1042
Creates a new #GtkRcStyle with no fields set and
Owen Taylor's avatar
Owen Taylor committed
1043
1044
1045
a reference count of 1.
</para>

Matthias Clasen's avatar
Matthias Clasen committed
1046
@Returns: the newly-created #GtkRcStyle
Owen Taylor's avatar
Owen Taylor committed
1047
1048


1049
1050
1051
1052
1053
1054
1055
1056
1057
<!-- ##### FUNCTION gtk_rc_style_copy ##### -->
<para>

</para>

@orig: 
@Returns: 


Owen Taylor's avatar
Owen Taylor committed
1058
1059
<!-- ##### FUNCTION gtk_rc_style_ref ##### -->
<para>
Matthias Clasen's avatar
Matthias Clasen committed
1060
Increments the reference count of a #GtkRcStyle.
Owen Taylor's avatar
Owen Taylor committed
1061
1062
1063
1064
1065
1066
1067
</para>

@rc_style: a #GtkRcStyle


<!-- ##### FUNCTION gtk_rc_style_unref ##### -->
<para>
Matthias Clasen's avatar
Matthias Clasen committed
1068
1069
Decrements the reference count of a #GtkRcStyle and
frees if the result is 0.
Owen Taylor's avatar
Owen Taylor committed
1070
1071
1072
1073
1074
</para>

@rc_style: a #GtkRcStyle