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"
40 #include <gdk/gdkkeysyms.h>
42 #define GTK_TREE_VIEW_SEARCH_DIALOG_KEY "gtk-tree-view-search-dialog"
44 #define SCROLL_EDGE_SIZE 15
45 #define EXPANDER_EXTRA_PADDING 4
47 /* The "background" areas of all rows/cells add up to cover the entire tree.
48 * The background includes all inter-row and inter-cell spacing.
49 * The "cell" areas are the cell_area passed in to gtk_cell_renderer_render(),
50 * i.e. just the cells, no spacing.
53 #define BACKGROUND_HEIGHT(node) (GTK_RBNODE_GET_HEIGHT (node))
54 #define CELL_HEIGHT(node, separator) (BACKGROUND_HEIGHT (node) - separator);
56 #define TREE_WINDOW_Y_TO_RBTREE_Y(tree_view,y) ((y) - TREE_VIEW_HEADER_HEIGHT (tree_view) + tree_view->priv->dy)
57 #define RBTREE_Y_TO_TREE_WINDOW_Y(tree_view,y) ((y) + TREE_VIEW_HEADER_HEIGHT (tree_view) - tree_view->priv->dy)
59 /* This is in Window coordinates */
60 #define BACKGROUND_FIRST_PIXEL(tree_view,tree,node) (RBTREE_Y_TO_TREE_WINDOW_Y (tree_view, _gtk_rbtree_node_find_offset ((tree), (node))))
61 #define CELL_FIRST_PIXEL(tree_view,tree,node,separator) (BACKGROUND_FIRST_PIXEL (tree_view,tree,node) + separator/2)
64 typedef struct _GtkTreeViewChild GtkTreeViewChild;
65 struct _GtkTreeViewChild
75 typedef struct _TreeViewDragInfo TreeViewDragInfo;
76 struct _TreeViewDragInfo
78 GdkModifierType start_button_mask;
79 GtkTargetList *source_target_list;
80 GdkDragAction source_actions;
82 GtkTargetList *dest_target_list;
103 EXPAND_COLLAPSE_CURSOR_ROW,
104 SELECT_CURSOR_PARENT,
105 START_INTERACTIVE_SEARCH,
115 PROP_HEADERS_VISIBLE,
116 PROP_HEADERS_CLICKABLE,
117 PROP_EXPANDER_COLUMN,
124 static void gtk_tree_view_class_init (GtkTreeViewClass *klass);
125 static void gtk_tree_view_init (GtkTreeView *tree_view);
128 static void gtk_tree_view_finalize (GObject *object);
129 static void gtk_tree_view_set_property (GObject *object,
133 static void gtk_tree_view_get_property (GObject *object,
138 /* gtkobject signals */
139 static void gtk_tree_view_destroy (GtkObject *object);
141 /* gtkwidget signals */
142 static void gtk_tree_view_realize (GtkWidget *widget);
143 static void gtk_tree_view_unrealize (GtkWidget *widget);
144 static void gtk_tree_view_map (GtkWidget *widget);
145 static void gtk_tree_view_size_request (GtkWidget *widget,
146 GtkRequisition *requisition);
147 static void gtk_tree_view_size_allocate (GtkWidget *widget,
148 GtkAllocation *allocation);
149 static gboolean gtk_tree_view_expose (GtkWidget *widget,
150 GdkEventExpose *event);
151 static gboolean gtk_tree_view_key_press (GtkWidget *widget,
153 static gboolean gtk_tree_view_motion (GtkWidget *widget,
154 GdkEventMotion *event);
155 static gboolean gtk_tree_view_enter_notify (GtkWidget *widget,
156 GdkEventCrossing *event);
157 static gboolean gtk_tree_view_leave_notify (GtkWidget *widget,
158 GdkEventCrossing *event);
159 static gboolean gtk_tree_view_button_press (GtkWidget *widget,
160 GdkEventButton *event);
161 static gboolean gtk_tree_view_button_release (GtkWidget *widget,
162 GdkEventButton *event);
163 static void gtk_tree_view_set_focus_child (GtkContainer *container,
165 static gint gtk_tree_view_focus_in (GtkWidget *widget,
166 GdkEventFocus *event);
167 static gint gtk_tree_view_focus_out (GtkWidget *widget,
168 GdkEventFocus *event);
169 static gint gtk_tree_view_focus (GtkWidget *widget,
170 GtkDirectionType direction);
172 /* container signals */
173 static void gtk_tree_view_remove (GtkContainer *container,
175 static void gtk_tree_view_forall (GtkContainer *container,
176 gboolean include_internals,
177 GtkCallback callback,
178 gpointer callback_data);
180 /* Source side drag signals */
181 static void gtk_tree_view_drag_begin (GtkWidget *widget,
182 GdkDragContext *context);
183 static void gtk_tree_view_drag_end (GtkWidget *widget,
184 GdkDragContext *context);
185 static void gtk_tree_view_drag_data_get (GtkWidget *widget,
186 GdkDragContext *context,
187 GtkSelectionData *selection_data,
190 static void gtk_tree_view_drag_data_delete (GtkWidget *widget,
191 GdkDragContext *context);
193 /* Target side drag signals */
194 static void gtk_tree_view_drag_leave (GtkWidget *widget,
195 GdkDragContext *context,
197 static gboolean gtk_tree_view_drag_motion (GtkWidget *widget,
198 GdkDragContext *context,
202 static gboolean gtk_tree_view_drag_drop (GtkWidget *widget,
203 GdkDragContext *context,
207 static void gtk_tree_view_drag_data_received (GtkWidget *widget,
208 GdkDragContext *context,
211 GtkSelectionData *selection_data,
215 /* tree_model signals */
216 static void gtk_tree_view_set_adjustments (GtkTreeView *tree_view,
218 GtkAdjustment *vadj);
219 static void gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
220 GtkMovementStep step,
222 static void gtk_tree_view_real_select_all (GtkTreeView *tree_view);
223 static void gtk_tree_view_real_select_cursor_row (GtkTreeView *tree_view,
224 gboolean start_editing);
225 static void gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view);
226 static void gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
230 static void gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view);
231 static void gtk_tree_view_row_changed (GtkTreeModel *model,
235 static void gtk_tree_view_row_inserted (GtkTreeModel *model,
239 static void gtk_tree_view_row_has_child_toggled (GtkTreeModel *model,
243 static void gtk_tree_view_row_deleted (GtkTreeModel *model,
246 static void gtk_tree_view_rows_reordered (GtkTreeModel *model,
254 /* Internal functions */
255 static gboolean gtk_tree_view_is_expander_column (GtkTreeView *tree_view,
256 GtkTreeViewColumn *column);
257 static void gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
260 GtkMovementStep step,
262 static gint gtk_tree_view_unref_and_check_selection_tree (GtkTreeView *tree_view,
264 static void gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
267 GdkRectangle *clip_rect);
268 static void gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
270 GdkRectangle *clip_rect);
271 static void gtk_tree_view_queue_draw_arrow (GtkTreeView *tree_view,
274 GdkRectangle *clip_rect);
275 static void gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
280 static void gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
284 static gint gtk_tree_view_new_column_width (GtkTreeView *tree_view,
287 static void gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
288 GtkTreeView *tree_view);
289 static gint gtk_tree_view_insert_iter_height (GtkTreeView *tree_view,
293 static void gtk_tree_view_build_tree (GtkTreeView *tree_view,
298 gboolean calc_bounds);
299 static void gtk_tree_view_calc_size (GtkTreeView *priv,
303 static gboolean gtk_tree_view_discover_dirty_iter (GtkTreeView *tree_view,
308 static void gtk_tree_view_discover_dirty (GtkTreeView *tree_view,
312 static void gtk_tree_view_check_dirty_and_clean (GtkTreeView *tree_view);
313 static void gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
316 static void gtk_tree_view_clamp_column_visible (GtkTreeView *tree_view,
317 GtkTreeViewColumn *column);
318 static gboolean gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
319 GdkEventMotion *event);
320 static void _gtk_tree_view_update_col_width (GtkTreeView *tree_view);
321 static void gtk_tree_view_focus_to_cursor (GtkTreeView *tree_view);
322 static void gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
324 static void gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
326 static void gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
328 static void gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
330 static gboolean gtk_tree_view_real_collapse_row (GtkTreeView *tree_view,
335 static gboolean gtk_tree_view_real_expand_row (GtkTreeView *tree_view,
341 static void gtk_tree_view_real_set_cursor (GtkTreeView *tree_view,
343 gboolean clear_and_select);
345 /* interactive search */
346 static void gtk_tree_view_search_dialog_destroy (GtkWidget *search_dialog,
347 GtkTreeView *tree_view);
348 static void gtk_tree_view_search_position_func (GtkTreeView *tree_view,
349 GtkWidget *search_dialog);
350 static gboolean gtk_tree_view_search_delete_event (GtkWidget *widget,
352 GtkTreeView *tree_view);
353 static gboolean gtk_tree_view_search_button_press_event (GtkWidget *widget,
354 GdkEventButton *event,
355 GtkTreeView *tree_view);
356 static gboolean gtk_tree_view_search_key_press_event (GtkWidget *entry,
358 GtkTreeView *tree_view);
359 static void gtk_tree_view_search_move (GtkWidget *window,
360 GtkTreeView *tree_view,
362 static gboolean gtk_tree_view_search_equal_func (GtkTreeModel *model,
366 gpointer search_data);
367 static gboolean gtk_tree_view_search_iter (GtkTreeModel *model,
368 GtkTreeSelection *selection,
373 static void gtk_tree_view_search_init (GtkWidget *entry,
374 GtkTreeView *tree_view);
375 static void gtk_tree_view_put (GtkTreeView *tree_view,
376 GtkWidget *child_widget,
381 static gboolean gtk_tree_view_start_editing (GtkTreeView *tree_view,
382 GtkTreePath *cursor_path);
383 static void gtk_tree_view_real_start_editing (GtkTreeView *tree_view,
384 GtkTreeViewColumn *column,
386 GtkCellEditable *cell_editable,
387 GdkRectangle *cell_area,
390 static void gtk_tree_view_stop_editing (GtkTreeView *tree_view);
391 static void gtk_tree_view_real_start_interactive_search (GtkTreeView *tree_view);
394 static GtkContainerClass *parent_class = NULL;
395 static guint tree_view_signals [LAST_SIGNAL] = { 0 };
403 gtk_tree_view_get_type (void)
405 static GtkType tree_view_type = 0;
409 static const GTypeInfo tree_view_info =
411 sizeof (GtkTreeViewClass),
412 NULL, /* base_init */
413 NULL, /* base_finalize */
414 (GClassInitFunc) gtk_tree_view_class_init,
415 NULL, /* class_finalize */
416 NULL, /* class_data */
417 sizeof (GtkTreeView),
419 (GInstanceInitFunc) gtk_tree_view_init
422 tree_view_type = g_type_register_static (GTK_TYPE_CONTAINER, "GtkTreeView", &tree_view_info, 0);
425 return tree_view_type;
429 gtk_tree_view_class_init (GtkTreeViewClass *class)
431 GObjectClass *o_class;
432 GtkObjectClass *object_class;
433 GtkWidgetClass *widget_class;
434 GtkContainerClass *container_class;
435 GtkBindingSet *binding_set;
437 parent_class = g_type_class_peek_parent (class);
438 binding_set = gtk_binding_set_by_class (class);
440 o_class = (GObjectClass *) class;
441 object_class = (GtkObjectClass *) class;
442 widget_class = (GtkWidgetClass *) class;
443 container_class = (GtkContainerClass *) class;
445 /* GObject signals */
446 o_class->set_property = gtk_tree_view_set_property;
447 o_class->get_property = gtk_tree_view_get_property;
448 o_class->finalize = gtk_tree_view_finalize;
450 /* GtkObject signals */
451 object_class->destroy = gtk_tree_view_destroy;
453 /* GtkWidget signals */
454 widget_class->map = gtk_tree_view_map;
455 widget_class->realize = gtk_tree_view_realize;
456 widget_class->unrealize = gtk_tree_view_unrealize;
457 widget_class->size_request = gtk_tree_view_size_request;
458 widget_class->size_allocate = gtk_tree_view_size_allocate;
459 widget_class->button_press_event = gtk_tree_view_button_press;
460 widget_class->button_release_event = gtk_tree_view_button_release;
461 widget_class->motion_notify_event = gtk_tree_view_motion;
462 widget_class->expose_event = gtk_tree_view_expose;
463 widget_class->key_press_event = gtk_tree_view_key_press;
464 widget_class->enter_notify_event = gtk_tree_view_enter_notify;
465 widget_class->leave_notify_event = gtk_tree_view_leave_notify;
466 widget_class->focus_in_event = gtk_tree_view_focus_in;
467 widget_class->focus_out_event = gtk_tree_view_focus_out;
468 widget_class->drag_begin = gtk_tree_view_drag_begin;
469 widget_class->drag_end = gtk_tree_view_drag_end;
470 widget_class->drag_data_get = gtk_tree_view_drag_data_get;
471 widget_class->drag_data_delete = gtk_tree_view_drag_data_delete;
472 widget_class->drag_leave = gtk_tree_view_drag_leave;
473 widget_class->drag_motion = gtk_tree_view_drag_motion;
474 widget_class->drag_drop = gtk_tree_view_drag_drop;
475 widget_class->drag_data_received = gtk_tree_view_drag_data_received;
476 widget_class->focus = gtk_tree_view_focus;
478 /* GtkContainer signals */
479 container_class->remove = gtk_tree_view_remove;
480 container_class->forall = gtk_tree_view_forall;
481 container_class->set_focus_child = gtk_tree_view_set_focus_child;
483 class->set_scroll_adjustments = gtk_tree_view_set_adjustments;
484 class->move_cursor = gtk_tree_view_real_move_cursor;
485 class->select_all = gtk_tree_view_real_select_all;
486 class->select_cursor_row = gtk_tree_view_real_select_cursor_row;
487 class->toggle_cursor_row = gtk_tree_view_real_toggle_cursor_row;
488 class->expand_collapse_cursor_row = gtk_tree_view_real_expand_collapse_cursor_row;
489 class->select_cursor_parent = gtk_tree_view_real_select_cursor_parent;
490 class->start_interactive_search = gtk_tree_view_real_start_interactive_search;
494 g_object_class_install_property (o_class,
496 g_param_spec_object ("model",
498 _("The model for the tree view"),
502 g_object_class_install_property (o_class,
504 g_param_spec_object ("hadjustment",
505 _("Horizontal Adjustment"),
506 _("Horizontal Adjustment for the widget"),
510 g_object_class_install_property (o_class,
512 g_param_spec_object ("vadjustment",
513 _("Vertical Adjustment"),
514 _("Vertical Adjustment for the widget"),
518 g_object_class_install_property (o_class,
519 PROP_HEADERS_VISIBLE,
520 g_param_spec_boolean ("headers_visible",
522 _("Show the column header buttons"),
526 g_object_class_install_property (o_class,
527 PROP_HEADERS_CLICKABLE,
528 g_param_spec_boolean ("headers_clickable",
529 _("Headers Clickable"),
530 _("Column headers respond to click events"),
534 g_object_class_install_property (o_class,
535 PROP_EXPANDER_COLUMN,
536 g_param_spec_object ("expander_column",
537 _("Expander Column"),
538 _("Set the column for the expander column"),
539 GTK_TYPE_TREE_VIEW_COLUMN,
542 g_object_class_install_property (o_class,
544 g_param_spec_boolean ("reorderable",
546 _("View is reorderable"),
550 g_object_class_install_property (o_class,
552 g_param_spec_boolean ("rules_hint",
554 _("Set a hint to the theme engine to draw rows in alternating colors"),
558 g_object_class_install_property (o_class,
560 g_param_spec_boolean ("enable_search",
562 _("View allows user to search through columns interactively"),
566 g_object_class_install_property (o_class,
568 g_param_spec_int ("search_column",
570 _("Model column to search through when searching through code"),
576 /* Style properties */
577 #define _TREE_VIEW_EXPANDER_SIZE 10
578 #define _TREE_VIEW_VERTICAL_SEPARATOR 2
579 #define _TREE_VIEW_HORIZONTAL_SEPARATOR 2
581 gtk_widget_class_install_style_property (widget_class,
582 g_param_spec_int ("expander_size",
584 _("Size of the expander arrow."),
587 _TREE_VIEW_EXPANDER_SIZE,
590 gtk_widget_class_install_style_property (widget_class,
591 g_param_spec_int ("vertical_separator",
592 _("Vertical Separator Width"),
593 _("Vertical space between cells. Must be an even number."),
596 _TREE_VIEW_VERTICAL_SEPARATOR,
599 gtk_widget_class_install_style_property (widget_class,
600 g_param_spec_int ("horizontal_separator",
601 _("Horizontal Separator Width"),
602 _("Horizontal space between cells. Must be an even number."),
605 _TREE_VIEW_HORIZONTAL_SEPARATOR,
608 gtk_widget_class_install_style_property (widget_class,
609 g_param_spec_boolean ("allow_rules",
611 _("Allow drawing of alternating color rows."),
615 gtk_widget_class_install_style_property (widget_class,
616 g_param_spec_boolean ("indent_expanders",
617 _("Indent Expanders"),
618 _("Make the expanders indented."),
622 widget_class->set_scroll_adjustments_signal =
623 gtk_signal_new ("set_scroll_adjustments",
625 GTK_CLASS_TYPE (object_class),
626 GTK_SIGNAL_OFFSET (GtkTreeViewClass, set_scroll_adjustments),
627 _gtk_marshal_VOID__OBJECT_OBJECT,
629 GTK_TYPE_ADJUSTMENT, GTK_TYPE_ADJUSTMENT);
631 tree_view_signals[ROW_ACTIVATED] =
632 gtk_signal_new ("row_activated",
633 GTK_RUN_LAST | GTK_RUN_ACTION,
634 GTK_CLASS_TYPE (object_class),
635 GTK_SIGNAL_OFFSET (GtkTreeViewClass, row_activated),
636 _gtk_marshal_VOID__BOXED_OBJECT,
639 GTK_TYPE_TREE_VIEW_COLUMN);
641 tree_view_signals[TEST_EXPAND_ROW] =
642 g_signal_new ("test_expand_row",
643 G_TYPE_FROM_CLASS (object_class),
645 G_STRUCT_OFFSET (GtkTreeViewClass, test_expand_row),
646 _gtk_boolean_handled_accumulator, NULL,
647 _gtk_marshal_BOOLEAN__BOXED_BOXED,
652 tree_view_signals[TEST_COLLAPSE_ROW] =
653 g_signal_new ("test_collapse_row",
654 G_TYPE_FROM_CLASS (object_class),
656 G_STRUCT_OFFSET (GtkTreeViewClass, test_collapse_row),
657 _gtk_boolean_handled_accumulator, NULL,
658 _gtk_marshal_BOOLEAN__BOXED_BOXED,
663 tree_view_signals[ROW_EXPANDED] =
664 g_signal_new ("row_expanded",
665 G_TYPE_FROM_CLASS (object_class),
667 G_STRUCT_OFFSET (GtkTreeViewClass, row_expanded),
669 _gtk_marshal_VOID__BOXED_BOXED,
674 tree_view_signals[ROW_COLLAPSED] =
675 g_signal_new ("row_collapsed",
676 G_TYPE_FROM_CLASS (object_class),
678 G_STRUCT_OFFSET (GtkTreeViewClass, row_collapsed),
680 _gtk_marshal_VOID__BOXED_BOXED,
685 tree_view_signals[COLUMNS_CHANGED] =
686 g_signal_new ("columns_changed",
687 G_TYPE_FROM_CLASS (object_class),
689 G_STRUCT_OFFSET (GtkTreeViewClass, columns_changed),
691 _gtk_marshal_NONE__NONE,
694 tree_view_signals[CURSOR_CHANGED] =
695 g_signal_new ("cursor_changed",
696 G_TYPE_FROM_CLASS (object_class),
698 G_STRUCT_OFFSET (GtkTreeViewClass, cursor_changed),
700 _gtk_marshal_NONE__NONE,
703 tree_view_signals[MOVE_CURSOR] =
704 g_signal_new ("move_cursor",
705 G_TYPE_FROM_CLASS (object_class),
706 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
707 G_STRUCT_OFFSET (GtkTreeViewClass, move_cursor),
709 _gtk_marshal_VOID__ENUM_INT,
710 GTK_TYPE_NONE, 2, GTK_TYPE_MOVEMENT_STEP, GTK_TYPE_INT);
712 tree_view_signals[SELECT_ALL] =
713 g_signal_new ("select_all",
714 G_TYPE_FROM_CLASS (object_class),
715 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
716 G_STRUCT_OFFSET (GtkTreeViewClass, select_all),
718 _gtk_marshal_NONE__NONE,
721 tree_view_signals[SELECT_CURSOR_ROW] =
722 g_signal_new ("select_cursor_row",
723 G_TYPE_FROM_CLASS (object_class),
724 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
725 G_STRUCT_OFFSET (GtkTreeViewClass, select_cursor_row),
727 _gtk_marshal_VOID__BOOLEAN,
731 tree_view_signals[TOGGLE_CURSOR_ROW] =
732 g_signal_new ("toggle_cursor_row",
733 G_TYPE_FROM_CLASS (object_class),
734 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
735 G_STRUCT_OFFSET (GtkTreeViewClass, toggle_cursor_row),
737 _gtk_marshal_NONE__NONE,
740 tree_view_signals[EXPAND_COLLAPSE_CURSOR_ROW] =
741 g_signal_new ("expand_collapse_cursor_row",
742 G_TYPE_FROM_CLASS (object_class),
743 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
744 G_STRUCT_OFFSET (GtkTreeViewClass, expand_collapse_cursor_row),
746 _gtk_marshal_VOID__BOOLEAN_BOOLEAN_BOOLEAN,
747 GTK_TYPE_NONE, 3, GTK_TYPE_BOOL, GTK_TYPE_BOOL, GTK_TYPE_BOOL);
749 tree_view_signals[SELECT_CURSOR_PARENT] =
750 g_signal_new ("select_cursor_parent",
751 G_TYPE_FROM_CLASS (object_class),
752 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
753 G_STRUCT_OFFSET (GtkTreeViewClass, select_cursor_parent),
755 _gtk_marshal_NONE__NONE,
758 tree_view_signals[START_INTERACTIVE_SEARCH] =
759 g_signal_new ("start_interactive_search",
760 G_TYPE_FROM_CLASS (object_class),
761 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
762 G_STRUCT_OFFSET (GtkTreeViewClass, start_interactive_search),
764 _gtk_marshal_NONE__NONE,
768 gtk_tree_view_add_move_binding (binding_set, GDK_Up, 0,
769 GTK_MOVEMENT_DISPLAY_LINES, -1);
771 gtk_tree_view_add_move_binding (binding_set, GDK_Down, 0,
772 GTK_MOVEMENT_DISPLAY_LINES, 1);
774 gtk_tree_view_add_move_binding (binding_set, GDK_p, GDK_CONTROL_MASK,
775 GTK_MOVEMENT_DISPLAY_LINES, -1);
777 gtk_tree_view_add_move_binding (binding_set, GDK_n, GDK_CONTROL_MASK,
778 GTK_MOVEMENT_DISPLAY_LINES, 1);
780 gtk_tree_view_add_move_binding (binding_set, GDK_Home, 0,
781 GTK_MOVEMENT_BUFFER_ENDS, -1);
783 gtk_tree_view_add_move_binding (binding_set, GDK_End, 0,
784 GTK_MOVEMENT_BUFFER_ENDS, 1);
786 gtk_tree_view_add_move_binding (binding_set, GDK_Page_Up, 0,
787 GTK_MOVEMENT_PAGES, -1);
789 gtk_tree_view_add_move_binding (binding_set, GDK_Page_Down, 0,
790 GTK_MOVEMENT_PAGES, 1);
792 gtk_binding_entry_add_signal (binding_set, GDK_Right, 0, "move_cursor", 2,
793 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
796 gtk_binding_entry_add_signal (binding_set, GDK_Left, 0, "move_cursor", 2,
797 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
800 gtk_binding_entry_add_signal (binding_set, GDK_Right, GDK_CONTROL_MASK, "move_cursor", 2,
801 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
804 gtk_binding_entry_add_signal (binding_set, GDK_Left, GDK_CONTROL_MASK, "move_cursor", 2,
805 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
808 gtk_binding_entry_add_signal (binding_set, GDK_Right, GDK_CONTROL_MASK|GDK_SHIFT_MASK, "move_cursor", 2,
809 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
812 gtk_binding_entry_add_signal (binding_set, GDK_Left, GDK_CONTROL_MASK|GDK_SHIFT_MASK, "move_cursor", 2,
813 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
816 gtk_binding_entry_add_signal (binding_set, GDK_f, GDK_CONTROL_MASK, "move_cursor", 2,
817 GTK_TYPE_ENUM, GTK_MOVEMENT_LOGICAL_POSITIONS,
820 gtk_binding_entry_add_signal (binding_set, GDK_b, GDK_CONTROL_MASK, "move_cursor", 2,
821 GTK_TYPE_ENUM, GTK_MOVEMENT_LOGICAL_POSITIONS,
824 gtk_binding_entry_add_signal (binding_set, GDK_space, GDK_CONTROL_MASK, "toggle_cursor_row", 0);
826 gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_CONTROL_MASK, "select_all", 0);
828 gtk_binding_entry_add_signal (binding_set, GDK_space, GDK_SHIFT_MASK, "select_cursor_row", 1,
829 GTK_TYPE_BOOL, TRUE);
831 gtk_binding_entry_add_signal (binding_set, GDK_space, 0, "select_cursor_row", 1,
832 GTK_TYPE_BOOL, TRUE);
834 /* expand and collapse rows */
835 gtk_binding_entry_add_signal (binding_set, GDK_plus, 0, "expand_collapse_cursor_row", 3,
836 GTK_TYPE_BOOL, FALSE,
838 GTK_TYPE_BOOL, FALSE);
839 /* Not doable on US keyboards */
840 gtk_binding_entry_add_signal (binding_set, GDK_plus, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
841 GTK_TYPE_BOOL, FALSE,
843 GTK_TYPE_BOOL, TRUE);
844 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, 0, "expand_collapse_cursor_row", 3,
845 GTK_TYPE_BOOL, FALSE,
847 GTK_TYPE_BOOL, FALSE);
848 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
849 GTK_TYPE_BOOL, FALSE,
851 GTK_TYPE_BOOL, TRUE);
852 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
853 GTK_TYPE_BOOL, FALSE,
855 GTK_TYPE_BOOL, TRUE);
856 gtk_binding_entry_add_signal (binding_set, GDK_Right, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
859 GTK_TYPE_BOOL, TRUE);
861 gtk_binding_entry_add_signal (binding_set, GDK_minus, 0, "expand_collapse_cursor_row", 3,
862 GTK_TYPE_BOOL, FALSE,
863 GTK_TYPE_BOOL, FALSE,
864 GTK_TYPE_BOOL, FALSE);
865 gtk_binding_entry_add_signal (binding_set, GDK_minus, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
866 GTK_TYPE_BOOL, FALSE,
867 GTK_TYPE_BOOL, FALSE,
868 GTK_TYPE_BOOL, TRUE);
869 gtk_binding_entry_add_signal (binding_set, GDK_KP_Subtract, 0, "expand_collapse_cursor_row", 3,
870 GTK_TYPE_BOOL, FALSE,
871 GTK_TYPE_BOOL, FALSE,
872 GTK_TYPE_BOOL, FALSE);
873 gtk_binding_entry_add_signal (binding_set, GDK_KP_Subtract, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
874 GTK_TYPE_BOOL, FALSE,
875 GTK_TYPE_BOOL, FALSE,
876 GTK_TYPE_BOOL, TRUE);
877 gtk_binding_entry_add_signal (binding_set, GDK_Left, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
878 GTK_TYPE_BOOL, FALSE,
879 GTK_TYPE_BOOL, FALSE,
880 GTK_TYPE_BOOL, TRUE);
882 gtk_binding_entry_add_signal (binding_set, GDK_BackSpace, 0, "select_cursor_parent", 0);
884 gtk_binding_entry_add_signal (binding_set, GDK_s, GDK_CONTROL_MASK, "start_interactive_search", 0);
886 gtk_binding_entry_add_signal (binding_set, GDK_S, GDK_CONTROL_MASK, "start_interactive_search", 0);
890 gtk_tree_view_init (GtkTreeView *tree_view)
892 tree_view->priv = g_new0 (GtkTreeViewPrivate, 1);
894 GTK_WIDGET_SET_FLAGS (tree_view, GTK_CAN_FOCUS);
896 tree_view->priv->flags = GTK_TREE_VIEW_IS_LIST | GTK_TREE_VIEW_SHOW_EXPANDERS | GTK_TREE_VIEW_DRAW_KEYFOCUS | GTK_TREE_VIEW_HEADERS_VISIBLE;
897 gtk_widget_style_get (GTK_WIDGET (tree_view), "expander_size", &tree_view->priv->tab_offset, NULL);
899 /* We need some padding */
900 tree_view->priv->tab_offset += EXPANDER_EXTRA_PADDING;
901 tree_view->priv->dy = 0;
902 tree_view->priv->n_columns = 0;
903 tree_view->priv->header_height = 1;
904 tree_view->priv->x_drag = 0;
905 tree_view->priv->drag_pos = -1;
906 tree_view->priv->header_has_focus = FALSE;
907 tree_view->priv->pressed_button = -1;
908 tree_view->priv->press_start_x = -1;
909 tree_view->priv->press_start_y = -1;
910 tree_view->priv->reorderable = FALSE;
911 gtk_tree_view_set_adjustments (tree_view, NULL, NULL);
912 tree_view->priv->selection = _gtk_tree_selection_new_with_tree_view (tree_view);
913 _gtk_tree_view_update_size (tree_view);
914 tree_view->priv->enable_search = TRUE;
915 tree_view->priv->search_column = -1;
916 tree_view->priv->search_dialog_position_func = gtk_tree_view_search_position_func;
917 tree_view->priv->search_equal_func = gtk_tree_view_search_equal_func;
926 gtk_tree_view_set_property (GObject *object,
931 GtkTreeView *tree_view;
933 tree_view = GTK_TREE_VIEW (object);
938 gtk_tree_view_set_model (tree_view, g_value_get_object (value));
940 case PROP_HADJUSTMENT:
941 gtk_tree_view_set_hadjustment (tree_view, g_value_get_object (value));
943 case PROP_VADJUSTMENT:
944 gtk_tree_view_set_vadjustment (tree_view, g_value_get_object (value));
946 case PROP_HEADERS_VISIBLE:
947 gtk_tree_view_set_headers_visible (tree_view, g_value_get_boolean (value));
949 case PROP_HEADERS_CLICKABLE:
950 gtk_tree_view_set_headers_clickable (tree_view, g_value_get_boolean (value));
952 case PROP_EXPANDER_COLUMN:
953 gtk_tree_view_set_expander_column (tree_view, g_value_get_object (value));
955 case PROP_REORDERABLE:
956 gtk_tree_view_set_reorderable (tree_view, g_value_get_boolean (value));
958 case PROP_RULES_HINT:
959 gtk_tree_view_set_rules_hint (tree_view, g_value_get_boolean (value));
960 case PROP_ENABLE_SEARCH:
961 gtk_tree_view_set_enable_search (tree_view, g_value_get_boolean (value));
963 case PROP_SEARCH_COLUMN:
964 gtk_tree_view_set_search_column (tree_view, g_value_get_int (value));
972 gtk_tree_view_get_property (GObject *object,
977 GtkTreeView *tree_view;
979 tree_view = GTK_TREE_VIEW (object);
984 g_value_set_object (value, tree_view->priv->model);
986 case PROP_HADJUSTMENT:
987 g_value_set_object (value, G_OBJECT (tree_view->priv->hadjustment));
989 case PROP_VADJUSTMENT:
990 g_value_set_object (value, G_OBJECT (tree_view->priv->vadjustment));
992 case PROP_HEADERS_VISIBLE:
993 g_value_set_boolean (value, gtk_tree_view_get_headers_visible (tree_view));
995 case PROP_EXPANDER_COLUMN:
996 g_value_set_object (value, tree_view->priv->expander_column);
998 case PROP_REORDERABLE:
999 g_value_set_boolean (value, tree_view->priv->reorderable);
1001 case PROP_RULES_HINT:
1002 g_value_set_boolean (value, tree_view->priv->has_rules);
1004 case PROP_ENABLE_SEARCH:
1005 g_value_set_boolean (value, tree_view->priv->enable_search);
1007 case PROP_SEARCH_COLUMN:
1008 g_value_set_int (value, tree_view->priv->search_column);
1011 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1017 gtk_tree_view_finalize (GObject *object)
1019 GtkTreeView *tree_view = (GtkTreeView *) object;
1021 g_free (tree_view->priv);
1023 if (G_OBJECT_CLASS (parent_class)->finalize)
1024 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
1029 /* GtkObject Methods
1033 gtk_tree_view_destroy (GtkObject *object)
1035 GtkTreeView *tree_view = GTK_TREE_VIEW (object);
1036 GtkWidget *search_dialog;
1039 gtk_tree_view_stop_editing (tree_view);
1041 if (tree_view->priv->columns != NULL)
1043 list = tree_view->priv->columns;
1046 GtkTreeViewColumn *column;
1047 column = GTK_TREE_VIEW_COLUMN (list->data);
1049 gtk_tree_view_remove_column (tree_view, column);
1051 tree_view->priv->columns = NULL;
1054 gtk_tree_view_set_model (tree_view, NULL);
1056 if (tree_view->priv->tree != NULL)
1058 gtk_tree_view_unref_and_check_selection_tree (tree_view, tree_view->priv->tree);
1059 _gtk_rbtree_free (tree_view->priv->tree);
1060 tree_view->priv->tree = NULL;
1063 if (tree_view->priv->model != NULL)
1065 g_object_unref (G_OBJECT (tree_view->priv->model));
1066 tree_view->priv->model = NULL;
1069 if (tree_view->priv->selection != NULL)
1071 _gtk_tree_selection_set_tree_view (tree_view->priv->selection, NULL);
1072 g_object_unref (tree_view->priv->selection);
1073 tree_view->priv->selection = NULL;
1076 if (tree_view->priv->scroll_to_path != NULL)
1078 gtk_tree_path_free (tree_view->priv->scroll_to_path);
1079 tree_view->priv->scroll_to_path = NULL;
1082 if (tree_view->priv->drag_dest_row != NULL)
1084 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
1085 tree_view->priv->drag_dest_row = NULL;
1089 if (tree_view->priv->column_drop_func_data &&
1090 tree_view->priv->column_drop_func_data_destroy)
1092 (* tree_view->priv->column_drop_func_data_destroy) (tree_view->priv->column_drop_func_data);
1093 tree_view->priv->column_drop_func_data = NULL;
1096 if (tree_view->priv->destroy_count_destroy &&
1097 tree_view->priv->destroy_count_data)
1099 (* tree_view->priv->destroy_count_destroy) (tree_view->priv->destroy_count_data);
1100 tree_view->priv->destroy_count_data = NULL;
1103 gtk_tree_row_reference_free (tree_view->priv->cursor);
1104 tree_view->priv->cursor = NULL;
1106 gtk_tree_row_reference_free (tree_view->priv->anchor);
1107 tree_view->priv->anchor = NULL;
1109 /* destroy interactive search dialog */
1110 search_dialog = gtk_object_get_data (GTK_OBJECT (tree_view),
1111 GTK_TREE_VIEW_SEARCH_DIALOG_KEY);
1113 gtk_tree_view_search_dialog_destroy (search_dialog,
1116 if (tree_view->priv->search_user_data)
1118 (* tree_view->priv->search_destroy) (tree_view->priv->search_user_data);
1119 tree_view->priv->search_user_data = NULL;
1121 if (GTK_OBJECT_CLASS (parent_class)->destroy)
1122 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
1127 /* GtkWidget Methods
1130 /* GtkWidget::map helper */
1132 gtk_tree_view_map_buttons (GtkTreeView *tree_view)
1136 g_return_if_fail (GTK_WIDGET_MAPPED (tree_view));
1138 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
1140 GtkTreeViewColumn *column;
1142 for (list = tree_view->priv->columns; list; list = list->next)
1144 column = list->data;
1145 if (GTK_WIDGET_VISIBLE (column->button) &&
1146 !GTK_WIDGET_MAPPED (column->button))
1147 gtk_widget_map (column->button);
1149 for (list = tree_view->priv->columns; list; list = list->next)
1151 column = list->data;
1152 if (column->visible == FALSE)
1154 if (column->resizable)
1156 gdk_window_raise (column->window);
1157 gdk_window_show (column->window);
1160 gdk_window_hide (column->window);
1162 gdk_window_show (tree_view->priv->header_window);
1167 gtk_tree_view_map (GtkWidget *widget)
1170 GtkTreeView *tree_view;
1172 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1174 tree_view = GTK_TREE_VIEW (widget);
1176 GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
1178 tmp_list = tree_view->priv->children;
1181 GtkTreeViewChild *child = tmp_list->data;
1182 tmp_list = tmp_list->next;
1184 if (GTK_WIDGET_VISIBLE (child->widget))
1186 if (!GTK_WIDGET_MAPPED (child->widget))
1187 gtk_widget_map (child->widget);
1190 gdk_window_show (tree_view->priv->bin_window);
1192 gtk_tree_view_map_buttons (tree_view);
1194 gdk_window_show (widget->window);
1198 gtk_tree_view_realize (GtkWidget *widget)
1201 GtkTreeView *tree_view;
1203 GdkWindowAttr attributes;
1204 gint attributes_mask;
1206 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1208 tree_view = GTK_TREE_VIEW (widget);
1210 gtk_tree_view_check_dirty_and_clean (GTK_TREE_VIEW (widget));
1211 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
1213 /* Make the main, clipping window */
1214 attributes.window_type = GDK_WINDOW_CHILD;
1215 attributes.x = widget->allocation.x;
1216 attributes.y = widget->allocation.y;
1217 attributes.width = widget->allocation.width;
1218 attributes.height = widget->allocation.height;
1219 attributes.wclass = GDK_INPUT_OUTPUT;
1220 attributes.visual = gtk_widget_get_visual (widget);
1221 attributes.colormap = gtk_widget_get_colormap (widget);
1222 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK;
1224 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
1226 widget->window = gdk_window_new (gtk_widget_get_parent_window (widget),
1227 &attributes, attributes_mask);
1228 gdk_window_set_user_data (widget->window, widget);
1230 /* Make the window for the tree */
1233 attributes.width = tree_view->priv->width;
1234 attributes.height = widget->allocation.height;
1235 attributes.event_mask = GDK_EXPOSURE_MASK |
1237 GDK_POINTER_MOTION_MASK |
1238 GDK_ENTER_NOTIFY_MASK |
1239 GDK_LEAVE_NOTIFY_MASK |
1240 GDK_BUTTON_PRESS_MASK |
1241 GDK_BUTTON_RELEASE_MASK |
1242 gtk_widget_get_events (widget);
1244 tree_view->priv->bin_window = gdk_window_new (widget->window,
1245 &attributes, attributes_mask);
1246 gdk_window_set_user_data (tree_view->priv->bin_window, widget);
1248 /* Make the column header window */
1251 attributes.width = MAX (tree_view->priv->width, widget->allocation.width);
1252 attributes.height = tree_view->priv->header_height;
1253 attributes.event_mask = (GDK_EXPOSURE_MASK |
1255 GDK_BUTTON_PRESS_MASK |
1256 GDK_BUTTON_RELEASE_MASK |
1257 GDK_KEY_PRESS_MASK |
1258 GDK_KEY_RELEASE_MASK) |
1259 gtk_widget_get_events (widget);
1261 tree_view->priv->header_window = gdk_window_new (widget->window,
1262 &attributes, attributes_mask);
1263 gdk_window_set_user_data (tree_view->priv->header_window, widget);
1266 values.foreground = (widget->style->white.pixel==0 ?
1267 widget->style->black:widget->style->white);
1268 values.function = GDK_XOR;
1269 values.subwindow_mode = GDK_INCLUDE_INFERIORS;
1270 tree_view->priv->xor_gc = gdk_gc_new_with_values (widget->window,
1275 /* Add them all up. */
1276 widget->style = gtk_style_attach (widget->style, widget->window);
1277 gdk_window_set_background (widget->window, &widget->style->base[widget->state]);
1278 gdk_window_set_background (tree_view->priv->bin_window, &widget->style->base[widget->state]);
1279 gtk_style_set_background (widget->style, tree_view->priv->header_window, GTK_STATE_NORMAL);
1281 tmp_list = tree_view->priv->children;
1284 GtkTreeViewChild *child = tmp_list->data;
1285 tmp_list = tmp_list->next;
1287 gtk_widget_set_parent_window (child->widget, tree_view->priv->bin_window);
1290 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
1291 _gtk_tree_view_column_realize_button (GTK_TREE_VIEW_COLUMN (tmp_list->data));
1293 _gtk_tree_view_update_size (GTK_TREE_VIEW (widget));
1295 if (GTK_WIDGET_CLASS (parent_class)->map)
1296 (* GTK_WIDGET_CLASS (parent_class)->map) (widget);
1300 gtk_tree_view_unrealize (GtkWidget *widget)
1302 GtkTreeView *tree_view;
1305 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1307 tree_view = GTK_TREE_VIEW (widget);
1309 if (tree_view->priv->scroll_timeout != 0)
1311 gtk_timeout_remove (tree_view->priv->scroll_timeout);
1312 tree_view->priv->scroll_timeout = 0;
1315 if (tree_view->priv->open_dest_timeout != 0)
1317 gtk_timeout_remove (tree_view->priv->open_dest_timeout);
1318 tree_view->priv->open_dest_timeout = 0;
1321 if (tree_view->priv->expand_collapse_timeout != 0)
1323 gtk_timeout_remove (tree_view->priv->expand_collapse_timeout);
1324 tree_view->priv->expand_collapse_timeout = 0;
1327 for (list = tree_view->priv->columns; list; list = list->next)
1328 _gtk_tree_view_column_unrealize_button (GTK_TREE_VIEW_COLUMN (list->data));
1330 gdk_window_set_user_data (tree_view->priv->bin_window, NULL);
1331 gdk_window_destroy (tree_view->priv->bin_window);
1332 tree_view->priv->bin_window = NULL;
1334 gdk_window_set_user_data (tree_view->priv->header_window, NULL);
1335 gdk_window_destroy (tree_view->priv->header_window);
1336 tree_view->priv->header_window = NULL;
1338 if (tree_view->priv->drag_window)
1340 gdk_window_set_user_data (tree_view->priv->drag_window, NULL);
1341 gdk_window_destroy (tree_view->priv->drag_window);
1342 tree_view->priv->drag_window = NULL;
1345 if (tree_view->priv->drag_highlight_window)
1347 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, NULL);
1348 gdk_window_destroy (tree_view->priv->drag_highlight_window);
1349 tree_view->priv->drag_highlight_window = NULL;
1352 if (tree_view->priv->xor_gc)
1354 gdk_gc_destroy (tree_view->priv->xor_gc);
1355 tree_view->priv->xor_gc = NULL;
1358 /* GtkWidget::unrealize destroys children and widget->window */
1359 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
1360 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
1363 /* GtkWidget::size_request helper */
1365 gtk_tree_view_size_request_buttons (GtkTreeView *tree_view)
1369 tree_view->priv->header_height = 1;
1371 if (tree_view->priv->model)
1373 for (list = tree_view->priv->columns; list; list = list->next)
1375 GtkRequisition requisition;
1376 GtkTreeViewColumn *column = list->data;
1378 if (column->button == NULL)
1381 column = list->data;
1383 gtk_widget_size_request (column->button, &requisition);
1385 _gtk_tree_view_column_set_width (column, MAX (column->width, requisition.width));
1386 tree_view->priv->header_height = MAX (tree_view->priv->header_height, requisition.height);
1392 gtk_tree_view_size_request (GtkWidget *widget,
1393 GtkRequisition *requisition)
1395 GtkTreeView *tree_view;
1398 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1400 tree_view = GTK_TREE_VIEW (widget);
1402 gtk_tree_view_size_request_buttons (tree_view);
1404 requisition->width = tree_view->priv->width;
1405 requisition->height = tree_view->priv->height + tree_view->priv->header_height;
1407 tmp_list = tree_view->priv->children;
1411 GtkTreeViewChild *child = tmp_list->data;
1412 GtkRequisition child_requisition;
1414 tmp_list = tmp_list->next;
1416 if (GTK_WIDGET_VISIBLE (child->widget))
1417 gtk_widget_size_request (child->widget, &child_requisition);
1421 /* GtkWidget::size_allocate helper */
1423 gtk_tree_view_size_allocate_buttons (GtkWidget *widget)
1425 GtkTreeView *tree_view;
1427 GtkTreeViewColumn *column;
1428 GtkAllocation allocation;
1431 tree_view = GTK_TREE_VIEW (widget);
1434 allocation.height = tree_view->priv->header_height;
1436 for (list = tree_view->priv->columns; list != NULL; list = list->next)
1438 column = list->data;
1440 if (!column->visible)
1443 allocation.x = width;
1444 allocation.width = column->width;
1445 width += column->width;
1446 gtk_widget_size_allocate (column->button, &allocation);
1449 gdk_window_move_resize (column->window,
1450 allocation.x + allocation.width - TREE_VIEW_DRAG_WIDTH/2,
1452 TREE_VIEW_DRAG_WIDTH, allocation.height);
1457 gtk_tree_view_size_allocate (GtkWidget *widget,
1458 GtkAllocation *allocation)
1461 GtkTreeView *tree_view;
1463 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1465 widget->allocation = *allocation;
1467 tree_view = GTK_TREE_VIEW (widget);
1469 gtk_tree_view_check_dirty_and_clean (tree_view);
1471 tmp_list = tree_view->priv->children;
1475 GtkAllocation allocation;
1477 GtkTreeViewChild *child = tmp_list->data;
1478 tmp_list = tmp_list->next;
1480 /* totally ignore our childs requisition */
1481 allocation.x = child->x;
1482 allocation.y = child->y;
1483 allocation.width = child->width;
1484 allocation.height = child->height;
1485 gtk_widget_size_allocate (child->widget, &allocation);
1488 if (GTK_WIDGET_REALIZED (widget))
1490 gdk_window_move_resize (widget->window,
1491 allocation->x, allocation->y,
1492 allocation->width, allocation->height);
1493 gdk_window_resize (tree_view->priv->header_window,
1494 MAX (tree_view->priv->width, allocation->width),
1495 tree_view->priv->header_height);
1496 gdk_window_resize (tree_view->priv->bin_window,
1497 tree_view->priv->width,
1498 allocation->height);
1499 _gtk_tree_view_update_col_width (tree_view);
1502 gtk_tree_view_size_allocate_buttons (widget);
1504 tree_view->priv->hadjustment->page_size = allocation->width;
1505 tree_view->priv->hadjustment->page_increment = allocation->width;
1506 tree_view->priv->hadjustment->step_increment = allocation->width / 10;
1507 tree_view->priv->hadjustment->lower = 0;
1508 tree_view->priv->hadjustment->upper = tree_view->priv->width;
1510 if (tree_view->priv->hadjustment->value + allocation->width > tree_view->priv->width)
1511 tree_view->priv->hadjustment->value = MAX (tree_view->priv->width - allocation->width, 0);
1512 gtk_adjustment_changed (tree_view->priv->hadjustment);
1514 tree_view->priv->vadjustment->page_size = allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view);
1515 tree_view->priv->vadjustment->step_increment = (tree_view->priv->vadjustment->page_size) / 10;
1516 tree_view->priv->vadjustment->page_increment = (allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view)) / 2;
1517 tree_view->priv->vadjustment->lower = 0;
1518 tree_view->priv->vadjustment->upper = tree_view->priv->height;
1520 if (tree_view->priv->vadjustment->value + allocation->height > tree_view->priv->height)
1521 gtk_adjustment_set_value (tree_view->priv->vadjustment,
1522 MAX (tree_view->priv->height - allocation->height, 0));
1523 gtk_adjustment_changed (tree_view->priv->vadjustment);
1525 if (tree_view->priv->scroll_to_path != NULL ||
1526 tree_view->priv->scroll_to_column != NULL)
1528 gtk_tree_view_scroll_to_cell (tree_view,
1529 tree_view->priv->scroll_to_path,
1530 tree_view->priv->scroll_to_column,
1531 tree_view->priv->scroll_to_use_align,
1532 tree_view->priv->scroll_to_row_align,
1533 tree_view->priv->scroll_to_col_align);
1534 if (tree_view->priv->scroll_to_path)
1536 gtk_tree_path_free (tree_view->priv->scroll_to_path);
1537 tree_view->priv->scroll_to_path = NULL;
1539 tree_view->priv->scroll_to_column = NULL;
1545 gtk_tree_view_button_press (GtkWidget *widget,
1546 GdkEventButton *event)
1548 GtkTreeView *tree_view;
1550 GtkTreeViewColumn *column = NULL;
1552 GdkRectangle background_area;
1553 GdkRectangle cell_area;
1554 gint vertical_separator;
1555 gint horizontal_separator;
1557 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
1558 g_return_val_if_fail (event != NULL, FALSE);
1560 tree_view = GTK_TREE_VIEW (widget);
1561 gtk_tree_view_stop_editing (tree_view);
1562 gtk_widget_style_get (widget,
1563 "vertical_separator", &vertical_separator,
1564 "horizontal_separator", &horizontal_separator,
1567 if (event->window == tree_view->priv->bin_window)
1576 GtkTreeViewColumn *column = NULL;
1577 gint column_handled_click = FALSE;
1579 if (!GTK_WIDGET_HAS_FOCUS (widget))
1580 gtk_widget_grab_focus (widget);
1581 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
1583 /* are we in an arrow? */
1584 if (tree_view->priv->prelight_node &&
1585 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
1587 if (event->button == 1)
1589 gtk_grab_add (widget);
1590 tree_view->priv->button_pressed_node = tree_view->priv->prelight_node;
1591 tree_view->priv->button_pressed_tree = tree_view->priv->prelight_tree;
1592 gtk_tree_view_draw_arrow (GTK_TREE_VIEW (widget),
1593 tree_view->priv->prelight_tree,
1594 tree_view->priv->prelight_node,
1601 /* find the node that was clicked */
1602 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
1605 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
1608 /* We clicked in dead space */
1611 /* Get the path and the node */
1612 path = _gtk_tree_view_find_path (tree_view, tree, node);
1613 depth = gtk_tree_path_get_depth (path);
1614 background_area.y = y_offset + event->y;
1615 background_area.height = GTK_RBNODE_GET_HEIGHT (node);
1616 background_area.x = 0;
1618 /* Let the column have a chance at selecting it. */
1619 for (list = tree_view->priv->columns; list; list = list->next)
1621 column = list->data;
1623 if (!column->visible)
1626 background_area.width = column->width;
1627 if ((background_area.x > (gint) event->x) ||
1628 (background_area.x + background_area.width <= (gint) event->x))
1630 background_area.x += background_area.width;
1634 /* we found the focus column */
1635 cell_area = background_area;
1636 cell_area.width -= horizontal_separator;
1637 cell_area.height -= vertical_separator;
1638 cell_area.x += horizontal_separator/2;
1639 cell_area.y += vertical_separator/2;
1640 if (gtk_tree_view_is_expander_column (tree_view, column) &&
1641 TREE_VIEW_DRAW_EXPANDERS(tree_view))
1643 cell_area.x += depth*tree_view->priv->tab_offset;
1644 cell_area.width -= depth*tree_view->priv->tab_offset;
1652 tree_view->priv->focus_column = column;
1653 if (event->state & GDK_CONTROL_MASK)
1655 gtk_tree_view_real_set_cursor (tree_view, path, FALSE);
1656 gtk_tree_view_real_toggle_cursor_row (tree_view);
1658 else if (event->state & GDK_SHIFT_MASK)
1660 gtk_tree_view_real_set_cursor (tree_view, path, FALSE);
1661 gtk_tree_view_real_select_cursor_row (tree_view, FALSE);
1665 gtk_tree_view_real_set_cursor (tree_view, path, TRUE);
1668 if (event->type == GDK_BUTTON_PRESS &&
1671 GtkCellEditable *cell_editable = NULL;
1672 /* FIXME: get the right flags */
1676 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
1677 gtk_tree_view_column_cell_set_cell_data (column,
1678 tree_view->priv->model,
1680 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
1681 node->children?TRUE:FALSE);
1683 path_string = gtk_tree_path_to_string (path);
1685 if (_gtk_tree_view_column_cell_event (column,
1692 if (cell_editable != NULL)
1694 gtk_tree_view_real_start_editing (tree_view,
1703 column_handled_click = TRUE;
1705 g_free (path_string);
1708 /* Save press to possibly begin a drag
1710 if (!column_handled_click &&
1711 tree_view->priv->pressed_button < 0)
1713 tree_view->priv->pressed_button = event->button;
1714 tree_view->priv->press_start_x = event->x;
1715 tree_view->priv->press_start_y = event->y;
1718 if (event->button == 1 && event->type == GDK_2BUTTON_PRESS)
1720 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
1722 if (node->children == NULL)
1723 gtk_tree_view_real_expand_row (tree_view, path,
1724 tree, node, FALSE, TRUE);
1726 gtk_tree_view_real_collapse_row (GTK_TREE_VIEW (widget), path,
1730 gtk_tree_view_row_activated (tree_view, path, column);
1732 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
1733 gtk_tree_path_free (path);
1737 /* We didn't click in the window. Let's check to see if we clicked on a column resize window.
1739 for (i = 0, list = tree_view->priv->columns; list; list = list->next, i++)
1741 column = list->data;
1742 if (event->window == column->window &&
1743 column->resizable &&
1748 if (gdk_pointer_grab (column->window, FALSE,
1749 GDK_POINTER_MOTION_HINT_MASK |
1750 GDK_BUTTON1_MOTION_MASK |
1751 GDK_BUTTON_RELEASE_MASK,
1752 NULL, NULL, event->time))
1755 gtk_grab_add (widget);
1756 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
1758 /* block attached dnd signal handler */
1759 drag_data = gtk_object_get_data (GTK_OBJECT (widget), "gtk-site-data");
1761 gtk_signal_handler_block_by_data (GTK_OBJECT (widget), drag_data);
1763 if (!GTK_WIDGET_HAS_FOCUS (widget))
1764 gtk_widget_grab_focus (widget);
1766 tree_view->priv->drag_pos = i;
1767 tree_view->priv->x_drag = (column->button->allocation.x + column->button->allocation.width);
1773 /* GtkWidget::button_release_event helper */
1775 gtk_tree_view_button_release_drag_column (GtkWidget *widget,
1776 GdkEventButton *event)
1778 GtkTreeView *tree_view;
1779 GtkAllocation allocation;
1781 tree_view = GTK_TREE_VIEW (widget);
1783 allocation = tree_view->priv->drag_column->button->allocation;
1784 allocation.x = tree_view->priv->drag_column_x;
1785 gdk_pointer_ungrab (GDK_CURRENT_TIME);
1786 gdk_keyboard_ungrab (GDK_CURRENT_TIME);
1787 gdk_window_reparent (tree_view->priv->drag_column->button->window,
1788 tree_view->priv->header_window,
1789 tree_view->priv->drag_column_x,
1790 tree_view->priv->drag_column->button->allocation.y);
1791 gtk_widget_set_parent_window (tree_view->priv->drag_column->button, tree_view->priv->header_window);
1793 gtk_widget_size_allocate (tree_view->priv->drag_column->button, &allocation);
1794 gtk_widget_grab_focus (tree_view->priv->drag_column->button);
1796 if (tree_view->priv->cur_reorder &&
1797 tree_view->priv->cur_reorder->left_column != tree_view->priv->drag_column)
1798 gtk_tree_view_move_column_after (tree_view, tree_view->priv->drag_column,
1799 tree_view->priv->cur_reorder->left_column);
1800 tree_view->priv->drag_column = NULL;
1801 gdk_window_hide (tree_view->priv->drag_window);
1803 g_list_foreach (tree_view->priv->column_drag_info, (GFunc) g_free, NULL);
1804 g_list_free (tree_view->priv->column_drag_info);
1805 tree_view->priv->column_drag_info = NULL;
1807 gdk_window_hide (tree_view->priv->drag_highlight_window);
1809 /* Reset our flags */
1810 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_UNSET;
1811 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
1816 /* GtkWidget::button_release_event helper */
1818 gtk_tree_view_button_release_column_resize (GtkWidget *widget,
1819 GdkEventButton *event)
1821 GtkTreeView *tree_view;
1827 tree_view = GTK_TREE_VIEW (widget);
1829 i = tree_view->priv->drag_pos;
1830 tree_view->priv->drag_pos = -1;
1832 /* unblock attached dnd signal handler */
1833 drag_data = gtk_object_get_data (GTK_OBJECT (widget), "gtk-site-data");
1835 gtk_signal_handler_unblock_by_data (GTK_OBJECT (widget), drag_data);
1837 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
1838 gtk_widget_get_pointer (widget, &x, NULL);
1839 gtk_grab_remove (widget);
1840 gdk_pointer_ungrab (event->time);
1842 width = gtk_tree_view_new_column_width (GTK_TREE_VIEW (widget), i, &x);
1843 _gtk_tree_view_column_set_width (gtk_tree_view_get_column (GTK_TREE_VIEW (widget), i), width);
1849 gtk_tree_view_button_release (GtkWidget *widget,
1850 GdkEventButton *event)
1852 GtkTreeView *tree_view;
1854 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
1855 g_return_val_if_fail (event != NULL, FALSE);
1857 tree_view = GTK_TREE_VIEW (widget);
1859 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
1860 return gtk_tree_view_button_release_drag_column (widget, event);
1862 if (tree_view->priv->pressed_button == event->button)
1863 tree_view->priv->pressed_button = -1;
1865 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
1866 return gtk_tree_view_button_release_column_resize (widget, event);
1868 if (tree_view->priv->button_pressed_node == NULL)
1871 if (event->button == 1)
1873 gtk_grab_remove (widget);
1874 if (tree_view->priv->button_pressed_node == tree_view->priv->prelight_node &&
1875 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
1877 GtkTreePath *path = NULL;
1879 path = _gtk_tree_view_find_path (tree_view,
1880 tree_view->priv->button_pressed_tree,
1881 tree_view->priv->button_pressed_node);
1882 /* Actually activate the node */
1883 if (tree_view->priv->button_pressed_node->children == NULL)
1884 gtk_tree_view_real_expand_row (tree_view, path,
1885 tree_view->priv->button_pressed_tree,
1886 tree_view->priv->button_pressed_node,
1889 gtk_tree_view_real_collapse_row (GTK_TREE_VIEW (widget), path,
1890 tree_view->priv->button_pressed_tree,
1891 tree_view->priv->button_pressed_node, TRUE);
1892 gtk_tree_path_free (path);
1895 tree_view->priv->button_pressed_tree = NULL;
1896 tree_view->priv->button_pressed_node = NULL;
1903 /* GtkWidget::motion_event function set.
1907 coords_are_over_arrow (GtkTreeView *tree_view,
1910 /* these are in window coords */
1917 if (!GTK_WIDGET_REALIZED (tree_view))
1920 if ((node->flags & GTK_RBNODE_IS_PARENT) == 0)
1923 arrow.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
1925 arrow.height = BACKGROUND_HEIGHT (node);
1927 gtk_tree_view_get_arrow_xrange (tree_view, tree, &arrow.x, &x2);
1929 arrow.width = x2 - arrow.x;
1931 return (x >= arrow.x &&
1932 x < (arrow.x + arrow.width) &&
1934 y < (arrow.y + arrow.height));
1938 do_unprelight (GtkTreeView *tree_view,
1939 /* these are in tree window coords */
1943 if (tree_view->priv->prelight_node == NULL)
1946 GTK_RBNODE_UNSET_FLAG (tree_view->priv->prelight_node, GTK_RBNODE_IS_PRELIT);
1948 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT) &&
1949 !coords_are_over_arrow (tree_view,
1950 tree_view->priv->prelight_tree,
1951 tree_view->priv->prelight_node,
1954 /* We need to unprelight the old arrow. */
1956 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
1958 gtk_tree_view_draw_arrow (tree_view,
1959 tree_view->priv->prelight_tree,
1960 tree_view->priv->prelight_node,
1966 tree_view->priv->prelight_node = NULL;
1967 tree_view->priv->prelight_tree = NULL;
1971 do_prelight (GtkTreeView *tree_view,
1974 /* these are in tree_window coords */
1978 if (coords_are_over_arrow (tree_view, tree, node, x, y))
1980 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
1983 tree_view->priv->prelight_node = node;
1984 tree_view->priv->prelight_tree = tree;
1986 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PRELIT);
1990 ensure_unprelighted (GtkTreeView *tree_view)
1992 do_unprelight (tree_view, -1000, -1000); /* coords not possibly over an arrow */
1993 g_assert (tree_view->priv->prelight_node == NULL);
1999 /* Our motion arrow is either a box (in the case of the original spot)
2000 * or an arrow. It is expander_size wide.
2023 gtk_tree_view_motion_draw_column_motion_arrow (GtkTreeView *tree_view)
2025 GtkTreeViewColumnReorder *reorder = tree_view->priv->cur_reorder;
2026 GtkWidget *widget = GTK_WIDGET (tree_view);
2027 GdkBitmap *mask = NULL;
2032 gint arrow_type = DRAG_COLUMN_WINDOW_STATE_UNSET;
2033 GdkWindowAttr attributes;
2034 guint attributes_mask;
2037 reorder->left_column == tree_view->priv->drag_column ||
2038 reorder->right_column == tree_view->priv->drag_column)
2039 arrow_type = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
2040 else if (reorder->left_column || reorder->right_column)
2042 GdkRectangle visible_rect;
2043 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
2044 if (reorder->left_column)
2045 x = reorder->left_column->button->allocation.x + reorder->left_column->button->allocation.width;
2047 x = reorder->right_column->button->allocation.x;
2048 if (x < visible_rect.x)
2049 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT;
2050 else if (x > visible_rect.x + visible_rect.width)
2051 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT;
2053 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW;
2056 /* We want to draw the rectangle over the initial location. */
2057 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
2062 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
2065 if (tree_view->priv->drag_highlight_window)
2066 gdk_window_destroy (tree_view->priv->drag_highlight_window);
2068 attributes.window_type = GDK_WINDOW_CHILD;
2069 attributes.wclass = GDK_INPUT_OUTPUT;
2070 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
2071 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
2072 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
2073 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
2074 tree_view->priv->drag_highlight_window = gdk_window_new (tree_view->priv->header_window, &attributes, attributes_mask);
2075 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
2077 width = tree_view->priv->drag_column->button->allocation.width;
2078 height = tree_view->priv->drag_column->button->allocation.height;
2079 gdk_window_move_resize (tree_view->priv->drag_highlight_window,
2080 tree_view->priv->drag_column_x, 0, width, height);
2082 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
2083 gc = gdk_gc_new (mask);
2085 gdk_gc_set_foreground (gc, &col);
2086 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
2088 gdk_gc_set_foreground(gc, &col);
2089 gdk_draw_rectangle (mask, gc, TRUE, 2, 2, width - 4, height - 4);
2090 gdk_gc_destroy (gc);
2092 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
2094 if (mask) gdk_pixmap_unref (mask);
2095 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
2098 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW)
2105 gtk_widget_style_get (widget,
2106 "expander_size", &expander_size,
2109 width = expander_size;
2111 /* Get x, y, width, height of arrow */
2112 if (reorder->left_column)
2114 gdk_window_get_origin (reorder->left_column->button->window, &x, &y);
2115 x += reorder->left_column->button->allocation.width - width/2;
2116 height = reorder->left_column->button->allocation.height;
2120 gdk_window_get_origin (reorder->right_column->button->window, &x, &y);
2122 height = reorder->right_column->button->allocation.height;
2124 y -= expander_size/2; /* The arrow takes up only half the space */
2125 height += expander_size;
2127 /* Create the new window */
2128 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW)
2130 if (tree_view->priv->drag_highlight_window)
2131 gdk_window_destroy (tree_view->priv->drag_highlight_window);
2133 attributes.window_type = GDK_WINDOW_TEMP;
2134 attributes.wclass = GDK_INPUT_OUTPUT;
2135 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
2136 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
2137 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
2138 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
2139 attributes.width = width;
2140 attributes.height = height;
2141 tree_view->priv->drag_highlight_window = gdk_window_new (NULL, &attributes, attributes_mask);
2142 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
2144 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
2145 gc = gdk_gc_new (mask);
2147 gdk_gc_set_foreground (gc, &col);
2148 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
2150 /* Draw the 2 arrows as per above */
2152 gdk_gc_set_foreground (gc, &col);
2153 for (i = 0; i < width; i ++)
2155 if (i == (width/2 - 1))
2157 gdk_draw_line (mask, gc, i, j, i, height - j);
2158 if (i < (width/2 - 1))
2163 gdk_gc_destroy (gc);
2164 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
2166 if (mask) gdk_pixmap_unref (mask);
2169 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ARROW;
2170 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
2172 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT ||
2173 arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
2180 gtk_widget_style_get (widget,
2181 "expander_size", &expander_size,
2184 width = expander_size;
2186 /* Get x, y, width, height of arrow */
2187 width = width/2; /* remember, the arrow only takes half the available width */
2188 gdk_window_get_origin (widget->window, &x, &y);
2189 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
2190 x += widget->allocation.width - width;
2192 if (reorder->left_column)
2193 height = reorder->left_column->button->allocation.height;
2195 height = reorder->right_column->button->allocation.height;
2198 height += 2*expander_size;
2200 /* Create the new window */
2201 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT &&
2202 tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
2204 if (tree_view->priv->drag_highlight_window)
2205 gdk_window_destroy (tree_view->priv->drag_highlight_window);
2207 attributes.window_type = GDK_WINDOW_TEMP;
2208 attributes.wclass = GDK_INPUT_OUTPUT;
2209 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
2210 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
2211 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
2212 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
2213 attributes.width = width;
2214 attributes.height = height;
2215 tree_view->priv->drag_highlight_window = gdk_window_new (NULL, &attributes, attributes_mask);
2216 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
2218 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
2219 gc = gdk_gc_new (mask);
2221 gdk_gc_set_foreground (gc, &col);
2222 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
2224 /* Draw the 2 arrows as per above */
2226 gdk_gc_set_foreground (gc, &col);
2228 for (i = 0; i < width; i ++)
2231 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT)
2235 gdk_draw_line (mask, gc, k, j, k, height - j);
2236 gdk_draw_line (mask, gc, k, 0, k, expander_size - j);
2237 gdk_draw_line (mask, gc, k, height, k, height - expander_size + j);
2240 gdk_gc_destroy (gc);
2241 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
2243 if (mask) gdk_pixmap_unref (mask);
2246 tree_view->priv->drag_column_window_state = arrow_type;
2247 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
2251 g_warning (G_STRLOC"Invalid GtkTreeViewColumnReorder struct");
2252 gdk_window_hide (tree_view->priv->drag_highlight_window);
2256 gdk_window_show (tree_view->priv->drag_highlight_window);
2257 gdk_window_raise (tree_view->priv->drag_highlight_window);
2261 gtk_tree_view_motion_resize_column (GtkWidget *widget,
2262 GdkEventMotion *event)
2267 if (event->is_hint || event->window != widget->window)
2268 gtk_widget_get_pointer (widget, &x, NULL);
2272 new_width = gtk_tree_view_new_column_width (GTK_TREE_VIEW (widget),
2273 GTK_TREE_VIEW (widget)->priv->drag_pos, &x);
2274 if (x != GTK_TREE_VIEW (widget)->priv->x_drag)
2275 _gtk_tree_view_column_set_width (gtk_tree_view_get_column (GTK_TREE_VIEW (widget), GTK_TREE_VIEW (widget)->priv->drag_pos), new_width);
2277 /* FIXME: Do we need to scroll */
2278 _gtk_tree_view_update_size (GTK_TREE_VIEW (widget));
2284 gtk_tree_view_update_current_reorder (GtkTreeView *tree_view)
2286 GtkTreeViewColumnReorder *reorder = NULL;
2290 gdk_window_get_pointer (tree_view->priv->bin_window, &mouse_x, NULL, NULL);
2292 for (list = tree_view->priv->column_drag_info; list; list = list->next)
2294 reorder = (GtkTreeViewColumnReorder *) list->data;
2295 if (mouse_x >= reorder->left_align && mouse_x < reorder->right_align)
2300 /* if (reorder && reorder == tree_view->priv->cur_reorder)
2303 tree_view->priv->cur_reorder = reorder;
2304 gtk_tree_view_motion_draw_column_motion_arrow (tree_view);
2308 gtk_tree_view_horizontal_autoscroll (GtkTreeView *tree_view)
2310 GdkRectangle visible_rect;
2315 gdk_window_get_pointer (tree_view->priv->bin_window, &x, NULL, NULL);
2317 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
2319 /* See if we are near the edge. */
2320 offset = x - (visible_rect.x + SCROLL_EDGE_SIZE);
2323 offset = x - (visible_rect.x + visible_rect.width - SCROLL_EDGE_SIZE);
2329 value = CLAMP (tree_view->priv->hadjustment->value + offset,
2330 0.0, tree_view->priv->hadjustment->upper - tree_view->priv->hadjustment->page_size);
2331 gtk_adjustment_set_value (tree_view->priv->hadjustment, value);
2338 gtk_tree_view_motion_drag_column (GtkWidget *widget,
2339 GdkEventMotion *event)
2341 GtkTreeView *tree_view = (GtkTreeView *) widget;
2342 GtkTreeViewColumn *column = tree_view->priv->drag_column;
2346 if ((column == NULL) ||
2347 (event->window != tree_view->priv->drag_window))
2350 /* Handle moving the header */
2351 gdk_window_get_position (tree_view->priv->drag_window, &x, &y);
2352 x = CLAMP (x + (gint)event->x - column->drag_x, 0,
2353 MAX (tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.width) - column->button->allocation.width);
2354 gdk_window_move (tree_view->priv->drag_window, x, y);
2356 /* autoscroll, if needed */
2357 gtk_tree_view_horizontal_autoscroll (tree_view);
2358 /* Update the current reorder position and arrow; */
2359 gtk_tree_view_update_current_reorder (tree_view);
2365 gtk_tree_view_motion_bin_window (GtkWidget *widget,
2366 GdkEventMotion *event)
2368 GtkTreeView *tree_view;
2372 GtkRBTree *old_prelight_tree;
2373 GtkRBNode *old_prelight_node;
2374 gboolean old_arrow_prelit;
2376 tree_view = (GtkTreeView *) widget;
2378 if (tree_view->priv->tree == NULL)
2381 gtk_tree_view_maybe_begin_dragging_row (tree_view, event);
2383 old_prelight_tree = tree_view->priv->prelight_tree;
2384 old_prelight_node = tree_view->priv->prelight_node;
2385 old_arrow_prelit = GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
2387 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
2390 do_unprelight (tree_view, event->x, event->y);
2391 _gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
2396 /* If we are currently pressing down a button, we don't want to prelight anything else. */
2397 if ((tree_view->priv->button_pressed_node != NULL) &&
2398 (tree_view->priv->button_pressed_node != node))
2402 do_prelight (tree_view, tree, node, event->x, event->y);
2404 if (old_prelight_node != tree_view->priv->prelight_node)
2406 if (old_prelight_node)
2408 gtk_tree_view_queue_draw_node (tree_view,
2413 if (tree_view->priv->prelight_node)
2415 gtk_tree_view_queue_draw_node (tree_view,
2416 tree_view->priv->prelight_tree,
2417 tree_view->priv->prelight_node,
2421 else if (old_arrow_prelit != GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
2423 if (tree_view->priv->prelight_node)
2425 gtk_tree_view_queue_draw_node (tree_view,
2426 tree_view->priv->prelight_tree,
2427 tree_view->priv->prelight_node,
2435 gtk_tree_view_motion (GtkWidget *widget,
2436 GdkEventMotion *event)
2438 GtkTreeView *tree_view;
2440 tree_view = (GtkTreeView *) widget;
2442 /* Resizing a column */
2443 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
2444 return gtk_tree_view_motion_resize_column (widget, event);
2447 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
2448 return gtk_tree_view_motion_drag_column (widget, event);
2450 /* Sanity check it */
2451 if (event->window == tree_view->priv->bin_window)
2452 return gtk_tree_view_motion_bin_window (widget, event);
2457 /* Warning: Very scary function.
2458 * Modify at your own risk
2460 * KEEP IN SYNC WITH gtk_tree_view_create_row_drag_icon()!
2461 * FIXME: It's not...
2464 gtk_tree_view_bin_expose (GtkWidget *widget,
2465 GdkEventExpose *event)
2467 GtkTreeView *tree_view;
2472 GtkRBNode *cursor = NULL;
2473 GtkRBTree *cursor_tree = NULL;
2474 GtkRBNode *drag_highlight = NULL;
2475 GtkRBTree *drag_highlight_tree = NULL;
2478 gint y_offset, x_offset, cell_offset;
2481 GdkRectangle background_area;
2482 GdkRectangle cell_area;
2485 gint bin_window_width;
2486 GtkTreePath *cursor_path;
2487 GtkTreePath *drag_dest_path;
2489 gint vertical_separator;
2490 gint horizontal_separator;
2491 gboolean allow_rules;
2493 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2495 tree_view = GTK_TREE_VIEW (widget);
2497 gtk_widget_style_get (widget,
2498 "horizontal_separator", &horizontal_separator,
2499 "vertical_separator", &vertical_separator,
2500 "allow_rules", &allow_rules,
2503 if (tree_view->priv->tree == NULL)
2506 /* clip event->area to the visible area */
2507 if (event->area.y < TREE_VIEW_HEADER_HEIGHT (tree_view))
2509 event->area.height -= (TREE_VIEW_HEADER_HEIGHT (tree_view) - event->area.y);
2510 event->area.y = TREE_VIEW_HEADER_HEIGHT (tree_view);
2512 if (event->area.height < 0)
2516 gtk_tree_view_check_dirty_and_clean (GTK_TREE_VIEW (widget));
2518 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->area.y);
2521 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
2526 /* find the path for the node */
2527 path = _gtk_tree_view_find_path ((GtkTreeView *)widget,
2530 gtk_tree_model_get_iter (tree_view->priv->model,
2533 depth = gtk_tree_path_get_depth (path);
2534 gtk_tree_path_free (path);
2537 drag_dest_path = NULL;
2539 if (tree_view->priv->cursor)
2540 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
2543 _gtk_tree_view_find_node (tree_view, cursor_path,
2544 &cursor_tree, &cursor);
2546 if (tree_view->priv->drag_dest_row)
2547 drag_dest_path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
2550 _gtk_tree_view_find_node (tree_view, drag_dest_path,
2551 &drag_highlight_tree, &drag_highlight);
2553 gdk_drawable_get_size (tree_view->priv->bin_window,
2554 &bin_window_width, NULL);
2556 for (last_column = g_list_last (tree_view->priv->columns);
2558 !(GTK_TREE_VIEW_COLUMN (last_column->data)->visible) &&
2559 GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (last_column->data)->button);
2560 last_column = last_column->prev)
2563 /* Actually process the expose event. To do this, we want to
2564 * start at the first node of the event, and walk the tree in
2565 * order, drawing each successive node.
2572 max_height = BACKGROUND_HEIGHT (node);
2574 x_offset = -event->area.x;
2576 highlight_x = 0; /* should match x coord of first cell */
2578 background_area.y = y_offset + event->area.y;
2579 background_area.height = max_height;
2583 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PRELIT))
2584 flags |= GTK_CELL_RENDERER_PRELIT;
2586 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
2587 flags |= GTK_CELL_RENDERER_SELECTED;
2589 parity = _gtk_rbtree_node_find_parity (tree, node);
2591 for (list = tree_view->priv->columns; list; list = list->next)
2593 GtkTreeViewColumn *column = list->data;
2594 const gchar *detail = NULL;
2597 if (!column->visible)
2600 if (cell_offset > event->area.x + event->area.width ||
2601 cell_offset + column->width < event->area.x)
2603 cell_offset += column->width;
2607 if (column->show_sort_indicator)
2608 flags |= GTK_CELL_RENDERER_SORTED;
2610 flags &= ~GTK_CELL_RENDERER_SORTED;
2612 gtk_tree_view_column_cell_set_cell_data (column,
2613 tree_view->priv->model,
2615 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
2616 node->children?TRUE:FALSE);
2619 background_area.x = cell_offset;
2620 background_area.width = column->width;
2622 cell_area = background_area;
2623 cell_area.y += vertical_separator / 2;
2624 cell_area.x += horizontal_separator / 2;
2625 cell_area.height -= vertical_separator;
2626 cell_area.width -= horizontal_separator;
2628 /* Select the detail for drawing the cell. relevant
2629 * factors are parity, sortedness, and whether to
2632 if (allow_rules && tree_view->priv->has_rules)
2634 if (flags & GTK_CELL_RENDERER_SORTED)
2637 detail = "cell_odd_ruled_sorted";
2639 detail = "cell_even_ruled_sorted";
2644 detail = "cell_odd_ruled";
2646 detail = "cell_even_ruled";
2651 if (flags & GTK_CELL_RENDERER_SORTED)
2654 detail = "cell_odd_sorted";
2656 detail = "cell_even_sorted";
2661 detail = "cell_odd";
2663 detail = "cell_even";
2669 if (flags & GTK_CELL_RENDERER_SELECTED)
2670 state = GTK_STATE_SELECTED;
2672 state = GTK_STATE_NORMAL;
2674 /* Draw background */
2675 gtk_paint_flat_box (widget->style,
2684 background_area.width,
2685 background_area.height);
2687 if (gtk_tree_view_is_expander_column (tree_view, column) &&
2688 TREE_VIEW_DRAW_EXPANDERS(tree_view))
2690 cell_area.x += depth*tree_view->priv->tab_offset;
2691 cell_area.width -= depth*tree_view->priv->tab_offset;
2693 /* If we have an expander column, the highlight underline
2694 * starts with that column, so that it indicates which
2695 * level of the tree we're dropping at.
2697 highlight_x = cell_area.x;
2698 gtk_tree_view_column_cell_render (column,
2704 if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT)
2707 gdk_window_get_pointer (tree_view->priv->bin_window, &x, &y, 0);
2708 gtk_tree_view_draw_arrow (GTK_TREE_VIEW (widget),
2716 gtk_tree_view_column_cell_render (column,
2723 if (node == cursor &&
2724 ((column == tree_view->priv->focus_column &&
2725 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS) &&
2726 GTK_WIDGET_HAS_FOCUS (widget)) ||
2727 (column == tree_view->priv->edited_column)))
2729 gtk_tree_view_column_cell_draw_focus (column,
2736 cell_offset += column->width;
2740 if (node == drag_highlight)
2742 /* Draw indicator for the drop
2744 gint highlight_y = -1;
2745 GtkRBTree *tree = NULL;
2746 GtkRBNode *node = NULL;
2749 switch (tree_view->priv->drag_dest_pos)
2751 case GTK_TREE_VIEW_DROP_BEFORE:
2752 highlight_y = background_area.y - vertical_separator/2;
2755 case GTK_TREE_VIEW_DROP_AFTER:
2756 highlight_y = background_area.y + background_area.height + vertical_separator/2;
2759 case GTK_TREE_VIEW_DROP_INTO_OR_BEFORE:
2760 case GTK_TREE_VIEW_DROP_INTO_OR_AFTER:
2761 _gtk_tree_view_find_node (tree_view, drag_dest_path, &tree, &node);
2765 gdk_drawable_get_size (tree_view->priv->bin_window,
2767 gtk_paint_focus (widget->style,
2768 tree_view->priv->bin_window,
2769 GTK_WIDGET_STATE (widget),
2772 "treeview-drop-indicator",
2773 0, BACKGROUND_FIRST_PIXEL (tree_view, tree, node),
2774 width, BACKGROUND_HEIGHT (node));
2779 if (highlight_y >= 0)
2781 gdk_draw_line (event->window,
2782 widget->style->black_gc,
2785 bin_window_width - highlight_x,
2790 y_offset += max_height;
2793 GtkTreeIter parent = iter;
2796 tree = node->children;
2799 g_assert (node != tree->nil);
2801 while (node->left != tree->nil)
2803 has_child = gtk_tree_model_iter_children (tree_view->priv->model,
2809 TREE_VIEW_INTERNAL_ASSERT (has_child, FALSE);
2813 gboolean done = FALSE;
2816 node = _gtk_rbtree_next (tree, node);
2819 gboolean has_next = gtk_tree_model_iter_next (tree_view->priv->model, &iter);
2823 TREE_VIEW_INTERNAL_ASSERT (has_next, FALSE);
2827 GtkTreeIter parent_iter = iter;
2828 gboolean has_parent;
2830 node = tree->parent_node;
2831 tree = tree->parent_tree;
2833 /* we should go to done to free some memory */
2835 has_parent = gtk_tree_model_iter_parent (tree_view->priv->model,
2841 TREE_VIEW_INTERNAL_ASSERT (has_parent, FALSE);
2847 while (y_offset < event->area.height);
2851 gtk_tree_path_free (cursor_path);
2854 gtk_tree_path_free (drag_dest_path);
2860 gtk_tree_view_expose (GtkWidget *widget,
2861 GdkEventExpose *event)
2863 GtkTreeView *tree_view;
2865 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2867 tree_view = GTK_TREE_VIEW (widget);
2869 if (event->window == tree_view->priv->bin_window)
2870 return gtk_tree_view_bin_expose (widget, event);
2871 else if (event->window == tree_view->priv->header_window)
2875 for (list = tree_view->priv->columns; list != NULL; list = list->next)
2877 GtkTreeViewColumn *column = list->data;
2879 if (column->visible)
2880 gtk_container_propagate_expose (GTK_CONTAINER (tree_view),
2890 gtk_tree_view_key_press (GtkWidget *widget,
2893 GtkTreeView *tree_view = (GtkTreeView *) widget;
2895 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
2897 if (event->keyval == GDK_Escape)
2899 tree_view->priv->cur_reorder = NULL;
2900 gtk_tree_view_button_release_drag_column (widget, NULL);
2905 return (* GTK_WIDGET_CLASS (parent_class)->key_press_event) (widget, event);
2908 /* FIXME Is this function necessary? Can I get an enter_notify event
2909 * w/o either an expose event or a mouse motion event?
2912 gtk_tree_view_enter_notify (GtkWidget *widget,
2913 GdkEventCrossing *event)
2915 GtkTreeView *tree_view;
2920 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2922 tree_view = GTK_TREE_VIEW (widget);
2924 /* Sanity check it */
2925 if (event->window != tree_view->priv->bin_window)
2928 if (tree_view->priv->tree == NULL)
2931 if ((tree_view->priv->button_pressed_node != NULL) &&
2932 (tree_view->priv->button_pressed_node != node))
2935 /* find the node internally */
2936 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
2939 _gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
2944 do_prelight (tree_view, tree, node, event->x, event->y);
2946 if (tree_view->priv->prelight_node)
2947 gtk_tree_view_queue_draw_node (tree_view,
2948 tree_view->priv->prelight_tree,
2949 tree_view->priv->prelight_node,
2956 gtk_tree_view_leave_notify (GtkWidget *widget,
2957 GdkEventCrossing *event)
2959 GtkWidget *search_dialog;
2960 GtkTreeView *tree_view;
2962 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2964 if (event->mode == GDK_CROSSING_GRAB)
2966 tree_view = GTK_TREE_VIEW (widget);
2968 if (tree_view->priv->prelight_node)
2969 gtk_tree_view_queue_draw_node (tree_view,
2970 tree_view->priv->prelight_tree,
2971 tree_view->priv->prelight_node,
2974 ensure_unprelighted (tree_view);
2976 /* destroy interactive search dialog */
2977 search_dialog = gtk_object_get_data (GTK_OBJECT (widget),
2978 GTK_TREE_VIEW_SEARCH_DIALOG_KEY);
2980 gtk_tree_view_search_dialog_destroy (search_dialog, GTK_TREE_VIEW (widget));
2987 gtk_tree_view_focus_in (GtkWidget *widget,
2988 GdkEventFocus *event)
2990 GtkTreeView *tree_view;
2992 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2993 g_return_val_if_fail (event != NULL, FALSE);
2995 tree_view = GTK_TREE_VIEW (widget);
2997 GTK_WIDGET_SET_FLAGS (widget, GTK_HAS_FOCUS);
2999 gtk_widget_queue_draw (widget);
3006 gtk_tree_view_focus_out (GtkWidget *widget,
3007 GdkEventFocus *event)
3009 GtkWidget *search_dialog;
3011 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
3012 g_return_val_if_fail (event != NULL, FALSE);
3014 GTK_WIDGET_UNSET_FLAGS (widget, GTK_HAS_FOCUS);
3016 gtk_widget_queue_draw (widget);
3018 /* destroy interactive search dialog */
3019 search_dialog = gtk_object_get_data (GTK_OBJECT (widget),
3020 GTK_TREE_VIEW_SEARCH_DIALOG_KEY);
3022 gtk_tree_view_search_dialog_destroy (search_dialog, GTK_TREE_VIEW (widget));
3026 /* Incremental Reflow */
3029 validate_visible_area (GtkTreeView *tree_view)
3035 validate_rows_handler (GtkTreeView *tree_view)
3037 g_assert (tree_view);
3039 g_return_val_if_fail (tree_view->priv->tree != NULL, TRUE);
3041 if (! GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID))
3049 presize_handler_callback (gpointer data)
3056 install_presize_handler (GtkTreeView *tree_view)
3064 set_source_row (GdkDragContext *context,
3065 GtkTreeModel *model,
3066 GtkTreePath *source_row)
3068 g_object_set_data_full (G_OBJECT (context),
3069 "gtk-tree-view-source-row",
3070 source_row ? gtk_tree_row_reference_new (model, source_row) : NULL,
3071 (GDestroyNotify) (source_row ? gtk_tree_row_reference_free : NULL));
3075 get_source_row (GdkDragContext *context)
3077 GtkTreeRowReference *ref =
3078 g_object_get_data (G_OBJECT (context), "gtk-tree-view-source-row");
3081 return gtk_tree_row_reference_get_path (ref);
3088 set_dest_row (GdkDragContext *context,
3089 GtkTreeModel *model,
3090 GtkTreePath *dest_row)
3092 g_object_set_data_full (G_OBJECT (context),
3093 "gtk-tree-view-dest-row",
3094 dest_row ? gtk_tree_row_reference_new (model, dest_row) : NULL,
3095 (GDestroyNotify) (dest_row ? gtk_tree_row_reference_free : NULL));
3099 get_dest_row (GdkDragContext *context)
3101 GtkTreeRowReference *ref =
3102 g_object_get_data (G_OBJECT (context), "gtk-tree-view-dest-row");
3105 return gtk_tree_row_reference_get_path (ref);
3110 /* Get/set whether drag_motion requested the drag data and
3111 * drag_data_received should thus not actually insert the data,
3112 * since the data doesn't result from a drop.
3115 set_status_pending (GdkDragContext *context,
3116 GdkDragAction suggested_action)
3118 g_object_set_data (G_OBJECT (context),
3119 "gtk-tree-view-status-pending",
3120 GINT_TO_POINTER (suggested_action));
3123 static GdkDragAction
3124 get_status_pending (GdkDragContext *context)
3126 return GPOINTER_TO_INT (g_object_get_data (G_OBJECT (context),
3127 "gtk-tree-view-status-pending"));
3130 static TreeViewDragInfo*
3131 get_info (GtkTreeView *tree_view)
3133 return g_object_get_data (G_OBJECT (tree_view), "gtk-tree-view-drag-info");
3137 clear_source_info (TreeViewDragInfo *di)
3139 if (di->source_target_list)
3140 gtk_target_list_unref (di->source_target_list);
3142 di->source_target_list = NULL;
3146 clear_dest_info (TreeViewDragInfo *di)
3148 if (di->dest_target_list)
3149 gtk_target_list_unref (di->dest_target_list);
3151 di->dest_target_list = NULL;
3155 destroy_info (TreeViewDragInfo *di)
3157 clear_source_info (di);
3158 clear_dest_info (di);
3162 static TreeViewDragInfo*
3163 ensure_info (GtkTreeView *tree_view)
3165 TreeViewDragInfo *di;
3167 di = get_info (tree_view);
3171 di = g_new0 (TreeViewDragInfo, 1);
3173 g_object_set_data_full (G_OBJECT (tree_view),
3174 "gtk-tree-view-drag-info",
3176 (GDestroyNotify) destroy_info);
3183 remove_info (GtkTreeView *tree_view)
3185 g_object_set_data (G_OBJECT (tree_view), "gtk-tree-view-drag-info", NULL);
3190 drag_scan_timeout (gpointer data)
3192 GtkTreeView *tree_view;
3194 GdkModifierType state;
3195 GtkTreePath *path = NULL;
3196 GtkTreeViewColumn *column = NULL;
3197 GdkRectangle visible_rect;
3199 GDK_THREADS_ENTER ();
3201 tree_view = GTK_TREE_VIEW (data);
3203 gdk_window_get_pointer (tree_view->priv->bin_window,
3206 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
3208 /* See if we are near the edge. */
3209 if ((x - visible_rect.x) < SCROLL_EDGE_SIZE ||
3210 (visible_rect.x + visible_rect.width - x) < SCROLL_EDGE_SIZE ||
3211 (y - visible_rect.y) < SCROLL_EDGE_SIZE ||
3212 (visible_rect.y + visible_rect.height - y) < SCROLL_EDGE_SIZE)
3214 gtk_tree_view_get_path_at_pos (tree_view,
3215 tree_view->priv->bin_window,
3224 gtk_tree_view_scroll_to_cell (tree_view,
3230 gtk_tree_path_free (path);
3234 GDK_THREADS_LEAVE ();
3241 remove_scroll_timeout (GtkTreeView *tree_view)
3243 if (tree_view->priv->scroll_timeout != 0)
3245 gtk_timeout_remove (tree_view->priv->scroll_timeout);
3246 tree_view->priv->scroll_timeout = 0;
3250 check_model_dnd (GtkTreeModel *model,
3251 GType required_iface,
3252 const gchar *signal)
3254 if (model == NULL || !G_TYPE_CHECK_INSTANCE_TYPE ((model), required_iface))
3256 g_warning ("You must override the default '%s' handler "
3257 "on GtkTreeView when using models that don't support "
3258 "the %s interface and enabling drag-and-drop. The simplest way to do this "
3259 "is to connect to '%s' and call "
3260 "gtk_signal_emit_stop_by_name() in your signal handler to prevent "
3261 "the default handler from running. Look at the source code "
3262 "for the default handler in gtktreeview.c to get an idea what "
3263 "your handler should do. (gtktreeview.c is in the GTK source "
3264 "code.) If you're using GTK from a language other than C, "
3265 "there may be a more natural way to override default handlers, e.g. via derivation.",
3266 signal, g_type_name (required_iface), signal);
3274 remove_open_timeout (GtkTreeView *tree_view)
3276 if (tree_view->priv->open_dest_timeout != 0)
3278 gtk_timeout_remove (tree_view->priv->open_dest_timeout);
3279 tree_view->priv->open_dest_timeout = 0;
3285 open_row_timeout (gpointer data)
3287 GtkTreeView *tree_view = data;
3288 GtkTreePath *dest_path = NULL;
3289 GtkTreeViewDropPosition pos;
3290 gboolean result = FALSE;
3292 GDK_THREADS_ENTER ();
3294 gtk_tree_view_get_drag_dest_row (tree_view,
3299 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
3300 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
3302 gtk_tree_view_expand_row (tree_view, dest_path, FALSE);
3303 tree_view->priv->open_dest_timeout = 0;
3305 gtk_tree_path_free (dest_path);
3310 gtk_tree_path_free (dest_path);
3315 GDK_THREADS_LEAVE ();
3320 /* Returns TRUE if event should not be propagated to parent widgets */
3322 set_destination_row (GtkTreeView *tree_view,
3323 GdkDragContext *context,
3326 GdkDragAction *suggested_action,
3329 GtkTreePath *path = NULL;
3330 GtkTreeViewDropPosition pos;
3331 GtkTreeViewDropPosition old_pos;
3332 TreeViewDragInfo *di;
3334 GtkTreePath *old_dest_path = NULL;
3336 *suggested_action = 0;
3339 widget = GTK_WIDGET (tree_view);
3341 di = get_info (tree_view);
3345 /* someone unset us as a drag dest, note that if
3346 * we return FALSE drag_leave isn't called
3349 gtk_tree_view_set_drag_dest_row (tree_view,
3351 GTK_TREE_VIEW_DROP_BEFORE);
3353 remove_scroll_timeout (GTK_TREE_VIEW (widget));
3354 remove_open_timeout (GTK_TREE_VIEW (widget));
3356 return FALSE; /* no longer a drop site */
3359 *target = gtk_drag_dest_find_target (widget, context, di->dest_target_list);
3360 if (*target == GDK_NONE)
3365 if (!gtk_tree_view_get_dest_row_at_pos (tree_view,
3370 /* can't drop here */
3371 remove_open_timeout (tree_view);
3373 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3375 GTK_TREE_VIEW_DROP_BEFORE);
3377 /* don't propagate to parent though */
3383 /* If we left the current row's "open" zone, unset the timeout for
3386 gtk_tree_view_get_drag_dest_row (tree_view,
3390 if (old_dest_path &&
3391 (gtk_tree_path_compare (path, old_dest_path) != 0 ||
3392 !(pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
3393 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE)))
3394 remove_open_timeout (tree_view);
3397 gtk_tree_path_free (old_dest_path);
3399 if (TRUE /* FIXME if the location droppable predicate */)
3401 GtkWidget *source_widget;
3403 *suggested_action = context->suggested_action;
3405 source_widget = gtk_drag_get_source_widget (context);
3407 if (source_widget == widget)
3409 /* Default to MOVE, unless the user has
3410 * pressed ctrl or alt to affect available actions
3412 if ((context->actions & GDK_ACTION_MOVE) != 0)
3413 *suggested_action = GDK_ACTION_MOVE;
3416 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3421 /* can't drop here */
3422 remove_open_timeout (tree_view);
3424 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3426 GTK_TREE_VIEW_DROP_BEFORE);
3432 get_logical_dest_row (GtkTreeView *tree_view)
3435 /* adjust path to point to the row the drop goes in front of */
3436 GtkTreePath *path = NULL;
3437 GtkTreeViewDropPosition pos;
3439 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
3444 if (pos == GTK_TREE_VIEW_DROP_BEFORE)
3446 else if (pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE ||
3447 pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER)
3449 /* get first child, drop before it */
3450 gtk_tree_path_append_index (path, 0);
3454 g_assert (pos == GTK_TREE_VIEW_DROP_AFTER);
3455 gtk_tree_path_next (path);
3462 gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
3463 GdkEventMotion *event)
3465 GdkDragContext *context;
3466 TreeViewDragInfo *di;
3467 GtkTreePath *path = NULL;
3469 gint cell_x, cell_y;
3470 GtkTreeModel *model;
3471 gboolean retval = FALSE;
3473 di = get_info (tree_view);
3478 if (tree_view->priv->pressed_button < 0)
3481 if (!gtk_drag_check_threshold (GTK_WIDGET (tree_view),
3482 tree_view->priv->press_start_x,
3483 tree_view->priv->press_start_y,
3484 event->x, event->y))
3487 model = gtk_tree_view_get_model (tree_view);
3492 button = tree_view->priv->pressed_button;
3493 tree_view->priv->pressed_button = -1;
3495 gtk_tree_view_get_path_at_pos (tree_view,
3496 tree_view->priv->press_start_x,
3497 tree_view->priv->press_start_y,
3506 if (!GTK_IS_TREE_DRAG_SOURCE (model) ||
3507 !gtk_tree_drag_source_row_draggable (GTK_TREE_DRAG_SOURCE (model),
3511 /* FIXME Check whether we're a start button, if not return FALSE and
3515 /* Now we can begin the drag */
3519 context = gtk_drag_begin (GTK_WIDGET (tree_view),
3520 di->source_target_list,
3525 gtk_drag_set_icon_default (context);
3530 row_pix = gtk_tree_view_create_row_drag_icon (tree_view,
3533 gtk_drag_set_icon_pixmap (context,
3534 gdk_drawable_get_colormap (row_pix),
3537 /* the + 1 is for the black border in the icon */
3538 tree_view->priv->press_start_x + 1,
3541 gdk_pixmap_unref (row_pix);
3544 set_source_row (context, model, path);
3548 gtk_tree_path_free (path);
3555 gtk_tree_view_drag_begin (GtkWidget *widget,
3556 GdkDragContext *context)
3562 gtk_tree_view_drag_end (GtkWidget *widget,
3563 GdkDragContext *context)
3568 /* Default signal implementations for the drag signals */
3570 gtk_tree_view_drag_data_get (GtkWidget *widget,
3571 GdkDragContext *context,
3572 GtkSelectionData *selection_data,
3576 GtkTreeView *tree_view;
3577 GtkTreeModel *model;
3578 TreeViewDragInfo *di;
3579 GtkTreePath *source_row;
3581 tree_view = GTK_TREE_VIEW (widget);
3583 model = gtk_tree_view_get_model (tree_view);
3588 di = get_info (GTK_TREE_VIEW (widget));
3593 source_row = get_source_row (context);
3595 if (source_row == NULL)
3598 /* We can implement the GTK_TREE_MODEL_ROW target generically for
3599 * any model; for DragSource models there are some other targets
3603 if (GTK_IS_TREE_DRAG_SOURCE (model) &&
3604 gtk_tree_drag_source_drag_data_get (GTK_TREE_DRAG_SOURCE (model),
3609 /* If drag_data_get does nothing, try providing row data. */
3610 if (selection_data->target == gdk_atom_intern ("GTK_TREE_MODEL_ROW", FALSE))
3612 gtk_tree_set_row_drag_data (selection_data,
3618 gtk_tree_path_free (source_row);
3623 gtk_tree_view_drag_data_delete (GtkWidget *widget,
3624 GdkDragContext *context)
3626 TreeViewDragInfo *di;
3627 GtkTreeModel *model;
3628 GtkTreeView *tree_view;
3629 GtkTreePath *source_row;
3631 tree_view = GTK_TREE_VIEW (widget);
3632 model = gtk_tree_view_get_model (tree_view);
3634 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_SOURCE, "drag_data_delete"))
3637 di = get_info (tree_view);
3642 source_row = get_source_row (context);
3644 if (source_row == NULL)
3647 gtk_tree_drag_source_drag_data_delete (GTK_TREE_DRAG_SOURCE (model),
3650 gtk_tree_path_free (source_row);
3652 set_source_row (context, NULL, NULL);
3656 gtk_tree_view_drag_leave (GtkWidget *widget,
3657 GdkDragContext *context,
3660 TreeViewDragInfo *di;
3662 di = get_info (GTK_TREE_VIEW (widget));
3664 /* unset any highlight row */
3665 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3667 GTK_TREE_VIEW_DROP_BEFORE);
3669 remove_scroll_timeout (GTK_TREE_VIEW (widget));
3670 remove_open_timeout (GTK_TREE_VIEW (widget));
3675 gtk_tree_view_drag_motion (GtkWidget *widget,
3676 GdkDragContext *context,
3681 GtkTreePath *path = NULL;
3682 GtkTreeViewDropPosition pos;
3683 GtkTreeView *tree_view;
3684 GdkDragAction suggested_action = 0;
3687 tree_view = GTK_TREE_VIEW (widget);
3689 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
3692 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
3696 /* Can't drop here. */
3697 gdk_drag_status (context, 0, time);
3701 if (tree_view->priv->open_dest_timeout == 0 &&
3702 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
3703 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
3705 tree_view->priv->open_dest_timeout =
3706 gtk_timeout_add (500, open_row_timeout, tree_view);
3709 if (target == gdk_atom_intern ("GTK_TREE_MODEL_ROW", FALSE))
3711 /* Request data so we can use the source row when
3712 * determining whether to accept the drop
3714 set_status_pending (context, suggested_action);
3715 gtk_drag_get_data (widget, context, target, time);
3719 set_status_pending (context, 0);
3720 gdk_drag_status (context, suggested_action, time);
3725 gtk_tree_path_free (path);
3732 gtk_tree_view_drag_drop (GtkWidget *widget,
3733 GdkDragContext *context,
3738 GtkTreeView *tree_view;
3740 GdkDragAction suggested_action = 0;
3741 GdkAtom target = GDK_NONE;
3742 TreeViewDragInfo *di;
3743 GtkTreeModel *model;
3745 tree_view = GTK_TREE_VIEW (widget);
3747 model = gtk_tree_view_get_model (tree_view);
3749 remove_scroll_timeout (GTK_TREE_VIEW (widget));
3750 remove_open_timeout (GTK_TREE_VIEW (widget));
3752 di = get_info (tree_view);
3757 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_drop"))
3760 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
3763 path = get_logical_dest_row (tree_view);
3765 if (target != GDK_NONE && path != NULL)
3767 /* in case a motion had requested drag data, change things so we
3768 * treat drag data receives as a drop.
3770 set_status_pending (context, 0);
3772 set_dest_row (context, model, path);
3776 gtk_tree_path_free (path);
3778 /* Unset this thing */
3779 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3781 GTK_TREE_VIEW_DROP_BEFORE);
3783 if (target != GDK_NONE)
3785 gtk_drag_get_data (widget, context, target, time);
3793 gtk_tree_view_drag_data_received (GtkWidget *widget,
3794 GdkDragContext *context,
3797 GtkSelectionData *selection_data,
3802 TreeViewDragInfo *di;
3803 gboolean accepted = FALSE;
3804 GtkTreeModel *model;
3805 GtkTreeView *tree_view;
3806 GtkTreePath *dest_row;
3807 GdkDragAction suggested_action;
3809 tree_view = GTK_TREE_VIEW (widget);
3811 model = gtk_tree_view_get_model (tree_view);
3813 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_data_received"))
3816 di = get_info (tree_view);
3821 suggested_action = get_status_pending (context);
3823 if (suggested_action)
3825 /* We are getting this data due to a request in drag_motion,
3826 * rather than due to a request in drag_drop, so we are just
3827 * supposed to call drag_status, not actually paste in the
3830 path = get_logical_dest_row (tree_view);
3833 suggested_action = 0;
3835 if (suggested_action)
3837 if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model),
3840 suggested_action = 0;
3843 gdk_drag_status (context, suggested_action, time);
3846 gtk_tree_path_free (path);
3848 /* If you can't drop, remove user drop indicator until the next motion */
3849 if (suggested_action == 0)
3850 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3852 GTK_TREE_VIEW_DROP_BEFORE);
3857 dest_row = get_dest_row (context);
3859 if (dest_row == NULL)
3862 if (selection_data->length >= 0)
3864 if (gtk_tree_drag_dest_drag_data_received (GTK_TREE_DRAG_DEST (model),
3870 gtk_drag_finish (context,
3872 (context->action == GDK_ACTION_MOVE),
3875 gtk_tree_path_free (dest_row);
3878 set_dest_row (context, NULL, NULL);
3883 /* GtkContainer Methods
3888 gtk_tree_view_remove (GtkContainer *container,
3891 GtkTreeView *tree_view;
3892 GtkTreeViewChild *child = NULL;
3895 g_return_if_fail (GTK_IS_TREE_VIEW (container));
3897 tree_view = GTK_TREE_VIEW (container);
3899 tmp_list = tree_view->priv->children;
3902 child = tmp_list->data;
3903 if (child->widget == widget)
3905 gtk_widget_unparent (widget);
3907 tree_view->priv->children = g_list_remove_link (tree_view->priv->children, tmp_list);
3908 g_list_free_1 (tmp_list);
3913 tmp_list = tmp_list->next;
3916 tmp_list = tree_view->priv->columns;
3920 GtkTreeViewColumn *column;
3921 column = tmp_list->data;
3922 if (column->button == widget)
3924 gtk_widget_unparent (widget);
3927 tmp_list = tmp_list->next;
3933 gtk_tree_view_forall (GtkContainer *container,
3934 gboolean include_internals,
3935 GtkCallback callback,
3936 gpointer callback_data)
3938 GtkTreeView *tree_view;
3939 GtkTreeViewChild *child = NULL;
3940 GtkTreeViewColumn *column;
3943 g_return_if_fail (GTK_IS_TREE_VIEW (container));
3944 g_return_if_fail (callback != NULL);
3946 tree_view = GTK_TREE_VIEW (container);
3948 tmp_list = tree_view->priv->children;
3951 child = tmp_list->data;
3952 tmp_list = tmp_list->next;
3954 (* callback) (child->widget, callback_data);
3956 if (include_internals == FALSE)
3959 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
3961 column = tmp_list->data;
3964 (* callback) (column->button, callback_data);
3968 /* Returns TRUE if the focus is within the headers, after the focus operation is
3972 gtk_tree_view_header_focus (GtkTreeView *tree_view,
3973 GtkDirectionType dir)
3975 GtkWidget *focus_child;
3976 GtkContainer *container;
3978 GList *last_column, *first_column;
3981 if (! GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
3984 focus_child = GTK_CONTAINER (tree_view)->focus_child;
3985 container = GTK_CONTAINER (tree_view);
3987 last_column = g_list_last (tree_view->priv->columns);
3990 if (GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (last_column->data)->button) &&
3991 GTK_TREE_VIEW_COLUMN (last_column->data)->clickable &&
3992 GTK_TREE_VIEW_COLUMN (last_column->data)->reorderable &&
3993 GTK_TREE_VIEW_COLUMN (last_column->data)->visible)
3995 last_column = last_column->prev;
3998 /* No headers are visible, or are focusable. We can't focus in or out.
4000 if (last_column == NULL)
4003 first_column = tree_view->priv->columns;
4004 while (first_column)
4006 if (GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (first_column->data)->button) &&
4007 GTK_TREE_VIEW_COLUMN (first_column->data)->clickable &&
4008 GTK_TREE_VIEW_COLUMN (last_column->data)->reorderable &&
4009 GTK_TREE_VIEW_COLUMN (first_column->data)->visible)
4011 first_column = first_column->next;
4016 case GTK_DIR_TAB_BACKWARD:
4017 case GTK_DIR_TAB_FORWARD:
4020 if (focus_child == NULL)
4022 if (tree_view->priv->focus_column != NULL)
4023 focus_child = tree_view->priv->focus_column->button;
4025 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
4026 gtk_widget_grab_focus (focus_child);
4033 if (focus_child == NULL)
4035 if (tree_view->priv->focus_column != NULL)
4036 focus_child = tree_view->priv->focus_column->button;
4037 else if (dir == GTK_DIR_LEFT)
4038 focus_child = GTK_TREE_VIEW_COLUMN (last_column->data)->button;
4040 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
4041 gtk_widget_grab_focus (focus_child);
4045 if (gtk_widget_child_focus (focus_child, dir))
4047 /* The focus moves inside the button. */
4048 /* This is probably a great example of bad UI */
4052 /* We need to move the focus among the row of buttons. */
4053 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
4054 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
4057 if (tmp_list == first_column && dir == GTK_DIR_LEFT)
4059 focus_child = GTK_TREE_VIEW_COLUMN (last_column->data)->button;
4060 gtk_widget_grab_focus (focus_child);
4063 else if (tmp_list == last_column && dir == GTK_DIR_RIGHT)
4065 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
4066 gtk_widget_grab_focus (focus_child);
4072 GtkTreeViewColumn *column;
4074 if (dir == GTK_DIR_RIGHT)
4075 tmp_list = tmp_list->next;
4077 tmp_list = tmp_list->prev;
4079 if (tmp_list == NULL)
4081 g_warning ("Internal button not found");
4084 column = tmp_list->data;
4085 if (column->button &&
4087 GTK_WIDGET_CAN_FOCUS (column->button))
4089 focus_child = column->button;
4090 gtk_widget_grab_focus (column->button);
4096 g_assert_not_reached ();
4100 /* if focus child is non-null, we assume it's been set to the current focus child
4104 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
4105 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
4108 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
4110 /* If the following isn't true, then the view is smaller then the scrollpane.
4112 if ((focus_child->allocation.x + focus_child->allocation.width) <=
4113 (tree_view->priv->hadjustment->upper))
4115 /* Scroll to the button, if needed */
4116 if ((tree_view->priv->hadjustment->value + tree_view->priv->hadjustment->page_size) <
4117 (focus_child->allocation.x + focus_child->allocation.width))
4118 gtk_adjustment_set_value (tree_view->priv->hadjustment,
4119 focus_child->allocation.x + focus_child->allocation.width -
4120 tree_view->priv->hadjustment->page_size);
4121 else if (tree_view->priv->hadjustment->value > focus_child->allocation.x)
4122 gtk_adjustment_set_value (tree_view->priv->hadjustment,
4123 focus_child->allocation.x);
4127 return (focus_child != NULL);
4131 gtk_tree_view_focus (GtkWidget *widget,
4132 GtkDirectionType direction)
4134 GtkTreeView *tree_view;
4135 GtkWidget *focus_child;
4136 GtkContainer *container;
4138 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
4139 g_return_val_if_fail (GTK_WIDGET_VISIBLE (widget), FALSE);
4141 container = GTK_CONTAINER (widget);
4142 tree_view = GTK_TREE_VIEW (widget);
4144 if (!GTK_WIDGET_IS_SENSITIVE (container))
4147 focus_child = container->focus_child;
4149 gtk_tree_view_stop_editing (GTK_TREE_VIEW (widget));
4150 /* Case 1. Headers currently have focus. */
4157 gtk_tree_view_header_focus (tree_view, direction);
4159 case GTK_DIR_TAB_BACKWARD:
4162 case GTK_DIR_TAB_FORWARD:
4164 if (tree_view->priv->tree == NULL)
4166 gtk_tree_view_focus_to_cursor (tree_view);
4171 /* Case 2. We don't have focus at all. */
4172 if (!GTK_WIDGET_HAS_FOCUS (container))
4174 if (tree_view->priv->tree == NULL &&
4175 (direction == GTK_DIR_TAB_BACKWARD ||
4176 direction == GTK_DIR_UP))
4177 return gtk_tree_view_header_focus (tree_view, direction);
4178 if (((direction == GTK_DIR_TAB_FORWARD) ||
4179 (direction == GTK_DIR_RIGHT) ||
4180 (direction == GTK_DIR_DOWN) ||
4181 (direction == GTK_DIR_LEFT)) &&
4182 gtk_tree_view_header_focus (tree_view, direction))
4185 if (tree_view->priv->tree == NULL)
4187 gtk_tree_view_focus_to_cursor (tree_view);
4191 /* Case 3. We have focus already. */
4192 if (tree_view->priv->tree == NULL)
4193 return gtk_tree_view_header_focus (tree_view, direction);
4195 if (direction == GTK_DIR_TAB_BACKWARD)
4196 return (gtk_tree_view_header_focus (tree_view, direction));
4197 else if (direction == GTK_DIR_TAB_FORWARD)
4200 /* Other directions caught by the keybindings */
4201 gtk_tree_view_focus_to_cursor (tree_view);
4207 gtk_tree_view_set_focus_child (GtkContainer *container,
4210 GtkTreeView *tree_view = GTK_TREE_VIEW (container);
4213 for (list = tree_view->priv->columns; list; list = list->next)
4215 if (GTK_TREE_VIEW_COLUMN (list->data)->button == child)
4217 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (list->data);
4222 (* parent_class->set_focus_child) (container, child);
4226 gtk_tree_view_set_adjustments (GtkTreeView *tree_view,
4227 GtkAdjustment *hadj,
4228 GtkAdjustment *vadj)
4230 gboolean need_adjust = FALSE;
4232 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
4235 g_return_if_fail (GTK_IS_ADJUSTMENT (hadj));
4237 hadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
4239 g_return_if_fail (GTK_IS_ADJUSTMENT (vadj));
4241 vadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
4243 if (tree_view->priv->hadjustment && (tree_view->priv->hadjustment != hadj))
4245 gtk_signal_disconnect_by_data (GTK_OBJECT (tree_view->priv->hadjustment), tree_view);
4246 gtk_object_unref (GTK_OBJECT (tree_view->priv->hadjustment));
4249 if (tree_view->priv->vadjustment && (tree_view->priv->vadjustment != vadj))
4251 gtk_signal_disconnect_by_data (GTK_OBJECT (tree_view->priv->vadjustment), tree_view);
4252 gtk_object_unref (GTK_OBJECT (tree_view->priv->vadjustment));
4255 if (tree_view->priv->hadjustment != hadj)
4257 tree_view->priv->hadjustment = hadj;
4258 gtk_object_ref (GTK_OBJECT (tree_view->priv->hadjustment));
4259 gtk_object_sink (GTK_OBJECT (tree_view->priv->hadjustment));
4261 gtk_signal_connect (GTK_OBJECT (tree_view->priv->hadjustment), "value_changed",
4262 (GtkSignalFunc) gtk_tree_view_adjustment_changed,
4267 if (tree_view->priv->vadjustment != vadj)
4269 tree_view->priv->vadjustment = vadj;
4270 gtk_object_ref (GTK_OBJECT (tree_view->priv->vadjustment));
4271 gtk_object_sink (GTK_OBJECT (tree_view->priv->vadjustment));
4273 gtk_signal_connect (GTK_OBJECT (tree_view->priv->vadjustment), "value_changed",
4274 (GtkSignalFunc) gtk_tree_view_adjustment_changed,
4280 gtk_tree_view_adjustment_changed (NULL, tree_view);
4285 gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
4286 GtkMovementStep step,
4289 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
4290 g_return_if_fail (step == GTK_MOVEMENT_LOGICAL_POSITIONS ||
4291 step == GTK_MOVEMENT_VISUAL_POSITIONS ||
4292 step == GTK_MOVEMENT_DISPLAY_LINES ||
4293 step == GTK_MOVEMENT_PAGES ||
4294 step == GTK_MOVEMENT_BUFFER_ENDS);
4296 if (tree_view->priv->tree == NULL)
4298 gtk_tree_view_stop_editing (tree_view);
4299 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
4300 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
4304 /* currently we make no distinction. When we go bi-di, we need to */
4305 case GTK_MOVEMENT_LOGICAL_POSITIONS:
4306 case GTK_MOVEMENT_VISUAL_POSITIONS:
4307 gtk_tree_view_move_cursor_left_right (tree_view, count);
4309 case GTK_MOVEMENT_DISPLAY_LINES:
4310 gtk_tree_view_move_cursor_up_down (tree_view, count);
4312 case GTK_MOVEMENT_PAGES:
4313 gtk_tree_view_move_cursor_page_up_down (tree_view, count);
4315 case GTK_MOVEMENT_BUFFER_ENDS:
4316 gtk_tree_view_move_cursor_start_end (tree_view, count);
4319 g_assert_not_reached ();
4324 gtk_tree_view_put (GtkTreeView *tree_view,
4325 GtkWidget *child_widget,
4331 GtkTreeViewChild *child;
4333 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
4334 g_return_if_fail (GTK_IS_WIDGET (child_widget));
4336 child = g_new (GtkTreeViewChild, 1);
4338 child->widget = child_widget;
4341 child->width = width;
4342 child->height = height;
4344 tree_view->priv->children = g_list_append (tree_view->priv->children, child);
4346 if (GTK_WIDGET_REALIZED (tree_view))
4347 gtk_widget_set_parent_window (child->widget, tree_view->priv->bin_window);
4349 gtk_widget_set_parent (child_widget, GTK_WIDGET (tree_view));
4353 _gtk_tree_view_child_move_resize (GtkTreeView *tree_view,
4360 GtkTreeViewChild *child = NULL;
4362 GdkRectangle allocation;
4364 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
4365 g_return_if_fail (GTK_IS_WIDGET (widget));
4367 for (list = tree_view->priv->children; list; list = list->next)
4369 if (((GtkTreeViewChild *)list->data)->widget == widget)
4378 allocation.x = child->x = x;
4379 allocation.y = child->y = y;
4380 allocation.width = child->width = width;
4381 allocation.height = child->height = height;
4383 if (GTK_WIDGET_REALIZED (widget))
4384 gtk_widget_size_allocate (widget, &allocation);
4388 /* TreeModel Callbacks
4392 gtk_tree_view_row_changed (GtkTreeModel *model,
4397 GtkTreeView *tree_view = (GtkTreeView *)data;
4401 gboolean dirty_marked;
4402 gboolean free_path = FALSE;
4403 gint vertical_separator;
4406 g_return_if_fail (path != NULL || iter != NULL);
4408 gtk_widget_style_get (GTK_WIDGET (data), "vertical_separator", &vertical_separator, NULL);
4412 path = gtk_tree_model_get_path (model, iter);
4415 else if (iter == NULL)
4416 gtk_tree_model_get_iter (model, iter, path);
4418 if (_gtk_tree_view_find_node (tree_view,
4422 /* We aren't actually showing the node */
4428 dirty_marked = gtk_tree_view_discover_dirty_iter (tree_view,
4430 gtk_tree_path_get_depth (path),
4435 GTK_RBNODE_GET_HEIGHT (node) != height + vertical_separator)
4437 _gtk_rbtree_node_set_height (tree, node, height + vertical_separator);
4438 gtk_widget_queue_resize (GTK_WIDGET (data));
4439 _gtk_tree_view_update_size (tree_view);
4444 gtk_widget_queue_resize (GTK_WIDGET (data));
4448 gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
4453 gtk_tree_path_free (path);
4457 gtk_tree_view_row_inserted (GtkTreeModel *model,
4462 GtkTreeView *tree_view = (GtkTreeView *) data;
4464 GtkRBTree *tmptree, *tree;
4465 GtkRBNode *tmpnode = NULL;
4469 gboolean free_path = FALSE;
4471 if (tree_view->priv->tree == NULL)
4472 tree_view->priv->tree = _gtk_rbtree_new ();
4474 tmptree = tree = tree_view->priv->tree;
4475 g_return_if_fail (path != NULL || iter != NULL);
4479 path = gtk_tree_model_get_path (model, iter);
4482 else if (iter == NULL)
4483 gtk_tree_model_get_iter (model, iter, path);
4485 /* Update all row-references */
4486 gtk_tree_row_reference_inserted (G_OBJECT (data), path);
4487 depth = gtk_tree_path_get_depth (path);
4488 indices = gtk_tree_path_get_indices (path);
4490 /* First, find the parent tree */
4491 while (i < depth - 1)
4493 if (tmptree == NULL)
4495 /* We aren't showing the node */
4499 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
4500 if (tmpnode == NULL)
4502 g_warning ("A node was inserted with a parent that's not in the tree.\n" \
4503 "This possibly means that a GtkTreeModel inserted a child node\n" \
4504 "before the parent was inserted.");
4507 else if (!GTK_RBNODE_FLAG_SET (tmpnode, GTK_RBNODE_IS_PARENT))
4509 /* FIXME enforce correct behavior on model, probably */
4510 /* In theory, the model should have emitted has_child_toggled here. We
4511 * try to catch it anyway, just to be safe, in case the model hasn't.
4513 GtkTreePath *tmppath = _gtk_tree_view_find_path (tree_view,
4516 gtk_tree_view_row_has_child_toggled (model, tmppath, NULL, data);
4517 gtk_tree_path_free (tmppath);
4521 tmptree = tmpnode->children;
4530 gtk_tree_model_ref_node (tree_view->priv->model, iter);
4531 max_height = gtk_tree_view_insert_iter_height (tree_view,
4535 if (indices[depth - 1] == 0)
4537 tmpnode = _gtk_rbtree_find_count (tree, 1);
4538 _gtk_rbtree_insert_before (tree, tmpnode, max_height);
4542 tmpnode = _gtk_rbtree_find_count (tree, indices[depth - 1]);
4543 _gtk_rbtree_insert_after (tree, tmpnode, max_height);
4546 _gtk_tree_view_update_size (tree_view);
4550 gtk_tree_path_free (path);
4552 #include "gtktreemodelsort.h"
4554 gtk_tree_view_row_has_child_toggled (GtkTreeModel *model,
4559 GtkTreeView *tree_view = (GtkTreeView *)data;
4560 GtkTreeIter real_iter;
4564 gboolean free_path = FALSE;
4566 g_return_if_fail (path != NULL || iter != NULL);
4573 path = gtk_tree_model_get_path (model, iter);
4576 else if (iter == NULL)
4577 gtk_tree_model_get_iter (model, &real_iter, path);
4579 if (_gtk_tree_view_find_node (tree_view,
4583 /* We aren't actually showing the node */
4589 has_child = gtk_tree_model_iter_has_child (model, &real_iter);
4592 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT) == has_child)
4596 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PARENT);
4598 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_PARENT);
4600 if (has_child && GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST))
4602 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
4603 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS))
4607 for (list = tree_view->priv->columns; list; list = list->next)
4608 if (GTK_TREE_VIEW_COLUMN (list->data)->visible)
4610 GTK_TREE_VIEW_COLUMN (list->data)->dirty = TRUE;
4611 gtk_tree_view_column_cell_set_dirty (GTK_TREE_VIEW_COLUMN (list->data));
4615 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
4619 /* FIXME: Just redraw the node */
4620 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
4625 gtk_tree_path_free (path);
4629 count_children_helper (GtkRBTree *tree,
4634 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, data);
4635 (*((gint *)data))++;
4639 gtk_tree_view_row_deleted (GtkTreeModel *model,
4643 GtkTreeView *tree_view = (GtkTreeView *)data;
4647 gint selection_changed;
4649 g_return_if_fail (path != NULL);
4651 gtk_tree_row_reference_deleted (G_OBJECT (data), path);
4653 if (_gtk_tree_view_find_node (tree_view, path, &tree, &node))
4659 /* Change the selection */
4660 selection_changed = GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED);
4662 for (list = tree_view->priv->columns; list; list = list->next)
4663 if (((GtkTreeViewColumn *)list->data)->visible &&
4664 ((GtkTreeViewColumn *)list->data)->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
4665 gtk_tree_view_column_cell_set_dirty ((GtkTreeViewColumn *)list->data);
4667 /* Ensure we don't have a dangling pointer to a dead node */
4668 ensure_unprelighted (tree_view);
4670 /* If we have a node expanded/collapsed timeout, remove it */
4671 if (tree_view->priv->expand_collapse_timeout != 0)
4673 gtk_timeout_remove (tree_view->priv->expand_collapse_timeout);
4674 tree_view->priv->expand_collapse_timeout = 0;
4677 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_COLLAPSED);
4678 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_EXPANDED);
4679 tree_view->priv->expanded_collapsed_node = NULL;
4682 if (tree_view->priv->destroy_count_func)
4684 gint child_count = 0;
4686 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, &child_count);
4687 (* tree_view->priv->destroy_count_func) (tree_view, path, child_count, tree_view->priv->destroy_count_data);
4690 if (tree->root->count == 1)
4692 if (tree_view->priv->tree == tree)
4693 tree_view->priv->tree = NULL;
4695 _gtk_rbtree_remove (tree);
4699 _gtk_rbtree_remove_node (tree, node);
4702 _gtk_tree_view_update_size (GTK_TREE_VIEW (data));
4704 if (selection_changed)
4705 g_signal_emit_by_name (G_OBJECT (tree_view->priv->selection), "changed");
4710 gtk_tree_view_rows_reordered (GtkTreeModel *model,
4711 GtkTreePath *parent,
4716 GtkTreeView *tree_view = GTK_TREE_VIEW (data);
4721 len = gtk_tree_model_iter_n_children (model, iter);
4726 gtk_tree_row_reference_reordered (G_OBJECT (data),
4731 if (_gtk_tree_view_find_node (tree_view,
4737 /* We need to special case the parent path */
4739 tree = tree_view->priv->tree;
4741 tree = node->children;
4746 /* FIXME: we need to unprelight our tree, if it's prelit. */
4747 _gtk_rbtree_reorder (tree, new_order, len);
4749 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
4753 /* Internal tree functions
4758 gtk_tree_view_get_background_xrange (GtkTreeView *tree_view,
4760 GtkTreeViewColumn *column,
4764 GtkTreeViewColumn *tmp_column = NULL;
4775 for (list = tree_view->priv->columns; list; list = list->next)
4777 tmp_column = list->data;
4779 if (tmp_column == column)
4782 if (tmp_column->visible)
4783 total_width += tmp_column->width;
4786 if (tmp_column != column)
4788 g_warning (G_STRLOC": passed-in column isn't in the tree");
4797 if (column->visible)
4798 *x2 = total_width + column->width;
4800 *x2 = total_width; /* width of 0 */
4804 gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
4811 GtkTreeViewColumn *tmp_column = NULL;
4813 gboolean indent_expanders;
4816 for (list = tree_view->priv->columns; list; list = list->next)
4818 tmp_column = list->data;
4820 if (gtk_tree_view_is_expander_column (tree_view, tmp_column))
4822 x_offset = total_width;
4826 if (tmp_column->visible)
4827 total_width += tmp_column->width;
4830 gtk_widget_style_get (GTK_WIDGET (tree_view),
4831 "indent_expanders", &indent_expanders,
4834 if (indent_expanders)
4835 x_offset += tree_view->priv->tab_offset * _gtk_rbtree_get_depth (tree);
4840 if (tmp_column && tmp_column->visible)
4842 /* +1 because x2 isn't included in the range. */
4844 *x2 = x_offset + tree_view->priv->tab_offset + 1;
4848 /* return an empty range, the expander column is hidden */
4855 gtk_tree_view_insert_iter_height (GtkTreeView *tree_view,
4860 GtkTreeViewColumn *column;
4862 gint max_height = 0;
4863 gint vertical_separator;
4865 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical_separator", &vertical_separator, NULL);
4867 /* do stuff with node */
4868 for (list = tree_view->priv->columns; list; list = list->next)
4870 gint height = 0, width = 0;
4871 column = list->data;
4873 if (!column->visible)
4876 if (column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
4879 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter,
4880 gtk_tree_model_iter_has_child (tree_view->priv->model, iter),
4883 gtk_tree_view_column_cell_get_size (column, NULL, NULL, NULL, &width, &height);
4884 max_height = MAX (max_height, vertical_separator + height);
4886 if (gtk_tree_view_is_expander_column (tree_view, column) &&
4887 TREE_VIEW_DRAW_EXPANDERS (tree_view))
4888 _gtk_tree_view_column_set_width (column,
4889 MAX (column->width, depth * tree_view->priv->tab_offset + width));
4891 _gtk_tree_view_column_set_width (column,
4892 MAX (column->width, width));
4898 gtk_tree_view_build_tree (GtkTreeView *tree_view,
4903 gboolean calc_bounds)
4905 GtkRBNode *temp = NULL;
4912 max_height = gtk_tree_view_insert_iter_height (tree_view,
4917 gtk_tree_model_ref_node (tree_view->priv->model, iter);
4918 temp = _gtk_rbtree_insert_after (tree, temp, max_height);
4923 if (gtk_tree_model_iter_children (tree_view->priv->model, &child, iter))
4925 temp->children = _gtk_rbtree_new ();
4926 temp->children->parent_tree = tree;
4927 temp->children->parent_node = temp;
4928 gtk_tree_view_build_tree (tree_view, temp->children, &child, depth + 1, recurse, calc_bounds);
4931 if (gtk_tree_model_iter_has_child (tree_view->priv->model, iter))
4933 if ((temp->flags>K_RBNODE_IS_PARENT) != GTK_RBNODE_IS_PARENT)
4934 temp->flags ^= GTK_RBNODE_IS_PARENT;
4935 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
4938 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
4942 gtk_tree_view_calc_size (GtkTreeView *tree_view,
4950 GtkTreeViewColumn *column;
4952 gint vertical_separator;
4953 gint horizontal_separator;
4954 TREE_VIEW_INTERNAL_ASSERT_VOID (tree != NULL);
4956 gtk_widget_style_get (GTK_WIDGET (tree_view),
4957 "vertical_separator", &vertical_separator,
4958 "horizontal_separator", &horizontal_separator,
4962 while (temp->left != tree->nil)
4968 /* Do stuff with node */
4969 for (list = tree_view->priv->columns; list; list = list->next)
4971 gint height = 0, width = 0;
4972 column = list->data;
4974 if (!column->visible)
4977 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter,
4978 GTK_RBNODE_FLAG_SET (temp, GTK_RBNODE_IS_PARENT),
4979 temp->children?TRUE:FALSE);
4980 gtk_tree_view_column_cell_get_size (column, NULL, NULL, NULL, &width, &height);
4981 max_height = MAX (max_height, vertical_separator + height);
4983 /* FIXME: I'm getting the width of all nodes here. )-: */
4984 if (column->dirty == FALSE)
4987 if (column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
4991 if (gtk_tree_view_is_expander_column (tree_view, column) &&
4992 TREE_VIEW_DRAW_EXPANDERS (tree_view))
4993 _gtk_tree_view_column_set_width (column,
4994 MAX (column->width, depth * tree_view->priv->tab_offset + width + horizontal_separator));
4996 _gtk_tree_view_column_set_width (column, MAX (column->width, width + horizontal_separator));
4999 _gtk_rbtree_node_set_height (tree, temp, max_height);
5001 if (temp->children != NULL &&
5002 gtk_tree_model_iter_children (tree_view->priv->model, &child, iter))
5003 gtk_tree_view_calc_size (tree_view, temp->children, &child, depth + 1);
5004 temp = _gtk_rbtree_next (tree, temp);
5006 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
5009 /* If height is non-NULL, then we set it to be the new height. if it's all
5010 * dirty, then height is -1. We know we'll remeasure dirty rows, anyways.
5013 gtk_tree_view_discover_dirty_iter (GtkTreeView *tree_view,
5019 GtkTreeViewColumn *column;
5021 gboolean retval = FALSE;
5023 gint horizontal_separator;
5025 gtk_widget_style_get (GTK_WIDGET (tree_view),
5026 "horizontal_separator", &horizontal_separator,
5033 for (list = tree_view->priv->columns; list; list = list->next)
5036 column = list->data;
5037 if (column->dirty == TRUE)
5039 if (height == NULL && column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
5041 if (!column->visible)
5044 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter,
5045 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
5046 node->children?TRUE:FALSE);
5050 gtk_tree_view_column_cell_get_size (column,
5052 &width, &tmpheight);
5053 *height = MAX (*height, tmpheight);
5057 gtk_tree_view_column_cell_get_size (column,
5062 if (gtk_tree_view_is_expander_column (tree_view, column) &&
5063 TREE_VIEW_DRAW_EXPANDERS (tree_view))
5065 if (depth * tree_view->priv->tab_offset + horizontal_separator + width > column->requested_width)
5067 gtk_tree_view_column_cell_set_dirty (column);
5073 if (horizontal_separator + width > column->requested_width)
5075 gtk_tree_view_column_cell_set_dirty (column);
5085 gtk_tree_view_discover_dirty (GtkTreeView *tree_view,
5090 GtkRBNode *temp = tree->root;
5091 GtkTreeViewColumn *column;
5094 gboolean is_all_dirty;
5096 TREE_VIEW_INTERNAL_ASSERT_VOID (tree != NULL);
5098 while (temp->left != tree->nil)
5103 TREE_VIEW_INTERNAL_ASSERT_VOID (temp != NULL);
5104 is_all_dirty = TRUE;
5105 for (list = tree_view->priv->columns; list; list = list->next)
5107 column = list->data;
5108 if (column->dirty == FALSE)
5110 is_all_dirty = FALSE;
5118 gtk_tree_view_discover_dirty_iter (tree_view,
5123 if (gtk_tree_model_iter_children (tree_view->priv->model, &child, iter) &&
5124 temp->children != NULL)
5125 gtk_tree_view_discover_dirty (tree_view, temp->children, &child, depth + 1);
5126 temp = _gtk_rbtree_next (tree, temp);
5128 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
5133 * gtk_tree_view_check_dirty_and_clean:
5134 * @tree_view: A #GtkTreeView
5136 * Does all the actual sizing for
5139 gtk_tree_view_check_dirty_and_clean (GtkTreeView *tree_view)
5142 gboolean dirty = FALSE;
5144 GtkTreeViewColumn *column;
5147 for (list = tree_view->priv->columns; list; list = list->next)
5149 column = list->data;
5153 if (column->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
5158 w = MAX (w, column->button->requisition.width);
5160 _gtk_tree_view_column_set_width (column, w);
5168 if (tree_view->priv->model == NULL)
5171 path = gtk_tree_path_new_root ();
5172 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, path))
5174 gtk_tree_view_calc_size (tree_view, tree_view->priv->tree, &iter, 1);
5175 _gtk_tree_view_update_size (tree_view);
5178 gtk_tree_path_free (path);
5180 for (list = tree_view->priv->columns; list; list = list->next)
5182 column = list->data;
5183 column->dirty = FALSE;
5187 /* Make sure the node is visible vertically */
5189 gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
5195 /* We process updates because we want to clear old selected items when we scroll.
5196 * if this is removed, we get a "selection streak" at the bottom. */
5197 if (GTK_WIDGET_REALIZED (tree_view))
5198 gdk_window_process_updates (tree_view->priv->bin_window, TRUE);
5200 offset = _gtk_rbtree_node_find_offset (tree, node);
5202 /* we reverse the order, b/c in the unusual case of the
5203 * node's height being taller then the visible area, we'd rather
5204 * have the node flush to the top
5206 if (offset + GTK_RBNODE_GET_HEIGHT (node) >
5207 tree_view->priv->vadjustment->value + tree_view->priv->vadjustment->page_size)
5208 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment),
5209 offset + GTK_RBNODE_GET_HEIGHT (node) -
5210 tree_view->priv->vadjustment->page_size);
5211 if (offset < tree_view->priv->vadjustment->value)
5212 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment),
5218 gtk_tree_view_clamp_column_visible (GtkTreeView *tree_view,
5219 GtkTreeViewColumn *column)
5223 if ((tree_view->priv->hadjustment->value + tree_view->priv->hadjustment->page_size) <
5224 (column->button->allocation.x + column->button->allocation.width))
5225 gtk_adjustment_set_value (tree_view->priv->hadjustment,
5226 column->button->allocation.x + column->button->allocation.width -
5227 tree_view->priv->hadjustment->page_size);
5228 else if (tree_view->priv->hadjustment->value > column->button->allocation.x)
5229 gtk_adjustment_set_value (tree_view->priv->hadjustment,
5230 column->button->allocation.x);
5233 /* This function could be more efficient. I'll optimize it if profiling seems
5234 * to imply that it is important */
5236 _gtk_tree_view_find_path (GtkTreeView *tree_view,
5241 GtkRBTree *tmp_tree;
5242 GtkRBNode *tmp_node, *last;
5245 path = gtk_tree_path_new ();
5247 g_return_val_if_fail (node != NULL, path);
5248 g_return_val_if_fail (node != tree->nil, path);
5250 count = 1 + node->left->count;
5253 tmp_node = node->parent;
5257 while (tmp_node != tmp_tree->nil)
5259 if (tmp_node->right == last)
5260 count += 1 + tmp_node->left->count;
5262 tmp_node = tmp_node->parent;
5264 gtk_tree_path_prepend_index (path, count - 1);
5265 last = tmp_tree->parent_node;
5266 tmp_tree = tmp_tree->parent_tree;
5269 count = 1 + last->left->count;
5270 tmp_node = last->parent;
5276 /* Returns TRUE if we ran out of tree before finding the path. If the path is
5277 * invalid (ie. points to a node that's not in the tree), *tree and *node are
5281 _gtk_tree_view_find_node (GtkTreeView *tree_view,
5286 GtkRBNode *tmpnode = NULL;
5287 GtkRBTree *tmptree = tree_view->priv->tree;
5288 gint *indices = gtk_tree_path_get_indices (path);
5289 gint depth = gtk_tree_path_get_depth (path);
5295 if (depth == 0 || tmptree == NULL)
5299 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
5301 if (tmpnode == NULL)
5315 tmptree = tmpnode->children;
5316 if (tmptree == NULL)
5323 gtk_tree_view_is_expander_column (GtkTreeView *tree_view,
5324 GtkTreeViewColumn *column)
5328 if (tree_view->priv->expander_column != NULL)
5330 if (tree_view->priv->expander_column == column)
5336 for (list = tree_view->priv->columns; list; list = list->next)
5337 if (((GtkTreeViewColumn *)list->data)->visible)
5339 if (list && list->data == column)
5346 gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
5349 GtkMovementStep step,
5353 gtk_binding_entry_add_signal (binding_set, keyval, modmask,
5355 GTK_TYPE_ENUM, step,
5356 GTK_TYPE_INT, count);
5358 gtk_binding_entry_add_signal (binding_set, keyval, GDK_SHIFT_MASK,
5360 GTK_TYPE_ENUM, step,
5361 GTK_TYPE_INT, count);
5363 if ((modmask & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
5366 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK | GDK_SHIFT_MASK,
5368 GTK_TYPE_ENUM, step,
5369 GTK_TYPE_INT, count);
5371 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK,
5373 GTK_TYPE_ENUM, step,
5374 GTK_TYPE_INT, count);
5378 gtk_tree_view_unref_tree_helper (GtkTreeModel *model,
5383 gint retval = FALSE;
5386 g_return_val_if_fail (node != NULL, FALSE);
5391 GtkRBTree *new_tree;
5392 GtkRBNode *new_node;
5394 new_tree = node->children;
5395 new_node = new_tree->root;
5397 while (new_node && new_node->left != new_tree->nil)
5398 new_node = new_node->left;
5400 g_return_val_if_fail (gtk_tree_model_iter_children (model, &child, iter), FALSE);
5401 retval = retval || gtk_tree_view_unref_tree_helper (model, &child, new_tree, new_node);
5404 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
5406 gtk_tree_model_unref_node (model, iter);
5407 node = _gtk_rbtree_next (tree, node);
5409 while (gtk_tree_model_iter_next (model, iter));
5415 gtk_tree_view_unref_and_check_selection_tree (GtkTreeView *tree_view,
5427 while (node && node->left != tree->nil)
5430 g_return_val_if_fail (node != NULL, FALSE);
5431 path = _gtk_tree_view_find_path (tree_view, tree, node);
5432 gtk_tree_model_get_iter (GTK_TREE_MODEL (tree_view->priv->model),
5434 retval = gtk_tree_view_unref_tree_helper (GTK_TREE_MODEL (tree_view->priv->model), &iter, tree, node);
5435 gtk_tree_path_free (path);
5441 gtk_tree_view_set_column_drag_info (GtkTreeView *tree_view,
5442 GtkTreeViewColumn *column)
5444 GtkTreeViewColumn *left_column;
5445 GtkTreeViewColumn *cur_column = NULL;
5446 GtkTreeViewColumnReorder *reorder;
5451 /* We want to precalculate the motion list such that we know what column slots
5456 /* First, identify all possible drop spots */
5457 tmp_list = tree_view->priv->columns;
5461 g_assert (tmp_list);
5463 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5464 tmp_list = tmp_list->next;
5466 if (cur_column->visible == FALSE)
5469 /* If it's not the column moving and func tells us to skip over the column, we continue. */
5470 if (left_column != column && cur_column != column &&
5471 tree_view->priv->column_drop_func &&
5472 ! (* tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5474 left_column = cur_column;
5477 reorder = g_new (GtkTreeViewColumnReorder, 1);
5478 reorder->left_column = left_column;
5479 left_column = reorder->right_column = cur_column;
5481 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
5484 /* Add the last one */
5485 if (tree_view->priv->column_drop_func == NULL ||
5486 ((left_column != column) &&
5487 (* tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data)))
5489 reorder = g_new (GtkTreeViewColumnReorder, 1);
5490 reorder->left_column = left_column;
5491 reorder->right_column = NULL;
5492 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
5495 /* We quickly check to see if it even makes sense to reorder columns. */
5496 /* If there is nothing that can be moved, then we return */
5498 if (tree_view->priv->column_drag_info == NULL)
5501 /* We know there are always 2 slots possbile, as you can always return column. */
5502 /* If that's all there is, return */
5503 if (tree_view->priv->column_drag_info->next->next == NULL &&
5504 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->data)->right_column == column &&
5505 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->next->data)->left_column == column)
5507 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
5508 g_free (tmp_list->data);
5509 g_list_free (tree_view->priv->column_drag_info);
5510 tree_view->priv->column_drag_info = NULL;
5513 /* We fill in the ranges for the columns, now that we've isolated them */
5514 left = - TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
5516 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
5518 reorder = (GtkTreeViewColumnReorder *) tmp_list->data;
5520 reorder->left_align = left;
5521 if (tmp_list->next != NULL)
5523 g_assert (tmp_list->next->data);
5524 left = reorder->right_align = (reorder->right_column->button->allocation.x +
5525 reorder->right_column->button->allocation.width +
5526 ((GtkTreeViewColumnReorder *)tmp_list->next->data)->left_column->button->allocation.x)/2;
5532 gdk_window_get_size (tree_view->priv->header_window, &width, NULL);
5533 reorder->right_align = width + TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
5539 _gtk_tree_view_column_start_drag (GtkTreeView *tree_view,
5540 GtkTreeViewColumn *column)
5542 GdkEvent send_event;
5543 GtkAllocation allocation;
5544 gint x, y, width, height;
5546 g_return_if_fail (tree_view->priv->column_drag_info == NULL);
5548 gtk_tree_view_set_column_drag_info (tree_view, column);
5550 if (tree_view->priv->column_drag_info == NULL)
5553 if (tree_view->priv->drag_window == NULL)
5555 GdkWindowAttr attributes;
5556 guint attributes_mask;
5558 attributes.window_type = GDK_WINDOW_CHILD;
5559 attributes.wclass = GDK_INPUT_OUTPUT;
5560 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
5561 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
5562 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
5563 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
5565 tree_view->priv->drag_window = gdk_window_new (tree_view->priv->bin_window,
5568 gdk_window_set_user_data (tree_view->priv->drag_window, GTK_WIDGET (tree_view));
5571 gdk_pointer_ungrab (GDK_CURRENT_TIME);
5572 gdk_keyboard_ungrab (GDK_CURRENT_TIME);
5574 gtk_grab_remove (column->button);
5576 send_event.crossing.type = GDK_LEAVE_NOTIFY;
5577 send_event.crossing.send_event = TRUE;
5578 send_event.crossing.window = column->button->window;
5579 send_event.crossing.subwindow = NULL;
5580 send_event.crossing.detail = GDK_NOTIFY_ANCESTOR;
5581 send_event.crossing.time = GDK_CURRENT_TIME;
5583 gtk_propagate_event (column->button, &send_event);
5585 send_event.button.type = GDK_BUTTON_RELEASE;
5586 send_event.button.window = GDK_ROOT_PARENT ();
5587 send_event.button.send_event = TRUE;
5588 send_event.button.time = GDK_CURRENT_TIME;
5589 send_event.button.x = -1;
5590 send_event.button.y = -1;
5591 send_event.button.axes = NULL;
5592 send_event.button.state = 0;
5593 send_event.button.button = 1;
5594 send_event.button.device = gdk_device_get_core_pointer ();
5595 send_event.button.x_root = 0;
5596 send_event.button.y_root = 0;
5598 gtk_propagate_event (column->button, &send_event);
5600 gdk_window_move_resize (tree_view->priv->drag_window,
5601 column->button->allocation.x,
5602 column->button->allocation.y + column->button->allocation.height,
5603 column->button->allocation.width,
5604 column->button->allocation.height);
5605 gdk_window_reparent (column->button->window, tree_view->priv->drag_window, 0, 0);
5606 tree_view->priv->drag_column_x = column->button->allocation.x;
5607 allocation = column->button->allocation;
5609 gtk_widget_size_allocate (column->button, &allocation);
5610 gtk_widget_set_parent_window (column->button, tree_view->priv->drag_window);
5612 tree_view->priv->drag_column = column;
5613 gdk_window_show (tree_view->priv->drag_window);
5615 gdk_window_get_origin (tree_view->priv->header_window, &x, &y);
5616 gdk_window_get_size (tree_view->priv->header_window, &width, &height);
5618 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5619 while (gtk_events_pending ())
5620 gtk_main_iteration ();
5622 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
5623 gdk_pointer_grab (tree_view->priv->drag_window,
5625 GDK_POINTER_MOTION_MASK|GDK_BUTTON_RELEASE_MASK,
5626 NULL, NULL, GDK_CURRENT_TIME);
5627 gdk_keyboard_grab (tree_view->priv->drag_window,
5634 gtk_tree_view_queue_draw_arrow (GtkTreeView *tree_view,
5637 GdkRectangle *clip_rect)
5641 if (!GTK_WIDGET_REALIZED (tree_view))
5645 rect.width = MAX (tree_view->priv->tab_offset, GTK_WIDGET (tree_view)->allocation.width);
5647 rect.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
5648 rect.height = BACKGROUND_HEIGHT (node);
5652 GdkRectangle new_rect;
5654 gdk_rectangle_intersect (clip_rect, &rect, &new_rect);
5656 gdk_window_invalidate_rect (tree_view->priv->bin_window, &new_rect, TRUE);
5660 gdk_window_invalidate_rect (tree_view->priv->bin_window, &rect, TRUE);
5665 gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
5668 GdkRectangle *clip_rect)
5672 if (!GTK_WIDGET_REALIZED (tree_view))
5676 rect.width = MAX (tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.width);
5678 rect.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
5679 rect.height = BACKGROUND_HEIGHT (node);
5683 GdkRectangle new_rect;
5685 gdk_rectangle_intersect (clip_rect, &rect, &new_rect);
5687 gdk_window_invalidate_rect (tree_view->priv->bin_window, &new_rect, TRUE);
5691 gdk_window_invalidate_rect (tree_view->priv->bin_window, &rect, TRUE);
5696 gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
5698 GdkRectangle *clip_rect)
5700 GtkRBTree *tree = NULL;
5701 GtkRBNode *node = NULL;
5703 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
5706 gtk_tree_view_queue_draw_node (tree_view, tree, node, clip_rect);
5709 /* x and y are the mouse position
5712 gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
5722 gint vertical_separator;
5724 GtkExpanderStyle expander_style;
5726 gtk_widget_style_get (GTK_WIDGET (tree_view),
5727 "vertical_separator", &vertical_separator,
5728 "expander_size", &expander_size,
5731 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
5734 widget = GTK_WIDGET (tree_view);
5736 gtk_tree_view_get_arrow_xrange (tree_view, tree, &x_offset, NULL);
5739 area.y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
5740 area.width = expander_size + 2;
5741 area.height = CELL_HEIGHT (node, vertical_separator);
5743 if (node == tree_view->priv->button_pressed_node)
5745 if (x >= area.x && x <= (area.x + area.width) &&
5746 y >= area.y && y <= (area.y + area.height))
5747 state = GTK_STATE_ACTIVE;
5749 state = GTK_STATE_NORMAL;
5753 if (node == tree_view->priv->prelight_node &&
5754 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
5755 state = GTK_STATE_PRELIGHT;
5757 state = GTK_STATE_NORMAL;
5760 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
5761 expander_style = GTK_EXPANDER_SEMI_EXPANDED;
5762 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
5763 expander_style = GTK_EXPANDER_SEMI_COLLAPSED;
5764 else if (node->children != NULL)
5765 expander_style = GTK_EXPANDER_EXPANDED;
5767 expander_style = GTK_EXPANDER_COLLAPSED;
5769 gtk_paint_expander (widget->style,
5770 tree_view->priv->bin_window,
5775 area.x + area.width / 2,
5776 area.y + area.height / 2,
5782 _gtk_tree_view_update_col_width (GtkTreeView *tree_view)
5784 GList *list, *last_column;
5785 GtkTreeViewColumn *column;
5788 for (last_column = g_list_last (tree_view->priv->columns);
5790 !(GTK_TREE_VIEW_COLUMN (last_column->data)->visible) &&
5791 GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (last_column->data)->button);
5792 last_column = last_column->prev)
5795 if (last_column == NULL)
5798 for (list = tree_view->priv->columns; list != last_column; list = list->next)
5800 column = GTK_TREE_VIEW_COLUMN (list->data);
5801 if (! column->visible)
5804 width += column->width;
5805 column->width = (CLAMP (column->width, (column->min_width!=-1)?column->min_width:column->width, (column->max_width!=-1)?column->max_width:column->width));
5807 column = GTK_TREE_VIEW_COLUMN (last_column->data);
5808 column->width = MAX (GTK_WIDGET (tree_view)->allocation.width, tree_view->priv->width) - width;
5812 gtk_tree_view_focus_to_cursor (GtkTreeView *tree_view)
5815 GtkTreePath *cursor_path;
5817 if ((tree_view->priv->tree == NULL) ||
5818 (! GTK_WIDGET_REALIZED (tree_view)))
5821 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
5822 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5825 if (tree_view->priv->cursor)
5826 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5828 if (cursor_path == NULL)
5830 cursor_path = gtk_tree_path_new_root ();
5831 gtk_tree_row_reference_free (tree_view->priv->cursor);
5832 tree_view->priv->cursor = NULL;
5834 if (tree_view->priv->selection->type == GTK_SELECTION_MULTIPLE)
5835 gtk_tree_view_real_set_cursor (tree_view, cursor_path, FALSE);
5837 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE);
5839 gtk_tree_path_free (cursor_path);
5840 if (tree_view->priv->focus_column == NULL)
5843 for (list = tree_view->priv->columns; list; list = list->next)
5845 if (GTK_TREE_VIEW_COLUMN (list->data)->visible)
5847 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (list->data);
5855 gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
5858 GtkRBTree *cursor_tree = NULL;
5859 GtkRBNode *cursor_node = NULL;
5860 GtkRBTree *new_cursor_tree = NULL;
5861 GtkRBNode *new_cursor_node = NULL;
5862 GtkTreePath *cursor_path = NULL;
5865 if (!gtk_tree_row_reference_valid (tree_view->priv->cursor))
5866 /* FIXME: we lost the cursor; should we get the first? */
5869 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5870 _gtk_tree_view_find_node (tree_view, cursor_path,
5871 &cursor_tree, &cursor_node);
5872 gtk_tree_path_free (cursor_path);
5874 if (cursor_tree == NULL)
5875 /* FIXME: we lost the cursor; should we get the first? */
5878 _gtk_rbtree_prev_full (cursor_tree, cursor_node,
5879 &new_cursor_tree, &new_cursor_node);
5881 _gtk_rbtree_next_full (cursor_tree, cursor_node,
5882 &new_cursor_tree, &new_cursor_node);
5884 if (new_cursor_node)
5886 cursor_path = _gtk_tree_view_find_path (tree_view, new_cursor_tree, new_cursor_node);
5887 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE);
5888 gtk_tree_path_free (cursor_path);
5892 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
5895 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5899 gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
5902 GtkRBTree *cursor_tree = NULL;
5903 GtkRBNode *cursor_node = NULL;
5904 GtkTreePath *cursor_path = NULL;
5906 gint vertical_separator;
5908 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
5909 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5911 /* This is sorta weird. Focus in should give us a cursor */
5914 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical_separator", &vertical_separator, NULL);
5915 _gtk_tree_view_find_node (tree_view, cursor_path,
5916 &cursor_tree, &cursor_node);
5918 gtk_tree_path_free (cursor_path);
5920 if (cursor_tree == NULL)
5921 /* FIXME: we lost the cursor. Should we try to get one? */
5923 g_return_if_fail (cursor_node != NULL);
5925 y = CELL_FIRST_PIXEL (tree_view, cursor_tree, cursor_node, vertical_separator);
5926 y += count * tree_view->priv->vadjustment->page_size;
5927 y = CLAMP (y, (gint)tree_view->priv->vadjustment->lower, (gint)tree_view->priv->vadjustment->upper - vertical_separator);
5929 _gtk_rbtree_find_offset (tree_view->priv->tree, y, &cursor_tree, &cursor_node);
5930 cursor_path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
5931 g_return_if_fail (cursor_path != NULL);
5932 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE);
5936 gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
5939 GtkRBTree *cursor_tree = NULL;
5940 GtkRBNode *cursor_node = NULL;
5941 GtkTreePath *cursor_path = NULL;
5942 GtkTreeViewColumn *column;
5945 gboolean found_column = FALSE;
5947 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
5948 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5952 _gtk_tree_view_find_node (tree_view, cursor_path, &cursor_tree, &cursor_node);
5953 if (cursor_tree == NULL)
5955 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, cursor_path) == FALSE)
5957 gtk_tree_path_free (cursor_path);
5960 gtk_tree_path_free (cursor_path);
5962 list = tree_view->priv->columns;
5963 if (tree_view->priv->focus_column)
5965 for (list = tree_view->priv->columns; list; list = list->next)
5967 if (list->data == tree_view->priv->focus_column)
5974 column = list->data;
5975 if (column->visible == FALSE)
5978 gtk_tree_view_column_cell_set_cell_data (column,
5979 tree_view->priv->model,
5981 GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_PARENT),
5982 cursor_node->children?TRUE:FALSE);
5983 if (gtk_tree_view_column_cell_focus (column, count))
5985 tree_view->priv->focus_column = column;
5986 found_column = TRUE;
5998 gtk_tree_view_queue_draw_node (tree_view,
6002 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[CURSOR_CHANGED], 0);
6004 gtk_tree_view_clamp_column_visible (tree_view, tree_view->priv->focus_column);
6008 gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
6011 GtkRBTree *cursor_tree;
6012 GtkRBNode *cursor_node;
6015 g_return_if_fail (tree_view->priv->tree != NULL);
6019 cursor_tree = tree_view->priv->tree;
6020 cursor_node = cursor_tree->root;
6021 while (cursor_node && cursor_node->left != cursor_tree->nil)
6022 cursor_node = cursor_node->left;
6026 cursor_tree = tree_view->priv->tree;
6027 cursor_node = cursor_tree->root;
6030 while (cursor_node && cursor_node->right != cursor_tree->nil)
6031 cursor_node = cursor_node->right;
6032 if (cursor_node->children == NULL)
6035 cursor_tree = cursor_node->children;
6036 cursor_node = cursor_tree->root;
6041 path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
6042 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
6046 FALSE?GDK_SHIFT_MASK:0);
6048 gtk_tree_row_reference_free (tree_view->priv->cursor);
6049 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
6050 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
6054 gtk_tree_view_real_select_all (GtkTreeView *tree_view)
6056 if (tree_view->priv->selection->type != GTK_SELECTION_MULTIPLE)
6058 gtk_tree_selection_select_all (tree_view->priv->selection);
6062 gtk_tree_view_real_select_cursor_row (GtkTreeView *tree_view,
6063 gboolean start_editing)
6065 GtkRBTree *cursor_tree = NULL;
6066 GtkRBNode *cursor_node = NULL;
6067 GtkTreePath *cursor_path = NULL;
6068 GdkModifierType state = 0;
6071 if (tree_view->priv->cursor)
6072 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
6074 if (cursor_path == NULL)
6077 _gtk_tree_view_find_node (tree_view, cursor_path,
6078 &cursor_tree, &cursor_node);
6080 if (cursor_tree == NULL)
6082 gtk_tree_path_free (cursor_path);
6086 gtk_get_current_event_state (&state);
6088 if (start_editing && tree_view->priv->focus_column)
6090 if (gtk_tree_view_start_editing (tree_view, cursor_path))
6092 gtk_tree_path_free (cursor_path);
6096 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
6102 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
6104 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
6105 gtk_tree_view_queue_draw_node (tree_view, cursor_tree, cursor_node, NULL);
6106 gtk_tree_view_row_activated (tree_view, cursor_path, tree_view->priv->focus_column);
6108 gtk_tree_path_free (cursor_path);
6112 gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view)
6114 GtkRBTree *cursor_tree = NULL;
6115 GtkRBNode *cursor_node = NULL;
6116 GtkTreePath *cursor_path = NULL;
6119 if (tree_view->priv->cursor)
6120 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
6122 if (cursor_path == NULL)
6125 _gtk_tree_view_find_node (tree_view, cursor_path,
6126 &cursor_tree, &cursor_node);
6127 if (cursor_tree == NULL)
6129 gtk_tree_path_free (cursor_path);
6133 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
6139 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
6141 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
6142 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
6143 gtk_tree_path_free (cursor_path);
6149 gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
6154 GtkTreePath *cursor_path = NULL;
6159 if (tree_view->priv->cursor)
6160 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
6162 if (cursor_path == NULL)
6165 if (_gtk_tree_view_find_node (tree_view, cursor_path, &tree, &node))
6168 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
6169 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
6172 gtk_tree_view_real_expand_row (tree_view, cursor_path, tree, node, open_all, TRUE);
6174 gtk_tree_view_real_collapse_row (tree_view, cursor_path, tree, node, TRUE);
6176 gtk_tree_path_free (cursor_path);
6180 gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view)
6182 GtkRBTree *cursor_tree = NULL;
6183 GtkRBNode *cursor_node = NULL;
6184 GtkTreePath *cursor_path = NULL;
6187 if (tree_view->priv->cursor)
6188 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
6190 if (cursor_path == NULL)
6193 _gtk_tree_view_find_node (tree_view, cursor_path,
6194 &cursor_tree, &cursor_node);
6195 if (cursor_tree == NULL)
6197 gtk_tree_path_free (cursor_path);
6201 if (cursor_tree->parent_node)
6203 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
6204 cursor_node = cursor_tree->parent_node;
6205 cursor_tree = cursor_tree->parent_tree;
6207 gtk_tree_path_up (cursor_path);
6208 gtk_tree_row_reference_free (tree_view->priv->cursor);
6209 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, cursor_path);
6210 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
6217 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
6219 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
6220 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
6221 gtk_tree_path_free (cursor_path);
6225 gtk_tree_view_real_start_interactive_search (GtkTreeView *tree_view)
6229 GtkWidget *search_dialog;
6231 if (tree_view->priv->enable_search == FALSE ||
6232 tree_view->priv->search_column < 0)
6235 search_dialog = gtk_object_get_data (GTK_OBJECT (tree_view),
6236 GTK_TREE_VIEW_SEARCH_DIALOG_KEY);
6241 window = gtk_window_new (GTK_WINDOW_POPUP);
6242 gtk_window_set_title (GTK_WINDOW (window), "search dialog");
6243 gtk_container_set_border_width (GTK_CONTAINER (window), 3);
6244 gtk_window_set_modal (GTK_WINDOW (window), TRUE);
6246 (GTK_OBJECT (window), "delete_event",
6247 GTK_SIGNAL_FUNC (gtk_tree_view_search_delete_event),
6250 (GTK_OBJECT (window), "key_press_event",
6251 GTK_SIGNAL_FUNC (gtk_tree_view_search_key_press_event),
6254 (GTK_OBJECT (window), "button_press_event",
6255 GTK_SIGNAL_FUNC (gtk_tree_view_search_button_press_event),
6259 entry = gtk_entry_new ();
6260 gtk_widget_show (entry);
6262 (GTK_OBJECT (entry), "changed",
6263 GTK_SIGNAL_FUNC (gtk_tree_view_search_init),
6265 gtk_container_add (GTK_CONTAINER (window), entry);
6268 tree_view->priv->search_dialog_position_func (tree_view, window);
6269 gtk_widget_show_all (window);
6270 gtk_widget_grab_focus (entry);
6272 /* position window */
6274 gtk_object_set_data_full (GTK_OBJECT (window), "gtk-tree-view-text",
6275 g_strdup (gtk_entry_get_text (GTK_ENTRY (entry))),
6276 (GDestroyNotify) g_free);
6277 gtk_object_set_data (GTK_OBJECT (tree_view),
6278 GTK_TREE_VIEW_SEARCH_DIALOG_KEY, window);
6280 /* search first matching iter */
6281 gtk_tree_view_search_init (entry, tree_view);
6285 _gtk_tree_view_update_size (GtkTreeView *tree_view)
6289 GtkTreeViewColumn *column;
6290 gint vertical_separator;
6293 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical_separator", &vertical_separator, NULL);
6295 if (tree_view->priv->model == NULL)
6297 tree_view->priv->width = 0;
6298 tree_view->priv->height = 0;
6299 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
6304 for (list = tree_view->priv->columns, i = 0; list; list = list->next, i++)
6306 column = list->data;
6307 if (!column->visible)
6309 width += TREE_VIEW_COLUMN_WIDTH (column);
6312 if (tree_view->priv->tree == NULL)
6315 height = tree_view->priv->tree->root->offset + vertical_separator;
6317 if (tree_view->priv->width != width)
6319 tree_view->priv->width = width;
6320 tree_view->priv->hadjustment->upper = width;
6321 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->hadjustment), "changed");
6324 if (tree_view->priv->height != height)
6326 tree_view->priv->height = height;
6327 tree_view->priv->vadjustment->upper = tree_view->priv->height;
6328 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->vadjustment), "changed");
6331 if (GTK_WIDGET_REALIZED (tree_view))
6333 gdk_window_resize (tree_view->priv->bin_window, MAX (width, GTK_WIDGET (tree_view)->allocation.width), height + TREE_VIEW_HEADER_HEIGHT (tree_view));
6334 gdk_window_resize (tree_view->priv->header_window, MAX (width, GTK_WIDGET (tree_view)->allocation.width), tree_view->priv->header_height);
6336 _gtk_tree_view_update_col_width (tree_view);
6339 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6342 /* this function returns the new width of the column being resized given
6343 * the column and x position of the cursor; the x cursor position is passed
6344 * in as a pointer and automagicly corrected if it's beyond min/max limits
6347 gtk_tree_view_new_column_width (GtkTreeView *tree_view,
6351 GtkTreeViewColumn *column;
6354 /* first translate the x position from widget->window
6355 * to clist->clist_window
6358 column = g_list_nth (tree_view->priv->columns, i)->data;
6359 width = *x - column->button->allocation.x;
6361 /* Clamp down the value */
6362 if (column->min_width == -1)
6363 width = MAX (column->button->requisition.width,
6366 width = MAX (column->min_width,
6368 if (column->max_width != -1)
6369 width = MIN (width, column->max_width != -1);
6370 *x = column->button->allocation.x + width;
6378 gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
6379 GtkTreeView *tree_view)
6381 if (GTK_WIDGET_REALIZED (tree_view))
6384 gdk_window_move (tree_view->priv->bin_window,
6385 - tree_view->priv->hadjustment->value,
6387 gdk_window_move (tree_view->priv->header_window,
6388 - tree_view->priv->hadjustment->value,
6390 dy = tree_view->priv->dy - (int) tree_view->priv->vadjustment->value;
6391 gdk_window_scroll (tree_view->priv->bin_window, 0, dy);
6392 tree_view->priv->dy = (int) tree_view->priv->vadjustment->value;
6394 gdk_window_process_updates (tree_view->priv->bin_window, TRUE);
6395 gdk_window_process_updates (tree_view->priv->header_window, TRUE);
6405 * gtk_tree_view_new:
6407 * Creates a new #GtkTreeView widget.
6409 * Return value: A newly created #GtkTreeView widget.
6412 gtk_tree_view_new (void)
6414 GtkTreeView *tree_view;
6416 tree_view = GTK_TREE_VIEW (gtk_type_new (gtk_tree_view_get_type ()));
6418 return GTK_WIDGET (tree_view);
6422 * gtk_tree_view_new_with_model:
6423 * @model: the model.
6425 * Creates a new #GtkTreeView widget with the model initialized to @model.
6427 * Return value: A newly created #GtkTreeView widget.
6430 gtk_tree_view_new_with_model (GtkTreeModel *model)
6432 GtkTreeView *tree_view;
6434 tree_view = GTK_TREE_VIEW (gtk_type_new (gtk_tree_view_get_type ()));
6435 gtk_tree_view_set_model (tree_view, model);
6437 return GTK_WIDGET (tree_view);
6444 * gtk_tree_view_get_model:
6445 * @tree_view: a #GtkTreeView
6447 * Returns the model the the #GtkTreeView is based on. Returns %NULL if the
6450 * Return value: A #GtkTreeModel, or %NULL if none is currently being used.
6453 gtk_tree_view_get_model (GtkTreeView *tree_view)
6455 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
6457 return tree_view->priv->model;
6461 * gtk_tree_view_set_model:
6462 * @tree_view: A #GtkTreeNode.
6463 * @model: The model.
6465 * Sets the model for a #GtkTreeView. If the @tree_view already has a model
6466 * set, it will remove it before setting the new model. If @model is %NULL, then
6467 * it will unset the old model.
6470 gtk_tree_view_set_model (GtkTreeView *tree_view,
6471 GtkTreeModel *model)
6473 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6475 if (model == tree_view->priv->model)
6478 if (tree_view->priv->model)
6480 gtk_tree_view_unref_and_check_selection_tree (tree_view, tree_view->priv->tree);
6482 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
6483 gtk_tree_view_row_changed, tree_view);
6484 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
6485 gtk_tree_view_row_inserted, tree_view);
6486 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
6487 gtk_tree_view_row_has_child_toggled, tree_view);
6488 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
6489 gtk_tree_view_row_deleted, tree_view);
6490 g_signal_handlers_disconnect_by_func (G_OBJECT (tree_view->priv->model),
6491 gtk_tree_view_rows_reordered, tree_view);
6492 if (tree_view->priv->tree)
6494 _gtk_rbtree_free (tree_view->priv->tree);
6495 tree_view->priv->tree = NULL;
6497 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
6498 tree_view->priv->drag_dest_row = NULL;
6499 gtk_tree_row_reference_free (tree_view->priv->cursor);
6500 tree_view->priv->cursor = NULL;
6501 gtk_tree_row_reference_free (tree_view->priv->anchor);
6502 tree_view->priv->anchor = NULL;
6504 g_object_unref (tree_view->priv->model);
6505 tree_view->priv->search_column = -1;
6508 tree_view->priv->model = model;
6511 if (tree_view->priv->model)
6518 if (tree_view->priv->search_column == -1)
6520 for (i = 0; i < gtk_tree_model_get_n_columns (model); i++)
6522 if (gtk_tree_model_get_column_type (model, i) == G_TYPE_STRING)
6524 tree_view->priv->search_column = i;
6529 g_object_ref (tree_view->priv->model);
6530 g_signal_connect (tree_view->priv->model,
6532 G_CALLBACK (gtk_tree_view_row_changed),
6534 g_signal_connect (tree_view->priv->model,
6536 G_CALLBACK (gtk_tree_view_row_inserted),
6538 g_signal_connect (tree_view->priv->model,
6539 "row_has_child_toggled",
6540 G_CALLBACK (gtk_tree_view_row_has_child_toggled),
6542 g_signal_connect (tree_view->priv->model,
6544 G_CALLBACK (gtk_tree_view_row_deleted),
6546 g_signal_connect (tree_view->priv->model,
6548 G_CALLBACK (gtk_tree_view_rows_reordered),
6551 path = gtk_tree_path_new_root ();
6552 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, path))
6554 tree_view->priv->tree = _gtk_rbtree_new ();
6555 gtk_tree_view_build_tree (tree_view, tree_view->priv->tree, &iter, 1, FALSE, GTK_WIDGET_REALIZED (tree_view));
6557 gtk_tree_path_free (path);
6559 /* FIXME: do I need to do this? gtk_tree_view_create_buttons (tree_view); */
6562 if (GTK_WIDGET_REALIZED (tree_view))
6563 _gtk_tree_view_update_size (tree_view);
6564 g_object_notify (G_OBJECT (tree_view), "model");
6568 * gtk_tree_view_get_selection:
6569 * @tree_view: A #GtkTreeView.
6571 * Gets the #GtkTreeSelection associated with @tree_view.
6573 * Return value: A #GtkTreeSelection object.
6576 gtk_tree_view_get_selection (GtkTreeView *tree_view)
6578 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
6580 return tree_view->priv->selection;
6584 * gtk_tree_view_get_hadjustment:
6585 * @tree_view: A #GtkTreeView
6587 * Gets the #GtkAdjustment currently being used for the horizontal aspect.
6589 * Return value: A #GtkAdjustment object, or %NULL if none is currently being
6593 gtk_tree_view_get_hadjustment (GtkTreeView *tree_view)
6595 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
6597 if (tree_view->priv->hadjustment == NULL)
6598 gtk_tree_view_set_hadjustment (tree_view, NULL);
6600 return tree_view->priv->hadjustment;
6604 * gtk_tree_view_set_hadjustment:
6605 * @tree_view: A #GtkTreeView
6606 * @adjustment: The #GtkAdjustment to set, or %NULL
6608 * Sets the #GtkAdjustment for the current horizontal aspect.
6611 gtk_tree_view_set_hadjustment (GtkTreeView *tree_view,
6612 GtkAdjustment *adjustment)
6614 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6616 gtk_tree_view_set_adjustments (tree_view,
6618 tree_view->priv->vadjustment);
6620 g_object_notify (G_OBJECT (tree_view), "hadjustment");
6624 * gtk_tree_view_get_vadjustment:
6625 * @tree_view: A #GtkTreeView
6627 * Gets the #GtkAdjustment currently being used for the vertical aspect.
6629 * Return value: A #GtkAdjustment object, or %NULL if none is currently being
6633 gtk_tree_view_get_vadjustment (GtkTreeView *tree_view)
6635 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
6637 if (tree_view->priv->vadjustment == NULL)
6638 gtk_tree_view_set_vadjustment (tree_view, NULL);
6640 return tree_view->priv->vadjustment;
6644 * gtk_tree_view_set_vadjustment:
6645 * @tree_view: A #GtkTreeView
6646 * @adjustment: The #GtkAdjustment to set, or %NULL
6648 * Sets the #GtkAdjustment for the current vertical aspect.
6651 gtk_tree_view_set_vadjustment (GtkTreeView *tree_view,
6652 GtkAdjustment *adjustment)
6654 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6656 gtk_tree_view_set_adjustments (tree_view,
6657 tree_view->priv->hadjustment,
6660 g_object_notify (G_OBJECT (tree_view), "vadjustment");
6663 /* Column and header operations */
6666 * gtk_tree_view_get_headers_visible:
6667 * @tree_view: A #GtkTreeView.
6669 * Returns %TRUE if the headers on the @tree_view are visible.
6671 * Return value: Whether the headers are visible or not.
6674 gtk_tree_view_get_headers_visible (GtkTreeView *tree_view)
6676 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
6678 return GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
6682 * gtk_tree_view_set_headers_visible:
6683 * @tree_view: A #GtkTreeView.
6684 * @headers_visible: %TRUE if the headers are visible
6686 * Sets the the visibility state of the headers.
6689 gtk_tree_view_set_headers_visible (GtkTreeView *tree_view,
6690 gboolean headers_visible)
6694 GtkTreeViewColumn *column;
6696 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6698 headers_visible = !! headers_visible;
6700 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE) == headers_visible)
6703 if (headers_visible)
6704 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
6706 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
6708 if (GTK_WIDGET_REALIZED (tree_view))
6710 gdk_window_get_position (tree_view->priv->bin_window, &x, &y);
6711 if (headers_visible)
6713 gdk_window_move_resize (tree_view->priv->bin_window, x, y, tree_view->priv->width, tree_view->priv->height + TREE_VIEW_HEADER_HEIGHT (tree_view));
6715 if (GTK_WIDGET_MAPPED (tree_view))
6716 gtk_tree_view_map_buttons (tree_view);
6720 gdk_window_move_resize (tree_view->priv->bin_window, x, y, tree_view->priv->width, tree_view->priv->height);
6722 for (list = tree_view->priv->columns; list; list = list->next)
6724 column = list->data;
6725 gtk_widget_unmap (column->button);
6727 gdk_window_hide (tree_view->priv->header_window);
6731 tree_view->priv->vadjustment->page_size = GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
6732 tree_view->priv->vadjustment->page_increment = (GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view)) / 2;
6733 tree_view->priv->vadjustment->lower = 0;
6734 tree_view->priv->vadjustment->upper = tree_view->priv->height;
6735 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->vadjustment), "changed");
6737 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6739 g_object_notify (G_OBJECT (tree_view), "headers_visible");
6744 * gtk_tree_view_columns_autosize:
6745 * @tree_view: A #GtkTreeView.
6747 * Resizes all columns to their optimal width.
6750 gtk_tree_view_columns_autosize (GtkTreeView *tree_view)
6752 gboolean dirty = FALSE;
6754 GtkTreeViewColumn *column;
6756 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6758 for (list = tree_view->priv->columns; list; list = list->next)
6760 column = list->data;
6761 if (column->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
6763 gtk_tree_view_column_cell_set_dirty (column);
6768 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6772 * gtk_tree_view_set_headers_clickable:
6773 * @tree_view: A #GtkTreeView.
6774 * @setting: %TRUE if the columns are clickable.
6776 * Allow the column title buttons to be clicked.
6779 gtk_tree_view_set_headers_clickable (GtkTreeView *tree_view,
6784 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6785 g_return_if_fail (tree_view->priv->model != NULL);
6787 for (list = tree_view->priv->columns; list; list = list->next)
6788 gtk_tree_view_column_set_clickable (GTK_TREE_VIEW_COLUMN (list->data), setting);
6790 g_object_notify (G_OBJECT (tree_view), "headers_clickable");
6795 * gtk_tree_view_set_rules_hint
6796 * @tree_view: a #GtkTreeView
6797 * @setting: %TRUE if the tree requires reading across rows
6799 * This function tells GTK+ that the user interface for your
6800 * application requires users to read across tree rows and associate
6801 * cells with one another. By default, GTK+ will then render the tree
6802 * with alternating row colors. Do <emphasis>not</emphasis> use it
6803 * just because you prefer the appearance of the ruled tree; that's a
6804 * question for the theme. Some themes will draw tree rows in
6805 * alternating colors even when rules are turned off, and users who
6806 * prefer that appearance all the time can choose those themes. You
6807 * should call this function only as a <emphasis>semantic</emphasis>
6808 * hint to the theme engine that your tree makes alternating colors
6809 * useful from a functional standpoint (since it has lots of columns,
6814 gtk_tree_view_set_rules_hint (GtkTreeView *tree_view,
6817 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6819 setting = setting != FALSE;
6821 if (tree_view->priv->has_rules != setting)
6823 tree_view->priv->has_rules = setting;
6824 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
6827 g_object_notify (G_OBJECT (tree_view), "rules_hint");
6831 * gtk_tree_view_get_rules_hint
6832 * @tree_view: a #GtkTreeView
6834 * Gets the setting set by gtk_tree_view_set_rules_hint().
6836 * Return value: %TRUE if rules are useful for the user of this tree
6839 gtk_tree_view_get_rules_hint (GtkTreeView *tree_view)
6841 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
6843 return tree_view->priv->has_rules;
6846 /* Public Column functions
6850 * gtk_tree_view_append_column:
6851 * @tree_view: A #GtkTreeView.
6852 * @column: The #GtkTreeViewColumn to add.
6854 * Appends @column to the list of columns.
6856 * Return value: The number of columns in @tree_view after appending.
6859 gtk_tree_view_append_column (GtkTreeView *tree_view,
6860 GtkTreeViewColumn *column)
6862 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
6863 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
6864 g_return_val_if_fail (column->tree_view == NULL, -1);
6866 return gtk_tree_view_insert_column (tree_view, column, -1);
6871 * gtk_tree_view_remove_column:
6872 * @tree_view: A #GtkTreeView.
6873 * @column: The #GtkTreeViewColumn to remove.
6875 * Removes @column from @tree_view.
6877 * Return value: The number of columns in @tree_view after removing.
6880 gtk_tree_view_remove_column (GtkTreeView *tree_view,
6881 GtkTreeViewColumn *column)
6883 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
6884 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
6885 g_return_val_if_fail (column->tree_view == GTK_WIDGET (tree_view), -1);
6887 _gtk_tree_view_column_unset_tree_view (column);
6889 if (tree_view->priv->focus_column == column)
6890 tree_view->priv->focus_column = NULL;
6892 tree_view->priv->columns = g_list_remove (tree_view->priv->columns, column);
6893 tree_view->priv->n_columns--;
6895 if (GTK_WIDGET_REALIZED (tree_view))
6899 _gtk_tree_view_column_unrealize_button (column);
6900 for (list = tree_view->priv->columns; list; list = list->next)
6902 GtkTreeViewColumn *tmp_column;
6904 tmp_column = GTK_TREE_VIEW_COLUMN (list->data);
6905 if (tmp_column->visible)
6906 gtk_tree_view_column_cell_set_dirty (tmp_column);
6909 if (tree_view->priv->n_columns == 0 &&
6910 gtk_tree_view_get_headers_visible (tree_view))
6911 gdk_window_hide (tree_view->priv->header_window);
6913 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6916 g_object_unref (G_OBJECT (column));
6917 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLUMNS_CHANGED], 0);
6919 return tree_view->priv->n_columns;
6923 * gtk_tree_view_insert_column:
6924 * @tree_view: A #GtkTreeView.
6925 * @column: The #GtkTreeViewColumn to be inserted.
6926 * @position: The position to insert @column in.
6928 * This inserts the @column into the @tree_view at @position. If @position is
6929 * -1, then the column is inserted at the end.
6931 * Return value: The number of columns in @tree_view after insertion.
6934 gtk_tree_view_insert_column (GtkTreeView *tree_view,
6935 GtkTreeViewColumn *column,
6938 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
6939 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
6940 g_return_val_if_fail (column->tree_view == NULL, -1);
6942 g_object_ref (G_OBJECT (column));
6943 gtk_object_sink (GTK_OBJECT (column));
6945 if (tree_view->priv->n_columns == 0 &&
6946 GTK_WIDGET_REALIZED (tree_view) &&
6947 gtk_tree_view_get_headers_visible (tree_view))
6949 gdk_window_show (tree_view->priv->header_window);
6952 tree_view->priv->columns = g_list_insert (tree_view->priv->columns,
6954 tree_view->priv->n_columns++;
6956 _gtk_tree_view_column_set_tree_view (column, tree_view);
6958 if (GTK_WIDGET_REALIZED (tree_view))
6962 _gtk_tree_view_column_realize_button (column);
6964 for (list = tree_view->priv->columns; list; list = list->next)
6966 column = GTK_TREE_VIEW_COLUMN (list->data);
6967 if (column->visible)
6968 gtk_tree_view_column_cell_set_dirty (column);
6970 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6973 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLUMNS_CHANGED], 0);
6975 return tree_view->priv->n_columns;
6979 * gtk_tree_view_insert_column_with_attributes:
6980 * @tree_view: A #GtkTreeView
6981 * @position: The position to insert the new column in.
6982 * @title: The title to set the header to.
6983 * @cell: The #GtkCellRenderer.
6984 * @Varargs: A %NULL-terminated list of attributes.
6986 * Creates a new #GtkTreeViewColumn and inserts it into the @tree_view at
6987 * @position. If @position is -1, then the newly created column is inserted at
6988 * the end. The column is initialized with the attributes given.
6990 * Return value: The number of columns in @tree_view after insertion.
6993 gtk_tree_view_insert_column_with_attributes (GtkTreeView *tree_view,
6996 GtkCellRenderer *cell,
6999 GtkTreeViewColumn *column;
7004 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
7006 column = gtk_tree_view_column_new ();
7008 gtk_tree_view_column_set_title (column, title);
7009 gtk_tree_view_column_pack_start (column, cell, TRUE);
7011 va_start (args, cell);
7013 attribute = va_arg (args, gchar *);
7015 while (attribute != NULL)
7017 column_id = va_arg (args, gint);
7018 gtk_tree_view_column_add_attribute (column, cell, attribute, column_id);
7019 attribute = va_arg (args, gchar *);
7024 gtk_tree_view_insert_column (tree_view, column, position);
7026 return tree_view->priv->n_columns;
7030 * gtk_tree_view_insert_column_with_data_func:
7031 * @tree_view: a #GtkTreeView
7032 * @position: Position to insert, -1 for append
7033 * @title: column title
7034 * @cell: cell renderer for column
7035 * @func: function to set attributes of cell renderer
7036 * @data: data for @func
7037 * @dnotify: destroy notifier for @data
7039 * Convenience function that inserts a new column into the #GtkTreeView
7040 * with the given cell renderer and a #GtkCellDataFunc to set cell renderer
7041 * attributes (normally using data from the model). See also
7042 * gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start().
7044 * Return value: number of columns in the tree view post-insert
7047 gtk_tree_view_insert_column_with_data_func (GtkTreeView *tree_view,
7050 GtkCellRenderer *cell,
7051 GtkTreeCellDataFunc func,
7053 GDestroyNotify dnotify)
7055 GtkTreeViewColumn *column;
7057 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
7059 column = gtk_tree_view_column_new ();
7061 gtk_tree_view_column_set_title (column, title);
7062 gtk_tree_view_column_pack_start (column, cell, TRUE);
7063 gtk_tree_view_column_set_cell_data_func (column, cell, func, data, dnotify);
7065 gtk_tree_view_insert_column (tree_view, column, position);
7067 return tree_view->priv->n_columns;
7071 * gtk_tree_view_get_column:
7072 * @tree_view: A #GtkTreeView.
7073 * @n: The position of the column, counting from 0.
7075 * Gets the #GtkTreeViewColumn at the given position in the #tree_view.
7077 * Return value: The #GtkTreeViewColumn, or %NULL if the position is outside the
7081 gtk_tree_view_get_column (GtkTreeView *tree_view,
7084 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
7086 if (n < 0 || n >= tree_view->priv->n_columns)
7089 if (tree_view->priv->columns == NULL)
7092 return GTK_TREE_VIEW_COLUMN (g_list_nth (tree_view->priv->columns, n)->data);
7096 * gtk_tree_view_get_columns:
7097 * @tree_view: A #GtkTreeView
7099 * Returns a #GList of all the #GtkTreeViewColumn s currently in @tree_view.
7100 * The returned list must be freed with g_list_free ().
7102 * Return value: A list of #GtkTreeViewColumn s
7105 gtk_tree_view_get_columns (GtkTreeView *tree_view)
7107 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
7109 return g_list_copy (tree_view->priv->columns);
7113 * gtk_tree_view_move_column_after:
7114 * @tree_view: A #GtkTreeView
7115 * @column: The #GtkTreeViewColumn to be moved.
7116 * @base_column: The #GtkTreeViewColumn to be moved relative to, or %NULL.
7118 * Moves @column to be after to @base_column. If @base_column is %NULL, then
7119 * @column is placed in the first position.
7122 gtk_tree_view_move_column_after (GtkTreeView *tree_view,
7123 GtkTreeViewColumn *column,
7124 GtkTreeViewColumn *base_column)
7126 GList *column_list_el, *base_el = NULL;
7128 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7130 column_list_el = g_list_find (tree_view->priv->columns, column);
7131 g_return_if_fail (column_list_el != NULL);
7135 base_el = g_list_find (tree_view->priv->columns, base_column);
7136 g_return_if_fail (base_el != NULL);
7139 if (column_list_el->prev == base_el)
7142 tree_view->priv->columns = g_list_remove_link (tree_view->priv->columns, column_list_el);
7143 if (base_el == NULL)
7145 column_list_el->prev = NULL;
7146 column_list_el->next = tree_view->priv->columns;
7147 if (column_list_el->next)
7148 column_list_el->next->prev = column_list_el;
7149 tree_view->priv->columns = column_list_el;
7153 column_list_el->prev = base_el;
7154 column_list_el->next = base_el->next;
7155 if (column_list_el->next)
7156 column_list_el->next->prev = column_list_el;
7157 base_el->next = column_list_el;
7160 if (GTK_WIDGET_REALIZED (tree_view))
7162 /*gtk_widget_queue_resize (GTK_WIDGET (tree_view)); */
7163 _gtk_tree_view_update_size (tree_view);
7164 gtk_tree_view_size_allocate_buttons (GTK_WIDGET (tree_view));
7167 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLUMNS_CHANGED], 0);
7171 * gtk_tree_view_set_expander_column:
7172 * @tree_view: A #GtkTreeView
7173 * @column: %NULL, or the column to draw the expander arrow at.
7175 * Sets the column to draw the expander arrow at. It must be in @tree_view. If
7176 * @column is %NULL, then the expander arrow is always at the first visible
7180 gtk_tree_view_set_expander_column (GtkTreeView *tree_view,
7181 GtkTreeViewColumn *column)
7183 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7185 g_return_if_fail (GTK_IS_TREE_VIEW_COLUMN (column));
7187 if (tree_view->priv->expander_column != column)
7193 /* Confirm that column is in tree_view */
7194 for (list = tree_view->priv->columns; list; list = list->next)
7195 if (list->data == column)
7197 g_return_if_fail (list != NULL);
7200 tree_view->priv->expander_column = column;
7201 g_object_notify (G_OBJECT (tree_view), "expander_column");
7206 * gtk_tree_view_get_expander_column:
7207 * @tree_view: A #GtkTreeView
7209 * Returns the column that is the current expander column. This
7210 * column has the expander arrow drawn next to it.
7212 * Return value: The expander column.
7215 gtk_tree_view_get_expander_column (GtkTreeView *tree_view)
7219 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
7221 for (list = tree_view->priv->columns; list; list = list->data)
7222 if (gtk_tree_view_is_expander_column (tree_view, GTK_TREE_VIEW_COLUMN (list->data)))
7223 return (GtkTreeViewColumn *) list->data;
7229 * gtk_tree_view_set_column_drag_function:
7230 * @tree_view: A #GtkTreeView.
7231 * @func: A function to determine which columns are reorderable, or %NULL.
7232 * @user_data: User data to be passed to @func, or %NULL
7233 * @destroy: Destroy notifier for @user_data, or %NULL
7235 * Sets a user function for determining where a column may be dropped when
7236 * dragged. This function is called on every column pair in turn at the
7237 * beginning of a column drag to determine where a drop can take place. The
7238 * arguments passed to @func are: the @tree_view, the #GtkTreeViewColumn being
7239 * dragged, the two #GtkTreeViewColumn s determining the drop spot, and
7240 * @user_data. If either of the #GtkTreeViewColumn arguments for the drop spot
7241 * are %NULL, then they indicate an edge. If @func is set to be %NULL, then
7242 * @tree_view reverts to the default behavior of allowing all columns to be
7243 * dropped everywhere.
7246 gtk_tree_view_set_column_drag_function (GtkTreeView *tree_view,
7247 GtkTreeViewColumnDropFunc func,
7249 GtkDestroyNotify destroy)
7251 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7253 if (tree_view->priv->column_drop_func_data_destroy)
7254 (* tree_view->priv->column_drop_func_data_destroy) (tree_view->priv->column_drop_func_data);
7256 tree_view->priv->column_drop_func = func;
7257 tree_view->priv->column_drop_func_data = user_data;
7258 tree_view->priv->column_drop_func_data_destroy = destroy;
7262 * gtk_tree_view_scroll_to_point:
7263 * @tree_view: a #GtkTreeView
7264 * @tree_x: X coordinate of new top-left pixel of visible area
7265 * @tree_y: Y coordinate of new top-left pixel of visible area
7267 * Scrolls the tree view such that the top-left corner of the visible
7268 * area is @tree_x, @tree_y, where @tree_x and @tree_y are specified
7269 * in tree window coordinates. The @tree_view must be realized before
7270 * this function is called. If it isn't, you probably want to be
7271 * using gtk_tree_view_scroll_to_cell().
7274 gtk_tree_view_scroll_to_point (GtkTreeView *tree_view,
7278 GtkAdjustment *hadj;
7279 GtkAdjustment *vadj;
7281 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7282 g_return_if_fail (GTK_WIDGET_REALIZED (tree_view));
7284 hadj = tree_view->priv->hadjustment;
7285 vadj = tree_view->priv->vadjustment;
7287 gtk_adjustment_set_value (hadj, CLAMP (tree_x, hadj->lower, hadj->upper - hadj->page_size));
7288 gtk_adjustment_set_value (vadj, CLAMP (tree_y, vadj->lower, vadj->upper - vadj->page_size));
7292 * gtk_tree_view_scroll_to_cell
7293 * @tree_view: A #GtkTreeView.
7294 * @path: The path of the row to move to, or %NULL.
7295 * @column: The #GtkTreeViewColumn to move horizontally to, or %NULL.
7296 * @use_align: whether to use alignment arguments, or %FALSE.
7297 * @row_align: The vertical alignment of the row specified by @path.
7298 * @col_align: The horizontal alignment of the column specified by @column.
7300 * Moves the alignments of @tree_view to the position specified by @column and
7301 * @path. If @column is %NULL, then no horizontal scrolling occurs. Likewise,
7302 * if @path is %NULL no vertical scrolling occurs. @row_align determines where
7303 * the row is placed, and @col_align determines where @column is placed. Both
7304 * are expected to be between 0.0 and 1.0. 0.0 means left/top alignment, 1.0
7305 * means right/bottom alignment, 0.5 means center. If @use_align is %FALSE,
7306 * then the alignment arguments are ignored, and the tree does the minimum
7307 * amount of work to scroll the cell onto the screen.
7310 gtk_tree_view_scroll_to_cell (GtkTreeView *tree_view,
7312 GtkTreeViewColumn *column,
7317 GdkRectangle cell_rect;
7318 GdkRectangle vis_rect;
7319 gint dest_x, dest_y;
7320 gfloat within_margin = 0;
7322 /* FIXME work on unmapped/unrealized trees? maybe implement when
7323 * we do incremental reflow for trees
7326 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7327 g_return_if_fail (row_align >= 0.0 && row_align <= 1.0);
7328 g_return_if_fail (col_align >= 0.0 && col_align <= 1.0);
7329 g_return_if_fail (path != NULL || column != NULL);
7331 row_align = CLAMP (row_align, 0.0, 1.0);
7332 col_align = CLAMP (col_align, 0.0, 1.0);
7334 if (! GTK_WIDGET_REALIZED (tree_view))
7337 tree_view->priv->scroll_to_path = gtk_tree_path_copy (path);
7339 tree_view->priv->scroll_to_column = column;
7340 tree_view->priv->scroll_to_use_align = use_align;
7341 tree_view->priv->scroll_to_row_align = row_align;
7342 tree_view->priv->scroll_to_col_align = col_align;
7347 gtk_tree_view_get_cell_area (tree_view, path, column, &cell_rect);
7348 gtk_tree_view_get_visible_rect (tree_view, &vis_rect);
7350 dest_x = vis_rect.x;
7351 dest_y = vis_rect.y;
7357 dest_x = cell_rect.x + cell_rect.width * row_align - vis_rect.width * row_align;
7361 if (cell_rect.x < vis_rect.x)
7362 dest_x = cell_rect.x - vis_rect.width * within_margin;
7363 else if (cell_rect.x + cell_rect.width > vis_rect.x + vis_rect.width)
7364 dest_x = cell_rect.x + cell_rect.width - vis_rect.width * (1 - within_margin);
7372 dest_y = cell_rect.y + cell_rect.height * col_align - vis_rect.height * col_align;
7376 if (cell_rect.y < vis_rect.y)
7377 dest_y = cell_rect.y - vis_rect.height * within_margin;
7378 else if (cell_rect.y + cell_rect.height > vis_rect.y + vis_rect.height)
7379 dest_y = cell_rect.y + cell_rect.height - vis_rect.height * (1 - within_margin);
7383 gtk_tree_view_scroll_to_point (tree_view, dest_x, dest_y);
7388 * gtk_tree_view_row_activated:
7389 * @tree_view: A #GtkTreeView
7390 * @path: The #GtkTreePath to be activated.
7391 * @column: The #GtkTreeViewColumn to be activated.
7393 * Activates the cell determined by @path and @column.
7396 gtk_tree_view_row_activated (GtkTreeView *tree_view,
7398 GtkTreeViewColumn *column)
7400 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7402 g_signal_emit (G_OBJECT(tree_view), tree_view_signals[ROW_ACTIVATED], 0, path, column);
7407 gtk_tree_view_expand_all_helper (GtkRBTree *tree,
7411 GtkTreeView *tree_view = data;
7414 _gtk_rbtree_traverse (node->children,
7415 node->children->root,
7417 gtk_tree_view_expand_all_helper,
7419 else if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT && node->children == NULL)
7425 node->children = _gtk_rbtree_new ();
7426 node->children->parent_tree = tree;
7427 node->children->parent_node = node;
7428 path = _gtk_tree_view_find_path (tree_view, tree, node);
7429 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
7430 gtk_tree_model_iter_children (tree_view->priv->model, &child, &iter);
7431 gtk_tree_view_build_tree (tree_view,
7434 gtk_tree_path_get_depth (path) + 1,
7436 GTK_WIDGET_REALIZED (tree_view));
7437 gtk_tree_path_free (path);
7442 * gtk_tree_view_expand_all:
7443 * @tree_view: A #GtkTreeView.
7445 * Recursively expands all nodes in the @tree_view.
7448 gtk_tree_view_expand_all (GtkTreeView *tree_view)
7450 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7451 g_return_if_fail (tree_view->priv->tree != NULL);
7453 _gtk_rbtree_traverse (tree_view->priv->tree,
7454 tree_view->priv->tree->root,
7456 gtk_tree_view_expand_all_helper,
7459 _gtk_tree_view_update_size (tree_view);
7462 /* Timeout to animate the expander during expands and collapses */
7464 expand_collapse_timeout (gpointer data)
7466 GtkTreeView *tree_view = data;
7472 GDK_THREADS_ENTER ();
7477 node = tree_view->priv->expanded_collapsed_node;
7478 tree = tree_view->priv->expanded_collapsed_tree;
7480 if (node->children == NULL)
7485 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
7487 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
7488 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
7493 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
7495 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
7502 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
7504 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
7505 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
7509 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
7511 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
7520 gtk_tree_view_queue_draw_arrow (tree_view, tree, node, NULL);
7522 GDK_THREADS_LEAVE ();
7527 GDK_THREADS_LEAVE ();
7533 * gtk_tree_view_collapse_all:
7534 * @tree_view: A #GtkTreeView.
7536 * Recursively collapses all visible, expanded nodes in @tree_view.
7539 gtk_tree_view_collapse_all (GtkTreeView *tree_view)
7546 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7547 g_return_if_fail (tree_view->priv->tree != NULL);
7549 path = gtk_tree_path_new ();
7550 gtk_tree_path_append_index (path, 0);
7551 indices = gtk_tree_path_get_indices (path);
7553 tree = tree_view->priv->tree;
7555 while (node && node->left != tree->nil)
7561 gtk_tree_view_real_collapse_row (tree_view, path, tree, node, FALSE);
7563 node = _gtk_rbtree_next (tree, node);
7566 gtk_tree_path_free (path);
7569 /* FIXME the bool return values for expand_row and collapse_row are
7570 * not analagous; they should be TRUE if the row had children and
7571 * was not already in the requested state.
7576 gtk_tree_view_real_expand_row (GtkTreeView *tree_view,
7590 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
7593 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
7594 if (! gtk_tree_model_iter_has_child (tree_view->priv->model, &iter))
7597 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[TEST_EXPAND_ROW], 0, &iter, path, &expand);
7602 node->children = _gtk_rbtree_new ();
7603 node->children->parent_tree = tree;
7604 node->children->parent_node = node;
7606 gtk_tree_model_iter_children (tree_view->priv->model, &temp, &iter);
7608 gtk_tree_view_build_tree (tree_view,
7611 gtk_tree_path_get_depth (path) + 1,
7613 GTK_WIDGET_REALIZED (tree_view));
7615 if (tree_view->priv->expand_collapse_timeout)
7617 gtk_timeout_remove (tree_view->priv->expand_collapse_timeout);
7618 tree_view->priv->expand_collapse_timeout = 0;
7621 if (tree_view->priv->expanded_collapsed_node != NULL)
7623 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_EXPANDED);
7624 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_COLLAPSED);
7626 tree_view->priv->expanded_collapsed_node = NULL;
7631 tree_view->priv->expand_collapse_timeout = gtk_timeout_add (50, expand_collapse_timeout, tree_view);
7632 tree_view->priv->expanded_collapsed_node = node;
7633 tree_view->priv->expanded_collapsed_tree = tree;
7635 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
7638 if (GTK_WIDGET_MAPPED (tree_view))
7640 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
7641 _gtk_tree_view_update_size (tree_view);
7644 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[ROW_EXPANDED], 0, &iter, path);
7650 * gtk_tree_view_expand_row:
7651 * @tree_view: a #GtkTreeView
7652 * @path: path to a row
7653 * @open_all: whether to recursively expand, or just expand immediate children
7655 * Opens the row so its children are visible.
7657 * Return value: %TRUE if the row existed and had children
7660 gtk_tree_view_expand_row (GtkTreeView *tree_view,
7667 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
7668 g_return_val_if_fail (tree_view->priv->model != NULL, FALSE);
7669 g_return_val_if_fail (path != NULL, FALSE);
7671 if (_gtk_tree_view_find_node (tree_view,
7678 return gtk_tree_view_real_expand_row (tree_view, path, tree, node, open_all, FALSE);
7684 gtk_tree_view_real_collapse_row (GtkTreeView *tree_view,
7691 GtkTreeIter children;
7696 if (node->children == NULL)
7699 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
7701 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[TEST_COLLAPSE_ROW], 0, &iter, path, &collapse);
7706 /* if the prelighted node is a child of us, we want to unprelight it. We have
7707 * a chance to prelight the correct node below */
7709 if (tree_view->priv->prelight_tree)
7711 GtkRBTree *parent_tree;
7712 GtkRBNode *parent_node;
7714 parent_tree = tree_view->priv->prelight_tree->parent_tree;
7715 parent_node = tree_view->priv->prelight_tree->parent_node;
7718 if (parent_tree == tree && parent_node == node)
7720 ensure_unprelighted (tree_view);
7723 parent_node = parent_tree->parent_node;
7724 parent_tree = parent_tree->parent_tree;
7728 TREE_VIEW_INTERNAL_ASSERT (gtk_tree_model_iter_children (tree_view->priv->model, &children, &iter), FALSE);
7730 for (list = tree_view->priv->columns; list; list = list->next)
7732 GtkTreeViewColumn *column = list->data;
7734 if (column->visible == FALSE)
7736 if (gtk_tree_view_column_get_sizing (column) == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
7737 gtk_tree_view_column_cell_set_dirty (column);
7740 if (tree_view->priv->destroy_count_func)
7742 GtkTreePath *child_path;
7743 gint child_count = 0;
7744 child_path = gtk_tree_path_copy (path);
7745 gtk_tree_path_append_index (child_path, 0);
7747 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, &child_count);
7748 (* tree_view->priv->destroy_count_func) (tree_view, child_path, child_count, tree_view->priv->destroy_count_data);
7749 gtk_tree_path_free (child_path);
7752 if (gtk_tree_view_unref_and_check_selection_tree (tree_view, node->children))
7753 g_signal_emit_by_name (G_OBJECT (tree_view->priv->selection), "changed", 0);
7754 _gtk_rbtree_remove (node->children);
7756 if (tree_view->priv->expand_collapse_timeout)
7758 gtk_timeout_remove (tree_view->priv->expand_collapse_timeout);
7759 tree_view->priv->expand_collapse_timeout = 0;
7762 if (tree_view->priv->expanded_collapsed_node != NULL)
7764 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_EXPANDED);
7765 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_COLLAPSED);
7767 tree_view->priv->expanded_collapsed_node = NULL;
7772 tree_view->priv->expand_collapse_timeout = gtk_timeout_add (50, expand_collapse_timeout, tree_view);
7773 tree_view->priv->expanded_collapsed_node = node;
7774 tree_view->priv->expanded_collapsed_tree = tree;
7776 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
7779 if (GTK_WIDGET_MAPPED (tree_view))
7781 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
7782 _gtk_tree_view_update_size (tree_view);
7785 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
7787 GtkTreePath *cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
7789 if (gtk_tree_path_is_ancestor (path, cursor_path))
7791 gtk_tree_row_reference_free (tree_view->priv->cursor);
7792 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
7793 tree_view->priv->model,
7796 gtk_tree_path_free (cursor_path);
7799 if (gtk_tree_row_reference_valid (tree_view->priv->anchor))
7801 GtkTreePath *anchor_path = gtk_tree_row_reference_get_path (tree_view->priv->anchor);
7802 if (gtk_tree_path_is_ancestor (path, anchor_path))
7804 gtk_tree_row_reference_free (tree_view->priv->anchor);
7805 tree_view->priv->anchor = NULL;
7807 gtk_tree_path_free (anchor_path);
7811 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[ROW_COLLAPSED], 0, &iter, path);
7813 /* now that we've collapsed all rows, we want to try to set the prelight
7814 * again. To do this, we fake a motion event and send it to ourselves. */
7816 if (gdk_window_at_pointer (&x, &y) == tree_view->priv->bin_window)
7818 GdkEventMotion event;
7819 event.window = tree_view->priv->bin_window;
7823 /* despite the fact this isn't a real event, I'm almost positive it will
7824 * never trigger a drag event. maybe_drag is the only function that uses
7825 * more than just event.x and event.y. */
7826 gtk_tree_view_motion_bin_window (GTK_WIDGET (tree_view), &event);
7832 * gtk_tree_view_collapse_row:
7833 * @tree_view: a #GtkTreeView
7834 * @path: path to a row in the @tree_view
7836 * Collapses a row (hides its child rows, if they exist).
7838 * Return value: %TRUE if the row was collapsed.
7841 gtk_tree_view_collapse_row (GtkTreeView *tree_view,
7847 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
7848 g_return_val_if_fail (tree_view->priv->tree != NULL, FALSE);
7849 g_return_val_if_fail (path != NULL, FALSE);
7851 if (_gtk_tree_view_find_node (tree_view,
7857 if (tree == NULL || node->children == NULL)
7860 return gtk_tree_view_real_collapse_row (tree_view, path, tree, node, FALSE);
7864 gtk_tree_view_map_expanded_rows_helper (GtkTreeView *tree_view,
7867 GtkTreeViewMappingFunc func,
7875 if (tree == NULL || tree->root == NULL)
7880 indices = gtk_tree_path_get_indices (path);
7881 depth = gtk_tree_path_get_depth (path);
7883 while (node && node->left != tree->nil)
7890 gtk_tree_path_append_index (path, 0);
7891 gtk_tree_view_map_expanded_rows_helper (tree_view, node->children, path, func, user_data);
7892 gtk_tree_path_up (path);
7893 (* func) (tree_view, path, user_data);
7896 indices[depth -1] = i;
7897 node = _gtk_rbtree_next (tree, node);
7902 * gtk_tree_view_map_expanded_rows:
7903 * @tree_view: A #GtkTreeView
7904 * @func: A function to be called
7905 * @data: User data to be passed to the function.
7907 * Calls @func on all expanded rows.
7910 gtk_tree_view_map_expanded_rows (GtkTreeView *tree_view,
7911 GtkTreeViewMappingFunc func,
7916 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7917 g_return_if_fail (func != NULL);
7919 path = gtk_tree_path_new_root ();
7921 gtk_tree_view_map_expanded_rows_helper (tree_view,
7922 tree_view->priv->tree,
7923 path, func, user_data);
7925 gtk_tree_path_free (path);
7929 * gtk_tree_view_row_expanded:
7930 * @tree_view: A #GtkTreeView.
7931 * @path: A #GtkTreePath to test expansion state.
7933 * Returns %TRUE if the node pointed to by @path is expanded in @tree_view.
7935 * Return value: %TRUE if #path is expanded.
7938 gtk_tree_view_row_expanded (GtkTreeView *tree_view,
7944 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
7945 g_return_val_if_fail (path != NULL, FALSE);
7947 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
7952 return (node->children != NULL);
7955 static GtkTargetEntry row_targets[] = {
7956 { "GTK_TREE_MODEL_ROW", GTK_TARGET_SAME_WIDGET, 0 }
7961 * gtk_tree_view_get_reorderable:
7962 * @tree_view: a #GtkTreeView
7964 * Retrieves whether the user can reorder the tree via drag-and-drop. See
7965 * gtk_tree_view_set_reorderable().
7967 * Return value: %TRUE if the tree can be reordered.
7970 gtk_tree_view_get_reorderable (GtkTreeView *tree_view)
7972 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
7974 return tree_view->priv->reorderable;
7978 * gtk_tree_view_set_reorderable:
7979 * @tree_view: A #GtkTreeView.
7980 * @reorderable: %TRUE, if the tree can be reordered.
7982 * This function is a convenience function to allow you to reorder models that
7983 * support the #GtkDragSourceIface and the #GtkDragDestIface. Both
7984 * #GtkTreeStore and #GtkListStore support these. If @reorderable is %TRUE, then
7985 * the user can reorder the model by dragging and dropping columns. The
7986 * developer can listen to these changes by connecting to the model's
7989 * This function does not give you any degree of control over the order -- any
7990 * reorderering is allowed. If more control is needed, you should probably
7991 * handle drag and drop manually.
7994 gtk_tree_view_set_reorderable (GtkTreeView *tree_view,
7995 gboolean reorderable)
7997 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7999 reorderable = reorderable != FALSE;
8001 if (tree_view->priv->reorderable == reorderable)
8004 tree_view->priv->reorderable = reorderable;
8008 gtk_tree_view_enable_model_drag_source (tree_view,
8011 G_N_ELEMENTS (row_targets),
8013 gtk_tree_view_enable_model_drag_dest (tree_view,
8015 G_N_ELEMENTS (row_targets),
8020 gtk_tree_view_unset_rows_drag_source (tree_view);
8021 gtk_tree_view_unset_rows_drag_dest (tree_view);
8024 g_object_notify (G_OBJECT (tree_view), "reorderable");
8028 gtk_tree_view_real_set_cursor (GtkTreeView *tree_view,
8030 gboolean clear_and_select)
8032 GtkRBTree *tree = NULL;
8033 GtkRBNode *node = NULL;
8034 GdkModifierType state = 0;
8036 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
8038 GtkTreePath *cursor_path;
8039 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
8040 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
8041 gtk_tree_path_free (cursor_path);
8044 gtk_tree_row_reference_free (tree_view->priv->cursor);
8045 gtk_get_current_event_state (&state);
8047 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
8048 tree_view->priv->model,
8050 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
8053 if (clear_and_select && !((state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK))
8054 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
8057 gtk_tree_view_clamp_node_visible (tree_view, tree, node);
8058 gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
8061 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[CURSOR_CHANGED], 0);
8065 * gtk_tree_view_get_cursor:
8066 * @tree_view: A #GtkTreeView
8067 * @path: A pointer to be filled with the current cursor path, or %NULL
8068 * @focus_column: A pointer to be filled with the current focus column, or %NULL
8070 * Fills in @path and @focus_column with the current path and focus column. If
8071 * the cursor isn't currently set, then *@path will be %NULL. If no column
8072 * currently has focus, then *@focus_column will be %NULL.
8075 gtk_tree_view_get_cursor (GtkTreeView *tree_view,
8077 GtkTreeViewColumn **focus_column)
8079 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8083 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
8084 *path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
8091 *focus_column = tree_view->priv->focus_column;
8096 * gtk_tree_view_set_cursor:
8097 * @tree_view: A #GtkTreeView
8098 * @path: A #GtkTreePath
8099 * @focus_column: A #GtkTreeViewColumn, or %NULL
8100 * @start_editing: %TRUE if the specified cell should start being edited.
8102 * Sets the current keyboard focus to be at @path, and selects it. This is
8103 * useful when you want to focus the user's attention on a particular row. If
8104 * @column is not %NULL, then focus is given to the column specified by it.
8105 * Additionally, if @column is specified, and @start_editing is %TRUE, then
8106 * editing should be started in the specified cell. Keyboard focus is given to
8107 * the widget after this is called. Please note that editing can only happen
8108 * when the widget is realized.
8111 gtk_tree_view_set_cursor (GtkTreeView *tree_view,
8113 GtkTreeViewColumn *focus_column,
8114 gboolean start_editing)
8116 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8117 g_return_if_fail (path != NULL);
8119 g_return_if_fail (GTK_IS_TREE_VIEW_COLUMN (focus_column));
8121 gtk_tree_view_real_set_cursor (tree_view, path, TRUE);
8123 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
8124 if (focus_column && focus_column->visible)
8127 gboolean column_in_tree = FALSE;
8129 for (list = tree_view->priv->columns; list; list = list->next)
8130 if (list->data == focus_column)
8132 column_in_tree = TRUE;
8135 g_return_if_fail (column_in_tree);
8136 tree_view->priv->focus_column = focus_column;
8138 gtk_tree_view_start_editing (tree_view, path);
8144 * gtk_tree_view_get_bin_window:
8145 * @tree_view: A #GtkTreeView
8147 * Returns the window that @tree_view renders to. This is used primarily to
8148 * compare to <literal>event->window</literal> to confirm that the event on
8149 * @tree_view is on the right window.
8151 * Return value: A #GdkWindow, or %NULL when @tree_view hasn't been realized yet
8154 gtk_tree_view_get_bin_window (GtkTreeView *tree_view)
8156 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
8158 return tree_view->priv->bin_window;
8162 * gtk_tree_view_get_path_at_pos:
8163 * @tree_view: A #GtkTreeView.
8164 * @x: The x position to be identified.
8165 * @y: The y position to be identified.
8166 * @path: A pointer to a #GtkTreePath pointer to be filled in, or %NULL
8167 * @column: A pointer to a #GtkTreeViewColumn pointer to be filled in, or %NULL
8168 * @cell_x: A pointer where the X coordinate relative to the cell can be placed, or %NULL
8169 * @cell_y: A pointer where the Y coordinate relative to the cell can be placed, or %NULL
8171 * Finds the path at the point (@x, @y), relative to widget coordinates. That
8172 * is, @x and @y are relative to an events coordinates. It is primarily for
8173 * things like popup menus. If @path is non-%NULL, then it will be filled with
8174 * the #GtkTreePath at that point. This path should be freed with
8175 * gtk_tree_path_free(). If @column is non-%NULL, then it will be filled with
8176 * the column at that point. @cell_x and @cell_y return the coordinates relative
8177 * to the cell background (i.e. the @background_area passed to
8178 * gtk_cell_renderer_render()). This function is only meaningful if @tree_view
8181 * Return value: %TRUE if a row exists at that coordinate.
8184 gtk_tree_view_get_path_at_pos (GtkTreeView *tree_view,
8188 GtkTreeViewColumn **column,
8196 g_return_val_if_fail (tree_view != NULL, FALSE);
8197 g_return_val_if_fail (tree_view->priv->bin_window != NULL, FALSE);
8204 if (tree_view->priv->tree == NULL)
8207 if (x > tree_view->priv->hadjustment->upper)
8213 if (column || cell_x)
8215 GtkTreeViewColumn *tmp_column;
8216 GtkTreeViewColumn *last_column = NULL;
8218 gint remaining_x = x;
8219 gboolean found = FALSE;
8221 for (list = tree_view->priv->columns; list; list = list->next)
8223 tmp_column = list->data;
8225 if (tmp_column->visible == FALSE)
8228 last_column = tmp_column;
8229 if (remaining_x <= tmp_column->width)
8234 *column = tmp_column;
8237 *cell_x = remaining_x;
8241 remaining_x -= tmp_column->width;
8247 *column = last_column;
8250 *cell_x = last_column->width + remaining_x;
8254 if (y < TREE_VIEW_HEADER_HEIGHT (tree_view))
8257 y_offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
8258 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, y + tree_view->priv->vadjustment->value),
8268 *path = _gtk_tree_view_find_path (tree_view, tree, node);
8275 * gtk_tree_view_get_cell_area:
8276 * @tree_view: a #GtkTreeView
8277 * @path: a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
8278 * @column: a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
8279 * @rect: rectangle to fill with cell rect
8281 * Fills the bounding rectangle in tree window coordinates for the cell at the
8282 * row specified by @path and the column specified by @column. If @path is
8283 * %NULL, or points to a path not currently displayed, the @y and @height fields
8284 * of the rectangle will be filled with 0. If @column is %NULL, the @x and @width
8285 * fields will be filled with 0. The sum of all cell rects does not cover the
8286 * entire tree; there are extra pixels in between rows, for example. The
8287 * returned rectangle is equivalent to the @cell_area passed to
8288 * gtk_cell_renderer_render(). This function is only valid if #tree_view is
8292 gtk_tree_view_get_cell_area (GtkTreeView *tree_view,
8294 GtkTreeViewColumn *column,
8297 GtkRBTree *tree = NULL;
8298 GtkRBNode *node = NULL;
8299 gint vertical_separator;
8300 gint horizontal_separator;
8302 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8303 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
8304 g_return_if_fail (rect != NULL);
8305 g_return_if_fail (!column || column->tree_view == (GtkWidget *) tree_view);
8306 g_return_if_fail (GTK_WIDGET_REALIZED (tree_view));
8308 gtk_widget_style_get (GTK_WIDGET (tree_view),
8309 "vertical_separator", &vertical_separator,
8310 "horizontal_separator", &horizontal_separator,
8320 rect->x = column->button->allocation.x + horizontal_separator/2;
8321 rect->width = column->button->allocation.width - horizontal_separator;
8326 /* Get vertical coords */
8327 if (_gtk_tree_view_find_node (tree_view, path, &tree, &node) &&
8331 rect->y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
8332 rect->height = CELL_HEIGHT (node, vertical_separator);
8334 if (gtk_tree_view_is_expander_column (tree_view, column) &&
8335 TREE_VIEW_DRAW_EXPANDERS (tree_view))
8337 gint depth = gtk_tree_path_get_depth (path) - 1;
8338 rect->x += depth * tree_view->priv->tab_offset;
8339 rect->width -= depth * tree_view->priv->tab_offset;
8340 rect->width = MAX (rect->width, 0);
8346 * gtk_tree_view_get_background_area:
8347 * @tree_view: a #GtkTreeView
8348 * @path: a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
8349 * @column: a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
8350 * @rect: rectangle to fill with cell background rect
8352 * Fills the bounding rectangle in tree window coordinates for the cell at the
8353 * row specified by @path and the column specified by @column. If @path is
8354 * %NULL, or points to a node not found in the tree, the @y and @height fields of
8355 * the rectangle will be filled with 0. If @column is %NULL, the @x and @width
8356 * fields will be filled with 0. The returned rectangle is equivalent to the
8357 * @background_area passed to gtk_cell_renderer_render(). These background
8358 * areas tile to cover the entire tree window (except for the area used for
8359 * header buttons). Contrast with the @cell_area, returned by
8360 * gtk_tree_view_get_cell_area(), which returns only the cell itself, excluding
8361 * surrounding borders and the tree expander area.
8365 gtk_tree_view_get_background_area (GtkTreeView *tree_view,
8367 GtkTreeViewColumn *column,
8370 GtkRBTree *tree = NULL;
8371 GtkRBNode *node = NULL;
8373 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8374 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
8375 g_return_if_fail (rect != NULL);
8384 /* Get vertical coords */
8386 if (_gtk_tree_view_find_node (tree_view, path, &tree, &node) &&
8390 rect->y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
8392 rect->height = BACKGROUND_HEIGHT (node);
8399 gtk_tree_view_get_background_xrange (tree_view, tree, column, &rect->x, &x2);
8400 rect->width = x2 - rect->x;
8405 * gtk_tree_view_get_visible_rect:
8406 * @tree_view: a #GtkTreeView
8407 * @visible_rect: rectangle to fill
8409 * Fills @visible_rect with the currently-visible region of the
8410 * buffer, in tree coordinates. Convert to widget coordinates with
8411 * gtk_tree_view_tree_to_widget_coords(). Tree coordinates start at
8412 * 0,0 for row 0 of the tree, and cover the entire scrollable area of
8416 gtk_tree_view_get_visible_rect (GtkTreeView *tree_view,
8417 GdkRectangle *visible_rect)
8421 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8423 widget = GTK_WIDGET (tree_view);
8427 visible_rect->x = tree_view->priv->hadjustment->value;
8428 visible_rect->y = tree_view->priv->vadjustment->value;
8429 visible_rect->width = widget->allocation.width;
8430 visible_rect->height = widget->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
8435 * gtk_tree_view_widget_to_tree_coords:
8436 * @tree_view: a #GtkTreeView
8437 * @wx: widget X coordinate
8438 * @wy: widget Y coordinate
8439 * @tx: return location for tree X coordinate
8440 * @ty: return location for tree Y coordinate
8442 * Converts widget coordinates to coordinates for the
8443 * tree window (the full scrollable area of the tree).
8447 gtk_tree_view_widget_to_tree_coords (GtkTreeView *tree_view,
8453 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8456 *tx = wx + tree_view->priv->hadjustment->value;
8458 *ty = wy + tree_view->priv->vadjustment->value;
8462 * gtk_tree_view_tree_to_widget_coords:
8463 * @tree_view: a #GtkTreeView
8464 * @tx: tree X coordinate
8465 * @ty: tree Y coordinate
8466 * @wx: return location for widget X coordinate
8467 * @wy: return location for widget Y coordinate
8469 * Converts tree coordinates (coordinates in full scrollable area of the tree)
8470 * to widget coordinates.
8474 gtk_tree_view_tree_to_widget_coords (GtkTreeView *tree_view,
8480 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8483 *wx = tx - tree_view->priv->hadjustment->value;
8485 *wy = ty - tree_view->priv->vadjustment->value;
8489 unset_reorderable (GtkTreeView *tree_view)
8491 if (tree_view->priv->reorderable)
8493 tree_view->priv->reorderable = FALSE;
8494 g_object_notify (G_OBJECT (tree_view), "reorderable");
8499 gtk_tree_view_enable_model_drag_source (GtkTreeView *tree_view,
8500 GdkModifierType start_button_mask,
8501 const GtkTargetEntry *targets,
8503 GdkDragAction actions)
8505 TreeViewDragInfo *di;
8507 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8509 di = ensure_info (tree_view);
8510 clear_source_info (di);
8512 di->start_button_mask = start_button_mask;
8513 di->source_target_list = gtk_target_list_new (targets, n_targets);
8514 di->source_actions = actions;
8516 di->source_set = TRUE;
8518 unset_reorderable (tree_view);
8522 gtk_tree_view_enable_model_drag_dest (GtkTreeView *tree_view,
8523 const GtkTargetEntry *targets,
8525 GdkDragAction actions)
8527 TreeViewDragInfo *di;
8529 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8531 gtk_drag_dest_set (GTK_WIDGET (tree_view),
8537 di = ensure_info (tree_view);
8538 clear_dest_info (di);
8541 di->dest_target_list = gtk_target_list_new (targets, n_targets);
8543 di->dest_set = TRUE;
8545 unset_reorderable (tree_view);
8549 gtk_tree_view_unset_rows_drag_source (GtkTreeView *tree_view)
8551 TreeViewDragInfo *di;
8553 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8555 di = get_info (tree_view);
8561 clear_source_info (di);
8562 di->source_set = FALSE;
8565 if (!di->dest_set && !di->source_set)
8566 remove_info (tree_view);
8569 unset_reorderable (tree_view);
8573 gtk_tree_view_unset_rows_drag_dest (GtkTreeView *tree_view)
8575 TreeViewDragInfo *di;
8577 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8579 di = get_info (tree_view);
8585 gtk_drag_dest_unset (GTK_WIDGET (tree_view));
8586 clear_dest_info (di);
8587 di->dest_set = FALSE;
8590 if (!di->dest_set && !di->source_set)
8591 remove_info (tree_view);
8594 unset_reorderable (tree_view);
8598 gtk_tree_view_set_drag_dest_row (GtkTreeView *tree_view,
8600 GtkTreeViewDropPosition pos)
8602 GtkTreePath *current_dest;
8603 /* Note; this function is exported to allow a custom DND
8604 * implementation, so it can't touch TreeViewDragInfo
8607 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8609 current_dest = NULL;
8611 if (tree_view->priv->drag_dest_row)
8612 current_dest = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
8616 gtk_tree_view_queue_draw_path (tree_view, current_dest, NULL);
8617 gtk_tree_path_free (current_dest);
8620 if (tree_view->priv->drag_dest_row)
8621 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
8623 tree_view->priv->drag_dest_pos = pos;
8627 tree_view->priv->drag_dest_row =
8628 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
8629 gtk_tree_view_queue_draw_path (tree_view, path, NULL);
8632 tree_view->priv->drag_dest_row = NULL;
8636 gtk_tree_view_get_drag_dest_row (GtkTreeView *tree_view,
8638 GtkTreeViewDropPosition *pos)
8640 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8644 if (tree_view->priv->drag_dest_row)
8645 *path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
8651 *pos = tree_view->priv->drag_dest_pos;
8655 gtk_tree_view_get_dest_row_at_pos (GtkTreeView *tree_view,
8659 GtkTreeViewDropPosition *pos)
8662 gdouble offset_into_row;
8666 GtkTreeViewColumn *column = NULL;
8667 GtkTreePath *tmp_path = NULL;
8669 /* Note; this function is exported to allow a custom DND
8670 * implementation, so it can't touch TreeViewDragInfo
8673 g_return_val_if_fail (tree_view != NULL, FALSE);
8674 g_return_val_if_fail (drag_x >= 0, FALSE);
8675 g_return_val_if_fail (drag_y >= 0, FALSE);
8676 g_return_val_if_fail (tree_view->priv->bin_window != NULL, FALSE);
8682 if (tree_view->priv->tree == NULL)
8685 /* remember that drag_x and drag_y are in widget coords, convert to tree window */
8687 gtk_tree_view_widget_to_tree_coords (tree_view, drag_x, drag_y,
8690 /* If in the top quarter of a row, we drop before that row; if
8691 * in the bottom quarter, drop after that row; if in the middle,
8692 * and the row has children, drop into the row.
8695 if (!gtk_tree_view_get_path_at_pos (tree_view,
8703 gtk_tree_view_get_background_area (tree_view, tmp_path, column,
8706 offset_into_row = cell_y;
8711 gtk_tree_path_free (tmp_path);
8715 quarter = cell.height / 4.0;
8719 if (offset_into_row < quarter)
8721 *pos = GTK_TREE_VIEW_DROP_BEFORE;
8723 else if (offset_into_row < quarter * 2)
8725 *pos = GTK_TREE_VIEW_DROP_INTO_OR_BEFORE;
8727 else if (offset_into_row < quarter * 3)
8729 *pos = GTK_TREE_VIEW_DROP_INTO_OR_AFTER;
8733 *pos = GTK_TREE_VIEW_DROP_AFTER;
8742 /* KEEP IN SYNC WITH GTK_TREE_VIEW_BIN_EXPOSE */
8744 * gtk_tree_view_create_row_drag_icon:
8745 * @tree_view: a #GtkTreeView
8746 * @path: a #GtkTreePath in @tree_view
8748 * Creates a #GdkPixmap representation of the row at @path. This image is used
8751 * Return value: a newly-allocated pixmap of the drag icon.
8754 gtk_tree_view_create_row_drag_icon (GtkTreeView *tree_view,
8762 GdkRectangle background_area;
8763 GdkRectangle expose_area;
8766 /* start drawing inside the black outline */
8768 GdkDrawable *drawable;
8769 gint bin_window_width;
8771 widget = GTK_WIDGET (tree_view);
8773 depth = gtk_tree_path_get_depth (path);
8775 _gtk_tree_view_find_node (tree_view,
8783 if (!gtk_tree_model_get_iter (tree_view->priv->model,
8790 background_area.y = y;
8791 background_area.height = BACKGROUND_HEIGHT (node);
8793 gdk_drawable_get_size (tree_view->priv->bin_window,
8794 &bin_window_width, NULL);
8796 drawable = gdk_pixmap_new (tree_view->priv->bin_window,
8797 bin_window_width + 2,
8798 background_area.height + 2,
8803 expose_area.width = bin_window_width + 2;
8804 expose_area.height = background_area.height + 2;
8806 gdk_draw_rectangle (drawable,
8807 widget->style->base_gc [GTK_WIDGET_STATE (widget)],
8810 bin_window_width + 2,
8811 background_area.height + 2);
8813 gdk_draw_rectangle (drawable,
8814 widget->style->black_gc,
8817 bin_window_width + 1,
8818 background_area.height + 1);
8820 for (list = tree_view->priv->columns; list; list = list->next)
8822 GtkTreeViewColumn *column = list->data;
8823 GdkRectangle cell_area;
8824 gint vertical_separator;
8826 if (!column->visible)
8829 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, &iter,
8830 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
8831 node->children?TRUE:FALSE);
8833 background_area.x = cell_offset;
8834 background_area.width = column->width;
8836 cell_area = background_area;
8838 gtk_widget_style_get (widget, "vertical_separator", &vertical_separator, NULL);
8839 cell_area.y += vertical_separator / 2;
8840 cell_area.height -= vertical_separator;
8842 if (gtk_tree_view_is_expander_column (tree_view, column) &&
8843 TREE_VIEW_DRAW_EXPANDERS(tree_view))
8845 cell_area.x += depth * tree_view->priv->tab_offset;
8846 cell_area.width -= depth * tree_view->priv->tab_offset;
8849 if (gtk_tree_view_column_cell_is_visible (column))
8850 gtk_tree_view_column_cell_render (column,
8857 cell_offset += column->width;
8865 * gtk_tree_view_set_destroy_count_func:
8866 * @tree_view: A #GtkTreeView
8867 * @func: Function to be called when a view row is destroyed, or %NULL
8868 * @data: User data to be passed to @func, or %NULL
8869 * @destroy: Destroy notifier for @data, or %NULL
8871 * This function should almost never be used. It is meant for private use by
8872 * ATK for determining the number of visible children that are removed when the
8873 * user collapses a row, or a row is deleted.
8876 gtk_tree_view_set_destroy_count_func (GtkTreeView *tree_view,
8877 GtkTreeDestroyCountFunc func,
8879 GtkDestroyNotify destroy)
8881 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8883 if (tree_view->priv->destroy_count_destroy)
8884 (* tree_view->priv->destroy_count_destroy) (tree_view->priv->destroy_count_data);
8886 tree_view->priv->destroy_count_func = func;
8887 tree_view->priv->destroy_count_data = data;
8888 tree_view->priv->destroy_count_destroy = destroy;
8893 * Interactive search
8897 * gtk_tree_view_set_enable_search:
8898 * @tree_view: A #GtkTreeView
8899 * @enable_search: %TRUE, if the user can search interactively
8901 * If @enable_search is set, then the user can type in text to search through
8902 * the tree interactively.
8905 gtk_tree_view_set_enable_search (GtkTreeView *tree_view,
8906 gboolean enable_search)
8908 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8910 tree_view->priv->enable_search = !!enable_search;
8914 * gtk_tree_view_get_enable_search:
8915 * @tree_view: A #GtkTreeView
8917 * Returns whether or not the tree allows interactive searching.
8919 * Return value: whether or not to let the user search interactively
8922 gtk_tree_view_get_enable_search (GtkTreeView *tree_view)
8924 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
8926 return tree_view->priv->enable_search;
8931 * gtk_tree_view_get_search_column:
8932 * @tree_view: A #GtkTreeView
8934 * Gets the column searched on by the interactive search code.
8936 * Return value: the column the interactive search code searches in.
8939 gtk_tree_view_get_search_column (GtkTreeView *tree_view)
8941 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), 0);
8943 return (tree_view->priv->search_column);
8947 * gtk_tree_view_set_search_column:
8948 * @tree_view: A #GtkTreeView
8949 * @column: the column to search in
8951 * Sets @column as the column where the interactive search code should search
8952 * in. Additionally, turns on interactive searching.
8955 gtk_tree_view_set_search_column (GtkTreeView *tree_view,
8958 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8959 g_return_if_fail (column >= 0);
8961 if (tree_view->priv->search_column == column)
8964 tree_view->priv->search_column = column;
8969 * gtk_tree_view_search_get_search_equal_func:
8970 * @tree_view: A #GtkTreeView
8972 * Returns the compare function currently in use.
8974 * Return value: the currently used compare function for the search code.
8977 GtkTreeViewSearchEqualFunc
8978 gtk_tree_view_get_search_equal_func (GtkTreeView *tree_view)
8980 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
8982 return tree_view->priv->search_equal_func;
8986 * gtk_tree_view_set_search_equal_func:
8987 * @tree_view: A #GtkTreeView
8988 * @search_equal_func: the compare function to use during the search
8989 * @search_user_data: user data to pass to @search_equal_func, or %NULL
8990 * @search_destroy: Destroy notifier for @search_user_data, or %NULL
8992 * Sets the compare function for the interactive search capabilities.
8995 gtk_tree_view_set_search_equal_func (GtkTreeView *tree_view,
8996 GtkTreeViewSearchEqualFunc search_equal_func,
8997 gpointer search_user_data,
8998 GtkDestroyNotify search_destroy)
9000 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9001 g_return_if_fail (search_equal_func !=NULL);
9003 if (tree_view->priv->search_destroy)
9004 (* tree_view->priv->search_destroy) (tree_view->priv->search_user_data);
9006 tree_view->priv->search_equal_func = search_equal_func;
9007 tree_view->priv->search_user_data = search_user_data;
9008 tree_view->priv->search_destroy = search_destroy;
9009 if (tree_view->priv->search_equal_func == NULL)
9010 tree_view->priv->search_equal_func = gtk_tree_view_search_equal_func;
9014 gtk_tree_view_search_dialog_destroy (GtkWidget *search_dialog,
9015 GtkTreeView *tree_view)
9017 /* remove data from tree_view */
9018 gtk_object_remove_data (GTK_OBJECT (tree_view),
9019 GTK_TREE_VIEW_SEARCH_DIALOG_KEY);
9021 gtk_widget_destroy (search_dialog);
9025 gtk_tree_view_search_position_func (GtkTreeView *tree_view,
9026 GtkWidget *search_dialog)
9028 gint tree_x, tree_y;
9029 gint tree_width, tree_height;
9030 GdkWindow *tree_window = GTK_WIDGET (tree_view)->window;
9031 GtkRequisition requisition;
9033 /* put window in the lower right corner */
9034 gdk_window_get_origin (tree_window, &tree_x, &tree_y);
9035 gdk_window_get_size (tree_window,
9038 gtk_widget_size_request (search_dialog, &requisition);
9039 gtk_window_move (GTK_WINDOW (search_dialog),
9040 tree_x + tree_width - requisition.width,
9041 tree_y + tree_height);
9045 gtk_tree_view_search_delete_event (GtkWidget *widget,
9047 GtkTreeView *tree_view)
9049 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
9051 gtk_tree_view_search_dialog_destroy (widget, tree_view);
9057 gtk_tree_view_search_button_press_event (GtkWidget *widget,
9058 GdkEventButton *event,
9059 GtkTreeView *tree_view)
9061 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
9063 gtk_tree_view_search_dialog_destroy (widget, tree_view);
9069 gtk_tree_view_search_key_press_event (GtkWidget *widget,
9071 GtkTreeView *tree_view)
9073 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
9074 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
9077 if (event->keyval == GDK_Escape ||
9078 event->keyval == GDK_Return ||
9079 event->keyval == GDK_Tab)
9081 gtk_tree_view_search_dialog_destroy (widget, tree_view);
9085 /* select previous matching iter */
9086 if (event->keyval == GDK_Up)
9088 gtk_tree_view_search_move (widget, tree_view, TRUE);
9092 /* select next matching iter */
9093 if (event->keyval == GDK_Down)
9095 gtk_tree_view_search_move (widget, tree_view, FALSE);
9103 gtk_tree_view_search_move (GtkWidget *window,
9104 GtkTreeView *tree_view,
9108 gint *selected_iter;
9113 GtkTreeModel *model;
9114 GtkTreeSelection *selection;
9116 text = gtk_object_get_data (GTK_OBJECT (window), "gtk-tree-view-text");
9117 selected_iter = gtk_object_get_data (GTK_OBJECT (window), "gtk-tree-view-selected-iter");
9119 g_return_if_fail (text != NULL);
9121 if (!selected_iter || (up && *selected_iter == 1))
9124 len = strlen (text);
9129 model = gtk_tree_view_get_model (tree_view);
9130 selection = gtk_tree_view_get_selection (tree_view);
9133 gtk_tree_selection_unselect_all (selection);
9134 gtk_tree_model_get_iter_root (model, &iter);
9136 ret = gtk_tree_view_search_iter (model, selection, &iter, text,
9137 &count, up?((*selected_iter) - 1):((*selected_iter + 1)));
9142 *selected_iter += up?(-1):(1);
9146 /* return to old iter */
9148 gtk_tree_model_get_iter_root (model, &iter);
9149 gtk_tree_view_search_iter (model, selection,
9151 &count, *selected_iter);
9156 gtk_tree_view_search_equal_func (GtkTreeModel *model,
9160 gpointer search_data)
9162 gboolean retval = TRUE;
9163 gchar *normalized_string;
9164 gchar *normalized_key;
9165 gchar *case_normalized_string;
9166 gchar *case_normalized_key;
9167 GValue value = {0,};
9170 gtk_tree_model_get_value (model, iter, column, &value);
9171 normalized_string = g_utf8_normalize (g_value_get_string (&value), -1, G_NORMALIZE_ALL);
9172 normalized_key = g_utf8_normalize (key, -1, G_NORMALIZE_ALL);
9173 case_normalized_string = g_utf8_casefold (normalized_string, -1);
9174 case_normalized_key = g_utf8_casefold (normalized_key, -1);
9176 key_len = strlen (case_normalized_key);
9178 if (!strncmp (case_normalized_key, case_normalized_string, key_len))
9181 g_value_unset (&value);
9182 g_free (normalized_key);
9183 g_free (normalized_string);
9184 g_free (case_normalized_key);
9185 g_free (case_normalized_string);
9191 gtk_tree_view_search_iter (GtkTreeModel *model,
9192 GtkTreeSelection *selection,
9198 GtkRBTree *tree = NULL;
9199 GtkRBNode *node = NULL;
9202 GtkTreeView *tree_view = gtk_tree_selection_get_tree_view (selection);
9203 GtkTreeViewColumn *column =
9204 gtk_tree_view_get_column (tree_view, tree_view->priv->search_column);
9206 path = gtk_tree_model_get_path (model, iter);
9207 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
9211 if (! tree_view->priv->search_equal_func (model, tree_view->priv->search_column, text, iter, tree_view->priv->search_user_data))
9216 gtk_tree_selection_select_iter (selection, iter);
9217 gtk_tree_view_scroll_to_cell (tree_view, path, column,
9219 gtk_tree_view_real_set_cursor (tree_view, path, FALSE);
9222 gtk_tree_path_free (path);
9233 tree = node->children;
9236 while (node->left != tree->nil)
9240 has_child = gtk_tree_model_iter_children (model, iter, &tmp);
9241 gtk_tree_path_append_index (path, 0);
9244 TREE_VIEW_INTERNAL_ASSERT (has_child, FALSE);
9248 gboolean done = FALSE;
9252 node = _gtk_rbtree_next (tree, node);
9258 has_next = gtk_tree_model_iter_next (model, iter);
9261 gtk_tree_path_next (path);
9264 TREE_VIEW_INTERNAL_ASSERT (has_next, FALSE);
9268 gboolean has_parent;
9269 GtkTreeIter tmp_iter = *iter;
9271 node = tree->parent_node;
9272 tree = tree->parent_tree;
9277 gtk_tree_path_free (path);
9279 /* we've run out of tree, done with this func */
9283 has_parent = gtk_tree_model_iter_parent (model,
9286 gtk_tree_path_up (path);
9289 TREE_VIEW_INTERNAL_ASSERT (has_parent, FALSE);
9298 gtk_tree_path_free (path);
9304 gtk_tree_view_search_init (GtkWidget *entry,
9305 GtkTreeView *tree_view)
9308 gint *selected_iter;
9314 GtkTreeModel *model;
9315 GtkTreeSelection *selection;
9317 g_return_if_fail (GTK_IS_ENTRY (entry));
9318 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
9320 window = gtk_widget_get_parent (entry);
9321 text = gtk_entry_get_text (GTK_ENTRY (entry));
9322 len = strlen (text);
9323 model = gtk_tree_view_get_model (tree_view);
9324 selection = gtk_tree_view_get_selection (tree_view);
9327 gtk_tree_selection_unselect_all (selection);
9328 selected_iter = gtk_object_get_data (GTK_OBJECT (window), "gtk-tree-view-selected-iter");
9330 g_free (selected_iter);
9331 gtk_object_remove_data (GTK_OBJECT (window), "gtk-tree-view-selected-iter");
9336 gtk_tree_model_get_iter_root (model, &iter);
9338 ret = gtk_tree_view_search_iter (model, selection,
9344 selected_iter = g_malloc (sizeof (int));
9346 gtk_object_set_data (GTK_OBJECT (window), "gtk-tree-view-selected-iter",
9352 gtk_tree_view_remove_widget (GtkCellEditable *cell_editable,
9353 GtkTreeView *tree_view)
9355 g_return_if_fail (tree_view->priv->edited_column != NULL);
9356 _gtk_tree_view_column_stop_editing (tree_view->priv->edited_column);
9357 tree_view->priv->edited_column = NULL;
9359 gtk_container_remove (GTK_CONTAINER (tree_view),
9360 GTK_WIDGET (cell_editable));
9361 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
9365 gtk_tree_view_start_editing (GtkTreeView *tree_view,
9366 GtkTreePath *cursor_path)
9369 GdkRectangle background_area;
9370 GdkRectangle cell_area;
9371 GtkCellEditable *editable_widget = NULL;
9373 guint flags = 0; /* can be 0, as the flags are primarily for rendering */
9374 gint retval = FALSE;
9375 GtkRBTree *cursor_tree;
9376 GtkRBNode *cursor_node;
9378 g_assert (tree_view->priv->focus_column);
9380 if (! GTK_WIDGET_REALIZED (tree_view))
9383 if (_gtk_tree_view_find_node (tree_view, cursor_path, &cursor_tree, &cursor_node) ||
9384 cursor_node == NULL)
9387 path_string = gtk_tree_path_to_string (cursor_path);
9388 gtk_tree_model_get_iter (tree_view->priv->model, &iter, cursor_path);
9389 gtk_tree_view_column_cell_set_cell_data (tree_view->priv->focus_column,
9390 tree_view->priv->model,
9392 GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_PARENT),
9393 cursor_node->children?TRUE:FALSE);
9394 gtk_tree_view_get_background_area (tree_view,
9396 tree_view->priv->focus_column,
9398 gtk_tree_view_get_cell_area (tree_view,
9400 tree_view->priv->focus_column,
9402 if (_gtk_tree_view_column_cell_event (tree_view->priv->focus_column,
9411 if (editable_widget != NULL)
9413 gtk_tree_view_real_start_editing (tree_view,
9414 tree_view->priv->focus_column,
9423 g_free (path_string);
9428 gtk_tree_view_real_start_editing (GtkTreeView *tree_view,
9429 GtkTreeViewColumn *column,
9431 GtkCellEditable *cell_editable,
9432 GdkRectangle *cell_area,
9436 tree_view->priv->edited_column = column;
9437 _gtk_tree_view_column_start_editing (column, GTK_CELL_EDITABLE (cell_editable));
9438 gtk_tree_view_real_set_cursor (tree_view, path, FALSE);
9439 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
9440 gtk_tree_view_put (tree_view,
9441 GTK_WIDGET (cell_editable),
9442 cell_area->x, cell_area->y, cell_area->width, cell_area->height);
9443 gtk_cell_editable_start_editing (GTK_CELL_EDITABLE (cell_editable),
9445 gtk_widget_grab_focus (GTK_WIDGET (cell_editable));
9446 g_signal_connect (cell_editable, "remove_widget", G_CALLBACK (gtk_tree_view_remove_widget), tree_view);
9450 gtk_tree_view_stop_editing (GtkTreeView *tree_view)
9452 if (tree_view->priv->edited_column == NULL)
9455 gtk_cell_editable_editing_done (tree_view->priv->edited_column->editable_widget);
9456 gtk_cell_editable_remove_widget (tree_view->priv->edited_column->editable_widget);