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_ITER_H__
29 #define __GTK_CELL_AREA_ITER_H__
31 #include <gtk/gtkcellarea.h>
35 #define GTK_TYPE_CELL_AREA_ITER (gtk_cell_area_iter_get_type ())
36 #define GTK_CELL_AREA_ITER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_CELL_AREA_ITER, GtkCellAreaIter))
37 #define GTK_CELL_AREA_ITER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_CELL_AREA_ITER, GtkCellAreaIterClass))
38 #define GTK_IS_CELL_AREA_ITER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_CELL_AREA_ITER))
39 #define GTK_IS_CELL_AREA_ITER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_CELL_AREA_ITER))
40 #define GTK_CELL_AREA_ITER_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_CELL_AREA_ITER, GtkCellAreaIterClass))
42 typedef struct _GtkCellAreaIterPrivate GtkCellAreaIterPrivate;
43 typedef struct _GtkCellAreaIterClass GtkCellAreaIterClass;
45 struct _GtkCellAreaIter
47 GObject parent_instance;
49 GtkCellAreaIterPrivate *priv;
52 struct _GtkCellAreaIterClass
54 GObjectClass parent_class;
56 /* Subclasses can use this to flush their alignments/allocations */
57 void (* flush_preferred_width) (GtkCellAreaIter *iter);
58 void (* flush_preferred_height_for_width) (GtkCellAreaIter *iter,
60 void (* flush_preferred_height) (GtkCellAreaIter *iter);
61 void (* flush_preferred_width_for_height) (GtkCellAreaIter *iter,
63 void (* flush_allocation) (GtkCellAreaIter *iter);
65 /* These must be invoked after a series of requests before consulting
66 * the iter values, implementors use this to push the overall
67 * requests while acconting for any internal alignments */
68 void (* sum_preferred_width) (GtkCellAreaIter *iter);
69 void (* sum_preferred_height_for_width) (GtkCellAreaIter *iter,
71 void (* sum_preferred_height) (GtkCellAreaIter *iter);
72 void (* sum_preferred_width_for_height) (GtkCellAreaIter *iter,
75 /* Store an allocation value for a GtkCellArea contextual to a range of
77 void (* allocate_width) (GtkCellAreaIter *iter,
79 void (* allocate_height) (GtkCellAreaIter *iter,
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_iter_get_type (void) G_GNUC_CONST;
91 GtkCellArea *gtk_cell_area_iter_get_area (GtkCellAreaIter *iter);
93 /* Apis for GtkCellArea clients to flush the cache */
94 void gtk_cell_area_iter_flush (GtkCellAreaIter *iter);
95 void gtk_cell_area_iter_flush_preferred_width (GtkCellAreaIter *iter);
96 void gtk_cell_area_iter_flush_preferred_height_for_width (GtkCellAreaIter *iter,
98 void gtk_cell_area_iter_flush_preferred_height (GtkCellAreaIter *iter);
99 void gtk_cell_area_iter_flush_preferred_width_for_height (GtkCellAreaIter *iter,
101 void gtk_cell_area_iter_flush_allocation (GtkCellAreaIter *iter);
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_iter_sum_preferred_width (GtkCellAreaIter *iter);
106 void gtk_cell_area_iter_sum_preferred_height_for_width (GtkCellAreaIter *iter,
108 void gtk_cell_area_iter_sum_preferred_height (GtkCellAreaIter *iter);
109 void gtk_cell_area_iter_sum_preferred_width_for_height (GtkCellAreaIter *iter,
112 /* Apis to set an allocation size in one dimension or another, the subclass specific iter
113 * will store allocated positions/sizes for individual cells or groups of cells */
114 void gtk_cell_area_iter_allocate_width (GtkCellAreaIter *iter,
116 void gtk_cell_area_iter_allocate_height (GtkCellAreaIter *iter,
119 /* Apis for GtkCellArea clients to consult cached values for multiple GtkTreeModel rows */
120 void gtk_cell_area_iter_get_preferred_width (GtkCellAreaIter *iter,
122 gint *natural_width);
123 void gtk_cell_area_iter_get_preferred_height_for_width (GtkCellAreaIter *iter,
125 gint *minimum_height,
126 gint *natural_height);
127 void gtk_cell_area_iter_get_preferred_height (GtkCellAreaIter *iter,
128 gint *minimum_height,
129 gint *natural_height);
130 void gtk_cell_area_iter_get_preferred_width_for_height (GtkCellAreaIter *iter,
133 gint *natural_width);
134 void gtk_cell_area_iter_get_allocation (GtkCellAreaIter *iter,
138 /* Apis for GtkCellArea implementations to update cached values for multiple GtkTreeModel rows */
139 void gtk_cell_area_iter_push_preferred_width (GtkCellAreaIter *iter,
142 void gtk_cell_area_iter_push_preferred_height_for_width (GtkCellAreaIter *iter,
145 gint natural_height);
146 void gtk_cell_area_iter_push_preferred_height (GtkCellAreaIter *iter,
148 gint natural_height);
149 void gtk_cell_area_iter_push_preferred_width_for_height (GtkCellAreaIter *iter,
156 #endif /* __GTK_CELL_AREA_ITER_H__ */