gtk-resource-files.html

该压缩包包含了GTK+的大量API函数

><DT
><TT
CLASS="LITERAL"
>bg_text[<TT
CLASS="REPLACEABLE"
><I
>state</I
></TT
>] =
      <TT
CLASS="REPLACEABLE"
><I
>color</I
></TT
></TT
></DT
><DD
><P
>         Set a background pixmap to be used in place of
         the <TT
CLASS="LITERAL"
>bg</TT
> color (or for <A
HREF="gtktext.html"
>GtkText</A
>,
         in place of the <TT
CLASS="LITERAL"
>base</TT
> color.
       </P
></DD
><DT
><TT
CLASS="LITERAL"
>font = <TT
CLASS="REPLACEABLE"
><I
>font</I
></TT
></TT
></DT
><DD
><P
>         Set the font for a widget.
       </P
></DD
><DT
><TT
CLASS="LITERAL"
>fontset = <TT
CLASS="REPLACEABLE"
><I
>font</I
></TT
></TT
></DT
><DD
><P
>         Set the fontset for a widget. Overrides any
         <TT
CLASS="LITERAL"
>font</TT
> declarations.
       </P
></DD
></DL
></DIV
></P
><P
>The colors and background pixmaps are specified as a function of the
state of the widget. The states are:

<P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="LITERAL"
>NORMAL</TT
></DT
><DD
><P
>        A color used for a widget in its normal state
      </P
></DD
><DT
><TT
CLASS="LITERAL"
>ACTIVE</TT
></DT
><DD
><P
>        A variant of the <TT
CLASS="LITERAL"
>NORMAL</TT
> color used when the
        widget is in the <TT
CLASS="LITERAL"
>GTK_STATE_ACTIVE</TT
> 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
CLASS="LITERAL"
>NORMAL</TT
> color.
      </P
></DD
><DT
><TT
CLASS="LITERAL"
>PRELIGHT</TT
></DT
><DD
><P
>        A color used for widgets in the <TT
CLASS="LITERAL"
>GTK_STATE_PRELIGHT</TT
> state. This
        state is the used for Buttons and MenuItems
        that have the mouse cursor over them, and for 
        their children.
      </P
></DD
><DT
><TT
CLASS="LITERAL"
>SELECTED</TT
></DT
><DD
><P
>        A color used to highlight data selected by the user.
        for instance, the selected ListItems in a List widget, and the
        selection in an Editable widget.
      </P
></DD
><DT
><TT
CLASS="LITERAL"
>INSENSITIVE</TT
></DT
><DD
><P
>        A color used for the background of widgets that have
        been set insenstivie with gtk_widget_set_senstive()
      </P
></DD
></DL
></DIV
></P
><P
>Colors can be specified as a string <TT
CLASS="LITERAL"
>"#rrrrggggbbbb"</TT
>,
<TT
CLASS="LITERAL"
>"#rrrgggbbb"</TT
>, <TT
CLASS="LITERAL"
>"#rrggbb"</TT
>,
or <TT
CLASS="LITERAL"
>"#rgb"</TT
>, where <TT
CLASS="LITERAL"
>r</TT
>
<TT
CLASS="LITERAL"
>g</TT
>, and <TT
CLASS="LITERAL"
>b</TT
> are
hex digits, or they can be specified as a triplet of floats
<TT
CLASS="LITERAL"
>{ <TT
CLASS="REPLACEABLE"
><I
>r</I
></TT
>, <TT
CLASS="REPLACEABLE"
><I
>g</I
></TT
>,
<TT
CLASS="REPLACEABLE"
><I
>b</I
></TT
>}</TT
>.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4898"
></A
><H3
>Key bindings</H3
><P
>Key bindings allow the user to specify actions to be 
taken on particular key presses. The form of a binding
set declaration is:</P
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>binding <TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
> {
  bind <TT
CLASS="REPLACEABLE"
><I
>key</I
></TT
> { 
    <TT
CLASS="REPLACEABLE"
><I
>signalname</I
></TT
> (<TT
CLASS="REPLACEABLE"
><I
>param</I
></TT
>, ...)
    ...
  }
  ...
}</PRE
></TD
></TR
></TABLE
><P
><TT
CLASS="REPLACEABLE"
><I
>key</I
></TT
> is a string consisting of a 
series of modifiers followed by the name of a key. The
modifiers can be:
<P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;alt&gt;</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;control&gt;</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;mod1&gt;</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;mod2&gt;</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;mod3&gt;</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;mod4&gt;</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;mod5&gt;</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;release&gt;</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;shft&gt;</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>&lt;shift&gt;</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
>
<TT
CLASS="LITERAL"
>&lt;shft&gt;</TT
> is an alias for 
<TT
CLASS="LITERAL"
>&lt;shift&gt;</TT
> and 
<TT
CLASS="LITERAL"
>&lt;alt&gt;</TT
> is an alias for
<TT
CLASS="LITERAL"
>&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 <A
HREF="gtk-signals.html#GTK-SIGNAL-NEW"
>gtk_signal_new</A
>()). Each parameter can be
a float, integer, string, or unquoted string
representing an enumeration value. The types of
the parameters specified must match the types of the 
parameters of the signal.</P
><P
>Binding sets are connected to widgets in the
same manner as styles, with one addition. 
A priority can be specified for each pattern,
and within each type of pattern, binding sets
override other binding sets first by priority,
and only then by order of specification. (Later
overrides earlier). The priorities that can
be specified are (highest to lowest):
<P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><TT
CLASS="LITERAL"
>HIGHEST</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>RC</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>APPLICATION</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>GTK</TT
></TD
></TR
><TR
><TD
><TT
CLASS="LITERAL"
>LOWEST</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
>
<TT
CLASS="LITERAL"
>RC</TT
> is the default for bindings
read from an RC file, <TT
CLASS="LITERAL"
>APPLICATION</TT
>
should be used for bindings an application sets
up, and <TT
CLASS="LITERAL"
>GTK</TT
> is used for bindings
that GTK+ creates internally.</P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4950"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4952"
></A
><H3
><A
NAME="GTKRCSTYLE"
></A
>struct GtkRcStyle</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GtkRcStyle
{
  gchar *name;
  gchar *font_name;
  gchar *fontset_name;
  gchar *bg_pixmap_name[5];

  GtkRcFlags color_flags[5];
  GdkColor   fg[5];
  GdkColor   bg[5];
  GdkColor   text[5];
  GdkColor   base[5];

  GtkThemeEngine *engine;
  gpointer        engine_data;

  /* Private */
  guint ref_count;
};</PRE
></TD
></TR
></TABLE
><P
>The <A
HREF="gtk-resource-files.html#GTKRCSTYLE"
>GtkRcStyle</A
> structure is used to represent a set
of information about the appearance of a widget.
This can later be composited together with other
<A
HREF="gtk-resource-files.html#GTKRCSTYLE"
>GtkRcStyle</A
> structures to form a <A
HREF="gtk-styles.html#GTKSTYLE"
>GtkStyle</A
>.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4960"
></A
><H3
><A
NAME="GTKRCFLAGS"
></A
>enum GtkRcFlags</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
  GTK_RC_FG   = 1 &lt;&lt; 0,
  GTK_RC_BG   = 1 &lt;&lt; 1,
  GTK_RC_TEXT = 1 &lt;&lt; 2,
  GTK_RC_BASE = 1 &lt;&lt; 3
} GtkRcFlags;</PRE
></TD
></TR
></TABLE
><P
>The <A
HREF="gtk-resource-files.html#GTKRCFLAGS"
>GtkRcFlags</A
> enumeration is used as a bitmask
to specify which fields of a <A
HREF="gtk-resource-files.html#GTKRCSTYLE"
>GtkRcStyle</A
> have been
set for each state.</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="LITERAL"
>GTK_RC_FG</TT
></DT
><DD
><P
>   If present, the foreground color has been set for this state.
   </P
></DD
><DT
><TT
CLASS="LITERAL"
>GTK_RC_BG</TT
></DT
><DD
><P
>   If present, the background color has been set for this state.
   </P
></DD
><DT
><TT
CLASS="LITERAL"
>GTK_RC_TEXT</TT
></DT
><DD
><P
>   If present, the text color has been set for this state.
   </P
></DD
><DT
><TT
CLASS="LITERAL"
>GTK_RC_BASE</TT
></DT
><DD
><P
>   If present, the base color has been set for this state.
   </P
></DD
></DL
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4988"
></A
><H3
><A
NAME="GTKIMAGELOADER"
></A
>GtkImageLoader ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKPIXMAP
>GdkPixmap</A>*  (*GtkImageLoader)               (<A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A> *window,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLORMAP
>GdkColormap</A> *colormap,
                                             <A
HREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKBITMAP
>GdkBitmap</A> **mask,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *transparent_color,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *filename);</PRE
></TD
></TR
></TABLE
><P
>A GtkImageLoader is used to load a filename found in
a RC file.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4999"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the window for creating image</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>colormap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the colormap for this image</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mask</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a pointer to the location to store the mask</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>transparent_color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the transparent color for the image</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>filename to load</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkpixmap.html"
>GtkPixmap</A
> representing <TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5030"
></A
><H3
><A
NAME="GTKRCTOKENTYPE"
></A
>enum GtkRcTokenType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
  GTK_RC_TOKEN_INVALID = G_TOKEN_LAST,
  GTK_RC_TOKEN_INCLUDE,
  GTK_RC_TOKEN_NORMAL,
  GTK_RC_TOKEN_ACTIVE,
  GTK_RC_TOKEN_PRELIGHT,
  GTK_RC_TOKEN_SELECTED,
  GTK_RC_TOKEN_INSENSITIVE,
  GTK_RC_TOKEN_FG,
  GTK_RC_TOKEN_BG,
  GTK_RC_TOKEN_BASE,
  GTK_RC_TOKEN_TEXT,
  GTK_RC_TOKEN_FONT,
  GTK_RC_TOKEN_FONTSET,
  GTK_RC_TOKEN_BG_PIXMAP,
  GTK_RC_TOKEN_PIXMAP_PATH,
  GTK_RC_TOKEN_STYLE,
  GTK_RC_TOKEN_BINDING,
  GTK_RC_TOKEN_BIND,
  GTK_RC_TOKEN_WIDGET,
  GTK_RC_TOKEN_WIDGET_CLASS,
  GTK_RC_TOKEN_CLASS,
  GTK_RC_TOKEN_LOWEST,
  GTK_RC_TOKEN_GTK,
  GTK_RC_TOKEN_APPLICATION,
  GTK_RC_TOKEN_RC,
  GTK_RC_TOKEN_HIGHEST,
  GTK_RC_TOKEN_ENGINE,
  GTK_RC_TOKEN_MODULE_PATH,
  GTK_RC_TOKEN_LAST
} GtkRcTokenType;</PRE
></TD
></TR
></TABLE
><P
>The <A
HREF="gtk-resource-files.html#GTKRCTOKENTYPE"
>GtkRcTokenType</A
> enumeration represents the tokens
in the RC file. It is exposed so that theme engines
can reuse these tokens when parsing the theme-engine
specific portions of a RC file.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5036"
></A
><H3
><A
NAME="GTK-RC-GET-STYLE"
></A
>gtk_rc_get_style ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gtk-styles.html#GTKSTYLE"
>GtkStyle</A
>*   gtk_rc_get_style                (<A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget);</PRE
></TD
></TR
></TABLE
><P
>Finds all matching RC styles for a given widget,
composites them together, and then creates a 
<A
HREF="gtk-styles.html#GTKSTYLE"
>GtkStyle</A
> representing the composite appearance.
(GTK+ actually keeps a cache of previously 
created styles, so a new style may not be
created.)</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5044"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkwidget.html"
>GtkWidget</A
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the resulting style. The caller should
reference the result, since GTK+ will retain the
initial reference count itself for the cache
of created styles.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5058"
></A
><H3
><A
NAME="GTK-RC-ADD-WIDGET-NAME-STYLE"
></A
>gtk_rc_add_widget_name_style ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_rc_add_widget_name_style    (<A
HREF="gtk-resource-files.html#GTKRCSTYLE"
>GtkRcStyle</A
> *rc_style,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *pattern);</PRE
></TD
></TR
></TABLE
><P
>Add a RcStyle that will be looked up by a match against
the widget's pathname. This is equivalent to a:
<TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>widget PATTERN style STYLE</PRE
></TD
></TR
></TABLE
>
statement in a RC file.</P