gtkthemingengine.h 12.1 KB
Newer Older
Carlos Garnacho's avatar
Carlos Garnacho committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14
/* GTK - The GIMP Toolkit
 * Copyright (C) 2010 Carlos Garnacho <carlosg@gnome.org>
 *
 * 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
Javier Jardón's avatar
Javier Jardón committed
15
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
Carlos Garnacho's avatar
Carlos Garnacho committed
16 17
 */

18 19 20 21
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif

Carlos Garnacho's avatar
Carlos Garnacho committed
22 23 24 25 26 27
#ifndef __GTK_THEMING_ENGINE_H__
#define __GTK_THEMING_ENGINE_H__

#include <glib-object.h>
#include <cairo.h>

28
#include <gtk/gtkborder.h>
Carlos Garnacho's avatar
Carlos Garnacho committed
29
#include <gtk/gtkenums.h>
30 31
#include <gtk/gtkstyleproperties.h>
#include <gtk/gtktypes.h>
Carlos Garnacho's avatar
Carlos Garnacho committed
32 33 34 35 36 37 38 39 40 41

G_BEGIN_DECLS

#define GTK_TYPE_THEMING_ENGINE         (gtk_theming_engine_get_type ())
#define GTK_THEMING_ENGINE(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), GTK_TYPE_THEMING_ENGINE, GtkThemingEngine))
#define GTK_THEMING_ENGINE_CLASS(c)     (G_TYPE_CHECK_CLASS_CAST    ((c), GTK_TYPE_THEMING_ENGINE, GtkThemingEngineClass))
#define GTK_IS_THEMING_ENGINE(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), GTK_TYPE_THEMING_ENGINE))
#define GTK_IS_THEMING_ENGINE_CLASS(c)  (G_TYPE_CHECK_CLASS_TYPE    ((c), GTK_TYPE_THEMING_ENGINE))
#define GTK_THEMING_ENGINE_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS  ((o), GTK_TYPE_THEMING_ENGINE, GtkThemingEngineClass))

Carlos Garnacho's avatar
Carlos Garnacho committed
42
typedef struct _GtkThemingEngine GtkThemingEngine;
43
typedef struct GtkThemingEnginePrivate GtkThemingEnginePrivate;
Carlos Garnacho's avatar
Carlos Garnacho committed
44
typedef struct _GtkThemingEngineClass GtkThemingEngineClass;
Carlos Garnacho's avatar
Carlos Garnacho committed
45

Carlos Garnacho's avatar
Carlos Garnacho committed
46
struct _GtkThemingEngine
Carlos Garnacho's avatar
Carlos Garnacho committed
47 48
{
  GObject parent_object;
49
  GtkThemingEnginePrivate *priv;
Carlos Garnacho's avatar
Carlos Garnacho committed
50 51
};

Carlos Garnacho's avatar
Carlos Garnacho committed
52
/**
53
 * GtkThemingEngineClass:
Carlos Garnacho's avatar
Carlos Garnacho committed
54 55 56 57 58 59 60 61 62 63 64 65 66 67 68
 * @parent_class: The parent class.
 * @render_line: Renders a line between two points.
 * @render_background: Renders the background area of a widget region.
 * @render_frame: Renders the frame around a widget area.
 * @render_frame_gap: Renders the frame around a widget area with a gap in it.
 * @render_extension: Renders a extension to a box, usually a notebook tab.
 * @render_check: Renders a checkmark, as in #GtkCheckButton.
 * @render_option: Renders an option, as in #GtkRadioButton.
 * @render_arrow: Renders an arrow pointing to a certain direction.
 * @render_expander: Renders an element what will expose/expand part of
 *                   the UI, as in #GtkExpander.
 * @render_focus: Renders the focus indicator.
 * @render_layout: Renders a #PangoLayout
 * @render_slider: Renders a slider control, as in #GtkScale.
 * @render_handle: Renders a handle to drag UI elements, as in #GtkPaned.
69 70 71
 * @render_activity: Renders an area displaying activity, such as in #GtkSpinner,
 *                   or #GtkProgressBar.
 * @render_icon_pixbuf: Renders an icon as a #GdkPixbuf.
72
 * @render_icon: Renders an icon given as a #GdkPixbuf.
Carlos Garnacho's avatar
Carlos Garnacho committed
73 74 75 76
 *
 * Base class for theming engines.
 */
