gtkcssnodeprivate.h 10.5 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
/* GTK - The GIMP Toolkit
 * Copyright (C) 2014 Benjamin Otte <otte@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
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef __GTK_CSS_NODE_PRIVATE_H__
#define __GTK_CSS_NODE_PRIVATE_H__

#include "gtkcssnodedeclarationprivate.h"
22 23
#include "gtkbitmaskprivate.h"
#include "gtkcsstypesprivate.h"
24 25 26

G_BEGIN_DECLS

27 28 29 30 31 32 33 34 35 36 37 38 39
#define GTK_TYPE_CSS_NODE           (gtk_css_node_get_type ())
#define GTK_CSS_NODE(obj)           (G_TYPE_CHECK_INSTANCE_CAST (obj, GTK_TYPE_CSS_NODE, GtkCssNode))
#define GTK_CSS_NODE_CLASS(cls)     (G_TYPE_CHECK_CLASS_CAST (cls, GTK_TYPE_CSS_NODE, GtkCssNodeClass))
#define GTK_IS_CSS_NODE(obj)        (G_TYPE_CHECK_INSTANCE_TYPE (obj, GTK_TYPE_CSS_NODE))
#define GTK_IS_CSS_NODE_CLASS(obj)  (G_TYPE_CHECK_CLASS_TYPE (obj, GTK_TYPE_CSS_NODE))
#define GTK_CSS_NODE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_CSS_NODE, GtkCssNodeClass))

typedef struct _GtkCssNodeClass      GtkCssNodeClass;

struct _GtkCssNode
{
  GObject object;

40 41 42 43 44 45
  GtkCssNode *parent;
  GtkCssNode *previous_sibling;
  GtkCssNode *next_sibling;
  GtkCssNode *first_child;
  GtkCssNode *last_child;

46 47
  GtkCssNodeDeclaration *decl;
  GtkCssStyle           *style;
48

49 50
  GtkCssChange           pending_changes;       /* changes that accumulated since the style was last computed */

51
  guint                  visible :1;            /* node will be skipped when validating or computing styles */
52
  guint                  invalid :1;            /* node or a child needs to be validated (even if just for animation) */
53
  guint                  needs_propagation :1;  /* children have state changes that need to be propagated to their siblings */
54 55 56 57 58 59
  /* Two invariants hold for this variable:
   * style_is_invalid == TRUE  =>  next_sibling->style_is_invalid == TRUE
   * style_is_invalid == FALSE =>  first_child->style_is_invalid == TRUE
   * So if a valid style is computed, one has to previously ensure that the parent's and the previous sibling's style
   * are valid. This allows both validation and invalidation to run in O(nodes-in-tree) */
  guint                  style_is_invalid :1;   /* the style needs to be recomputed */
60 61 62 63 64
};

struct _GtkCssNodeClass
{
  GObjectClass object_class;
65

66 67 68 69 70 71
  void                  (* node_added)                  (GtkCssNode            *cssnode,
                                                         GtkCssNode            *child,
                                                         GtkCssNode            *previous);
  void                  (* node_removed)                (GtkCssNode            *cssnode,
                                                         GtkCssNode            *child,
                                                         GtkCssNode            *previous);
72 73 74
  void                  (* style_changed)               (GtkCssNode            *cssnode,
                                                         GtkCssStyle           *old_style,
                                                         GtkCssStyle           *new_style);
75

76
  gboolean              (* init_matcher)                (GtkCssNode            *cssnode,
77
                                                         GtkCssMatcher         *matcher);
78 79
  GtkWidgetPath *       (* create_widget_path)          (GtkCssNode            *cssnode);
  const GtkWidgetPath * (* get_widget_path)             (GtkCssNode            *cssnode);
80
  /* get style provider to use or NULL to use parent's */
81
  GtkStyleProviderPrivate *(* get_style_provider)       (GtkCssNode            *cssnode);
82 83
  /* get frame clock or NULL (only relevant for root node) */
  GdkFrameClock *       (* get_frame_clock)             (GtkCssNode            *cssnode);
84 85
  GtkCssStyle *         (* update_style)                (GtkCssNode            *cssnode,
                                                         GtkCssChange           pending_changes,
86
                                                         gint64                 timestamp,
87 88
                                                         GtkCssStyle           *old_style);
  void                  (* invalidate)                  (GtkCssNode            *node);
89 90
  void                  (* queue_validate)              (GtkCssNode            *node);
  void                  (* dequeue_validate)            (GtkCssNode            *node);
91
  void                  (* validate)                    (GtkCssNode            *node);
92 93 94
};

GType                   gtk_css_node_get_type           (void) G_GNUC_CONST;
95

96 97
void                    gtk_css_node_set_parent         (GtkCssNode            *cssnode,
                                                         GtkCssNode            *parent);
