1 /* gtkcellareacontext.h
3 * Copyright (C) 2010 Openismus GmbH
6 * Tristan Van Berkom <tristanvb@openismus.com>
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Library General Public
10 * License as published by the Free Software Foundation; either
11 * version 2 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Library General Public License for more details.
18 * You should have received a copy of the GNU Library General Public
19 * License along with this library; if not, write to the
20 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21 * Boston, MA 02111-1307, USA.
24 #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
25 #error "Only <gtk/gtk.h> can be included directly."
28 #ifndef __GTK_CELL_AREA_CONTEXT_H__
29 #define __GTK_CELL_AREA_CONTEXT_H__
31 #include <gtk/gtkcellarea.h>
35 #define GTK_TYPE_CELL_AREA_CONTEXT (gtk_cell_area_context_get_type ())
36 #define GTK_CELL_AREA_CONTEXT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_CELL_AREA_CONTEXT, GtkCellAreaContext))
37 #define GTK_CELL_AREA_CONTEXT_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_CELL_AREA_CONTEXT, GtkCellAreaContextClass))
38 #define GTK_IS_CELL_AREA_CONTEXT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_CELL_AREA_CONTEXT))
39 #define GTK_IS_CELL_AREA_CONTEXT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_CELL_AREA_CONTEXT))
40 #define GTK_CELL_AREA_CONTEXT_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_CELL_AREA_CONTEXT, GtkCellAreaContextClass))
42 typedef struct _GtkCellAreaContextPrivate GtkCellAreaContextPrivate;
43 typedef struct _GtkCellAreaContextClass GtkCellAreaContextClass;
45 struct _GtkCellAreaContext
47 GObject parent_instance;
49 GtkCellAreaContextPrivate *priv;
52 struct _GtkCellAreaContextClass
54 GObjectClass parent_class;
56 /* Subclasses can use this to flush their alignments/allocations */
57 void (* flush_preferred_width) (GtkCellAreaContext *context);
58 void (* flush_preferred_height_for_width) (GtkCellAreaContext *context,
60 void (* flush_preferred_height) (GtkCellAreaContext *context);
61 void (* flush_preferred_width_for_height) (GtkCellAreaContext *context,
63 void (* flush_allocation) (GtkCellAreaContext *context);
65 /* These must be invoked after a series of requests before consulting
66 * the context values, implementors use this to push the overall
67 * requests while acconting for any internal alignments */
68 void (* sum_preferred_width) (GtkCellAreaContext *context);
69 void (* sum_preferred_height_for_width) (GtkCellAreaContext *context,
71 void (* sum_preferred_height) (GtkCellAreaContext *context);
72 void (* sum_preferred_width_for_height) (GtkCellAreaContext *context,
75 /* Store an allocation value for a GtkCellArea contextual to a range of
77 void (* allocate_width) (GtkCellAreaContext *context,
79 void (* allocate_height) (GtkCellAreaContext *context,
82 /* Padding for future expansion */
83 void (*_gtk_reserved1) (void);
84 void (*_gtk_reserved2) (void);
85 void (*_gtk_reserved3) (void);
86 void (*_gtk_reserved4) (void);
89 GType gtk_cell_area_context_get_type (void) G_GNUC_CONST;
91 GtkCellArea *gtk_cell_area_context_get_area (GtkCellAreaContext *context);
93 /* Apis for GtkCellArea clients to flush the cache */
94 void gtk_cell_area_context_flush (GtkCellAreaContext *context);
95 void gtk_cell_area_context_flush_preferred_width (GtkCellAreaContext *context);
96 void gtk_cell_area_context_flush_preferred_height_for_width (GtkCellAreaContext *context,
98 void gtk_cell_area_context_flush_preferred_height (GtkCellAreaContext *context);
99 void gtk_cell_area_context_flush_preferred_width_for_height (GtkCellAreaContext *context,
101 void gtk_cell_area_context_flush_allocation (GtkCellAreaContext *context);
103 /* Apis for GtkCellArea clients to sum up the results of a series of requests, this
104 * call is required to reduce the processing while calculating the size of each row */
105 void gtk_cell_area_context_sum_preferred_width (GtkCellAreaContext *context);
106 void gtk_cell_area_context_sum_preferred_height_for_width (GtkCellAreaContext *context,
108 void gtk_cell_area_context_sum_preferred_height (GtkCellAreaContext *context);
109 void gtk_cell_area_context_sum_preferred_width_for_height (GtkCellAreaContext *context,
112 /* Apis to set an allocation size in one dimension or another, the subclass specific context
113 * will store allocated positions/sizes for individual cells or groups of cells */
114 void gtk_cell_area_context_allocate_width (GtkCellAreaContext *context,
116 void gtk_cell_area_context_allocate_height (GtkCellAreaContext *context,
119 /* Apis for GtkCellArea clients to consult cached values for multiple GtkTreeModel rows */
120 void gtk_cell_area_context_get_preferred_width (GtkCellAreaContext *context,
122 gint *natural_width);
123 void gtk_cell_area_context_get_preferred_height_for_width (GtkCellAreaContext *context,
125 gint *minimum_height,
126 gint *natural_height);
127 void gtk_cell_area_context_get_preferred_height (GtkCellAreaContext *context,
128 gint *minimum_height,
129 gint *natural_height);
130 void gtk_cell_area_context_get_preferred_width_for_height (GtkCellAreaContext *context,
133 gint *natural_width);
134 void gtk_cell_area_context_get_allocation (GtkCellAreaContext *context,
138 /* Apis for GtkCellArea implementations to update cached values for multiple GtkTreeModel rows */
139 void gtk_cell_area_context_push_preferred_width (GtkCellAreaContext *context,
142 void gtk_cell_area_context_push_preferred_height_for_width (GtkCellAreaContext *context,
145 gint natural_height);
146 void gtk_cell_area_context_push_preferred_height (GtkCellAreaContext *context,
148 gint natural_height);
149 void gtk_cell_area_context_push_preferred_width_for_height (GtkCellAreaContext *context,
156 #endif /* __GTK_CELL_AREA_CONTEXT_H__ */