1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GTK+ Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
27 #ifndef __GTK_STYLE_H__
28 #define __GTK_STYLE_H__
32 #include <gtk/gtkenums.h>
33 #include <pango/pango.h>
37 #endif /* __cplusplus */
39 #define GTK_TYPE_STYLE (gtk_style_get_type ())
40 #define GTK_STYLE(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GTK_TYPE_STYLE, GtkStyle))
41 #define GTK_STYLE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_STYLE, GtkStyleClass))
42 #define GTK_IS_STYLE(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GTK_TYPE_STYLE))
43 #define GTK_IS_STYLE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_STYLE))
44 #define GTK_STYLE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_STYLE, GtkStyleClass))
46 /* Some forward declarations needed to rationalize the header
49 typedef struct _GtkBorder GtkBorder;
50 typedef struct _GtkStyle GtkStyle;
51 typedef struct _GtkStyleClass GtkStyleClass;
52 typedef struct _GtkThemeEngine GtkThemeEngine;
53 typedef struct _GtkRcStyle GtkRcStyle;
54 typedef struct _GtkIconSet GtkIconSet;
55 typedef struct _GtkIconSource GtkIconSource;
56 typedef struct _GtkRcProperty GtkRcProperty;
57 typedef gboolean (*GtkRcPropertyParser) (const GParamSpec *pspec,
58 const GString *rc_string,
59 GValue *property_value);
61 /* We make this forward declaration here, since we pass
62 * GtkWidgt's to the draw functions.
64 typedef struct _GtkWidget GtkWidget;
66 /* This is used for having dynamic style changing stuff
67 * fg, bg, light, dark, mid, text, base
69 #define GTK_STYLE_NUM_STYLECOLORS() (7 * 5)
71 #define GTK_STYLE_ATTACHED(style) (GTK_STYLE (style)->attach_count > 0)
75 GObject parent_instance;
86 GdkColor text_aa[5]; /* Halfway between text/base */
91 PangoFontDescription *font_desc;
103 GdkGC *text_aa_gc[5];
107 GdkPixmap *bg_pixmap[5];
114 GdkColormap *colormap;
116 /* the RcStyle from which this style was created */
117 GtkRcStyle *rc_style;
119 GSList *styles; /* of type GtkStyle* */
120 GBSearchArray *property_cache;
121 GSList *icon_factories; /* of type GtkIconFactory* */
124 struct _GtkStyleClass
126 GObjectClass parent_class;
128 /* Initialize for a particular colormap/depth
129 * combination. style->colormap/style->depth will have
130 * been set at this point. Will typically chain to parent.
132 void (*realize) (GtkStyle *style);
134 /* Clean up for a particular colormap/depth combination. Will
135 * typically chain to parent.
137 void (*unrealize) (GtkStyle *style);
139 /* Make style an exact duplicate of src.
141 void (*copy) (GtkStyle *style,
144 /* Create an empty style of the same type as this style.
145 * The default implementation, which does
146 * g_object_new (G_OBJECT_TYPE (style), NULL);
147 * should work in most cases.
149 GtkStyle *(*clone) (GtkStyle *style);
151 /* Initialize the GtkStyle with the values in the GtkRcStyle.
152 * should chain to the parent implementation.
154 void (*init_from_rc) (GtkStyle *style,
155 GtkRcStyle *rc_style);
157 void (*set_background) (GtkStyle *style,
159 GtkStateType state_type);
162 GdkPixbuf * (* render_icon) (GtkStyle *style,
163 const GtkIconSource *source,
164 GtkTextDirection direction,
168 const gchar *detail);
173 void (*draw_hline) (GtkStyle *style,
175 GtkStateType state_type,
182 void (*draw_vline) (GtkStyle *style,
184 GtkStateType state_type,
191 void (*draw_shadow) (GtkStyle *style,
193 GtkStateType state_type,
194 GtkShadowType shadow_type,
202 void (*draw_polygon) (GtkStyle *style,
204 GtkStateType state_type,
205 GtkShadowType shadow_type,
212 void (*draw_arrow) (GtkStyle *style,
214 GtkStateType state_type,
215 GtkShadowType shadow_type,
219 GtkArrowType arrow_type,
225 void (*draw_diamond) (GtkStyle *style,
227 GtkStateType state_type,
228 GtkShadowType shadow_type,
236 void (*draw_string) (GtkStyle *style,
238 GtkStateType state_type,
244 const gchar *string);
245 void (*draw_box) (GtkStyle *style,
247 GtkStateType state_type,
248 GtkShadowType shadow_type,
256 void (*draw_flat_box) (GtkStyle *style,
258 GtkStateType state_type,
259 GtkShadowType shadow_type,
267 void (*draw_check) (GtkStyle *style,
269 GtkStateType state_type,
270 GtkShadowType shadow_type,
278 void (*draw_option) (GtkStyle *style,
280 GtkStateType state_type,
281 GtkShadowType shadow_type,
289 void (*draw_tab) (GtkStyle *style,
291 GtkStateType state_type,
292 GtkShadowType shadow_type,
300 void (*draw_shadow_gap) (GtkStyle *style,
302 GtkStateType state_type,
303 GtkShadowType shadow_type,
311 GtkPositionType gap_side,
314 void (*draw_box_gap) (GtkStyle *style,
316 GtkStateType state_type,
317 GtkShadowType shadow_type,
325 GtkPositionType gap_side,
328 void (*draw_extension) (GtkStyle *style,
330 GtkStateType state_type,
331 GtkShadowType shadow_type,
339 GtkPositionType gap_side);
340 void (*draw_focus) (GtkStyle *style,
349 void (*draw_slider) (GtkStyle *style,
351 GtkStateType state_type,
352 GtkShadowType shadow_type,
360 GtkOrientation orientation);
361 void (*draw_handle) (GtkStyle *style,
363 GtkStateType state_type,
364 GtkShadowType shadow_type,
372 GtkOrientation orientation);
374 void (*draw_expander) (GtkStyle *style,
376 GtkStateType state_type,
382 GtkExpanderStyle expander_style);
383 void (*draw_layout) (GtkStyle *style,
385 GtkStateType state_type,
392 PangoLayout *layout);
393 void (*draw_resize_grip) (GtkStyle *style,
395 GtkStateType state_type,
415 GType gtk_style_get_type (void) G_GNUC_CONST;
416 GtkStyle* gtk_style_new (void);
417 GtkStyle* gtk_style_copy (GtkStyle *style);
418 GtkStyle* gtk_style_attach (GtkStyle *style,
420 void gtk_style_detach (GtkStyle *style);
421 GtkStyle* gtk_style_ref (GtkStyle *style);
422 void gtk_style_unref (GtkStyle *style);
423 void gtk_style_set_background (GtkStyle *style,
425 GtkStateType state_type);
426 void gtk_style_apply_default_background (GtkStyle *style,
429 GtkStateType state_type,
436 GtkIconSet* gtk_style_lookup_icon_set (GtkStyle *style,
437 const gchar *stock_id);
438 GdkPixbuf* gtk_style_render_icon (GtkStyle *style,
439 const GtkIconSource *source,
440 GtkTextDirection direction,
444 const gchar *detail);
445 void gtk_draw_hline (GtkStyle *style,
447 GtkStateType state_type,
451 void gtk_draw_vline (GtkStyle *style,
453 GtkStateType state_type,
457 void gtk_draw_shadow (GtkStyle *style,
459 GtkStateType state_type,
460 GtkShadowType shadow_type,
465 void gtk_draw_polygon (GtkStyle *style,
467 GtkStateType state_type,
468 GtkShadowType shadow_type,
472 void gtk_draw_arrow (GtkStyle *style,
474 GtkStateType state_type,
475 GtkShadowType shadow_type,
476 GtkArrowType arrow_type,
482 void gtk_draw_diamond (GtkStyle *style,
484 GtkStateType state_type,
485 GtkShadowType shadow_type,
490 void gtk_draw_box (GtkStyle *style,
492 GtkStateType state_type,
493 GtkShadowType shadow_type,
498 void gtk_draw_flat_box (GtkStyle *style,
500 GtkStateType state_type,
501 GtkShadowType shadow_type,
506 void gtk_draw_check (GtkStyle *style,
508 GtkStateType state_type,
509 GtkShadowType shadow_type,
514 void gtk_draw_option (GtkStyle *style,
516 GtkStateType state_type,
517 GtkShadowType shadow_type,
522 void gtk_draw_tab (GtkStyle *style,
524 GtkStateType state_type,
525 GtkShadowType shadow_type,
530 void gtk_draw_shadow_gap (GtkStyle *style,
532 GtkStateType state_type,
533 GtkShadowType shadow_type,
538 GtkPositionType gap_side,
541 void gtk_draw_box_gap (GtkStyle *style,
543 GtkStateType state_type,
544 GtkShadowType shadow_type,
549 GtkPositionType gap_side,
552 void gtk_draw_extension (GtkStyle *style,
554 GtkStateType state_type,
555 GtkShadowType shadow_type,
560 GtkPositionType gap_side);
561 void gtk_draw_focus (GtkStyle *style,
567 void gtk_draw_slider (GtkStyle *style,
569 GtkStateType state_type,
570 GtkShadowType shadow_type,
575 GtkOrientation orientation);
576 void gtk_draw_handle (GtkStyle *style,
578 GtkStateType state_type,
579 GtkShadowType shadow_type,
584 GtkOrientation orientation);
585 void gtk_draw_expander (GtkStyle *style,
587 GtkStateType state_type,
590 GtkExpanderStyle expander_style);
591 void gtk_draw_layout (GtkStyle *style,
593 GtkStateType state_type,
597 PangoLayout *layout);
599 void gtk_draw_resize_grip (GtkStyle *style,
601 GtkStateType state_type,
608 void gtk_paint_hline (GtkStyle *style,
610 GtkStateType state_type,
617 void gtk_paint_vline (GtkStyle *style,
619 GtkStateType state_type,
626 void gtk_paint_shadow (GtkStyle *style,
628 GtkStateType state_type,
629 GtkShadowType shadow_type,
637 void gtk_paint_polygon (GtkStyle *style,
639 GtkStateType state_type,
640 GtkShadowType shadow_type,
647 void gtk_paint_arrow (GtkStyle *style,
649 GtkStateType state_type,
650 GtkShadowType shadow_type,
654 GtkArrowType arrow_type,
660 void gtk_paint_diamond (GtkStyle *style,
662 GtkStateType state_type,
663 GtkShadowType shadow_type,
671 void gtk_paint_box (GtkStyle *style,
673 GtkStateType state_type,
674 GtkShadowType shadow_type,
682 void gtk_paint_flat_box (GtkStyle *style,
684 GtkStateType state_type,
685 GtkShadowType shadow_type,
693 void gtk_paint_check (GtkStyle *style,
695 GtkStateType state_type,
696 GtkShadowType shadow_type,
704 void gtk_paint_option (GtkStyle *style,
706 GtkStateType state_type,
707 GtkShadowType shadow_type,
715 void gtk_paint_tab (GtkStyle *style,
717 GtkStateType state_type,
718 GtkShadowType shadow_type,
726 void gtk_paint_shadow_gap (GtkStyle *style,
728 GtkStateType state_type,
729 GtkShadowType shadow_type,
737 GtkPositionType gap_side,
740 void gtk_paint_box_gap (GtkStyle *style,
742 GtkStateType state_type,
743 GtkShadowType shadow_type,
751 GtkPositionType gap_side,
754 void gtk_paint_extension (GtkStyle *style,
756 GtkStateType state_type,
757 GtkShadowType shadow_type,
765 GtkPositionType gap_side);
766 void gtk_paint_focus (GtkStyle *style,
775 void gtk_paint_slider (GtkStyle *style,
777 GtkStateType state_type,
778 GtkShadowType shadow_type,
786 GtkOrientation orientation);
787 void gtk_paint_handle (GtkStyle *style,
789 GtkStateType state_type,
790 GtkShadowType shadow_type,
798 GtkOrientation orientation);
799 void gtk_paint_expander (GtkStyle *style,
801 GtkStateType state_type,
807 GtkExpanderStyle expander_style);
808 void gtk_paint_layout (GtkStyle *style,
810 GtkStateType state_type,
817 PangoLayout *layout);
819 void gtk_paint_resize_grip (GtkStyle *style,
821 GtkStateType state_type,
832 GtkBorder *gtk_border_copy (const GtkBorder *border);
833 void gtk_border_free (GtkBorder *border);
835 /* --- private API --- */
836 const GValue* _gtk_style_peek_property_value (GtkStyle *style,
839 GtkRcPropertyParser parser);
843 #ifndef GTK_DISABLE_DEPRECATED
844 void gtk_draw_string (GtkStyle *style,
846 GtkStateType state_type,
849 const gchar *string);
850 void gtk_paint_string (GtkStyle *style,
852 GtkStateType state_type,
858 const gchar *string);
859 #endif /* GTK_DISABLE_DEPRECATED */
863 #endif /* __cplusplus */
866 #endif /* __GTK_STYLE_H__ */