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.
21 #include "gtktreeview.h"
22 #include "gtkrbtree.h"
23 #include "gtktreednd.h"
24 #include "gtktreeprivate.h"
25 #include "gtkcellrenderer.h"
26 #include "gtksignal.h"
28 #include "gtkmarshalers.h"
29 #include "gtkbutton.h"
30 #include "gtkalignment.h"
35 #include "gtkbindings.h"
36 #include "gtkcontainer.h"
38 #include "gtktreemodelsort.h"
41 #include <gdk/gdkkeysyms.h>
43 #define GTK_TREE_VIEW_SEARCH_DIALOG_KEY "gtk-tree-view-search-dialog"
44 #define GTK_TREE_VIEW_PRIORITY_VALIDATE (GDK_PRIORITY_REDRAW + 5)
45 #define GTK_TREE_VIEW_PRIORITY_SCROLL_SYNC (GTK_TREE_VIEW_PRIORITY_VALIDATE + 2)
46 #define GTK_TREE_VIEW_NUM_ROWS_PER_IDLE 500
47 #define SCROLL_EDGE_SIZE 15
48 #define EXPANDER_EXTRA_PADDING 4
50 /* The "background" areas of all rows/cells add up to cover the entire tree.
51 * The background includes all inter-row and inter-cell spacing.
52 * The "cell" areas are the cell_area passed in to gtk_cell_renderer_render(),
53 * i.e. just the cells, no spacing.
56 #define BACKGROUND_HEIGHT(node) (GTK_RBNODE_GET_HEIGHT (node))
57 #define CELL_HEIGHT(node, separator) ((BACKGROUND_HEIGHT (node)) - (separator))
59 #define TREE_WINDOW_Y_TO_RBTREE_Y(tree_view,y) ((y) + tree_view->priv->dy)
60 #define RBTREE_Y_TO_TREE_WINDOW_Y(tree_view,y) ((y) - tree_view->priv->dy)
62 /* This is in Window coordinates */
63 #define BACKGROUND_FIRST_PIXEL(tree_view,tree,node) (RBTREE_Y_TO_TREE_WINDOW_Y (tree_view, _gtk_rbtree_node_find_offset ((tree), (node))))
64 #define CELL_FIRST_PIXEL(tree_view,tree,node,separator) (BACKGROUND_FIRST_PIXEL (tree_view,tree,node) + separator/2)
67 typedef struct _GtkTreeViewChild GtkTreeViewChild;
68 struct _GtkTreeViewChild
78 typedef struct _TreeViewDragInfo TreeViewDragInfo;
79 struct _TreeViewDragInfo
81 GdkModifierType start_button_mask;
82 GtkTargetList *source_target_list;
83 GdkDragAction source_actions;
85 GtkTargetList *dest_target_list;
107 EXPAND_COLLAPSE_CURSOR_ROW,
108 SELECT_CURSOR_PARENT,
109 START_INTERACTIVE_SEARCH,
119 PROP_HEADERS_VISIBLE,
120 PROP_HEADERS_CLICKABLE,
121 PROP_EXPANDER_COLUMN,
128 static void gtk_tree_view_class_init (GtkTreeViewClass *klass);
129 static void gtk_tree_view_init (GtkTreeView *tree_view);
132 static void gtk_tree_view_finalize (GObject *object);
133 static void gtk_tree_view_set_property (GObject *object,
137 static void gtk_tree_view_get_property (GObject *object,
142 /* gtkobject signals */
143 static void gtk_tree_view_destroy (GtkObject *object);
145 /* gtkwidget signals */
146 static void gtk_tree_view_realize (GtkWidget *widget);
147 static void gtk_tree_view_unrealize (GtkWidget *widget);
148 static void gtk_tree_view_map (GtkWidget *widget);
149 static void gtk_tree_view_size_request (GtkWidget *widget,
150 GtkRequisition *requisition);
151 static void gtk_tree_view_size_allocate (GtkWidget *widget,
152 GtkAllocation *allocation);
153 static gboolean gtk_tree_view_expose (GtkWidget *widget,
154 GdkEventExpose *event);
155 static gboolean gtk_tree_view_key_press (GtkWidget *widget,
157 static gboolean gtk_tree_view_motion (GtkWidget *widget,
158 GdkEventMotion *event);
159 static gboolean gtk_tree_view_enter_notify (GtkWidget *widget,
160 GdkEventCrossing *event);
161 static gboolean gtk_tree_view_leave_notify (GtkWidget *widget,
162 GdkEventCrossing *event);
163 static gboolean gtk_tree_view_button_press (GtkWidget *widget,
164 GdkEventButton *event);
165 static gboolean gtk_tree_view_button_release (GtkWidget *widget,
166 GdkEventButton *event);
167 static void gtk_tree_view_set_focus_child (GtkContainer *container,
169 static gint gtk_tree_view_focus_out (GtkWidget *widget,
170 GdkEventFocus *event);
171 static gint gtk_tree_view_focus (GtkWidget *widget,
172 GtkDirectionType direction);
173 static void gtk_tree_view_grab_focus (GtkWidget *widget);
174 static void gtk_tree_view_style_set (GtkWidget *widget,
175 GtkStyle *previous_style);
177 /* container signals */
178 static void gtk_tree_view_remove (GtkContainer *container,
180 static void gtk_tree_view_forall (GtkContainer *container,
181 gboolean include_internals,
182 GtkCallback callback,
183 gpointer callback_data);
185 /* Source side drag signals */
186 static void gtk_tree_view_drag_begin (GtkWidget *widget,
187 GdkDragContext *context);
188 static void gtk_tree_view_drag_end (GtkWidget *widget,
189 GdkDragContext *context);
190 static void gtk_tree_view_drag_data_get (GtkWidget *widget,
191 GdkDragContext *context,
192 GtkSelectionData *selection_data,
195 static void gtk_tree_view_drag_data_delete (GtkWidget *widget,
196 GdkDragContext *context);
198 /* Target side drag signals */
199 static void gtk_tree_view_drag_leave (GtkWidget *widget,
200 GdkDragContext *context,
202 static gboolean gtk_tree_view_drag_motion (GtkWidget *widget,
203 GdkDragContext *context,
207 static gboolean gtk_tree_view_drag_drop (GtkWidget *widget,
208 GdkDragContext *context,
212 static void gtk_tree_view_drag_data_received (GtkWidget *widget,
213 GdkDragContext *context,
216 GtkSelectionData *selection_data,
220 /* tree_model signals */
221 static void gtk_tree_view_set_adjustments (GtkTreeView *tree_view,
223 GtkAdjustment *vadj);
224 static gboolean gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
225 GtkMovementStep step,
227 static void gtk_tree_view_real_select_all (GtkTreeView *tree_view);
228 static void gtk_tree_view_real_unselect_all (GtkTreeView *tree_view);
229 static void gtk_tree_view_real_select_cursor_row (GtkTreeView *tree_view,
230 gboolean start_editing);
231 static void gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view);
232 static void gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
236 static void gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view);
237 static void gtk_tree_view_row_changed (GtkTreeModel *model,
241 static void gtk_tree_view_row_inserted (GtkTreeModel *model,
245 static void gtk_tree_view_row_has_child_toggled (GtkTreeModel *model,
249 static void gtk_tree_view_row_deleted (GtkTreeModel *model,
252 static void gtk_tree_view_rows_reordered (GtkTreeModel *model,
258 /* Incremental reflow */
259 static gboolean validate_row (GtkTreeView *tree_view,
264 static void validate_visible_area (GtkTreeView *tree_view);
265 static gboolean validate_rows_handler (GtkTreeView *tree_view);
266 static gboolean do_validate_rows (GtkTreeView *tree_view);
267 static gboolean presize_handler_callback (gpointer data);
268 static void install_presize_handler (GtkTreeView *tree_view);
269 static void install_scroll_sync_handler (GtkTreeView *tree_view);
270 static void gtk_tree_view_dy_to_top_row (GtkTreeView *tree_view);
271 static void gtk_tree_view_top_row_to_dy (GtkTreeView *tree_view);
274 /* Internal functions */
275 static gboolean gtk_tree_view_is_expander_column (GtkTreeView *tree_view,
276 GtkTreeViewColumn *column);
277 static void gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
280 GtkMovementStep step,
282 static gint gtk_tree_view_unref_and_check_selection_tree (GtkTreeView *tree_view,
284 static void gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
286 GdkRectangle *clip_rect);
287 static void gtk_tree_view_queue_draw_arrow (GtkTreeView *tree_view,
290 GdkRectangle *clip_rect);
291 static void gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
296 static void gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
300 static gint gtk_tree_view_new_column_width (GtkTreeView *tree_view,
303 static void gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
304 GtkTreeView *tree_view);
305 static void gtk_tree_view_build_tree (GtkTreeView *tree_view,
310 static gboolean gtk_tree_view_discover_dirty_iter (GtkTreeView *tree_view,
315 static void gtk_tree_view_discover_dirty (GtkTreeView *tree_view,
319 static void gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
322 static void gtk_tree_view_clamp_column_visible (GtkTreeView *tree_view,
323 GtkTreeViewColumn *column);
324 static gboolean gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
325 GdkEventMotion *event);
326 static void gtk_tree_view_focus_to_cursor (GtkTreeView *tree_view);
327 static void gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
329 static void gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
331 static void gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
333 static void gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
335 static gboolean gtk_tree_view_real_collapse_row (GtkTreeView *tree_view,
340 static gboolean gtk_tree_view_real_expand_row (GtkTreeView *tree_view,
346 static void gtk_tree_view_real_set_cursor (GtkTreeView *tree_view,
348 gboolean clear_and_select,
349 gboolean clamp_node);
351 /* interactive search */
352 static void gtk_tree_view_search_dialog_destroy (GtkWidget *search_dialog,
353 GtkTreeView *tree_view);
354 static void gtk_tree_view_search_position_func (GtkTreeView *tree_view,
355 GtkWidget *search_dialog);
356 static void gtk_tree_view_search_disable_popdown (GtkEntry *entry,
359 static gboolean gtk_tree_view_real_search_enable_popdown(gpointer data);
360 static void gtk_tree_view_search_enable_popdown (GtkWidget *widget,
362 static gboolean gtk_tree_view_search_delete_event (GtkWidget *widget,
364 GtkTreeView *tree_view);
365 static gboolean gtk_tree_view_search_button_press_event (GtkWidget *widget,
366 GdkEventButton *event,
367 GtkTreeView *tree_view);
368 static gboolean gtk_tree_view_search_key_press_event (GtkWidget *entry,
370 GtkTreeView *tree_view);
371 static void gtk_tree_view_search_move (GtkWidget *window,
372 GtkTreeView *tree_view,
374 static gboolean gtk_tree_view_search_equal_func (GtkTreeModel *model,
378 gpointer search_data);
379 static gboolean gtk_tree_view_search_iter (GtkTreeModel *model,
380 GtkTreeSelection *selection,
385 static void gtk_tree_view_search_init (GtkWidget *entry,
386 GtkTreeView *tree_view);
387 static void gtk_tree_view_put (GtkTreeView *tree_view,
388 GtkWidget *child_widget,
393 static gboolean gtk_tree_view_start_editing (GtkTreeView *tree_view,
394 GtkTreePath *cursor_path);
395 static void gtk_tree_view_real_start_editing (GtkTreeView *tree_view,
396 GtkTreeViewColumn *column,
398 GtkCellEditable *cell_editable,
399 GdkRectangle *cell_area,
402 static void gtk_tree_view_stop_editing (GtkTreeView *tree_view,
403 gboolean cancel_editing);
404 static void gtk_tree_view_real_start_interactive_search (GtkTreeView *tree_view);
405 static GtkTreeViewColumn *gtk_tree_view_get_drop_column (GtkTreeView *tree_view,
406 GtkTreeViewColumn *column,
410 static GtkContainerClass *parent_class = NULL;
411 static guint tree_view_signals [LAST_SIGNAL] = { 0 };
419 gtk_tree_view_get_type (void)
421 static GtkType tree_view_type = 0;
425 static const GTypeInfo tree_view_info =
427 sizeof (GtkTreeViewClass),
428 NULL, /* base_init */
429 NULL, /* base_finalize */
430 (GClassInitFunc) gtk_tree_view_class_init,
431 NULL, /* class_finalize */
432 NULL, /* class_data */
433 sizeof (GtkTreeView),
435 (GInstanceInitFunc) gtk_tree_view_init
438 tree_view_type = g_type_register_static (GTK_TYPE_CONTAINER, "GtkTreeView", &tree_view_info, 0);
441 return tree_view_type;
445 gtk_tree_view_class_init (GtkTreeViewClass *class)
447 GObjectClass *o_class;
448 GtkObjectClass *object_class;
449 GtkWidgetClass *widget_class;
450 GtkContainerClass *container_class;
451 GtkBindingSet *binding_set;
453 parent_class = g_type_class_peek_parent (class);
454 binding_set = gtk_binding_set_by_class (class);
456 o_class = (GObjectClass *) class;
457 object_class = (GtkObjectClass *) class;
458 widget_class = (GtkWidgetClass *) class;
459 container_class = (GtkContainerClass *) class;
461 /* GObject signals */
462 o_class->set_property = gtk_tree_view_set_property;
463 o_class->get_property = gtk_tree_view_get_property;
464 o_class->finalize = gtk_tree_view_finalize;
466 /* GtkObject signals */
467 object_class->destroy = gtk_tree_view_destroy;
469 /* GtkWidget signals */
470 widget_class->map = gtk_tree_view_map;
471 widget_class->realize = gtk_tree_view_realize;
472 widget_class->unrealize = gtk_tree_view_unrealize;
473 widget_class->size_request = gtk_tree_view_size_request;
474 widget_class->size_allocate = gtk_tree_view_size_allocate;
475 widget_class->button_press_event = gtk_tree_view_button_press;
476 widget_class->button_release_event = gtk_tree_view_button_release;
477 widget_class->motion_notify_event = gtk_tree_view_motion;
478 widget_class->expose_event = gtk_tree_view_expose;
479 widget_class->key_press_event = gtk_tree_view_key_press;
480 widget_class->enter_notify_event = gtk_tree_view_enter_notify;
481 widget_class->leave_notify_event = gtk_tree_view_leave_notify;
482 widget_class->focus_out_event = gtk_tree_view_focus_out;
483 widget_class->drag_begin = gtk_tree_view_drag_begin;
484 widget_class->drag_end = gtk_tree_view_drag_end;
485 widget_class->drag_data_get = gtk_tree_view_drag_data_get;
486 widget_class->drag_data_delete = gtk_tree_view_drag_data_delete;
487 widget_class->drag_leave = gtk_tree_view_drag_leave;
488 widget_class->drag_motion = gtk_tree_view_drag_motion;
489 widget_class->drag_drop = gtk_tree_view_drag_drop;
490 widget_class->drag_data_received = gtk_tree_view_drag_data_received;
491 widget_class->focus = gtk_tree_view_focus;
492 widget_class->grab_focus = gtk_tree_view_grab_focus;
493 widget_class->style_set = gtk_tree_view_style_set;
495 /* GtkContainer signals */
496 container_class->remove = gtk_tree_view_remove;
497 container_class->forall = gtk_tree_view_forall;
498 container_class->set_focus_child = gtk_tree_view_set_focus_child;
500 class->set_scroll_adjustments = gtk_tree_view_set_adjustments;
501 class->move_cursor = gtk_tree_view_real_move_cursor;
502 class->select_all = gtk_tree_view_real_select_all;
503 class->unselect_all = gtk_tree_view_real_unselect_all;
504 class->select_cursor_row = gtk_tree_view_real_select_cursor_row;
505 class->toggle_cursor_row = gtk_tree_view_real_toggle_cursor_row;
506 class->expand_collapse_cursor_row = gtk_tree_view_real_expand_collapse_cursor_row;
507 class->select_cursor_parent = gtk_tree_view_real_select_cursor_parent;
508 class->start_interactive_search = gtk_tree_view_real_start_interactive_search;
512 g_object_class_install_property (o_class,
514 g_param_spec_object ("model",
516 _("The model for the tree view"),
520 g_object_class_install_property (o_class,
522 g_param_spec_object ("hadjustment",
523 _("Horizontal Adjustment"),
524 _("Horizontal Adjustment for the widget"),
528 g_object_class_install_property (o_class,
530 g_param_spec_object ("vadjustment",
531 _("Vertical Adjustment"),
532 _("Vertical Adjustment for the widget"),
536 g_object_class_install_property (o_class,
537 PROP_HEADERS_VISIBLE,
538 g_param_spec_boolean ("headers_visible",
540 _("Show the column header buttons"),
544 g_object_class_install_property (o_class,
545 PROP_HEADERS_CLICKABLE,
546 g_param_spec_boolean ("headers_clickable",
547 _("Headers Clickable"),
548 _("Column headers respond to click events"),
552 g_object_class_install_property (o_class,
553 PROP_EXPANDER_COLUMN,
554 g_param_spec_object ("expander_column",
555 _("Expander Column"),
556 _("Set the column for the expander column"),
557 GTK_TYPE_TREE_VIEW_COLUMN,
560 g_object_class_install_property (o_class,
562 g_param_spec_boolean ("reorderable",
564 _("View is reorderable"),
568 g_object_class_install_property (o_class,
570 g_param_spec_boolean ("rules_hint",
572 _("Set a hint to the theme engine to draw rows in alternating colors"),
576 g_object_class_install_property (o_class,
578 g_param_spec_boolean ("enable_search",
580 _("View allows user to search through columns interactively"),
584 g_object_class_install_property (o_class,
586 g_param_spec_int ("search_column",
588 _("Model column to search through when searching through code"),
594 /* Style properties */
595 #define _TREE_VIEW_EXPANDER_SIZE 10
596 #define _TREE_VIEW_VERTICAL_SEPARATOR 2
597 #define _TREE_VIEW_HORIZONTAL_SEPARATOR 2
599 gtk_widget_class_install_style_property (widget_class,
600 g_param_spec_int ("expander_size",
602 _("Size of the expander arrow."),
605 _TREE_VIEW_EXPANDER_SIZE,
608 gtk_widget_class_install_style_property (widget_class,
609 g_param_spec_int ("vertical_separator",
610 _("Vertical Separator Width"),
611 _("Vertical space between cells. Must be an even number."),
614 _TREE_VIEW_VERTICAL_SEPARATOR,
617 gtk_widget_class_install_style_property (widget_class,
618 g_param_spec_int ("horizontal_separator",
619 _("Horizontal Separator Width"),
620 _("Horizontal space between cells. Must be an even number."),
623 _TREE_VIEW_HORIZONTAL_SEPARATOR,
626 gtk_widget_class_install_style_property (widget_class,
627 g_param_spec_boolean ("allow_rules",
629 _("Allow drawing of alternating color rows."),
633 gtk_widget_class_install_style_property (widget_class,
634 g_param_spec_boolean ("indent_expanders",
635 _("Indent Expanders"),
636 _("Make the expanders indented."),
640 widget_class->set_scroll_adjustments_signal =
641 gtk_signal_new ("set_scroll_adjustments",
643 GTK_CLASS_TYPE (object_class),
644 GTK_SIGNAL_OFFSET (GtkTreeViewClass, set_scroll_adjustments),
645 _gtk_marshal_VOID__OBJECT_OBJECT,
647 GTK_TYPE_ADJUSTMENT, GTK_TYPE_ADJUSTMENT);
649 tree_view_signals[ROW_ACTIVATED] =
650 gtk_signal_new ("row_activated",
651 GTK_RUN_LAST | GTK_RUN_ACTION,
652 GTK_CLASS_TYPE (object_class),
653 GTK_SIGNAL_OFFSET (GtkTreeViewClass, row_activated),
654 _gtk_marshal_VOID__BOXED_OBJECT,
657 GTK_TYPE_TREE_VIEW_COLUMN);
659 tree_view_signals[TEST_EXPAND_ROW] =
660 g_signal_new ("test_expand_row",
661 G_TYPE_FROM_CLASS (object_class),
663 G_STRUCT_OFFSET (GtkTreeViewClass, test_expand_row),
664 _gtk_boolean_handled_accumulator, NULL,
665 _gtk_marshal_BOOLEAN__BOXED_BOXED,
670 tree_view_signals[TEST_COLLAPSE_ROW] =
671 g_signal_new ("test_collapse_row",
672 G_TYPE_FROM_CLASS (object_class),
674 G_STRUCT_OFFSET (GtkTreeViewClass, test_collapse_row),
675 _gtk_boolean_handled_accumulator, NULL,
676 _gtk_marshal_BOOLEAN__BOXED_BOXED,
681 tree_view_signals[ROW_EXPANDED] =
682 g_signal_new ("row_expanded",
683 G_TYPE_FROM_CLASS (object_class),
685 G_STRUCT_OFFSET (GtkTreeViewClass, row_expanded),
687 _gtk_marshal_VOID__BOXED_BOXED,
692 tree_view_signals[ROW_COLLAPSED] =
693 g_signal_new ("row_collapsed",
694 G_TYPE_FROM_CLASS (object_class),
696 G_STRUCT_OFFSET (GtkTreeViewClass, row_collapsed),
698 _gtk_marshal_VOID__BOXED_BOXED,
703 tree_view_signals[COLUMNS_CHANGED] =
704 g_signal_new ("columns_changed",
705 G_TYPE_FROM_CLASS (object_class),
707 G_STRUCT_OFFSET (GtkTreeViewClass, columns_changed),
709 _gtk_marshal_NONE__NONE,
712 tree_view_signals[CURSOR_CHANGED] =
713 g_signal_new ("cursor_changed",
714 G_TYPE_FROM_CLASS (object_class),
716 G_STRUCT_OFFSET (GtkTreeViewClass, cursor_changed),
718 _gtk_marshal_NONE__NONE,
721 tree_view_signals[MOVE_CURSOR] =
722 g_signal_new ("move_cursor",
723 G_TYPE_FROM_CLASS (object_class),
724 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
725 G_STRUCT_OFFSET (GtkTreeViewClass, move_cursor),
727 _gtk_marshal_BOOLEAN__ENUM_INT,
728 GTK_TYPE_BOOL, 2, GTK_TYPE_MOVEMENT_STEP, GTK_TYPE_INT);
730 tree_view_signals[SELECT_ALL] =
731 g_signal_new ("select_all",
732 G_TYPE_FROM_CLASS (object_class),
733 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
734 G_STRUCT_OFFSET (GtkTreeViewClass, select_all),
736 _gtk_marshal_NONE__NONE,
739 tree_view_signals[UNSELECT_ALL] =
740 g_signal_new ("unselect_all",
741 G_TYPE_FROM_CLASS (object_class),
742 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
743 G_STRUCT_OFFSET (GtkTreeViewClass, unselect_all),
745 _gtk_marshal_NONE__NONE,
748 tree_view_signals[SELECT_CURSOR_ROW] =
749 g_signal_new ("select_cursor_row",
750 G_TYPE_FROM_CLASS (object_class),
751 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
752 G_STRUCT_OFFSET (GtkTreeViewClass, select_cursor_row),
754 _gtk_marshal_VOID__BOOLEAN,
758 tree_view_signals[TOGGLE_CURSOR_ROW] =
759 g_signal_new ("toggle_cursor_row",
760 G_TYPE_FROM_CLASS (object_class),
761 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
762 G_STRUCT_OFFSET (GtkTreeViewClass, toggle_cursor_row),
764 _gtk_marshal_NONE__NONE,
767 tree_view_signals[EXPAND_COLLAPSE_CURSOR_ROW] =
768 g_signal_new ("expand_collapse_cursor_row",
769 G_TYPE_FROM_CLASS (object_class),
770 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
771 G_STRUCT_OFFSET (GtkTreeViewClass, expand_collapse_cursor_row),
773 _gtk_marshal_VOID__BOOLEAN_BOOLEAN_BOOLEAN,
774 GTK_TYPE_NONE, 3, GTK_TYPE_BOOL, GTK_TYPE_BOOL, GTK_TYPE_BOOL);
776 tree_view_signals[SELECT_CURSOR_PARENT] =
777 g_signal_new ("select_cursor_parent",
778 G_TYPE_FROM_CLASS (object_class),
779 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
780 G_STRUCT_OFFSET (GtkTreeViewClass, select_cursor_parent),
782 _gtk_marshal_NONE__NONE,
785 tree_view_signals[START_INTERACTIVE_SEARCH] =
786 g_signal_new ("start_interactive_search",
787 G_TYPE_FROM_CLASS (object_class),
788 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
789 G_STRUCT_OFFSET (GtkTreeViewClass, start_interactive_search),
791 _gtk_marshal_NONE__NONE,
795 gtk_tree_view_add_move_binding (binding_set, GDK_Up, 0,
796 GTK_MOVEMENT_DISPLAY_LINES, -1);
798 gtk_tree_view_add_move_binding (binding_set, GDK_Down, 0,
799 GTK_MOVEMENT_DISPLAY_LINES, 1);
801 gtk_tree_view_add_move_binding (binding_set, GDK_p, GDK_CONTROL_MASK,
802 GTK_MOVEMENT_DISPLAY_LINES, -1);
804 gtk_tree_view_add_move_binding (binding_set, GDK_n, GDK_CONTROL_MASK,
805 GTK_MOVEMENT_DISPLAY_LINES, 1);
807 gtk_tree_view_add_move_binding (binding_set, GDK_Home, 0,
808 GTK_MOVEMENT_BUFFER_ENDS, -1);
810 gtk_tree_view_add_move_binding (binding_set, GDK_End, 0,
811 GTK_MOVEMENT_BUFFER_ENDS, 1);
813 gtk_tree_view_add_move_binding (binding_set, GDK_Page_Up, 0,
814 GTK_MOVEMENT_PAGES, -1);
816 gtk_tree_view_add_move_binding (binding_set, GDK_Page_Down, 0,
817 GTK_MOVEMENT_PAGES, 1);
819 gtk_binding_entry_add_signal (binding_set, GDK_Right, 0, "move_cursor", 2,
820 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
823 gtk_binding_entry_add_signal (binding_set, GDK_Left, 0, "move_cursor", 2,
824 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
827 gtk_binding_entry_add_signal (binding_set, GDK_Right, GDK_CONTROL_MASK, "move_cursor", 2,
828 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
831 gtk_binding_entry_add_signal (binding_set, GDK_Left, GDK_CONTROL_MASK, "move_cursor", 2,
832 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
835 gtk_binding_entry_add_signal (binding_set, GDK_Right, GDK_CONTROL_MASK|GDK_SHIFT_MASK, "move_cursor", 2,
836 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
839 gtk_binding_entry_add_signal (binding_set, GDK_Left, GDK_CONTROL_MASK|GDK_SHIFT_MASK, "move_cursor", 2,
840 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
843 gtk_binding_entry_add_signal (binding_set, GDK_space, GDK_CONTROL_MASK, "toggle_cursor_row", 0);
845 gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_CONTROL_MASK, "select_all", 0);
846 gtk_binding_entry_add_signal (binding_set, GDK_slash, GDK_CONTROL_MASK, "select_all", 0);
848 gtk_binding_entry_add_signal (binding_set, GDK_A, GDK_CONTROL_MASK | GDK_SHIFT_MASK, "unselect_all", 0);
849 gtk_binding_entry_add_signal (binding_set, GDK_backslash, GDK_CONTROL_MASK, "unselect_all", 0);
851 gtk_binding_entry_add_signal (binding_set, GDK_space, GDK_SHIFT_MASK, "select_cursor_row", 1,
852 GTK_TYPE_BOOL, TRUE);
854 gtk_binding_entry_add_signal (binding_set, GDK_space, 0, "select_cursor_row", 1,
855 GTK_TYPE_BOOL, TRUE);
857 /* expand and collapse rows */
858 gtk_binding_entry_add_signal (binding_set, GDK_plus, 0, "expand_collapse_cursor_row", 3,
859 GTK_TYPE_BOOL, FALSE,
861 GTK_TYPE_BOOL, FALSE);
862 /* Not doable on US keyboards */
863 gtk_binding_entry_add_signal (binding_set, GDK_plus, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
864 GTK_TYPE_BOOL, FALSE,
866 GTK_TYPE_BOOL, TRUE);
867 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, 0, "expand_collapse_cursor_row", 3,
868 GTK_TYPE_BOOL, FALSE,
870 GTK_TYPE_BOOL, FALSE);
871 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
872 GTK_TYPE_BOOL, FALSE,
874 GTK_TYPE_BOOL, TRUE);
875 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
876 GTK_TYPE_BOOL, FALSE,
878 GTK_TYPE_BOOL, TRUE);
879 gtk_binding_entry_add_signal (binding_set, GDK_Right, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
882 GTK_TYPE_BOOL, TRUE);
884 gtk_binding_entry_add_signal (binding_set, GDK_minus, 0, "expand_collapse_cursor_row", 3,
885 GTK_TYPE_BOOL, FALSE,
886 GTK_TYPE_BOOL, FALSE,
887 GTK_TYPE_BOOL, FALSE);
888 gtk_binding_entry_add_signal (binding_set, GDK_minus, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
889 GTK_TYPE_BOOL, FALSE,
890 GTK_TYPE_BOOL, FALSE,
891 GTK_TYPE_BOOL, TRUE);
892 gtk_binding_entry_add_signal (binding_set, GDK_KP_Subtract, 0, "expand_collapse_cursor_row", 3,
893 GTK_TYPE_BOOL, FALSE,
894 GTK_TYPE_BOOL, FALSE,
895 GTK_TYPE_BOOL, FALSE);
896 gtk_binding_entry_add_signal (binding_set, GDK_KP_Subtract, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
897 GTK_TYPE_BOOL, FALSE,
898 GTK_TYPE_BOOL, FALSE,
899 GTK_TYPE_BOOL, TRUE);
900 gtk_binding_entry_add_signal (binding_set, GDK_Left, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
901 GTK_TYPE_BOOL, FALSE,
902 GTK_TYPE_BOOL, FALSE,
903 GTK_TYPE_BOOL, TRUE);
905 gtk_binding_entry_add_signal (binding_set, GDK_BackSpace, 0, "select_cursor_parent", 0);
907 gtk_binding_entry_add_signal (binding_set, GDK_f, GDK_CONTROL_MASK, "start_interactive_search", 0);
909 gtk_binding_entry_add_signal (binding_set, GDK_F, GDK_CONTROL_MASK, "start_interactive_search", 0);
913 gtk_tree_view_init (GtkTreeView *tree_view)
915 tree_view->priv = g_new0 (GtkTreeViewPrivate, 1);
916 GTK_WIDGET_SET_FLAGS (tree_view, GTK_CAN_FOCUS);
918 tree_view->priv->flags = GTK_TREE_VIEW_IS_LIST | GTK_TREE_VIEW_SHOW_EXPANDERS | GTK_TREE_VIEW_DRAW_KEYFOCUS | GTK_TREE_VIEW_HEADERS_VISIBLE;
920 /* We need some padding */
921 tree_view->priv->dy = 0;
922 tree_view->priv->n_columns = 0;
923 tree_view->priv->header_height = 1;
924 tree_view->priv->x_drag = 0;
925 tree_view->priv->drag_pos = -1;
926 tree_view->priv->header_has_focus = FALSE;
927 tree_view->priv->pressed_button = -1;
928 tree_view->priv->press_start_x = -1;
929 tree_view->priv->press_start_y = -1;
930 tree_view->priv->reorderable = FALSE;
931 tree_view->priv->presize_handler_timer = 0;
932 tree_view->priv->scroll_sync_timer = 0;
933 tree_view->priv->fixed_height_check = 0;
934 gtk_tree_view_set_adjustments (tree_view, NULL, NULL);
935 tree_view->priv->selection = _gtk_tree_selection_new_with_tree_view (tree_view);
936 tree_view->priv->enable_search = TRUE;
937 tree_view->priv->search_column = -1;
938 tree_view->priv->search_dialog_position_func = gtk_tree_view_search_position_func;
939 tree_view->priv->search_equal_func = gtk_tree_view_search_equal_func;
948 gtk_tree_view_set_property (GObject *object,
953 GtkTreeView *tree_view;
955 tree_view = GTK_TREE_VIEW (object);
960 gtk_tree_view_set_model (tree_view, g_value_get_object (value));
962 case PROP_HADJUSTMENT:
963 gtk_tree_view_set_hadjustment (tree_view, g_value_get_object (value));
965 case PROP_VADJUSTMENT:
966 gtk_tree_view_set_vadjustment (tree_view, g_value_get_object (value));
968 case PROP_HEADERS_VISIBLE:
969 gtk_tree_view_set_headers_visible (tree_view, g_value_get_boolean (value));
971 case PROP_HEADERS_CLICKABLE:
972 gtk_tree_view_set_headers_clickable (tree_view, g_value_get_boolean (value));
974 case PROP_EXPANDER_COLUMN:
975 gtk_tree_view_set_expander_column (tree_view, g_value_get_object (value));
977 case PROP_REORDERABLE:
978 gtk_tree_view_set_reorderable (tree_view, g_value_get_boolean (value));
980 case PROP_RULES_HINT:
981 gtk_tree_view_set_rules_hint (tree_view, g_value_get_boolean (value));
983 case PROP_ENABLE_SEARCH:
984 gtk_tree_view_set_enable_search (tree_view, g_value_get_boolean (value));
986 case PROP_SEARCH_COLUMN:
987 gtk_tree_view_set_search_column (tree_view, g_value_get_int (value));
995 gtk_tree_view_get_property (GObject *object,
1000 GtkTreeView *tree_view;
1002 tree_view = GTK_TREE_VIEW (object);
1007 g_value_set_object (value, tree_view->priv->model);
1009 case PROP_HADJUSTMENT:
1010 g_value_set_object (value, tree_view->priv->hadjustment);
1012 case PROP_VADJUSTMENT:
1013 g_value_set_object (value, tree_view->priv->vadjustment);
1015 case PROP_HEADERS_VISIBLE:
1016 g_value_set_boolean (value, gtk_tree_view_get_headers_visible (tree_view));
1018 case PROP_EXPANDER_COLUMN:
1019 g_value_set_object (value, tree_view->priv->expander_column);
1021 case PROP_REORDERABLE:
1022 g_value_set_boolean (value, tree_view->priv->reorderable);
1024 case PROP_RULES_HINT:
1025 g_value_set_boolean (value, tree_view->priv->has_rules);
1027 case PROP_ENABLE_SEARCH:
1028 g_value_set_boolean (value, tree_view->priv->enable_search);
1030 case PROP_SEARCH_COLUMN:
1031 g_value_set_int (value, tree_view->priv->search_column);
1034 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1040 gtk_tree_view_finalize (GObject *object)
1042 GtkTreeView *tree_view = (GtkTreeView *) object;
1044 g_free (tree_view->priv);
1046 if (G_OBJECT_CLASS (parent_class)->finalize)
1047 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
1052 /* GtkObject Methods
1056 gtk_tree_view_destroy (GtkObject *object)
1058 GtkTreeView *tree_view = GTK_TREE_VIEW (object);
1059 GtkWidget *search_dialog;
1062 gtk_tree_view_stop_editing (tree_view, TRUE);
1064 if (tree_view->priv->columns != NULL)
1066 list = tree_view->priv->columns;
1069 GtkTreeViewColumn *column;
1070 column = GTK_TREE_VIEW_COLUMN (list->data);
1072 gtk_tree_view_remove_column (tree_view, column);
1074 tree_view->priv->columns = NULL;
1077 if (tree_view->priv->tree != NULL)
1079 gtk_tree_view_unref_and_check_selection_tree (tree_view, tree_view->priv->tree);
1080 _gtk_rbtree_free (tree_view->priv->tree);
1081 tree_view->priv->tree = NULL;
1084 if (tree_view->priv->selection != NULL)
1086 _gtk_tree_selection_set_tree_view (tree_view->priv->selection, NULL);
1087 g_object_unref (tree_view->priv->selection);
1088 tree_view->priv->selection = NULL;
1091 if (tree_view->priv->scroll_to_path != NULL)
1093 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
1094 tree_view->priv->scroll_to_path = NULL;
1097 if (tree_view->priv->drag_dest_row != NULL)
1099 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
1100 tree_view->priv->drag_dest_row = NULL;
1103 if (tree_view->priv->last_button_press != NULL)
1105 gtk_tree_row_reference_free (tree_view->priv->last_button_press);
1106 tree_view->priv->last_button_press = NULL;
1109 if (tree_view->priv->last_button_press_2 != NULL)
1111 gtk_tree_row_reference_free (tree_view->priv->last_button_press_2);
1112 tree_view->priv->last_button_press_2 = NULL;
1115 if (tree_view->priv->top_row != NULL)
1117 gtk_tree_row_reference_free (tree_view->priv->top_row);
1118 tree_view->priv->top_row = NULL;
1121 if (tree_view->priv->column_drop_func_data &&
1122 tree_view->priv->column_drop_func_data_destroy)
1124 (* tree_view->priv->column_drop_func_data_destroy) (tree_view->priv->column_drop_func_data);
1125 tree_view->priv->column_drop_func_data = NULL;
1128 if (tree_view->priv->destroy_count_destroy &&
1129 tree_view->priv->destroy_count_data)
1131 (* tree_view->priv->destroy_count_destroy) (tree_view->priv->destroy_count_data);
1132 tree_view->priv->destroy_count_data = NULL;
1135 gtk_tree_row_reference_free (tree_view->priv->cursor);
1136 tree_view->priv->cursor = NULL;
1138 gtk_tree_row_reference_free (tree_view->priv->anchor);
1139 tree_view->priv->anchor = NULL;
1141 /* destroy interactive search dialog */
1142 search_dialog = gtk_object_get_data (GTK_OBJECT (tree_view),
1143 GTK_TREE_VIEW_SEARCH_DIALOG_KEY);
1145 gtk_tree_view_search_dialog_destroy (search_dialog,
1148 if (tree_view->priv->search_user_data)
1150 (* tree_view->priv->search_destroy) (tree_view->priv->search_user_data);
1151 tree_view->priv->search_user_data = NULL;
1154 gtk_tree_view_set_model (tree_view, NULL);
1156 if (GTK_OBJECT_CLASS (parent_class)->destroy)
1157 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
1162 /* GtkWidget Methods
1165 /* GtkWidget::map helper */
1167 gtk_tree_view_map_buttons (GtkTreeView *tree_view)
1171 g_return_if_fail (GTK_WIDGET_MAPPED (tree_view));
1173 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
1175 GtkTreeViewColumn *column;
1177 for (list = tree_view->priv->columns; list; list = list->next)
1179 column = list->data;
1180 if (GTK_WIDGET_VISIBLE (column->button) &&
1181 !GTK_WIDGET_MAPPED (column->button))
1182 gtk_widget_map (column->button);
1184 for (list = tree_view->priv->columns; list; list = list->next)
1186 column = list->data;
1187 if (column->visible == FALSE)
1189 if (column->resizable)
1191 gdk_window_raise (column->window);
1192 gdk_window_show (column->window);
1195 gdk_window_hide (column->window);
1197 gdk_window_show (tree_view->priv->header_window);
1202 gtk_tree_view_map (GtkWidget *widget)
1205 GtkTreeView *tree_view;
1207 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1209 tree_view = GTK_TREE_VIEW (widget);
1211 GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
1213 tmp_list = tree_view->priv->children;
1216 GtkTreeViewChild *child = tmp_list->data;
1217 tmp_list = tmp_list->next;
1219 if (GTK_WIDGET_VISIBLE (child->widget))
1221 if (!GTK_WIDGET_MAPPED (child->widget))
1222 gtk_widget_map (child->widget);
1225 gdk_window_show (tree_view->priv->bin_window);
1227 gtk_tree_view_map_buttons (tree_view);
1229 gdk_window_show (widget->window);
1233 gtk_tree_view_realize (GtkWidget *widget)
1236 GtkTreeView *tree_view;
1238 GdkWindowAttr attributes;
1239 gint attributes_mask;
1241 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1243 tree_view = GTK_TREE_VIEW (widget);
1245 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
1247 /* Make the main, clipping window */
1248 attributes.window_type = GDK_WINDOW_CHILD;
1249 attributes.x = widget->allocation.x;
1250 attributes.y = widget->allocation.y;
1251 attributes.width = widget->allocation.width;
1252 attributes.height = widget->allocation.height;
1253 attributes.wclass = GDK_INPUT_OUTPUT;
1254 attributes.visual = gtk_widget_get_visual (widget);
1255 attributes.colormap = gtk_widget_get_colormap (widget);
1256 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK;
1258 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
1260 widget->window = gdk_window_new (gtk_widget_get_parent_window (widget),
1261 &attributes, attributes_mask);
1262 gdk_window_set_user_data (widget->window, widget);
1264 /* Make the window for the tree */
1266 attributes.y = TREE_VIEW_HEADER_HEIGHT (tree_view);
1267 attributes.width = tree_view->priv->width;
1268 attributes.height = widget->allocation.height;
1269 attributes.event_mask = GDK_EXPOSURE_MASK |
1271 GDK_POINTER_MOTION_MASK |
1272 GDK_ENTER_NOTIFY_MASK |
1273 GDK_LEAVE_NOTIFY_MASK |
1274 GDK_BUTTON_PRESS_MASK |
1275 GDK_BUTTON_RELEASE_MASK |
1276 gtk_widget_get_events (widget);
1278 tree_view->priv->bin_window = gdk_window_new (widget->window,
1279 &attributes, attributes_mask);
1280 gdk_window_set_user_data (tree_view->priv->bin_window, widget);
1282 /* Make the column header window */
1285 attributes.width = MAX (tree_view->priv->width, widget->allocation.width);
1286 attributes.height = tree_view->priv->header_height;
1287 attributes.event_mask = (GDK_EXPOSURE_MASK |
1289 GDK_BUTTON_PRESS_MASK |
1290 GDK_BUTTON_RELEASE_MASK |
1291 GDK_KEY_PRESS_MASK |
1292 GDK_KEY_RELEASE_MASK) |
1293 gtk_widget_get_events (widget);
1295 tree_view->priv->header_window = gdk_window_new (widget->window,
1296 &attributes, attributes_mask);
1297 gdk_window_set_user_data (tree_view->priv->header_window, widget);
1300 values.foreground = (widget->style->white.pixel==0 ?
1301 widget->style->black:widget->style->white);
1302 values.function = GDK_XOR;
1303 values.subwindow_mode = GDK_INCLUDE_INFERIORS;
1305 /* Add them all up. */
1306 widget->style = gtk_style_attach (widget->style, widget->window);
1307 gdk_window_set_background (widget->window, &widget->style->base[widget->state]);
1308 gdk_window_set_background (tree_view->priv->bin_window, &widget->style->base[widget->state]);
1309 gtk_style_set_background (widget->style, tree_view->priv->header_window, GTK_STATE_NORMAL);
1311 tmp_list = tree_view->priv->children;
1314 GtkTreeViewChild *child = tmp_list->data;
1315 tmp_list = tmp_list->next;
1317 gtk_widget_set_parent_window (child->widget, tree_view->priv->bin_window);
1320 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
1321 _gtk_tree_view_column_realize_button (GTK_TREE_VIEW_COLUMN (tmp_list->data));
1323 install_presize_handler (tree_view);
1327 gtk_tree_view_unrealize (GtkWidget *widget)
1329 GtkTreeView *tree_view;
1332 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1334 tree_view = GTK_TREE_VIEW (widget);
1336 if (tree_view->priv->scroll_timeout != 0)
1338 gtk_timeout_remove (tree_view->priv->scroll_timeout);
1339 tree_view->priv->scroll_timeout = 0;
1342 if (tree_view->priv->open_dest_timeout != 0)
1344 gtk_timeout_remove (tree_view->priv->open_dest_timeout);
1345 tree_view->priv->open_dest_timeout = 0;
1348 if (tree_view->priv->expand_collapse_timeout != 0)
1350 gtk_timeout_remove (tree_view->priv->expand_collapse_timeout);
1351 tree_view->priv->expand_collapse_timeout = 0;
1354 if (tree_view->priv->presize_handler_timer != 0)
1356 gtk_timeout_remove (tree_view->priv->presize_handler_timer);
1357 tree_view->priv->presize_handler_timer = 0;
1360 if (tree_view->priv->validate_rows_timer != 0)
1362 gtk_timeout_remove (tree_view->priv->validate_rows_timer);
1363 tree_view->priv->validate_rows_timer = 0;
1366 if (tree_view->priv->scroll_sync_timer != 0)
1368 gtk_timeout_remove (tree_view->priv->scroll_sync_timer);
1369 tree_view->priv->scroll_sync_timer = 0;
1372 for (list = tree_view->priv->columns; list; list = list->next)
1373 _gtk_tree_view_column_unrealize_button (GTK_TREE_VIEW_COLUMN (list->data));
1375 gdk_window_set_user_data (tree_view->priv->bin_window, NULL);
1376 gdk_window_destroy (tree_view->priv->bin_window);
1377 tree_view->priv->bin_window = NULL;
1379 gdk_window_set_user_data (tree_view->priv->header_window, NULL);
1380 gdk_window_destroy (tree_view->priv->header_window);
1381 tree_view->priv->header_window = NULL;
1383 if (tree_view->priv->drag_window)
1385 gdk_window_set_user_data (tree_view->priv->drag_window, NULL);
1386 gdk_window_destroy (tree_view->priv->drag_window);
1387 tree_view->priv->drag_window = NULL;
1390 if (tree_view->priv->drag_highlight_window)
1392 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, NULL);
1393 gdk_window_destroy (tree_view->priv->drag_highlight_window);
1394 tree_view->priv->drag_highlight_window = NULL;
1397 /* GtkWidget::unrealize destroys children and widget->window */
1398 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
1399 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
1402 /* GtkWidget::size_request helper */
1404 gtk_tree_view_size_request_columns (GtkTreeView *tree_view)
1408 tree_view->priv->header_height = 0;
1410 if (tree_view->priv->model)
1412 for (list = tree_view->priv->columns; list; list = list->next)
1414 GtkRequisition requisition;
1415 GtkTreeViewColumn *column = list->data;
1417 if (column->button == NULL)
1420 column = list->data;
1422 gtk_widget_size_request (column->button, &requisition);
1423 column->button_request = requisition.width;
1424 tree_view->priv->header_height = MAX (tree_view->priv->header_height, requisition.height);
1431 gtk_tree_view_update_size (GtkTreeView *tree_view)
1434 GtkTreeViewColumn *column;
1437 if (tree_view->priv->model == NULL)
1439 tree_view->priv->width = 0;
1440 tree_view->priv->height = 0;
1444 tree_view->priv->width = 0;
1445 /* keep this in sync with size_allocate below */
1446 for (list = tree_view->priv->columns, i = 0; list; list = list->next, i++)
1448 gint real_requested_width = 0;
1449 column = list->data;
1450 if (!column->visible)
1453 if (column->use_resized_width)
1455 real_requested_width = column->resized_width;
1457 else if (column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
1459 real_requested_width = column->fixed_width;
1461 else if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
1463 real_requested_width = MAX (column->requested_width, column->button_request);
1467 real_requested_width = column->requested_width;
1470 if (column->min_width != -1)
1471 real_requested_width = MAX (real_requested_width, column->min_width);
1472 if (column->max_width != -1)
1473 real_requested_width = MIN (real_requested_width, column->max_width);
1475 tree_view->priv->width += real_requested_width;
1478 if (tree_view->priv->tree == NULL)
1479 tree_view->priv->height = 0;
1481 tree_view->priv->height = tree_view->priv->tree->root->offset;
1485 gtk_tree_view_size_request (GtkWidget *widget,
1486 GtkRequisition *requisition)
1488 GtkTreeView *tree_view;
1491 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1493 tree_view = GTK_TREE_VIEW (widget);
1495 /* we validate 50 rows initially just to make sure we have some size */
1496 /* in practice, with a lot of static lists, this should get a good width */
1497 do_validate_rows (tree_view);
1498 gtk_tree_view_size_request_columns (tree_view);
1499 gtk_tree_view_update_size (GTK_TREE_VIEW (widget));
1501 requisition->width = tree_view->priv->width;
1502 requisition->height = tree_view->priv->height + TREE_VIEW_HEADER_HEIGHT (tree_view);
1504 tmp_list = tree_view->priv->children;
1508 GtkTreeViewChild *child = tmp_list->data;
1509 GtkRequisition child_requisition;
1511 tmp_list = tmp_list->next;
1513 if (GTK_WIDGET_VISIBLE (child->widget))
1514 gtk_widget_size_request (child->widget, &child_requisition);
1518 /* GtkWidget::size_allocate helper */
1520 gtk_tree_view_size_allocate_columns (GtkWidget *widget)
1522 GtkTreeView *tree_view;
1523 GList *list, *last_column;
1524 GtkTreeViewColumn *column;
1525 GtkAllocation allocation;
1528 tree_view = GTK_TREE_VIEW (widget);
1530 for (last_column = g_list_last (tree_view->priv->columns);
1531 last_column && !(GTK_TREE_VIEW_COLUMN (last_column->data)->visible);
1532 last_column = last_column->prev)
1534 if (last_column == NULL)
1538 allocation.height = tree_view->priv->header_height;
1540 for (list = tree_view->priv->columns; list != last_column->next; list = list->next)
1542 gint real_requested_width = 0;
1543 column = list->data;
1544 if (!column->visible)
1547 /* We need to handle the dragged button specially.
1549 if (column == tree_view->priv->drag_column)
1551 GtkAllocation drag_allocation;
1552 gdk_window_get_size (tree_view->priv->drag_window,
1553 &(drag_allocation.width), &(drag_allocation.height));
1554 drag_allocation.x = 0;
1555 drag_allocation.y = 0;
1556 gtk_widget_size_allocate (tree_view->priv->drag_column->button, &drag_allocation);
1557 width += drag_allocation.width;
1561 if (column->use_resized_width)
1563 real_requested_width = column->resized_width;
1565 else if (column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
1567 real_requested_width = column->fixed_width;
1569 else if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
1571 real_requested_width = MAX (column->requested_width, column->button_request);
1575 real_requested_width = column->requested_width;
1576 if (real_requested_width < 0)
1577 real_requested_width = 0;
1580 if (column->min_width != -1)
1581 real_requested_width = MAX (real_requested_width, column->min_width);
1582 if (column->max_width != -1)
1583 real_requested_width = MIN (real_requested_width, column->max_width);
1585 allocation.x = width;
1586 column->width = real_requested_width;
1587 if (list == last_column &&
1588 width + real_requested_width < widget->allocation.width)
1590 column->width += (widget->allocation.width - column->width - width);
1592 g_object_notify (G_OBJECT (column), "width");
1593 allocation.width = column->width;
1594 width += column->width;
1595 gtk_widget_size_allocate (column->button, &allocation);
1597 gdk_window_move_resize (column->window,
1598 allocation.x + allocation.width - TREE_VIEW_DRAG_WIDTH/2,
1600 TREE_VIEW_DRAG_WIDTH, allocation.height);
1605 gtk_tree_view_size_allocate (GtkWidget *widget,
1606 GtkAllocation *allocation)
1609 GtkTreeView *tree_view;
1611 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1613 widget->allocation = *allocation;
1615 tree_view = GTK_TREE_VIEW (widget);
1617 tmp_list = tree_view->priv->children;
1621 GtkAllocation allocation;
1623 GtkTreeViewChild *child = tmp_list->data;
1624 tmp_list = tmp_list->next;
1626 /* totally ignore our childs requisition */
1627 allocation.x = child->x;
1628 allocation.y = child->y;
1629 allocation.width = child->width;
1630 allocation.height = child->height;
1631 gtk_widget_size_allocate (child->widget, &allocation);
1635 tree_view->priv->hadjustment->page_size = allocation->width;
1636 tree_view->priv->hadjustment->page_increment = allocation->width * 0.9;
1637 tree_view->priv->hadjustment->step_increment = allocation->width * 0.1;
1638 tree_view->priv->hadjustment->lower = 0;
1639 tree_view->priv->hadjustment->upper = MAX (tree_view->priv->hadjustment->page_size, tree_view->priv->width);
1641 if (tree_view->priv->hadjustment->value + allocation->width > tree_view->priv->width)
1642 tree_view->priv->hadjustment->value = MAX (tree_view->priv->width - allocation->width, 0);
1643 gtk_adjustment_changed (tree_view->priv->hadjustment);
1645 tree_view->priv->vadjustment->page_size = allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view);
1646 tree_view->priv->vadjustment->step_increment = tree_view->priv->vadjustment->page_size * 0.1;
1647 tree_view->priv->vadjustment->page_increment = tree_view->priv->vadjustment->page_size * 0.9;
1648 tree_view->priv->vadjustment->lower = 0;
1649 tree_view->priv->vadjustment->upper = MAX (tree_view->priv->vadjustment->page_size, tree_view->priv->height);
1651 if (tree_view->priv->vadjustment->value + allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view) > tree_view->priv->height)
1652 gtk_adjustment_set_value (tree_view->priv->vadjustment,
1653 MAX (tree_view->priv->height - tree_view->priv->vadjustment->page_size, 0));
1654 gtk_adjustment_changed (tree_view->priv->vadjustment);
1656 if (GTK_WIDGET_REALIZED (widget))
1658 gdk_window_move_resize (widget->window,
1659 allocation->x, allocation->y,
1660 allocation->width, allocation->height);
1661 gdk_window_move_resize (tree_view->priv->header_window,
1662 - (gint) tree_view->priv->hadjustment->value,
1664 MAX (tree_view->priv->width, allocation->width),
1665 tree_view->priv->header_height);
1666 gdk_window_move_resize (tree_view->priv->bin_window,
1667 - (gint) tree_view->priv->hadjustment->value,
1668 TREE_VIEW_HEADER_HEIGHT (tree_view),
1669 MAX (tree_view->priv->width, allocation->width),
1670 allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view));
1673 gtk_tree_view_size_allocate_columns (widget);
1677 gtk_tree_view_button_press (GtkWidget *widget,
1678 GdkEventButton *event)
1680 GtkTreeView *tree_view;
1682 GtkTreeViewColumn *column = NULL;
1684 GdkRectangle background_area;
1685 GdkRectangle cell_area;
1686 gint vertical_separator;
1687 gint horizontal_separator;
1689 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
1690 g_return_val_if_fail (event != NULL, FALSE);
1692 tree_view = GTK_TREE_VIEW (widget);
1693 gtk_tree_view_stop_editing (tree_view, FALSE);
1694 gtk_widget_style_get (widget,
1695 "vertical_separator", &vertical_separator,
1696 "horizontal_separator", &horizontal_separator,
1699 if (event->window == tree_view->priv->bin_window &&
1700 tree_view->priv->tree != NULL)
1710 gint pre_val, aft_val;
1711 GtkTreeViewColumn *column = NULL;
1712 gint column_handled_click = FALSE;
1713 gboolean emit_row_activated = FALSE;
1715 if (!GTK_WIDGET_HAS_FOCUS (widget))
1716 gtk_widget_grab_focus (widget);
1717 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
1719 /* are we in an arrow? */
1720 if (tree_view->priv->prelight_node &&
1721 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
1723 if (event->button == 1)
1725 gtk_grab_add (widget);
1726 tree_view->priv->button_pressed_node = tree_view->priv->prelight_node;
1727 tree_view->priv->button_pressed_tree = tree_view->priv->prelight_tree;
1728 gtk_tree_view_draw_arrow (GTK_TREE_VIEW (widget),
1729 tree_view->priv->prelight_tree,
1730 tree_view->priv->prelight_node,
1737 /* find the node that was clicked */
1738 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
1741 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
1744 /* We clicked in dead space */
1747 /* Get the path and the node */
1748 path = _gtk_tree_view_find_path (tree_view, tree, node);
1749 depth = gtk_tree_path_get_depth (path);
1750 background_area.y = y_offset + event->y;
1751 background_area.height = MAX (GTK_RBNODE_GET_HEIGHT (node),
1752 tree_view->priv->expander_size);
1753 background_area.x = 0;
1755 /* Let the column have a chance at selecting it. */
1756 for (list = tree_view->priv->columns; list; list = list->next)
1758 column = list->data;
1760 if (!column->visible)
1763 background_area.width = column->width;
1764 if ((background_area.x > (gint) event->x) ||
1765 (background_area.x + background_area.width <= (gint) event->x))
1767 background_area.x += background_area.width;
1771 /* we found the focus column */
1772 cell_area = background_area;
1773 cell_area.width -= horizontal_separator;
1774 cell_area.height -= vertical_separator;
1775 cell_area.x += horizontal_separator/2;
1776 cell_area.y += vertical_separator/2;
1777 if (gtk_tree_view_is_expander_column (tree_view, column) &&
1778 TREE_VIEW_DRAW_EXPANDERS(tree_view))
1780 cell_area.x += depth * tree_view->priv->expander_size;
1781 cell_area.width -= depth * tree_view->priv->expander_size;
1789 /* decide if we edit */
1790 if (event->type == GDK_BUTTON_PRESS &&
1791 !(event->state & gtk_accelerator_get_default_mod_mask ()))
1793 GtkTreePath *anchor;
1796 if (tree_view->priv->anchor)
1798 anchor = gtk_tree_row_reference_get_path (tree_view->priv->anchor);
1799 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
1800 gtk_tree_view_column_cell_set_cell_data (column,
1801 tree_view->priv->model,
1803 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
1804 node->children?TRUE:FALSE);
1809 if ((anchor && !gtk_tree_path_compare (anchor, path))
1810 || !_gtk_tree_view_column_has_editable_cell (column))
1812 GtkCellEditable *cell_editable = NULL;
1814 /* FIXME: get the right flags */
1817 path_string = gtk_tree_path_to_string (path);
1819 if (_gtk_tree_view_column_cell_event (column,
1826 if (cell_editable != NULL)
1832 _gtk_tree_view_column_get_neighbor_sizes (column, _gtk_tree_view_column_get_editable_cell (column), &left, &right);
1835 area.width -= right + left;
1837 gtk_tree_view_real_start_editing (tree_view,
1844 gtk_tree_path_free (path);
1845 gtk_tree_path_free (anchor);
1848 column_handled_click = TRUE;
1850 g_free (path_string);
1853 gtk_tree_path_free (anchor);
1857 pre_val = tree_view->priv->vadjustment->value;
1859 tree_view->priv->focus_column = column;
1860 if (event->state & GDK_CONTROL_MASK)
1862 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
1863 gtk_tree_view_real_toggle_cursor_row (tree_view);
1865 else if (event->state & GDK_SHIFT_MASK)
1867 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
1868 gtk_tree_view_real_select_cursor_row (tree_view, FALSE);
1872 gtk_tree_view_real_set_cursor (tree_view, path, TRUE, TRUE);
1875 /* the treeview may have been scrolled because of _set_cursor,
1879 aft_val = tree_view->priv->vadjustment->value;
1880 dval = pre_val - aft_val;
1882 cell_area.y += dval;
1883 background_area.y += dval;
1885 /* Save press to possibly begin a drag
1887 if (!column_handled_click &&
1888 tree_view->priv->pressed_button < 0)
1890 tree_view->priv->pressed_button = event->button;
1891 tree_view->priv->press_start_x = event->x;
1892 tree_view->priv->press_start_y = event->y;
1895 if (event->button == 1 && event->type == GDK_2BUTTON_PRESS &&
1896 tree_view->priv->last_button_press)
1900 lsc = gtk_tree_row_reference_get_path (tree_view->priv->last_button_press);
1902 if (tree_view->priv->last_button_press)
1903 gtk_tree_row_reference_free (tree_view->priv->last_button_press);
1904 if (tree_view->priv->last_button_press_2)
1905 gtk_tree_row_reference_free (tree_view->priv->last_button_press_2);
1906 tree_view->priv->last_button_press = NULL;
1907 tree_view->priv->last_button_press_2 = NULL;
1911 if (!gtk_tree_path_compare (lsc, path))
1912 emit_row_activated = TRUE;
1913 gtk_tree_path_free (lsc);
1916 else if (event->button == 1 && event->type == GDK_BUTTON_PRESS)
1918 if (tree_view->priv->last_button_press)
1919 gtk_tree_row_reference_free (tree_view->priv->last_button_press);
1920 tree_view->priv->last_button_press = tree_view->priv->last_button_press_2;
1921 tree_view->priv->last_button_press_2 = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
1924 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
1926 if (emit_row_activated)
1928 gtk_grab_remove (widget);
1929 gtk_tree_view_row_activated (tree_view, path, column);
1932 gtk_tree_path_free (path);
1937 /* We didn't click in the window. Let's check to see if we clicked on a column resize window.
1939 for (i = 0, list = tree_view->priv->columns; list; list = list->next, i++)
1941 column = list->data;
1942 if (event->window == column->window &&
1943 column->resizable &&
1948 if (event->type == GDK_2BUTTON_PRESS &&
1949 gtk_tree_view_column_get_sizing (column) != GTK_TREE_VIEW_COLUMN_AUTOSIZE)
1951 _gtk_tree_view_column_autosize (tree_view, column);
1955 if (gdk_pointer_grab (column->window, FALSE,
1956 GDK_POINTER_MOTION_HINT_MASK |
1957 GDK_BUTTON1_MOTION_MASK |
1958 GDK_BUTTON_RELEASE_MASK,
1959 NULL, NULL, event->time))
1962 gtk_grab_add (widget);
1963 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
1964 column->resized_width = column->width;
1965 column->use_resized_width = TRUE;
1967 /* block attached dnd signal handler */
1968 drag_data = gtk_object_get_data (GTK_OBJECT (widget), "gtk-site-data");
1970 gtk_signal_handler_block_by_data (GTK_OBJECT (widget), drag_data);
1972 if (!GTK_WIDGET_HAS_FOCUS (widget))
1973 gtk_widget_grab_focus (widget);
1975 tree_view->priv->drag_pos = i;
1976 tree_view->priv->x_drag = (column->button->allocation.x + column->button->allocation.width);
1983 /* GtkWidget::button_release_event helper */
1985 gtk_tree_view_button_release_drag_column (GtkWidget *widget,
1986 GdkEventButton *event)
1988 GtkTreeView *tree_view;
1990 tree_view = GTK_TREE_VIEW (widget);
1992 gdk_pointer_ungrab (GDK_CURRENT_TIME);
1993 gdk_keyboard_ungrab (GDK_CURRENT_TIME);
1995 /* Move the button back */
1996 g_object_ref (tree_view->priv->drag_column->button);
1997 gtk_container_remove (GTK_CONTAINER (tree_view), tree_view->priv->drag_column->button);
1998 gtk_widget_set_parent_window (tree_view->priv->drag_column->button, tree_view->priv->header_window);
1999 gtk_widget_set_parent (tree_view->priv->drag_column->button, GTK_WIDGET (tree_view));
2000 g_object_unref (tree_view->priv->drag_column->button);
2001 gtk_widget_queue_resize (widget);
2002 if (tree_view->priv->drag_column->resizable)
2004 gdk_window_raise (tree_view->priv->drag_column->window);
2005 gdk_window_show (tree_view->priv->drag_column->window);
2008 gdk_window_hide (tree_view->priv->drag_column->window);
2010 gtk_widget_grab_focus (tree_view->priv->drag_column->button);
2012 if (tree_view->priv->cur_reorder &&
2013 tree_view->priv->cur_reorder->left_column != tree_view->priv->drag_column)
2014 gtk_tree_view_move_column_after (tree_view, tree_view->priv->drag_column,
2015 tree_view->priv->cur_reorder->left_column);
2016 tree_view->priv->drag_column = NULL;
2017 gdk_window_hide (tree_view->priv->drag_window);
2019 g_list_foreach (tree_view->priv->column_drag_info, (GFunc) g_free, NULL);
2020 g_list_free (tree_view->priv->column_drag_info);
2021 tree_view->priv->column_drag_info = NULL;
2023 gdk_window_hide (tree_view->priv->drag_highlight_window);
2025 /* Reset our flags */
2026 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_UNSET;
2027 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
2032 /* GtkWidget::button_release_event helper */
2034 gtk_tree_view_button_release_column_resize (GtkWidget *widget,
2035 GdkEventButton *event)
2037 GtkTreeView *tree_view;
2042 tree_view = GTK_TREE_VIEW (widget);
2044 i = tree_view->priv->drag_pos;
2045 tree_view->priv->drag_pos = -1;
2047 /* unblock attached dnd signal handler */
2048 drag_data = gtk_object_get_data (GTK_OBJECT (widget), "gtk-site-data");
2050 gtk_signal_handler_unblock_by_data (GTK_OBJECT (widget), drag_data);
2052 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
2053 gtk_widget_get_pointer (widget, &x, NULL);
2054 gtk_grab_remove (widget);
2055 gdk_pointer_ungrab (event->time);
2061 gtk_tree_view_button_release (GtkWidget *widget,
2062 GdkEventButton *event)
2064 GtkTreeView *tree_view;
2066 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2067 g_return_val_if_fail (event != NULL, FALSE);
2069 tree_view = GTK_TREE_VIEW (widget);
2071 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
2072 return gtk_tree_view_button_release_drag_column (widget, event);
2074 if (tree_view->priv->pressed_button == event->button)
2075 tree_view->priv->pressed_button = -1;
2077 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
2078 return gtk_tree_view_button_release_column_resize (widget, event);
2080 if (tree_view->priv->button_pressed_node == NULL)
2083 if (event->button == 1)
2085 gtk_grab_remove (widget);
2086 if (tree_view->priv->button_pressed_node == tree_view->priv->prelight_node &&
2087 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
2089 GtkTreePath *path = NULL;
2091 path = _gtk_tree_view_find_path (tree_view,
2092 tree_view->priv->button_pressed_tree,
2093 tree_view->priv->button_pressed_node);
2094 /* Actually activate the node */
2095 if (tree_view->priv->button_pressed_node->children == NULL)
2096 gtk_tree_view_real_expand_row (tree_view, path,
2097 tree_view->priv->button_pressed_tree,
2098 tree_view->priv->button_pressed_node,
2101 gtk_tree_view_real_collapse_row (GTK_TREE_VIEW (widget), path,
2102 tree_view->priv->button_pressed_tree,
2103 tree_view->priv->button_pressed_node, TRUE);
2104 gtk_tree_path_free (path);
2107 tree_view->priv->button_pressed_tree = NULL;
2108 tree_view->priv->button_pressed_node = NULL;
2115 /* GtkWidget::motion_event function set.
2119 coords_are_over_arrow (GtkTreeView *tree_view,
2122 /* these are in window coords */
2129 if (!GTK_WIDGET_REALIZED (tree_view))
2132 if ((node->flags & GTK_RBNODE_IS_PARENT) == 0)
2135 arrow.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
2137 arrow.height = MAX (BACKGROUND_HEIGHT (node), tree_view->priv->expander_size);
2139 gtk_tree_view_get_arrow_xrange (tree_view, tree, &arrow.x, &x2);
2141 arrow.width = x2 - arrow.x;
2143 return (x >= arrow.x &&
2144 x < (arrow.x + arrow.width) &&
2146 y < (arrow.y + arrow.height));
2150 do_unprelight (GtkTreeView *tree_view,
2151 /* these are in tree window coords */
2155 if (tree_view->priv->prelight_node == NULL)
2158 GTK_RBNODE_UNSET_FLAG (tree_view->priv->prelight_node, GTK_RBNODE_IS_PRELIT);
2160 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT) &&
2161 !coords_are_over_arrow (tree_view,
2162 tree_view->priv->prelight_tree,
2163 tree_view->priv->prelight_node,
2166 /* We need to unprelight the old arrow. */
2168 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
2170 gtk_tree_view_draw_arrow (tree_view,
2171 tree_view->priv->prelight_tree,
2172 tree_view->priv->prelight_node,
2178 tree_view->priv->prelight_node = NULL;
2179 tree_view->priv->prelight_tree = NULL;
2183 do_prelight (GtkTreeView *tree_view,
2186 /* these are in tree_window coords */
2190 if (coords_are_over_arrow (tree_view, tree, node, x, y))
2192 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
2195 tree_view->priv->prelight_node = node;
2196 tree_view->priv->prelight_tree = tree;
2198 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PRELIT);
2202 ensure_unprelighted (GtkTreeView *tree_view)
2204 do_unprelight (tree_view, -1000, -1000); /* coords not possibly over an arrow */
2205 g_assert (tree_view->priv->prelight_node == NULL);
2211 /* Our motion arrow is either a box (in the case of the original spot)
2212 * or an arrow. It is expander_size wide.
2235 gtk_tree_view_motion_draw_column_motion_arrow (GtkTreeView *tree_view)
2237 GtkTreeViewColumnReorder *reorder = tree_view->priv->cur_reorder;
2238 GtkWidget *widget = GTK_WIDGET (tree_view);
2239 GdkBitmap *mask = NULL;
2244 gint arrow_type = DRAG_COLUMN_WINDOW_STATE_UNSET;
2245 GdkWindowAttr attributes;
2246 guint attributes_mask;
2249 reorder->left_column == tree_view->priv->drag_column ||
2250 reorder->right_column == tree_view->priv->drag_column)
2251 arrow_type = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
2252 else if (reorder->left_column || reorder->right_column)
2254 GdkRectangle visible_rect;
2255 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
2256 if (reorder->left_column)
2257 x = reorder->left_column->button->allocation.x + reorder->left_column->button->allocation.width;
2259 x = reorder->right_column->button->allocation.x;
2261 if (x < visible_rect.x)
2262 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT;
2263 else if (x > visible_rect.x + visible_rect.width)
2264 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT;
2266 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW;
2269 /* We want to draw the rectangle over the initial location. */
2270 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
2275 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
2278 if (tree_view->priv->drag_highlight_window)
2279 gdk_window_destroy (tree_view->priv->drag_highlight_window);
2281 attributes.window_type = GDK_WINDOW_CHILD;
2282 attributes.wclass = GDK_INPUT_OUTPUT;
2283 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
2284 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
2285 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
2286 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
2287 tree_view->priv->drag_highlight_window = gdk_window_new (tree_view->priv->header_window, &attributes, attributes_mask);
2288 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
2290 width = tree_view->priv->drag_column->button->allocation.width;
2291 height = tree_view->priv->drag_column->button->allocation.height;
2292 gdk_window_move_resize (tree_view->priv->drag_highlight_window,
2293 tree_view->priv->drag_column_x, 0, width, height);
2295 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
2296 gc = gdk_gc_new (mask);
2298 gdk_gc_set_foreground (gc, &col);
2299 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
2301 gdk_gc_set_foreground(gc, &col);
2302 gdk_draw_rectangle (mask, gc, TRUE, 2, 2, width - 4, height - 4);
2303 gdk_gc_destroy (gc);
2305 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
2307 if (mask) gdk_pixmap_unref (mask);
2308 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
2311 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW)
2317 width = tree_view->priv->expander_size;
2319 /* Get x, y, width, height of arrow */
2320 gdk_window_get_origin (tree_view->priv->header_window, &x, &y);
2321 if (reorder->left_column)
2323 x += reorder->left_column->button->allocation.x + reorder->left_column->button->allocation.width - width/2;
2324 height = reorder->left_column->button->allocation.height;
2328 x += reorder->right_column->button->allocation.x - width/2;
2329 height = reorder->right_column->button->allocation.height;
2331 y -= tree_view->priv->expander_size/2; /* The arrow takes up only half the space */
2332 height += tree_view->priv->expander_size;
2334 /* Create the new window */
2335 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW)
2337 if (tree_view->priv->drag_highlight_window)
2338 gdk_window_destroy (tree_view->priv->drag_highlight_window);
2340 attributes.window_type = GDK_WINDOW_TEMP;
2341 attributes.wclass = GDK_INPUT_OUTPUT;
2342 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
2343 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
2344 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
2345 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
2346 attributes.width = width;
2347 attributes.height = height;
2348 tree_view->priv->drag_highlight_window = gdk_window_new (NULL, &attributes, attributes_mask);
2349 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
2351 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
2352 gc = gdk_gc_new (mask);
2354 gdk_gc_set_foreground (gc, &col);
2355 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
2357 /* Draw the 2 arrows as per above */
2359 gdk_gc_set_foreground (gc, &col);
2360 for (i = 0; i < width; i ++)
2362 if (i == (width/2 - 1))
2364 gdk_draw_line (mask, gc, i, j, i, height - j);
2365 if (i < (width/2 - 1))
2370 gdk_gc_destroy (gc);
2371 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
2373 if (mask) gdk_pixmap_unref (mask);
2376 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ARROW;
2377 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
2379 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT ||
2380 arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
2386 width = tree_view->priv->expander_size;
2388 /* Get x, y, width, height of arrow */
2389 width = width/2; /* remember, the arrow only takes half the available width */
2390 gdk_window_get_origin (widget->window, &x, &y);
2391 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
2392 x += widget->allocation.width - width;
2394 if (reorder->left_column)
2395 height = reorder->left_column->button->allocation.height;
2397 height = reorder->right_column->button->allocation.height;
2399 y -= tree_view->priv->expander_size;
2400 height += 2*tree_view->priv->expander_size;
2402 /* Create the new window */
2403 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT &&
2404 tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
2406 if (tree_view->priv->drag_highlight_window)
2407 gdk_window_destroy (tree_view->priv->drag_highlight_window);
2409 attributes.window_type = GDK_WINDOW_TEMP;
2410 attributes.wclass = GDK_INPUT_OUTPUT;
2411 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
2412 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
2413 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
2414 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
2415 attributes.width = width;
2416 attributes.height = height;
2417 tree_view->priv->drag_highlight_window = gdk_window_new (NULL, &attributes, attributes_mask);
2418 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
2420 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
2421 gc = gdk_gc_new (mask);
2423 gdk_gc_set_foreground (gc, &col);
2424 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
2426 /* Draw the 2 arrows as per above */
2428 gdk_gc_set_foreground (gc, &col);
2429 j = tree_view->priv->expander_size;
2430 for (i = 0; i < width; i ++)
2433 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT)
2437 gdk_draw_line (mask, gc, k, j, k, height - j);
2438 gdk_draw_line (mask, gc, k, 0, k, tree_view->priv->expander_size - j);
2439 gdk_draw_line (mask, gc, k, height, k, height - tree_view->priv->expander_size + j);
2442 gdk_gc_destroy (gc);
2443 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
2445 if (mask) gdk_pixmap_unref (mask);
2448 tree_view->priv->drag_column_window_state = arrow_type;
2449 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
2453 g_warning (G_STRLOC"Invalid GtkTreeViewColumnReorder struct");
2454 gdk_window_hide (tree_view->priv->drag_highlight_window);
2458 gdk_window_show (tree_view->priv->drag_highlight_window);
2459 gdk_window_raise (tree_view->priv->drag_highlight_window);
2463 gtk_tree_view_motion_resize_column (GtkWidget *widget,
2464 GdkEventMotion *event)
2468 GtkTreeViewColumn *column;
2469 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
2471 column = gtk_tree_view_get_column (tree_view, tree_view->priv->drag_pos);
2473 if (event->is_hint || event->window != widget->window)
2474 gtk_widget_get_pointer (widget, &x, NULL);
2478 if (tree_view->priv->hadjustment)
2479 x += tree_view->priv->hadjustment->value;
2481 new_width = gtk_tree_view_new_column_width (tree_view,
2482 tree_view->priv->drag_pos, &x);
2483 if (x != tree_view->priv->x_drag &&
2484 (new_width != column->fixed_width));
2486 column->resized_width = new_width;
2487 gtk_widget_queue_resize (widget);
2495 gtk_tree_view_update_current_reorder (GtkTreeView *tree_view)
2497 GtkTreeViewColumnReorder *reorder = NULL;
2501 gdk_window_get_pointer (tree_view->priv->header_window, &mouse_x, NULL, NULL);
2503 for (list = tree_view->priv->column_drag_info; list; list = list->next)
2505 reorder = (GtkTreeViewColumnReorder *) list->data;
2506 if (mouse_x >= reorder->left_align && mouse_x < reorder->right_align)
2511 /* if (reorder && reorder == tree_view->priv->cur_reorder)
2514 tree_view->priv->cur_reorder = reorder;
2515 gtk_tree_view_motion_draw_column_motion_arrow (tree_view);
2519 gtk_tree_view_vertical_autoscroll (GtkTreeView *tree_view)
2521 GdkRectangle visible_rect;
2526 gdk_window_get_pointer (tree_view->priv->bin_window, NULL, &y, NULL);
2527 y += tree_view->priv->dy;
2529 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
2531 /* see if we are near the edge. */
2532 offset = y - (visible_rect.y + 2 * SCROLL_EDGE_SIZE);
2535 offset = y - (visible_rect.y + visible_rect.height - 2 * SCROLL_EDGE_SIZE);
2540 value = CLAMP (tree_view->priv->vadjustment->value + offset, 0.0,
2541 tree_view->priv->vadjustment->upper - tree_view->priv->vadjustment->page_size);
2542 gtk_adjustment_set_value (tree_view->priv->vadjustment, value);
2546 gtk_tree_view_horizontal_autoscroll (GtkTreeView *tree_view)
2548 GdkRectangle visible_rect;
2553 gdk_window_get_pointer (tree_view->priv->bin_window, &x, NULL, NULL);
2555 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
2557 /* See if we are near the edge. */
2558 offset = x - (visible_rect.x + SCROLL_EDGE_SIZE);
2561 offset = x - (visible_rect.x + visible_rect.width - SCROLL_EDGE_SIZE);
2567 value = CLAMP (tree_view->priv->hadjustment->value + offset,
2568 0.0, tree_view->priv->hadjustment->upper - tree_view->priv->hadjustment->page_size);
2569 gtk_adjustment_set_value (tree_view->priv->hadjustment, value);
2576 gtk_tree_view_motion_drag_column (GtkWidget *widget,
2577 GdkEventMotion *event)
2579 GtkTreeView *tree_view = (GtkTreeView *) widget;
2580 GtkTreeViewColumn *column = tree_view->priv->drag_column;
2584 if ((column == NULL) ||
2585 (event->window != tree_view->priv->drag_window))
2588 /* Handle moving the header */
2589 gdk_window_get_position (tree_view->priv->drag_window, &x, &y);
2590 x = CLAMP (x + (gint)event->x - column->drag_x, 0,
2591 MAX (tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.width) - column->button->allocation.width);
2592 gdk_window_move (tree_view->priv->drag_window, x, y);
2594 /* autoscroll, if needed */
2595 gtk_tree_view_horizontal_autoscroll (tree_view);
2596 /* Update the current reorder position and arrow; */
2597 gtk_tree_view_update_current_reorder (tree_view);
2603 gtk_tree_view_motion_bin_window (GtkWidget *widget,
2604 GdkEventMotion *event)
2606 GtkTreeView *tree_view;
2610 GtkRBTree *old_prelight_tree;
2611 GtkRBNode *old_prelight_node;
2612 gboolean old_arrow_prelit;
2614 tree_view = (GtkTreeView *) widget;
2616 if (tree_view->priv->tree == NULL)
2619 gtk_tree_view_maybe_begin_dragging_row (tree_view, event);
2621 old_prelight_tree = tree_view->priv->prelight_tree;
2622 old_prelight_node = tree_view->priv->prelight_node;
2623 old_arrow_prelit = GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
2625 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
2628 do_unprelight (tree_view, event->x, event->y);
2629 _gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
2634 /* If we are currently pressing down a button, we don't want to prelight anything else. */
2635 if ((tree_view->priv->button_pressed_node != NULL) &&
2636 (tree_view->priv->button_pressed_node != node))
2640 do_prelight (tree_view, tree, node, event->x, event->y);
2642 if (old_prelight_node != tree_view->priv->prelight_node)
2644 if (old_prelight_node)
2646 _gtk_tree_view_queue_draw_node (tree_view,
2651 if (tree_view->priv->prelight_node)
2653 _gtk_tree_view_queue_draw_node (tree_view,
2654 tree_view->priv->prelight_tree,
2655 tree_view->priv->prelight_node,
2659 else if (old_arrow_prelit != GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
2661 if (tree_view->priv->prelight_node)
2663 _gtk_tree_view_queue_draw_node (tree_view,
2664 tree_view->priv->prelight_tree,
2665 tree_view->priv->prelight_node,
2673 gtk_tree_view_motion (GtkWidget *widget,
2674 GdkEventMotion *event)
2676 GtkTreeView *tree_view;
2678 tree_view = (GtkTreeView *) widget;
2680 /* Resizing a column */
2681 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
2682 return gtk_tree_view_motion_resize_column (widget, event);
2685 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
2686 return gtk_tree_view_motion_drag_column (widget, event);
2688 /* Sanity check it */
2689 if (event->window == tree_view->priv->bin_window)
2690 return gtk_tree_view_motion_bin_window (widget, event);
2695 /* Warning: Very scary function.
2696 * Modify at your own risk
2698 * KEEP IN SYNC WITH gtk_tree_view_create_row_drag_icon()!
2699 * FIXME: It's not...
2702 gtk_tree_view_bin_expose (GtkWidget *widget,
2703 GdkEventExpose *event)
2705 GtkTreeView *tree_view;
2710 GtkRBNode *cursor = NULL;
2711 GtkRBTree *cursor_tree = NULL;
2712 GtkRBNode *drag_highlight = NULL;
2713 GtkRBTree *drag_highlight_tree = NULL;
2716 gint y_offset, x_offset, cell_offset;
2719 GdkRectangle background_area;
2720 GdkRectangle cell_area;
2723 gint bin_window_width;
2724 GtkTreePath *cursor_path;
2725 GtkTreePath *drag_dest_path;
2727 gint vertical_separator;
2728 gint horizontal_separator;
2729 gboolean allow_rules;
2731 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2733 tree_view = GTK_TREE_VIEW (widget);
2735 gtk_widget_style_get (widget,
2736 "horizontal_separator", &horizontal_separator,
2737 "vertical_separator", &vertical_separator,
2738 "allow_rules", &allow_rules,
2741 if (tree_view->priv->tree == NULL)
2744 /* clip event->area to the visible area */
2745 if (event->area.height < 0)
2748 validate_visible_area (tree_view);
2750 new_y = TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, event->area.y);
2754 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
2759 /* find the path for the node */
2760 path = _gtk_tree_view_find_path ((GtkTreeView *)widget,
2763 gtk_tree_model_get_iter (tree_view->priv->model,
2766 depth = gtk_tree_path_get_depth (path);
2767 gtk_tree_path_free (path);
2770 drag_dest_path = NULL;
2772 if (tree_view->priv->cursor)
2773 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
2776 _gtk_tree_view_find_node (tree_view, cursor_path,
2777 &cursor_tree, &cursor);
2779 if (tree_view->priv->drag_dest_row)
2780 drag_dest_path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
2783 _gtk_tree_view_find_node (tree_view, drag_dest_path,
2784 &drag_highlight_tree, &drag_highlight);
2786 gdk_drawable_get_size (tree_view->priv->bin_window,
2787 &bin_window_width, NULL);
2789 for (last_column = g_list_last (tree_view->priv->columns);
2791 !(GTK_TREE_VIEW_COLUMN (last_column->data)->visible) &&
2792 GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (last_column->data)->button);
2793 last_column = last_column->prev)
2796 /* Actually process the expose event. To do this, we want to
2797 * start at the first node of the event, and walk the tree in
2798 * order, drawing each successive node.
2805 max_height = MAX (BACKGROUND_HEIGHT (node), tree_view->priv->expander_size);
2807 x_offset = -event->area.x;
2809 highlight_x = 0; /* should match x coord of first cell */
2811 background_area.y = y_offset + event->area.y;
2812 background_area.height = max_height;
2816 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PRELIT))
2817 flags |= GTK_CELL_RENDERER_PRELIT;
2819 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
2820 flags |= GTK_CELL_RENDERER_SELECTED;
2822 parity = _gtk_rbtree_node_find_parity (tree, node);
2824 for (list = tree_view->priv->columns; list; list = list->next)
2826 GtkTreeViewColumn *column = list->data;
2827 const gchar *detail = NULL;
2830 if (!column->visible)
2833 if (cell_offset > event->area.x + event->area.width ||
2834 cell_offset + column->width < event->area.x)
2836 cell_offset += column->width;
2840 if (column->show_sort_indicator)
2841 flags |= GTK_CELL_RENDERER_SORTED;
2843 flags &= ~GTK_CELL_RENDERER_SORTED;
2845 gtk_tree_view_column_cell_set_cell_data (column,
2846 tree_view->priv->model,
2848 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
2849 node->children?TRUE:FALSE);
2852 background_area.x = cell_offset;
2853 background_area.width = column->width;
2855 cell_area = background_area;
2856 cell_area.y += vertical_separator / 2;
2857 cell_area.x += horizontal_separator / 2;
2858 cell_area.height -= vertical_separator;
2859 cell_area.width -= horizontal_separator;
2861 /* Select the detail for drawing the cell. relevant
2862 * factors are parity, sortedness, and whether to
2865 if (allow_rules && tree_view->priv->has_rules)
2867 if (flags & GTK_CELL_RENDERER_SORTED)
2870 detail = "cell_odd_ruled_sorted";
2872 detail = "cell_even_ruled_sorted";
2877 detail = "cell_odd_ruled";
2879 detail = "cell_even_ruled";
2884 if (flags & GTK_CELL_RENDERER_SORTED)
2887 detail = "cell_odd_sorted";
2889 detail = "cell_even_sorted";
2894 detail = "cell_odd";
2896 detail = "cell_even";
2902 if (flags & GTK_CELL_RENDERER_SELECTED)
2903 state = GTK_STATE_SELECTED;
2905 state = GTK_STATE_NORMAL;
2907 /* Draw background */
2908 gtk_paint_flat_box (widget->style,
2917 background_area.width,
2918 background_area.height);
2920 if (gtk_tree_view_is_expander_column (tree_view, column) &&
2921 TREE_VIEW_DRAW_EXPANDERS(tree_view))
2923 cell_area.x += depth * tree_view->priv->expander_size;
2924 cell_area.width -= depth * tree_view->priv->expander_size;
2926 /* If we have an expander column, the highlight underline
2927 * starts with that column, so that it indicates which
2928 * level of the tree we're dropping at.
2930 highlight_x = cell_area.x;
2931 _gtk_tree_view_column_cell_render (column,
2937 if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT)
2940 gdk_window_get_pointer (tree_view->priv->bin_window, &x, &y, 0);
2941 gtk_tree_view_draw_arrow (GTK_TREE_VIEW (widget),
2949 _gtk_tree_view_column_cell_render (column,
2956 if (node == cursor &&
2957 ((column == tree_view->priv->focus_column &&
2958 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS) &&
2959 GTK_WIDGET_HAS_FOCUS (widget)) ||
2960 (column == tree_view->priv->edited_column)))
2962 _gtk_tree_view_column_cell_draw_focus (column,
2969 cell_offset += column->width;
2973 if (node == drag_highlight)
2975 /* Draw indicator for the drop
2977 gint highlight_y = -1;
2978 GtkRBTree *tree = NULL;
2979 GtkRBNode *node = NULL;
2981 gint focus_line_width;
2983 switch (tree_view->priv->drag_dest_pos)
2985 case GTK_TREE_VIEW_DROP_BEFORE:
2986 highlight_y = background_area.y - 1;
2987 if (highlight_y < 0)
2991 case GTK_TREE_VIEW_DROP_AFTER:
2992 highlight_y = background_area.y + background_area.height - 1;
2995 case GTK_TREE_VIEW_DROP_INTO_OR_BEFORE:
2996 case GTK_TREE_VIEW_DROP_INTO_OR_AFTER:
2997 _gtk_tree_view_find_node (tree_view, drag_dest_path, &tree, &node);
3001 gdk_drawable_get_size (tree_view->priv->bin_window,
3003 gtk_widget_style_get (widget, "focus-line-width", &focus_line_width, NULL);
3004 gtk_paint_focus (widget->style,
3005 tree_view->priv->bin_window,
3006 GTK_WIDGET_STATE (widget),
3009 "treeview-drop-indicator",
3010 0, BACKGROUND_FIRST_PIXEL (tree_view, tree, node)
3011 - focus_line_width / 2,
3012 width, MAX(BACKGROUND_HEIGHT (node),
3013 tree_view->priv->expander_size)
3014 - focus_line_width + 1);
3018 if (highlight_y >= 0)
3020 gdk_draw_line (event->window,
3021 widget->style->black_gc,
3024 bin_window_width - highlight_x,
3029 y_offset += max_height;
3032 GtkTreeIter parent = iter;
3035 tree = node->children;
3038 g_assert (node != tree->nil);
3040 while (node->left != tree->nil)
3042 has_child = gtk_tree_model_iter_children (tree_view->priv->model,
3048 TREE_VIEW_INTERNAL_ASSERT (has_child, FALSE);
3052 gboolean done = FALSE;
3055 node = _gtk_rbtree_next (tree, node);
3058 gboolean has_next = gtk_tree_model_iter_next (tree_view->priv->model, &iter);
3062 TREE_VIEW_INTERNAL_ASSERT (has_next, FALSE);
3066 GtkTreeIter parent_iter = iter;
3067 gboolean has_parent;
3069 node = tree->parent_node;
3070 tree = tree->parent_tree;
3072 /* we should go to done to free some memory */
3074 has_parent = gtk_tree_model_iter_parent (tree_view->priv->model,
3080 TREE_VIEW_INTERNAL_ASSERT (has_parent, FALSE);
3086 while (y_offset < event->area.height);
3090 gtk_tree_path_free (cursor_path);
3093 gtk_tree_path_free (drag_dest_path);
3099 gtk_tree_view_expose (GtkWidget *widget,
3100 GdkEventExpose *event)
3102 GtkTreeView *tree_view;
3104 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
3106 tree_view = GTK_TREE_VIEW (widget);
3108 if (event->window == tree_view->priv->bin_window)
3109 return gtk_tree_view_bin_expose (widget, event);
3110 else if (event->window == tree_view->priv->header_window)
3114 for (list = tree_view->priv->columns; list != NULL; list = list->next)
3116 GtkTreeViewColumn *column = list->data;
3118 if (column == tree_view->priv->drag_column)
3121 if (column->visible)
3122 gtk_container_propagate_expose (GTK_CONTAINER (tree_view),
3127 else if (event->window == tree_view->priv->drag_window)
3129 gtk_container_propagate_expose (GTK_CONTAINER (tree_view),
3130 tree_view->priv->drag_column->button,
3144 /* returns 0x1 when no column has been found -- yes it's hackish */
3145 static GtkTreeViewColumn *
3146 gtk_tree_view_get_drop_column (GtkTreeView *tree_view,
3147 GtkTreeViewColumn *column,
3150 GtkTreeViewColumn *left_column = NULL;
3151 GtkTreeViewColumn *cur_column = NULL;
3154 if (!column->reorderable)
3155 return (GtkTreeViewColumn *)0x1;
3157 switch (drop_position)
3160 /* find first column where we can drop */
3161 tmp_list = tree_view->priv->columns;
3162 if (column == GTK_TREE_VIEW_COLUMN (tmp_list->data))
3163 return (GtkTreeViewColumn *)0x1;
3167 g_assert (tmp_list);
3169 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
3170 tmp_list = tmp_list->next;
3172 if (left_column && left_column->visible == FALSE)
3175 if (!tree_view->priv->column_drop_func)
3178 if (!(*tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
3180 left_column = cur_column;
3187 if (!tree_view->priv->column_drop_func)
3190 if ((*tree_view->priv->column_drop_func) (tree_view, column, left_column, NULL, tree_view->priv->column_drop_func_data))
3193 return (GtkTreeViewColumn *)0x1;
3197 /* find first column after column where we can drop */
3198 tmp_list = tree_view->priv->columns;
3200 for (; tmp_list; tmp_list = tmp_list->next)
3201 if (GTK_TREE_VIEW_COLUMN (tmp_list->data) == column)
3204 if (!tmp_list || !tmp_list->next)
3205 return (GtkTreeViewColumn *)0x1;
3207 tmp_list = tmp_list->next;
3208 left_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
3209 tmp_list = tmp_list->next;
3213 g_assert (tmp_list);
3215 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
3216 tmp_list = tmp_list->next;
3218 if (left_column && left_column->visible == FALSE)
3220 left_column = cur_column;
3222 tmp_list = tmp_list->next;
3226 if (!tree_view->priv->column_drop_func)
3229 if (!(*tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
3231 left_column = cur_column;
3238 if (!tree_view->priv->column_drop_func)
3241 if ((*tree_view->priv->column_drop_func) (tree_view, column, left_column, NULL, tree_view->priv->column_drop_func_data))
3244 return (GtkTreeViewColumn *)0x1;
3248 /* find first column before column where we can drop */
3249 tmp_list = tree_view->priv->columns;
3251 for (; tmp_list; tmp_list = tmp_list->next)
3252 if (GTK_TREE_VIEW_COLUMN (tmp_list->data) == column)
3255 if (!tmp_list || !tmp_list->prev)
3256 return (GtkTreeViewColumn *)0x1;
3258 tmp_list = tmp_list->prev;
3259 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
3260 tmp_list = tmp_list->prev;
3264 g_assert (tmp_list);
3266 left_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
3268 if (left_column && !left_column->visible)
3270 /*if (!tmp_list->prev)
3271 return (GtkTreeViewColumn *)0x1;
3274 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->prev->data);
3275 tmp_list = tmp_list->prev->prev;
3278 cur_column = left_column;
3280 tmp_list = tmp_list->prev;
3284 if (!tree_view->priv->column_drop_func)
3287 if ((*tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
3290 cur_column = left_column;
3291 tmp_list = tmp_list->prev;
3294 if (!tree_view->priv->column_drop_func)
3297 if ((*tree_view->priv->column_drop_func) (tree_view, column, NULL, cur_column, tree_view->priv->column_drop_func_data))
3300 return (GtkTreeViewColumn *)0x1;
3304 /* same as DROP_HOME case, but doing it backwards */
3305 tmp_list = g_list_last (tree_view->priv->columns);
3308 if (column == GTK_TREE_VIEW_COLUMN (tmp_list->data))
3309 return (GtkTreeViewColumn *)0x1;
3313 g_assert (tmp_list);
3315 left_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
3317 if (left_column && !left_column->visible)
3319 cur_column = left_column;
3320 tmp_list = tmp_list->prev;
3323 if (!tree_view->priv->column_drop_func)
3326 if ((*tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
3329 cur_column = left_column;
3330 tmp_list = tmp_list->prev;
3333 if (!tree_view->priv->column_drop_func)
3336 if ((*tree_view->priv->column_drop_func) (tree_view, column, NULL, cur_column, tree_view->priv->column_drop_func_data))
3339 return (GtkTreeViewColumn *)0x1;
3343 return (GtkTreeViewColumn *)0x1;
3347 gtk_tree_view_key_press (GtkWidget *widget,
3350 GtkTreeView *tree_view = (GtkTreeView *) widget;
3353 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
3355 if (event->keyval == GDK_Escape)
3357 tree_view->priv->cur_reorder = NULL;
3358 gtk_tree_view_button_release_drag_column (widget, NULL);
3363 /* FIXME: this is prolly broken when we go bidi */
3364 if (tree_view->priv->columns && (event->state & GDK_SHIFT_MASK)
3365 && (event->keyval == GDK_Left || event->keyval == GDK_Right))
3367 list = tree_view->priv->columns;
3370 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (list->data);
3371 if (GTK_WIDGET_HAS_FOCUS (column->button))
3373 if (!column->resizable)
3376 if (event->keyval == GDK_Left)
3378 column->resized_width = MAX (column->resized_width,
3380 column->resized_width -= 2;
3381 if (column->resized_width < 0)
3382 column->resized_width = 0;
3384 if (column->min_width == -1)
3385 column->resized_width = MAX (column->button->requisition.width, column->resized_width);
3387 column->resized_width = MAX (column->min_width, column->resized_width);
3389 if (column->max_width != -1)
3390 column->resized_width = MIN (column->resized_width, column->max_width);
3392 column->use_resized_width = TRUE;
3393 gtk_widget_queue_resize (widget);
3396 else if (event->keyval == GDK_Right)
3398 column->resized_width = MAX (column->resized_width,
3400 column->resized_width += 2;
3402 if (column->max_width != -1)
3403 column->resized_width = MIN (column->resized_width, column->max_width);
3405 column->use_resized_width = TRUE;
3406 gtk_widget_queue_resize (widget);
3414 /* FIXME: broken when we go bidi? */
3415 if (tree_view->priv->columns && (event->state & GDK_CONTROL_MASK) &&
3416 (event->keyval == GDK_Left || event->keyval == GDK_Right
3417 || event->keyval == GDK_Home || event->keyval == GDK_End))
3419 list = tree_view->priv->columns;
3422 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (list->data);
3423 if (GTK_WIDGET_HAS_FOCUS (column->button))
3425 if (event->keyval == GDK_Left)
3427 GtkTreeViewColumn *col;
3428 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_LEFT);
3429 if (col != (GtkTreeViewColumn *)0x1)
3430 gtk_tree_view_move_column_after (tree_view, column, col);
3433 else if (event->keyval == GDK_Right)
3435 GtkTreeViewColumn *col;
3436 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_RIGHT);
3437 if (col != (GtkTreeViewColumn *)0x1)
3438 gtk_tree_view_move_column_after (tree_view, column, col);
3441 else if (event->keyval == GDK_Home)
3443 GtkTreeViewColumn *col;
3444 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_HOME);
3445 if (col != (GtkTreeViewColumn *)0x1)
3446 gtk_tree_view_move_column_after (tree_view, column, col);
3449 else if (event->keyval == GDK_End)
3451 GtkTreeViewColumn *col;
3452 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_END);
3453 if (col != (GtkTreeViewColumn *)0x1)
3454 gtk_tree_view_move_column_after (tree_view, column, col);
3462 /* FIXME: this is prolly broken when we go bidi */
3463 if (tree_view->priv->columns &&
3464 (event->keyval == GDK_Left || event->keyval == GDK_Right))
3467 list = tree_view->priv->columns;
3470 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (list->data);
3471 if (GTK_WIDGET_HAS_FOCUS (column->button))
3473 if (event->keyval == GDK_Left && list->prev)
3477 for (tmp = list->prev; tmp; tmp = tmp->prev)
3478 if (GTK_TREE_VIEW_COLUMN (tmp->data)->visible)
3484 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (tmp->data);
3485 gtk_widget_grab_focus (tree_view->priv->focus_column->button);
3486 width -= tree_view->priv->focus_column->width;
3487 gtk_adjustment_set_value (tree_view->priv->hadjustment, CLAMP (width, tree_view->priv->hadjustment->lower, tree_view->priv->hadjustment->upper - tree_view->priv->hadjustment->page_size));
3490 else if (event->keyval == GDK_Right && list->next)
3494 for (tmp = list->next; tmp; tmp = tmp->next)
3495 if (GTK_TREE_VIEW_COLUMN (tmp->data)->visible)
3501 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (tmp->data);
3503 gtk_widget_grab_focus (tree_view->priv->focus_column->button);
3504 width += tree_view->priv->focus_column->width;
3505 gtk_adjustment_set_value (tree_view->priv->hadjustment, CLAMP (width, tree_view->priv->hadjustment->lower, tree_view->priv->hadjustment->upper - tree_view->priv->hadjustment->page_size));
3509 width += GTK_TREE_VIEW_COLUMN (list->data)->width;
3514 return (* GTK_WIDGET_CLASS (parent_class)->key_press_event) (widget, event);
3517 /* FIXME Is this function necessary? Can I get an enter_notify event
3518 * w/o either an expose event or a mouse motion event?
3521 gtk_tree_view_enter_notify (GtkWidget *widget,
3522 GdkEventCrossing *event)
3524 GtkTreeView *tree_view;
3529 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
3531 tree_view = GTK_TREE_VIEW (widget);
3533 /* Sanity check it */
3534 if (event->window != tree_view->priv->bin_window)
3537 if (tree_view->priv->tree == NULL)
3540 if ((tree_view->priv->button_pressed_node != NULL) &&
3541 (tree_view->priv->button_pressed_node != node))
3544 /* find the node internally */
3545 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
3548 _gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
3553 do_prelight (tree_view, tree, node, event->x, event->y);
3555 if (tree_view->priv->prelight_node)
3556 _gtk_tree_view_queue_draw_node (tree_view,
3557 tree_view->priv->prelight_tree,
3558 tree_view->priv->prelight_node,
3565 gtk_tree_view_leave_notify (GtkWidget *widget,
3566 GdkEventCrossing *event)
3568 GtkTreeView *tree_view;
3570 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
3572 if (event->mode == GDK_CROSSING_GRAB)
3574 tree_view = GTK_TREE_VIEW (widget);
3576 if (tree_view->priv->prelight_node)
3577 _gtk_tree_view_queue_draw_node (tree_view,
3578 tree_view->priv->prelight_tree,
3579 tree_view->priv->prelight_node,
3582 ensure_unprelighted (tree_view);
3589 gtk_tree_view_focus_out (GtkWidget *widget,
3590 GdkEventFocus *event)
3592 GtkWidget *search_dialog;
3594 gtk_widget_queue_draw (widget);
3596 /* destroy interactive search dialog */
3597 search_dialog = gtk_object_get_data (GTK_OBJECT (widget),
3598 GTK_TREE_VIEW_SEARCH_DIALOG_KEY);
3600 gtk_tree_view_search_dialog_destroy (search_dialog, GTK_TREE_VIEW (widget));
3606 /* Incremental Reflow
3609 /* Returns TRUE if it updated the size
3612 validate_row (GtkTreeView *tree_view,
3618 GtkTreeViewColumn *column;
3621 gint horizontal_separator;
3622 gint depth = gtk_tree_path_get_depth (path);
3623 gboolean retval = FALSE;
3625 /* double check the row needs validating */
3626 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) &&
3627 ! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
3630 gtk_widget_style_get (GTK_WIDGET (tree_view),
3631 "horizontal_separator", &horizontal_separator,
3634 for (list = tree_view->priv->columns; list; list = list->next)
3639 column = list->data;
3641 if (! column->visible)
3644 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID) && !column->dirty)
3647 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter,
3648 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
3649 node->children?TRUE:FALSE);
3650 gtk_tree_view_column_cell_get_size (column,
3652 &tmp_width, &tmp_height);
3653 height = MAX (height, tmp_height);
3654 height = MAX (height, tree_view->priv->expander_size);
3656 if (gtk_tree_view_is_expander_column (tree_view, column) && TREE_VIEW_DRAW_EXPANDERS (tree_view))
3658 tmp_width = tmp_width + horizontal_separator + depth * (tree_view->priv->expander_size);
3661 tmp_width = tmp_width + horizontal_separator;
3663 if (tmp_width > column->requested_width)
3666 column->requested_width = tmp_width;
3670 if (height != GTK_RBNODE_GET_HEIGHT (node))
3673 _gtk_rbtree_node_set_height (tree, node, height);
3675 _gtk_rbtree_node_mark_valid (tree, node);
3682 validate_visible_area (GtkTreeView *tree_view)
3684 GtkTreePath *path = NULL;
3685 GtkTreePath *above_path = NULL;
3687 GtkRBTree *tree = NULL;
3688 GtkRBNode *node = NULL;
3689 gboolean need_redraw = FALSE;
3690 gboolean size_changed = FALSE;
3691 gboolean modify_dy = FALSE;
3693 gint area_above = 0;
3694 gint area_below = 0;
3696 if (tree_view->priv->tree == NULL)
3699 if (! GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID) &&
3700 tree_view->priv->scroll_to_path == NULL)
3703 total_height = GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
3705 /* First, we check to see if we need to scroll anywhere
3707 if (tree_view->priv->scroll_to_path)
3709 path = gtk_tree_row_reference_get_path (tree_view->priv->scroll_to_path);
3710 if (path && !_gtk_tree_view_find_node (tree_view, path, &tree, &node))
3712 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
3713 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
3714 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
3717 if (validate_row (tree_view, tree, node, &iter, path))
3718 size_changed = TRUE;
3720 if (tree_view->priv->scroll_to_use_align)
3722 gint height = MAX (GTK_RBNODE_GET_HEIGHT (node), tree_view->priv->expander_size);
3723 area_above = (total_height - height) *
3724 tree_view->priv->scroll_to_row_align;
3725 area_below = total_height - area_above - height;
3726 area_above = MAX (area_above, 0);
3727 area_below = MAX (area_below, 0);
3732 g_warning ("non use_align not implemented yet");
3733 gtk_tree_path_free (path);
3738 /* the scroll to isn't valid; ignore it.
3741 if (tree_view->priv->scroll_to_path && !path)
3743 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
3744 tree_view->priv->scroll_to_path = NULL;
3747 gtk_tree_path_free (path);
3752 /* We didn't have a scroll_to set, so we just handle things normally
3758 offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
3759 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, 0),
3763 /* In this case, nothing has been validated */
3764 path = gtk_tree_path_new_first ();
3765 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
3769 path = _gtk_tree_view_find_path (tree_view, tree, node);
3770 total_height += offset;
3773 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
3775 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
3776 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
3779 if (validate_row (tree_view, tree, node, &iter, path))
3780 size_changed = TRUE;
3783 area_below = total_height - MAX (GTK_RBNODE_GET_HEIGHT (node), tree_view->priv->expander_size);
3786 above_path = gtk_tree_path_copy (path);
3788 /* Now, we walk forwards and backwards, measuring rows. Unfortunately,
3789 * backwards is much slower then forward, as there is no iter_prev function.
3790 * We go forwards first in case we run out of tree. Then we go backwards to
3793 while (node && area_below > 0)
3797 GtkTreeIter parent = iter;
3800 tree = node->children;
3803 g_assert (node != tree->nil);
3805 while (node->left != tree->nil)
3807 has_child = gtk_tree_model_iter_children (tree_view->priv->model,
3810 TREE_VIEW_INTERNAL_ASSERT_VOID (has_child);
3811 gtk_tree_path_down (path);
3815 gboolean done = FALSE;
3818 node = _gtk_rbtree_next (tree, node);
3821 gboolean has_next = gtk_tree_model_iter_next (tree_view->priv->model, &iter);
3823 gtk_tree_path_next (path);
3826 TREE_VIEW_INTERNAL_ASSERT_VOID (has_next);
3830 GtkTreeIter parent_iter = iter;
3831 gboolean has_parent;
3833 node = tree->parent_node;
3834 tree = tree->parent_tree;
3837 has_parent = gtk_tree_model_iter_parent (tree_view->priv->model,
3840 gtk_tree_path_up (path);
3843 TREE_VIEW_INTERNAL_ASSERT_VOID (has_parent);
3848 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
3849 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
3852 if (validate_row (tree_view, tree, node, &iter, path))
3853 size_changed = TRUE;
3856 area_below -= MAX (GTK_RBNODE_GET_HEIGHT (node), tree_view->priv->expander_size);
3858 gtk_tree_path_free (path);
3860 /* If we ran out of tree, and have extra area_below left, we need to remove it
3861 * from the area_above */
3863 area_above += area_below;
3865 _gtk_tree_view_find_node (tree_view, above_path, &tree, &node);
3867 /* We walk backwards */
3868 while (area_above > 0)
3870 _gtk_rbtree_prev_full (tree, node, &tree, &node);
3871 if (! gtk_tree_path_prev (above_path) && node != NULL)
3873 gtk_tree_path_free (above_path);
3874 above_path = _gtk_tree_view_find_path (tree_view, tree, node);
3876 gtk_tree_model_get_iter (tree_view->priv->model, &iter, above_path);
3881 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
3882 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
3885 if (validate_row (tree_view, tree, node, &iter, above_path))
3886 size_changed = TRUE;
3888 area_above -= MAX (GTK_RBNODE_GET_HEIGHT (node), tree_view->priv->expander_size);
3892 /* if we walk backwards at all, then we need to reset our dy. */
3898 dy = _gtk_rbtree_node_find_offset (tree, node) - area_above;
3904 gtk_adjustment_set_value (tree_view->priv->vadjustment, dy);
3908 if (tree_view->priv->scroll_to_path)
3910 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
3911 tree_view->priv->scroll_to_path = NULL;
3915 gtk_tree_path_free (above_path);
3917 if (tree_view->priv->scroll_to_column)
3919 tree_view->priv->scroll_to_column = NULL;
3922 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
3924 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
3928 /* Our strategy for finding nodes to validate is a little convoluted. We find
3929 * the left-most uninvalidated node. We then try walking right, validating
3930 * nodes. Once we find a valid node, we repeat the previous process of finding
3931 * the first invalid node.
3935 do_validate_rows (GtkTreeView *tree_view)
3937 GtkRBTree *tree = NULL;
3938 GtkRBNode *node = NULL;
3939 gboolean validated_area = FALSE;
3941 GtkTreePath *path = NULL;
3945 gint prev_height = -1;
3946 gboolean fixed_height = TRUE;
3948 g_assert (tree_view);
3950 if (tree_view->priv->tree == NULL)
3952 tree_view->priv->validate_rows_timer = 0;
3957 if (! GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID))
3965 node = _gtk_rbtree_next (tree, node);
3968 TREE_VIEW_INTERNAL_ASSERT (gtk_tree_model_iter_next (tree_view->priv->model, &iter), FALSE);
3969 gtk_tree_path_next (path);
3973 gtk_tree_path_free (path);
3980 tree = tree_view->priv->tree;
3981 node = tree_view->priv->tree->root;
3983 g_assert (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_DESCENDANTS_INVALID));
3987 if (node->left != tree->nil &&
3988 GTK_RBNODE_FLAG_SET (node->left, GTK_RBNODE_DESCENDANTS_INVALID))
3992 else if (node->right != tree->nil &&
3993 GTK_RBNODE_FLAG_SET (node->right, GTK_RBNODE_DESCENDANTS_INVALID))
3997 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
3998 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
4002 else if (node->children != NULL)
4004 tree = node->children;
4008 /* RBTree corruption! All bad */
4009 g_assert_not_reached ();
4012 path = _gtk_tree_view_find_path (tree_view, tree, node);
4013 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
4015 validated_area = validate_row (tree_view, tree, node, &iter, path) | validated_area;
4017 if (!tree_view->priv->fixed_height_check)
4021 height = MAX (GTK_RBNODE_GET_HEIGHT (node), tree_view->priv->expander_size);
4022 if (prev_height < 0)
4023 prev_height = height;
4024 else if (prev_height != height)
4025 fixed_height = FALSE;
4030 while (i < GTK_TREE_VIEW_NUM_ROWS_PER_IDLE);
4032 if (!tree_view->priv->fixed_height_check)
4035 _gtk_rbtree_set_fixed_height (tree_view->priv->tree, prev_height);
4037 tree_view->priv->fixed_height_check = 1;
4041 if (gtk_tree_row_reference_valid (tree_view->priv->top_row))
4042 gtk_tree_view_top_row_to_dy (tree_view);
4044 gtk_tree_view_dy_to_top_row (tree_view);
4046 if (path) gtk_tree_path_free (path);
4048 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
4050 tree_view->priv->validate_rows_timer = 0;
4056 validate_rows_handler (GtkTreeView *tree_view)
4060 GDK_THREADS_ENTER ();
4062 retval = do_validate_rows (tree_view);
4064 GDK_THREADS_LEAVE ();
4070 do_presize_handler (GtkTreeView *tree_view)
4072 if (tree_view->priv->mark_rows_col_dirty)
4074 if (tree_view->priv->tree)
4075 _gtk_rbtree_column_invalid (tree_view->priv->tree);
4076 tree_view->priv->mark_rows_col_dirty = FALSE;
4078 validate_visible_area (tree_view);
4079 tree_view->priv->presize_handler_timer = 0;
4085 presize_handler_callback (gpointer data)
4087 GDK_THREADS_ENTER ();
4089 do_presize_handler (GTK_TREE_VIEW (data));
4091 GDK_THREADS_LEAVE ();
4097 install_presize_handler (GtkTreeView *tree_view)
4099 if (! GTK_WIDGET_REALIZED (tree_view))
4102 if (! tree_view->priv->presize_handler_timer)
4104 tree_view->priv->presize_handler_timer =
4105 g_idle_add_full (GTK_PRIORITY_RESIZE - 2, presize_handler_callback, tree_view, NULL);
4107 if (! tree_view->priv->validate_rows_timer)
4109 tree_view->priv->validate_rows_timer =
4110 g_idle_add_full (GTK_TREE_VIEW_PRIORITY_VALIDATE, (GSourceFunc) validate_rows_handler, tree_view, NULL);
4115 scroll_sync_handler (GtkTreeView *tree_view)
4118 GDK_THREADS_ENTER ();
4120 if (gtk_tree_row_reference_valid (tree_view->priv->top_row))
4121 gtk_tree_view_top_row_to_dy (tree_view);
4123 gtk_tree_view_dy_to_top_row (tree_view);
4125 tree_view->priv->scroll_sync_timer = 0;
4127 GDK_THREADS_LEAVE ();
4133 install_scroll_sync_handler (GtkTreeView *tree_view)
4135 if (! GTK_WIDGET_REALIZED (tree_view))
4138 if (!tree_view->priv->scroll_sync_timer)
4140 tree_view->priv->scroll_sync_timer =
4141 g_idle_add_full (GTK_TREE_VIEW_PRIORITY_SCROLL_SYNC, (GSourceFunc) scroll_sync_handler, tree_view, NULL);
4145 /* Always call this iff dy is in the visible range. If the tree is empty, then
4146 * it's set to be NULL, and top_row_dy is 0;
4149 gtk_tree_view_dy_to_top_row (GtkTreeView *tree_view)
4155 gtk_tree_row_reference_free (tree_view->priv->top_row);
4156 if (tree_view->priv->tree == NULL)
4159 tree_view->priv->top_row_dy = _gtk_rbtree_find_offset (tree_view->priv->tree,
4160 tree_view->priv->dy,
4164 tree_view->priv->top_row = NULL;
4165 tree_view->priv->top_row_dy = 0;
4169 path = _gtk_tree_view_find_path (tree_view, tree, node);
4170 tree_view->priv->top_row = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
4171 gtk_tree_path_free (path);
4175 gtk_tree_view_top_row_to_dy (GtkTreeView *tree_view)
4181 if (tree_view->priv->top_row)
4182 path = gtk_tree_row_reference_get_path (tree_view->priv->top_row);
4189 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
4192 gtk_tree_path_free (path);
4196 /* keep dy and set new toprow */
4197 gtk_tree_row_reference_free (tree_view->priv->top_row);
4198 tree_view->priv->top_row = NULL;
4199 tree_view->priv->top_row_dy = 0;
4200 /* DO NOT install the idle handler */
4201 gtk_tree_view_dy_to_top_row (tree_view);
4205 if (MAX (BACKGROUND_HEIGHT (node), tree_view->priv->expander_size)
4206 < tree_view->priv->top_row_dy)
4208 /* new top row -- do NOT install the idle handler */
4209 gtk_tree_view_dy_to_top_row (tree_view);
4213 tree_view->priv->dy = _gtk_rbtree_node_find_offset (tree, node);
4214 tree_view->priv->dy += tree_view->priv->top_row_dy;
4215 gtk_adjustment_set_value (tree_view->priv->vadjustment,
4216 tree_view->priv->dy);
4220 _gtk_tree_view_install_mark_rows_col_dirty (GtkTreeView *tree_view)
4222 tree_view->priv->mark_rows_col_dirty = TRUE;
4224 install_presize_handler (tree_view);
4228 * This function works synchronously (due to the while (do_validate_rows...)
4231 * There was a check for column_type != GTK_TREE_VIEW_COLUMN_AUTOSIZE
4232 * here. You now need to check that yourself.
4235 _gtk_tree_view_column_autosize (GtkTreeView *tree_view,
4236 GtkTreeViewColumn *column)
4238 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
4239 g_return_if_fail (GTK_IS_TREE_VIEW_COLUMN (column));
4241 _gtk_tree_view_column_cell_set_dirty (column, FALSE);
4243 do_presize_handler (tree_view);
4244 while (do_validate_rows (tree_view));
4246 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
4252 set_source_row (GdkDragContext *context,
4253 GtkTreeModel *model,
4254 GtkTreePath *source_row)
4256 g_object_set_data_full (G_OBJECT (context),
4257 "gtk-tree-view-source-row",
4258 source_row ? gtk_tree_row_reference_new (model, source_row) : NULL,
4259 (GDestroyNotify) (source_row ? gtk_tree_row_reference_free : NULL));
4263 get_source_row (GdkDragContext *context)
4265 GtkTreeRowReference *ref =
4266 g_object_get_data (G_OBJECT (context), "gtk-tree-view-source-row");
4269 return gtk_tree_row_reference_get_path (ref);
4276 set_dest_row (GdkDragContext *context,
4277 GtkTreeModel *model,
4278 GtkTreePath *dest_row)
4280 g_object_set_data_full (G_OBJECT (context),
4281 "gtk-tree-view-dest-row",
4282 dest_row ? gtk_tree_row_reference_new (model, dest_row) : NULL,
4283 (GDestroyNotify) (dest_row ? gtk_tree_row_reference_free : NULL));
4287 get_dest_row (GdkDragContext *context)
4289 GtkTreeRowReference *ref =
4290 g_object_get_data (G_OBJECT (context), "gtk-tree-view-dest-row");
4293 return gtk_tree_row_reference_get_path (ref);
4298 /* Get/set whether drag_motion requested the drag data and
4299 * drag_data_received should thus not actually insert the data,
4300 * since the data doesn't result from a drop.
4303 set_status_pending (GdkDragContext *context,
4304 GdkDragAction suggested_action)
4306 g_object_set_data (G_OBJECT (context),
4307 "gtk-tree-view-status-pending",
4308 GINT_TO_POINTER (suggested_action));
4311 static GdkDragAction
4312 get_status_pending (GdkDragContext *context)
4314 return GPOINTER_TO_INT (g_object_get_data (G_OBJECT (context),
4315 "gtk-tree-view-status-pending"));
4318 static TreeViewDragInfo*
4319 get_info (GtkTreeView *tree_view)
4321 return g_object_get_data (G_OBJECT (tree_view), "gtk-tree-view-drag-info");
4325 clear_source_info (TreeViewDragInfo *di)
4327 if (di->source_target_list)
4328 gtk_target_list_unref (di->source_target_list);
4330 di->source_target_list = NULL;
4334 clear_dest_info (TreeViewDragInfo *di)
4336 if (di->dest_target_list)
4337 gtk_target_list_unref (di->dest_target_list);
4339 di->dest_target_list = NULL;
4343 destroy_info (TreeViewDragInfo *di)
4345 clear_source_info (di);
4346 clear_dest_info (di);
4350 static TreeViewDragInfo*
4351 ensure_info (GtkTreeView *tree_view)
4353 TreeViewDragInfo *di;
4355 di = get_info (tree_view);
4359 di = g_new0 (TreeViewDragInfo, 1);
4361 g_object_set_data_full (G_OBJECT (tree_view),
4362 "gtk-tree-view-drag-info",
4364 (GDestroyNotify) destroy_info);
4371 remove_info (GtkTreeView *tree_view)
4373 g_object_set_data (G_OBJECT (tree_view), "gtk-tree-view-drag-info", NULL);
4378 drag_scan_timeout (gpointer data)
4380 GtkTreeView *tree_view;
4382 GdkModifierType state;
4383 GtkTreePath *path = NULL;
4384 GtkTreeViewColumn *column = NULL;
4385 GdkRectangle visible_rect;
4387 GDK_THREADS_ENTER ();
4389 tree_view = GTK_TREE_VIEW (data);
4391 gdk_window_get_pointer (tree_view->priv->bin_window,
4394 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
4396 /* See if we are near the edge. */
4397 if ((x - visible_rect.x) < SCROLL_EDGE_SIZE ||
4398 (visible_rect.x + visible_rect.width - x) < SCROLL_EDGE_SIZE ||
4399 (y - visible_rect.y) < SCROLL_EDGE_SIZE ||
4400 (visible_rect.y + visible_rect.height - y) < SCROLL_EDGE_SIZE)
4402 gtk_tree_view_get_path_at_pos (tree_view,
4403 tree_view->priv->bin_window,
4412 gtk_tree_view_scroll_to_cell (tree_view,
4418 gtk_tree_path_free (path);
4422 GDK_THREADS_LEAVE ();
4429 remove_scroll_timeout (GtkTreeView *tree_view)
4431 if (tree_view->priv->scroll_timeout != 0)
4433 gtk_timeout_remove (tree_view->priv->scroll_timeout);
4434 tree_view->priv->scroll_timeout = 0;
4438 check_model_dnd (GtkTreeModel *model,
4439 GType required_iface,
4440 const gchar *signal)
4442 if (model == NULL || !G_TYPE_CHECK_INSTANCE_TYPE ((model), required_iface))
4444 g_warning ("You must override the default '%s' handler "
4445 "on GtkTreeView when using models that don't support "
4446 "the %s interface and enabling drag-and-drop. The simplest way to do this "
4447 "is to connect to '%s' and call "
4448 "gtk_signal_emit_stop_by_name() in your signal handler to prevent "
4449 "the default handler from running. Look at the source code "
4450 "for the default handler in gtktreeview.c to get an idea what "
4451 "your handler should do. (gtktreeview.c is in the GTK source "
4452 "code.) If you're using GTK from a language other than C, "
4453 "there may be a more natural way to override default handlers, e.g. via derivation.",
4454 signal, g_type_name (required_iface), signal);
4462 remove_open_timeout (GtkTreeView *tree_view)
4464 if (tree_view->priv->open_dest_timeout != 0)
4466 gtk_timeout_remove (tree_view->priv->open_dest_timeout);
4467 tree_view->priv->open_dest_timeout = 0;
4473 open_row_timeout (gpointer data)
4475 GtkTreeView *tree_view = data;
4476 GtkTreePath *dest_path = NULL;
4477 GtkTreeViewDropPosition pos;
4478 gboolean result = FALSE;
4480 GDK_THREADS_ENTER ();
4482 gtk_tree_view_get_drag_dest_row (tree_view,
4487 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
4488 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
4490 gtk_tree_view_expand_row (tree_view, dest_path, FALSE);
4491 tree_view->priv->open_dest_timeout = 0;
4493 gtk_tree_path_free (dest_path);
4498 gtk_tree_path_free (dest_path);
4503 GDK_THREADS_LEAVE ();
4509 scroll_row_timeout (gpointer data)
4511 GtkTreeView *tree_view = data;
4513 GDK_THREADS_ENTER ();
4515 gtk_tree_view_vertical_autoscroll (tree_view);
4517 GDK_THREADS_LEAVE ();
4522 /* Returns TRUE if event should not be propagated to parent widgets */
4524 set_destination_row (GtkTreeView *tree_view,
4525 GdkDragContext *context,
4528 GdkDragAction *suggested_action,
4531 GtkTreePath *path = NULL;
4532 GtkTreeViewDropPosition pos;
4533 GtkTreeViewDropPosition old_pos;
4534 TreeViewDragInfo *di;
4536 GtkTreePath *old_dest_path = NULL;
4538 *suggested_action = 0;
4541 widget = GTK_WIDGET (tree_view);
4543 di = get_info (tree_view);
4547 /* someone unset us as a drag dest, note that if
4548 * we return FALSE drag_leave isn't called
4551 gtk_tree_view_set_drag_dest_row (tree_view,
4553 GTK_TREE_VIEW_DROP_BEFORE);
4555 remove_scroll_timeout (GTK_TREE_VIEW (widget));
4556 remove_open_timeout (GTK_TREE_VIEW (widget));
4558 return FALSE; /* no longer a drop site */
4561 *target = gtk_drag_dest_find_target (widget, context, di->dest_target_list);
4562 if (*target == GDK_NONE)
4567 if (!gtk_tree_view_get_dest_row_at_pos (tree_view,
4572 /* can't drop here */
4573 remove_open_timeout (tree_view);
4575 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
4577 GTK_TREE_VIEW_DROP_BEFORE);
4580 gtk_tree_path_free (path);
4582 /* don't propagate to parent though */
4588 /* If we left the current row's "open" zone, unset the timeout for
4591 gtk_tree_view_get_drag_dest_row (tree_view,
4595 if (old_dest_path &&
4596 (gtk_tree_path_compare (path, old_dest_path) != 0 ||
4597 !(pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
4598 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE)))
4599 remove_open_timeout (tree_view);
4602 gtk_tree_path_free (old_dest_path);
4604 if (TRUE /* FIXME if the location droppable predicate */)
4606 GtkWidget *source_widget;
4608 *suggested_action = context->suggested_action;
4610 source_widget = gtk_drag_get_source_widget (context);
4612 if (source_widget == widget)
4614 /* Default to MOVE, unless the user has
4615 * pressed ctrl or alt to affect available actions
4617 if ((context->actions & GDK_ACTION_MOVE) != 0)
4618 *suggested_action = GDK_ACTION_MOVE;
4621 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
4626 /* can't drop here */
4627 remove_open_timeout (tree_view);
4629 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
4631 GTK_TREE_VIEW_DROP_BEFORE);
4635 gtk_tree_path_free (path);
4640 get_logical_dest_row (GtkTreeView *tree_view)
4643 /* adjust path to point to the row the drop goes in front of */
4644 GtkTreePath *path = NULL;
4645 GtkTreeViewDropPosition pos;
4647 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
4652 if (pos == GTK_TREE_VIEW_DROP_BEFORE)
4654 else if (pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE ||
4655 pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER)
4657 /* get first child, drop before it */
4658 gtk_tree_path_down (path);
4663 GtkTreeModel *model = gtk_tree_view_get_model (tree_view);
4665 g_assert (pos == GTK_TREE_VIEW_DROP_AFTER);
4667 gtk_tree_model_get_iter (model, &iter, path);
4669 if (!gtk_tree_model_iter_next (model, &iter))
4670 g_object_set_data (G_OBJECT (model), "gtk-tree-model-drop-append",
4671 GINT_TO_POINTER (1));
4674 g_object_set_data (G_OBJECT (model), "gtk-tree-model-drop-append",
4676 gtk_tree_path_next (path);
4684 gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
4685 GdkEventMotion *event)
4687 GdkDragContext *context;
4688 TreeViewDragInfo *di;
4689 GtkTreePath *path = NULL;
4691 gint cell_x, cell_y;
4692 GtkTreeModel *model;
4693 gboolean retval = FALSE;
4695 di = get_info (tree_view);
4700 if (tree_view->priv->pressed_button < 0)
4703 if (!gtk_drag_check_threshold (GTK_WIDGET (tree_view),
4704 tree_view->priv->press_start_x,
4705 tree_view->priv->press_start_y,
4706 event->x, event->y))
4709 model = gtk_tree_view_get_model (tree_view);
4714 button = tree_view->priv->pressed_button;
4715 tree_view->priv->pressed_button = -1;
4717 gtk_tree_view_get_path_at_pos (tree_view,
4718 tree_view->priv->press_start_x,
4719 tree_view->priv->press_start_y,
4728 if (!GTK_IS_TREE_DRAG_SOURCE (model) ||
4729 !gtk_tree_drag_source_row_draggable (GTK_TREE_DRAG_SOURCE (model),
4733 /* FIXME Check whether we're a start button, if not return FALSE and
4737 /* Now we can begin the drag */
4741 context = gtk_drag_begin (GTK_WIDGET (tree_view),
4742 di->source_target_list,
4747 gtk_drag_set_icon_default (context);
4752 row_pix = gtk_tree_view_create_row_drag_icon (tree_view,
4755 gtk_drag_set_icon_pixmap (context,
4756 gdk_drawable_get_colormap (row_pix),
4759 /* the + 1 is for the black border in the icon */
4760 tree_view->priv->press_start_x + 1,
4763 gdk_pixmap_unref (row_pix);
4766 set_source_row (context, model, path);
4770 gtk_tree_path_free (path);
4777 gtk_tree_view_drag_begin (GtkWidget *widget,
4778 GdkDragContext *context)
4784 gtk_tree_view_drag_end (GtkWidget *widget,
4785 GdkDragContext *context)
4790 /* Default signal implementations for the drag signals */
4792 gtk_tree_view_drag_data_get (GtkWidget *widget,
4793 GdkDragContext *context,
4794 GtkSelectionData *selection_data,
4798 GtkTreeView *tree_view;
4799 GtkTreeModel *model;
4800 TreeViewDragInfo *di;
4801 GtkTreePath *source_row;
4803 tree_view = GTK_TREE_VIEW (widget);
4805 model = gtk_tree_view_get_model (tree_view);
4810 di = get_info (GTK_TREE_VIEW (widget));
4815 source_row = get_source_row (context);
4817 if (source_row == NULL)
4820 /* We can implement the GTK_TREE_MODEL_ROW target generically for
4821 * any model; for DragSource models there are some other targets
4825 if (GTK_IS_TREE_DRAG_SOURCE (model) &&
4826 gtk_tree_drag_source_drag_data_get (GTK_TREE_DRAG_SOURCE (model),
4831 /* If drag_data_get does nothing, try providing row data. */
4832 if (selection_data->target == gdk_atom_intern ("GTK_TREE_MODEL_ROW", FALSE))
4834 gtk_tree_set_row_drag_data (selection_data,
4840 gtk_tree_path_free (source_row);
4845 gtk_tree_view_drag_data_delete (GtkWidget *widget,
4846 GdkDragContext *context)
4848 TreeViewDragInfo *di;
4849 GtkTreeModel *model;
4850 GtkTreeView *tree_view;
4851 GtkTreePath *source_row;
4853 tree_view = GTK_TREE_VIEW (widget);
4854 model = gtk_tree_view_get_model (tree_view);
4856 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_SOURCE, "drag_data_delete"))
4859 di = get_info (tree_view);
4864 source_row = get_source_row (context);
4866 if (source_row == NULL)
4869 gtk_tree_drag_source_drag_data_delete (GTK_TREE_DRAG_SOURCE (model),
4872 gtk_tree_path_free (source_row);
4874 set_source_row (context, NULL, NULL);
4878 gtk_tree_view_drag_leave (GtkWidget *widget,
4879 GdkDragContext *context,
4882 TreeViewDragInfo *di;
4884 di = get_info (GTK_TREE_VIEW (widget));
4886 /* unset any highlight row */
4887 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
4889 GTK_TREE_VIEW_DROP_BEFORE);
4891 remove_scroll_timeout (GTK_TREE_VIEW (widget));
4892 remove_open_timeout (GTK_TREE_VIEW (widget));
4897 gtk_tree_view_drag_motion (GtkWidget *widget,
4898 GdkDragContext *context,
4903 GtkTreePath *path = NULL;
4904 GtkTreeViewDropPosition pos;
4905 GtkTreeView *tree_view;
4906 GdkDragAction suggested_action = 0;
4909 tree_view = GTK_TREE_VIEW (widget);
4911 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
4914 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
4918 /* Can't drop here. */
4919 gdk_drag_status (context, 0, time);
4923 if (tree_view->priv->open_dest_timeout == 0 &&
4924 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
4925 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
4927 tree_view->priv->open_dest_timeout =
4928 gtk_timeout_add (500, open_row_timeout, tree_view);
4930 else if (tree_view->priv->scroll_timeout == 0)
4932 tree_view->priv->scroll_timeout =
4933 gtk_timeout_add (150, scroll_row_timeout, tree_view);
4936 if (target == gdk_atom_intern ("GTK_TREE_MODEL_ROW", FALSE))
4938 /* Request data so we can use the source row when
4939 * determining whether to accept the drop
4941 set_status_pending (context, suggested_action);
4942 gtk_drag_get_data (widget, context, target, time);
4946 set_status_pending (context, 0);
4947 gdk_drag_status (context, suggested_action, time);
4952 gtk_tree_path_free (path);
4959 gtk_tree_view_drag_drop (GtkWidget *widget,
4960 GdkDragContext *context,
4965 GtkTreeView *tree_view;
4967 GdkDragAction suggested_action = 0;
4968 GdkAtom target = GDK_NONE;
4969 TreeViewDragInfo *di;
4970 GtkTreeModel *model;
4972 tree_view = GTK_TREE_VIEW (widget);
4974 model = gtk_tree_view_get_model (tree_view);
4976 remove_scroll_timeout (GTK_TREE_VIEW (widget));
4977 remove_open_timeout (GTK_TREE_VIEW (widget));
4979 di = get_info (tree_view);
4984 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_drop"))
4987 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
4990 path = get_logical_dest_row (tree_view);
4992 if (target != GDK_NONE && path != NULL)
4994 /* in case a motion had requested drag data, change things so we
4995 * treat drag data receives as a drop.
4997 set_status_pending (context, 0);
4999 set_dest_row (context, model, path);
5003 gtk_tree_path_free (path);
5005 /* Unset this thing */
5006 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
5008 GTK_TREE_VIEW_DROP_BEFORE);
5010 if (target != GDK_NONE)
5012 gtk_drag_get_data (widget, context, target, time);
5020 gtk_tree_view_drag_data_received (GtkWidget *widget,
5021 GdkDragContext *context,
5024 GtkSelectionData *selection_data,
5029 TreeViewDragInfo *di;
5030 gboolean accepted = FALSE;
5031 GtkTreeModel *model;
5032 GtkTreeView *tree_view;
5033 GtkTreePath *dest_row;
5034 GdkDragAction suggested_action;
5036 tree_view = GTK_TREE_VIEW (widget);
5038 model = gtk_tree_view_get_model (tree_view);
5040 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_data_received"))
5043 di = get_info (tree_view);
5048 suggested_action = get_status_pending (context);
5050 if (suggested_action)
5052 /* We are getting this data due to a request in drag_motion,
5053 * rather than due to a request in drag_drop, so we are just
5054 * supposed to call drag_status, not actually paste in the
5057 path = get_logical_dest_row (tree_view);
5060 suggested_action = 0;
5062 if (suggested_action)
5064 if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model),
5067 suggested_action = 0;
5070 gdk_drag_status (context, suggested_action, time);
5073 gtk_tree_path_free (path);
5075 /* If you can't drop, remove user drop indicator until the next motion */
5076 if (suggested_action == 0)
5077 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
5079 GTK_TREE_VIEW_DROP_BEFORE);
5084 dest_row = get_dest_row (context);
5086 if (dest_row == NULL)
5089 if (selection_data->length >= 0)
5091 if (gtk_tree_drag_dest_drag_data_received (GTK_TREE_DRAG_DEST (model),
5097 gtk_drag_finish (context,
5099 (context->action == GDK_ACTION_MOVE),
5102 gtk_tree_path_free (dest_row);
5105 set_dest_row (context, NULL, NULL);
5110 /* GtkContainer Methods
5115 gtk_tree_view_remove (GtkContainer *container,
5118 GtkTreeView *tree_view;
5119 GtkTreeViewChild *child = NULL;
5122 g_return_if_fail (GTK_IS_TREE_VIEW (container));
5124 tree_view = GTK_TREE_VIEW (container);
5126 tmp_list = tree_view->priv->children;
5129 child = tmp_list->data;
5130 if (child->widget == widget)
5132 gtk_widget_unparent (widget);
5134 tree_view->priv->children = g_list_remove_link (tree_view->priv->children, tmp_list);
5135 g_list_free_1 (tmp_list);
5140 tmp_list = tmp_list->next;
5143 tmp_list = tree_view->priv->columns;
5147 GtkTreeViewColumn *column;
5148 column = tmp_list->data;
5149 if (column->button == widget)
5151 gtk_widget_unparent (widget);
5154 tmp_list = tmp_list->next;
5159 gtk_tree_view_forall (GtkContainer *container,
5160 gboolean include_internals,
5161 GtkCallback callback,
5162 gpointer callback_data)
5164 GtkTreeView *tree_view;
5165 GtkTreeViewChild *child = NULL;
5166 GtkTreeViewColumn *column;
5169 g_return_if_fail (GTK_IS_TREE_VIEW (container));
5170 g_return_if_fail (callback != NULL);
5172 tree_view = GTK_TREE_VIEW (container);
5174 tmp_list = tree_view->priv->children;
5177 child = tmp_list->data;
5178 tmp_list = tmp_list->next;
5180 (* callback) (child->widget, callback_data);
5182 if (include_internals == FALSE)
5185 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
5187 column = tmp_list->data;
5190 (* callback) (column->button, callback_data);
5194 /* Returns TRUE if the focus is within the headers, after the focus operation is
5198 gtk_tree_view_header_focus (GtkTreeView *tree_view,
5199 GtkDirectionType dir)
5201 GtkWidget *focus_child;
5202 GtkContainer *container;
5204 GList *last_column, *first_column;
5207 if (! GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
5210 focus_child = GTK_CONTAINER (tree_view)->focus_child;
5211 container = GTK_CONTAINER (tree_view);
5213 first_column = tree_view->priv->columns;
5214 while (first_column)
5216 if (GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (first_column->data)->button) &&
5217 GTK_TREE_VIEW_COLUMN (first_column->data)->visible &&
5218 (GTK_TREE_VIEW_COLUMN (first_column->data)->clickable ||
5219 GTK_TREE_VIEW_COLUMN (first_column->data)->reorderable))
5221 first_column = first_column->next;
5224 /* No headers are visible, or are focusable. We can't focus in or out.
5226 if (first_column == NULL)
5229 last_column = g_list_last (tree_view->priv->columns);
5232 if (GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (last_column->data)->button) &&
5233 GTK_TREE_VIEW_COLUMN (last_column->data)->visible &&
5234 (GTK_TREE_VIEW_COLUMN (last_column->data)->clickable ||
5235 GTK_TREE_VIEW_COLUMN (last_column->data)->reorderable))
5237 last_column = last_column->prev;
5243 case GTK_DIR_TAB_BACKWARD:
5244 case GTK_DIR_TAB_FORWARD:
5247 if (focus_child == NULL)
5249 if (tree_view->priv->focus_column != NULL)
5250 focus_child = tree_view->priv->focus_column->button;
5252 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
5253 gtk_widget_grab_focus (focus_child);
5260 if (focus_child == NULL)
5262 if (tree_view->priv->focus_column != NULL)
5263 focus_child = tree_view->priv->focus_column->button;
5264 else if (dir == GTK_DIR_LEFT)
5265 focus_child = GTK_TREE_VIEW_COLUMN (last_column->data)->button;
5267 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
5268 gtk_widget_grab_focus (focus_child);
5272 if (gtk_widget_child_focus (focus_child, dir))
5274 /* The focus moves inside the button. */
5275 /* This is probably a great example of bad UI */
5279 /* We need to move the focus among the row of buttons. */
5280 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
5281 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
5284 if (tmp_list == first_column && dir == GTK_DIR_LEFT)
5286 focus_child = GTK_TREE_VIEW_COLUMN (last_column->data)->button;
5287 gtk_widget_grab_focus (focus_child);
5290 else if (tmp_list == last_column && dir == GTK_DIR_RIGHT)
5292 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
5293 gtk_widget_grab_focus (focus_child);
5299 GtkTreeViewColumn *column;
5301 if (dir == GTK_DIR_RIGHT)
5302 tmp_list = tmp_list->next;
5304 tmp_list = tmp_list->prev;
5306 if (tmp_list == NULL)
5308 g_warning ("Internal button not found");
5311 column = tmp_list->data;
5312 if (column->button &&
5314 GTK_WIDGET_CAN_FOCUS (column->button))
5316 focus_child = column->button;
5317 gtk_widget_grab_focus (column->button);
5323 g_assert_not_reached ();
5327 /* if focus child is non-null, we assume it's been set to the current focus child
5331 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
5332 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
5335 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5337 /* If the following isn't true, then the view is smaller then the scrollpane.
5339 if ((focus_child->allocation.x + focus_child->allocation.width) <=
5340 (tree_view->priv->hadjustment->upper))
5342 /* Scroll to the button, if needed */
5343 if ((tree_view->priv->hadjustment->value + tree_view->priv->hadjustment->page_size) <
5344 (focus_child->allocation.x + focus_child->allocation.width))
5345 gtk_adjustment_set_value (tree_view->priv->hadjustment,
5346 focus_child->allocation.x + focus_child->allocation.width -
5347 tree_view->priv->hadjustment->page_size);
5348 else if (tree_view->priv->hadjustment->value > focus_child->allocation.x)
5349 gtk_adjustment_set_value (tree_view->priv->hadjustment,
5350 focus_child->allocation.x);
5354 return (focus_child != NULL);
5358 gtk_tree_view_focus (GtkWidget *widget,
5359 GtkDirectionType direction)
5361 GtkTreeView *tree_view;
5362 GtkWidget *focus_child;
5363 GtkContainer *container;
5365 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
5366 g_return_val_if_fail (GTK_WIDGET_VISIBLE (widget), FALSE);
5368 container = GTK_CONTAINER (widget);
5369 tree_view = GTK_TREE_VIEW (widget);
5371 if (!GTK_WIDGET_IS_SENSITIVE (container))
5374 focus_child = container->focus_child;
5376 gtk_tree_view_stop_editing (GTK_TREE_VIEW (widget), FALSE);
5377 /* Case 1. Headers currently have focus. */
5384 gtk_tree_view_header_focus (tree_view, direction);
5386 case GTK_DIR_TAB_BACKWARD:
5389 case GTK_DIR_TAB_FORWARD:
5391 if (tree_view->priv->tree == NULL)
5393 gtk_widget_grab_focus (widget);
5398 /* Case 2. We don't have focus at all. */
5399 if (!GTK_WIDGET_HAS_FOCUS (container))
5401 if (tree_view->priv->tree == NULL &&
5402 (direction == GTK_DIR_TAB_BACKWARD ||
5403 direction == GTK_DIR_UP))
5404 return gtk_tree_view_header_focus (tree_view, direction);
5405 if (((direction == GTK_DIR_TAB_FORWARD) ||
5406 (direction == GTK_DIR_RIGHT) ||
5407 (direction == GTK_DIR_DOWN) ||
5408 (direction == GTK_DIR_LEFT)) &&
5409 gtk_tree_view_header_focus (tree_view, direction))
5412 if (tree_view->priv->tree == NULL)
5414 gtk_widget_grab_focus (widget);
5418 /* Case 3. We have focus already. */
5419 if (tree_view->priv->tree == NULL)
5420 return gtk_tree_view_header_focus (tree_view, direction);
5422 if (direction == GTK_DIR_TAB_BACKWARD)
5423 return (gtk_tree_view_header_focus (tree_view, direction));
5424 else if (direction == GTK_DIR_TAB_FORWARD)
5427 /* Other directions caught by the keybindings */
5428 gtk_widget_grab_focus (widget);
5433 gtk_tree_view_grab_focus (GtkWidget *widget)
5435 (* GTK_WIDGET_CLASS (parent_class)->grab_focus) (widget);
5437 gtk_tree_view_focus_to_cursor (GTK_TREE_VIEW (widget));
5441 gtk_tree_view_style_set (GtkWidget *widget,
5442 GtkStyle *previous_style)
5444 GtkTreeView *tree_view;
5446 GtkTreeViewColumn *column;
5448 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
5450 tree_view = GTK_TREE_VIEW (widget);
5452 gtk_widget_style_get (widget,
5453 "expander_size", &tree_view->priv->expander_size,
5455 tree_view->priv->expander_size += EXPANDER_EXTRA_PADDING;
5457 for (list = tree_view->priv->columns; list; list = list->next)
5459 column = list->data;
5460 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
5463 _gtk_rbtree_mark_invalid (tree_view->priv->tree);
5465 gtk_widget_queue_resize (widget);
5470 gtk_tree_view_set_focus_child (GtkContainer *container,
5473 GtkTreeView *tree_view = GTK_TREE_VIEW (container);
5476 for (list = tree_view->priv->columns; list; list = list->next)
5478 if (GTK_TREE_VIEW_COLUMN (list->data)->button == child)
5480 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (list->data);
5485 (* parent_class->set_focus_child) (container, child);
5489 gtk_tree_view_set_adjustments (GtkTreeView *tree_view,
5490 GtkAdjustment *hadj,
5491 GtkAdjustment *vadj)
5493 gboolean need_adjust = FALSE;
5495 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
5498 g_return_if_fail (GTK_IS_ADJUSTMENT (hadj));
5500 hadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
5502 g_return_if_fail (GTK_IS_ADJUSTMENT (vadj));
5504 vadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
5506 if (tree_view->priv->hadjustment && (tree_view->priv->hadjustment != hadj))
5508 gtk_signal_disconnect_by_data (GTK_OBJECT (tree_view->priv->hadjustment), tree_view);
5509 gtk_object_unref (GTK_OBJECT (tree_view->priv->hadjustment));
5512 if (tree_view->priv->vadjustment && (tree_view->priv->vadjustment != vadj))
5514 gtk_signal_disconnect_by_data (GTK_OBJECT (tree_view->priv->vadjustment), tree_view);
5515 gtk_object_unref (GTK_OBJECT (tree_view->priv->vadjustment));
5518 if (tree_view->priv->hadjustment != hadj)
5520 tree_view->priv->hadjustment = hadj;
5521 gtk_object_ref (GTK_OBJECT (tree_view->priv->hadjustment));
5522 gtk_object_sink (GTK_OBJECT (tree_view->priv->hadjustment));
5524 gtk_signal_connect (GTK_OBJECT (tree_view->priv->hadjustment), "value_changed",
5525 (GtkSignalFunc) gtk_tree_view_adjustment_changed,
5530 if (tree_view->priv->vadjustment != vadj)
5532 tree_view->priv->vadjustment = vadj;
5533 gtk_object_ref (GTK_OBJECT (tree_view->priv->vadjustment));
5534 gtk_object_sink (GTK_OBJECT (tree_view->priv->vadjustment));
5536 gtk_signal_connect (GTK_OBJECT (tree_view->priv->vadjustment), "value_changed",
5537 (GtkSignalFunc) gtk_tree_view_adjustment_changed,
5543 gtk_tree_view_adjustment_changed (NULL, tree_view);
5548 gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
5549 GtkMovementStep step,
5552 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
5553 g_return_val_if_fail (step == GTK_MOVEMENT_LOGICAL_POSITIONS ||
5554 step == GTK_MOVEMENT_VISUAL_POSITIONS ||
5555 step == GTK_MOVEMENT_DISPLAY_LINES ||
5556 step == GTK_MOVEMENT_PAGES ||
5557 step == GTK_MOVEMENT_BUFFER_ENDS, FALSE);
5559 if (tree_view->priv->tree == NULL)
5561 if (!GTK_WIDGET_HAS_FOCUS (GTK_WIDGET (tree_view)))
5564 gtk_tree_view_stop_editing (tree_view, FALSE);
5565 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
5566 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5570 /* currently we make no distinction. When we go bi-di, we need to */
5571 case GTK_MOVEMENT_LOGICAL_POSITIONS:
5572 case GTK_MOVEMENT_VISUAL_POSITIONS:
5573 gtk_tree_view_move_cursor_left_right (tree_view, count);
5575 case GTK_MOVEMENT_DISPLAY_LINES:
5576 gtk_tree_view_move_cursor_up_down (tree_view, count);
5578 case GTK_MOVEMENT_PAGES:
5579 gtk_tree_view_move_cursor_page_up_down (tree_view, count);
5581 case GTK_MOVEMENT_BUFFER_ENDS:
5582 gtk_tree_view_move_cursor_start_end (tree_view, count);
5585 g_assert_not_reached ();
5592 gtk_tree_view_put (GtkTreeView *tree_view,
5593 GtkWidget *child_widget,
5599 GtkTreeViewChild *child;
5601 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
5602 g_return_if_fail (GTK_IS_WIDGET (child_widget));
5604 child = g_new (GtkTreeViewChild, 1);
5606 child->widget = child_widget;
5609 child->width = width;
5610 child->height = height;
5612 tree_view->priv->children = g_list_append (tree_view->priv->children, child);
5614 if (GTK_WIDGET_REALIZED (tree_view))
5615 gtk_widget_set_parent_window (child->widget, tree_view->priv->bin_window);
5617 gtk_widget_set_parent (child_widget, GTK_WIDGET (tree_view));
5621 _gtk_tree_view_child_move_resize (GtkTreeView *tree_view,
5628 GtkTreeViewChild *child = NULL;
5630 GdkRectangle allocation;
5632 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
5633 g_return_if_fail (GTK_IS_WIDGET (widget));
5635 for (list = tree_view->priv->children; list; list = list->next)
5637 if (((GtkTreeViewChild *)list->data)->widget == widget)
5646 allocation.x = child->x = x;
5647 allocation.y = child->y = y;
5648 allocation.width = child->width = width;
5649 allocation.height = child->height = height;
5651 if (GTK_WIDGET_REALIZED (widget))
5652 gtk_widget_size_allocate (widget, &allocation);
5656 /* TreeModel Callbacks
5660 gtk_tree_view_row_changed (GtkTreeModel *model,
5665 GtkTreeView *tree_view = (GtkTreeView *)data;
5668 gboolean free_path = FALSE;
5669 gint vertical_separator;
5672 g_return_if_fail (path != NULL || iter != NULL);
5674 if (!GTK_WIDGET_REALIZED (tree_view))
5675 /* We can just ignore ::changed signals if we aren't realized, as we don't care about sizes
5679 if (tree_view->priv->edited_column)
5680 gtk_tree_view_stop_editing (tree_view, TRUE);
5682 gtk_widget_style_get (GTK_WIDGET (data), "vertical_separator", &vertical_separator, NULL);
5686 path = gtk_tree_model_get_path (model, iter);
5689 else if (iter == NULL)
5690 gtk_tree_model_get_iter (model, iter, path);
5692 if (_gtk_tree_view_find_node (tree_view,
5696 /* We aren't actually showing the node */
5702 _gtk_rbtree_node_mark_invalid (tree, node);
5703 for (list = tree_view->priv->columns; list; list = list->next)
5705 GtkTreeViewColumn *column;
5707 column = list->data;
5708 if (! column->visible)
5711 if (column->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
5713 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
5718 install_presize_handler (tree_view);
5720 gtk_tree_path_free (path);
5724 gtk_tree_view_row_inserted (GtkTreeModel *model,
5729 GtkTreeView *tree_view = (GtkTreeView *) data;
5731 GtkRBTree *tmptree, *tree;
5732 GtkRBNode *tmpnode = NULL;
5735 gboolean free_path = FALSE;
5737 g_return_if_fail (path != NULL || iter != NULL);
5741 path = gtk_tree_model_get_path (model, iter);
5744 else if (iter == NULL)
5745 gtk_tree_model_get_iter (model, iter, path);
5747 if (tree_view->priv->tree == NULL)
5748 tree_view->priv->tree = _gtk_rbtree_new ();
5750 tmptree = tree = tree_view->priv->tree;
5752 /* Update all row-references */
5753 gtk_tree_row_reference_inserted (G_OBJECT (data), path);
5754 depth = gtk_tree_path_get_depth (path);
5755 indices = gtk_tree_path_get_indices (path);
5757 /* First, find the parent tree */
5758 while (i < depth - 1)
5760 if (tmptree == NULL)
5762 /* We aren't showing the node */
5766 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
5767 if (tmpnode == NULL)
5769 g_warning ("A node was inserted with a parent that's not in the tree.\n" \
5770 "This possibly means that a GtkTreeModel inserted a child node\n" \
5771 "before the parent was inserted.");
5774 else if (!GTK_RBNODE_FLAG_SET (tmpnode, GTK_RBNODE_IS_PARENT))
5776 /* FIXME enforce correct behavior on model, probably */
5777 /* In theory, the model should have emitted has_child_toggled here. We
5778 * try to catch it anyway, just to be safe, in case the model hasn't.
5780 GtkTreePath *tmppath = _gtk_tree_view_find_path (tree_view,
5783 gtk_tree_view_row_has_child_toggled (model, tmppath, NULL, data);
5784 gtk_tree_path_free (tmppath);
5788 tmptree = tmpnode->children;
5797 gtk_tree_model_ref_node (tree_view->priv->model, iter);
5798 if (indices[depth - 1] == 0)
5800 tmpnode = _gtk_rbtree_find_count (tree, 1);
5801 _gtk_rbtree_insert_before (tree, tmpnode, 0, FALSE);
5805 tmpnode = _gtk_rbtree_find_count (tree, indices[depth - 1]);
5806 _gtk_rbtree_insert_after (tree, tmpnode, 0, FALSE);
5810 install_presize_handler (tree_view);
5812 gtk_tree_path_free (path);
5816 gtk_tree_view_row_has_child_toggled (GtkTreeModel *model,
5821 GtkTreeView *tree_view = (GtkTreeView *)data;
5822 GtkTreeIter real_iter;
5826 gboolean free_path = FALSE;
5828 g_return_if_fail (path != NULL || iter != NULL);
5835 path = gtk_tree_model_get_path (model, iter);
5838 else if (iter == NULL)
5839 gtk_tree_model_get_iter (model, &real_iter, path);
5841 if (_gtk_tree_view_find_node (tree_view,
5845 /* We aren't actually showing the node */
5851 has_child = gtk_tree_model_iter_has_child (model, &real_iter);
5854 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT) == has_child)
5858 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PARENT);
5860 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_PARENT);
5862 if (has_child && GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST))
5864 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
5865 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS))
5869 for (list = tree_view->priv->columns; list; list = list->next)
5870 if (GTK_TREE_VIEW_COLUMN (list->data)->visible)
5872 GTK_TREE_VIEW_COLUMN (list->data)->dirty = TRUE;
5873 _gtk_tree_view_column_cell_set_dirty (GTK_TREE_VIEW_COLUMN (list->data), TRUE);
5877 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
5881 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
5886 gtk_tree_path_free (path);
5890 count_children_helper (GtkRBTree *tree,
5895 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, data);
5896 (*((gint *)data))++;
5900 gtk_tree_view_row_deleted (GtkTreeModel *model,
5904 GtkTreeView *tree_view = (GtkTreeView *)data;
5908 gint selection_changed;
5910 g_return_if_fail (path != NULL);
5912 gtk_tree_row_reference_deleted (G_OBJECT (data), path);
5914 if (_gtk_tree_view_find_node (tree_view, path, &tree, &node))
5920 /* Change the selection */
5921 selection_changed = GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED);
5923 for (list = tree_view->priv->columns; list; list = list->next)
5924 if (((GtkTreeViewColumn *)list->data)->visible &&
5925 ((GtkTreeViewColumn *)list->data)->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
5926 _gtk_tree_view_column_cell_set_dirty ((GtkTreeViewColumn *)list->data, TRUE);
5928 /* Ensure we don't have a dangling pointer to a dead node */
5929 ensure_unprelighted (tree_view);
5931 /* Cancel editting if we've started */
5932 gtk_tree_view_stop_editing (tree_view, TRUE);
5934 /* If we have a node expanded/collapsed timeout, remove it */
5935 if (tree_view->priv->expand_collapse_timeout != 0)
5937 gtk_timeout_remove (tree_view->priv->expand_collapse_timeout);
5938 tree_view->priv->expand_collapse_timeout = 0;
5941 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_COLLAPSED);
5942 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_EXPANDED);
5943 tree_view->priv->expanded_collapsed_node = NULL;
5946 if (tree_view->priv->destroy_count_func)
5948 gint child_count = 0;
5950 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, &child_count);
5951 (* tree_view->priv->destroy_count_func) (tree_view, path, child_count, tree_view->priv->destroy_count_data);
5954 if (tree->root->count == 1)
5956 if (tree_view->priv->tree == tree)
5957 tree_view->priv->tree = NULL;
5959 _gtk_rbtree_remove (tree);
5963 _gtk_rbtree_remove_node (tree, node);
5966 install_scroll_sync_handler (tree_view);
5968 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
5970 if (selection_changed)
5971 g_signal_emit_by_name (G_OBJECT (tree_view->priv->selection), "changed");
5976 gtk_tree_view_rows_reordered (GtkTreeModel *model,
5977 GtkTreePath *parent,
5982 GtkTreeView *tree_view = GTK_TREE_VIEW (data);
5987 len = gtk_tree_model_iter_n_children (model, iter);
5992 gtk_tree_row_reference_reordered (G_OBJECT (data),
5997 if (_gtk_tree_view_find_node (tree_view,
6003 /* We need to special case the parent path */
6005 tree = tree_view->priv->tree;
6007 tree = node->children;
6012 /* we need to be unprelighted */
6013 ensure_unprelighted (tree_view);
6015 _gtk_rbtree_reorder (tree, new_order, len);
6017 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
6019 gtk_tree_view_dy_to_top_row (tree_view);
6023 /* Internal tree functions
6028 gtk_tree_view_get_background_xrange (GtkTreeView *tree_view,
6030 GtkTreeViewColumn *column,
6034 GtkTreeViewColumn *tmp_column = NULL;
6045 for (list = tree_view->priv->columns; list; list = list->next)
6047 tmp_column = list->data;
6049 if (tmp_column == column)
6052 if (tmp_column->visible)
6053 total_width += tmp_column->width;
6056 if (tmp_column != column)
6058 g_warning (G_STRLOC": passed-in column isn't in the tree");
6067 if (column->visible)
6068 *x2 = total_width + column->width;
6070 *x2 = total_width; /* width of 0 */
6074 gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
6081 GtkTreeViewColumn *tmp_column = NULL;
6083 gboolean indent_expanders;
6086 for (list = tree_view->priv->columns; list; list = list->next)
6088 tmp_column = list->data;
6090 if (gtk_tree_view_is_expander_column (tree_view, tmp_column))
6092 x_offset = total_width;
6096 if (tmp_column->visible)
6097 total_width += tmp_column->width;
6100 gtk_widget_style_get (GTK_WIDGET (tree_view),
6101 "indent_expanders", &indent_expanders,
6104 if (indent_expanders)
6105 x_offset += tree_view->priv->expander_size * _gtk_rbtree_get_depth (tree);
6110 if (tmp_column && tmp_column->visible)
6112 /* +1 because x2 isn't included in the range. */
6114 *x2 = x_offset + tree_view->priv->expander_size + 1;
6118 /* return an empty range, the expander column is hidden */
6125 gtk_tree_view_build_tree (GtkTreeView *tree_view,
6131 GtkRBNode *temp = NULL;
6135 gtk_tree_model_ref_node (tree_view->priv->model, iter);
6136 temp = _gtk_rbtree_insert_after (tree, temp, 0, FALSE);
6141 if (gtk_tree_model_iter_children (tree_view->priv->model, &child, iter))
6143 temp->children = _gtk_rbtree_new ();
6144 temp->children->parent_tree = tree;
6145 temp->children->parent_node = temp;
6146 gtk_tree_view_build_tree (tree_view, temp->children, &child, depth + 1, recurse);
6149 if (gtk_tree_model_iter_has_child (tree_view->priv->model, iter))
6151 if ((temp->flags>K_RBNODE_IS_PARENT) != GTK_RBNODE_IS_PARENT)
6152 temp->flags ^= GTK_RBNODE_IS_PARENT;
6153 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
6156 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
6159 /* If height is non-NULL, then we set it to be the new height. if it's all
6160 * dirty, then height is -1. We know we'll remeasure dirty rows, anyways.
6163 gtk_tree_view_discover_dirty_iter (GtkTreeView *tree_view,
6169 GtkTreeViewColumn *column;
6171 gboolean retval = FALSE;
6173 gint horizontal_separator;
6175 gtk_widget_style_get (GTK_WIDGET (tree_view),
6176 "horizontal_separator", &horizontal_separator,
6182 for (list = tree_view->priv->columns; list; list = list->next)
6185 column = list->data;
6186 if (column->dirty == TRUE)
6188 if (height == NULL && column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
6190 if (!column->visible)
6193 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter,
6194 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
6195 node->children?TRUE:FALSE);
6199 gtk_tree_view_column_cell_get_size (column,
6201 &width, &tmpheight);
6202 *height = MAX (*height, tmpheight);
6206 gtk_tree_view_column_cell_get_size (column,
6211 if (gtk_tree_view_is_expander_column (tree_view, column) &&
6212 TREE_VIEW_DRAW_EXPANDERS (tree_view))
6214 if (depth * tree_view->priv->expander_size + horizontal_separator + width > column->requested_width)
6216 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
6222 if (horizontal_separator + width > column->requested_width)
6224 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
6234 gtk_tree_view_discover_dirty (GtkTreeView *tree_view,
6239 GtkRBNode *temp = tree->root;
6240 GtkTreeViewColumn *column;
6243 gboolean is_all_dirty;
6245 TREE_VIEW_INTERNAL_ASSERT_VOID (tree != NULL);
6247 while (temp->left != tree->nil)
6252 TREE_VIEW_INTERNAL_ASSERT_VOID (temp != NULL);
6253 is_all_dirty = TRUE;
6254 for (list = tree_view->priv->columns; list; list = list->next)
6256 column = list->data;
6257 if (column->dirty == FALSE)
6259 is_all_dirty = FALSE;
6267 gtk_tree_view_discover_dirty_iter (tree_view,
6272 if (gtk_tree_model_iter_children (tree_view->priv->model, &child, iter) &&
6273 temp->children != NULL)
6274 gtk_tree_view_discover_dirty (tree_view, temp->children, &child, depth + 1);
6275 temp = _gtk_rbtree_next (tree, temp);
6277 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
6281 /* Make sure the node is visible vertically */
6283 gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
6287 GdkRectangle cell_rect;
6288 GdkRectangle vis_rect;
6291 /* We process updates because we want to clear old selected items when we scroll.
6292 * if this is removed, we get a "selection streak" at the bottom. */
6293 if (!GTK_WIDGET_REALIZED (tree_view))
6296 gdk_window_process_updates (tree_view->priv->bin_window, TRUE);
6297 cell_rect.y = TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, BACKGROUND_FIRST_PIXEL (tree_view, tree, node));
6298 cell_rect.height = BACKGROUND_HEIGHT (node);
6299 gtk_tree_view_get_visible_rect (tree_view, &vis_rect);
6301 dest_y = vis_rect.y;
6303 if (cell_rect.y + cell_rect.height > vis_rect.y + vis_rect.height)
6304 dest_y = cell_rect.y + cell_rect.height - vis_rect.height;
6305 if (cell_rect.y < vis_rect.y)
6306 dest_y = cell_rect.y;
6308 gtk_tree_view_scroll_to_point (tree_view, -1, dest_y);
6312 gtk_tree_view_clamp_column_visible (GtkTreeView *tree_view,
6313 GtkTreeViewColumn *column)
6317 if ((tree_view->priv->hadjustment->value + tree_view->priv->hadjustment->page_size) <
6318 (column->button->allocation.x + column->button->allocation.width))
6319 gtk_adjustment_set_value (tree_view->priv->hadjustment,
6320 column->button->allocation.x + column->button->allocation.width -
6321 tree_view->priv->hadjustment->page_size);
6322 else if (tree_view->priv->hadjustment->value > column->button->allocation.x)
6323 gtk_adjustment_set_value (tree_view->priv->hadjustment,
6324 column->button->allocation.x);
6327 /* This function could be more efficient. I'll optimize it if profiling seems
6328 * to imply that it is important */
6330 _gtk_tree_view_find_path (GtkTreeView *tree_view,
6335 GtkRBTree *tmp_tree;
6336 GtkRBNode *tmp_node, *last;
6339 path = gtk_tree_path_new ();
6341 g_return_val_if_fail (node != NULL, path);
6342 g_return_val_if_fail (node != tree->nil, path);
6344 count = 1 + node->left->count;
6347 tmp_node = node->parent;
6351 while (tmp_node != tmp_tree->nil)
6353 if (tmp_node->right == last)
6354 count += 1 + tmp_node->left->count;
6356 tmp_node = tmp_node->parent;
6358 gtk_tree_path_prepend_index (path, count - 1);
6359 last = tmp_tree->parent_node;
6360 tmp_tree = tmp_tree->parent_tree;
6363 count = 1 + last->left->count;
6364 tmp_node = last->parent;
6370 /* Returns TRUE if we ran out of tree before finding the path. If the path is
6371 * invalid (ie. points to a node that's not in the tree), *tree and *node are
6375 _gtk_tree_view_find_node (GtkTreeView *tree_view,
6380 GtkRBNode *tmpnode = NULL;
6381 GtkRBTree *tmptree = tree_view->priv->tree;
6382 gint *indices = gtk_tree_path_get_indices (path);
6383 gint depth = gtk_tree_path_get_depth (path);
6389 if (depth == 0 || tmptree == NULL)
6393 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
6395 if (tmpnode == NULL)
6409 tmptree = tmpnode->children;
6410 if (tmptree == NULL)
6417 gtk_tree_view_is_expander_column (GtkTreeView *tree_view,
6418 GtkTreeViewColumn *column)
6422 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST))
6425 if (tree_view->priv->expander_column != NULL)
6427 if (tree_view->priv->expander_column == column)
6433 for (list = tree_view->priv->columns; list; list = list->next)
6434 if (((GtkTreeViewColumn *)list->data)->visible)
6436 if (list && list->data == column)
6443 gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
6446 GtkMovementStep step,
6450 gtk_binding_entry_add_signal (binding_set, keyval, modmask,
6452 GTK_TYPE_ENUM, step,
6453 GTK_TYPE_INT, count);
6455 gtk_binding_entry_add_signal (binding_set, keyval, GDK_SHIFT_MASK,
6457 GTK_TYPE_ENUM, step,
6458 GTK_TYPE_INT, count);
6460 if ((modmask & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
6463 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK | GDK_SHIFT_MASK,
6465 GTK_TYPE_ENUM, step,
6466 GTK_TYPE_INT, count);
6468 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK,
6470 GTK_TYPE_ENUM, step,
6471 GTK_TYPE_INT, count);
6475 gtk_tree_view_unref_tree_helper (GtkTreeModel *model,
6480 gint retval = FALSE;
6483 g_return_val_if_fail (node != NULL, FALSE);
6488 GtkRBTree *new_tree;
6489 GtkRBNode *new_node;
6491 new_tree = node->children;
6492 new_node = new_tree->root;
6494 while (new_node && new_node->left != new_tree->nil)
6495 new_node = new_node->left;
6497 g_return_val_if_fail (gtk_tree_model_iter_children (model, &child, iter), FALSE);
6498 retval = retval || gtk_tree_view_unref_tree_helper (model, &child, new_tree, new_node);
6501 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
6503 gtk_tree_model_unref_node (model, iter);
6504 node = _gtk_rbtree_next (tree, node);
6506 while (gtk_tree_model_iter_next (model, iter));
6512 gtk_tree_view_unref_and_check_selection_tree (GtkTreeView *tree_view,
6524 while (node && node->left != tree->nil)
6527 g_return_val_if_fail (node != NULL, FALSE);
6528 path = _gtk_tree_view_find_path (tree_view, tree, node);
6529 gtk_tree_model_get_iter (GTK_TREE_MODEL (tree_view->priv->model),
6531 retval = gtk_tree_view_unref_tree_helper (GTK_TREE_MODEL (tree_view->priv->model), &iter, tree, node);
6532 gtk_tree_path_free (path);
6538 gtk_tree_view_set_column_drag_info (GtkTreeView *tree_view,
6539 GtkTreeViewColumn *column)
6541 GtkTreeViewColumn *left_column;
6542 GtkTreeViewColumn *cur_column = NULL;
6543 GtkTreeViewColumnReorder *reorder;
6548 /* We want to precalculate the motion list such that we know what column slots
6553 /* First, identify all possible drop spots */
6554 tmp_list = tree_view->priv->columns;
6558 g_assert (tmp_list);
6560 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
6561 tmp_list = tmp_list->next;
6563 if (cur_column->visible == FALSE)
6566 /* If it's not the column moving and func tells us to skip over the column, we continue. */
6567 if (left_column != column && cur_column != column &&
6568 tree_view->priv->column_drop_func &&
6569 ! (* tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
6571 left_column = cur_column;
6574 reorder = g_new (GtkTreeViewColumnReorder, 1);
6575 reorder->left_column = left_column;
6576 left_column = reorder->right_column = cur_column;
6578 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
6581 /* Add the last one */
6582 if (tree_view->priv->column_drop_func == NULL ||
6583 ((left_column != column) &&
6584 (* tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data)))
6586 reorder = g_new (GtkTreeViewColumnReorder, 1);
6587 reorder->left_column = left_column;
6588 reorder->right_column = NULL;
6589 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
6592 /* We quickly check to see if it even makes sense to reorder columns. */
6593 /* If there is nothing that can be moved, then we return */
6595 if (tree_view->priv->column_drag_info == NULL)
6598 /* We know there are always 2 slots possbile, as you can always return column. */
6599 /* If that's all there is, return */
6600 if (tree_view->priv->column_drag_info->next->next == NULL &&
6601 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->data)->right_column == column &&
6602 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->next->data)->left_column == column)
6604 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
6605 g_free (tmp_list->data);
6606 g_list_free (tree_view->priv->column_drag_info);
6607 tree_view->priv->column_drag_info = NULL;
6610 /* We fill in the ranges for the columns, now that we've isolated them */
6611 left = - TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
6613 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
6615 reorder = (GtkTreeViewColumnReorder *) tmp_list->data;
6617 reorder->left_align = left;
6618 if (tmp_list->next != NULL)
6620 g_assert (tmp_list->next->data);
6621 left = reorder->right_align = (reorder->right_column->button->allocation.x +
6622 reorder->right_column->button->allocation.width +
6623 ((GtkTreeViewColumnReorder *)tmp_list->next->data)->left_column->button->allocation.x)/2;
6629 gdk_window_get_size (tree_view->priv->header_window, &width, NULL);
6630 reorder->right_align = width + TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
6636 _gtk_tree_view_column_start_drag (GtkTreeView *tree_view,
6637 GtkTreeViewColumn *column)
6639 GdkEvent send_event;
6640 GtkAllocation allocation;
6641 gint x, y, width, height;
6643 g_return_if_fail (tree_view->priv->column_drag_info == NULL);
6645 gtk_tree_view_set_column_drag_info (tree_view, column);
6647 if (tree_view->priv->column_drag_info == NULL)
6650 if (tree_view->priv->drag_window == NULL)
6652 GdkWindowAttr attributes;
6653 guint attributes_mask;
6655 attributes.window_type = GDK_WINDOW_CHILD;
6656 attributes.wclass = GDK_INPUT_OUTPUT;
6657 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
6658 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
6659 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
6660 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
6662 tree_view->priv->drag_window = gdk_window_new (tree_view->priv->bin_window,
6665 gdk_window_set_user_data (tree_view->priv->drag_window, GTK_WIDGET (tree_view));
6668 gdk_pointer_ungrab (GDK_CURRENT_TIME);
6669 gdk_keyboard_ungrab (GDK_CURRENT_TIME);
6671 gtk_grab_remove (column->button);
6673 send_event.crossing.type = GDK_LEAVE_NOTIFY;
6674 send_event.crossing.send_event = TRUE;
6675 send_event.crossing.window = column->button->window;
6676 send_event.crossing.subwindow = NULL;
6677 send_event.crossing.detail = GDK_NOTIFY_ANCESTOR;
6678 send_event.crossing.time = GDK_CURRENT_TIME;
6680 gtk_propagate_event (column->button, &send_event);
6682 send_event.button.type = GDK_BUTTON_RELEASE;
6683 send_event.button.window = GDK_ROOT_PARENT ();
6684 send_event.button.send_event = TRUE;
6685 send_event.button.time = GDK_CURRENT_TIME;
6686 send_event.button.x = -1;
6687 send_event.button.y = -1;
6688 send_event.button.axes = NULL;
6689 send_event.button.state = 0;
6690 send_event.button.button = 1;
6691 send_event.button.device = gdk_device_get_core_pointer ();
6692 send_event.button.x_root = 0;
6693 send_event.button.y_root = 0;
6695 gtk_propagate_event (column->button, &send_event);
6697 gdk_window_move_resize (tree_view->priv->drag_window,
6698 column->button->allocation.x,
6700 column->button->allocation.width,
6701 column->button->allocation.height);
6703 /* Kids, don't try this at home */
6704 g_object_ref (column->button);
6705 gtk_container_remove (GTK_CONTAINER (tree_view), column->button);
6706 gtk_widget_set_parent_window (column->button, tree_view->priv->drag_window);
6707 gtk_widget_set_parent (column->button, GTK_WIDGET (tree_view));
6708 g_object_unref (column->button);
6710 tree_view->priv->drag_column_x = column->button->allocation.x;
6711 allocation = column->button->allocation;
6713 gtk_widget_size_allocate (column->button, &allocation);
6714 gtk_widget_set_parent_window (column->button, tree_view->priv->drag_window);
6716 tree_view->priv->drag_column = column;
6717 gdk_window_show (tree_view->priv->drag_window);
6719 gdk_window_get_origin (tree_view->priv->header_window, &x, &y);
6720 gdk_window_get_size (tree_view->priv->header_window, &width, &height);
6722 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
6723 while (gtk_events_pending ())
6724 gtk_main_iteration ();
6726 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
6727 gdk_pointer_grab (tree_view->priv->drag_window,
6729 GDK_POINTER_MOTION_MASK|GDK_BUTTON_RELEASE_MASK,
6730 NULL, NULL, GDK_CURRENT_TIME);
6731 gdk_keyboard_grab (tree_view->priv->drag_window,
6738 gtk_tree_view_queue_draw_arrow (GtkTreeView *tree_view,
6741 GdkRectangle *clip_rect)
6745 if (!GTK_WIDGET_REALIZED (tree_view))
6749 rect.width = MAX (tree_view->priv->expander_size, GTK_WIDGET (tree_view)->allocation.width);
6751 rect.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
6752 rect.height = MAX (BACKGROUND_HEIGHT (node), tree_view->priv->expander_size);
6756 GdkRectangle new_rect;
6758 gdk_rectangle_intersect (clip_rect, &rect, &new_rect);
6760 gdk_window_invalidate_rect (tree_view->priv->bin_window, &new_rect, TRUE);
6764 gdk_window_invalidate_rect (tree_view->priv->bin_window, &rect, TRUE);
6769 _gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
6772 GdkRectangle *clip_rect)
6776 if (!GTK_WIDGET_REALIZED (tree_view))
6780 rect.width = MAX (tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.width);
6782 rect.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
6783 rect.height = MAX (BACKGROUND_HEIGHT (node), tree_view->priv->expander_size);
6787 GdkRectangle new_rect;
6789 gdk_rectangle_intersect (clip_rect, &rect, &new_rect);
6791 gdk_window_invalidate_rect (tree_view->priv->bin_window, &new_rect, TRUE);
6795 gdk_window_invalidate_rect (tree_view->priv->bin_window, &rect, TRUE);
6800 gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
6802 GdkRectangle *clip_rect)
6804 GtkRBTree *tree = NULL;
6805 GtkRBNode *node = NULL;
6807 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
6810 _gtk_tree_view_queue_draw_node (tree_view, tree, node, clip_rect);
6813 /* x and y are the mouse position
6816 gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
6826 gint vertical_separator;
6828 GtkExpanderStyle expander_style;
6830 gtk_widget_style_get (GTK_WIDGET (tree_view),
6831 "vertical_separator", &vertical_separator,
6833 expander_size = tree_view->priv->expander_size - EXPANDER_EXTRA_PADDING;
6835 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
6838 widget = GTK_WIDGET (tree_view);
6840 gtk_tree_view_get_arrow_xrange (tree_view, tree, &x_offset, NULL);
6843 area.y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
6844 area.width = expander_size + 2;
6845 area.height = MAX (CELL_HEIGHT (node, vertical_separator), (expander_size - vertical_separator));
6847 if (node == tree_view->priv->button_pressed_node)
6849 if (x >= area.x && x <= (area.x + area.width) &&
6850 y >= area.y && y <= (area.y + area.height))
6851 state = GTK_STATE_ACTIVE;
6853 state = GTK_STATE_NORMAL;
6857 if (node == tree_view->priv->prelight_node &&
6858 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
6859 state = GTK_STATE_PRELIGHT;
6861 state = GTK_STATE_NORMAL;
6864 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
6865 expander_style = GTK_EXPANDER_SEMI_EXPANDED;
6866 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
6867 expander_style = GTK_EXPANDER_SEMI_COLLAPSED;
6868 else if (node->children != NULL)
6869 expander_style = GTK_EXPANDER_EXPANDED;
6871 expander_style = GTK_EXPANDER_COLLAPSED;
6873 gtk_paint_expander (widget->style,
6874 tree_view->priv->bin_window,
6879 area.x + area.width / 2,
6880 area.y + area.height / 2,
6885 gtk_tree_view_focus_to_cursor (GtkTreeView *tree_view)
6888 GtkTreePath *cursor_path;
6890 if ((tree_view->priv->tree == NULL) ||
6891 (! GTK_WIDGET_REALIZED (tree_view)))
6894 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
6897 if (tree_view->priv->cursor)
6898 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
6900 if (cursor_path == NULL)
6902 cursor_path = gtk_tree_path_new_first ();
6903 gtk_tree_row_reference_free (tree_view->priv->cursor);
6904 tree_view->priv->cursor = NULL;
6906 if (tree_view->priv->selection->type == GTK_SELECTION_MULTIPLE)
6907 gtk_tree_view_real_set_cursor (tree_view, cursor_path, FALSE, FALSE);
6909 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, FALSE);
6911 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
6912 gtk_tree_path_free (cursor_path);
6914 if (tree_view->priv->focus_column == NULL)
6917 for (list = tree_view->priv->columns; list; list = list->next)
6919 if (GTK_TREE_VIEW_COLUMN (list->data)->visible)
6921 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (list->data);
6929 gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
6932 GtkRBTree *cursor_tree = NULL;
6933 GtkRBNode *cursor_node = NULL;
6934 GtkRBTree *new_cursor_tree = NULL;
6935 GtkRBNode *new_cursor_node = NULL;
6936 GtkTreePath *cursor_path = NULL;
6938 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
6942 if (!gtk_tree_row_reference_valid (tree_view->priv->cursor))
6943 /* FIXME: we lost the cursor; should we get the first? */
6946 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
6947 _gtk_tree_view_find_node (tree_view, cursor_path,
6948 &cursor_tree, &cursor_node);
6949 gtk_tree_path_free (cursor_path);
6951 if (cursor_tree == NULL)
6952 /* FIXME: we lost the cursor; should we get the first? */
6955 _gtk_rbtree_prev_full (cursor_tree, cursor_node,
6956 &new_cursor_tree, &new_cursor_node);
6958 _gtk_rbtree_next_full (cursor_tree, cursor_node,
6959 &new_cursor_tree, &new_cursor_node);
6961 if (new_cursor_node)
6963 cursor_path = _gtk_tree_view_find_path (tree_view, new_cursor_tree, new_cursor_node);
6964 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, TRUE);
6965 gtk_tree_path_free (cursor_path);
6969 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
6972 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
6976 gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
6979 GtkRBTree *cursor_tree = NULL;
6980 GtkRBNode *cursor_node = NULL;
6981 GtkTreePath *cursor_path = NULL;
6983 gint vertical_separator;
6985 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
6988 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
6989 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
6991 /* This is sorta weird. Focus in should give us a cursor */
6994 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical_separator", &vertical_separator, NULL);
6995 _gtk_tree_view_find_node (tree_view, cursor_path,
6996 &cursor_tree, &cursor_node);
6998 gtk_tree_path_free (cursor_path);
7000 if (cursor_tree == NULL)
7001 /* FIXME: we lost the cursor. Should we try to get one? */
7003 g_return_if_fail (cursor_node != NULL);
7005 y = _gtk_rbtree_node_find_offset (cursor_tree, cursor_node);
7006 y += count * tree_view->priv->vadjustment->page_size;
7008 y -= MAX (GTK_RBNODE_GET_HEIGHT (cursor_node),
7009 tree_view->priv->expander_size);
7011 y += MAX (GTK_RBNODE_GET_HEIGHT (cursor_node),
7012 tree_view->priv->expander_size);
7013 y = CLAMP (y, (gint)tree_view->priv->vadjustment->lower, (gint)tree_view->priv->vadjustment->upper - vertical_separator);
7015 if (y > tree_view->priv->height)
7016 y = tree_view->priv->height - 1;
7018 _gtk_rbtree_find_offset (tree_view->priv->tree, y, &cursor_tree, &cursor_node);
7019 cursor_path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
7020 g_return_if_fail (cursor_path != NULL);
7021 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, TRUE);
7022 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
7023 gtk_tree_path_free (cursor_path);
7027 gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
7030 GtkRBTree *cursor_tree = NULL;
7031 GtkRBNode *cursor_node = NULL;
7032 GtkTreePath *cursor_path = NULL;
7033 GtkTreeViewColumn *column;
7036 gboolean found_column = FALSE;
7038 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
7041 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
7042 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
7046 _gtk_tree_view_find_node (tree_view, cursor_path, &cursor_tree, &cursor_node);
7047 if (cursor_tree == NULL)
7049 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, cursor_path) == FALSE)
7051 gtk_tree_path_free (cursor_path);
7054 gtk_tree_path_free (cursor_path);
7056 list = tree_view->priv->columns;
7057 if (tree_view->priv->focus_column)
7059 for (list = tree_view->priv->columns; list; list = list->next)
7061 if (list->data == tree_view->priv->focus_column)
7068 column = list->data;
7069 if (column->visible == FALSE)
7072 gtk_tree_view_column_cell_set_cell_data (column,
7073 tree_view->priv->model,
7075 GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_PARENT),
7076 cursor_node->children?TRUE:FALSE);
7077 if (_gtk_tree_view_column_cell_focus (column, count))
7079 tree_view->priv->focus_column = column;
7080 found_column = TRUE;
7092 _gtk_tree_view_queue_draw_node (tree_view,
7096 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[CURSOR_CHANGED], 0);
7098 gtk_tree_view_clamp_column_visible (tree_view, tree_view->priv->focus_column);
7102 gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
7105 GtkRBTree *cursor_tree;
7106 GtkRBNode *cursor_node;
7109 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
7112 g_return_if_fail (tree_view->priv->tree != NULL);
7116 cursor_tree = tree_view->priv->tree;
7117 cursor_node = cursor_tree->root;
7118 while (cursor_node && cursor_node->left != cursor_tree->nil)
7119 cursor_node = cursor_node->left;
7123 cursor_tree = tree_view->priv->tree;
7124 cursor_node = cursor_tree->root;
7127 while (cursor_node && cursor_node->right != cursor_tree->nil)
7128 cursor_node = cursor_node->right;
7129 if (cursor_node->children == NULL)
7132 cursor_tree = cursor_node->children;
7133 cursor_node = cursor_tree->root;
7138 path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
7139 gtk_tree_view_real_set_cursor (tree_view, path, TRUE, TRUE);
7140 gtk_tree_path_free (path);
7144 gtk_tree_view_real_select_all (GtkTreeView *tree_view)
7146 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
7149 if (tree_view->priv->selection->type != GTK_SELECTION_MULTIPLE)
7151 gtk_tree_selection_select_all (tree_view->priv->selection);
7155 gtk_tree_view_real_unselect_all (GtkTreeView *tree_view)
7157 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
7160 if (tree_view->priv->selection->type != GTK_SELECTION_MULTIPLE)
7162 gtk_tree_selection_unselect_all (tree_view->priv->selection);
7166 gtk_tree_view_real_select_cursor_row (GtkTreeView *tree_view,
7167 gboolean start_editing)
7169 GtkRBTree *cursor_tree = NULL;
7170 GtkRBNode *cursor_node = NULL;
7171 GtkTreePath *cursor_path = NULL;
7172 GdkModifierType state = 0;
7175 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
7178 if (tree_view->priv->cursor)
7179 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
7181 if (cursor_path == NULL)
7184 _gtk_tree_view_find_node (tree_view, cursor_path,
7185 &cursor_tree, &cursor_node);
7187 if (cursor_tree == NULL)
7189 gtk_tree_path_free (cursor_path);
7193 gtk_get_current_event_state (&state);
7195 if (! (state & GDK_SHIFT_MASK) &&
7197 tree_view->priv->focus_column)
7199 if (gtk_tree_view_start_editing (tree_view, cursor_path))
7201 gtk_tree_path_free (cursor_path);
7205 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
7212 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
7214 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
7215 _gtk_tree_view_queue_draw_node (tree_view, cursor_tree, cursor_node, NULL);
7217 if (! (state & GDK_SHIFT_MASK))
7218 gtk_tree_view_row_activated (tree_view, cursor_path, tree_view->priv->focus_column);
7220 gtk_tree_path_free (cursor_path);
7224 gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view)
7226 GtkRBTree *cursor_tree = NULL;
7227 GtkRBNode *cursor_node = NULL;
7228 GtkTreePath *cursor_path = NULL;
7230 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
7234 if (tree_view->priv->cursor)
7235 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
7237 if (cursor_path == NULL)
7240 _gtk_tree_view_find_node (tree_view, cursor_path,
7241 &cursor_tree, &cursor_node);
7242 if (cursor_tree == NULL)
7244 gtk_tree_path_free (cursor_path);
7248 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
7255 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
7257 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
7258 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
7259 gtk_tree_path_free (cursor_path);
7265 gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
7270 GtkTreePath *cursor_path = NULL;
7274 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
7278 if (tree_view->priv->cursor)
7279 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
7281 if (cursor_path == NULL)
7284 if (_gtk_tree_view_find_node (tree_view, cursor_path, &tree, &node))
7287 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
7288 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
7291 gtk_tree_view_real_expand_row (tree_view, cursor_path, tree, node, open_all, TRUE);
7293 gtk_tree_view_real_collapse_row (tree_view, cursor_path, tree, node, TRUE);
7295 gtk_tree_path_free (cursor_path);
7299 gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view)
7301 GtkRBTree *cursor_tree = NULL;
7302 GtkRBNode *cursor_node = NULL;
7303 GtkTreePath *cursor_path = NULL;
7305 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
7309 if (tree_view->priv->cursor)
7310 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
7312 if (cursor_path == NULL)
7315 _gtk_tree_view_find_node (tree_view, cursor_path,
7316 &cursor_tree, &cursor_node);
7317 if (cursor_tree == NULL)
7319 gtk_tree_path_free (cursor_path);
7323 if (cursor_tree->parent_node)
7325 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
7326 cursor_node = cursor_tree->parent_node;
7327 cursor_tree = cursor_tree->parent_tree;
7329 gtk_tree_path_up (cursor_path);
7330 gtk_tree_row_reference_free (tree_view->priv->cursor);
7331 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, cursor_path);
7332 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
7340 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
7342 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
7343 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
7344 gtk_tree_path_free (cursor_path);
7348 gtk_tree_view_real_start_interactive_search (GtkTreeView *tree_view)
7352 GtkWidget *search_dialog;
7353 GdkEventFocus focus_event;
7355 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
7358 if (tree_view->priv->enable_search == FALSE ||
7359 tree_view->priv->search_column < 0)
7362 search_dialog = g_object_get_data (G_OBJECT (tree_view),
7363 GTK_TREE_VIEW_SEARCH_DIALOG_KEY);
7368 window = gtk_window_new (GTK_WINDOW_POPUP);
7369 gtk_window_set_title (GTK_WINDOW (window), "search dialog");
7370 gtk_container_set_border_width (GTK_CONTAINER (window), 3);
7371 gtk_window_set_modal (GTK_WINDOW (window), TRUE);
7372 g_signal_connect (G_OBJECT (window), "delete_event",
7373 G_CALLBACK (gtk_tree_view_search_delete_event),
7375 g_signal_connect (G_OBJECT (window), "key_press_event",
7376 G_CALLBACK (gtk_tree_view_search_key_press_event),
7378 g_signal_connect (G_OBJECT (window), "button_press_event",
7379 G_CALLBACK (gtk_tree_view_search_button_press_event),
7383 entry = gtk_entry_new ();
7384 gtk_widget_show (entry);
7385 g_signal_connect (G_OBJECT (entry), "changed",
7386 G_CALLBACK (gtk_tree_view_search_init), tree_view);
7387 g_signal_connect (G_OBJECT (entry), "populate_popup",
7388 G_CALLBACK (gtk_tree_view_search_disable_popdown),
7390 gtk_container_add (GTK_CONTAINER (window), entry);
7393 tree_view->priv->search_dialog_position_func (tree_view, window);
7394 gtk_widget_show_all (window);
7395 gtk_widget_grab_focus (entry);
7397 /* send focus-in event */
7398 focus_event.type = GDK_FOCUS_CHANGE;
7399 focus_event.in = TRUE;
7400 gtk_widget_event (entry, (GdkEvent *) &focus_event);
7402 /* position window */
7404 /* yes, we point to the entry's private text thing here, a bit evil */
7405 g_object_set_data (G_OBJECT (window), "gtk-tree-view-text",
7406 (gchar *) gtk_entry_get_text (GTK_ENTRY (entry)));
7407 g_object_set_data (G_OBJECT (tree_view),
7408 GTK_TREE_VIEW_SEARCH_DIALOG_KEY, window);
7410 /* search first matching iter */
7411 gtk_tree_view_search_init (entry, tree_view);
7414 /* this function returns the new width of the column being resized given
7415 * the column and x position of the cursor; the x cursor position is passed
7416 * in as a pointer and automagicly corrected if it's beyond min/max limits
7419 gtk_tree_view_new_column_width (GtkTreeView *tree_view,
7423 GtkTreeViewColumn *column;
7426 /* first translate the x position from widget->window
7427 * to clist->clist_window
7430 column = g_list_nth (tree_view->priv->columns, i)->data;
7431 width = *x - column->button->allocation.x;
7433 /* Clamp down the value */
7434 if (column->min_width == -1)
7435 width = MAX (column->button->requisition.width,
7438 width = MAX (column->min_width,
7440 if (column->max_width != -1)
7441 width = MIN (width, column->max_width != -1);
7442 *x = column->button->allocation.x + width;
7450 gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
7451 GtkTreeView *tree_view)
7453 if (GTK_WIDGET_REALIZED (tree_view))
7457 gdk_window_move (tree_view->priv->bin_window,
7458 - tree_view->priv->hadjustment->value,
7459 TREE_VIEW_HEADER_HEIGHT (tree_view));
7460 gdk_window_move (tree_view->priv->header_window,
7461 - tree_view->priv->hadjustment->value,
7463 dy = tree_view->priv->dy - (int) tree_view->priv->vadjustment->value;
7464 gdk_window_scroll (tree_view->priv->bin_window, 0, dy);
7466 /* update our dy and top_row */
7467 tree_view->priv->dy = (int) tree_view->priv->vadjustment->value;
7468 gtk_tree_view_dy_to_top_row (tree_view);
7469 gdk_window_process_updates (tree_view->priv->bin_window, TRUE);
7470 gdk_window_process_updates (tree_view->priv->header_window, TRUE);
7480 * gtk_tree_view_new:
7482 * Creates a new #GtkTreeView widget.
7484 * Return value: A newly created #GtkTreeView widget.
7487 gtk_tree_view_new (void)
7489 GtkTreeView *tree_view;
7491 tree_view = GTK_TREE_VIEW (gtk_type_new (gtk_tree_view_get_type ()));
7493 return GTK_WIDGET (tree_view);
7497 * gtk_tree_view_new_with_model:
7498 * @model: the model.
7500 * Creates a new #GtkTreeView widget with the model initialized to @model.
7502 * Return value: A newly created #GtkTreeView widget.
7505 gtk_tree_view_new_with_model (GtkTreeModel *model)
7507 GtkTreeView *tree_view;
7509 tree_view = GTK_TREE_VIEW (gtk_type_new (gtk_tree_view_get_type ()));
7510 gtk_tree_view_set_model (tree_view, model);
7512 return GTK_WIDGET (tree_view);
7519 * gtk_tree_view_get_model:
7520 * @tree_view: a #GtkTreeView
7522 * Returns the model the the #GtkTreeView is based on. Returns %NULL if the
7525 * Return value: A #GtkTreeModel, or %NULL if none is currently being used.
7528 gtk_tree_view_get_model (GtkTreeView *tree_view)
7530 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
7532 return tree_view->priv->model;
7536 * gtk_tree_view_set_model:
7537 * @tree_view: A #GtkTreeNode.
7538 * @model: The model.
7540 * Sets the model for a #GtkTreeView. If the @tree_view already has a model
7541 * set, it will remove it before setting the new model. If @model is %NULL, then
7542 * it will unset the old model.
7545 gtk_tree_view_set_model (GtkTreeView *tree_view,
7546 GtkTreeModel *model)
7548 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7550 if (model == tree_view->priv->model)
7553 if (tree_view->priv->model)
7555 gtk_tree_view_unref_and_check_selection_tree (tree_view, tree_view->priv->tree);
7557 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
7558 (gpointer) gtk_tree_view_row_changed, tree_view);
7559 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
7560 (gpointer) gtk_tree_view_row_inserted, tree_view);
7561 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
7562 (gpointer) gtk_tree_view_row_has_child_toggled, tree_view);
7563 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
7564 (gpointer) gtk_tree_view_row_deleted, tree_view);
7565 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
7566 (gpointer) gtk_tree_view_rows_reordered, tree_view);
7567 if (tree_view->priv->tree)
7569 _gtk_rbtree_free (tree_view->priv->tree);
7570 tree_view->priv->tree = NULL;
7573 tree_view->priv->prelight_node = NULL;
7574 tree_view->priv->prelight_tree = NULL;
7575 tree_view->priv->button_pressed_node = NULL;
7576 tree_view->priv->button_pressed_tree = NULL;
7578 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
7579 tree_view->priv->drag_dest_row = NULL;
7580 gtk_tree_row_reference_free (tree_view->priv->cursor);
7581 tree_view->priv->cursor = NULL;
7582 gtk_tree_row_reference_free (tree_view->priv->anchor);
7583 tree_view->priv->anchor = NULL;
7585 g_object_unref (tree_view->priv->model);
7586 tree_view->priv->search_column = -1;
7587 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
7588 tree_view->priv->fixed_height_check = 0;
7591 tree_view->priv->model = model;
7594 if (tree_view->priv->model)
7601 if (tree_view->priv->search_column == -1)
7603 for (i = 0; i < gtk_tree_model_get_n_columns (model); i++)
7605 if (gtk_tree_model_get_column_type (model, i) == G_TYPE_STRING)
7607 tree_view->priv->search_column = i;
7612 g_object_ref (tree_view->priv->model);
7613 g_signal_connect (tree_view->priv->model,
7615 G_CALLBACK (gtk_tree_view_row_changed),
7617 g_signal_connect (tree_view->priv->model,
7619 G_CALLBACK (gtk_tree_view_row_inserted),
7621 g_signal_connect (tree_view->priv->model,
7622 "row_has_child_toggled",
7623 G_CALLBACK (gtk_tree_view_row_has_child_toggled),
7625 g_signal_connect (tree_view->priv->model,
7627 G_CALLBACK (gtk_tree_view_row_deleted),
7629 g_signal_connect (tree_view->priv->model,
7631 G_CALLBACK (gtk_tree_view_rows_reordered),
7634 path = gtk_tree_path_new_first ();
7635 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, path))
7637 tree_view->priv->tree = _gtk_rbtree_new ();
7638 gtk_tree_view_build_tree (tree_view, tree_view->priv->tree, &iter, 1, FALSE);
7640 gtk_tree_path_free (path);
7642 /* FIXME: do I need to do this? gtk_tree_view_create_buttons (tree_view); */
7643 install_presize_handler (tree_view);
7646 g_object_notify (G_OBJECT (tree_view), "model");
7648 if (GTK_WIDGET_REALIZED (tree_view))
7649 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
7653 * gtk_tree_view_get_selection:
7654 * @tree_view: A #GtkTreeView.
7656 * Gets the #GtkTreeSelection associated with @tree_view.
7658 * Return value: A #GtkTreeSelection object.
7661 gtk_tree_view_get_selection (GtkTreeView *tree_view)
7663 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
7665 return tree_view->priv->selection;
7669 * gtk_tree_view_get_hadjustment:
7670 * @tree_view: A #GtkTreeView
7672 * Gets the #GtkAdjustment currently being used for the horizontal aspect.
7674 * Return value: A #GtkAdjustment object, or %NULL if none is currently being
7678 gtk_tree_view_get_hadjustment (GtkTreeView *tree_view)
7680 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
7682 if (tree_view->priv->hadjustment == NULL)
7683 gtk_tree_view_set_hadjustment (tree_view, NULL);
7685 return tree_view->priv->hadjustment;
7689 * gtk_tree_view_set_hadjustment:
7690 * @tree_view: A #GtkTreeView
7691 * @adjustment: The #GtkAdjustment to set, or %NULL
7693 * Sets the #GtkAdjustment for the current horizontal aspect.
7696 gtk_tree_view_set_hadjustment (GtkTreeView *tree_view,
7697 GtkAdjustment *adjustment)
7699 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7701 gtk_tree_view_set_adjustments (tree_view,
7703 tree_view->priv->vadjustment);
7705 g_object_notify (G_OBJECT (tree_view), "hadjustment");
7709 * gtk_tree_view_get_vadjustment:
7710 * @tree_view: A #GtkTreeView
7712 * Gets the #GtkAdjustment currently being used for the vertical aspect.
7714 * Return value: A #GtkAdjustment object, or %NULL if none is currently being
7718 gtk_tree_view_get_vadjustment (GtkTreeView *tree_view)
7720 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
7722 if (tree_view->priv->vadjustment == NULL)
7723 gtk_tree_view_set_vadjustment (tree_view, NULL);
7725 return tree_view->priv->vadjustment;
7729 * gtk_tree_view_set_vadjustment:
7730 * @tree_view: A #GtkTreeView
7731 * @adjustment: The #GtkAdjustment to set, or %NULL
7733 * Sets the #GtkAdjustment for the current vertical aspect.
7736 gtk_tree_view_set_vadjustment (GtkTreeView *tree_view,
7737 GtkAdjustment *adjustment)
7739 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7741 gtk_tree_view_set_adjustments (tree_view,
7742 tree_view->priv->hadjustment,
7745 g_object_notify (G_OBJECT (tree_view), "vadjustment");
7748 /* Column and header operations */
7751 * gtk_tree_view_get_headers_visible:
7752 * @tree_view: A #GtkTreeView.
7754 * Returns %TRUE if the headers on the @tree_view are visible.
7756 * Return value: Whether the headers are visible or not.
7759 gtk_tree_view_get_headers_visible (GtkTreeView *tree_view)
7761 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
7763 return GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
7767 * gtk_tree_view_set_headers_visible:
7768 * @tree_view: A #GtkTreeView.
7769 * @headers_visible: %TRUE if the headers are visible
7771 * Sets the the visibility state of the headers.
7774 gtk_tree_view_set_headers_visible (GtkTreeView *tree_view,
7775 gboolean headers_visible)
7779 GtkTreeViewColumn *column;
7781 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7783 headers_visible = !! headers_visible;
7785 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE) == headers_visible)
7788 if (headers_visible)
7789 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
7791 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
7793 if (GTK_WIDGET_REALIZED (tree_view))
7795 gdk_window_get_position (tree_view->priv->bin_window, &x, &y);
7796 if (headers_visible)
7798 gdk_window_move_resize (tree_view->priv->bin_window, x, y + TREE_VIEW_HEADER_HEIGHT (tree_view), tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.height - + TREE_VIEW_HEADER_HEIGHT (tree_view));
7800 if (GTK_WIDGET_MAPPED (tree_view))
7801 gtk_tree_view_map_buttons (tree_view);
7805 gdk_window_move_resize (tree_view->priv->bin_window, x, y, tree_view->priv->width, tree_view->priv->height);
7807 for (list = tree_view->priv->columns; list; list = list->next)
7809 column = list->data;
7810 gtk_widget_unmap (column->button);
7812 gdk_window_hide (tree_view->priv->header_window);
7816 tree_view->priv->vadjustment->page_size = GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
7817 tree_view->priv->vadjustment->page_increment = (GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view)) / 2;
7818 tree_view->priv->vadjustment->lower = 0;
7819 tree_view->priv->vadjustment->upper = tree_view->priv->height;
7820 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->vadjustment), "changed");
7822 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
7824 g_object_notify (G_OBJECT (tree_view), "headers_visible");
7828 * gtk_tree_view_columns_autosize:
7829 * @tree_view: A #GtkTreeView.
7831 * Resizes all columns to their optimal width. Only works after the
7832 * treeview has been realized.
7835 gtk_tree_view_columns_autosize (GtkTreeView *tree_view)
7837 gboolean dirty = FALSE;
7839 GtkTreeViewColumn *column;
7841 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7843 for (list = tree_view->priv->columns; list; list = list->next)
7845 column = list->data;
7846 if (column->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
7848 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
7853 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
7857 * gtk_tree_view_set_headers_clickable:
7858 * @tree_view: A #GtkTreeView.
7859 * @setting: %TRUE if the columns are clickable.
7861 * Allow the column title buttons to be clicked.
7864 gtk_tree_view_set_headers_clickable (GtkTreeView *tree_view,
7869 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7870 g_return_if_fail (tree_view->priv->model != NULL);
7872 for (list = tree_view->priv->columns; list; list = list->next)
7873 gtk_tree_view_column_set_clickable (GTK_TREE_VIEW_COLUMN (list->data), setting);
7875 g_object_notify (G_OBJECT (tree_view), "headers_clickable");
7880 * gtk_tree_view_set_rules_hint
7881 * @tree_view: a #GtkTreeView
7882 * @setting: %TRUE if the tree requires reading across rows
7884 * This function tells GTK+ that the user interface for your
7885 * application requires users to read across tree rows and associate
7886 * cells with one another. By default, GTK+ will then render the tree
7887 * with alternating row colors. Do <emphasis>not</emphasis> use it
7888 * just because you prefer the appearance of the ruled tree; that's a
7889 * question for the theme. Some themes will draw tree rows in
7890 * alternating colors even when rules are turned off, and users who
7891 * prefer that appearance all the time can choose those themes. You
7892 * should call this function only as a <emphasis>semantic</emphasis>
7893 * hint to the theme engine that your tree makes alternating colors
7894 * useful from a functional standpoint (since it has lots of columns,
7899 gtk_tree_view_set_rules_hint (GtkTreeView *tree_view,
7902 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7904 setting = setting != FALSE;
7906 if (tree_view->priv->has_rules != setting)
7908 tree_view->priv->has_rules = setting;
7909 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
7912 g_object_notify (G_OBJECT (tree_view), "rules_hint");
7916 * gtk_tree_view_get_rules_hint
7917 * @tree_view: a #GtkTreeView
7919 * Gets the setting set by gtk_tree_view_set_rules_hint().
7921 * Return value: %TRUE if rules are useful for the user of this tree
7924 gtk_tree_view_get_rules_hint (GtkTreeView *tree_view)
7926 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
7928 return tree_view->priv->has_rules;
7931 /* Public Column functions
7935 * gtk_tree_view_append_column:
7936 * @tree_view: A #GtkTreeView.
7937 * @column: The #GtkTreeViewColumn to add.
7939 * Appends @column to the list of columns.
7941 * Return value: The number of columns in @tree_view after appending.
7944 gtk_tree_view_append_column (GtkTreeView *tree_view,
7945 GtkTreeViewColumn *column)
7947 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
7948 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
7949 g_return_val_if_fail (column->tree_view == NULL, -1);
7951 return gtk_tree_view_insert_column (tree_view, column, -1);
7956 * gtk_tree_view_remove_column:
7957 * @tree_view: A #GtkTreeView.
7958 * @column: The #GtkTreeViewColumn to remove.
7960 * Removes @column from @tree_view.
7962 * Return value: The number of columns in @tree_view after removing.
7965 gtk_tree_view_remove_column (GtkTreeView *tree_view,
7966 GtkTreeViewColumn *column)
7968 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
7969 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
7970 g_return_val_if_fail (column->tree_view == GTK_WIDGET (tree_view), -1);
7972 _gtk_tree_view_column_unset_tree_view (column);
7974 if (tree_view->priv->focus_column == column)
7975 tree_view->priv->focus_column = NULL;
7977 tree_view->priv->columns = g_list_remove (tree_view->priv->columns, column);
7978 tree_view->priv->n_columns--;
7980 if (GTK_WIDGET_REALIZED (tree_view))
7984 _gtk_tree_view_column_unrealize_button (column);
7985 for (list = tree_view->priv->columns; list; list = list->next)
7987 GtkTreeViewColumn *tmp_column;
7989 tmp_column = GTK_TREE_VIEW_COLUMN (list->data);
7990 if (tmp_column->visible)
7991 _gtk_tree_view_column_cell_set_dirty (tmp_column, TRUE);
7994 if (tree_view->priv->n_columns == 0 &&
7995 gtk_tree_view_get_headers_visible (tree_view))
7996 gdk_window_hide (tree_view->priv->header_window);
7998 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8001 g_object_unref (G_OBJECT (column));
8002 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLUMNS_CHANGED], 0);
8004 return tree_view->priv->n_columns;
8008 * gtk_tree_view_insert_column:
8009 * @tree_view: A #GtkTreeView.
8010 * @column: The #GtkTreeViewColumn to be inserted.
8011 * @position: The position to insert @column in.
8013 * This inserts the @column into the @tree_view at @position. If @position is
8014 * -1, then the column is inserted at the end.
8016 * Return value: The number of columns in @tree_view after insertion.
8019 gtk_tree_view_insert_column (GtkTreeView *tree_view,
8020 GtkTreeViewColumn *column,
8023 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
8024 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
8025 g_return_val_if_fail (column->tree_view == NULL, -1);
8027 g_object_ref (G_OBJECT (column));
8028 gtk_object_sink (GTK_OBJECT (column));
8030 if (tree_view->priv->n_columns == 0 &&
8031 GTK_WIDGET_REALIZED (tree_view) &&
8032 gtk_tree_view_get_headers_visible (tree_view))
8034 gdk_window_show (tree_view->priv->header_window);
8037 tree_view->priv->columns = g_list_insert (tree_view->priv->columns,
8039 tree_view->priv->n_columns++;
8041 _gtk_tree_view_column_set_tree_view (column, tree_view);
8043 if (GTK_WIDGET_REALIZED (tree_view))
8047 _gtk_tree_view_column_realize_button (column);
8049 for (list = tree_view->priv->columns; list; list = list->next)
8051 column = GTK_TREE_VIEW_COLUMN (list->data);
8052 if (column->visible)
8053 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
8055 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8058 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLUMNS_CHANGED], 0);
8060 return tree_view->priv->n_columns;
8064 * gtk_tree_view_insert_column_with_attributes:
8065 * @tree_view: A #GtkTreeView
8066 * @position: The position to insert the new column in.
8067 * @title: The title to set the header to.
8068 * @cell: The #GtkCellRenderer.
8069 * @Varargs: A %NULL-terminated list of attributes.
8071 * Creates a new #GtkTreeViewColumn and inserts it into the @tree_view at
8072 * @position. If @position is -1, then the newly created column is inserted at
8073 * the end. The column is initialized with the attributes given.
8075 * Return value: The number of columns in @tree_view after insertion.
8078 gtk_tree_view_insert_column_with_attributes (GtkTreeView *tree_view,
8081 GtkCellRenderer *cell,
8084 GtkTreeViewColumn *column;
8089 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
8091 column = gtk_tree_view_column_new ();
8093 gtk_tree_view_column_set_title (column, title);
8094 gtk_tree_view_column_pack_start (column, cell, TRUE);
8096 va_start (args, cell);
8098 attribute = va_arg (args, gchar *);
8100 while (attribute != NULL)
8102 column_id = va_arg (args, gint);
8103 gtk_tree_view_column_add_attribute (column, cell, attribute, column_id);
8104 attribute = va_arg (args, gchar *);
8109 gtk_tree_view_insert_column (tree_view, column, position);
8111 return tree_view->priv->n_columns;
8115 * gtk_tree_view_insert_column_with_data_func:
8116 * @tree_view: a #GtkTreeView
8117 * @position: Position to insert, -1 for append
8118 * @title: column title
8119 * @cell: cell renderer for column
8120 * @func: function to set attributes of cell renderer
8121 * @data: data for @func
8122 * @dnotify: destroy notifier for @data
8124 * Convenience function that inserts a new column into the #GtkTreeView
8125 * with the given cell renderer and a #GtkCellDataFunc to set cell renderer
8126 * attributes (normally using data from the model). See also
8127 * gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start().
8129 * Return value: number of columns in the tree view post-insert
8132 gtk_tree_view_insert_column_with_data_func (GtkTreeView *tree_view,
8135 GtkCellRenderer *cell,
8136 GtkTreeCellDataFunc func,
8138 GDestroyNotify dnotify)
8140 GtkTreeViewColumn *column;
8142 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
8144 column = gtk_tree_view_column_new ();
8146 gtk_tree_view_column_set_title (column, title);
8147 gtk_tree_view_column_pack_start (column, cell, TRUE);
8148 gtk_tree_view_column_set_cell_data_func (column, cell, func, data, dnotify);
8150 gtk_tree_view_insert_column (tree_view, column, position);
8152 return tree_view->priv->n_columns;
8156 * gtk_tree_view_get_column:
8157 * @tree_view: A #GtkTreeView.
8158 * @n: The position of the column, counting from 0.
8160 * Gets the #GtkTreeViewColumn at the given position in the #tree_view.
8162 * Return value: The #GtkTreeViewColumn, or %NULL if the position is outside the
8166 gtk_tree_view_get_column (GtkTreeView *tree_view,
8169 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
8171 if (n < 0 || n >= tree_view->priv->n_columns)
8174 if (tree_view->priv->columns == NULL)
8177 return GTK_TREE_VIEW_COLUMN (g_list_nth (tree_view->priv->columns, n)->data);
8181 * gtk_tree_view_get_columns:
8182 * @tree_view: A #GtkTreeView
8184 * Returns a #GList of all the #GtkTreeViewColumn s currently in @tree_view.
8185 * The returned list must be freed with g_list_free ().
8187 * Return value: A list of #GtkTreeViewColumn s
8190 gtk_tree_view_get_columns (GtkTreeView *tree_view)
8192 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
8194 return g_list_copy (tree_view->priv->columns);
8198 * gtk_tree_view_move_column_after:
8199 * @tree_view: A #GtkTreeView
8200 * @column: The #GtkTreeViewColumn to be moved.
8201 * @base_column: The #GtkTreeViewColumn to be moved relative to, or %NULL.
8203 * Moves @column to be after to @base_column. If @base_column is %NULL, then
8204 * @column is placed in the first position.
8207 gtk_tree_view_move_column_after (GtkTreeView *tree_view,
8208 GtkTreeViewColumn *column,
8209 GtkTreeViewColumn *base_column)
8211 GList *column_list_el, *base_el = NULL;
8213 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8215 column_list_el = g_list_find (tree_view->priv->columns, column);
8216 g_return_if_fail (column_list_el != NULL);
8220 base_el = g_list_find (tree_view->priv->columns, base_column);
8221 g_return_if_fail (base_el != NULL);
8224 if (column_list_el->prev == base_el)
8227 tree_view->priv->columns = g_list_remove_link (tree_view->priv->columns, column_list_el);
8228 if (base_el == NULL)
8230 column_list_el->prev = NULL;
8231 column_list_el->next = tree_view->priv->columns;
8232 if (column_list_el->next)
8233 column_list_el->next->prev = column_list_el;
8234 tree_view->priv->columns = column_list_el;
8238 column_list_el->prev = base_el;
8239 column_list_el->next = base_el->next;
8240 if (column_list_el->next)
8241 column_list_el->next->prev = column_list_el;
8242 base_el->next = column_list_el;
8245 if (GTK_WIDGET_REALIZED (tree_view))
8247 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8248 gtk_tree_view_size_allocate_columns (GTK_WIDGET (tree_view));
8251 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLUMNS_CHANGED], 0);
8255 * gtk_tree_view_set_expander_column:
8256 * @tree_view: A #GtkTreeView
8257 * @column: %NULL, or the column to draw the expander arrow at.
8259 * Sets the column to draw the expander arrow at. It must be in @tree_view. If
8260 * @column is %NULL, then the expander arrow is always at the first visible
8264 gtk_tree_view_set_expander_column (GtkTreeView *tree_view,
8265 GtkTreeViewColumn *column)
8267 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8269 g_return_if_fail (GTK_IS_TREE_VIEW_COLUMN (column));
8271 if (tree_view->priv->expander_column != column)
8277 /* Confirm that column is in tree_view */
8278 for (list = tree_view->priv->columns; list; list = list->next)
8279 if (list->data == column)
8281 g_return_if_fail (list != NULL);
8284 tree_view->priv->expander_column = column;
8285 g_object_notify (G_OBJECT (tree_view), "expander_column");
8290 * gtk_tree_view_get_expander_column:
8291 * @tree_view: A #GtkTreeView
8293 * Returns the column that is the current expander column. This
8294 * column has the expander arrow drawn next to it.
8296 * Return value: The expander column.
8299 gtk_tree_view_get_expander_column (GtkTreeView *tree_view)
8303 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
8305 for (list = tree_view->priv->columns; list; list = list->next)
8306 if (gtk_tree_view_is_expander_column (tree_view, GTK_TREE_VIEW_COLUMN (list->data)))
8307 return (GtkTreeViewColumn *) list->data;
8313 * gtk_tree_view_set_column_drag_function:
8314 * @tree_view: A #GtkTreeView.
8315 * @func: A function to determine which columns are reorderable, or %NULL.
8316 * @user_data: User data to be passed to @func, or %NULL
8317 * @destroy: Destroy notifier for @user_data, or %NULL
8319 * Sets a user function for determining where a column may be dropped when
8320 * dragged. This function is called on every column pair in turn at the
8321 * beginning of a column drag to determine where a drop can take place. The
8322 * arguments passed to @func are: the @tree_view, the #GtkTreeViewColumn being
8323 * dragged, the two #GtkTreeViewColumn s determining the drop spot, and
8324 * @user_data. If either of the #GtkTreeViewColumn arguments for the drop spot
8325 * are %NULL, then they indicate an edge. If @func is set to be %NULL, then
8326 * @tree_view reverts to the default behavior of allowing all columns to be
8327 * dropped everywhere.
8330 gtk_tree_view_set_column_drag_function (GtkTreeView *tree_view,
8331 GtkTreeViewColumnDropFunc func,
8333 GtkDestroyNotify destroy)
8335 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8337 if (tree_view->priv->column_drop_func_data_destroy)
8338 (* tree_view->priv->column_drop_func_data_destroy) (tree_view->priv->column_drop_func_data);
8340 tree_view->priv->column_drop_func = func;
8341 tree_view->priv->column_drop_func_data = user_data;
8342 tree_view->priv->column_drop_func_data_destroy = destroy;
8346 * gtk_tree_view_scroll_to_point:
8347 * @tree_view: a #GtkTreeView
8348 * @tree_x: X coordinate of new top-left pixel of visible area, or -1
8349 * @tree_y: Y coordinate of new top-left pixel of visible area, or -1
8351 * Scrolls the tree view such that the top-left corner of the visible
8352 * area is @tree_x, @tree_y, where @tree_x and @tree_y are specified
8353 * in tree window coordinates. The @tree_view must be realized before
8354 * this function is called. If it isn't, you probably want to be
8355 * using gtk_tree_view_scroll_to_cell().
8357 * If either @tree_x or @tree_y are -1, then that direction isn't scrolled.
8360 gtk_tree_view_scroll_to_point (GtkTreeView *tree_view,
8364 GtkAdjustment *hadj;
8365 GtkAdjustment *vadj;
8367 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8368 g_return_if_fail (GTK_WIDGET_REALIZED (tree_view));
8370 hadj = tree_view->priv->hadjustment;
8371 vadj = tree_view->priv->vadjustment;
8374 gtk_adjustment_set_value (hadj, CLAMP (tree_x, hadj->lower, hadj->upper - hadj->page_size));
8376 gtk_adjustment_set_value (vadj, CLAMP (tree_y, vadj->lower, vadj->upper - vadj->page_size));
8380 * gtk_tree_view_scroll_to_cell
8381 * @tree_view: A #GtkTreeView.
8382 * @path: The path of the row to move to, or %NULL.
8383 * @column: The #GtkTreeViewColumn to move horizontally to, or %NULL.
8384 * @use_align: whether to use alignment arguments, or %FALSE.
8385 * @row_align: The vertical alignment of the row specified by @path.
8386 * @col_align: The horizontal alignment of the column specified by @column.
8388 * Moves the alignments of @tree_view to the position specified by @column and
8389 * @path. If @column is %NULL, then no horizontal scrolling occurs. Likewise,
8390 * if @path is %NULL no vertical scrolling occurs. At a minimum, one of @column
8391 * or @path need to be non-%NULL. @row_align determines where the row is
8392 * placed, and @col_align determines where @column is placed. Both are expected
8393 * to be between 0.0 and 1.0. 0.0 means left/top alignment, 1.0 means
8394 * right/bottom alignment, 0.5 means center.
8396 * If @use_align is %FALSE, then the alignment arguments are ignored, and the
8397 * tree does the minimum amount of work to scroll the cell onto the screen.
8398 * This means that the cell will be scrolled to the edge closest to it's current
8399 * position. If the cell is currently visible on the screen, nothing is done.
8401 * This function only works if the model is set, and @path is a valid row on the
8402 * model. If the model changes before the @tree_view is realized, the centered
8403 * path will be modified to reflect this change.
8406 gtk_tree_view_scroll_to_cell (GtkTreeView *tree_view,
8408 GtkTreeViewColumn *column,
8413 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8414 g_return_if_fail (tree_view->priv->model != NULL);
8415 g_return_if_fail (tree_view->priv->tree != NULL);
8416 g_return_if_fail (row_align >= 0.0 && row_align <= 1.0);
8417 g_return_if_fail (col_align >= 0.0 && col_align <= 1.0);
8418 g_return_if_fail (path != NULL || column != NULL);
8421 g_print ("gtk_tree_view_scroll_to_cell:\npath: %s\ncolumn: %s\nuse_align: %d\nrow_align: %f\ncol_align: %f\n",
8422 gtk_tree_path_to_string (path), column?"non-null":"null", use_align, row_align, col_align);
8424 row_align = CLAMP (row_align, 0.0, 1.0);
8425 col_align = CLAMP (col_align, 0.0, 1.0);
8428 /* Note: Despite the benefits that come from having one code path for the
8429 * scrolling code, we short-circuit validate_visible_area's immplementation as
8430 * it is much slower than just going to the point.
8432 if (! GTK_WIDGET_REALIZED (tree_view) ||
8433 GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID))
8435 if (tree_view->priv->scroll_to_path)
8436 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
8438 tree_view->priv->scroll_to_path = NULL;
8439 tree_view->priv->scroll_to_column = NULL;
8442 tree_view->priv->scroll_to_path = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
8444 tree_view->priv->scroll_to_column = column;
8445 tree_view->priv->scroll_to_use_align = use_align;
8446 tree_view->priv->scroll_to_row_align = row_align;
8447 tree_view->priv->scroll_to_col_align = col_align;
8449 install_presize_handler (tree_view);
8453 GdkRectangle cell_rect;
8454 GdkRectangle vis_rect;
8455 gint dest_x, dest_y;
8457 gtk_tree_view_get_cell_area (tree_view, path, column, &cell_rect);
8458 gtk_tree_view_widget_to_tree_coords (tree_view, cell_rect.x, cell_rect.y, &(cell_rect.x), &(cell_rect.y));
8459 gtk_tree_view_get_visible_rect (tree_view, &vis_rect);
8461 dest_x = vis_rect.x;
8462 dest_y = vis_rect.y;
8468 dest_x = cell_rect.x - ((vis_rect.width - cell_rect.width) * col_align);
8472 if (cell_rect.x < vis_rect.x)
8473 dest_x = cell_rect.x;
8474 if (cell_rect.x + cell_rect.width > vis_rect.x + vis_rect.width)
8475 dest_x = cell_rect.x + cell_rect.width - vis_rect.width;
8483 dest_y = cell_rect.y - ((vis_rect.height - cell_rect.height) * row_align);
8484 dest_y = MAX (dest_y, 0);
8488 if (cell_rect.y < vis_rect.y)
8489 dest_y = cell_rect.y;
8490 if (cell_rect.y + cell_rect.height > vis_rect.y + vis_rect.height)
8491 dest_y = cell_rect.y + cell_rect.height - vis_rect.height;
8495 gtk_tree_view_scroll_to_point (tree_view, dest_x, dest_y);
8500 * gtk_tree_view_row_activated:
8501 * @tree_view: A #GtkTreeView
8502 * @path: The #GtkTreePath to be activated.
8503 * @column: The #GtkTreeViewColumn to be activated.
8505 * Activates the cell determined by @path and @column.
8508 gtk_tree_view_row_activated (GtkTreeView *tree_view,
8510 GtkTreeViewColumn *column)
8512 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8514 g_signal_emit (G_OBJECT(tree_view), tree_view_signals[ROW_ACTIVATED], 0, path, column);
8519 gtk_tree_view_expand_all_helper (GtkRBTree *tree,
8523 GtkTreeView *tree_view = data;
8526 _gtk_rbtree_traverse (node->children,
8527 node->children->root,
8529 gtk_tree_view_expand_all_helper,
8531 else if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT && node->children == NULL)
8537 node->children = _gtk_rbtree_new ();
8538 node->children->parent_tree = tree;
8539 node->children->parent_node = node;
8540 path = _gtk_tree_view_find_path (tree_view, tree, node);
8541 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
8542 gtk_tree_model_iter_children (tree_view->priv->model, &child, &iter);
8543 gtk_tree_view_build_tree (tree_view,
8546 gtk_tree_path_get_depth (path) + 1,
8548 gtk_tree_path_free (path);
8553 * gtk_tree_view_expand_all:
8554 * @tree_view: A #GtkTreeView.
8556 * Recursively expands all nodes in the @tree_view.
8559 gtk_tree_view_expand_all (GtkTreeView *tree_view)
8561 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8563 if (tree_view->priv->tree == NULL)
8566 _gtk_rbtree_traverse (tree_view->priv->tree,
8567 tree_view->priv->tree->root,
8569 gtk_tree_view_expand_all_helper,
8573 /* Timeout to animate the expander during expands and collapses */
8575 expand_collapse_timeout (gpointer data)
8577 GtkTreeView *tree_view = data;
8583 GDK_THREADS_ENTER ();
8588 node = tree_view->priv->expanded_collapsed_node;
8589 tree = tree_view->priv->expanded_collapsed_tree;
8591 if (node->children == NULL)
8596 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
8598 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
8599 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
8604 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
8606 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
8613 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
8615 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
8616 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
8620 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
8622 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
8631 gtk_tree_view_queue_draw_arrow (tree_view, tree, node, NULL);
8633 GDK_THREADS_LEAVE ();
8638 GDK_THREADS_LEAVE ();
8644 * gtk_tree_view_collapse_all:
8645 * @tree_view: A #GtkTreeView.
8647 * Recursively collapses all visible, expanded nodes in @tree_view.
8650 gtk_tree_view_collapse_all (GtkTreeView *tree_view)
8657 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8659 if (tree_view->priv->tree == NULL)
8662 path = gtk_tree_path_new ();
8663 gtk_tree_path_down (path);
8664 indices = gtk_tree_path_get_indices (path);
8666 tree = tree_view->priv->tree;
8668 while (node && node->left != tree->nil)
8674 gtk_tree_view_real_collapse_row (tree_view, path, tree, node, FALSE);
8676 node = _gtk_rbtree_next (tree, node);
8679 gtk_tree_path_free (path);
8682 /* FIXME the bool return values for expand_row and collapse_row are
8683 * not analagous; they should be TRUE if the row had children and
8684 * was not already in the requested state.
8689 gtk_tree_view_real_expand_row (GtkTreeView *tree_view,
8701 if (node->children && !open_all)
8703 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
8706 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
8707 if (! gtk_tree_model_iter_has_child (tree_view->priv->model, &iter))
8710 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[TEST_EXPAND_ROW], 0, &iter, path, &expand);
8715 node->children = _gtk_rbtree_new ();
8716 node->children->parent_tree = tree;
8717 node->children->parent_node = node;
8719 gtk_tree_model_iter_children (tree_view->priv->model, &temp, &iter);
8721 gtk_tree_view_build_tree (tree_view,
8724 gtk_tree_path_get_depth (path) + 1,
8727 if (tree_view->priv->expand_collapse_timeout)
8729 gtk_timeout_remove (tree_view->priv->expand_collapse_timeout);
8730 tree_view->priv->expand_collapse_timeout = 0;
8733 if (tree_view->priv->expanded_collapsed_node != NULL)
8735 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_EXPANDED);
8736 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_COLLAPSED);
8738 tree_view->priv->expanded_collapsed_node = NULL;
8743 tree_view->priv->expand_collapse_timeout = gtk_timeout_add (50, expand_collapse_timeout, tree_view);
8744 tree_view->priv->expanded_collapsed_node = node;
8745 tree_view->priv->expanded_collapsed_tree = tree;
8747 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
8750 install_presize_handler (tree_view);
8752 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[ROW_EXPANDED], 0, &iter, path);
8758 * gtk_tree_view_expand_row:
8759 * @tree_view: a #GtkTreeView
8760 * @path: path to a row
8761 * @open_all: whether to recursively expand, or just expand immediate children
8763 * Opens the row so its children are visible.
8765 * Return value: %TRUE if the row existed and had children
8768 gtk_tree_view_expand_row (GtkTreeView *tree_view,
8775 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
8776 g_return_val_if_fail (tree_view->priv->model != NULL, FALSE);
8777 g_return_val_if_fail (path != NULL, FALSE);
8779 if (_gtk_tree_view_find_node (tree_view,
8786 return gtk_tree_view_real_expand_row (tree_view, path, tree, node, open_all, FALSE);
8792 gtk_tree_view_real_collapse_row (GtkTreeView *tree_view,
8799 GtkTreeIter children;
8804 if (node->children == NULL)
8807 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
8809 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[TEST_COLLAPSE_ROW], 0, &iter, path, &collapse);
8814 /* if the prelighted node is a child of us, we want to unprelight it. We have
8815 * a chance to prelight the correct node below */
8817 if (tree_view->priv->prelight_tree)
8819 GtkRBTree *parent_tree;
8820 GtkRBNode *parent_node;
8822 parent_tree = tree_view->priv->prelight_tree->parent_tree;
8823 parent_node = tree_view->priv->prelight_tree->parent_node;
8826 if (parent_tree == tree && parent_node == node)
8828 ensure_unprelighted (tree_view);
8831 parent_node = parent_tree->parent_node;
8832 parent_tree = parent_tree->parent_tree;
8836 TREE_VIEW_INTERNAL_ASSERT (gtk_tree_model_iter_children (tree_view->priv->model, &children, &iter), FALSE);
8838 for (list = tree_view->priv->columns; list; list = list->next)
8840 GtkTreeViewColumn *column = list->data;
8842 if (column->visible == FALSE)
8844 if (gtk_tree_view_column_get_sizing (column) == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
8845 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
8848 if (tree_view->priv->destroy_count_func)
8850 GtkTreePath *child_path;
8851 gint child_count = 0;
8852 child_path = gtk_tree_path_copy (path);
8853 gtk_tree_path_down (child_path);
8855 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, &child_count);
8856 (* tree_view->priv->destroy_count_func) (tree_view, child_path, child_count, tree_view->priv->destroy_count_data);
8857 gtk_tree_path_free (child_path);
8860 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
8862 GtkTreePath *cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
8864 if (gtk_tree_path_is_ancestor (path, cursor_path))
8866 gtk_tree_row_reference_free (tree_view->priv->cursor);
8867 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
8868 tree_view->priv->model,
8871 gtk_tree_path_free (cursor_path);
8874 if (gtk_tree_row_reference_valid (tree_view->priv->anchor))
8876 GtkTreePath *anchor_path = gtk_tree_row_reference_get_path (tree_view->priv->anchor);
8877 if (gtk_tree_path_is_ancestor (path, anchor_path))
8879 gtk_tree_row_reference_free (tree_view->priv->anchor);
8880 tree_view->priv->anchor = NULL;
8882 gtk_tree_path_free (anchor_path);
8885 if (gtk_tree_row_reference_valid (tree_view->priv->last_button_press))
8887 GtkTreePath *lsc = gtk_tree_row_reference_get_path (tree_view->priv->last_button_press);
8888 if (gtk_tree_path_is_ancestor (path, lsc))
8890 gtk_tree_row_reference_free (tree_view->priv->last_button_press);
8891 tree_view->priv->last_button_press = NULL;
8893 gtk_tree_path_free (lsc);
8896 if (gtk_tree_row_reference_valid (tree_view->priv->last_button_press_2))
8898 GtkTreePath *lsc = gtk_tree_row_reference_get_path (tree_view->priv->last_button_press_2);
8899 if (gtk_tree_path_is_ancestor (path, lsc))
8901 gtk_tree_row_reference_free (tree_view->priv->last_button_press_2);
8902 tree_view->priv->last_button_press_2 = NULL;
8904 gtk_tree_path_free (lsc);
8907 if (gtk_tree_view_unref_and_check_selection_tree (tree_view, node->children))
8909 _gtk_rbtree_remove (node->children);
8910 g_signal_emit_by_name (G_OBJECT (tree_view->priv->selection), "changed", 0);
8913 _gtk_rbtree_remove (node->children);
8915 if (tree_view->priv->expand_collapse_timeout)
8917 gtk_timeout_remove (tree_view->priv->expand_collapse_timeout);
8918 tree_view->priv->expand_collapse_timeout = 0;
8921 if (tree_view->priv->expanded_collapsed_node != NULL)
8923 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_EXPANDED);
8924 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_COLLAPSED);
8926 tree_view->priv->expanded_collapsed_node = NULL;
8931 tree_view->priv->expand_collapse_timeout = gtk_timeout_add (50, expand_collapse_timeout, tree_view);
8932 tree_view->priv->expanded_collapsed_node = node;
8933 tree_view->priv->expanded_collapsed_tree = tree;
8935 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
8938 if (GTK_WIDGET_MAPPED (tree_view))
8940 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8943 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[ROW_COLLAPSED], 0, &iter, path);
8945 /* now that we've collapsed all rows, we want to try to set the prelight
8946 * again. To do this, we fake a motion event and send it to ourselves. */
8948 if (gdk_window_at_pointer (&x, &y) == tree_view->priv->bin_window)
8950 GdkEventMotion event;
8951 event.window = tree_view->priv->bin_window;
8955 /* despite the fact this isn't a real event, I'm almost positive it will
8956 * never trigger a drag event. maybe_drag is the only function that uses
8957 * more than just event.x and event.y. */
8958 gtk_tree_view_motion_bin_window (GTK_WIDGET (tree_view), &event);
8964 * gtk_tree_view_collapse_row:
8965 * @tree_view: a #GtkTreeView
8966 * @path: path to a row in the @tree_view
8968 * Collapses a row (hides its child rows, if they exist).
8970 * Return value: %TRUE if the row was collapsed.
8973 gtk_tree_view_collapse_row (GtkTreeView *tree_view,
8979 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
8980 g_return_val_if_fail (tree_view->priv->tree != NULL, FALSE);
8981 g_return_val_if_fail (path != NULL, FALSE);
8983 if (_gtk_tree_view_find_node (tree_view,
8989 if (tree == NULL || node->children == NULL)
8992 return gtk_tree_view_real_collapse_row (tree_view, path, tree, node, FALSE);
8996 gtk_tree_view_map_expanded_rows_helper (GtkTreeView *tree_view,
8999 GtkTreeViewMappingFunc func,
9004 if (tree == NULL || tree->root == NULL)
9009 while (node && node->left != tree->nil)
9016 gtk_tree_path_down (path);
9017 gtk_tree_view_map_expanded_rows_helper (tree_view, node->children, path, func, user_data);
9018 gtk_tree_path_up (path);
9019 (* func) (tree_view, path, user_data);
9021 gtk_tree_path_next (path);
9022 node = _gtk_rbtree_next (tree, node);
9027 * gtk_tree_view_map_expanded_rows:
9028 * @tree_view: A #GtkTreeView
9029 * @func: A function to be called
9030 * @data: User data to be passed to the function.
9032 * Calls @func on all expanded rows.
9035 gtk_tree_view_map_expanded_rows (GtkTreeView *tree_view,
9036 GtkTreeViewMappingFunc func,
9041 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9042 g_return_if_fail (func != NULL);
9044 path = gtk_tree_path_new_first ();
9046 gtk_tree_view_map_expanded_rows_helper (tree_view,
9047 tree_view->priv->tree,
9048 path, func, user_data);
9050 gtk_tree_path_free (path);
9054 * gtk_tree_view_row_expanded:
9055 * @tree_view: A #GtkTreeView.
9056 * @path: A #GtkTreePath to test expansion state.
9058 * Returns %TRUE if the node pointed to by @path is expanded in @tree_view.
9060 * Return value: %TRUE if #path is expanded.
9063 gtk_tree_view_row_expanded (GtkTreeView *tree_view,
9069 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
9070 g_return_val_if_fail (path != NULL, FALSE);
9072 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
9077 return (node->children != NULL);
9080 static GtkTargetEntry row_targets[] = {
9081 { "GTK_TREE_MODEL_ROW", GTK_TARGET_SAME_WIDGET, 0 }
9086 * gtk_tree_view_get_reorderable:
9087 * @tree_view: a #GtkTreeView
9089 * Retrieves whether the user can reorder the tree via drag-and-drop. See
9090 * gtk_tree_view_set_reorderable().
9092 * Return value: %TRUE if the tree can be reordered.
9095 gtk_tree_view_get_reorderable (GtkTreeView *tree_view)
9097 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
9099 return tree_view->priv->reorderable;
9103 * gtk_tree_view_set_reorderable:
9104 * @tree_view: A #GtkTreeView.
9105 * @reorderable: %TRUE, if the tree can be reordered.
9107 * This function is a convenience function to allow you to reorder models that
9108 * support the #GtkDragSourceIface and the #GtkDragDestIface. Both
9109 * #GtkTreeStore and #GtkListStore support these. If @reorderable is %TRUE, then
9110 * the user can reorder the model by dragging and dropping rows. The
9111 * developer can listen to these changes by connecting to the model's
9114 * This function does not give you any degree of control over the order -- any
9115 * reorderering is allowed. If more control is needed, you should probably
9116 * handle drag and drop manually.
9119 gtk_tree_view_set_reorderable (GtkTreeView *tree_view,
9120 gboolean reorderable)
9122 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9124 reorderable = reorderable != FALSE;
9126 if (tree_view->priv->reorderable == reorderable)
9131 gtk_tree_view_enable_model_drag_source (tree_view,
9134 G_N_ELEMENTS (row_targets),
9136 gtk_tree_view_enable_model_drag_dest (tree_view,
9138 G_N_ELEMENTS (row_targets),
9143 gtk_tree_view_unset_rows_drag_source (tree_view);
9144 gtk_tree_view_unset_rows_drag_dest (tree_view);
9147 tree_view->priv->reorderable = reorderable;
9149 g_object_notify (G_OBJECT (tree_view), "reorderable");
9153 gtk_tree_view_real_set_cursor (GtkTreeView *tree_view,
9155 gboolean clear_and_select,
9156 gboolean clamp_node)
9158 GtkRBTree *tree = NULL;
9159 GtkRBNode *node = NULL;
9160 GdkModifierType state = 0;
9162 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
9164 GtkTreePath *cursor_path;
9165 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9166 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
9167 gtk_tree_path_free (cursor_path);
9170 gtk_tree_row_reference_free (tree_view->priv->cursor);
9171 gtk_get_current_event_state (&state);
9173 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
9174 tree_view->priv->model,
9176 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
9179 if (clear_and_select && !((state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK))
9180 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
9185 gtk_tree_view_clamp_node_visible (tree_view, tree, node);
9186 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
9190 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[CURSOR_CHANGED], 0);
9194 * gtk_tree_view_get_cursor:
9195 * @tree_view: A #GtkTreeView
9196 * @path: A pointer to be filled with the current cursor path, or %NULL
9197 * @focus_column: A pointer to be filled with the current focus column, or %NULL
9199 * Fills in @path and @focus_column with the current path and focus column. If
9200 * the cursor isn't currently set, then *@path will be %NULL. If no column
9201 * currently has focus, then *@focus_column will be %NULL.
9204 gtk_tree_view_get_cursor (GtkTreeView *tree_view,
9206 GtkTreeViewColumn **focus_column)
9208 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9212 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
9213 *path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9220 *focus_column = tree_view->priv->focus_column;
9225 * gtk_tree_view_set_cursor:
9226 * @tree_view: A #GtkTreeView
9227 * @path: A #GtkTreePath
9228 * @focus_column: A #GtkTreeViewColumn, or %NULL
9229 * @start_editing: %TRUE if the specified cell should start being edited.
9231 * Sets the current keyboard focus to be at @path, and selects it. This is
9232 * useful when you want to focus the user's attention on a particular row. If
9233 * @column is not %NULL, then focus is given to the column specified by it.
9234 * Additionally, if @column is specified, and @start_editing is %TRUE, then
9235 * editing should be started in the specified cell. This function is often
9236 * followed by @gtk_widget_grab_focus (@tree_view) in order to give keyboard
9237 * focus to the widget. Please note that editing can only happen when the
9238 * widget is realized.
9241 gtk_tree_view_set_cursor (GtkTreeView *tree_view,
9243 GtkTreeViewColumn *focus_column,
9244 gboolean start_editing)
9246 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9247 g_return_if_fail (path != NULL);
9249 g_return_if_fail (GTK_IS_TREE_VIEW_COLUMN (focus_column));
9251 gtk_tree_view_real_set_cursor (tree_view, path, TRUE, TRUE);
9253 if (focus_column && focus_column->visible)
9256 gboolean column_in_tree = FALSE;
9258 for (list = tree_view->priv->columns; list; list = list->next)
9259 if (list->data == focus_column)
9261 column_in_tree = TRUE;
9264 g_return_if_fail (column_in_tree);
9265 tree_view->priv->focus_column = focus_column;
9267 gtk_tree_view_start_editing (tree_view, path);
9273 * gtk_tree_view_get_bin_window:
9274 * @tree_view: A #GtkTreeView
9276 * Returns the window that @tree_view renders to. This is used primarily to
9277 * compare to <literal>event->window</literal> to confirm that the event on
9278 * @tree_view is on the right window.
9280 * Return value: A #GdkWindow, or %NULL when @tree_view hasn't been realized yet
9283 gtk_tree_view_get_bin_window (GtkTreeView *tree_view)
9285 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
9287 return tree_view->priv->bin_window;
9291 * gtk_tree_view_get_path_at_pos:
9292 * @tree_view: A #GtkTreeView.
9293 * @x: The x position to be identified.
9294 * @y: The y position to be identified.
9295 * @path: A pointer to a #GtkTreePath pointer to be filled in, or %NULL
9296 * @column: A pointer to a #GtkTreeViewColumn pointer to be filled in, or %NULL
9297 * @cell_x: A pointer where the X coordinate relative to the cell can be placed, or %NULL
9298 * @cell_y: A pointer where the Y coordinate relative to the cell can be placed, or %NULL
9300 * Finds the path at the point (@x, @y), relative to widget coordinates. That
9301 * is, @x and @y are relative to an events coordinates. @x and @y must come
9302 * from an event on the @tree_view only where event->window ==
9303 * gtk_tree_view_get_bin (). It is primarily for things like popup menus.
9304 * If @path is non-%NULL, then it will be filled with the #GtkTreePath at that
9305 * point. This path should be freed with gtk_tree_path_free(). If @column
9306 * is non-%NULL, then it will be filled with the column at that point.
9307 * @cell_x and @cell_y return the coordinates relative to the cell background
9308 * (i.e. the @background_area passed to gtk_cell_renderer_render()). This
9309 * function is only meaningful if @tree_view is realized.
9311 * Return value: %TRUE if a row exists at that coordinate.
9314 gtk_tree_view_get_path_at_pos (GtkTreeView *tree_view,
9318 GtkTreeViewColumn **column,
9326 g_return_val_if_fail (tree_view != NULL, FALSE);
9327 g_return_val_if_fail (tree_view->priv->bin_window != NULL, FALSE);
9334 if (tree_view->priv->tree == NULL)
9337 if (x > tree_view->priv->hadjustment->page_size)
9343 if (column || cell_x)
9345 GtkTreeViewColumn *tmp_column;
9346 GtkTreeViewColumn *last_column = NULL;
9348 gint remaining_x = x;
9349 gboolean found = FALSE;
9351 for (list = tree_view->priv->columns; list; list = list->next)
9353 tmp_column = list->data;
9355 if (tmp_column->visible == FALSE)
9358 last_column = tmp_column;
9359 if (remaining_x <= tmp_column->width)
9364 *column = tmp_column;
9367 *cell_x = remaining_x;
9371 remaining_x -= tmp_column->width;
9377 *column = last_column;
9380 *cell_x = last_column->width + remaining_x;
9384 y_offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
9385 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, y),
9395 *path = _gtk_tree_view_find_path (tree_view, tree, node);
9402 * gtk_tree_view_get_cell_area:
9403 * @tree_view: a #GtkTreeView
9404 * @path: a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
9405 * @column: a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
9406 * @rect: rectangle to fill with cell rect
9408 * Fills the bounding rectangle in tree window coordinates for the cell at the
9409 * row specified by @path and the column specified by @column. If @path is
9410 * %NULL, or points to a path not currently displayed, the @y and @height fields
9411 * of the rectangle will be filled with 0. If @column is %NULL, the @x and @width
9412 * fields will be filled with 0. The sum of all cell rects does not cover the
9413 * entire tree; there are extra pixels in between rows, for example. The
9414 * returned rectangle is equivalent to the @cell_area passed to
9415 * gtk_cell_renderer_render(). This function is only valid if #tree_view is
9419 gtk_tree_view_get_cell_area (GtkTreeView *tree_view,
9421 GtkTreeViewColumn *column,
9424 GtkRBTree *tree = NULL;
9425 GtkRBNode *node = NULL;
9426 gint vertical_separator;
9427 gint horizontal_separator;
9429 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9430 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
9431 g_return_if_fail (rect != NULL);
9432 g_return_if_fail (!column || column->tree_view == (GtkWidget *) tree_view);
9433 g_return_if_fail (GTK_WIDGET_REALIZED (tree_view));
9435 gtk_widget_style_get (GTK_WIDGET (tree_view),
9436 "vertical_separator", &vertical_separator,
9437 "horizontal_separator", &horizontal_separator,
9447 rect->x = column->button->allocation.x + horizontal_separator/2;
9448 rect->width = column->button->allocation.width - horizontal_separator;
9453 /* Get vertical coords */
9454 if (!_gtk_tree_view_find_node (tree_view, path, &tree, &node) &&
9458 rect->y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
9459 rect->height = MAX (CELL_HEIGHT (node, vertical_separator), tree_view->priv->expander_size - vertical_separator);
9461 if (gtk_tree_view_is_expander_column (tree_view, column) &&
9462 TREE_VIEW_DRAW_EXPANDERS (tree_view))
9464 gint depth = gtk_tree_path_get_depth (path) - 1;
9466 rect->x += depth * tree_view->priv->expander_size;
9467 rect->width -= depth * tree_view->priv->expander_size;
9468 rect->width = MAX (rect->width, 0);
9474 * gtk_tree_view_get_background_area:
9475 * @tree_view: a #GtkTreeView
9476 * @path: a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
9477 * @column: a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
9478 * @rect: rectangle to fill with cell background rect
9480 * Fills the bounding rectangle in tree window coordinates for the cell at the
9481 * row specified by @path and the column specified by @column. If @path is
9482 * %NULL, or points to a node not found in the tree, the @y and @height fields of
9483 * the rectangle will be filled with 0. If @column is %NULL, the @x and @width
9484 * fields will be filled with 0. The returned rectangle is equivalent to the
9485 * @background_area passed to gtk_cell_renderer_render(). These background
9486 * areas tile to cover the entire tree window (except for the area used for
9487 * header buttons). Contrast with the @cell_area, returned by
9488 * gtk_tree_view_get_cell_area(), which returns only the cell itself, excluding
9489 * surrounding borders and the tree expander area.
9493 gtk_tree_view_get_background_area (GtkTreeView *tree_view,
9495 GtkTreeViewColumn *column,
9498 GtkRBTree *tree = NULL;
9499 GtkRBNode *node = NULL;
9501 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9502 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
9503 g_return_if_fail (rect != NULL);
9512 /* Get vertical coords */
9514 if (!_gtk_tree_view_find_node (tree_view, path, &tree, &node) &&
9518 rect->y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
9520 rect->height = MAX (BACKGROUND_HEIGHT (node), tree_view->priv->expander_size);
9527 gtk_tree_view_get_background_xrange (tree_view, tree, column, &rect->x, &x2);
9528 rect->width = x2 - rect->x;
9533 * gtk_tree_view_get_visible_rect:
9534 * @tree_view: a #GtkTreeView
9535 * @visible_rect: rectangle to fill
9537 * Fills @visible_rect with the currently-visible region of the
9538 * buffer, in tree coordinates. Convert to widget coordinates with
9539 * gtk_tree_view_tree_to_widget_coords(). Tree coordinates start at
9540 * 0,0 for row 0 of the tree, and cover the entire scrollable area of
9544 gtk_tree_view_get_visible_rect (GtkTreeView *tree_view,
9545 GdkRectangle *visible_rect)
9549 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9551 widget = GTK_WIDGET (tree_view);
9555 visible_rect->x = tree_view->priv->hadjustment->value;
9556 visible_rect->y = tree_view->priv->vadjustment->value;
9557 visible_rect->width = widget->allocation.width;
9558 visible_rect->height = widget->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
9563 * gtk_tree_view_widget_to_tree_coords:
9564 * @tree_view: a #GtkTreeView
9565 * @wx: widget X coordinate
9566 * @wy: widget Y coordinate
9567 * @tx: return location for tree X coordinate
9568 * @ty: return location for tree Y coordinate
9570 * Converts widget coordinates to coordinates for the
9571 * tree window (the full scrollable area of the tree).
9575 gtk_tree_view_widget_to_tree_coords (GtkTreeView *tree_view,
9581 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9584 *tx = wx + tree_view->priv->hadjustment->value;
9586 *ty = wy + tree_view->priv->dy;
9590 * gtk_tree_view_tree_to_widget_coords:
9591 * @tree_view: a #GtkTreeView
9592 * @tx: tree X coordinate
9593 * @ty: tree Y coordinate
9594 * @wx: return location for widget X coordinate
9595 * @wy: return location for widget Y coordinate
9597 * Converts tree coordinates (coordinates in full scrollable area of the tree)
9598 * to widget coordinates.
9602 gtk_tree_view_tree_to_widget_coords (GtkTreeView *tree_view,
9608 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9611 *wx = tx - tree_view->priv->hadjustment->value;
9613 *wy = ty - tree_view->priv->dy;
9617 unset_reorderable (GtkTreeView *tree_view)
9619 if (tree_view->priv->reorderable)
9621 tree_view->priv->reorderable = FALSE;
9622 g_object_notify (G_OBJECT (tree_view), "reorderable");
9627 gtk_tree_view_enable_model_drag_source (GtkTreeView *tree_view,
9628 GdkModifierType start_button_mask,
9629 const GtkTargetEntry *targets,
9631 GdkDragAction actions)
9633 TreeViewDragInfo *di;
9635 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9637 di = ensure_info (tree_view);
9638 clear_source_info (di);
9640 di->start_button_mask = start_button_mask;
9641 di->source_target_list = gtk_target_list_new (targets, n_targets);
9642 di->source_actions = actions;
9644 di->source_set = TRUE;
9646 unset_reorderable (tree_view);
9650 gtk_tree_view_enable_model_drag_dest (GtkTreeView *tree_view,
9651 const GtkTargetEntry *targets,
9653 GdkDragAction actions)
9655 TreeViewDragInfo *di;
9657 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9659 gtk_drag_dest_set (GTK_WIDGET (tree_view),
9665 di = ensure_info (tree_view);
9666 clear_dest_info (di);
9669 di->dest_target_list = gtk_target_list_new (targets, n_targets);
9671 di->dest_set = TRUE;
9673 unset_reorderable (tree_view);
9677 gtk_tree_view_unset_rows_drag_source (GtkTreeView *tree_view)
9679 TreeViewDragInfo *di;
9681 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9683 di = get_info (tree_view);
9689 clear_source_info (di);
9690 di->source_set = FALSE;
9693 if (!di->dest_set && !di->source_set)
9694 remove_info (tree_view);
9697 unset_reorderable (tree_view);
9701 gtk_tree_view_unset_rows_drag_dest (GtkTreeView *tree_view)
9703 TreeViewDragInfo *di;
9705 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9707 di = get_info (tree_view);
9713 gtk_drag_dest_unset (GTK_WIDGET (tree_view));
9714 clear_dest_info (di);
9715 di->dest_set = FALSE;
9718 if (!di->dest_set && !di->source_set)
9719 remove_info (tree_view);
9722 unset_reorderable (tree_view);
9726 gtk_tree_view_set_drag_dest_row (GtkTreeView *tree_view,
9728 GtkTreeViewDropPosition pos)
9730 GtkTreePath *current_dest;
9731 /* Note; this function is exported to allow a custom DND
9732 * implementation, so it can't touch TreeViewDragInfo
9735 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9737 current_dest = NULL;
9739 if (tree_view->priv->drag_dest_row)
9740 current_dest = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
9742 if (tree_view->priv->drag_dest_row)
9743 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
9745 tree_view->priv->drag_dest_pos = pos;
9749 tree_view->priv->drag_dest_row =
9750 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
9751 gtk_tree_view_queue_draw_path (tree_view, path, NULL);
9754 tree_view->priv->drag_dest_row = NULL;
9758 GtkRBTree *tree, *new_tree;
9759 GtkRBNode *node, *new_node;
9761 _gtk_tree_view_find_node (tree_view, current_dest, &tree, &node);
9762 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
9766 _gtk_rbtree_next_full (tree, node, &new_tree, &new_node);
9767 if (new_tree && new_node)
9768 _gtk_tree_view_queue_draw_node (tree_view, new_tree, new_node, NULL);
9770 _gtk_rbtree_prev_full (tree, node, &new_tree, &new_node);
9771 if (new_tree && new_node)
9772 _gtk_tree_view_queue_draw_node (tree_view, new_tree, new_node, NULL);
9774 gtk_tree_path_free (current_dest);
9779 gtk_tree_view_get_drag_dest_row (GtkTreeView *tree_view,
9781 GtkTreeViewDropPosition *pos)
9783 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9787 if (tree_view->priv->drag_dest_row)
9788 *path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
9794 *pos = tree_view->priv->drag_dest_pos;
9798 gtk_tree_view_get_dest_row_at_pos (GtkTreeView *tree_view,
9802 GtkTreeViewDropPosition *pos)
9805 gdouble offset_into_row;
9808 GtkTreeViewColumn *column = NULL;
9809 GtkTreePath *tmp_path = NULL;
9811 /* Note; this function is exported to allow a custom DND
9812 * implementation, so it can't touch TreeViewDragInfo
9815 g_return_val_if_fail (tree_view != NULL, FALSE);
9816 g_return_val_if_fail (drag_x >= 0, FALSE);
9817 g_return_val_if_fail (drag_y >= 0, FALSE);
9818 g_return_val_if_fail (tree_view->priv->bin_window != NULL, FALSE);
9824 if (tree_view->priv->tree == NULL)
9827 /* If in the top third of a row, we drop before that row; if
9828 * in the bottom third, drop after that row; if in the middle,
9829 * and the row has children, drop into the row.
9832 if (!gtk_tree_view_get_path_at_pos (tree_view,
9834 drag_y - TREE_VIEW_HEADER_HEIGHT (tree_view),
9841 gtk_tree_view_get_background_area (tree_view, tmp_path, column,
9844 offset_into_row = cell_y;
9849 gtk_tree_path_free (tmp_path);
9853 third = cell.height / 3.0;
9857 if (offset_into_row < third)
9859 *pos = GTK_TREE_VIEW_DROP_BEFORE;
9861 else if (offset_into_row < (cell.height / 2.0))
9863 *pos = GTK_TREE_VIEW_DROP_INTO_OR_BEFORE;
9865 else if (offset_into_row < third * 2.0)
9867 *pos = GTK_TREE_VIEW_DROP_INTO_OR_AFTER;
9871 *pos = GTK_TREE_VIEW_DROP_AFTER;
9880 /* KEEP IN SYNC WITH GTK_TREE_VIEW_BIN_EXPOSE */
9882 * gtk_tree_view_create_row_drag_icon:
9883 * @tree_view: a #GtkTreeView
9884 * @path: a #GtkTreePath in @tree_view
9886 * Creates a #GdkPixmap representation of the row at @path. This image is used
9889 * Return value: a newly-allocated pixmap of the drag icon.
9892 gtk_tree_view_create_row_drag_icon (GtkTreeView *tree_view,
9900 GdkRectangle background_area;
9901 GdkRectangle expose_area;
9904 /* start drawing inside the black outline */
9906 GdkDrawable *drawable;
9907 gint bin_window_width;
9909 widget = GTK_WIDGET (tree_view);
9911 depth = gtk_tree_path_get_depth (path);
9913 _gtk_tree_view_find_node (tree_view,
9921 if (!gtk_tree_model_get_iter (tree_view->priv->model,
9928 background_area.y = y;
9929 background_area.height = MAX (BACKGROUND_HEIGHT (node), tree_view->priv->expander_size);
9931 gdk_drawable_get_size (tree_view->priv->bin_window,
9932 &bin_window_width, NULL);
9934 drawable = gdk_pixmap_new (tree_view->priv->bin_window,
9935 bin_window_width + 2,
9936 background_area.height + 2,
9941 expose_area.width = bin_window_width + 2;
9942 expose_area.height = background_area.height + 2;
9944 gdk_draw_rectangle (drawable,
9945 widget->style->base_gc [GTK_WIDGET_STATE (widget)],
9948 bin_window_width + 2,
9949 background_area.height + 2);
9951 for (list = tree_view->priv->columns; list; list = list->next)
9953 GtkTreeViewColumn *column = list->data;
9954 GdkRectangle cell_area;
9955 gint vertical_separator;
9957 if (!column->visible)
9960 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, &iter,
9961 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
9962 node->children?TRUE:FALSE);
9964 background_area.x = cell_offset;
9965 background_area.width = column->width;
9967 cell_area = background_area;
9969 gtk_widget_style_get (widget, "vertical_separator", &vertical_separator, NULL);
9970 cell_area.y += vertical_separator / 2;
9971 cell_area.height -= vertical_separator;
9973 if (gtk_tree_view_is_expander_column (tree_view, column) &&
9974 TREE_VIEW_DRAW_EXPANDERS(tree_view))
9976 cell_area.x += depth * tree_view->priv->expander_size;
9977 cell_area.width -= depth * tree_view->priv->expander_size;
9980 if (gtk_tree_view_column_cell_is_visible (column))
9981 _gtk_tree_view_column_cell_render (column,
9987 cell_offset += column->width;
9990 gdk_draw_rectangle (drawable,
9991 widget->style->black_gc,
9994 bin_window_width + 1,
9995 background_area.height + 1);
10002 * gtk_tree_view_set_destroy_count_func:
10003 * @tree_view: A #GtkTreeView
10004 * @func: Function to be called when a view row is destroyed, or %NULL
10005 * @data: User data to be passed to @func, or %NULL
10006 * @destroy: Destroy notifier for @data, or %NULL
10008 * This function should almost never be used. It is meant for private use by
10009 * ATK for determining the number of visible children that are removed when the
10010 * user collapses a row, or a row is deleted.
10013 gtk_tree_view_set_destroy_count_func (GtkTreeView *tree_view,
10014 GtkTreeDestroyCountFunc func,
10016 GtkDestroyNotify destroy)
10018 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10020 if (tree_view->priv->destroy_count_destroy)
10021 (* tree_view->priv->destroy_count_destroy) (tree_view->priv->destroy_count_data);
10023 tree_view->priv->destroy_count_func = func;
10024 tree_view->priv->destroy_count_data = data;
10025 tree_view->priv->destroy_count_destroy = destroy;
10030 * Interactive search
10034 * gtk_tree_view_set_enable_search:
10035 * @tree_view: A #GtkTreeView
10036 * @enable_search: %TRUE, if the user can search interactively
10038 * If @enable_search is set, then the user can type in text to search through
10039 * the tree interactively.
10042 gtk_tree_view_set_enable_search (GtkTreeView *tree_view,
10043 gboolean enable_search)
10045 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10047 enable_search = !!enable_search;
10049 if (tree_view->priv->enable_search != enable_search)
10051 tree_view->priv->enable_search = enable_search;
10052 g_object_notify (G_OBJECT (tree_view), "enable_search");
10057 * gtk_tree_view_get_enable_search:
10058 * @tree_view: A #GtkTreeView
10060 * Returns whether or not the tree allows interactive searching.
10062 * Return value: whether or not to let the user search interactively
10065 gtk_tree_view_get_enable_search (GtkTreeView *tree_view)
10067 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
10069 return tree_view->priv->enable_search;
10074 * gtk_tree_view_get_search_column:
10075 * @tree_view: A #GtkTreeView
10077 * Gets the column searched on by the interactive search code.
10079 * Return value: the column the interactive search code searches in.
10082 gtk_tree_view_get_search_column (GtkTreeView *tree_view)
10084 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), 0);
10086 return (tree_view->priv->search_column);
10090 * gtk_tree_view_set_search_column:
10091 * @tree_view: A #GtkTreeView
10092 * @column: the column to search in
10094 * Sets @column as the column where the interactive search code should search
10095 * in. Additionally, turns on interactive searching.
10098 gtk_tree_view_set_search_column (GtkTreeView *tree_view,
10101 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10102 g_return_if_fail (column >= 0);
10104 if (tree_view->priv->search_column == column)
10107 tree_view->priv->search_column = column;
10108 g_object_notify (G_OBJECT (tree_view), "search_column");
10112 * gtk_tree_view_get_search_equal_func:
10113 * @tree_view: A #GtkTreeView
10115 * Returns the compare function currently in use.
10117 * Return value: the currently used compare function for the search code.
10120 GtkTreeViewSearchEqualFunc
10121 gtk_tree_view_get_search_equal_func (GtkTreeView *tree_view)
10123 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
10125 return tree_view->priv->search_equal_func;
10129 * gtk_tree_view_set_search_equal_func:
10130 * @tree_view: A #GtkTreeView
10131 * @search_equal_func: the compare function to use during the search
10132 * @search_user_data: user data to pass to @search_equal_func, or %NULL
10133 * @search_destroy: Destroy notifier for @search_user_data, or %NULL
10135 * Sets the compare function for the interactive search capabilities.
10138 gtk_tree_view_set_search_equal_func (GtkTreeView *tree_view,
10139 GtkTreeViewSearchEqualFunc search_equal_func,
10140 gpointer search_user_data,
10141 GtkDestroyNotify search_destroy)
10143 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10144 g_return_if_fail (search_equal_func !=NULL);
10146 if (tree_view->priv->search_destroy)
10147 (* tree_view->priv->search_destroy) (tree_view->priv->search_user_data);
10149 tree_view->priv->search_equal_func = search_equal_func;
10150 tree_view->priv->search_user_data = search_user_data;
10151 tree_view->priv->search_destroy = search_destroy;
10152 if (tree_view->priv->search_equal_func == NULL)
10153 tree_view->priv->search_equal_func = gtk_tree_view_search_equal_func;
10157 gtk_tree_view_search_dialog_destroy (GtkWidget *search_dialog,
10158 GtkTreeView *tree_view)
10160 GtkEntry *entry = (GtkEntry *)(gtk_container_get_children (GTK_CONTAINER (search_dialog)))->data;
10161 gint *selected_iter;
10163 if (tree_view->priv->disable_popdown)
10168 GdkEventFocus focus_event;
10170 focus_event.type = GDK_FOCUS_CHANGE;
10171 focus_event.in = FALSE;
10172 gtk_widget_event (GTK_WIDGET (entry), (GdkEvent *) &focus_event);
10175 /* remove data from tree_view */
10176 g_object_set_data (G_OBJECT (tree_view), GTK_TREE_VIEW_SEARCH_DIALOG_KEY,
10179 selected_iter = g_object_get_data (G_OBJECT (search_dialog),
10180 "gtk-tree-view-selected-iter");
10182 g_free (selected_iter);
10183 g_object_set_data (G_OBJECT (search_dialog), "gtk-tree-view-selected-iter",
10186 gtk_widget_destroy (search_dialog);
10190 gtk_tree_view_search_position_func (GtkTreeView *tree_view,
10191 GtkWidget *search_dialog)
10194 gint tree_x, tree_y;
10195 gint tree_width, tree_height;
10196 GdkWindow *tree_window = GTK_WIDGET (tree_view)->window;
10197 GtkRequisition requisition;
10199 gtk_widget_realize (search_dialog);
10201 gdk_window_get_origin (tree_window, &tree_x, &tree_y);
10202 gdk_window_get_size (tree_window,
10205 gtk_widget_size_request (search_dialog, &requisition);
10207 if (tree_x + tree_width - requisition.width > gdk_screen_width ())
10208 x = gdk_screen_width () - requisition.width;
10209 else if (tree_x + tree_width - requisition.width < 0)
10212 x = tree_x + tree_width - requisition.width;
10214 if (tree_y + tree_height > gdk_screen_height ())
10215 y = gdk_screen_height () - requisition.height;
10216 else if (tree_y + tree_height < 0) /* isn't really possible ... */
10219 y = tree_y + tree_height;
10221 gtk_window_move (GTK_WINDOW (search_dialog), x, y);
10225 gtk_tree_view_search_disable_popdown (GtkEntry *entry,
10229 GtkTreeView *tree_view = (GtkTreeView *)data;
10231 tree_view->priv->disable_popdown = 1;
10232 g_signal_connect (G_OBJECT (menu), "hide",
10233 G_CALLBACK (gtk_tree_view_search_enable_popdown), data);
10237 gtk_tree_view_real_search_enable_popdown (gpointer data)
10239 GtkTreeView *tree_view = (GtkTreeView *)data;
10241 GDK_THREADS_ENTER ();
10243 tree_view->priv->disable_popdown = 0;
10245 GDK_THREADS_LEAVE ();
10251 gtk_tree_view_search_enable_popdown (GtkWidget *widget,
10254 g_timeout_add (200, gtk_tree_view_real_search_enable_popdown, data);
10258 gtk_tree_view_search_delete_event (GtkWidget *widget,
10259 GdkEventAny *event,
10260 GtkTreeView *tree_view)
10262 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
10264 gtk_tree_view_search_dialog_destroy (widget, tree_view);
10270 gtk_tree_view_search_button_press_event (GtkWidget *widget,
10271 GdkEventButton *event,
10272 GtkTreeView *tree_view)
10274 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
10276 gtk_tree_view_search_dialog_destroy (widget, tree_view);
10282 gtk_tree_view_search_key_press_event (GtkWidget *widget,
10283 GdkEventKey *event,
10284 GtkTreeView *tree_view)
10286 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
10287 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
10290 if (event->keyval == GDK_Escape ||
10291 event->keyval == GDK_Return ||
10292 event->keyval == GDK_Tab)
10294 gtk_tree_view_search_dialog_destroy (widget, tree_view);
10298 /* select previous matching iter */
10299 if (event->keyval == GDK_Up)
10301 gtk_tree_view_search_move (widget, tree_view, TRUE);
10305 /* select next matching iter */
10306 if (event->keyval == GDK_Down)
10308 gtk_tree_view_search_move (widget, tree_view, FALSE);
10316 gtk_tree_view_search_move (GtkWidget *window,
10317 GtkTreeView *tree_view,
10321 gint *selected_iter;
10326 GtkTreeModel *model;
10327 GtkTreeSelection *selection;
10329 text = g_object_get_data (G_OBJECT (window), "gtk-tree-view-text");
10330 selected_iter = g_object_get_data (G_OBJECT (window), "gtk-tree-view-selected-iter");
10332 g_return_if_fail (text != NULL);
10334 if (!selected_iter || (up && *selected_iter == 1))
10337 len = strlen (text);
10342 model = gtk_tree_view_get_model (tree_view);
10343 selection = gtk_tree_view_get_selection (tree_view);
10346 gtk_tree_selection_unselect_all (selection);
10347 gtk_tree_model_get_iter_first (model, &iter);
10349 ret = gtk_tree_view_search_iter (model, selection, &iter, text,
10350 &count, up?((*selected_iter) - 1):((*selected_iter + 1)));
10355 *selected_iter += up?(-1):(1);
10359 /* return to old iter */
10361 gtk_tree_model_get_iter_first (model, &iter);
10362 gtk_tree_view_search_iter (model, selection,
10364 &count, *selected_iter);
10369 gtk_tree_view_search_equal_func (GtkTreeModel *model,
10373 gpointer search_data)
10375 gboolean retval = TRUE;
10376 gchar *normalized_string;
10377 gchar *normalized_key;
10378 gchar *case_normalized_string;
10379 gchar *case_normalized_key;
10380 GValue value = {0,};
10383 gtk_tree_model_get_value (model, iter, column, &value);
10384 normalized_string = g_utf8_normalize (g_value_get_string (&value), -1, G_NORMALIZE_ALL);
10385 normalized_key = g_utf8_normalize (key, -1, G_NORMALIZE_ALL);
10386 case_normalized_string = g_utf8_casefold (normalized_string, -1);
10387 case_normalized_key = g_utf8_casefold (normalized_key, -1);
10389 key_len = strlen (case_normalized_key);
10391 if (!strncmp (case_normalized_key, case_normalized_string, key_len))
10394 g_value_unset (&value);
10395 g_free (normalized_key);
10396 g_free (normalized_string);
10397 g_free (case_normalized_key);
10398 g_free (case_normalized_string);
10404 gtk_tree_view_search_iter (GtkTreeModel *model,
10405 GtkTreeSelection *selection,
10411 GtkRBTree *tree = NULL;
10412 GtkRBNode *node = NULL;
10415 GtkTreeView *tree_view = gtk_tree_selection_get_tree_view (selection);
10416 GtkTreeViewColumn *column =
10417 gtk_tree_view_get_column (tree_view, tree_view->priv->search_column);
10419 path = gtk_tree_model_get_path (model, iter);
10420 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
10424 if (! tree_view->priv->search_equal_func (model, tree_view->priv->search_column, text, iter, tree_view->priv->search_user_data))
10429 gtk_tree_view_scroll_to_cell (tree_view, path, column,
10431 gtk_tree_selection_select_iter (selection, iter);
10432 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
10435 gtk_tree_path_free (path);
10441 if (node->children)
10443 gboolean has_child;
10446 tree = node->children;
10449 while (node->left != tree->nil)
10453 has_child = gtk_tree_model_iter_children (model, iter, &tmp);
10454 gtk_tree_path_down (path);
10457 TREE_VIEW_INTERNAL_ASSERT (has_child, FALSE);
10461 gboolean done = FALSE;
10465 node = _gtk_rbtree_next (tree, node);
10471 has_next = gtk_tree_model_iter_next (model, iter);
10474 gtk_tree_path_next (path);
10477 TREE_VIEW_INTERNAL_ASSERT (has_next, FALSE);
10481 gboolean has_parent;
10482 GtkTreeIter tmp_iter = *iter;
10484 node = tree->parent_node;
10485 tree = tree->parent_tree;
10490 gtk_tree_path_free (path);
10492 /* we've run out of tree, done with this func */
10496 has_parent = gtk_tree_model_iter_parent (model,
10499 gtk_tree_path_up (path);
10502 TREE_VIEW_INTERNAL_ASSERT (has_parent, FALSE);
10511 gtk_tree_path_free (path);
10517 gtk_tree_view_search_init (GtkWidget *entry,
10518 GtkTreeView *tree_view)
10521 gint *selected_iter;
10527 GtkTreeModel *model;
10528 GtkTreeSelection *selection;
10530 g_return_if_fail (GTK_IS_ENTRY (entry));
10531 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10533 window = gtk_widget_get_parent (entry);
10534 text = gtk_entry_get_text (GTK_ENTRY (entry));
10535 len = strlen (text);
10536 model = gtk_tree_view_get_model (tree_view);
10537 selection = gtk_tree_view_get_selection (tree_view);
10540 gtk_tree_selection_unselect_all (selection);
10541 selected_iter = g_object_get_data (G_OBJECT (window), "gtk-tree-view-selected-iter");
10543 g_free (selected_iter);
10544 g_object_set_data (G_OBJECT (window), "gtk-tree-view-selected-iter", NULL);
10549 gtk_tree_model_get_iter_first (model, &iter);
10551 ret = gtk_tree_view_search_iter (model, selection,
10557 selected_iter = g_malloc (sizeof (int));
10558 *selected_iter = 1;
10559 g_object_set_data (G_OBJECT (window), "gtk-tree-view-selected-iter",
10565 gtk_tree_view_remove_widget (GtkCellEditable *cell_editable,
10566 GtkTreeView *tree_view)
10568 if (tree_view->priv->edited_column == NULL)
10571 _gtk_tree_view_column_stop_editing (tree_view->priv->edited_column);
10572 tree_view->priv->edited_column = NULL;
10574 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
10576 gtk_container_remove (GTK_CONTAINER (tree_view),
10577 GTK_WIDGET (cell_editable));
10581 gtk_tree_view_start_editing (GtkTreeView *tree_view,
10582 GtkTreePath *cursor_path)
10585 GdkRectangle background_area;
10586 GdkRectangle cell_area;
10587 GtkCellEditable *editable_widget = NULL;
10588 gchar *path_string;
10589 guint flags = 0; /* can be 0, as the flags are primarily for rendering */
10590 gint retval = FALSE;
10591 GtkRBTree *cursor_tree;
10592 GtkRBNode *cursor_node;
10594 g_assert (tree_view->priv->focus_column);
10596 if (! GTK_WIDGET_REALIZED (tree_view))
10599 if (_gtk_tree_view_find_node (tree_view, cursor_path, &cursor_tree, &cursor_node) ||
10600 cursor_node == NULL)
10603 path_string = gtk_tree_path_to_string (cursor_path);
10604 gtk_tree_model_get_iter (tree_view->priv->model, &iter, cursor_path);
10606 validate_row (tree_view, cursor_tree, cursor_node, &iter, cursor_path);
10608 gtk_tree_view_column_cell_set_cell_data (tree_view->priv->focus_column,
10609 tree_view->priv->model,
10611 GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_PARENT),
10612 cursor_node->children?TRUE:FALSE);
10613 gtk_tree_view_get_background_area (tree_view,
10615 tree_view->priv->focus_column,
10617 gtk_tree_view_get_cell_area (tree_view,
10619 tree_view->priv->focus_column,
10621 if (_gtk_tree_view_column_cell_event (tree_view->priv->focus_column,
10630 if (editable_widget != NULL)
10632 gtk_tree_view_real_start_editing (tree_view,
10633 tree_view->priv->focus_column,
10642 g_free (path_string);
10647 gtk_tree_view_real_start_editing (GtkTreeView *tree_view,
10648 GtkTreeViewColumn *column,
10650 GtkCellEditable *cell_editable,
10651 GdkRectangle *cell_area,
10655 gint pre_val = tree_view->priv->vadjustment->value;
10657 tree_view->priv->edited_column = column;
10658 _gtk_tree_view_column_start_editing (column, GTK_CELL_EDITABLE (cell_editable));
10660 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
10662 cell_area->y += pre_val - tree_view->priv->vadjustment->value;
10664 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
10665 gtk_tree_view_put (tree_view,
10666 GTK_WIDGET (cell_editable),
10667 cell_area->x, cell_area->y, cell_area->width, cell_area->height);
10668 gtk_cell_editable_start_editing (GTK_CELL_EDITABLE (cell_editable),
10669 (GdkEvent *)event);
10670 gtk_widget_grab_focus (GTK_WIDGET (cell_editable));
10671 g_signal_connect (cell_editable, "remove_widget", G_CALLBACK (gtk_tree_view_remove_widget), tree_view);
10675 gtk_tree_view_stop_editing (GtkTreeView *tree_view,
10676 gboolean cancel_editing)
10678 GtkTreeViewColumn *column;
10680 if (tree_view->priv->edited_column == NULL)
10684 * This is very evil. We need to do this, because
10685 * gtk_cell_editable_editing_done may trigger gtk_tree_view_row_changed
10686 * later on. If gtk_tree_view_row_changed notices
10687 * tree_view->priv->edited_column != NULL, it'll call
10688 * gtk_tree_view_stop_editing again. Bad things will happen then.
10690 * Please read that again if you intend to modify anything here.
10693 column = tree_view->priv->edited_column;
10694 tree_view->priv->edited_column = NULL;
10696 if (! cancel_editing)
10697 gtk_cell_editable_editing_done (column->editable_widget);
10699 tree_view->priv->edited_column = column;
10701 gtk_cell_editable_remove_widget (column->editable_widget);