Sophie: ghc-gtk-devel-0.11.2-5.fc14 i686

ghc-gtk-devel-0.11.2-5.fc14.i686.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--Rendered using the Haskell Html Library v0.2-->
<HTML
><HEAD
><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8"
><TITLE
>Graphics.UI.Gtk.General.RcStyle</TITLE
><LINK HREF="haddock.css" REL="stylesheet" TYPE="text/css"
><SCRIPT SRC="haddock-util.js" TYPE="text/javascript"
></SCRIPT
><SCRIPT TYPE="text/javascript"
>window.onload = function () {setSynopsis("mini_Graphics-UI-Gtk-General-RcStyle.html")};</SCRIPT
></HEAD
><BODY
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="topbar"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD
><IMG SRC="haskell_icon.gif" WIDTH="16" HEIGHT="16" ALT=" "
></TD
><TD CLASS="title"
>gtk-0.11.2: Binding to the Gtk+ graphical user interface library.</TD
><TD CLASS="topbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html"
>Source code</A
></TD
><TD CLASS="topbut"
><A HREF="index.html"
>Contents</A
></TD
><TD CLASS="topbut"
><A HREF="doc-index.html"
>Index</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="modulebar"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD
><FONT SIZE="6"
>Graphics.UI.Gtk.General.RcStyle</FONT
></TD
><TD ALIGN="right"
><TABLE CLASS="narrow" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="infohead"
>Portability</TD
><TD CLASS="infoval"
>portable (depends on GHC)</TD
></TR
><TR
><TD CLASS="infohead"
>Stability</TD
><TD CLASS="infoval"
>provisional</TD
></TR
><TR
><TD CLASS="infohead"
>Maintainer</TD
><TD CLASS="infoval"
>gtk2hs-users@lists.sourceforge.net</TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="section4"
><B
>Contents</B
></TD
></TR
><TR
><TD
><DL
><DT
><A HREF="#1"
>Detail
</A
></DT
><DD
><DL
><DT
><A HREF="#2"
>Default files
</A
></DT
><DT
><A HREF="#3"
>Pathnames and patterns
</A
></DT
><DT
><A HREF="#4"
>Optimizing RC Style Matches
</A
></DT
><DT
><A HREF="#5"
>Toplevel declarations
</A
></DT
><DT
><A HREF="#6"
>Styles
</A
></DT
><DT
><A HREF="#7"
>Key bindings
</A
></DT
></DL
></DD
><DT
><A HREF="#8"
>Class Hierarchy
</A
></DT
><DT
><A HREF="#9"
>Types
</A
></DT
><DT
><A HREF="#10"
>Constructors
</A
></DT
><DT
><A HREF="#11"
>Methods
</A
></DT
></DL
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
>Description</TD
></TR
><TR
><TD CLASS="doc"
>Routines for handling resource files
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
>Synopsis</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>data</SPAN
>  <A HREF="#t%3ARcStyle"
>RcStyle</A
> </TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>class</SPAN
> <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass"
>GObjectClass</A
> o =&gt; <A HREF="#t%3ARcStyleClass"
>RcStyleClass</A
> o </TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AcastToRcStyle"
>castToRcStyle</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass"
>GObjectClass</A
> obj =&gt; obj -&gt; <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgTypeRcStyle"
>gTypeRcStyle</A
> :: <A HREF="Graphics-UI-Gtk-Abstract-Widget.html#t%3AGType"
>GType</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AtoRcStyle"
>toRcStyle</A
> :: <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyleClass"
>RcStyleClass</A
> o =&gt; o -&gt; <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcStyleNew"
>rcStyleNew</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcStyleCopy"
>rcStyleCopy</A
> :: <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyleClass"
>RcStyleClass</A
> self =&gt; self -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcAddDefaultFile"
>rcAddDefaultFile</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcGetDefaultFiles"
>rcGetDefaultFiles</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> [<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
>]</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcGetImModuleFile"
>rcGetImModuleFile</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcGetModuleDir"
>rcGetModuleDir</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcGetStyle"
>rcGetStyle</A
> :: <A HREF="Graphics-UI-Gtk-Abstract-Widget.html#t%3AWidgetClass"
>WidgetClass</A
> widget =&gt; widget -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="Graphics-UI-Gtk-General-Style.html#t%3AStyle"
>Style</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcGetStyleByPaths"
>rcGetStyleByPaths</A
> :: Settings -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="Graphics-UI-Gtk-Abstract-Widget.html#t%3AGType"
>GType</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="Graphics-UI-Gtk-General-Style.html#t%3AStyle"
>Style</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcGetThemeDir"
>rcGetThemeDir</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcParse"
>rcParse</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcParseString"
>rcParseString</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcReparseAll"
>rcReparseAll</A
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Bool.html#t%3ABool"
>Bool</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcReparseAllForSettings"
>rcReparseAllForSettings</A
> :: Settings -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Bool.html#t%3ABool"
>Bool</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Bool.html#t%3ABool"
>Bool</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcResetStyles"
>rcResetStyles</A
> :: Settings -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3ArcSetDefaultFiles"
>rcSetDefaultFiles</A
> :: [<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
>] -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
><A NAME="1"
><A NAME="1"
>Detail
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="doc"
>Gtk+ provides resource file mechanism for configuring various aspects of
 the operation of a Gtk+ program at runtime.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section2"