struct _GtkThemingEngineClass
Carlos Garnacho's avatar
Carlos Garnacho committed
77 78
{
  GObjectClass parent_class;
79

80 81 82 83 84 85
  void (* render_line) (GtkThemingEngine *engine,
                        cairo_t          *cr,
                        gdouble           x0,
                        gdouble           y0,
                        gdouble           x1,
                        gdouble           y1);
86 87 88 89 90 91
  void (* render_background) (GtkThemingEngine *engine,
                              cairo_t          *cr,
                              gdouble           x,
                              gdouble           y,
                              gdouble           width,
                              gdouble           height);
92 93 94 95 96 97
  void (* render_frame) (GtkThemingEngine *engine,
                         cairo_t          *cr,
                         gdouble           x,
                         gdouble           y,
                         gdouble           width,
                         gdouble           height);
98 99 100 101 102 103 104 105 106
  void (* render_frame_gap) (GtkThemingEngine *engine,
                             cairo_t          *cr,
                             gdouble           x,
                             gdouble           y,
                             gdouble           width,
                             gdouble           height,
                             GtkPositionType   gap_side,
                             gdouble           xy0_gap,
                             gdouble           xy1_gap);
107 108 109 110 111 112 113
  void (* render_extension) (GtkThemingEngine *engine,
                             cairo_t          *cr,
                             gdouble           x,
                             gdouble           y,
                             gdouble           width,
                             gdouble           height,
                             GtkPositionType   gap_side);
114 115 116 117 118 119
  void (* render_check) (GtkThemingEngine *engine,
                         cairo_t          *cr,
                         gdouble           x,
                         gdouble           y,
                         gdouble           width,
                         gdouble           height);
120 121 122 123 124 125
  void (* render_option) (GtkThemingEngine *engine,
                          cairo_t          *cr,
                          gdouble           x,
                          gdouble           y,
                          gdouble           width,
                          gdouble           height);
126 127 128 129 130 131
  void (* render_arrow) (GtkThemingEngine *engine,
                         cairo_t          *cr,
                         gdouble           angle,
                         gdouble           x,
                         gdouble           y,
                         gdouble           size);
132 133 134 135 136 137
  void (* render_expander) (GtkThemingEngine *engine,
                            cairo_t          *cr,
                            gdouble           x,
                            gdouble           y,
                            gdouble           width,
                            gdouble           height);
138 139 140 141 142 143
  void (* render_focus) (GtkThemingEngine *engine,
                         cairo_t          *cr,
                         gdouble           x,
                         gdouble           y,
                         gdouble           width,
                         gdouble           height);
144 145 146 147 148
  void (* render_layout) (GtkThemingEngine *engine,
                          cairo_t          *cr,
                          gdouble           x,
                          gdouble           y,
                          PangoLayout      *layout);
149 150 151 152 153 154 155
  void (* render_slider) (GtkThemingEngine *engine,
                          cairo_t          *cr,
                          gdouble           x,
                          gdouble           y,
                          gdouble           width,
                          gdouble           height,
                          GtkOrientation    orientation);
156 157 158 159 160
  void (* render_handle)    (GtkThemingEngine *engine,
                             cairo_t          *cr,
                             gdouble           x,
                             gdouble           y,
                             gdouble           width,
161
                             gdouble           height);
162 163 164 165 166 167
  void (* render_activity) (GtkThemingEngine *engine,
                            cairo_t          *cr,
                            gdouble           x,
                            gdouble           y,
                            gdouble           width,
                            gdouble           height);
168 169 170 171

  GdkPixbuf * (* render_icon_pixbuf) (GtkThemingEngine    *engine,
                                      const GtkIconSource *source,
                                      GtkIconSize          size);
172 173 174 175 176
  void (* render_icon) (GtkThemingEngine *engine,
                        cairo_t          *cr,
			GdkPixbuf        *pixbuf,
                        gdouble           x,
                        gdouble           y);
177 178

  /*< private >*/
179
  gpointer padding[15];
Carlos Garnacho's avatar
Carlos Garnacho committed
180 181 182 183
};

