text: /* GTK - The GIMP Toolkit
   * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
   *
   * This library is free software; you can redistribute it and/or
   * modify it under the terms of the GNU Lesser General Public
   * License as published by the Free Software Foundation; either
   * version 2 of the License, or (at your option) any later version.
   *
   * This library is distributed in the hope that it will be useful,
   * but WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
   * Lesser General Public License for more details.
   *
   * You should have received a copy of the GNU Lesser General Public
   * License along with this library; if not, write to the
   * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   * Boston, MA 02111-1307, USA.
   */
  
  /*
   * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
   * file for a list of people on the GTK+ Team.  See the ChangeLog
   * files for a list of changes.  These files are distributed with
   * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
   */
  
  #ifndef __GTK_RC_H__
  #define __GTK_RC_H__
  
  
  #if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
  #error "Only <gtk/gtk.h> can be included directly."
  #endif
  
  #include <gtk/gtkstyle.h>
  
  G_BEGIN_DECLS
  
  /* Forward declarations */
  typedef struct _GtkIconFactory  GtkIconFactory;
  typedef struct _GtkRcContext    GtkRcContext;
  
  typedef struct _GtkRcStyleClass GtkRcStyleClass;
  
  #define GTK_TYPE_RC_STYLE              (gtk_rc_style_get_type ())
  #define GTK_RC_STYLE(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), GTK_TYPE_RC_STYLE, GtkRcStyle))
  #define GTK_RC_STYLE_CLASS(klass)      (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_RC_STYLE, GtkRcStyleClass))
  #define GTK_IS_RC_STYLE(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), GTK_TYPE_RC_STYLE))
  #define GTK_IS_RC_STYLE_CLASS(klass)   (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_RC_STYLE))
  #define GTK_RC_STYLE_GET_CLASS(obj)    (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_RC_STYLE, GtkRcStyleClass))
  
  typedef enum
  {
    GTK_RC_FG		= 1 << 0,
    GTK_RC_BG		= 1 << 1,
    GTK_RC_TEXT		= 1 << 2,
    GTK_RC_BASE		= 1 << 3
  } GtkRcFlags;
  
  struct _GtkRcStyle
  {
    GObject parent_instance;
  
    /*< public >*/
  
    gchar *name;
    gchar *bg_pixmap_name[5];
    PangoFontDescription *font_desc;
  
    GtkRcFlags color_flags[5];
    GdkColor   fg[5];
    GdkColor   bg[5];
    GdkColor   text[5];
    GdkColor   base[5];
  
    gint xthickness;
    gint ythickness;
  
    /*< private >*/
    GArray *rc_properties;
  
    /* list of RC style lists including this RC style */
    GSList *rc_style_lists;
  
    GSList *icon_factories;
  
    guint engine_specified : 1;	/* The RC file specified the engine */
  };
  
  struct _GtkRcStyleClass
  {
    GObjectClass parent_class;
  
    /* Create an empty RC style of the same type as this RC style.
     * The default implementation, which does
     * g_object_new (G_OBJECT_TYPE (style), NULL);
     * should work in most cases.
     */
    GtkRcStyle * (*create_rc_style) (GtkRcStyle *rc_style);
  
    /* Fill in engine specific parts of GtkRcStyle by parsing contents
     * of brackets. Returns G_TOKEN_NONE if successful, otherwise returns
     * the token it expected but didn't get.
     */
    guint     (*parse)  (GtkRcStyle   *rc_style,
  		       GtkSettings  *settings,
  		       GScanner     *scanner);
  
    /* Combine RC style data from src into dest. If overridden, this
     * function should chain to the parent.
     */
    void      (*merge)  (GtkRcStyle *dest,
  		       GtkRcStyle *src);
  
    /* Create an empty style suitable to this RC style
     */
    GtkStyle * (*create_style) (GtkRcStyle *rc_style);
  
    /* Padding for future expansion */
    void (*_gtk_reserved1) (void);
    void (*_gtk_reserved2) (void);
    void (*_gtk_reserved3) (void);
    void (*_gtk_reserved4) (void);
  };
  
  #ifdef G_OS_WIN32
  /* Reserve old names for DLL ABI backward compatibility */
  #define gtk_rc_add_default_file gtk_rc_add_default_file_utf8
  #define gtk_rc_set_default_files gtk_rc_set_default_files_utf8
  #define gtk_rc_parse gtk_rc_parse_utf8
  #endif
  
  void	  _gtk_rc_init			 (void);
  GSList*   _gtk_rc_parse_widget_class_path (const gchar *pattern);
  void      _gtk_rc_free_widget_class_path (GSList       *list);
  gboolean  _gtk_rc_match_widget_class     (GSList       *list,
                                            gint          length,
                                            gchar        *path,
                                            gchar        *path_reversed);
  
  void      gtk_rc_add_default_file	(const gchar *filename);
  void      gtk_rc_set_default_files      (gchar **filenames);
  gchar**   gtk_rc_get_default_files      (void);
  GtkStyle* gtk_rc_get_style		(GtkWidget   *widget);
  GtkStyle* gtk_rc_get_style_by_paths     (GtkSettings *settings,
  					 const char  *widget_path,
  					 const char  *class_path,
  					 GType        type);
  
  gboolean gtk_rc_reparse_all_for_settings (GtkSettings *settings,
  					  gboolean     force_load);
  void     gtk_rc_reset_styles             (GtkSettings *settings);
  
  gchar*   gtk_rc_find_pixmap_in_path (GtkSettings  *settings,
  				     GScanner     *scanner,
  				     const gchar  *pixmap_file);
  
  void	  gtk_rc_parse			(const gchar *filename);
  void	  gtk_rc_parse_string		(const gchar *rc_string);
  gboolean  gtk_rc_reparse_all		(void);
  
  #ifndef GTK_DISABLE_DEPRECATED
  void	  gtk_rc_add_widget_name_style	(GtkRcStyle   *rc_style,
  					 const gchar  *pattern);
  void	  gtk_rc_add_widget_class_style (GtkRcStyle   *rc_style,
  					 const gchar  *pattern);
  void	  gtk_rc_add_class_style	(GtkRcStyle   *rc_style,
  					 const gchar  *pattern);
  #endif /* GTK_DISABLE_DEPRECATED */
  
  
  GType       gtk_rc_style_get_type   (void) G_GNUC_CONST;
  GtkRcStyle* gtk_rc_style_new        (void);
  GtkRcStyle* gtk_rc_style_copy       (GtkRcStyle *orig);
  
  #ifndef GTK_DISABLE_DEPRECATED
  void        gtk_rc_style_ref        (GtkRcStyle *rc_style);
  void        gtk_rc_style_unref      (GtkRcStyle *rc_style);
  #endif
  
  gchar*		gtk_rc_find_module_in_path	(const gchar 	*module_file);
  gchar*		gtk_rc_get_theme_dir		(void);
  gchar*		gtk_rc_get_module_dir		(void);
  gchar*		gtk_rc_get_im_module_path	(void);
  gchar*		gtk_rc_get_im_module_file	(void);
  
  /* private functions/definitions */
  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_TEXT,
    GTK_RC_TOKEN_BASE,
    GTK_RC_TOKEN_XTHICKNESS,
    GTK_RC_TOKEN_YTHICKNESS,
    GTK_RC_TOKEN_FONT,
    GTK_RC_TOKEN_FONTSET,
    GTK_RC_TOKEN_FONT_NAME,
    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_THEME,
    GTK_RC_TOKEN_RC,
    GTK_RC_TOKEN_HIGHEST,
    GTK_RC_TOKEN_ENGINE,
    GTK_RC_TOKEN_MODULE_PATH,
    GTK_RC_TOKEN_IM_MODULE_PATH,
    GTK_RC_TOKEN_IM_MODULE_FILE,
    GTK_RC_TOKEN_STOCK,
    GTK_RC_TOKEN_LTR,
    GTK_RC_TOKEN_RTL,
    GTK_RC_TOKEN_COLOR,
    GTK_RC_TOKEN_UNBIND,
    GTK_RC_TOKEN_LAST
  } GtkRcTokenType;
  
  GScanner* gtk_rc_scanner_new	(void);
  guint	  gtk_rc_parse_color	(GScanner	     *scanner,
  				 GdkColor	     *color);
  guint	  gtk_rc_parse_color_full (GScanner	     *scanner,
                                     GtkRcStyle        *style,
  				   GdkColor	     *color);
  guint	  gtk_rc_parse_state	(GScanner	     *scanner,
  				 GtkStateType	     *state);
  guint	  gtk_rc_parse_priority	(GScanner	     *scanner,
  				 GtkPathPriorityType *priority);
  
  /* rc properties
   * (structure forward declared in gtkstyle.h)
   */
  struct _GtkRcProperty
  {
    /* quark-ified property identifier like "GtkScrollbar::spacing" */
    GQuark type_name;
    GQuark property_name;
  
    /* fields similar to GtkSettingsValue */
    gchar *origin;
    GValue value;
  };
  const GtkRcProperty* _gtk_rc_style_lookup_rc_property (GtkRcStyle *rc_style,
  						       GQuark      type_name,
  						       GQuark      property_name);
  void	      _gtk_rc_style_set_rc_property	      (GtkRcStyle *rc_style,
  						       GtkRcProperty *property);
  void	      _gtk_rc_style_unset_rc_property	      (GtkRcStyle *rc_style,
  						       GQuark      type_name,
  						       GQuark      property_name);
  
  GSList     * _gtk_rc_style_get_color_hashes        (GtkRcStyle *rc_style);
  
  const gchar* _gtk_rc_context_get_default_font_name (GtkSettings *settings);
  void         _gtk_rc_context_destroy               (GtkSettings *settings);
  
  G_END_DECLS
  
  #endif /* __GTK_RC_H__ */
  