📄 gtk-resource-files.html
字号:
<HTML><HEAD><TITLE>Resource Files</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ "HREF="gtk.html"><LINKREL="PREVIOUS"TITLE="Themes"HREF="gtk-themes.html"><LINKREL="NEXT"TITLE="Keyboard Accelerators"HREF="gtk-keyboard-accelerators.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtk-themes.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtk.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtk-keyboard-accelerators.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTK-RESOURCE-FILES">Resource Files</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN4594"></A><H2>Name</H2>Resource Files -- Routines for handling resource files</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN4597"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtk-resource-files.html#GTKRCSTYLE">GtkRcStyle</A>;enum <AHREF="gtk-resource-files.html#GTKRCFLAGS">GtkRcFlags</A>;<AHREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKPIXMAP>GdkPixmap</A>* (<AHREF="gtk-resource-files.html#GTKIMAGELOADER">*GtkImageLoader</A>) (<AHREF=../gdk/gdk-windows.html#GDKWINDOW>GdkWindow</A> *window, <AHREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLORMAP>GdkColormap</A> *colormap, <AHREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKBITMAP>GdkBitmap</A> **mask, <AHREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR>GdkColor</A> *transparent_color, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *filename);enum <AHREF="gtk-resource-files.html#GTKRCTOKENTYPE">GtkRcTokenType</A>;<AHREF="gtk-styles.html#GTKSTYLE">GtkStyle</A>* <AHREF="gtk-resource-files.html#GTK-RC-GET-STYLE">gtk_rc_get_style</A> (<AHREF="gtkwidget.html">GtkWidget</A> *widget);void <AHREF="gtk-resource-files.html#GTK-RC-ADD-WIDGET-NAME-STYLE">gtk_rc_add_widget_name_style</A> (<AHREF="gtk-resource-files.html#GTKRCSTYLE">GtkRcStyle</A> *rc_style, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *pattern);void <AHREF="gtk-resource-files.html#GTK-RC-ADD-WIDGET-CLASS-STYLE">gtk_rc_add_widget_class_style</A> (<AHREF="gtk-resource-files.html#GTKRCSTYLE">GtkRcStyle</A> *rc_style, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *pattern);void <AHREF="gtk-resource-files.html#GTK-RC-ADD-CLASS-STYLE">gtk_rc_add_class_style</A> (<AHREF="gtk-resource-files.html#GTKRCSTYLE">GtkRcStyle</A> *rc_style, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *pattern);void <AHREF="gtk-resource-files.html#GTK-RC-PARSE">gtk_rc_parse</A> (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *filename);void <AHREF="gtk-resource-files.html#GTK-RC-PARSE-STRING">gtk_rc_parse_string</A> (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *rc_string);<AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> <AHREF="gtk-resource-files.html#GTK-RC-REPARSE-ALL">gtk_rc_reparse_all</A> (void);void <AHREF="gtk-resource-files.html#GTK-RC-ADD-DEFAULT-FILE">gtk_rc_add_default_file</A> (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *filename);<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>** <AHREF="gtk-resource-files.html#GTK-RC-GET-DEFAULT-FILES">gtk_rc_get_default_files</A> (void);void <AHREF="gtk-resource-files.html#GTK-RC-SET-DEFAULT-FILES">gtk_rc_set_default_files</A> (<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> **filenames);<AHREF=../glib/glib-basic-types.html#GUINT>guint</A> <AHREF="gtk-resource-files.html#GTK-RC-PARSE-COLOR">gtk_rc_parse_color</A> (<AHREF=../glib/glib-lexical-scanner.html#GSCANNER>GScanner</A> *scanner, <AHREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR>GdkColor</A> *color);<AHREF=../glib/glib-basic-types.html#GUINT>guint</A> <AHREF="gtk-resource-files.html#GTK-RC-PARSE-STATE">gtk_rc_parse_state</A> (<AHREF=../glib/glib-lexical-scanner.html#GSCANNER>GScanner</A> *scanner, <AHREF="gtk-standard-enumerations.html#GTKSTATETYPE">GtkStateType</A> *state);<AHREF=../glib/glib-basic-types.html#GUINT>guint</A> <AHREF="gtk-resource-files.html#GTK-RC-PARSE-PRIORITY">gtk_rc_parse_priority</A> (<AHREF=../glib/glib-lexical-scanner.html#GSCANNER>GScanner</A> *scanner, <AHREF="gtk-standard-enumerations.html#GTKPATHPRIORITYTYPE">GtkPathPriorityType</A> *priority);<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* <AHREF="gtk-resource-files.html#GTK-RC-FIND-MODULE-IN-PATH">gtk_rc_find_module_in_path</A> (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *module_file);<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* <AHREF="gtk-resource-files.html#GTK-RC-FIND-PIXMAP-IN-PATH">gtk_rc_find_pixmap_in_path</A> (<AHREF=../glib/glib-lexical-scanner.html#GSCANNER>GScanner</A> *scanner, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *pixmap_file);<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* <AHREF="gtk-resource-files.html#GTK-RC-GET-MODULE-DIR">gtk_rc_get_module_dir</A> (void);<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* <AHREF="gtk-resource-files.html#GTK-RC-GET-THEME-DIR">gtk_rc_get_theme_dir</A> (void);void <AHREF="gtk-resource-files.html#GTK-RC-SET-IMAGE-LOADER">gtk_rc_set_image_loader</A> (<AHREF="gtk-resource-files.html#GTKIMAGELOADER">GtkImageLoader</A> loader);<AHREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKPIXMAP>GdkPixmap</A>* <AHREF="gtk-resource-files.html#GTK-RC-LOAD-IMAGE">gtk_rc_load_image</A> (<AHREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLORMAP>GdkColormap</A> *colormap, <AHREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR>GdkColor</A> *transparent_color, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *filename);<AHREF="gtk-resource-files.html#GTKRCSTYLE">GtkRcStyle</A>* <AHREF="gtk-resource-files.html#GTK-RC-STYLE-NEW">gtk_rc_style_new</A> (void);void <AHREF="gtk-resource-files.html#GTK-RC-STYLE-REF">gtk_rc_style_ref</A> (<AHREF="gtk-resource-files.html#GTKRCSTYLE">GtkRcStyle</A> *rc_style);void <AHREF="gtk-resource-files.html#GTK-RC-STYLE-UNREF">gtk_rc_style_unref</A> (<AHREF="gtk-resource-files.html#GTKRCSTYLE">GtkRcStyle</A> *rc_style);void <AHREF="gtk-resource-files.html#GTK-RC-INIT">gtk_rc_init</A> (void);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN4671"></A><H2>Description</H2><P>GTK+ provides resource file mechanism for configuringvarious aspects of the operation of a GTK+ programat runtime.</P><DIVCLASS="REFSECT2"><ANAME="AEN4674"></A><H3>Default files</H3><P>An application can cause GTK+ to parse a specific RCfile by calling <AHREF="gtk-resource-files.html#GTK-RC-PARSE">gtk_rc_parse</A>(). In addition to this,certain files will be read at the end of <AHREF="gtk-general.html#GTK-INIT">gtk_init</A>().Unless modified, the files looked for will be <TTCLASS="FILENAME">.gtkrc</TT>in the users home directory, and <TTCLASS="FILENAME">$localstatedir/gtk/gtkrc</TT> (<TTCLASS="LITERAL">$localstatedir</TT> defaults to <TTCLASS="FILENAME">/usr/local/etc</TT>).</P><P>The set of these <ICLASS="FIRSTTERM">default</I> filescan be retrieved with <AHREF="gtk-resource-files.html#GTK-RC-GET-DEFAULT-FILES">gtk_rc_get_default_files</A>()and modified with <AHREF="gtk-resource-files.html#GTK-RC-ADD-DEFAULT-FILE">gtk_rc_add_default_file</A>() and<AHREF="gtk-resource-files.html#GTK-RC-SET-DEFAULT-FILES">gtk_rc_set_default_files</A>().</P><P>For each default file, in addition to the file itself,GTK+ will look for a locale-specific file that willbe parsed in addition to the main file. For instance,if <TTCLASS="LITERAL">LANG</TT> is set to <TTCLASS="LITERAL">ja_JP.ujis</TT>,when loading the default file <TTCLASS="FILENAME">~/.gtkrc</TT>then GTK+ looks for <TTCLASS="FILENAME">~/.gtkrc.ja_JP.ujis</TT>,<TTCLASS="FILENAME">~/.gtkrc.ja_JP</TT>, and<TTCLASS="FILENAME">~/.gtkrc.ja</TT>, and parses thefirst one it finds.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN4695"></A><H3>Pathnames and patterns</H3><P>A resource file defines a number of styles and key bindings andattaches them to particular widgets. The attachment is doneby the <TTCLASS="LITERAL">widget</TT>, <TTCLASS="LITERAL">widget_class</TT>,and <TTCLASS="LITERAL">class</TT> declarations. As an exampleof such a statement:<TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">widget "mywindow.*.GtkEntry" style "my-entry-class"</PRE></TD></TR></TABLE>attaches the style <TTCLASS="LITERAL">"my-entry-class"</TT>to all widgets whose <ICLASS="FIRSTTERM">widget class</I>matches the <ICLASS="FIRSTTERM">pattern</I><TTCLASS="LITERAL">"mywindow.*.GtkEntry"</TT>.</P><P>The patterns here are given in the standard shell globsyntax. The <TTCLASS="LITERAL">"?"</TT> wildcard matchesany character, while <TTCLASS="LITERAL">"*"</TT> matcheszero or more of any character. The three types ofmatching are against the widget path, the<ICLASS="FIRSTTERM">class path</I> and the classheirarchy. Both the widget and the class paths consists of a<TTCLASS="LITERAL">"."</TT> separated list of all theparents of the widget and the widget itself fromoutermost to innermost. The difference is that inthe widget path, the name assigned by<TTCLASS="FUNCTION"><AHREF="gtkwidget.html#GTK-WIDGET-SET-NAME">gtk_widget_set_name</A>()</TT> is usedif present, otherwise the class name of the widget, whilefor the widget path, the class name is always used.</P><P>So, if you have a <TTCLASS="CLASSNAME">GtkEntry</TT> named<TTCLASS="LITERAL">"myentry"</TT>, inside of a of a windownamed <TTCLASS="LITERAL">"mywindow"</TT>, then thewidget path is:<TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">"mwindow.GtkHBox.myentry"</PRE></TD></TR></TABLE>while the class path is:<TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">"GtkWindow.GtkHBox.GtkEntry"</PRE></TD></TR></TABLE></P><P>Matching against class is a little different. The patternmatch is done against all class names in the widgetsclass heirarchy (not the layout heirarchy) in sequence, so thepattern:<TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">class "GtkButton" style "my-style"</PRE></TD></TR></TABLE>will match not just <TTCLASS="CLASSNAME">GtkButton</TT> widgets,but also <TTCLASS="CLASSNAME">GtkToggleButton</TT> and<TTCLASS="CLASSNAME">GtkCheckButton</TT> widgets, sincethose classes derive from <TTCLASS="CLASSNAME">GtkButton</TT>.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN4725"></A><H3>Toplevel declarations</H3><P>An RC file is a text file which is composed of a sequenceof declarations. '#' characters delimit comments andthe portion of a line after a '#' is ignored when parsingan RC file.</P><P>The possible toplevel declarations are:<P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="LITERAL">binding <TTCLASS="REPLACEABLE"><I>name</I></TT> { ... }</TT></DT><DD><P>Declare a binding set</P></DD><DT><TTCLASS="LITERAL">class <TTCLASS="REPLACEABLE"><I>pattern</I></TT> [ style | binding [ : <TTCLASS="REPLACEABLE"><I>priority</I></TT> ]] <TTCLASS="REPLACEABLE"><I>name</I></TT></TT></DT><DD><P>Specify a style or binding set for a particular branch of the inheritance heirarchy.</P></DD><DT><TTCLASS="LITERAL">include <TTCLASS="REPLACEABLE"><I>filename</I></TT></TT></DT><DD><P>Parse another file at this point</P></DD><DT><TTCLASS="LITERAL">module_path <TTCLASS="REPLACEABLE"><I>path></I></TT></TT></DT><DD><P>Sets a path (a list of directories separated by colons) that will be searched for theme engines referenced in RC files.</P></DD><DT><TTCLASS="LITERAL">pixmap_path <TTCLASS="REPLACEABLE"><I>path></I></TT></TT></DT><DD><P>Sets a path (a list of directories separated by colons) that will be searched for pixmaps referenced in RC files.</P></DD><DT><TTCLASS="LITERAL">style <TTCLASS="REPLACEABLE"><I>name</I></TT> [ = <TTCLASS="REPLACEABLE"><I>parent</I></TT> ] { ... }</TT></DT><DD><P>Declare a style</P></DD><DT><TTCLASS="LITERAL">widget <TTCLASS="REPLACEABLE"><I>pattern</I></TT> [ style | binding [ : <TTCLASS="REPLACEABLE"><I>priority</I></TT> ]] <TTCLASS="REPLACEABLE"><I>name</I></TT></TT></DT><DD><P>Specify a style or binding set for a particular group of widgets by matching on the widget pathname.</P></DD><DT><TTCLASS="LITERAL">widget_class <TTCLASS="REPLACEABLE"><I>pattern</I></TT> [ style | binding [ : <TTCLASS="REPLACEABLE"><I>priority</I></TT> ]] <TTCLASS="REPLACEABLE"><I>name</I></TT></TT></DT><DD><P>Specify a style or binding set for a particular group of widgets by matching on the class pathname.</P></DD></DL></DIV></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN4785"></A><H3>Styles</H3><P>A RC style is specified by a <TTCLASS="LITERAL">style</TT> declaration in a RC file, and then bound to widgetswith a <TTCLASS="LITERAL">widget</TT>, <TTCLASS="LITERAL">widget_class</TT>,or <TTCLASS="LITERAL">class</TT> declaration. All stylesapplying to a particular widget are composited togetherwith <TTCLASS="LITERAL">widget</TT> declarations overriding<TTCLASS="LITERAL">widget_class</TT> declarations which, inturn, override <TTCLASS="LITERAL">widget</TT> declarations.Within each type of declaration, later declarations overrideearlier ones.</P><P>Within a <TTCLASS="LITERAL">style</TT> declaration, the possibleelements are:<P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="LITERAL">bg[<TTCLASS="REPLACEABLE"><I>state</I></TT>] = <TTCLASS="REPLACEABLE"><I>color</I></TT></TT></DT><DD><P> Set color used for the background of most widgets. </P></DD><DT><TTCLASS="LITERAL">fg[<TTCLASS="REPLACEABLE"><I>state</I></TT>] = <TTCLASS="REPLACEABLE"><I>color</I></TT></TT></DT><DD><P> Set color used for the foreground of most widgets. </P></DD><DT><TTCLASS="LITERAL">base[<TTCLASS="REPLACEABLE"><I>state</I></TT>] = <TTCLASS="REPLACEABLE"><I>color</I></TT></TT></DT><DD><P> Set color used for the background of widgets displaying editable text. This color is used for the background of, among others, <AHREF="gtktext.html">GtkText</A>, <AHREF="gtkentry.html">GtkEntry</A>, <AHREF="gtklist.html">GtkList</A>, and <AHREF="gtkclist.html">GtkClist</A>. </P></DD><DT><TTCLASS="LITERAL">text[<TTCLASS="REPLACEABLE"><I>state</I></TT>] = <TTCLASS="REPLACEABLE"><I>color</I></TT></TT></DT><DD><P> Set color used for foreground of widgets using <TTCLASS="LITERAL">base</TT> for the background color. </P></DD⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -