]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtkrc.h
Remove deprecated 'shadow' properties in GtkFrame and GtkHandleBox
[~andy/gtk] / gtk / gtkrc.h
index 5f281fc6ccb8f62a26ddc2880b355b9a740a23ed..fb923c2f6b0e12ae33e3a80f3af724538360a1c7 100644 (file)
  * 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/. 
+ * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  */
 
+#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
+#error "Only <gtk/gtk.h> can be included directly."
+#endif
+
 #ifndef __GTK_RC_H__
 #define __GTK_RC_H__
 
 
 #include <gtk/gtkstyle.h>
-#include <gtk/gtkwidget.h>
 
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
+G_BEGIN_DECLS
 
-/* Forward declaration */
-typedef struct _GtkIconFactory GtkIconFactory;
+/* 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))
@@ -53,14 +57,12 @@ typedef enum
   GTK_RC_BASE          = 1 << 3
 } GtkRcFlags;
 
-typedef struct _GtkRcStyleClass GtkRcStyleClass;
-
 struct _GtkRcStyle
 {
   GObject parent_instance;
 
   /*< public >*/
-  
+
   gchar *name;
   gchar *bg_pixmap_name[5];
   PangoFontDescription *font_desc;
@@ -73,13 +75,16 @@ struct _GtkRcStyle
 
   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
@@ -91,60 +96,73 @@ struct _GtkRcStyleClass
    * g_object_new (G_OBJECT_TYPE (style), NULL);
    * should work in most cases.
    */
-  GtkRcStyle *(*clone) (GtkRcStyle *rc_style);
+  GtkRcStyle * (*create_rc_style) (GtkRcStyle *rc_style);
 
   /* Fill in engine specific parts of GtkRcStyle by parsing contents
-   * of brackets. Returns G_TOKEN_NONE if succesful, otherwise returns
+   * of brackets. Returns G_TOKEN_NONE if successful, otherwise returns
    * the token it expected but didn't get.
    */
-  guint     (*parse)  (GtkRcStyle *rc_style, GScanner *scanner);
-  
-  /* Combine RC style data from src into dest. If overriden, this
+  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);
+  void      (*merge)  (GtkRcStyle *dest,
+                      GtkRcStyle *src);
 
   /* Create an empty style suitable to this RC style
    */
-  GtkStyle *(*create_style) (GtkRcStyle *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);
 };
 
-void     gtk_rc_init                   (void);
-void      gtk_rc_add_default_file    (const gchar *filename);
+#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);
-GtkStyle* gtk_rc_get_style             (GtkWidget   *widget);
-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);
 
 GType       gtk_rc_style_get_type   (void) G_GNUC_CONST;
 GtkRcStyle* gtk_rc_style_new        (void);
-GtkRcStyle *gtk_rc_style_copy       (GtkRcStyle *orig);
-void        gtk_rc_style_ref        (GtkRcStyle *rc_style);
-void        gtk_rc_style_unref      (GtkRcStyle *rc_style);
+GtkRcStyle* gtk_rc_style_copy       (GtkRcStyle *orig);
 
-/* Tell gtkrc to use a custom routine to load images specified in rc files instead of
- *   the default xpm-only loader
- */
-typedef        GdkPixmap*  (*GtkImageLoader)           (GdkWindow      *window,
-                                                GdkColormap    *colormap,
-                                                GdkBitmap     **mask,
-                                                GdkColor       *transparent_color,
-                                                const gchar    *filename);
-void           gtk_rc_set_image_loader         (GtkImageLoader  loader);
-
-GdkPixmap*     gtk_rc_load_image               (GdkColormap    *colormap,
-                                                GdkColor       *transparent_color,
-                                                const gchar    *filename);
-gchar*         gtk_rc_find_pixmap_in_path      (GScanner       *scanner,
-                                                const gchar    *pixmap_file);
 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);
@@ -180,6 +198,7 @@ typedef enum {
   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,
@@ -189,26 +208,53 @@ typedef enum {
   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;
 
-guint  gtk_rc_parse_color      (GScanner            *scanner,
+GScanner* gtk_rc_scanner_new   (void);
+guint    gtk_rc_parse_color    (GScanner            *scanner,
                                 GdkColor            *color);
-guint  gtk_rc_parse_state      (GScanner            *scanner,
+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,
+guint    gtk_rc_parse_priority (GScanner            *scanner,
                                 GtkPathPriorityType *priority);
-     
-#ifdef G_OS_WIN32
 
-gchar  *gtk_win32_get_installation_directory (void);
+/* rc properties
+ * (structure forward declared in gtkstyle.h)
+ */
+struct _GtkRcProperty
+{
+  /* quark-ified property identifier like "GtkScrollbar::spacing" */
+  GQuark type_name;
+  GQuark property_name;
 
-#endif
+  /* 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);
 
+void         _gtk_rc_style_set_symbolic_color       (GtkRcStyle     *rc_style,
+                                                     const gchar    *name,
+                                                     const GdkColor *color);
 
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
+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__ */