><A NAME="2"
><A NAME="2"
>Default files
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="doc"
><P
>An application can cause Gtk+ to parse a specific RC file by calling
 <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#v%3ArcParse"
>rcParse</A
></TT
>. In addition to this, certain files will be read at the end of
 initGUI. Unless modified, the files looked for will be
 <TT
>&lt;SYSCONFDIR&gt;/gtk-2.0/gtkrc</TT
> and <TT
>.gtkrc-2.0</TT
> in the users home directory.
 <TT
>(&lt;SYSCONFDIR&gt;</TT
> defaults to <TT
>/usr/local/etc</TT
>. It can be changed with the
 --prefix or --sysconfdir options when configuring Gtk+.) Note that although
 the filenames contain the version number 2.0, all 2.x versions of Gtk+ look
 for these files.
</P
><P
>The set of these default files can be retrieved with <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#v%3ArcGetDefaultFiles"
>rcGetDefaultFiles</A
></TT
>
 and modified with <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#v%3ArcAddDefaultFile"
>rcAddDefaultFile</A
></TT
> and <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#v%3ArcSetDefaultFiles"
>rcSetDefaultFiles</A
></TT
>. Additionally,
 the <TT
>GTK2_RC_FILES</TT
> environment variable can be set to a
 <TT
><A HREF=":.html"
>:</A
></TT
>-separated list of
 files in order to overwrite the set of default files at runtime.
</P
><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 <TT
>LANG</TT
> is set to <TT
>ja_JP.ujis</TT
>, when loading the default file <TT
>~/.gtkrc</TT
> then
 Gtk+ looks for <TT
>~/.gtkrc.ja_JP</TT
> and <TT
>~/.gtkrc.ja</TT
>, and parses the first of
 those that exists.
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section2"
><A NAME="3"
><A NAME="3"
>Pathnames and patterns
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="doc"
><P
>A resource file defines a number of styles and key bindings and attaches
 them to particular widgets. The attachment is done by the <TT
>widget</TT
>,
 <TT
>widget_class</TT
>, and <TT
>class</TT
> declarations. As an example of such a statement:
 attaches the style <TT
>&quot;my-entry-class&quot;</TT
> to all widgets whose widget path
 matches the pattern <TT
>&quot;mywindow.*.GtkEntry&quot;</TT
>. That is, all <TT
><A HREF="Graphics-UI-Gtk-Entry-Entry.html#t%3AEntry"
>Entry</A
></TT
> widgets
 which are part of a <TT
><A HREF="Graphics-UI-Gtk-Windows-Window.html#t%3AWindow"
>Window</A
></TT
> named <TT
>&quot;mywindow&quot;</TT
>.
</P
><PRE
> widget &quot;mywindow.*.GtkEntry&quot; style &quot;my-entry-class&quot;
</PRE
><P
>The patterns here are given in the standard shell glob syntax. The
 <TT
>&quot;?&quot;</TT
> wildcard matches any character, while <TT
>&quot;*&quot;</TT
> 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 <TT
>&quot;.&quot;</TT
> 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 widgetSetName 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, <TT
>widget_class</TT
> paths can also contain <TT
>&lt;classname&gt;</TT
>
 substrings, which are matching the class with the given name and any derived
 classes. For instance, will match <TT
><A HREF="Graphics-UI-Gtk-Display-Label.html#t%3ALabel"
>Label</A
></TT
> widgets which are contained in any
 kind of menu item.
</P
><PRE
> widget_class &quot;*GtkMenuItem.GtkLabel&quot; style &quot;my-style&quot;
</PRE
><P
>So, if you have a <TT
><A HREF="Graphics-UI-Gtk-Entry-Entry.html#t%3AEntry"
>Entry</A
></TT
> named <TT
>&quot;myentry&quot;</TT
>, inside of a horizontal box
 in a window named <TT
