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 #define GTK_TYPE_BORDER (gtk_border_get_type ())
48 /* Some forward declarations needed to rationalize the header
51 typedef struct _GtkBorder GtkBorder;
52 typedef struct _GtkStyle GtkStyle;
53 typedef struct _GtkStyleClass GtkStyleClass;
54 typedef struct _GtkThemeEngine GtkThemeEngine;
55 typedef struct _GtkRcStyle GtkRcStyle;
56 typedef struct _GtkIconSet GtkIconSet;
57 typedef struct _GtkIconSource GtkIconSource;
58 typedef struct _GtkRcProperty GtkRcProperty;
59 typedef struct _GtkSettings GtkSettings;
60 typedef gboolean (*GtkRcPropertyParser) (const GParamSpec *pspec,
61 const GString *rc_string,
62 GValue *property_value);
64 /* We make this forward declaration here, since we pass
65 * GtkWidget's to the draw functions.
67 typedef struct _GtkWidget GtkWidget;
69 #define GTK_STYLE_ATTACHED(style) (GTK_STYLE (style)->attach_count > 0)
73 GObject parent_instance;
84 GdkColor text_aa[5]; /* Halfway between text/base */
88 PangoFontDescription *font_desc;
100 GdkGC *text_aa_gc[5];
104 GdkPixmap *bg_pixmap[5];
111 GdkColormap *colormap;
112 GdkFont *private_font;
113 PangoFontDescription *private_font_desc; /* Font description for style->private_font or %NULL */
115 /* the RcStyle from which this style was created */
116 GtkRcStyle *rc_style;
118 GSList *styles; /* of type GtkStyle* */
119 GArray *property_cache;
120 GSList *icon_factories; /* of type GtkIconFactory* */
123 struct _GtkStyleClass
125 GObjectClass parent_class;
127 /* Initialize for a particular colormap/depth
128 * combination. style->colormap/style->depth will have
129 * been set at this point. Will typically chain to parent.
131 void (*realize) (GtkStyle *style);
133 /* Clean up for a particular colormap/depth combination. Will
134 * typically chain to parent.
136 void (*unrealize) (GtkStyle *style);
138 /* Make style an exact duplicate of src.
140 void (*copy) (GtkStyle *style,
143 /* Create an empty style of the same type as this style.
144 * The default implementation, which does
145 * g_object_new (G_OBJECT_TYPE (style), NULL);
146 * should work in most cases.
148 GtkStyle *(*clone) (GtkStyle *style);
150 /* Initialize the GtkStyle with the values in the GtkRcStyle.
151 * should chain to the parent implementation.
153 void (*init_from_rc) (GtkStyle *style,
154 GtkRcStyle *rc_style);
156 void (*set_background) (GtkStyle *style,
158 GtkStateType state_type);
161 GdkPixbuf * (* render_icon) (GtkStyle *style,
162 const GtkIconSource *source,
163 GtkTextDirection direction,
167 const gchar *detail);
172 void (*draw_hline) (GtkStyle *style,
174 GtkStateType state_type,
181 void (*draw_vline) (GtkStyle *style,
183 GtkStateType state_type,
190 void (*draw_shadow) (GtkStyle *style,
192 GtkStateType state_type,
193 GtkShadowType shadow_type,
201 void (*draw_polygon) (GtkStyle *style,
203 GtkStateType state_type,
204 GtkShadowType shadow_type,
211 void (*draw_arrow) (GtkStyle *style,
213 GtkStateType state_type,
214 GtkShadowType shadow_type,
218 GtkArrowType arrow_type,
224 void (*draw_diamond) (GtkStyle *style,
226 GtkStateType state_type,
227 GtkShadowType shadow_type,
235 void (*draw_string) (GtkStyle *style,
237 GtkStateType state_type,
243 const gchar *string);
244 void (*draw_box) (GtkStyle *style,
246 GtkStateType state_type,
247 GtkShadowType shadow_type,
255 void (*draw_flat_box) (GtkStyle *style,
257 GtkStateType state_type,
258 GtkShadowType shadow_type,
266 void (*draw_check) (GtkStyle *style,
268 GtkStateType state_type,
269 GtkShadowType shadow_type,
277 void (*draw_option) (GtkStyle *style,
279 GtkStateType state_type,
280 GtkShadowType shadow_type,
288 void (*draw_tab) (GtkStyle *style,
290 GtkStateType state_type,
291 GtkShadowType shadow_type,
299 void (*draw_shadow_gap) (GtkStyle *style,
301 GtkStateType state_type,
302 GtkShadowType shadow_type,
310 GtkPositionType gap_side,
313 void (*draw_box_gap) (GtkStyle *style,
315 GtkStateType state_type,
316 GtkShadowType shadow_type,
324 GtkPositionType gap_side,
327 void (*draw_extension) (GtkStyle *style,
329 GtkStateType state_type,
330 GtkShadowType shadow_type,
338 GtkPositionType gap_side);
339 void (*draw_focus) (GtkStyle *style,
341 GtkStateType state_type,
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,
405 /* Padding for future expansion */
406 void (*_gtk_reserved1) (void);
407 void (*_gtk_reserved2) (void);
408 void (*_gtk_reserved3) (void);
409 void (*_gtk_reserved4) (void);
410 void (*_gtk_reserved5) (void);
411 void (*_gtk_reserved6) (void);
412 void (*_gtk_reserved7) (void);
413 void (*_gtk_reserved8) (void);
414 void (*_gtk_reserved9) (void);
415 void (*_gtk_reserved10) (void);
416 void (*_gtk_reserved11) (void);
417 void (*_gtk_reserved12) (void);
428 GType gtk_style_get_type (void) G_GNUC_CONST;
429 GtkStyle* gtk_style_new (void);
430 GtkStyle* gtk_style_copy (GtkStyle *style);
431 GtkStyle* gtk_style_attach (GtkStyle *style,
433 void gtk_style_detach (GtkStyle *style);
435 #ifndef GTK_DISABLE_DEPRECATED
436 GtkStyle* gtk_style_ref (GtkStyle *style);
437 void gtk_style_unref (GtkStyle *style);
439 GdkFont * gtk_style_get_font (GtkStyle *style);
440 void gtk_style_set_font (GtkStyle *style,
442 #endif /* GTK_DISABLE_DEPRECATED */
444 void gtk_style_set_background (GtkStyle *style,
446 GtkStateType state_type);
447 void gtk_style_apply_default_background (GtkStyle *style,
450 GtkStateType state_type,
457 GtkIconSet* gtk_style_lookup_icon_set (GtkStyle *style,
458 const gchar *stock_id);
459 GdkPixbuf* gtk_style_render_icon (GtkStyle *style,
460 const GtkIconSource *source,
461 GtkTextDirection direction,
465 const gchar *detail);
466 #ifndef GTK_DISABLE_DEPRECATED
467 void gtk_draw_hline (GtkStyle *style,
469 GtkStateType state_type,
473 void gtk_draw_vline (GtkStyle *style,
475 GtkStateType state_type,
479 void gtk_draw_shadow (GtkStyle *style,
481 GtkStateType state_type,
482 GtkShadowType shadow_type,
487 void gtk_draw_polygon (GtkStyle *style,
489 GtkStateType state_type,
490 GtkShadowType shadow_type,
494 void gtk_draw_arrow (GtkStyle *style,
496 GtkStateType state_type,
497 GtkShadowType shadow_type,
498 GtkArrowType arrow_type,
504 void gtk_draw_diamond (GtkStyle *style,
506 GtkStateType state_type,
507 GtkShadowType shadow_type,
512 void gtk_draw_box (GtkStyle *style,
514 GtkStateType state_type,
515 GtkShadowType shadow_type,
520 void gtk_draw_flat_box (GtkStyle *style,
522 GtkStateType state_type,
523 GtkShadowType shadow_type,
528 void gtk_draw_check (GtkStyle *style,
530 GtkStateType state_type,
531 GtkShadowType shadow_type,
536 void gtk_draw_option (GtkStyle *style,
538 GtkStateType state_type,
539 GtkShadowType shadow_type,
544 void gtk_draw_tab (GtkStyle *style,
546 GtkStateType state_type,
547 GtkShadowType shadow_type,
552 void gtk_draw_shadow_gap (GtkStyle *style,
554 GtkStateType state_type,
555 GtkShadowType shadow_type,
560 GtkPositionType gap_side,
563 void gtk_draw_box_gap (GtkStyle *style,
565 GtkStateType state_type,
566 GtkShadowType shadow_type,
571 GtkPositionType gap_side,
574 void gtk_draw_extension (GtkStyle *style,
576 GtkStateType state_type,
577 GtkShadowType shadow_type,
582 GtkPositionType gap_side);
583 void gtk_draw_focus (GtkStyle *style,
589 void gtk_draw_slider (GtkStyle *style,
591 GtkStateType state_type,
592 GtkShadowType shadow_type,
597 GtkOrientation orientation);
598 void gtk_draw_handle (GtkStyle *style,
600 GtkStateType state_type,
601 GtkShadowType shadow_type,
606 GtkOrientation orientation);
607 void gtk_draw_expander (GtkStyle *style,
609 GtkStateType state_type,
612 GtkExpanderStyle expander_style);
613 void gtk_draw_layout (GtkStyle *style,
615 GtkStateType state_type,
619 PangoLayout *layout);
620 void gtk_draw_resize_grip (GtkStyle *style,
622 GtkStateType state_type,
628 #endif /* GTK_DISABLE_DEPRECATED */
630 void gtk_paint_hline (GtkStyle *style,
632 GtkStateType state_type,
639 void gtk_paint_vline (GtkStyle *style,
641 GtkStateType state_type,
648 void gtk_paint_shadow (GtkStyle *style,
650 GtkStateType state_type,
651 GtkShadowType shadow_type,
659 void gtk_paint_polygon (GtkStyle *style,
661 GtkStateType state_type,
662 GtkShadowType shadow_type,
669 void gtk_paint_arrow (GtkStyle *style,
671 GtkStateType state_type,
672 GtkShadowType shadow_type,
676 GtkArrowType arrow_type,
682 void gtk_paint_diamond (GtkStyle *style,
684 GtkStateType state_type,
685 GtkShadowType shadow_type,
693 void gtk_paint_box (GtkStyle *style,
695 GtkStateType state_type,
696 GtkShadowType shadow_type,
704 void gtk_paint_flat_box (GtkStyle *style,
706 GtkStateType state_type,
707 GtkShadowType shadow_type,
715 void gtk_paint_check (GtkStyle *style,
717 GtkStateType state_type,
718 GtkShadowType shadow_type,
726 void gtk_paint_option (GtkStyle *style,
728 GtkStateType state_type,
729 GtkShadowType shadow_type,
737 void gtk_paint_tab (GtkStyle *style,
739 GtkStateType state_type,
740 GtkShadowType shadow_type,
748 void gtk_paint_shadow_gap (GtkStyle *style,
750 GtkStateType state_type,
751 GtkShadowType shadow_type,
759 GtkPositionType gap_side,
762 void gtk_paint_box_gap (GtkStyle *style,
764 GtkStateType state_type,
765 GtkShadowType shadow_type,
773 GtkPositionType gap_side,
776 void gtk_paint_extension (GtkStyle *style,
778 GtkStateType state_type,
779 GtkShadowType shadow_type,
787 GtkPositionType gap_side);
788 void gtk_paint_focus (GtkStyle *style,
790 GtkStateType state_type,
798 void gtk_paint_slider (GtkStyle *style,
800 GtkStateType state_type,
801 GtkShadowType shadow_type,
809 GtkOrientation orientation);
810 void gtk_paint_handle (GtkStyle *style,
812 GtkStateType state_type,
813 GtkShadowType shadow_type,
821 GtkOrientation orientation);
822 void gtk_paint_expander (GtkStyle *style,
824 GtkStateType state_type,
830 GtkExpanderStyle expander_style);
831 void gtk_paint_layout (GtkStyle *style,
833 GtkStateType state_type,
840 PangoLayout *layout);
842 void gtk_paint_resize_grip (GtkStyle *style,
844 GtkStateType state_type,
855 GType gtk_border_get_type (void);
856 GtkBorder *gtk_border_copy (const GtkBorder *border_);
857 void gtk_border_free ( GtkBorder *border_);
859 /* --- private API --- */
860 const GValue* _gtk_style_peek_property_value (GtkStyle *style,
863 GtkRcPropertyParser parser);
865 void _gtk_style_init_for_settings (GtkStyle *style,
866 GtkSettings *settings);
869 #ifndef GTK_DISABLE_DEPRECATED
870 #define gtk_style_apply_default_pixmap(s,gw,st,a,x,y,w,h) gtk_style_apply_default_background (s,gw,1,st,a,x,y,w,h)
871 void gtk_draw_string (GtkStyle *style,
873 GtkStateType state_type,
876 const gchar *string);
877 void gtk_paint_string (GtkStyle *style,
879 GtkStateType state_type,
885 const gchar *string);
886 #endif /* GTK_DISABLE_DEPRECATED */
888 GdkGC *_gtk_get_insertion_cursor_gc (GtkWidget *widget,
889 gboolean is_primary);
890 void _gtk_draw_insertion_cursor (GtkWidget *widget,
891 GdkDrawable *drawable,
893 GdkRectangle *location,
894 GtkTextDirection direction,
895 gboolean draw_arrow);
899 #endif /* __cplusplus */
902 #endif /* __GTK_STYLE_H__ */