diff options
Diffstat (limited to 'gtk')
-rw-r--r-- | gtk/gtkstyle.c | 20 | ||||
-rw-r--r-- | gtk/gtkstyle.h | 16 |
2 files changed, 36 insertions, 0 deletions
diff --git a/gtk/gtkstyle.c b/gtk/gtkstyle.c index 53c4711f90..8a1c8cc970 100644 --- a/gtk/gtkstyle.c +++ b/gtk/gtkstyle.c @@ -43,6 +43,26 @@ #include "gtkalias.h" #include "gtkspinner.h" + +/** + * SECTION:gtkstyle + * @Short_description: An object that hold style information for widgets + * @Title: GtkStyle + * + * A #GtkStyle object encapsulates the information that provides the look and + * feel for a widget. Each #GtkWidget has an associated #GTkStyle object that + * is used when rendering that widget. Also, a #GtkStyle holds information for + * the five possible widget states though not every widget supports all five + * states; see #GtkStateType. + * + * Usually the #GtkStyle for a widget is the same as the default style that is + * set by GTK+ and modified the theme engine. + * + * Usually applications should not need to use or modify the #GtkStyle of their + * widgets. + */ + + #define LIGHTNESS_MULT 1.3 #define DARKNESS_MULT 0.7 diff --git a/gtk/gtkstyle.h b/gtk/gtkstyle.h index 141cbcc379..dd8890002e 100644 --- a/gtk/gtkstyle.h +++ b/gtk/gtkstyle.h @@ -68,6 +68,12 @@ typedef gboolean (*GtkRcPropertyParser) (const GParamSpec *pspec, */ typedef struct _GtkWidget GtkWidget; +/** + * GTK_STYLE_ATTACHED: + * @style: a #GtkStyle. + * + * Returns whether the style is attached to a window. + */ #define GTK_STYLE_ATTACHED(style) (GTK_STYLE (style)->attach_count > 0) struct _GtkStyle @@ -429,6 +435,16 @@ struct _GtkStyleClass void (*_gtk_reserved11) (void); }; +/** + * GtkBorder: + * @left: The width of the left border. + * @right: The width of the right border. + * @top: The width of the top border. + * @bottom: The width of the bottom border. + * + * A struct that specifies a border around a rectangular area that can + * be of different width on each side. + */ struct _GtkBorder { gint left; |