GType gtk_theming_engine_get_type (void) G_GNUC_CONST;

184
/* function implemented in gtkcsscustomproperty.c */
185
void gtk_theming_engine_register_property (const gchar            *name_space,
186 187
                                           GtkStylePropertyParser  parse_func,
                                           GParamSpec             *pspec);
188

Carlos Garnacho's avatar
Carlos Garnacho committed
189 190
void gtk_theming_engine_get_property (GtkThemingEngine *engine,
                                      const gchar      *property,
191
                                      GtkStateFlags     state,
Carlos Garnacho's avatar
Carlos Garnacho committed
192 193
                                      GValue           *value);
void gtk_theming_engine_get_valist   (GtkThemingEngine *engine,
194
                                      GtkStateFlags     state,
Carlos Garnacho's avatar
Carlos Garnacho committed
195 196
                                      va_list           args);
void gtk_theming_engine_get          (GtkThemingEngine *engine,
197
                                      GtkStateFlags     state,
Carlos Garnacho's avatar
Carlos Garnacho committed
198 199
                                      ...) G_GNUC_NULL_TERMINATED;

200 201 202 203 204 205 206 207
void gtk_theming_engine_get_style_property (GtkThemingEngine *engine,
                                            const gchar      *property_name,
                                            GValue           *value);
void gtk_theming_engine_get_style_valist   (GtkThemingEngine *engine,
                                            va_list           args);
void gtk_theming_engine_get_style          (GtkThemingEngine *engine,
                                            ...);

208 209 210
gboolean gtk_theming_engine_lookup_color (GtkThemingEngine *engine,
                                          const gchar      *color_name,
                                          GdkRGBA          *color);
211

212
const GtkWidgetPath * gtk_theming_engine_get_path (GtkThemingEngine *engine);
Carlos Garnacho's avatar
Carlos Garnacho committed
213

214 215 216
gboolean gtk_theming_engine_has_class  (GtkThemingEngine *engine,
                                        const gchar      *style_class);
gboolean gtk_theming_engine_has_region (GtkThemingEngine *engine,
217
                                        const gchar      *style_region,
218
                                        GtkRegionFlags   *flags);
219

220 221 222 223
GtkStateFlags gtk_theming_engine_get_state        (GtkThemingEngine *engine);
gboolean      gtk_theming_engine_state_is_running (GtkThemingEngine *engine,
                                                   GtkStateType      state,
                                                   gdouble          *progress);
Carlos Garnacho's avatar
Carlos Garnacho committed
224

225 226
GtkTextDirection gtk_theming_engine_get_direction (GtkThemingEngine *engine);

227 228
GtkJunctionSides gtk_theming_engine_get_junction_sides (GtkThemingEngine *engine);

229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249
/* Helper functions */
void gtk_theming_engine_get_color            (GtkThemingEngine *engine,
                                              GtkStateFlags     state,
                                              GdkRGBA          *color);
void gtk_theming_engine_get_background_color (GtkThemingEngine *engine,
                                              GtkStateFlags     state,
                                              GdkRGBA          *color);
void gtk_theming_engine_get_border_color     (GtkThemingEngine *engine,
                                              GtkStateFlags     state,
                                              GdkRGBA          *color);

void gtk_theming_engine_get_border  (GtkThemingEngine *engine,
                                     GtkStateFlags     state,
                                     GtkBorder        *border);
void gtk_theming_engine_get_padding (GtkThemingEngine *engine,
                                     GtkStateFlags     state,
                                     GtkBorder        *padding);
void gtk_theming_engine_get_margin  (GtkThemingEngine *engine,
                                     GtkStateFlags     state,
                                     GtkBorder        *margin);

250 251
const PangoFontDescription * gtk_theming_engine_get_font (GtkThemingEngine *engine,
                                                          GtkStateFlags     state);
252

253
GtkThemingEngine * gtk_theming_engine_load (const gchar *name);
254

255 256
GdkScreen * gtk_theming_engine_get_screen (GtkThemingEngine *engine);

Carlos Garnacho's avatar
Carlos Garnacho committed
257 258 259
G_END_DECLS

#endif /* __GTK_THEMING_ENGINE_H__ */