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__
26 #endif /* __cplusplus */
28 #include <gtk/gtktreeview.h>
29 #include <gtk/gtktreeselection.h>
30 #include <gtk/gtkrbtree.h>
32 #define TREE_VIEW_DRAG_WIDTH 6
36 GTK_TREE_VIEW_IS_LIST = 1 << 0,
37 GTK_TREE_VIEW_SHOW_EXPANDERS = 1 << 1,
38 GTK_TREE_VIEW_IN_COLUMN_RESIZE = 1 << 2,
39 GTK_TREE_VIEW_ARROW_PRELIT = 1 << 3,
40 GTK_TREE_VIEW_HEADERS_VISIBLE = 1 << 4,
41 GTK_TREE_VIEW_DRAW_KEYFOCUS = 1 << 5,
42 GTK_TREE_VIEW_MODEL_SETUP = 1 << 6,
43 GTK_TREE_VIEW_IN_COLUMN_DRAG = 1 << 7
48 DRAG_COLUMN_WINDOW_STATE_UNSET = 0,
49 DRAG_COLUMN_WINDOW_STATE_ORIGINAL = 1,
50 DRAG_COLUMN_WINDOW_STATE_ARROW = 2,
51 DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT = 3,
52 DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT = 4
55 #define GTK_TREE_VIEW_SET_FLAG(tree_view, flag) G_STMT_START{ (tree_view->priv->flags|=flag); }G_STMT_END
56 #define GTK_TREE_VIEW_UNSET_FLAG(tree_view, flag) G_STMT_START{ (tree_view->priv->flags&=~(flag)); }G_STMT_END
57 #define GTK_TREE_VIEW_FLAG_SET(tree_view, flag) ((tree_view->priv->flags&flag)==flag)
58 #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)
59 #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))
60 #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 /* This lovely little value is used to determine how far away from the title bar
63 * you can move the mouse and still have a column drag work.
65 #define TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER(tree_view) (10*TREE_VIEW_HEADER_HEIGHT(tree_view))
67 typedef void (*GtkTreeViewSearchDialogPositionFunc) (GtkTreeView *tree_view,
68 GtkWidget *search_dialog);
70 typedef struct _GtkTreeViewColumnReorder GtkTreeViewColumnReorder;
71 struct _GtkTreeViewColumnReorder
75 GtkTreeViewColumn *left_column;
76 GtkTreeViewColumn *right_column;
79 struct _GtkTreeViewPrivate
84 /* tree information */
87 GtkRBNode *button_pressed_node;
88 GtkRBTree *button_pressed_tree;
95 GtkAdjustment *hadjustment;
96 GtkAdjustment *vadjustment;
98 GdkWindow *bin_window;
99 GdkWindow *header_window;
100 GdkWindow *drag_window;
101 GdkWindow *drag_highlight_window;
102 GtkTreeViewColumn *drag_column;
104 GtkTreeRowReference *last_button_press;
105 GtkTreeRowReference *last_button_press_2;
107 /* bin_window offset */
108 GtkTreeRowReference *top_row;
110 /* dy == y pos of top_row + top_row_dy */
111 /* we cache it for simplicity of the code */
115 GtkTreeViewColumn *expander_column;
116 GtkTreeViewColumn *edited_column;
117 guint presize_handler_timer;
118 guint validate_rows_timer;
119 guint scroll_sync_timer;
122 GtkTreeViewColumn *focus_column;
124 /* Selection stuff */
125 GtkTreeRowReference *anchor;
126 GtkTreeRowReference *cursor;
128 /* Column Resizing */
132 /* Prelight information */
133 GtkRBNode *prelight_node;
134 GtkRBTree *prelight_tree;
136 /* The node that's currently being collapsed or expanded */
137 GtkRBNode *expanded_collapsed_node;
138 GtkRBTree *expanded_collapsed_tree;
139 guint expand_collapse_timeout;
141 /* Selection information */
142 GtkTreeSelection *selection;
144 /* Header information */
149 GtkTreeViewColumnDropFunc column_drop_func;
150 gpointer column_drop_func_data;
151 GtkDestroyNotify column_drop_func_data_destroy;
152 GList *column_drag_info;
153 GtkTreeViewColumnReorder *cur_reorder;
156 GtkTreeDestroyCountFunc destroy_count_func;
157 gpointer destroy_count_data;
158 GtkDestroyNotify destroy_count_destroy;
160 /* Scroll timeout (e.g. during dnd) */
161 guint scroll_timeout;
163 /* Row drag-and-drop */
164 GtkTreeRowReference *drag_dest_row;
165 GtkTreeViewDropPosition drag_dest_pos;
166 guint open_dest_timeout;
172 /* Scroll-to functionality when unrealized */
173 GtkTreeRowReference *scroll_to_path;
174 GtkTreeViewColumn *scroll_to_column;
175 gfloat scroll_to_row_align;
176 gfloat scroll_to_col_align;
177 guint scroll_to_use_align : 1;
179 guint fixed_height_check : 1;
181 guint reorderable : 1;
182 guint header_has_focus : 1;
183 guint drag_column_window_state : 3;
184 /* hint to display rows in alternating colors */
186 guint mark_rows_col_dirty : 1;
188 /* interactive search */
189 guint enable_search : 1;
190 guint disable_popdown : 1;
192 GtkTreeViewSearchDialogPositionFunc search_dialog_position_func;
193 GtkTreeViewSearchEqualFunc search_equal_func;
194 gpointer search_user_data;
195 GtkDestroyNotify search_destroy;
200 #define TREE_VIEW_INTERNAL_ASSERT(expr, ret) G_STMT_START{ \
203 g_log (G_LOG_DOMAIN, \
204 G_LOG_LEVEL_CRITICAL, \
205 "file %s: line %d (%s): assertion `%s' failed.\n" \
206 "There is a disparity between the internal view of the GtkTreeView,\n" \
207 "and the GtkTreeModel. This generally means that the model has changed\n"\
208 "without letting the view know. Any display from now on is likely to\n" \
212 __PRETTY_FUNCTION__, \
217 #define TREE_VIEW_INTERNAL_ASSERT_VOID(expr) G_STMT_START{ \
220 g_log (G_LOG_DOMAIN, \
221 G_LOG_LEVEL_CRITICAL, \
222 "file %s: line %d (%s): assertion `%s' failed.\n" \
223 "There is a disparity between the internal view of the GtkTreeView,\n" \
224 "and the GtkTreeModel. This generally means that the model has changed\n"\
225 "without letting the view know. Any display from now on is likely to\n" \
229 __PRETTY_FUNCTION__, \
236 #define TREE_VIEW_INTERNAL_ASSERT(expr, ret) G_STMT_START{ \
239 g_log (G_LOG_DOMAIN, \
240 G_LOG_LEVEL_CRITICAL, \
241 "file %s: line %d: assertion `%s' failed.\n" \
242 "There is a disparity between the internal view of the GtkTreeView,\n" \
243 "and the GtkTreeModel. This generally means that the model has changed\n"\
244 "without letting the view know. Any display from now on is likely to\n" \
252 #define TREE_VIEW_INTERNAL_ASSERT_VOID(expr) G_STMT_START{ \
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" \
270 /* functions that shouldn't be exported */
271 void _gtk_tree_selection_internal_select_node (GtkTreeSelection *selection,
275 GdkModifierType state,
276 gboolean override_browse_mode);
277 gboolean _gtk_tree_view_find_node (GtkTreeView *tree_view,
281 GtkTreePath *_gtk_tree_view_find_path (GtkTreeView *tree_view,
284 void _gtk_tree_view_child_move_resize (GtkTreeView *tree_view,
290 void _gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
293 GdkRectangle *clip_rect);
295 void _gtk_tree_view_column_realize_button (GtkTreeViewColumn *column);
296 void _gtk_tree_view_column_unrealize_button (GtkTreeViewColumn *column);
297 void _gtk_tree_view_column_set_tree_view (GtkTreeViewColumn *column,
298 GtkTreeView *tree_view);
299 void _gtk_tree_view_column_unset_tree_view (GtkTreeViewColumn *column);
300 void _gtk_tree_view_column_set_width (GtkTreeViewColumn *column,
302 void _gtk_tree_view_column_start_drag (GtkTreeView *tree_view,
303 GtkTreeViewColumn *column);
304 gboolean _gtk_tree_view_column_cell_event (GtkTreeViewColumn *tree_column,
305 GtkCellEditable **editable_widget,
308 GdkRectangle *background_area,
309 GdkRectangle *cell_area,
311 void _gtk_tree_view_column_start_editing (GtkTreeViewColumn *tree_column,
312 GtkCellEditable *editable_widget);
313 void _gtk_tree_view_column_stop_editing (GtkTreeViewColumn *tree_column);
314 void _gtk_tree_view_install_mark_rows_col_dirty (GtkTreeView *tree_view);
315 void _gtk_tree_view_column_autosize (GtkTreeView *tree_view,
316 GtkTreeViewColumn *column);
318 gboolean _gtk_tree_view_column_has_editable_cell (GtkTreeViewColumn *column);
319 GtkCellRenderer *_gtk_tree_view_column_get_edited_cell (GtkTreeViewColumn *column);
320 gint _gtk_tree_view_column_count_special_cells (GtkTreeViewColumn *column);
321 GtkCellRenderer *_gtk_tree_view_column_get_cell_at_pos (GtkTreeViewColumn *column,
324 GtkTreeSelection* _gtk_tree_selection_new (void);
325 GtkTreeSelection* _gtk_tree_selection_new_with_tree_view (GtkTreeView *tree_view);
326 void _gtk_tree_selection_set_tree_view (GtkTreeSelection *selection,
327 GtkTreeView *tree_view);
329 void _gtk_tree_view_column_cell_render (GtkTreeViewColumn *tree_column,
331 GdkRectangle *background_area,
332 GdkRectangle *cell_area,
333 GdkRectangle *expose_area,
335 gboolean _gtk_tree_view_column_cell_focus (GtkTreeViewColumn *tree_column,
339 void _gtk_tree_view_column_cell_draw_focus (GtkTreeViewColumn *tree_column,
341 GdkRectangle *background_area,
342 GdkRectangle *cell_area,
343 GdkRectangle *expose_area,
345 void _gtk_tree_view_column_cell_set_dirty (GtkTreeViewColumn *tree_column,
346 gboolean install_handler);
347 void _gtk_tree_view_column_get_neighbor_sizes (GtkTreeViewColumn *column,
348 GtkCellRenderer *cell,
355 #endif /* __cplusplus */
358 #endif /* __GTK_TREE_PRIVATE_H__ */