>&quot;mywindow&quot;</TT
>, then the widget path is:
 <TT
>&quot;mywindow.GtkHBox.myentry&quot;</TT
> while the class path is:
 <TT
>&quot;GtkWindow.GtkHBox.GtkEntry&quot;</TT
>.
</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: will match not just <TT
><A HREF="Graphics-UI-Gtk-Buttons-Button.html#t%3AButton"
>Button</A
></TT
>
 widgets, but also <TT
><A HREF="Graphics-UI-Gtk-Buttons-ToggleButton.html#t%3AToggleButton"
>ToggleButton</A
></TT
> and <TT
><A HREF="Graphics-UI-Gtk-Buttons-CheckButton.html#t%3ACheckButton"
>CheckButton</A
></TT
> widgets, since those
 classes derive from <TT
><A HREF="Graphics-UI-Gtk-Buttons-Button.html#t%3AButton"
>Button</A
></TT
>.
</P
><PRE
> class &quot;GtkButton&quot; style &quot;my-style&quot;
</PRE
><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
><UL
><LI
><PRE
>highest</PRE
></LI
><LI
><PRE
>rc</PRE
></LI
><LI
><PRE
>theme</PRE
></LI
><LI
><PRE
>application</PRE
></LI
><LI
><PRE
>gtk</PRE
></LI
><LI
><PRE
>lowest</PRE
></LI
></UL
><P
><TT
>rc</TT
> is the default for styles read from an RC file, <TT
>theme</TT
> is the
 default for styles read from theme RC files, <TT
>application</TT
> should be used
 for styles an application sets up, and <TT
>gtk</TT
> is used for styles that Gtk+
 creates internally.
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section2"
><A NAME="4"
><A NAME="4"
>Optimizing RC Style Matches
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="doc"
><P
>Everytime a widget is created and added to the layout hierarchy of a
 <TT
><A HREF="Graphics-UI-Gtk-Windows-Window.html#t%3AWindow"
>Window</A
></TT
> (&quot;anchored&quot; to be exact), a list of matching RC styles out of all
 RC styles read in so far is composed. For this, every RC style is matched
 against the widgets class path, the widgets name path and widgets
 inheritance hierarchy. As a consequence, significant slowdown can be caused
 by utilization of many RC styles and by using RC style patterns that are
 slow or complicated to match against a given widget. The following ordered
 list provides a number of advices (prioritized by effectiveness) to reduce
 the performance overhead associated with RC style matches:
</P
><P
>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
><P
>Merge multiple styles which use the same matching rule, for instance: is
 faster to match as:
</P
><PRE
> style &quot;Foo&quot; { foo_content }
 class &quot;X&quot; style &quot;Foo&quot;
 style &quot;Bar&quot; { bar_content }
 class &quot;X&quot; style &quot;Bar&quot;
</PRE
><PRE
> style &quot;FooBar&quot; { foo_content bar_content }
 class &quot;X&quot; style &quot;FooBar&quot;
</PRE
><P
>Use of wildcards should be avoided, this can reduce the individual RC
 style match to a single integer comparison in most cases.
</P
><P
>To avoid complex recursive matching, specification of full class names
 (for <TT
>class</TT
> matches) or full path names (for <TT
>widget</TT
> and <TT
>widget_class</TT
>
 matches) is to be preferred over shortened names containing <TT
>&quot;*&quot;</TT
> or
 <TT
>&quot;?&quot;</TT
>.
</P
><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
><P
>When using wildcards, use of <TT
>&quot;?&quot;</TT
> should be preferred over <TT
>&quot;*&quot;</TT
>.
 This can reduce the matching complexity from O(n^2) to O(n). For example
 <TT
>&quot;Gtk*Box&quot;</TT
> can be turned into <TT
>&quot;Gtk?Box&quot;</TT
> and will still match <TT
><A HREF="Graphics-UI-Gtk-Layout-HBox.html#t%3AHBox"
>HBox</A
></TT
>
 and <TT
><A HREF="Graphics-UI-Gtk-Layout-VBox.html#t%3AVBox"
>VBox</A
></TT
>.
</P
><P
>The use of <TT
>&quot;*&quot;</TT
> wildcards should be restricted as much as possible,
 because matching <TT
