2 * Copyright (C) 2000 Red Hat, Inc., Jonathan Blandford <jrb@redhat.com>
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.
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.
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.
20 #ifndef __GTK_TREE_PRIVATE_H__
21 #define __GTK_TREE_PRIVATE_H__
27 #include <gtk/gtktreeview.h>
28 #include <gtk/gtktreeselection.h>
29 #include <gtk/gtkrbtree.h>
31 #define TREE_VIEW_DRAG_WIDTH 6
35 GTK_TREE_VIEW_IS_LIST = 1 << 0,
36 GTK_TREE_VIEW_SHOW_EXPANDERS = 1 << 1,
37 GTK_TREE_VIEW_IN_COLUMN_RESIZE = 1 << 2,
38 GTK_TREE_VIEW_ARROW_PRELIT = 1 << 3,
39 GTK_TREE_VIEW_HEADERS_VISIBLE = 1 << 4,
40 GTK_TREE_VIEW_DRAW_KEYFOCUS = 1 << 5,
41 GTK_TREE_VIEW_MODEL_SETUP = 1 << 6,
42 GTK_TREE_VIEW_IN_COLUMN_DRAG = 1 << 7
47 GTK_TREE_SELECT_MODE_TOGGLE = 1 << 0,
48 GTK_TREE_SELECT_MODE_EXTEND = 1 << 1
54 DRAG_COLUMN_WINDOW_STATE_UNSET = 0,
55 DRAG_COLUMN_WINDOW_STATE_ORIGINAL = 1,
56 DRAG_COLUMN_WINDOW_STATE_ARROW = 2,
57 DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT = 3,
58 DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT = 4
64 RUBBER_BAND_MAYBE_START = 1,
65 RUBBER_BAND_ACTIVE = 2
68 #define GTK_TREE_VIEW_SET_FLAG(tree_view, flag) G_STMT_START{ (tree_view->priv->flags|=flag); }G_STMT_END
69 #define GTK_TREE_VIEW_UNSET_FLAG(tree_view, flag) G_STMT_START{ (tree_view->priv->flags&=~(flag)); }G_STMT_END
70 #define GTK_TREE_VIEW_FLAG_SET(tree_view, flag) ((tree_view->priv->flags&flag)==flag)
71 #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)
72 #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))
73 #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))
75 /* This lovely little value is used to determine how far away from the title bar
76 * you can move the mouse and still have a column drag work.
78 #define TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER(tree_view) (10*TREE_VIEW_HEADER_HEIGHT(tree_view))
80 typedef struct _GtkTreeViewColumnReorder GtkTreeViewColumnReorder;
81 struct _GtkTreeViewColumnReorder
85 GtkTreeViewColumn *left_column;
86 GtkTreeViewColumn *right_column;
89 struct _GtkTreeViewPrivate
94 /* tree information */
103 GtkAdjustment *hadjustment;
104 GtkAdjustment *vadjustment;
105 gint min_display_width;
106 gint min_display_height;
109 GdkWindow *bin_window;
110 GdkWindow *header_window;
112 /* Scroll position state keeping */
113 GtkTreeRowReference *top_row;
115 /* dy == y pos of top_row + top_row_dy */
116 /* we cache it for simplicity of the code */
119 guint presize_handler_timer;
120 guint validate_rows_timer;
121 guint scroll_sync_timer;
123 /* Indentation and expander layout */
125 GtkTreeViewColumn *expander_column;
127 gint level_indentation;
129 /* Key navigation (focus), selection */
132 GtkTreeRowReference *anchor;
133 GtkTreeRowReference *cursor;
135 GtkTreeViewColumn *focus_column;
137 /* Current pressed node, previously pressed, prelight */
138 GtkRBNode *button_pressed_node;
139 GtkRBTree *button_pressed_tree;
148 guint last_button_time;
152 GtkRBNode *prelight_node;
153 GtkRBTree *prelight_tree;
156 GtkTreeViewColumn *edited_column;
158 /* The node that's currently being collapsed or expanded */
159 GtkRBNode *expanded_collapsed_node;
160 GtkRBTree *expanded_collapsed_tree;
161 guint expand_collapse_timeout;
163 /* Auto expand/collapse timeout in hover mode */
164 guint auto_expand_timeout;
166 /* Selection information */
167 GtkTreeSelection *selection;
169 /* Header information */
174 GtkTreeViewColumnDropFunc column_drop_func;
175 gpointer column_drop_func_data;
176 GDestroyNotify column_drop_func_data_destroy;
177 GList *column_drag_info;
178 GtkTreeViewColumnReorder *cur_reorder;
180 gint prev_width_before_expander;
182 /* Interactive Header reordering */
183 GdkWindow *drag_window;
184 GdkWindow *drag_highlight_window;
185 GtkTreeViewColumn *drag_column;
188 /* Interactive Header Resizing */
192 /* Non-interactive Header Resizing, expand flag support */
195 gint last_extra_space;
196 gint last_extra_space_per_column;
197 gint last_number_of_expand_columns;
200 GtkTreeDestroyCountFunc destroy_count_func;
201 gpointer destroy_count_data;
202 GDestroyNotify destroy_count_destroy;
204 /* Scroll timeout (e.g. during dnd, rubber banding) */
205 guint scroll_timeout;
207 /* Row drag-and-drop */
208 GtkTreeRowReference *drag_dest_row;
209 GtkTreeViewDropPosition drag_dest_pos;
210 guint open_dest_timeout;
213 gint rubber_band_status;
216 gint rubber_band_shift;
217 gint rubber_band_ctrl;
219 GtkRBNode *rubber_band_start_node;
220 GtkRBTree *rubber_band_start_tree;
222 GtkRBNode *rubber_band_end_node;
223 GtkRBTree *rubber_band_end_tree;
228 /* Scroll-to functionality when unrealized */
229 GtkTreeRowReference *scroll_to_path;
230 GtkTreeViewColumn *scroll_to_column;
231 gfloat scroll_to_row_align;
232 gfloat scroll_to_col_align;
234 /* Interactive search */
237 GtkTreeViewSearchPositionFunc search_position_func;
238 GtkTreeViewSearchEqualFunc search_equal_func;
239 gpointer search_user_data;
240 GDestroyNotify search_destroy;
241 gpointer search_position_user_data;
242 GDestroyNotify search_position_destroy;
243 GtkWidget *search_window;
244 GtkWidget *search_entry;
245 gulong search_entry_changed_id;
246 guint typeselect_flush_timeout;
248 /* Grid and tree lines */
249 GtkTreeViewGridLines grid_lines;
250 double grid_line_dashes[2];
253 gboolean tree_lines_enabled;
254 double tree_line_dashes[2];
258 GtkTreeViewRowSeparatorFunc row_separator_func;
259 gpointer row_separator_data;
260 GDestroyNotify row_separator_destroy;
262 /* Tooltip support */
265 /* Here comes the bitfield */
266 guint scroll_to_use_align : 1;
268 guint fixed_height_mode : 1;
269 guint fixed_height_check : 1;
271 guint reorderable : 1;
272 guint header_has_focus : 1;
273 guint drag_column_window_state : 3;
274 /* hint to display rows in alternating colors */
276 guint mark_rows_col_dirty : 1;
279 guint empty_view_drop : 1;
281 guint ctrl_pressed : 1;
282 guint shift_pressed : 1;
284 guint init_hadjust_value : 1;
286 guint in_top_row_to_dy : 1;
288 /* interactive search */
289 guint enable_search : 1;
290 guint disable_popdown : 1;
291 guint search_custom_entry_set : 1;
293 guint hover_selection : 1;
294 guint hover_expand : 1;
295 guint imcontext_changed : 1;
297 guint rubber_banding_enable : 1;
301 guint post_validation_flag : 1;
303 /* Whether our key press handler is to avoid sending an unhandled binding to the search entry */
304 guint search_entry_avoid_unhandled_binding : 1;
306 /* GtkScrollablePolicy needs to be checked when
307 * driving the scrollable adjustment values */
308 guint hscroll_policy : 1;
309 guint vscroll_policy : 1;
314 #define TREE_VIEW_INTERNAL_ASSERT(expr, ret) G_STMT_START{ \
317 g_log (G_LOG_DOMAIN, \
318 G_LOG_LEVEL_CRITICAL, \
319 "%s (%s): assertion `%s' failed.\n" \
320 "There is a disparity between the internal view of the GtkTreeView,\n" \
321 "and the GtkTreeModel. This generally means that the model has changed\n"\
322 "without letting the view know. Any display from now on is likely to\n" \
330 #define TREE_VIEW_INTERNAL_ASSERT_VOID(expr) G_STMT_START{ \
333 g_log (G_LOG_DOMAIN, \
334 G_LOG_LEVEL_CRITICAL, \
335 "%s (%s): assertion `%s' failed.\n" \
336 "There is a disparity between the internal view of the GtkTreeView,\n" \
337 "and the GtkTreeModel. This generally means that the model has changed\n"\
338 "without letting the view know. Any display from now on is likely to\n" \
348 #define TREE_VIEW_INTERNAL_ASSERT(expr, ret) G_STMT_START{ \
351 g_log (G_LOG_DOMAIN, \
352 G_LOG_LEVEL_CRITICAL, \
353 "file %s: line %d: assertion `%s' failed.\n" \
354 "There is a disparity between the internal view of the GtkTreeView,\n" \
355 "and the GtkTreeModel. This generally means that the model has changed\n"\
356 "without letting the view know. Any display from now on is likely to\n" \
364 #define TREE_VIEW_INTERNAL_ASSERT_VOID(expr) G_STMT_START{ \
367 g_log (G_LOG_DOMAIN, \
368 G_LOG_LEVEL_CRITICAL, \
369 "file %s: line %d: assertion '%s' failed.\n" \
370 "There is a disparity between the internal view of the GtkTreeView,\n" \
371 "and the GtkTreeModel. This generally means that the model has changed\n"\
372 "without letting the view know. Any display from now on is likely to\n" \
382 /* functions that shouldn't be exported */
383 void _gtk_tree_selection_internal_select_node (GtkTreeSelection *selection,
387 GtkTreeSelectMode mode,
388 gboolean override_browse_mode);
389 void _gtk_tree_selection_emit_changed (GtkTreeSelection *selection);
390 gboolean _gtk_tree_view_find_node (GtkTreeView *tree_view,
394 GtkTreePath *_gtk_tree_view_find_path (GtkTreeView *tree_view,
397 void _gtk_tree_view_child_move_resize (GtkTreeView *tree_view,
403 void _gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
406 const GdkRectangle *clip_rect);
408 void _gtk_tree_view_column_realize_button (GtkTreeViewColumn *column);
409 void _gtk_tree_view_column_unrealize_button (GtkTreeViewColumn *column);
410 void _gtk_tree_view_column_set_tree_view (GtkTreeViewColumn *column,
411 GtkTreeView *tree_view);
412 void _gtk_tree_view_column_unset_model (GtkTreeViewColumn *column,
413 GtkTreeModel *old_model);
414 void _gtk_tree_view_column_unset_tree_view (GtkTreeViewColumn *column);
415 void _gtk_tree_view_column_set_width (GtkTreeViewColumn *column,
417 void _gtk_tree_view_column_start_drag (GtkTreeView *tree_view,
418 GtkTreeViewColumn *column,
420 gboolean _gtk_tree_view_column_cell_event (GtkTreeViewColumn *tree_column,
421 GtkCellEditable **editable_widget,
424 const GdkRectangle *background_area,
425 const GdkRectangle *cell_area,
427 void _gtk_tree_view_column_start_editing (GtkTreeViewColumn *tree_column,
428 GtkCellEditable *editable_widget);
429 void _gtk_tree_view_column_stop_editing (GtkTreeViewColumn *tree_column);
430 void _gtk_tree_view_install_mark_rows_col_dirty (GtkTreeView *tree_view);
431 void _gtk_tree_view_column_autosize (GtkTreeView *tree_view,
432 GtkTreeViewColumn *column);
434 gboolean _gtk_tree_view_column_has_editable_cell (GtkTreeViewColumn *column);
435 GtkCellRenderer *_gtk_tree_view_column_get_edited_cell (GtkTreeViewColumn *column);
436 gint _gtk_tree_view_column_count_special_cells (GtkTreeViewColumn *column);
437 GtkCellRenderer *_gtk_tree_view_column_get_cell_at_pos (GtkTreeViewColumn *column,
440 GtkTreeSelection* _gtk_tree_selection_new (void);
441 GtkTreeSelection* _gtk_tree_selection_new_with_tree_view (GtkTreeView *tree_view);
442 void _gtk_tree_selection_set_tree_view (GtkTreeSelection *selection,
443 GtkTreeView *tree_view);
444 gboolean _gtk_tree_selection_row_is_selectable (GtkTreeSelection *selection,
448 void _gtk_tree_view_column_cell_render (GtkTreeViewColumn *tree_column,
450 const GdkRectangle *background_area,
451 const GdkRectangle *cell_area,
453 void _gtk_tree_view_column_get_focus_area (GtkTreeViewColumn *tree_column,
454 const GdkRectangle *background_area,
455 const GdkRectangle *cell_area,
456 GdkRectangle *focus_area);
457 gboolean _gtk_tree_view_column_cell_focus (GtkTreeViewColumn *tree_column,
461 void _gtk_tree_view_column_cell_draw_focus (GtkTreeViewColumn *tree_column,
463 const GdkRectangle *background_area,
464 const GdkRectangle *cell_area,
466 void _gtk_tree_view_column_cell_set_dirty (GtkTreeViewColumn *tree_column,
467 gboolean install_handler);
468 void _gtk_tree_view_column_get_neighbor_sizes (GtkTreeViewColumn *column,
469 GtkCellRenderer *cell,
477 #endif /* __GTK_TREE_PRIVATE_H__ */