98 99
void                    gtk_css_node_insert_after       (GtkCssNode            *parent,
                                                         GtkCssNode            *cssnode,
100
                                                         GtkCssNode            *previous_sibling);
101 102
void                    gtk_css_node_insert_before      (GtkCssNode            *parent,
                                                         GtkCssNode            *cssnode,
103
                                                         GtkCssNode            *next_sibling);
104
GtkCssNode *            gtk_css_node_get_parent         (GtkCssNode            *cssnode);
105 106 107 108
GtkCssNode *            gtk_css_node_get_first_child    (GtkCssNode            *cssnode);
GtkCssNode *            gtk_css_node_get_last_child     (GtkCssNode            *cssnode);
GtkCssNode *            gtk_css_node_get_previous_sibling(GtkCssNode           *cssnode);
GtkCssNode *            gtk_css_node_get_next_sibling   (GtkCssNode            *cssnode);
109

110 111 112 113
void                    gtk_css_node_set_visible        (GtkCssNode            *cssnode,
                                                         gboolean               visible);
gboolean                gtk_css_node_get_visible        (GtkCssNode            *cssnode);

114 115 116
void                    gtk_css_node_set_widget_type    (GtkCssNode            *cssnode,
                                                         GType                  widget_type);
GType                   gtk_css_node_get_widget_type    (GtkCssNode            *cssnode);
117
void                    gtk_css_node_set_id             (GtkCssNode            *cssnode,
118 119
                                                         const char            *id);
const char *            gtk_css_node_get_id             (GtkCssNode            *cssnode);
120
void                    gtk_css_node_set_state          (GtkCssNode            *cssnode,
121 122 123 124 125
                                                         GtkStateFlags          state_flags);
GtkStateFlags           gtk_css_node_get_state          (GtkCssNode            *cssnode);
void                    gtk_css_node_set_junction_sides (GtkCssNode            *cssnode,
                                                         GtkJunctionSides       junction_sides);
GtkJunctionSides        gtk_css_node_get_junction_sides (GtkCssNode            *cssnode);
Benjamin Otte's avatar
Benjamin Otte committed
126 127 128
void                    gtk_css_node_set_classes        (GtkCssNode            *cssnode,
                                                         const char           **classes);
char **                 gtk_css_node_get_classes        (GtkCssNode            *cssnode);
129
void                    gtk_css_node_add_class          (GtkCssNode            *cssnode,
130
                                                         GQuark                 style_class);
131
void                    gtk_css_node_remove_class       (GtkCssNode            *cssnode,
132 133 134 135
                                                         GQuark                 style_class);
gboolean                gtk_css_node_has_class          (GtkCssNode            *cssnode,
                                                         GQuark                 style_class);
GList *                 gtk_css_node_list_classes       (GtkCssNode            *cssnode);
136
void                    gtk_css_node_add_region         (GtkCssNode            *cssnode,
137 138
                                                         GQuark                 region,
                                                         GtkRegionFlags         flags);
139
void                    gtk_css_node_remove_region      (GtkCssNode            *cssnode,
140 141 142 143 144 145 146 147
                                                         GQuark                 region);
gboolean                gtk_css_node_has_region         (GtkCssNode            *cssnode,
                                                         GQuark                 region,
                                                         GtkRegionFlags        *out_flags);
GList *                 gtk_css_node_list_regions       (GtkCssNode            *cssnode);

const GtkCssNodeDeclaration *
                        gtk_css_node_get_declaration    (GtkCssNode            *cssnode);
148
GtkCssStyle *           gtk_css_node_get_style          (GtkCssNode            *cssnode);
149

150

151 152
void                    gtk_css_node_invalidate_style_provider
                                                        (GtkCssNode            *cssnode);
153 154 155
void                    gtk_css_node_invalidate_frame_clock
                                                        (GtkCssNode            *cssnode,
                                                         gboolean               just_timestamp);
156 157
void                    gtk_css_node_invalidate         (GtkCssNode            *cssnode,
                                                         GtkCssChange           change);
158
void                    gtk_css_node_validate           (GtkCssNode            *cssnode);
159 160

gboolean                gtk_css_node_init_matcher       (GtkCssNode            *cssnode,
161
                                                         GtkCssMatcher         *matcher);
162 163
GtkWidgetPath *         gtk_css_node_create_widget_path (GtkCssNode            *cssnode);
const GtkWidgetPath *   gtk_css_node_get_widget_path    (GtkCssNode            *cssnode);
164
GtkStyleProviderPrivate *gtk_css_node_get_style_provider(GtkCssNode            *cssnode);
165

166 167 168
G_END_DECLS

#endif /* __GTK_CSS_NODE_PRIVATE_H__ */