>&quot;A*B*C*RestString&quot;</TT
> can result in matching complexities
 of O(n^2) worst case.
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section2"
><A NAME="5"
><A NAME="5"
>Toplevel declarations
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="doc"
><P
>An RC file is a text file which is composed of a sequence of
 declarations. <TT
>'#'</TT
> characters delimit comments and the portion of a line
 after a <TT
>'#'</TT
> is ignored when parsing an RC file.
</P
><P
>The possible toplevel declarations are:
</P
><DL
><DT
><TT
>binding name { ... }</TT
></DT
><DD
> Declares a binding set.
</DD
><DT
><TT
>class pattern [ style | binding ][ : priority ] name</TT
></DT
><DD
>
 Specifies a style or binding set for a particular branch of the inheritance
 hierarchy.
</DD
><DT
><TT
>include filename</TT
></DT
><DD
> 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. Gtk+ also tries to load a locale-specific variant of the
 included file.
</DD
><DT
><TT
>module_path path</TT
></DT
><DD
> Sets a path (a list of directories separated by
 colons) that will be searched for theme engines referenced in RC files.
</DD
><DT
><TT
>pixmap_path path</TT
></DT
><DD
> Sets a path (a list of directories separated by
 colons) that will be searched for pixmaps referenced in RC files.
</DD
><DT
><TT
>im_module_file pathname</TT
></DT
><DD
> Sets the pathname for the IM modules file.
 Setting this from RC files is deprecated; you should use the environment
 variable GTK_IM_MODULE_FILE instead.
</DD
><DT
><TT
>style name [ = parent ] { ... }</TT
></DT
><DD
> Declares a style.
</DD
><DT
><TT
>widget pattern [ style | binding ][ : priority ] name</TT
></DT
><DD
>
 Specifies a style or binding set for a particular group of widgets by
 matching on the widget pathname.
</DD
><DT
><TT
>widget_class pattern [ style | binding ][ : priority ] name</TT
></DT
><DD
>
 Specifies a style or binding set for a particular group of widgets by
 matching on the class pathname.
</DD
><DT
>setting = value</DT
><DD
> Specifies a value for a setting. Note that settings in
 RC files are overwritten by system-wide settings (which are managed by an
 XSettings manager on X11).
</DD
></DL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section2"
><A NAME="6"
><A NAME="6"
>Styles
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="doc"
><P
>A RC style is specified by a <TT
>style</TT
> declaration in a RC file, and then
 bound to widgets with a <TT
>widget</TT
>, <TT
>widget_class</TT
>, or <TT
>class</TT
> declaration.
 All styles applying to a particular widget are composited together with
 <TT
>widget</TT
> declarations overriding <TT
>widget_class</TT
> declarations which, in turn,
 override <TT
>class</TT
> declarations. Within each type of declaration, later
 declarations override earlier ones.
</P
><P
>Within a <TT
>style</TT
> declaration, the possible elements are:
</P
><DL
><DT
><TT
>bg[state] = color</TT
></DT
><DD
> Sets the color used for the background of
 most widgets.
</DD
><DT
><TT
>fg[state] = color</TT
></DT
><DD
> Sets the color used for the foreground of
 most widgets.
</DD
><DT
><TT
>base[state] = color</TT
></DT
><DD
> Sets the color used for the background of
 widgets displaying editable text. This color is used for the background of,
 among others, {GtkText, FIXME: unknown type/value}, <TT
><A HREF="Graphics-UI-Gtk-Entry-Entry.html#t%3AEntry"
>Entry</A
></TT
>, <TT
>List</TT
>, and
 <TT
>CList</TT
>.
</DD
><DT
><TT
>text[state] = color</TT
></DT
><DD
> Sets the color used for foreground of
 widgets using <TT
>base</TT
> for the background color.
</DD
><DT
><TT
>xthickness = number</TT
></DT
><DD
> Sets the xthickness, which is used for
 various horizontal padding values in Gtk+.
</DD
><DT
><TT
>ythickness = number</TT
></DT
><DD
> Sets the ythickness, which is used for
 various vertical padding values in Gtk+.
</DD
><DT
><TT
>bg_pixmap[state] = pixmap</TT
></DT
><DD
> Sets a background pixmap to be used
 in place of the <TT
