ab8c6e40 |
1 | /* gtktreeprivate.h |
2 | * Copyright (C) 2000 Red Hat, Inc., Jonathan Blandford <jrb@redhat.com> |
3 | * |
4 | * This library is free software; you can redistribute it and/or |
5 | * modify it under the terms of the GNU Library 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. |
8 | * |
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 | * Library General Public License for more details. |
13 | * |
14 | * You should have received a copy of the GNU Library 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. |
18 | */ |
19 | |
20 | #ifndef __GTK_TREE_PRIVATE_H__ |
21 | #define __GTK_TREE_PRIVATE_H__ |
22 | |
23 | |
24 | #ifdef __cplusplus |
25 | extern "C" { |
26 | #endif /* __cplusplus */ |
27 | |
28 | #include <gtk/gtktreeview.h> |
29 | #include <gtk/gtktreeselection.h> |
30 | //#include <gtk/gtkrbtree.h> |
31 | #include "gtkrbtree.h" |
32 | |
33 | #define TREE_VIEW_DRAG_WIDTH 6 |
34 | |
35 | typedef enum |
36 | { |
37 | GTK_TREE_VIEW_IS_LIST = 1 << 0, |
38 | GTK_TREE_VIEW_SHOW_EXPANDERS = 1 << 1, |
39 | GTK_TREE_VIEW_IN_COLUMN_RESIZE = 1 << 2, |
40 | GTK_TREE_VIEW_ARROW_PRELIT = 1 << 3, |
41 | GTK_TREE_VIEW_HEADERS_VISIBLE = 1 << 4, |
42 | GTK_TREE_VIEW_DRAW_KEYFOCUS = 1 << 5, |
43 | GTK_TREE_VIEW_MODEL_SETUP = 1 << 6, |
44 | GTK_TREE_VIEW_IN_COLUMN_DRAG = 1 << 7 |
45 | } GtkTreeViewFlags; |
46 | |
47 | enum |
48 | { |
49 | DRAG_COLUMN_WINDOW_STATE_UNSET = 0, |
50 | DRAG_COLUMN_WINDOW_STATE_ORIGINAL = 1, |
51 | DRAG_COLUMN_WINDOW_STATE_ARROW = 2, |
52 | DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT = 3, |
53 | DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT = 4 |
54 | }; |
55 | |
56 | #define GTK_TREE_VIEW_SET_FLAG(tree_view, flag) G_STMT_START{ (tree_view->priv->flags|=flag); }G_STMT_END |
57 | #define GTK_TREE_VIEW_UNSET_FLAG(tree_view, flag) G_STMT_START{ (tree_view->priv->flags&=~(flag)); }G_STMT_END |
58 | #define GTK_TREE_VIEW_FLAG_SET(tree_view, flag) ((tree_view->priv->flags&flag)==flag) |
59 | #define TREE_VIEW_HEADER_HEIGHT(tree_view) (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE)?tree_view->priv->header_height:0) |
60 | #define TREE_VIEW_COLUMN_REQUESTED_WIDTH(column) (CLAMP (column->requested_width, (column->min_width!=-1)?column->min_width:column->requested_width, (column->max_width!=-1)?column->max_width:column->requested_width)) |
61 | #define TREE_VIEW_DRAW_EXPANDERS(tree_view) (!GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST)&>K_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS)) |
62 | |
63 | /* This lovely little value is used to determine how far away from the title bar |
64 | * you can move the mouse and still have a column drag work. |
65 | */ |
66 | #define TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER(tree_view) (10*TREE_VIEW_HEADER_HEIGHT(tree_view)) |
67 | |
68 | typedef void (*GtkTreeViewSearchDialogPositionFunc) (GtkTreeView *tree_view, |
69 | GtkWidget *search_dialog); |
70 | |
71 | typedef struct _GtkTreeViewColumnReorder GtkTreeViewColumnReorder; |
72 | struct _GtkTreeViewColumnReorder |
73 | { |
74 | gint left_align; |
75 | gint right_align; |
76 | GtkTreeViewColumn *left_column; |
77 | GtkTreeViewColumn *right_column; |
78 | }; |
79 | |
80 | struct _GtkTreeViewPrivate |
81 | { |
82 | GtkTreeModel *model; |
83 | |
84 | guint flags; |
85 | /* tree information */ |
86 | GtkRBTree *tree; |
87 | |
88 | GtkRBNode *button_pressed_node; |
89 | GtkRBTree *button_pressed_tree; |
90 | |
91 | GList *children; |
92 | gint width; |
93 | gint height; |
94 | gint expander_size; |
95 | |
96 | GtkAdjustment *hadjustment; |
97 | GtkAdjustment *vadjustment; |
98 | |
99 | GdkWindow *bin_window; |
100 | GdkWindow *header_window; |
101 | GdkWindow *drag_window; |
102 | GdkWindow *drag_highlight_window; |
103 | GtkTreeViewColumn *drag_column; |
104 | |
105 | GtkTreeRowReference *last_button_press; |
106 | GtkTreeRowReference *last_button_press_2; |
107 | |
108 | /* bin_window offset */ |
109 | GtkTreeRowReference *top_row; |
110 | gint top_row_dy; |
111 | /* dy == y pos of top_row + top_row_dy */ |
112 | /* we cache it for simplicity of the code */ |
113 | gint dy; |
114 | gint drag_column_x; |
115 | |
116 | GtkTreeViewColumn *expander_column; |
117 | GtkTreeViewColumn *edited_column; |
118 | guint presize_handler_timer; |
119 | guint validate_rows_timer; |
120 | guint scroll_sync_timer; |
121 | |
122 | /* Focus code */ |
123 | GtkTreeViewColumn *focus_column; |
124 | |
125 | /* Selection stuff */ |
126 | GtkTreeRowReference *anchor; |
127 | GtkTreeRowReference *cursor; |
128 | |
129 | /* Column Resizing */ |
130 | gint drag_pos; |
131 | gint x_drag; |
132 | |
133 | /* Prelight information */ |
134 | GtkRBNode *prelight_node; |
135 | GtkRBTree *prelight_tree; |
136 | |
137 | /* The node that's currently being collapsed or expanded */ |
138 | GtkRBNode *expanded_collapsed_node; |
139 | GtkRBTree *expanded_collapsed_tree; |
140 | guint expand_collapse_timeout; |
141 | |
142 | /* Selection information */ |
143 | GtkTreeSelection *selection; |
144 | |
145 | /* Header information */ |
146 | gint n_columns; |
147 | GList *columns; |
148 | gint header_height; |
149 | |
150 | GtkTreeViewColumnDropFunc column_drop_func; |
151 | gpointer column_drop_func_data; |
152 | GtkDestroyNotify column_drop_func_data_destroy; |
153 | GList *column_drag_info; |
154 | GtkTreeViewColumnReorder *cur_reorder; |
155 | |
156 | /* ATK Hack */ |
157 | GtkTreeDestroyCountFunc destroy_count_func; |
158 | gpointer destroy_count_data; |
159 | GtkDestroyNotify destroy_count_destroy; |
160 | |
161 | /* Scroll timeout (e.g. during dnd) */ |
162 | guint scroll_timeout; |
163 | |
164 | /* Row drag-and-drop */ |
165 | GtkTreeRowReference *drag_dest_row; |
166 | GtkTreeViewDropPosition drag_dest_pos; |
167 | guint open_dest_timeout; |
168 | |
169 | gint pressed_button; |
170 | gint press_start_x; |
171 | gint press_start_y; |
172 | |
173 | /* Scroll-to functionality when unrealized */ |
174 | GtkTreeRowReference *scroll_to_path; |
175 | GtkTreeViewColumn *scroll_to_column; |
176 | gfloat scroll_to_row_align; |
177 | gfloat scroll_to_col_align; |
178 | guint scroll_to_use_align : 1; |
179 | |
180 | guint fixed_height_check : 1; |
181 | |
182 | guint reorderable : 1; |
183 | guint header_has_focus : 1; |
184 | guint drag_column_window_state : 3; |
185 | /* hint to display rows in alternating colors */ |
186 | guint has_rules : 1; |
187 | guint mark_rows_col_dirty : 1; |
188 | |
189 | /* interactive search */ |
190 | guint enable_search : 1; |
191 | guint disable_popdown : 1; |
192 | gint search_column; |
193 | GtkTreeViewSearchDialogPositionFunc search_dialog_position_func; |
194 | GtkTreeViewSearchEqualFunc search_equal_func; |
195 | gpointer search_user_data; |
196 | GtkDestroyNotify search_destroy; |
197 | }; |
198 | |
199 | /* cool ABI compat hack */ |
200 | #define GTK_CELL_RENDERER_INFO_KEY "gtk-cell-renderer-info" |
201 | |
202 | typedef struct _GtkCellRendererInfo GtkCellRendererInfo; |
203 | struct _GtkCellRendererInfo |
204 | { |
205 | GdkColor cell_background; |
206 | |
207 | /* text renderer */ |
208 | gulong focus_out_id; |
209 | |
210 | /* toggle renderer */ |
211 | gboolean inconsistent :1; |
212 | }; |
213 | |
214 | #ifdef __GNUC__ |
215 | |
216 | #define TREE_VIEW_INTERNAL_ASSERT(expr, ret) G_STMT_START{ \ |
217 | if (!(expr)) \ |
218 | { \ |
219 | g_log (G_LOG_DOMAIN, \ |
220 | G_LOG_LEVEL_CRITICAL, \ |
221 | "file %s: line %d (%s): assertion `%s' failed.\n" \ |
222 | "There is a disparity between the internal view of the GtkTreeView,\n" \ |
223 | "and the GtkTreeModel. This generally means that the model has changed\n"\ |
224 | "without letting the view know. Any display from now on is likely to\n" \ |
225 | "be incorrect.\n", \ |
226 | __FILE__, \ |
227 | __LINE__, \ |
228 | __PRETTY_FUNCTION__, \ |
229 | #expr); \ |
230 | return ret; \ |
231 | }; }G_STMT_END |
232 | |
233 | #define TREE_VIEW_INTERNAL_ASSERT_VOID(expr) G_STMT_START{ \ |
234 | if (!(expr)) \ |
235 | { \ |
236 | g_log (G_LOG_DOMAIN, \ |
237 | G_LOG_LEVEL_CRITICAL, \ |
238 | "file %s: line %d (%s): assertion `%s' failed.\n" \ |
239 | "There is a disparity between the internal view of the GtkTreeView,\n" \ |
240 | "and the GtkTreeModel. This generally means that the model has changed\n"\ |
241 | "without letting the view know. Any display from now on is likely to\n" \ |
242 | "be incorrect.\n", \ |
243 | __FILE__, \ |
244 | __LINE__, \ |
245 | __PRETTY_FUNCTION__, \ |
246 | #expr); \ |
247 | return; \ |
248 | }; }G_STMT_END |
249 | |
250 | #else |
251 | |
252 | #define TREE_VIEW_INTERNAL_ASSERT(expr, ret) G_STMT_START{ \ |
253 | if (!(expr)) \ |
254 | { \ |
255 | g_log (G_LOG_DOMAIN, \ |
256 | G_LOG_LEVEL_CRITICAL, \ |
257 | "file %s: line %d: assertion `%s' failed.\n" \ |
258 | "There is a disparity between the internal view of the GtkTreeView,\n" \ |
259 | "and the GtkTreeModel. This generally means that the model has changed\n"\ |
260 | "without letting the view know. Any display from now on is likely to\n" \ |
261 | "be incorrect.\n", \ |
262 | __FILE__, \ |
263 | __LINE__, \ |
264 | #expr); \ |
265 | return ret; \ |
266 | }; }G_STMT_END |
267 | |
268 | #define TREE_VIEW_INTERNAL_ASSERT_VOID(expr) G_STMT_START{ \ |
269 | if (!(expr)) \ |
270 | { \ |
271 | g_log (G_LOG_DOMAIN, \ |
272 | G_LOG_LEVEL_CRITICAL, \ |
273 | "file %s: line %d: assertion '%s' failed.\n" \ |
274 | "There is a disparity between the internal view of the GtkTreeView,\n" \ |
275 | "and the GtkTreeModel. This generally means that the model has changed\n"\ |
276 | "without letting the view know. Any display from now on is likely to\n" \ |
277 | "be incorrect.\n", \ |
278 | __FILE__, \ |
279 | __LINE__, \ |
280 | #expr); \ |
281 | return; \ |
282 | }; }G_STMT_END |
283 | #endif |
284 | |
285 | |
286 | /* functions that shouldn't be exported */ |
287 | void _gtk_tree_selection_internal_select_node (GtkTreeSelection *selection, |
288 | GtkRBNode *node, |
289 | GtkRBTree *tree, |
290 | GtkTreePath *path, |
291 | GdkModifierType state, |
292 | gboolean override_browse_mode); |
293 | gboolean _gtk_tree_view_find_node (GtkTreeView *tree_view, |
294 | GtkTreePath *path, |
295 | GtkRBTree **tree, |
296 | GtkRBNode **node); |
297 | GtkTreePath *_gtk_tree_view_find_path (GtkTreeView *tree_view, |
298 | GtkRBTree *tree, |
299 | GtkRBNode *node); |
300 | void _gtk_tree_view_child_move_resize (GtkTreeView *tree_view, |
301 | GtkWidget *widget, |
302 | gint x, |
303 | gint y, |
304 | gint width, |
305 | gint height); |
306 | void _gtk_tree_view_queue_draw_node (GtkTreeView *tree_view, |
307 | GtkRBTree *tree, |
308 | GtkRBNode *node, |
309 | GdkRectangle *clip_rect); |
310 | |
311 | void _gtk_tree_view_column_realize_button (GtkTreeViewColumn *column); |
312 | void _gtk_tree_view_column_unrealize_button (GtkTreeViewColumn *column); |
313 | void _gtk_tree_view_column_set_tree_view (GtkTreeViewColumn *column, |
314 | GtkTreeView *tree_view); |
315 | void _gtk_tree_view_column_unset_model (GtkTreeViewColumn *column, |
316 | GtkTreeModel *old_model); |
317 | void _gtk_tree_view_column_unset_tree_view (GtkTreeViewColumn *column); |
318 | void _gtk_tree_view_column_set_width (GtkTreeViewColumn *column, |
319 | gint width); |
320 | void _gtk_tree_view_column_start_drag (GtkTreeView *tree_view, |
321 | GtkTreeViewColumn *column); |
322 | gboolean _gtk_tree_view_column_cell_event (GtkTreeViewColumn *tree_column, |
323 | GtkCellEditable **editable_widget, |
324 | GdkEvent *event, |
325 | gchar *path_string, |
326 | GdkRectangle *background_area, |
327 | GdkRectangle *cell_area, |
328 | guint flags); |
329 | void _gtk_tree_view_column_start_editing (GtkTreeViewColumn *tree_column, |
330 | GtkCellEditable *editable_widget); |
331 | void _gtk_tree_view_column_stop_editing (GtkTreeViewColumn *tree_column); |
332 | void _gtk_tree_view_install_mark_rows_col_dirty (GtkTreeView *tree_view); |
333 | void _gtk_tree_view_column_autosize (GtkTreeView *tree_view, |
334 | GtkTreeViewColumn *column); |
335 | |
336 | gboolean _gtk_tree_view_column_has_editable_cell (GtkTreeViewColumn *column); |
337 | GtkCellRenderer *_gtk_tree_view_column_get_edited_cell (GtkTreeViewColumn *column); |
338 | gint _gtk_tree_view_column_count_special_cells (GtkTreeViewColumn *column); |
339 | GtkCellRenderer *_gtk_tree_view_column_get_cell_at_pos (GtkTreeViewColumn *column, |
340 | gint x); |
341 | |
342 | GtkTreeSelection* _gtk_tree_selection_new (void); |
343 | GtkTreeSelection* _gtk_tree_selection_new_with_tree_view (GtkTreeView *tree_view); |
344 | void _gtk_tree_selection_set_tree_view (GtkTreeSelection *selection, |
345 | GtkTreeView *tree_view); |
346 | |
347 | void _gtk_tree_view_column_cell_render (GtkTreeViewColumn *tree_column, |
348 | GdkWindow *window, |
349 | GdkRectangle *background_area, |
350 | GdkRectangle *cell_area, |
351 | GdkRectangle *expose_area, |
352 | guint flags); |
353 | gboolean _gtk_tree_view_column_cell_focus (GtkTreeViewColumn *tree_column, |
354 | gint direction, |
355 | gboolean left, |
356 | gboolean right); |
357 | void _gtk_tree_view_column_cell_draw_focus (GtkTreeViewColumn *tree_column, |
358 | GdkWindow *window, |
359 | GdkRectangle *background_area, |
360 | GdkRectangle *cell_area, |
361 | GdkRectangle *expose_area, |
362 | guint flags); |
363 | void _gtk_tree_view_column_cell_set_dirty (GtkTreeViewColumn *tree_column, |
364 | gboolean install_handler); |
365 | void _gtk_tree_view_column_get_neighbor_sizes (GtkTreeViewColumn *column, |
366 | GtkCellRenderer *cell, |
367 | gint *left, |
368 | gint *right); |
369 | |
370 | |
371 | #ifdef __cplusplus |
372 | } |
373 | #endif /* __cplusplus */ |
374 | |
375 | |
376 | #endif /* __GTK_TREE_PRIVATE_H__ */ |
377 | |