>bg</TT
> color (or for {GtkText, FIXME: unknown type/value}, in
 place of the <TT
>base</TT
> color. The special value <TT
>&quot;&lt;parent&gt;&quot;</TT
> may be used to
 indicate that the widget should use the same background pixmap as its
 parent. The special value <TT
>&quot;&lt;none&gt;&quot;</TT
> may be used to indicate no
 background pixmap.
</DD
><DT
><TT
>font = font</TT
></DT
><DD
> Starting with Gtk+ 2.0, the &quot;font&quot; and &quot;fontset&quot;
 declarations are ignored; use &quot;font_name&quot; declarations instead.
</DD
><DT
><TT
>fontset = font</TT
></DT
><DD
> Starting with Gtk+ 2.0, the &quot;font&quot; and &quot;fontset&quot;
 declarations are ignored; use &quot;font_name&quot; declarations instead.
</DD
><DT
><TT
>font_name = font</TT
></DT
><DD
> Sets the font for a widget. font must be a Pango
 font name, e.g. <TT
>&quot;Sans Italic 10&quot;</TT
>. For details about Pango font names,
 see fontDescriptionFromString.
</DD
><DT
><TT
>stock[&quot;stock-id&quot;] = { icon source specifications }</TT
></DT
><DD
> Defines the
 icon for a stock item.
</DD
><DT
><TT
>color[&quot;color-name&quot;] = color specification</TT
></DT
><DD
> Since 2.10, this element
 can be used to defines symbolic colors. See below for the syntax of color
 specifications.
</DD
><DT
><TT
>engine &quot;engine&quot; { engine-specific settings }</TT
></DT
><DD
> Defines the engine to
 be used when drawing with this style.
</DD
><DT
><TT
>class::property = value</TT
></DT
><DD
> Sets a style property for a widget class.
</DD
></DL
><P
>The colors and background pixmaps are specified as a function of the
 state of the widget. The states are:
</P
><DL
><DT
><TT
>NORMAL</TT
></DT
><DD
> A color used for a widget in its normal state.
</DD
><DT
><TT
>ACTIVE</TT
></DT
><DD
> A variant of the <TT
>NORMAL</TT
> color used when the widget is in the
 StateActive 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 <TT
>NORMAL</TT
> color.
</DD
><DT
><TT
>PRELIGHT</TT
></DT
><DD
> A color used for widgets in the StatePrelight state. This
 state is the used for Buttons and MenuItems that have the mouse cursor over
 them, and for their children.
</DD
><DT
><TT
>SELECTED</TT
></DT
><DD
> 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.
</DD
><DT
><TT
>INSENSITIVE</TT
></DT
><DD
> A color used for the background of widgets that have been
 set insensitive with widgetSetSensitive.
</DD
></DL
><P
>Colors can be specified as a string containing a color name (GTK+ knows
 all names from the X color database /usr/lib/X11/rgb.txt), in one of the
 hexadecimal forms <TT
><A NAME="rrrrggggbbbb@, @#rrrgggbbb@, @#rrggbb@, or @"
><A NAME="rrrrggggbbbb%40%2C%20%40%23rrrgggbbb%40%2C%20%40%23rrggbb%40%2C%20or%20%40"
></A
></A
>rgb</TT
>, where
 <TT
>r</TT
>, <TT
>g</TT
> and <TT
>b</TT
> are hex digits, or they can be specified as a triplet <TT
>{ r,
 g, b}</TT
>, where <TT
>r</TT
>, <TT
>g</TT
> and <TT
>b</TT
> 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: <TT
>@color-name</TT
>, or by using expressions to combine colors. The
 following expressions are currently supported:
</P
><DL
><DT
>mix (factor, color1, color2)</DT
><DD
> 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.
</DD
><DT
>shade (factor, color)</DT
><DD
> 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.
</DD
><DT
>lighter (color)</DT
><DD
> This is an abbreviation for <TT
>shade (1.3, color)</TT
>.
</DD
><DT
>darker (color)</DT
><DD
> This is an abbreviation for <TT
>shade (0.7, color)</TT
>.
</DD
></DL
><P
>Here are some examples of color expressions:
</P
><PRE
> mix (0.5, &quot;red&quot;, &quot;blue&quot;)
 shade (1.5, mix (0.3, &quot;#0abbc0&quot;, { 0.3, 0.5, 0.9 }))
 lighter (@foreground)
</PRE
><P
>In a <TT
>stock</TT
> 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 <TT
>&quot;itemltr.png&quot;</TT
>, while icon names (looked up in the current icon
 theme), are specified with a leading <TT
>@</TT
>, such as <TT
>@&quot;item-ltr&quot;</TT
>. The <TT
>*</TT
>
 character can be used as a wildcard, and if direction/state/size are
 omitted they default to <TT
>*</TT
>. So for example, the following specifies
 different icons to use for left-to-right and right-to-left languages: This
 could be abbreviated as follows:
</P
><PRE
> stock[&quot;my-stock-item&quot;] =
 {
 { &quot;itemltr.png&quot;, LTR, *, * },
 { &quot;itemrtl.png&quot;, RTL, *, * }
 }
</PRE
><PRE
> stock[&quot;my-stock-item&quot;] =
 {
 { &quot;itemltr.png&quot;, LTR },
 { &quot;itemrtl.png&quot;, RTL }
 }
</PRE
><P
>You can specify custom icons for specific sizes, as follows: The sizes
 that come with Gtk+ itself are <TT
>&quot;gtk-menu&quot;</TT
>, <TT
>&quot;gtk-small-toolbar&quot;</TT
>,
 <TT
>&quot;gtk-large-toolbar&quot;</TT
>, <TT
>&quot;gtk-button&quot;</TT
>, <TT
>&quot;gtk-dialog&quot;</TT
>. Applications
 can define other sizes.
</P
><PRE
> stock[&quot;my-stock-item&quot;] =
 {
 { &quot;itemmenusize.png&quot;, *, *, &quot;gtk-menu&quot; },
 { &quot;itemtoolbarsize.png&quot;, *, *, &quot;gtk-large-toolbar&quot; }
 { &quot;itemgeneric.png&quot; }
 }
</PRE
><P
>It's also possible to use custom icons for a given state, for example:
</P
><PRE
> stock[&quot;my-stock-item&quot;] =
 {
 { &quot;itemprelight.png&quot;, *, PRELIGHT },
 { &quot;iteminsensitive.png&quot;, *, INSENSITIVE },
 { &quot;itemgeneric.png&quot; }
 }
</PRE
><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
 <TT
>PRELIGHT</TT
> 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
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section2"
><A NAME="7"
><A NAME="7"
>Key bindings
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="doc"
><P
>Key bindings allow the user to specify actions to be taken on particular
 key presses. The form of a binding set declaration is:
</P
><P
>key is a string consisting of a series of modifiers followed by the name
 of a key. The modifiers can be:
</P
><UL
><LI
><PRE
>&lt;alt&gt;</PRE
></LI
><LI
><PRE
>&lt;ctl&gt;</PRE
></LI
><LI
><PRE
>&lt;control&gt;</PRE
></LI
><LI
><PRE
>&lt;meta&gt;</PRE
></LI
><LI
><PRE
>&lt;hyper&gt;</PRE
></LI
><LI
><PRE
>&lt;super&gt;</PRE
></LI
><LI
><PRE
>&lt;mod1&gt;</PRE
></LI
><LI
><PRE
>&lt;mod2&gt;</PRE
></LI
><LI
><PRE
>&lt;mod3&gt;</PRE
></LI
><LI
><PRE
>&lt;mod4&gt;</PRE
></LI
><LI
><PRE
>&lt;mod5&gt;</PRE
></LI
><LI
><PRE
>&lt;release&gt;</PRE
></LI
><LI
><PRE
>&lt;shft&gt;</PRE
></LI
><LI
><PRE
>&lt;shift&gt;</PRE
></LI
></UL
><P
><TT
>&lt;shft&gt;</TT
> is an alias for <TT
>&lt;shift&gt;</TT
>, <TT
>&lt;ctl&gt;</TT
> is an alias for
 <TT
>&lt;control&gt;</TT
>, and <TT
>&lt;alt&gt;</TT
> is an alias for <TT
>&lt;mod1&gt;</TT
>.
</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 gSignalNew). 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
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
><A NAME="8"
><A NAME="8"
>Class Hierarchy
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="doc"
><PRE
>
 | <TT
><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObject"
>GObject</A
></TT
>
 | +----RcStyle
</PRE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
><A NAME="9"
><A NAME="9"
>Types
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><SPAN CLASS="keyword"
>data</SPAN
>  <A NAME="t:RcStyle"
><A NAME="t%3ARcStyle"
></A
></A
><B
>RcStyle</B
>  </TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-Types.html#RcStyle"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="section4"
><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:RcStyle')" ALT="show/hide"
> Instances</TD
></TR
><TR
><TD CLASS="body"
><DIV ID="i:RcStyle" STYLE="display:block;"
><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Eq.html#t%3AEq"
>Eq</A
> <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Ord.html#t%3AOrd"
>Ord</A
> <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass"
>GObjectClass</A
> <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyleClass"
>RcStyleClass</A
> <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><SPAN CLASS="keyword"
>class</SPAN
> <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass"
>GObjectClass</A
> o =&gt; <A NAME="t:RcStyleClass"
><A NAME="t%3ARcStyleClass"
></A
></A
><B
>RcStyleClass</B
> o </TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-Types.html#RcStyleClass"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="section4"
><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:RcStyleClass')" ALT="show/hide"
> Instances</TD
></TR
><TR
><TD CLASS="body"
><DIV ID="i:RcStyleClass" STYLE="display:block;"
><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyleClass"
>RcStyleClass</A
> <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:castToRcStyle"
><A NAME="v%3AcastToRcStyle"
></A
></A
><B
>castToRcStyle</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass"
>GObjectClass</A
> obj =&gt; obj -&gt; <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-Types.html#castToRcStyle"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:gTypeRcStyle"
><A NAME="v%3AgTypeRcStyle"
></A
></A
><B
>gTypeRcStyle</B
> :: <A HREF="Graphics-UI-Gtk-Abstract-Widget.html#t%3AGType"
>GType</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-Types.html#gTypeRcStyle"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:toRcStyle"
><A NAME="v%3AtoRcStyle"
></A
></A
><B
>toRcStyle</B
> :: <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyleClass"
>RcStyleClass</A
> o =&gt; o -&gt; <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-Types.html#toRcStyle"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
><A NAME="10"
><A NAME="10"
>Constructors
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcStyleNew"
><A NAME="v%3ArcStyleNew"
></A
></A
><B
>rcStyleNew</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcStyleNew"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>Creates a new <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TT
> with no fields set. The <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TT
> structure is
 used to represent a set of information about the appearance of a widget.
 This can later be composited together with other <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TT
> structures to
 form a <TT
><A HREF="Graphics-UI-Gtk-General-Style.html#t%3AStyle"
>Style</A
></TT
>.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
><A NAME="11"
><A NAME="11"
>Methods
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcStyleCopy"
><A NAME="v%3ArcStyleCopy"
></A
></A
><B
>rcStyleCopy</B
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcStyleCopy"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="arg"
>:: <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyleClass"
>RcStyleClass</A
> self</TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
>=&gt; self</TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TD
><TD CLASS="rdoc"
>returns the resulting <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TT
>
</TD
></TR
><TR
><TD CLASS="ndoc" COLSPAN="2"
>Makes a copy of the specified <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TT
>. This function will correctly
 copy an RC style that is a member of a class derived from <TT
><A HREF="Graphics-UI-Gtk-General-RcStyle.html#t%3ARcStyle"
>RcStyle</A
></TT
>.
</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcAddDefaultFile"
><A NAME="v%3ArcAddDefaultFile"
></A
></A
><B
>rcAddDefaultFile</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcAddDefaultFile"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>Adds a file to the list of files to be parsed at the end of initGUI.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcGetDefaultFiles"
><A NAME="v%3ArcGetDefaultFiles"
></A
></A
><B
>rcGetDefaultFiles</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> [<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
>]</TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcGetDefaultFiles"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>etrieves the current list of RC files that will be parsed at the end of
 initGUI.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcGetImModuleFile"
><A NAME="v%3ArcGetImModuleFile"
></A
></A
><B
>rcGetImModuleFile</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcGetImModuleFile"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>Obtains the path to the IM modules file. See the documentation of the
 <TT
>GTK_IM_MODULE_FILE</TT
> environment variable for more details.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcGetModuleDir"
><A NAME="v%3ArcGetModuleDir"
></A
></A
><B
>rcGetModuleDir</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcGetModuleDir"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>Returns a directory in which GTK+ looks for theme engines.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcGetStyle"
><A NAME="v%3ArcGetStyle"
></A
></A
><B
>rcGetStyle</B
> :: <A HREF="Graphics-UI-Gtk-Abstract-Widget.html#t%3AWidgetClass"
>WidgetClass</A
> widget =&gt; widget -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="Graphics-UI-Gtk-General-Style.html#t%3AStyle"
>Style</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcGetStyle"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>Finds all matching RC styles for a given widget, composites them
 together, and then creates a GtkStyle representing the composite
 appearance. (GTK+ actually keeps a cache of previously created styles, so a
 new style may not be created.)
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcGetStyleByPaths"
><A NAME="v%3ArcGetStyleByPaths"
></A
></A
><B
>rcGetStyleByPaths</B
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcGetStyleByPaths"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="arg"
>:: Settings</TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="rdoc"
><TT
>widgetPath</TT
> : the widget path to use when looking up the style, or
 <TT
>Nothing</TT
> if no matching against the widget path should be done
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="rdoc"
><TT
>classPath</TT
> : the class path to use when looking up the style, or
 <TT
>Nothing</TT
> if no matching against the class path should be done.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="Graphics-UI-Gtk-Abstract-Widget.html#t%3AGType"
>GType</A
></TD
><TD CLASS="rdoc"
><TT
>type</TT
> : a type that will be used along with parent types of this type when
 matching against class styles, or <TT
><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GTypeConstants.html#v%3Anone"
>none</A
></TT
>
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="Graphics-UI-Gtk-General-Style.html#t%3AStyle"
>Style</A
></TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="ndoc" COLSPAN="2"
>Creates up a <TT
><A HREF="Graphics-UI-Gtk-General-Style.html#t%3AStyle"
>Style</A
></TT
> 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.
</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcGetThemeDir"
><A NAME="v%3ArcGetThemeDir"
></A
></A
><B
>rcGetThemeDir</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcGetThemeDir"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>Returns the standard directory in which themes should be installed. (GTK+
 does not actually use this directory itself.)
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcParse"
><A NAME="v%3ArcParse"
></A
></A
><B
>rcParse</B
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcParse"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="arg"
>:: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="rdoc"
><TT
>filename</TT
> : the <TT
>filename</TT
> of a file to parse. If <TT
>filename</TT
> is not
 absolute, it is searched in the current directory.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="ndoc" COLSPAN="2"
>Parses a given resource file.
</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcParseString"
><A NAME="v%3ArcParseString"
></A
></A
><B
>rcParseString</B
> :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcParseString"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>Parses resource information directly from a string.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcReparseAll"
><A NAME="v%3ArcReparseAll"
></A
></A
><B
>rcReparseAll</B
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcReparseAll"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="arg"
>:: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Bool.html#t%3ABool"
>Bool</A
></TD
><TD CLASS="rdoc"
><TT
>True</TT
> if the files were reread.
</TD
></TR
><TR
><TD CLASS="ndoc" COLSPAN="2"
>If the modification time on any previously read file for the default
 <TT
>Settings</TT
> has changed, discard all style information and then reread all
 previously read RC files.
</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcReparseAllForSettings"
><A NAME="v%3ArcReparseAllForSettings"
></A
></A
><B
>rcReparseAllForSettings</B
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcReparseAllForSettings"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="arg"
>:: Settings</TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Bool.html#t%3ABool"
>Bool</A
></TD
><TD CLASS="rdoc"
><TT
>forceLoad</TT
> : load whether or not anything changed
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Bool.html#t%3ABool"
>Bool</A
></TD
><TD CLASS="rdoc"
><TT
>True</TT
> if the files were reread.
</TD
></TR
><TR
><TD CLASS="ndoc" COLSPAN="2"
>f the modification time on any previously read file for the given
 <TT
>Settings</TT
> has changed, discard all style information and then reread all
 previously read RC files.
</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcResetStyles"
><A NAME="v%3ArcResetStyles"
></A
></A
><B
>rcResetStyles</B
> :: Settings -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcResetStyles"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>This function recomputes the styles for all widgets that use a particular
 <TT
>Settings</TT
> object. (There is one <TT
>Settings</TT
> object per <TT
><A HREF="Graphics-UI-Gtk-Gdk-Screen.html#t%3AScreen"
>Screen</A
></TT
>, see
 settingsGetForScreen.) It is useful when some global parameter has
 changed that affects the appearance of all widgets, because when a widget
 gets a new style, it will both redraw and recompute any cached information
 about its appearance. As an example, it is used when the default font size
 set by the operating system changes. Note that this function doesn't affect
 widgets that have a style set explicitely on them with widgetSetStyle.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="topdecl"
><TABLE CLASS="declbar"
><TR
><TD CLASS="declname"
><A NAME="v:rcSetDefaultFiles"
><A NAME="v%3ArcSetDefaultFiles"
></A
></A
><B
>rcSetDefaultFiles</B
> :: [<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString"
>String</A
>] -&gt; <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO"
>IO</A
> <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29"
>()</A
></TD
><TD CLASS="declbut"
><A HREF="src/Graphics-UI-Gtk-General-RcStyle.html#rcSetDefaultFiles"
>Source</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="doc"
>Sets the list of files that GTK+ will read at the end of initGUI.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="botbar"
>Produced by <A HREF="http://www.haskell.org/haddock/"
>Haddock</A
> version 2.6.1</TD
></TR
></TABLE
></BODY
></HTML
>