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 "gtkbutton.h"
29 #include "gtkalignment.h"
34 #include "gtkbindings.h"
36 #include <gdk/gdkkeysyms.h>
38 #if defined (GDK_WINDOWING_X11)
40 #elif defined (GDK_WINDOWING_WIN32)
41 #include "win32/gdkwin32.h"
42 #elif defined(GDK_WINDOWING_FB)
43 #include "linux-fb/gdkfb.h"
44 #elif defined (GDK_WINDOWING_NANOX)
45 #include "nanox/gdkprivate-nanox.h"
49 #define SCROLL_EDGE_SIZE 15
52 /* The "background" areas of all rows/cells add up to cover the entire tree.
53 * The background includes all inter-row and inter-cell spacing.
54 * The "cell" areas are the cell_area passed in to gtk_cell_renderer_render(),
55 * i.e. just the cells, no spacing.
57 #define BACKGROUND_FIRST_PIXEL(tree_view,tree,node) (_gtk_rbtree_node_find_offset ((tree), (node)) + TREE_VIEW_HEADER_HEIGHT ((tree_view)))
58 #define CELL_FIRST_PIXEL(tree_view,tree,node,separator) (BACKGROUND_FIRST_PIXEL (tree_view,tree,node) + separator/2)
60 #define BACKGROUND_HEIGHT(node) (GTK_RBNODE_GET_HEIGHT (node))
61 #define CELL_HEIGHT(node, separator) (BACKGROUND_HEIGHT (node) - separator);
63 #define TREE_WINDOW_Y_TO_RBTREE_Y(tree_view,y) ((y) - TREE_VIEW_HEADER_HEIGHT (tree_view))
64 #define RBTREE_Y_TO_TREE_WINDOW_Y(tree_view,y) ((y) + TREE_VIEW_HEADER_HEIGHT (tree_view))
67 typedef struct _GtkTreeViewChild GtkTreeViewChild;
68 struct _GtkTreeViewChild
76 typedef struct _TreeViewDragInfo TreeViewDragInfo;
77 struct _TreeViewDragInfo
79 GdkModifierType start_button_mask;
80 GtkTargetList *source_target_list;
81 GdkDragAction source_actions;
82 GClosure *row_draggable_closure;
84 GtkTargetList *dest_target_list;
85 GClosure *location_droppable_closure;
102 EXPAND_COLLAPSE_CURSOR_ROW,
103 SELECT_CURSOR_PARENT,
113 PROP_HEADERS_VISIBLE,
114 PROP_HEADERS_CLICKABLE,
115 PROP_EXPANDER_COLUMN,
120 static void gtk_tree_view_class_init (GtkTreeViewClass *klass);
121 static void gtk_tree_view_init (GtkTreeView *tree_view);
124 static void gtk_tree_view_finalize (GObject *object);
125 static void gtk_tree_view_set_property (GObject *object,
129 static void gtk_tree_view_get_property (GObject *object,
134 /* gtkobject signals */
135 static void gtk_tree_view_destroy (GtkObject *object);
137 /* gtkwidget signals */
138 static void gtk_tree_view_setup_model (GtkTreeView *tree_view);
139 static void gtk_tree_view_realize (GtkWidget *widget);
140 static void gtk_tree_view_unrealize (GtkWidget *widget);
141 static void gtk_tree_view_map (GtkWidget *widget);
142 static void gtk_tree_view_size_request (GtkWidget *widget,
143 GtkRequisition *requisition);
144 static void gtk_tree_view_size_allocate (GtkWidget *widget,
145 GtkAllocation *allocation);
146 static gboolean gtk_tree_view_expose (GtkWidget *widget,
147 GdkEventExpose *event);
148 static gboolean gtk_tree_view_key_press (GtkWidget *widget,
150 static gboolean gtk_tree_view_motion (GtkWidget *widget,
151 GdkEventMotion *event);
152 static gboolean gtk_tree_view_enter_notify (GtkWidget *widget,
153 GdkEventCrossing *event);
154 static gboolean gtk_tree_view_leave_notify (GtkWidget *widget,
155 GdkEventCrossing *event);
156 static gboolean gtk_tree_view_button_press (GtkWidget *widget,
157 GdkEventButton *event);
158 static gboolean gtk_tree_view_button_release (GtkWidget *widget,
159 GdkEventButton *event);
160 static void gtk_tree_view_set_focus_child (GtkContainer *container,
162 static void gtk_tree_view_draw_focus (GtkWidget *widget);
163 static gint gtk_tree_view_focus_in (GtkWidget *widget,
164 GdkEventFocus *event);
165 static gint gtk_tree_view_focus_out (GtkWidget *widget,
166 GdkEventFocus *event);
167 static gint gtk_tree_view_focus (GtkContainer *container,
168 GtkDirectionType direction);
170 /* container signals */
171 static void gtk_tree_view_remove (GtkContainer *container,
173 static void gtk_tree_view_forall (GtkContainer *container,
174 gboolean include_internals,
175 GtkCallback callback,
176 gpointer callback_data);
178 /* Source side drag signals */
179 static void gtk_tree_view_drag_begin (GtkWidget *widget,
180 GdkDragContext *context);
181 static void gtk_tree_view_drag_end (GtkWidget *widget,
182 GdkDragContext *context);
183 static void gtk_tree_view_drag_data_get (GtkWidget *widget,
184 GdkDragContext *context,
185 GtkSelectionData *selection_data,
188 static void gtk_tree_view_drag_data_delete (GtkWidget *widget,
189 GdkDragContext *context);
191 /* Target side drag signals */
192 static void gtk_tree_view_drag_leave (GtkWidget *widget,
193 GdkDragContext *context,
195 static gboolean gtk_tree_view_drag_motion (GtkWidget *widget,
196 GdkDragContext *context,
200 static gboolean gtk_tree_view_drag_drop (GtkWidget *widget,
201 GdkDragContext *context,
205 static void gtk_tree_view_drag_data_received (GtkWidget *widget,
206 GdkDragContext *context,
209 GtkSelectionData *selection_data,
213 /* tree_model signals */
214 static void gtk_tree_view_set_adjustments (GtkTreeView *tree_view,
216 GtkAdjustment *vadj);
217 static void gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
218 GtkMovementStep step,
220 gboolean extend_selection);
221 static void gtk_tree_view_real_set_anchor (GtkTreeView *tree_view);
222 static void gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view);
223 static void gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
227 static void gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view);
228 static void gtk_tree_view_range_changed (GtkTreeModel *model,
231 GtkTreePath *end_path,
232 GtkTreeIter *end_iter,
234 static void gtk_tree_view_inserted (GtkTreeModel *model,
238 static void gtk_tree_view_has_child_toggled (GtkTreeModel *model,
242 static void gtk_tree_view_deleted (GtkTreeModel *model,
245 static void gtk_tree_view_reordered (GtkTreeModel *model,
254 /* Internal functions */
256 static void gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
259 GtkMovementStep step,
261 static void gtk_tree_view_unref_tree (GtkTreeView *tree_view,
263 static void gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
266 GdkRectangle *clip_rect);
267 static void gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
269 GdkRectangle *clip_rect);
270 static void gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
275 static void gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
278 static gint gtk_tree_view_new_column_width (GtkTreeView *tree_view,
281 static void gtk_tree_view_ensure_scroll_timeout(GtkTreeView *tree_view,
283 static void gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
284 GtkTreeView *tree_view);
285 static gint gtk_tree_view_insert_iter_height (GtkTreeView *tree_view,
289 static void gtk_tree_view_build_tree (GtkTreeView *tree_view,
294 gboolean calc_bounds);
295 static void gtk_tree_view_calc_size (GtkTreeView *priv,
299 static gboolean gtk_tree_view_discover_dirty_iter (GtkTreeView *tree_view,
303 static void gtk_tree_view_discover_dirty (GtkTreeView *tree_view,
307 static void gtk_tree_view_check_dirty (GtkTreeView *tree_view);
308 static void gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
311 static gboolean gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
312 GdkEventMotion *event);
313 static void _gtk_tree_view_update_col_width (GtkTreeView *tree_view);
316 static void gtk_tree_view_set_cursor_focus (GtkTreeView *tree_view);
317 static void gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
319 gboolean extend_selection);
320 static void gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
322 gboolean extend_selection);
323 static void gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
325 static void gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
327 gboolean extend_selection);
330 static GtkContainerClass *parent_class = NULL;
331 static guint tree_view_signals[LAST_SIGNAL] = { 0 };
339 gtk_tree_view_get_type (void)
341 static GtkType tree_view_type = 0;
345 static const GTypeInfo tree_view_info =
347 sizeof (GtkTreeViewClass),
348 NULL, /* base_init */
349 NULL, /* base_finalize */
350 (GClassInitFunc) gtk_tree_view_class_init,
351 NULL, /* class_finalize */
352 NULL, /* class_data */
353 sizeof (GtkTreeView),
355 (GInstanceInitFunc) gtk_tree_view_init
358 tree_view_type = g_type_register_static (GTK_TYPE_CONTAINER, "GtkTreeView", &tree_view_info, 0);
361 return tree_view_type;
365 gtk_tree_view_class_init (GtkTreeViewClass *class)
367 GObjectClass *o_class;
368 GtkObjectClass *object_class;
369 GtkWidgetClass *widget_class;
370 GtkContainerClass *container_class;
371 GtkBindingSet *binding_set;
373 parent_class = g_type_class_peek_parent (class);
374 binding_set = gtk_binding_set_by_class (class);
376 o_class = (GObjectClass *) class;
377 object_class = (GtkObjectClass *) class;
378 widget_class = (GtkWidgetClass *) class;
379 container_class = (GtkContainerClass *) class;
381 /* GObject signals */
382 o_class->set_property = gtk_tree_view_set_property;
383 o_class->get_property = gtk_tree_view_get_property;
384 o_class->finalize = gtk_tree_view_finalize;
386 /* GtkObject signals */
387 object_class->destroy = gtk_tree_view_destroy;
389 /* GtkWidget signals */
390 widget_class->map = gtk_tree_view_map;
391 widget_class->realize = gtk_tree_view_realize;
392 widget_class->unrealize = gtk_tree_view_unrealize;
393 widget_class->size_request = gtk_tree_view_size_request;
394 widget_class->size_allocate = gtk_tree_view_size_allocate;
395 widget_class->button_press_event = gtk_tree_view_button_press;
396 widget_class->button_release_event = gtk_tree_view_button_release;
397 widget_class->motion_notify_event = gtk_tree_view_motion;
398 widget_class->expose_event = gtk_tree_view_expose;
399 widget_class->key_press_event = gtk_tree_view_key_press;
400 widget_class->enter_notify_event = gtk_tree_view_enter_notify;
401 widget_class->leave_notify_event = gtk_tree_view_leave_notify;
402 widget_class->focus_in_event = gtk_tree_view_focus_in;
403 widget_class->focus_out_event = gtk_tree_view_focus_out;
404 widget_class->drag_begin = gtk_tree_view_drag_begin;
405 widget_class->drag_end = gtk_tree_view_drag_end;
406 widget_class->drag_data_get = gtk_tree_view_drag_data_get;
407 widget_class->drag_data_delete = gtk_tree_view_drag_data_delete;
408 widget_class->drag_leave = gtk_tree_view_drag_leave;
409 widget_class->drag_motion = gtk_tree_view_drag_motion;
410 widget_class->drag_drop = gtk_tree_view_drag_drop;
411 widget_class->drag_data_received = gtk_tree_view_drag_data_received;
413 /* GtkContainer signals */
414 container_class->remove = gtk_tree_view_remove;
415 container_class->forall = gtk_tree_view_forall;
416 container_class->focus = gtk_tree_view_focus;
417 container_class->set_focus_child = gtk_tree_view_set_focus_child;
419 class->set_scroll_adjustments = gtk_tree_view_set_adjustments;
420 class->move_cursor = gtk_tree_view_real_move_cursor;
421 class->set_anchor = gtk_tree_view_real_set_anchor;
422 class->toggle_cursor_row = gtk_tree_view_real_toggle_cursor_row;
423 class->expand_collapse_cursor_row = gtk_tree_view_real_expand_collapse_cursor_row;
424 class->select_cursor_parent = gtk_tree_view_real_select_cursor_parent;
428 g_object_class_install_property (o_class,
430 g_param_spec_object ("model",
432 _("The model for the tree view"),
436 g_object_class_install_property (o_class,
438 g_param_spec_object ("hadjustment",
439 _("Horizontal Adjustment"),
440 _("Horizontal Adjustment for the widget"),
444 g_object_class_install_property (o_class,
446 g_param_spec_object ("vadjustment",
447 _("Vertical Adjustment"),
448 _("Vertical Adjustment for the widget"),
452 g_object_class_install_property (o_class,
453 PROP_HEADERS_VISIBLE,
454 g_param_spec_boolean ("headers_visible",
456 _("Show the column header buttons"),
460 g_object_class_install_property (o_class,
461 PROP_HEADERS_CLICKABLE,
462 g_param_spec_boolean ("headers_clickable",
463 _("Headers Clickable"),
464 _("Column headers respond to click events"),
468 g_object_class_install_property (o_class,
469 PROP_EXPANDER_COLUMN,
470 g_param_spec_uint ("expander_column",
472 _("Set the column number for the expander column"),
478 g_object_class_install_property (o_class,
480 g_param_spec_boolean ("reorderable",
482 _("View is reorderable"),
486 g_object_class_install_property (o_class,
488 g_param_spec_boolean ("rules_hint",
490 _("Set a hint to the theme engine to draw rows in alternating colors"),
494 /* Style properties */
495 /* the width of the column resize windows */
496 #define _TREE_VIEW_EXPANDER_WIDTH 14
497 #define _TREE_VIEW_EXPANDER_HEIGHT 14
498 #define _TREE_VIEW_VERTICAL_SEPARATOR 2
499 #define _TREE_VIEW_HORIZONTAL_SEPARATOR 0
501 gtk_widget_class_install_style_property (widget_class,
502 g_param_spec_int ("expander_width",
504 _("Width of the expander arrow"),
507 _TREE_VIEW_EXPANDER_WIDTH,
510 gtk_widget_class_install_style_property (widget_class,
511 g_param_spec_int ("expander_height",
512 _("Expander Height"),
513 _("Height of the expander arrow"),
516 _TREE_VIEW_EXPANDER_HEIGHT,
519 gtk_widget_class_install_style_property (widget_class,
520 g_param_spec_int ("vertical_separator",
521 _("Vertical Separator Width"),
522 _("Vertical space between cells"),
525 _TREE_VIEW_VERTICAL_SEPARATOR,
528 gtk_widget_class_install_style_property (widget_class,
529 g_param_spec_int ("horizontal_separator",
530 _("Horizontal Separator Width"),
531 _("Horizontal space between cells"),
534 _TREE_VIEW_HORIZONTAL_SEPARATOR,
538 widget_class->set_scroll_adjustments_signal =
539 gtk_signal_new ("set_scroll_adjustments",
541 GTK_CLASS_TYPE (object_class),
542 GTK_SIGNAL_OFFSET (GtkTreeViewClass, set_scroll_adjustments),
543 gtk_marshal_VOID__OBJECT_OBJECT,
545 GTK_TYPE_ADJUSTMENT, GTK_TYPE_ADJUSTMENT);
547 tree_view_signals[ROW_ACTIVATED] =
548 gtk_signal_new ("row_activated",
549 GTK_RUN_LAST | GTK_RUN_ACTION,
550 GTK_CLASS_TYPE (object_class),
551 GTK_SIGNAL_OFFSET (GtkTreeViewClass, row_activated),
552 gtk_marshal_VOID__BOXED_OBJECT,
555 GTK_TYPE_TREE_VIEW_COLUMN);
557 tree_view_signals[EXPAND_ROW] =
558 g_signal_newc ("expand_row",
559 G_TYPE_FROM_CLASS (object_class),
561 G_STRUCT_OFFSET (GtkTreeViewClass, expand_row),
562 _gtk_boolean_handled_accumulator, NULL,
563 gtk_marshal_BOOLEAN__BOXED_BOXED,
568 tree_view_signals[COLLAPSE_ROW] =
569 g_signal_newc ("collapse_row",
570 G_TYPE_FROM_CLASS (object_class),
572 G_STRUCT_OFFSET (GtkTreeViewClass, collapse_row),
573 _gtk_boolean_handled_accumulator, NULL,
574 gtk_marshal_BOOLEAN__BOXED_BOXED,
579 tree_view_signals[COLUMNS_CHANGED] =
580 g_signal_newc ("columns_changed",
581 G_TYPE_FROM_CLASS (object_class),
583 G_STRUCT_OFFSET (GtkTreeViewClass, columns_changed),
585 gtk_marshal_NONE__NONE,
588 tree_view_signals[MOVE_CURSOR] =
589 g_signal_newc ("move_cursor",
590 G_TYPE_FROM_CLASS (object_class),
591 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
592 G_STRUCT_OFFSET (GtkTreeViewClass, move_cursor),
594 gtk_marshal_VOID__ENUM_INT_BOOLEAN,
595 GTK_TYPE_NONE, 3, GTK_TYPE_MOVEMENT_STEP, GTK_TYPE_INT, GTK_TYPE_BOOL);
597 tree_view_signals[TOGGLE_CURSOR_ROW] =
598 g_signal_newc ("toggle_cursor_row",
599 G_TYPE_FROM_CLASS (object_class),
600 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
601 G_STRUCT_OFFSET (GtkTreeViewClass, toggle_cursor_row),
603 gtk_marshal_NONE__NONE,
606 tree_view_signals[EXPAND_COLLAPSE_CURSOR_ROW] =
607 g_signal_newc ("expand_collapse_cursor_row",
608 G_TYPE_FROM_CLASS (object_class),
609 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
610 G_STRUCT_OFFSET (GtkTreeViewClass, expand_collapse_cursor_row),
612 gtk_marshal_VOID__BOOLEAN_BOOLEAN_BOOLEAN,
613 GTK_TYPE_NONE, 3, GTK_TYPE_BOOL, GTK_TYPE_BOOL, GTK_TYPE_BOOL);
615 tree_view_signals[SELECT_CURSOR_PARENT] =
616 g_signal_newc ("select_cursor_parent",
617 G_TYPE_FROM_CLASS (object_class),
618 G_SIGNAL_RUN_LAST | GTK_RUN_ACTION,
619 G_STRUCT_OFFSET (GtkTreeViewClass, select_cursor_parent),
621 gtk_marshal_NONE__NONE,
625 gtk_tree_view_add_move_binding (binding_set, GDK_Up, 0,
626 GTK_MOVEMENT_DISPLAY_LINES, -1);
628 gtk_tree_view_add_move_binding (binding_set, GDK_Down, 0,
629 GTK_MOVEMENT_DISPLAY_LINES, 1);
631 gtk_tree_view_add_move_binding (binding_set, GDK_p, GDK_CONTROL_MASK,
632 GTK_MOVEMENT_DISPLAY_LINES, -1);
634 gtk_tree_view_add_move_binding (binding_set, GDK_n, GDK_CONTROL_MASK,
635 GTK_MOVEMENT_DISPLAY_LINES, 1);
637 gtk_tree_view_add_move_binding (binding_set, GDK_Home, 0,
638 GTK_MOVEMENT_BUFFER_ENDS, -1);
640 gtk_tree_view_add_move_binding (binding_set, GDK_End, 0,
641 GTK_MOVEMENT_BUFFER_ENDS, 1);
643 gtk_tree_view_add_move_binding (binding_set, GDK_Page_Up, 0,
644 GTK_MOVEMENT_PAGES, -1);
646 gtk_tree_view_add_move_binding (binding_set, GDK_Page_Down, 0,
647 GTK_MOVEMENT_PAGES, 1);
649 gtk_binding_entry_add_signal (binding_set, GDK_Right, 0, "move_cursor", 3,
650 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
652 GTK_TYPE_BOOL, FALSE);
654 gtk_binding_entry_add_signal (binding_set, GDK_Left, 0, "move_cursor", 3,
655 GTK_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
657 GTK_TYPE_BOOL, FALSE);
659 gtk_binding_entry_add_signal (binding_set, GDK_f, GDK_CONTROL_MASK, "move_cursor", 3,
660 GTK_TYPE_ENUM, GTK_MOVEMENT_LOGICAL_POSITIONS,
662 GTK_TYPE_BOOL, FALSE);
664 gtk_binding_entry_add_signal (binding_set, GDK_b, GDK_CONTROL_MASK, "move_cursor", 3,
665 GTK_TYPE_ENUM, GTK_MOVEMENT_LOGICAL_POSITIONS,
667 GTK_TYPE_BOOL, FALSE);
669 gtk_binding_entry_add_signal (binding_set, GDK_space, GDK_CONTROL_MASK, "toggle_cursor_row", 0);
671 /* expand and collapse rows */
672 gtk_binding_entry_add_signal (binding_set, GDK_plus, 0, "expand_collapse_cursor_row", 3,
673 GTK_TYPE_BOOL, FALSE,
675 GTK_TYPE_BOOL, FALSE);
676 /* Not doable on US keyboards */
677 gtk_binding_entry_add_signal (binding_set, GDK_plus, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
678 GTK_TYPE_BOOL, FALSE,
680 GTK_TYPE_BOOL, TRUE);
681 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, 0, "expand_collapse_cursor_row", 3,
682 GTK_TYPE_BOOL, FALSE,
684 GTK_TYPE_BOOL, FALSE);
685 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
686 GTK_TYPE_BOOL, FALSE,
688 GTK_TYPE_BOOL, TRUE);
689 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
690 GTK_TYPE_BOOL, FALSE,
692 GTK_TYPE_BOOL, TRUE);
693 gtk_binding_entry_add_signal (binding_set, GDK_Right, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
696 GTK_TYPE_BOOL, TRUE);
698 gtk_binding_entry_add_signal (binding_set, GDK_minus, 0, "expand_collapse_cursor_row", 3,
699 GTK_TYPE_BOOL, FALSE,
700 GTK_TYPE_BOOL, FALSE,
701 GTK_TYPE_BOOL, FALSE);
702 gtk_binding_entry_add_signal (binding_set, GDK_minus, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
703 GTK_TYPE_BOOL, FALSE,
704 GTK_TYPE_BOOL, FALSE,
705 GTK_TYPE_BOOL, TRUE);
706 gtk_binding_entry_add_signal (binding_set, GDK_KP_Subtract, 0, "expand_collapse_cursor_row", 3,
707 GTK_TYPE_BOOL, FALSE,
708 GTK_TYPE_BOOL, FALSE,
709 GTK_TYPE_BOOL, FALSE);
710 gtk_binding_entry_add_signal (binding_set, GDK_KP_Subtract, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
711 GTK_TYPE_BOOL, FALSE,
712 GTK_TYPE_BOOL, FALSE,
713 GTK_TYPE_BOOL, TRUE);
714 gtk_binding_entry_add_signal (binding_set, GDK_Left, GDK_SHIFT_MASK, "expand_collapse_cursor_row", 3,
715 GTK_TYPE_BOOL, FALSE,
716 GTK_TYPE_BOOL, FALSE,
717 GTK_TYPE_BOOL, TRUE);
719 gtk_binding_entry_add_signal (binding_set, GDK_BackSpace, 0, "select_cursor_parent", 0);
724 gtk_tree_view_init (GtkTreeView *tree_view)
726 tree_view->priv = g_new0 (GtkTreeViewPrivate, 1);
728 GTK_WIDGET_SET_FLAGS (tree_view, GTK_CAN_FOCUS);
730 tree_view->priv->flags = GTK_TREE_VIEW_IS_LIST | GTK_TREE_VIEW_SHOW_EXPANDERS | GTK_TREE_VIEW_DRAW_KEYFOCUS | GTK_TREE_VIEW_HEADERS_VISIBLE;
731 gtk_widget_style_get (GTK_WIDGET (tree_view), "expander_width", &tree_view->priv->tab_offset, NULL);
732 tree_view->priv->n_columns = 0;
733 tree_view->priv->header_height = 1;
734 tree_view->priv->x_drag = 0;
735 tree_view->priv->drag_pos = -1;
736 tree_view->priv->header_has_focus = FALSE;
737 tree_view->priv->pressed_button = -1;
738 tree_view->priv->press_start_x = -1;
739 tree_view->priv->press_start_y = -1;
740 tree_view->priv->reorderable = FALSE;
741 gtk_tree_view_set_adjustments (tree_view, NULL, NULL);
742 _gtk_tree_view_update_size (tree_view);
751 gtk_tree_view_set_property (GObject *object,
756 GtkTreeView *tree_view;
758 tree_view = GTK_TREE_VIEW (object);
763 gtk_tree_view_set_model (tree_view, GTK_TREE_MODEL (g_value_get_object (value)));
765 case PROP_HADJUSTMENT:
766 gtk_tree_view_set_hadjustment (tree_view, GTK_ADJUSTMENT (g_value_get_object (value)));
768 case PROP_VADJUSTMENT:
769 gtk_tree_view_set_vadjustment (tree_view, GTK_ADJUSTMENT (g_value_get_object (value)));
771 case PROP_HEADERS_VISIBLE:
772 gtk_tree_view_set_headers_visible (tree_view, g_value_get_boolean (value));
774 case PROP_HEADERS_CLICKABLE:
775 gtk_tree_view_set_headers_clickable (tree_view, g_value_get_boolean (value));
777 case PROP_EXPANDER_COLUMN:
778 gtk_tree_view_set_expander_column (tree_view, g_value_get_uint (value));
780 case PROP_REORDERABLE:
781 gtk_tree_view_set_reorderable (tree_view, g_value_get_boolean (value));
783 case PROP_RULES_HINT:
784 gtk_tree_view_set_rules_hint (tree_view, g_value_get_boolean (value));
792 gtk_tree_view_get_property (GObject *object,
797 GtkTreeView *tree_view;
799 tree_view = GTK_TREE_VIEW (object);
804 g_value_set_object (value, G_OBJECT (tree_view->priv->model));
806 case PROP_HADJUSTMENT:
807 g_value_set_object (value, G_OBJECT (tree_view->priv->hadjustment));
809 case PROP_VADJUSTMENT:
810 g_value_set_object (value, G_OBJECT (tree_view->priv->vadjustment));
812 case PROP_HEADERS_VISIBLE:
813 g_value_set_boolean (value, gtk_tree_view_get_headers_visible (tree_view));
815 case PROP_EXPANDER_COLUMN:
816 g_value_set_uint (value, tree_view->priv->expander_column);
818 case PROP_REORDERABLE:
819 g_value_set_boolean (value, tree_view->priv->reorderable);
821 case PROP_RULES_HINT:
822 g_value_set_boolean (value, tree_view->priv->has_rules);
825 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
831 gtk_tree_view_finalize (GObject *object)
833 GtkTreeView *tree_view = (GtkTreeView *) object;
835 g_free (tree_view->priv);
837 if (G_OBJECT_CLASS (parent_class)->finalize)
838 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
847 gtk_tree_view_destroy (GtkObject *object)
849 GtkTreeView *tree_view = (GtkTreeView *) object;
853 if (tree_view->priv->tree != NULL)
855 gtk_tree_view_unref_tree (tree_view, tree_view->priv->tree);
856 _gtk_rbtree_free (tree_view->priv->tree);
857 tree_view->priv->tree = NULL;
860 if (tree_view->priv->model != NULL)
862 g_object_unref (G_OBJECT (tree_view->priv->model));
863 tree_view->priv->model = NULL;
866 if (tree_view->priv->columns != NULL)
868 for (list = tree_view->priv->columns; list; list = list->next)
869 g_object_unref (G_OBJECT (list->data));
870 g_list_free (tree_view->priv->columns);
871 tree_view->priv->columns = NULL;
874 if (tree_view->priv->selection != NULL)
876 _gtk_tree_selection_set_tree_view (tree_view->priv->selection, NULL);
877 g_object_unref (tree_view->priv->selection);
878 tree_view->priv->selection = NULL;
881 if (tree_view->priv->anchor != NULL)
883 gtk_tree_row_reference_free (tree_view->priv->anchor);
884 tree_view->priv->anchor = NULL;
887 if (tree_view->priv->scroll_to_path != NULL)
889 gtk_tree_path_free (tree_view->priv->scroll_to_path);
890 tree_view->priv->scroll_to_path = NULL;
893 if (tree_view->priv->drag_dest_row != NULL)
895 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
896 tree_view->priv->drag_dest_row = NULL;
899 if (tree_view->priv->cursor)
901 gtk_tree_row_reference_free (tree_view->priv->cursor);
902 tree_view->priv->cursor = NULL;
905 if (tree_view->priv->column_drop_func_data &&
906 tree_view->priv->column_drop_func_data_destroy)
908 (* tree_view->priv->column_drop_func_data_destroy) (tree_view->priv->column_drop_func_data);
909 tree_view->priv->column_drop_func_data = NULL;
912 if (GTK_OBJECT_CLASS (parent_class)->destroy)
913 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
921 /* GtkWidget::map helper */
923 gtk_tree_view_map_buttons (GtkTreeView *tree_view)
927 g_return_if_fail (GTK_WIDGET_MAPPED (tree_view));
929 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
931 GtkTreeViewColumn *column;
933 for (list = tree_view->priv->columns; list; list = list->next)
936 if (GTK_WIDGET_VISIBLE (column->button) &&
937 !GTK_WIDGET_MAPPED (column->button))
938 gtk_widget_map (column->button);
940 for (list = tree_view->priv->columns; list; list = list->next)
943 if (column->visible == FALSE)
945 if (column->column_type == GTK_TREE_VIEW_COLUMN_RESIZEABLE)
947 gdk_window_raise (column->window);
948 gdk_window_show (column->window);
951 gdk_window_hide (column->window);
953 gdk_window_show (tree_view->priv->header_window);
958 gtk_tree_view_map (GtkWidget *widget)
961 GtkTreeView *tree_view;
963 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
965 tree_view = GTK_TREE_VIEW (widget);
967 GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
969 tmp_list = tree_view->priv->children;
972 GtkTreeViewChild *child = tmp_list->data;
973 tmp_list = tmp_list->next;
975 if (GTK_WIDGET_VISIBLE (child->widget))
977 if (!GTK_WIDGET_MAPPED (child->widget))
978 gtk_widget_map (child->widget);
981 gdk_window_show (tree_view->priv->bin_window);
983 gtk_tree_view_map_buttons (tree_view);
985 gdk_window_show (widget->window);
989 gtk_tree_view_realize (GtkWidget *widget)
992 GtkTreeView *tree_view;
994 GdkWindowAttr attributes;
995 gint attributes_mask;
997 g_return_if_fail (widget != NULL);
998 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1000 tree_view = GTK_TREE_VIEW (widget);
1002 gtk_tree_view_check_dirty (GTK_TREE_VIEW (widget));
1003 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
1005 /* Make the main, clipping window */
1006 attributes.window_type = GDK_WINDOW_CHILD;
1007 attributes.x = widget->allocation.x;
1008 attributes.y = widget->allocation.y;
1009 attributes.width = widget->allocation.width;
1010 attributes.height = widget->allocation.height;
1011 attributes.wclass = GDK_INPUT_OUTPUT;
1012 attributes.visual = gtk_widget_get_visual (widget);
1013 attributes.colormap = gtk_widget_get_colormap (widget);
1014 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK;
1016 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
1018 widget->window = gdk_window_new (gtk_widget_get_parent_window (widget),
1019 &attributes, attributes_mask);
1020 gdk_window_set_user_data (widget->window, widget);
1022 /* Make the window for the tree */
1025 attributes.width = tree_view->priv->width;
1026 attributes.height = tree_view->priv->height + TREE_VIEW_HEADER_HEIGHT (tree_view);
1027 attributes.event_mask = GDK_EXPOSURE_MASK |
1029 GDK_POINTER_MOTION_MASK |
1030 GDK_ENTER_NOTIFY_MASK |
1031 GDK_LEAVE_NOTIFY_MASK |
1032 GDK_BUTTON_PRESS_MASK |
1033 GDK_BUTTON_RELEASE_MASK |
1034 gtk_widget_get_events (widget);
1036 tree_view->priv->bin_window = gdk_window_new (widget->window,
1037 &attributes, attributes_mask);
1038 gdk_window_set_user_data (tree_view->priv->bin_window, widget);
1040 /* Make the column header window */
1043 attributes.width = MAX (tree_view->priv->width, widget->allocation.width);
1044 attributes.height = tree_view->priv->header_height;
1045 attributes.event_mask = (GDK_EXPOSURE_MASK |
1047 GDK_BUTTON_PRESS_MASK |
1048 GDK_BUTTON_RELEASE_MASK |
1049 GDK_KEY_PRESS_MASK |
1050 GDK_KEY_RELEASE_MASK) |
1051 gtk_widget_get_events (widget);
1053 tree_view->priv->header_window = gdk_window_new (widget->window,
1054 &attributes, attributes_mask);
1055 gdk_window_set_user_data (tree_view->priv->header_window, widget);
1058 values.foreground = (widget->style->white.pixel==0 ?
1059 widget->style->black:widget->style->white);
1060 values.function = GDK_XOR;
1061 values.subwindow_mode = GDK_INCLUDE_INFERIORS;
1062 tree_view->priv->xor_gc = gdk_gc_new_with_values (widget->window,
1067 /* Add them all up. */
1068 widget->style = gtk_style_attach (widget->style, widget->window);
1069 gdk_window_set_background (widget->window, &widget->style->base[widget->state]);
1070 gdk_window_set_background (tree_view->priv->bin_window, &widget->style->base[widget->state]);
1071 gtk_style_set_background (widget->style, tree_view->priv->header_window, GTK_STATE_NORMAL);
1073 tmp_list = tree_view->priv->children;
1076 GtkTreeViewChild *child = tmp_list->data;
1077 tmp_list = tmp_list->next;
1079 gtk_widget_set_parent_window (child->widget, tree_view->priv->bin_window);
1082 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
1083 _gtk_tree_view_column_realize_button (GTK_TREE_VIEW_COLUMN (tmp_list->data));
1085 _gtk_tree_view_update_size (GTK_TREE_VIEW (widget));
1087 if (tree_view->priv->scroll_to_path != NULL ||
1088 tree_view->priv->scroll_to_column != NULL)
1090 gtk_tree_view_scroll_to_cell (tree_view,
1091 tree_view->priv->scroll_to_path,
1092 tree_view->priv->scroll_to_column,
1093 tree_view->priv->scroll_to_row_align,
1094 tree_view->priv->scroll_to_col_align);
1095 if (tree_view->priv->scroll_to_path)
1097 gtk_tree_path_free (tree_view->priv->scroll_to_path);
1098 tree_view->priv->scroll_to_path = NULL;
1100 tree_view->priv->scroll_to_column = NULL;
1105 gtk_tree_view_unrealize (GtkWidget *widget)
1107 GtkTreeView *tree_view;
1110 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1112 tree_view = GTK_TREE_VIEW (widget);
1114 if (tree_view->priv->scroll_timeout != 0)
1116 gtk_timeout_remove (tree_view->priv->scroll_timeout);
1117 tree_view->priv->scroll_timeout = 0;
1120 if (tree_view->priv->open_dest_timeout != 0)
1122 gtk_timeout_remove (tree_view->priv->open_dest_timeout);
1123 tree_view->priv->open_dest_timeout = 0;
1126 for (list = tree_view->priv->columns; list; list = list->next)
1127 _gtk_tree_view_column_unrealize_button (GTK_TREE_VIEW_COLUMN (list->data));
1129 gdk_window_set_user_data (tree_view->priv->bin_window, NULL);
1130 gdk_window_destroy (tree_view->priv->bin_window);
1131 tree_view->priv->bin_window = NULL;
1133 gdk_window_set_user_data (tree_view->priv->header_window, NULL);
1134 gdk_window_destroy (tree_view->priv->header_window);
1135 tree_view->priv->header_window = NULL;
1137 if (tree_view->priv->drag_window)
1139 gdk_window_set_user_data (tree_view->priv->drag_window, NULL);
1140 gdk_window_destroy (tree_view->priv->drag_window);
1141 tree_view->priv->drag_window = NULL;
1144 if (tree_view->priv->drag_highlight_window)
1146 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, NULL);
1147 gdk_window_destroy (tree_view->priv->drag_highlight_window);
1148 tree_view->priv->drag_highlight_window = NULL;
1151 if (tree_view->priv->cursor_drag)
1153 gdk_cursor_destroy (tree_view->priv->cursor_drag);
1154 tree_view->priv->cursor_drag = NULL;
1157 if (tree_view->priv->xor_gc)
1159 gdk_gc_destroy (tree_view->priv->xor_gc);
1160 tree_view->priv->xor_gc = NULL;
1163 /* GtkWidget::unrealize destroys children and widget->window */
1164 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
1165 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
1168 /* GtkWidget::size_request helper */
1170 gtk_tree_view_size_request_buttons (GtkTreeView *tree_view)
1174 tree_view->priv->header_height = 1;
1176 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_MODEL_SETUP))
1178 for (list = tree_view->priv->columns; list; list = list->next)
1180 GtkRequisition requisition;
1181 GtkTreeViewColumn *column = list->data;
1183 if (column->button == NULL)
1186 column = list->data;
1188 gtk_widget_size_request (column->button, &requisition);
1190 _gtk_tree_view_column_set_width (column, MAX (column->width, requisition.width));
1191 tree_view->priv->header_height = MAX (tree_view->priv->header_height, requisition.height);
1197 gtk_tree_view_size_request (GtkWidget *widget,
1198 GtkRequisition *requisition)
1200 GtkTreeView *tree_view;
1203 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1205 tree_view = GTK_TREE_VIEW (widget);
1207 requisition->width = tree_view->priv->width;
1208 requisition->height = tree_view->priv->height + tree_view->priv->header_height;
1210 tmp_list = tree_view->priv->children;
1214 GtkTreeViewChild *child = tmp_list->data;
1215 GtkRequisition child_requisition;
1217 tmp_list = tmp_list->next;
1219 if (GTK_WIDGET_VISIBLE (child->widget))
1220 gtk_widget_size_request (child->widget, &child_requisition);
1223 gtk_tree_view_size_request_buttons (tree_view);
1226 /* GtkWidget::size_allocate helper */
1228 gtk_tree_view_size_allocate_buttons (GtkWidget *widget)
1230 GtkTreeView *tree_view;
1232 GtkTreeViewColumn *column;
1233 GtkAllocation allocation;
1236 tree_view = GTK_TREE_VIEW (widget);
1239 allocation.height = tree_view->priv->header_height;
1241 for (list = tree_view->priv->columns; list != NULL; list = list->next)
1243 column = list->data;
1245 if (!column->visible)
1248 allocation.x = width;
1249 allocation.width = column->displayed_width;
1250 width += column->width;
1251 gtk_widget_size_allocate (column->button, &allocation);
1254 gdk_window_move_resize (column->window,
1255 allocation.x + allocation.width - TREE_VIEW_DRAG_WIDTH/2,
1257 TREE_VIEW_DRAG_WIDTH, allocation.height);
1262 gtk_tree_view_size_allocate (GtkWidget *widget,
1263 GtkAllocation *allocation)
1266 GtkTreeView *tree_view;
1268 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
1270 widget->allocation = *allocation;
1272 tree_view = GTK_TREE_VIEW (widget);
1274 gtk_tree_view_check_dirty (tree_view);
1276 tmp_list = tree_view->priv->children;
1280 GtkAllocation allocation;
1281 GtkRequisition requisition;
1283 GtkTreeViewChild *child = tmp_list->data;
1284 tmp_list = tmp_list->next;
1286 allocation.x = child->x;
1287 allocation.y = child->y;
1288 gtk_widget_get_child_requisition (child->widget, &requisition);
1289 allocation.width = requisition.width;
1290 allocation.height = requisition.height;
1292 gtk_widget_size_allocate (child->widget, &allocation);
1295 if (GTK_WIDGET_REALIZED (widget))
1297 gdk_window_move_resize (widget->window,
1298 allocation->x, allocation->y,
1299 allocation->width, allocation->height);
1300 gdk_window_resize (tree_view->priv->header_window,
1301 MAX (tree_view->priv->width, allocation->width),
1302 tree_view->priv->header_height);
1303 if (tree_view->priv->width < allocation->width)
1304 gdk_window_resize (tree_view->priv->bin_window,
1306 tree_view->priv->height + TREE_VIEW_HEADER_HEIGHT (tree_view));
1308 _gtk_tree_view_update_col_width (tree_view);
1311 gtk_tree_view_size_allocate_buttons (widget);
1313 tree_view->priv->hadjustment->page_size = allocation->width;
1314 tree_view->priv->hadjustment->page_increment = allocation->width / 2;
1315 tree_view->priv->hadjustment->lower = 0;
1316 tree_view->priv->hadjustment->upper = tree_view->priv->width;
1318 if (tree_view->priv->hadjustment->value + allocation->width > tree_view->priv->width)
1319 tree_view->priv->hadjustment->value = MAX (tree_view->priv->width - allocation->width, 0);
1320 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->hadjustment), "changed");
1322 tree_view->priv->vadjustment->page_size = allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view);
1323 tree_view->priv->vadjustment->page_increment = (allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view)) / 2;
1324 tree_view->priv->vadjustment->lower = 0;
1325 tree_view->priv->vadjustment->upper = tree_view->priv->height;
1327 if (tree_view->priv->vadjustment->value + allocation->height > tree_view->priv->height)
1328 gtk_adjustment_set_value (tree_view->priv->vadjustment,
1329 MAX (tree_view->priv->height - allocation->height, 0));
1331 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->vadjustment), "changed");
1336 gtk_tree_view_button_press (GtkWidget *widget,
1337 GdkEventButton *event)
1339 GtkTreeView *tree_view;
1341 GtkTreeViewColumn *column = NULL;
1343 GdkRectangle background_area;
1344 GdkRectangle cell_area;
1345 gint vertical_separator;
1347 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
1348 g_return_val_if_fail (event != NULL, FALSE);
1350 tree_view = GTK_TREE_VIEW (widget);
1351 gtk_widget_style_get (widget, "vertical_separator", &vertical_separator, NULL);
1353 if (event->window == tree_view->priv->bin_window)
1362 GtkTreeViewColumn *column = NULL;
1364 if (!GTK_WIDGET_HAS_FOCUS (widget))
1365 gtk_widget_grab_focus (widget);
1366 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
1368 /* are we in an arrow? */
1369 if (tree_view->priv->prelight_node &&
1370 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
1372 if (event->button == 1)
1374 gtk_grab_add (widget);
1375 tree_view->priv->button_pressed_node = tree_view->priv->prelight_node;
1376 tree_view->priv->button_pressed_tree = tree_view->priv->prelight_tree;
1377 gtk_tree_view_draw_arrow (GTK_TREE_VIEW (widget),
1378 tree_view->priv->prelight_tree,
1379 tree_view->priv->prelight_node,
1386 /* find the node that was clicked */
1387 new_y = ((gint)event->y<TREE_VIEW_HEADER_HEIGHT (tree_view))?TREE_VIEW_HEADER_HEIGHT (tree_view):(gint)event->y;
1388 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree,
1389 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, new_y),
1391 &node) + new_y - (gint)event->y;
1394 /* We clicked in dead space */
1397 /* Get the path and the node */
1398 path = _gtk_tree_view_find_path (tree_view, tree, node);
1399 depth = gtk_tree_path_get_depth (path);
1400 background_area.y = y_offset + event->y + vertical_separator;
1401 background_area.height = GTK_RBNODE_GET_HEIGHT (node) - vertical_separator;
1402 background_area.x = 0;
1403 /* Let the cell have a chance at selecting it. */
1405 for (i = 0, list = tree_view->priv->columns; i < tree_view->priv->n_columns; i++, list = list->next)
1409 column = list->data;
1411 if (!column->visible)
1414 background_area.width = column->displayed_width;
1415 if (i == tree_view->priv->expander_column &&
1416 TREE_VIEW_DRAW_EXPANDERS(tree_view))
1418 cell_area = background_area;
1419 cell_area.x += depth*tree_view->priv->tab_offset;
1420 cell_area.width -= depth*tree_view->priv->tab_offset;
1424 cell_area = background_area;
1427 if ((background_area.x > (gint) event->x) ||
1428 (background_area.y > (gint) event->y) ||
1429 (background_area.x + background_area.width <= (gint) event->x) ||
1430 (background_area.y + background_area.height <= (gint) event->y))
1432 background_area.x += background_area.width;
1436 gtk_tree_model_get_iter (tree_view->priv->model,
1439 gtk_tree_view_column_cell_set_cell_data (column,
1440 tree_view->priv->model,
1443 path_string = gtk_tree_path_to_string (path);
1445 if (gtk_tree_view_column_cell_event (column,
1451 g_free (path_string);
1452 gtk_tree_path_free (path);
1457 g_free (path_string);
1465 /* Save press to possibly begin a drag
1467 if (tree_view->priv->pressed_button < 0)
1469 tree_view->priv->pressed_button = event->button;
1470 tree_view->priv->press_start_x = event->x;
1471 tree_view->priv->press_start_y = event->y;
1474 /* Handle the selection */
1475 if (tree_view->priv->selection == NULL)
1476 tree_view->priv->selection =
1477 _gtk_tree_selection_new_with_tree_view (tree_view);
1479 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
1485 if (event->button == 1 && event->type == GDK_2BUTTON_PRESS)
1486 gtk_tree_view_row_activated (tree_view, path, column);
1488 gtk_tree_path_free (path);
1492 for (i = 0, list = tree_view->priv->columns; list; list = list->next, i++)
1494 column = list->data;
1495 if (event->window == column->window &&
1496 column->column_type == GTK_TREE_VIEW_COLUMN_RESIZEABLE &&
1501 if (gdk_pointer_grab (column->window, FALSE,
1502 GDK_POINTER_MOTION_HINT_MASK |
1503 GDK_BUTTON1_MOTION_MASK |
1504 GDK_BUTTON_RELEASE_MASK,
1505 NULL, NULL, event->time))
1508 gtk_grab_add (widget);
1509 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
1511 /* block attached dnd signal handler */
1512 drag_data = gtk_object_get_data (GTK_OBJECT (widget), "gtk-site-data");
1514 gtk_signal_handler_block_by_data (GTK_OBJECT (widget), drag_data);
1516 if (!GTK_WIDGET_HAS_FOCUS (widget))
1517 gtk_widget_grab_focus (widget);
1519 tree_view->priv->drag_pos = i;
1520 tree_view->priv->x_drag = (column->button->allocation.x + column->button->allocation.width);
1526 /* GtkWidget::button_release_event helper */
1528 gtk_tree_view_button_release_drag_column (GtkWidget *widget,
1529 GdkEventButton *event)
1531 GtkTreeView *tree_view;
1532 GtkAllocation allocation;
1534 tree_view = GTK_TREE_VIEW (widget);
1536 allocation = tree_view->priv->drag_column->button->allocation;
1537 allocation.x = tree_view->priv->drag_column_x;
1538 gdk_pointer_ungrab (GDK_CURRENT_TIME);
1539 gdk_keyboard_ungrab (GDK_CURRENT_TIME);
1540 gdk_window_reparent (tree_view->priv->drag_column->button->window,
1541 tree_view->priv->header_window,
1542 tree_view->priv->drag_column_x,
1543 tree_view->priv->drag_column->button->allocation.y);
1544 gtk_widget_set_parent_window (tree_view->priv->drag_column->button, tree_view->priv->header_window);
1546 gtk_widget_size_allocate (tree_view->priv->drag_column->button, &allocation);
1547 gtk_widget_grab_focus (tree_view->priv->drag_column->button);
1549 if (tree_view->priv->cur_reorder &&
1550 tree_view->priv->cur_reorder->left_column != tree_view->priv->drag_column)
1551 gtk_tree_view_move_column_after (tree_view, tree_view->priv->drag_column,
1552 tree_view->priv->cur_reorder->left_column);
1553 tree_view->priv->drag_column = NULL;
1554 gdk_window_hide (tree_view->priv->drag_window);
1556 g_list_foreach (tree_view->priv->column_drag_info, (GFunc) g_free, NULL);
1557 g_list_free (tree_view->priv->column_drag_info);
1558 tree_view->priv->column_drag_info = NULL;
1560 gdk_window_hide (tree_view->priv->drag_highlight_window);
1562 /* Reset our flags */
1563 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_UNSET;
1564 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
1569 /* GtkWidget::button_release_event helper */
1571 gtk_tree_view_button_release_column_resize (GtkWidget *widget,
1572 GdkEventButton *event)
1574 GtkTreeView *tree_view;
1580 tree_view = GTK_TREE_VIEW (widget);
1582 i = tree_view->priv->drag_pos;
1583 tree_view->priv->drag_pos = -1;
1585 /* unblock attached dnd signal handler */
1586 drag_data = gtk_object_get_data (GTK_OBJECT (widget), "gtk-site-data");
1588 gtk_signal_handler_unblock_by_data (GTK_OBJECT (widget), drag_data);
1590 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
1591 gtk_widget_get_pointer (widget, &x, NULL);
1592 gtk_grab_remove (widget);
1593 gdk_pointer_ungrab (event->time);
1595 width = gtk_tree_view_new_column_width (GTK_TREE_VIEW (widget), i, &x);
1596 _gtk_tree_view_column_set_width (gtk_tree_view_get_column (GTK_TREE_VIEW (widget), i), width);
1602 gtk_tree_view_button_release (GtkWidget *widget,
1603 GdkEventButton *event)
1605 GtkTreeView *tree_view;
1607 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
1608 g_return_val_if_fail (event != NULL, FALSE);
1610 tree_view = GTK_TREE_VIEW (widget);
1612 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
1613 return gtk_tree_view_button_release_drag_column (widget, event);
1615 if (tree_view->priv->pressed_button == event->button)
1616 tree_view->priv->pressed_button = -1;
1618 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
1619 return gtk_tree_view_button_release_column_resize (widget, event);
1621 if (tree_view->priv->button_pressed_node == NULL)
1624 if (event->button == 1)
1626 gtk_grab_remove (widget);
1627 if (tree_view->priv->button_pressed_node == tree_view->priv->prelight_node &&
1628 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
1630 GtkTreePath *path = NULL;
1633 /* Actually activate the node */
1634 if (tree_view->priv->button_pressed_node->children == NULL)
1637 path = _gtk_tree_view_find_path (tree_view,
1638 tree_view->priv->button_pressed_tree,
1639 tree_view->priv->button_pressed_node);
1640 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
1642 if (gtk_tree_model_iter_children (tree_view->priv->model, &child, &iter))
1645 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[EXPAND_ROW], 0, &iter, path, &expand);
1648 tree_view->priv->button_pressed_node->children = _gtk_rbtree_new ();
1649 tree_view->priv->button_pressed_node->children->parent_tree = tree_view->priv->button_pressed_tree;
1650 tree_view->priv->button_pressed_node->children->parent_node = tree_view->priv->button_pressed_node;
1651 gtk_tree_view_build_tree (tree_view,
1652 tree_view->priv->button_pressed_node->children,
1654 gtk_tree_path_get_depth (path) + 1,
1656 GTK_WIDGET_REALIZED (widget));
1664 path = _gtk_tree_view_find_path (GTK_TREE_VIEW (widget),
1665 tree_view->priv->button_pressed_tree,
1666 tree_view->priv->button_pressed_node);
1667 gtk_tree_model_get_iter (tree_view->priv->model,
1670 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLLAPSE_ROW], 0, &iter, path, &collapse);
1674 GtkTreeIter child_iter;
1675 gtk_tree_path_append_index (path, 0);
1676 gtk_tree_model_iter_children (tree_view->priv->model,
1679 gtk_tree_view_discover_dirty (GTK_TREE_VIEW (widget),
1680 tree_view->priv->button_pressed_node->children,
1682 gtk_tree_path_get_depth (path));
1683 gtk_tree_view_unref_tree (GTK_TREE_VIEW (widget),
1684 tree_view->priv->button_pressed_node->children);
1685 _gtk_rbtree_remove (tree_view->priv->button_pressed_node->children);
1689 gtk_tree_path_free (path);
1691 _gtk_tree_view_update_size (GTK_TREE_VIEW (widget));
1694 tree_view->priv->button_pressed_node = NULL;
1701 /* GtkWidget::motion_event function set.
1705 coords_are_over_arrow (GtkTreeView *tree_view,
1708 /* these are in tree window coords */
1715 if (!GTK_WIDGET_REALIZED (tree_view))
1718 if ((node->flags & GTK_RBNODE_IS_PARENT) == 0)
1721 arrow.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
1723 arrow.height = BACKGROUND_HEIGHT (node);
1725 gtk_tree_view_get_arrow_xrange (tree_view, &arrow.x, &x2);
1727 arrow.width = x2 - arrow.x;
1729 return (x >= arrow.x &&
1730 x < (arrow.x + arrow.height) &&
1732 y < (arrow.y + arrow.height));
1736 do_unprelight (GtkTreeView *tree_view,
1737 /* these are in tree window coords */
1741 if (tree_view->priv->prelight_node == NULL)
1744 GTK_RBNODE_UNSET_FLAG (tree_view->priv->prelight_node, GTK_RBNODE_IS_PRELIT);
1746 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT) &&
1747 !coords_are_over_arrow (tree_view,
1748 tree_view->priv->prelight_tree,
1749 tree_view->priv->prelight_node,
1752 /* We need to unprelight the old arrow. */
1754 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
1756 gtk_tree_view_draw_arrow (tree_view,
1757 tree_view->priv->prelight_tree,
1758 tree_view->priv->prelight_node,
1764 tree_view->priv->prelight_node = NULL;
1765 tree_view->priv->prelight_tree = NULL;
1769 do_prelight (GtkTreeView *tree_view,
1772 /* these are in tree window coords */
1776 if (coords_are_over_arrow (tree_view, tree, node, x, y))
1777 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
1779 tree_view->priv->prelight_node = node;
1780 tree_view->priv->prelight_tree = tree;
1782 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PRELIT);
1786 ensure_unprelighted (GtkTreeView *tree_view)
1788 do_unprelight (tree_view, -1000, -1000); /* coords not possibly over an arrow */
1793 /* Our motion arrow is either a box (in the case of the original spot)
1794 * or an arrow. It is expander_width wide.
1817 gtk_tree_view_motion_draw_column_motion_arrow (GtkTreeView *tree_view)
1819 GtkTreeViewColumnReorder *reorder = tree_view->priv->cur_reorder;
1820 GtkWidget *widget = GTK_WIDGET (tree_view);
1821 GdkBitmap *mask = NULL;
1826 gint arrow_type = DRAG_COLUMN_WINDOW_STATE_UNSET;
1827 GdkWindowAttr attributes;
1828 guint attributes_mask;
1831 reorder->left_column == tree_view->priv->drag_column ||
1832 reorder->right_column == tree_view->priv->drag_column)
1833 arrow_type = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
1834 else if (reorder->left_column || reorder->right_column)
1836 GdkRectangle visible_rect;
1837 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
1838 if (reorder->left_column)
1839 x = reorder->left_column->button->allocation.x + reorder->left_column->button->allocation.width;
1841 x = reorder->right_column->button->allocation.x;
1842 if (x < visible_rect.x)
1843 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT;
1844 else if (x > visible_rect.x + visible_rect.width)
1845 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT;
1847 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW;
1850 /* We want to draw the rectangle over the initial location. */
1851 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
1856 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
1859 if (tree_view->priv->drag_highlight_window)
1860 gdk_window_destroy (tree_view->priv->drag_highlight_window);
1862 attributes.window_type = GDK_WINDOW_CHILD;
1863 attributes.wclass = GDK_INPUT_OUTPUT;
1864 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
1865 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
1866 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
1867 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
1868 tree_view->priv->drag_highlight_window = gdk_window_new (tree_view->priv->header_window, &attributes, attributes_mask);
1869 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
1871 width = tree_view->priv->drag_column->button->allocation.width;
1872 height = tree_view->priv->drag_column->button->allocation.height;
1873 gdk_window_move_resize (tree_view->priv->drag_highlight_window,
1874 tree_view->priv->drag_column_x, 0, width, height);
1876 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
1877 gc = gdk_gc_new (mask);
1879 gdk_gc_set_foreground (gc, &col);
1880 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
1882 gdk_gc_set_foreground(gc, &col);
1883 gdk_draw_rectangle (mask, gc, TRUE, 2, 2, width - 4, height - 4);
1884 gdk_gc_destroy (gc);
1886 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
1888 if (mask) gdk_pixmap_unref (mask);
1889 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
1892 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW)
1897 gint expander_width;
1899 gtk_widget_style_get (widget,
1900 "expander_height", &width,
1901 "expander_width", &expander_width,
1904 /* Get x, y, width, height of arrow */
1905 if (reorder->left_column)
1907 gdk_window_get_origin (reorder->left_column->button->window, &x, &y);
1908 x += reorder->left_column->button->allocation.width - width/2;
1909 height = reorder->left_column->button->allocation.height;
1913 gdk_window_get_origin (reorder->right_column->button->window, &x, &y);
1915 height = reorder->right_column->button->allocation.height;
1917 y -= expander_width/2; /* The arrow takes up only half the space */
1918 height += expander_width;
1920 /* Create the new window */
1921 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW)
1923 if (tree_view->priv->drag_highlight_window)
1924 gdk_window_destroy (tree_view->priv->drag_highlight_window);
1926 attributes.window_type = GDK_WINDOW_TEMP;
1927 attributes.wclass = GDK_INPUT_OUTPUT;
1928 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
1929 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
1930 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
1931 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
1932 attributes.width = width;
1933 attributes.height = height;
1934 tree_view->priv->drag_highlight_window = gdk_window_new (NULL, &attributes, attributes_mask);
1935 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
1937 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
1938 gc = gdk_gc_new (mask);
1940 gdk_gc_set_foreground (gc, &col);
1941 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
1943 /* Draw the 2 arrows as per above */
1945 gdk_gc_set_foreground (gc, &col);
1946 for (i = 0; i < width; i ++)
1948 if (i == (width/2 - 1))
1950 gdk_draw_line (mask, gc, i, j, i, height - j);
1951 if (i < (width/2 - 1))
1956 gdk_gc_destroy (gc);
1957 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
1959 if (mask) gdk_pixmap_unref (mask);
1962 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ARROW;
1963 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
1965 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT ||
1966 arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
1971 gint expander_height;
1973 gtk_widget_style_get (widget,
1974 "expander_height", &expander_height,
1975 "expander_width", &width,
1978 /* Get x, y, width, height of arrow */
1979 width = width/2; /* remember, the arrow only takes half the available width */
1980 gdk_window_get_origin (widget->window, &x, &y);
1981 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
1982 x += widget->allocation.width - width;
1984 if (reorder->left_column)
1985 height = reorder->left_column->button->allocation.height;
1987 height = reorder->right_column->button->allocation.height;
1989 y -= expander_height;
1990 height += 2*expander_height;
1992 /* Create the new window */
1993 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT &&
1994 tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
1996 if (tree_view->priv->drag_highlight_window)
1997 gdk_window_destroy (tree_view->priv->drag_highlight_window);
1999 attributes.window_type = GDK_WINDOW_TEMP;
2000 attributes.wclass = GDK_INPUT_OUTPUT;
2001 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
2002 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
2003 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
2004 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
2005 attributes.width = width;
2006 attributes.height = height;
2007 tree_view->priv->drag_highlight_window = gdk_window_new (NULL, &attributes, attributes_mask);
2008 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
2010 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
2011 gc = gdk_gc_new (mask);
2013 gdk_gc_set_foreground (gc, &col);
2014 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
2016 /* Draw the 2 arrows as per above */
2018 gdk_gc_set_foreground (gc, &col);
2019 j = expander_height;
2020 for (i = 0; i < width; i ++)
2023 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT)
2027 gdk_draw_line (mask, gc, k, j, k, height - j);
2028 gdk_draw_line (mask, gc, k, 0, k, expander_height - j);
2029 gdk_draw_line (mask, gc, k, height, k, height - expander_height + j);
2032 gdk_gc_destroy (gc);
2033 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
2035 if (mask) gdk_pixmap_unref (mask);
2038 tree_view->priv->drag_column_window_state = arrow_type;
2039 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
2043 g_warning (G_STRLOC"Invalid GtkTreeViewColumnReorder struct");
2044 gdk_window_hide (tree_view->priv->drag_highlight_window);
2048 gdk_window_show (tree_view->priv->drag_highlight_window);
2049 gdk_window_raise (tree_view->priv->drag_highlight_window);
2053 gtk_tree_view_motion_resize_column (GtkWidget *widget,
2054 GdkEventMotion *event)
2059 if (event->is_hint || event->window != widget->window)
2060 gtk_widget_get_pointer (widget, &x, NULL);
2064 new_width = gtk_tree_view_new_column_width (GTK_TREE_VIEW (widget),
2065 GTK_TREE_VIEW (widget)->priv->drag_pos, &x);
2066 if (x != GTK_TREE_VIEW (widget)->priv->x_drag)
2067 _gtk_tree_view_column_set_width (gtk_tree_view_get_column (GTK_TREE_VIEW (widget), GTK_TREE_VIEW (widget)->priv->drag_pos), new_width);
2069 /* FIXME: Do we need to scroll */
2070 _gtk_tree_view_update_size (GTK_TREE_VIEW (widget));
2076 gtk_tree_view_update_current_reorder (GtkTreeView *tree_view)
2078 GtkTreeViewColumnReorder *reorder = NULL;
2082 gdk_window_get_pointer (tree_view->priv->bin_window, &mouse_x, NULL, NULL);
2084 for (list = tree_view->priv->column_drag_info; list; list = list->next)
2086 reorder = (GtkTreeViewColumnReorder *) list->data;
2087 if (mouse_x >= reorder->left_align && mouse_x < reorder->right_align)
2092 /* if (reorder && reorder == tree_view->priv->cur_reorder)
2095 tree_view->priv->cur_reorder = reorder;
2096 gtk_tree_view_motion_draw_column_motion_arrow (tree_view);
2100 gtk_tree_view_horizontal_autoscroll (GtkTreeView *tree_view)
2102 GdkRectangle visible_rect;
2107 gdk_window_get_pointer (tree_view->priv->bin_window, &x, NULL, NULL);
2109 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
2111 /* See if we are near the edge. */
2112 offset = x - (visible_rect.x + SCROLL_EDGE_SIZE);
2115 offset = x - (visible_rect.x + visible_rect.width - SCROLL_EDGE_SIZE);
2121 value = CLAMP (tree_view->priv->hadjustment->value + offset,
2122 0.0, tree_view->priv->hadjustment->upper - tree_view->priv->hadjustment->page_size);
2123 gtk_adjustment_set_value (tree_view->priv->hadjustment, value);
2130 gtk_tree_view_motion_drag_column (GtkWidget *widget,
2131 GdkEventMotion *event)
2133 GtkTreeView *tree_view = (GtkTreeView *) widget;
2134 GtkTreeViewColumn *column = tree_view->priv->drag_column;
2138 if ((column == NULL) ||
2139 (event->window != tree_view->priv->drag_window))
2142 /* Handle moving the header */
2143 gdk_window_get_position (tree_view->priv->drag_window, &x, &y);
2144 x = CLAMP (x + (gint)event->x - column->drag_x, 0,
2145 MAX (tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.width) - column->button->allocation.width);
2146 gdk_window_move (tree_view->priv->drag_window, x, y);
2148 /* autoscroll, if needed */
2149 gtk_tree_view_horizontal_autoscroll (tree_view);
2150 /* Update the current reorder position and arrow; */
2151 gtk_tree_view_update_current_reorder (tree_view);
2157 gtk_tree_view_motion_bin_window (GtkWidget *widget,
2158 GdkEventMotion *event)
2160 GtkTreeView *tree_view;
2164 GtkRBTree *old_prelight_tree;
2165 GtkRBNode *old_prelight_node;
2167 tree_view = (GtkTreeView *) widget;
2169 if (tree_view->priv->tree == NULL)
2172 gtk_tree_view_maybe_begin_dragging_row (tree_view, event);
2174 old_prelight_tree = tree_view->priv->prelight_tree;
2175 old_prelight_node = tree_view->priv->prelight_node;
2177 do_unprelight (tree_view, event->x, event->y);
2179 new_y = ((gint)event->y<TREE_VIEW_HEADER_HEIGHT (tree_view))?TREE_VIEW_HEADER_HEIGHT (tree_view):(gint)event->y;
2181 _gtk_rbtree_find_offset (tree_view->priv->tree,
2182 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, new_y),
2189 /* If we are currently pressing down a button, we don't want to prelight anything else. */
2190 if ((tree_view->priv->button_pressed_node != NULL) &&
2191 (tree_view->priv->button_pressed_node != node))
2195 do_prelight (tree_view, tree, node, event->x, new_y);
2197 if (old_prelight_node != tree_view->priv->prelight_node)
2199 if (old_prelight_node)
2200 gtk_tree_view_queue_draw_node (tree_view,
2205 if (tree_view->priv->prelight_node)
2206 gtk_tree_view_queue_draw_node (tree_view,
2207 tree_view->priv->prelight_tree,
2208 tree_view->priv->prelight_node,
2216 gtk_tree_view_motion (GtkWidget *widget,
2217 GdkEventMotion *event)
2219 GtkTreeView *tree_view;
2221 tree_view = (GtkTreeView *) widget;
2223 /* Resizing a column */
2224 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
2225 return gtk_tree_view_motion_resize_column (widget, event);
2228 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
2229 return gtk_tree_view_motion_drag_column (widget, event);
2231 /* Sanity check it */
2232 if (event->window == tree_view->priv->bin_window)
2233 return gtk_tree_view_motion_bin_window (widget, event);
2240 gtk_tree_view_draw_focus (GtkWidget *widget)
2242 GtkTreeView *tree_view;
2243 GtkTreePath *cursor_path;
2244 GtkRBTree *tree = NULL;
2245 GtkRBNode *node = NULL;
2248 gint vertical_separator;
2250 g_return_if_fail (GTK_IS_TREE_VIEW (widget));
2252 tree_view = GTK_TREE_VIEW (widget);
2254 gtk_widget_style_get (widget, "vertical_separator", &vertical_separator, NULL);
2256 if (! GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS))
2259 if (tree_view->priv->cursor == NULL)
2262 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
2263 if (cursor_path == NULL)
2266 _gtk_tree_view_find_node (tree_view, cursor_path, &tree, &node);
2270 gtk_tree_path_free (cursor_path);
2274 gdk_drawable_get_size (tree_view->priv->bin_window,
2279 y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
2280 gdk_drawable_get_size (tree_view->priv->bin_window,
2283 height = BACKGROUND_HEIGHT (node) - 1;
2284 if (tree_view->priv->focus_column != NULL)
2289 g_object_get (G_OBJECT (tree_view->priv->focus_column->cell),
2290 "can_activate", &can_focus,
2291 "visible", &visible,
2293 if (can_focus && visible)
2296 GdkRectangle cell_area;
2300 cell_area.x = tree_view->priv->focus_column->button->allocation.x;
2302 cell_area.width = tree_view->priv->focus_column->displayed_width;
2303 cell_area.height = CELL_HEIGHT (node, vertical_separator);
2305 gtk_tree_model_get_iter (tree_view->priv->model, &iter, cursor_path);
2306 gtk_tree_view_column_cell_set_cell_data (tree_view->priv->focus_column, tree_view->priv->model, &iter);
2308 gtk_cell_renderer_get_size (tree_view->priv->focus_column->cell, GTK_WIDGET (tree_view), &cell_area, &x_offset, &y_offset, &width, &height);
2311 x = cell_area.x + x_offset - 1;
2312 y = cell_area.y + y_offset - 1 + vertical_separator/2;
2316 gtk_paint_focus (widget->style,
2317 tree_view->priv->bin_window,
2321 x, y, width, height);
2323 gtk_tree_path_free (cursor_path);
2326 /* Warning: Very scary function.
2327 * Modify at your own risk
2330 gtk_tree_view_bin_expose (GtkWidget *widget,
2331 GdkEventExpose *event)
2333 GtkTreeView *tree_view;
2338 GtkRBNode *cursor = NULL;
2339 GtkRBTree *cursor_tree = NULL;
2340 GtkRBNode *drag_highlight = NULL;
2341 GtkRBTree *drag_highlight_tree = NULL;
2344 gint y_offset, x_offset, cell_offset;
2347 GdkRectangle background_area;
2348 GdkRectangle cell_area;
2351 gint bin_window_width;
2352 GtkTreePath *cursor_path;
2353 GtkTreePath *drag_dest_path;
2355 gint vertical_separator;
2357 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2359 tree_view = GTK_TREE_VIEW (widget);
2360 gtk_widget_style_get (widget, "vertical_separator", &vertical_separator, NULL);
2362 if (tree_view->priv->tree == NULL)
2365 gtk_tree_view_check_dirty (GTK_TREE_VIEW (widget));
2366 /* we want to account for a potential HEADER offset.
2367 * That is, if the header exists, we want to offset our event by its
2368 * height to find the right node.
2370 new_y = (event->area.y<TREE_VIEW_HEADER_HEIGHT (tree_view))?TREE_VIEW_HEADER_HEIGHT (tree_view):event->area.y;
2372 /* y_offset is the */
2374 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree,
2375 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, new_y),
2377 &node) + new_y - event->area.y;
2381 /* find the path for the node */
2382 path = _gtk_tree_view_find_path ((GtkTreeView *)widget,
2385 gtk_tree_model_get_iter (tree_view->priv->model,
2388 depth = gtk_tree_path_get_depth (path);
2389 gtk_tree_path_free (path);
2392 drag_dest_path = NULL;
2394 if (tree_view->priv->cursor)
2395 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
2398 _gtk_tree_view_find_node (tree_view, cursor_path,
2399 &cursor_tree, &cursor);
2401 if (tree_view->priv->drag_dest_row)
2402 drag_dest_path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
2405 _gtk_tree_view_find_node (tree_view, drag_dest_path,
2406 &drag_highlight_tree, &drag_highlight);
2408 gdk_drawable_get_size (tree_view->priv->bin_window,
2409 &bin_window_width, NULL);
2411 for (last_column = g_list_last (tree_view->priv->columns);
2413 !(GTK_TREE_VIEW_COLUMN (last_column->data)->visible) &&
2414 GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (last_column->data)->button);
2415 last_column = last_column->prev)
2418 /* Actually process the expose event. To do this, we want to
2419 * start at the first node of the event, and walk the tree in
2420 * order, drawing each successive node.
2427 max_height = BACKGROUND_HEIGHT (node);
2429 x_offset = -event->area.x;
2431 highlight_x = 0; /* should match x coord of first cell */
2433 background_area.y = y_offset + event->area.y;
2434 background_area.height = max_height;
2437 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PRELIT))
2438 flags |= GTK_CELL_RENDERER_PRELIT;
2440 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
2441 flags |= GTK_CELL_RENDERER_SELECTED;
2443 parity = _gtk_rbtree_node_find_parity (tree, node);
2445 for (i = 0, list = tree_view->priv->columns; i < tree_view->priv->n_columns; i++, list = list->next)
2447 GtkTreeViewColumn *column = list->data;
2448 const gchar *detail = NULL;
2450 if (!column->visible)
2453 if (cell_offset > event->area.x + event->area.width ||
2454 cell_offset + column->displayed_width < event->area.x)
2456 cell_offset += column->displayed_width;
2460 if (column->show_sort_indicator)
2461 flags |= GTK_CELL_RENDERER_SORTED;
2463 flags &= ~GTK_CELL_RENDERER_SORTED;
2465 gtk_tree_view_column_cell_set_cell_data (column,
2466 tree_view->priv->model,
2469 background_area.x = cell_offset;
2470 background_area.width = column->displayed_width;
2472 cell_area = background_area;
2473 cell_area.y += vertical_separator / 2;
2474 cell_area.height -= vertical_separator;
2476 /* Select the detail for drawing the cell. relevant
2477 * factors are parity, sortedness, and whether to
2481 /* FIXME when we have style properties, clean this up.
2484 if (tree_view->priv->has_rules)
2486 if (flags & GTK_CELL_RENDERER_SORTED)
2489 detail = "cell_odd_ruled_sorted";
2491 detail = "cell_even_ruled_sorted";
2496 detail = "cell_odd_ruled";
2498 detail = "cell_even_ruled";
2503 if (flags & GTK_CELL_RENDERER_SORTED)
2506 detail = "cell_odd_sorted";
2508 detail = "cell_even_sorted";
2513 detail = "cell_odd";
2515 detail = "cell_even";
2521 /* Draw background */
2522 gtk_paint_flat_box (widget->style,
2524 (flags & GTK_CELL_RENDERER_SELECTED) ?
2525 GTK_STATE_SELECTED : GTK_STATE_NORMAL,
2532 background_area.width,
2533 background_area.height);
2535 if (i == tree_view->priv->expander_column &&
2536 TREE_VIEW_DRAW_EXPANDERS(tree_view))
2538 cell_area.x += depth*tree_view->priv->tab_offset;
2539 cell_area.width -= depth*tree_view->priv->tab_offset;
2541 /* If we have an expander column, the highlight underline
2542 * starts with that column, so that it indicates which
2543 * level of the tree we're dropping at.
2545 highlight_x = cell_area.x;
2547 gtk_tree_view_column_cell_render (column,
2553 if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT)
2556 gdk_window_get_pointer (tree_view->priv->bin_window, &x, &y, 0);
2557 gtk_tree_view_draw_arrow (GTK_TREE_VIEW (widget),
2565 gtk_tree_view_column_cell_render (column,
2572 cell_offset += column->displayed_width;
2575 if (node == cursor && GTK_WIDGET_HAS_FOCUS (widget))
2576 gtk_tree_view_draw_focus (widget);
2578 if (node == drag_highlight)
2580 /* Draw indicator for the drop
2582 gint highlight_y = -1;
2583 GtkRBTree *tree = NULL;
2584 GtkRBNode *node = NULL;
2587 switch (tree_view->priv->drag_dest_pos)
2589 case GTK_TREE_VIEW_DROP_BEFORE:
2590 highlight_y = background_area.y - vertical_separator/2;
2593 case GTK_TREE_VIEW_DROP_AFTER:
2594 highlight_y = background_area.y + background_area.height + vertical_separator/2;
2597 case GTK_TREE_VIEW_DROP_INTO_OR_BEFORE:
2598 case GTK_TREE_VIEW_DROP_INTO_OR_AFTER:
2599 _gtk_tree_view_find_node (tree_view, drag_dest_path, &tree, &node);
2603 gdk_drawable_get_size (tree_view->priv->bin_window,
2605 gtk_paint_focus (widget->style,
2606 tree_view->priv->bin_window,
2610 0, BACKGROUND_FIRST_PIXEL (tree_view, tree, node),
2611 width - 1, BACKGROUND_HEIGHT (node) - 1);
2616 if (highlight_y >= 0)
2618 gdk_draw_line (event->window,
2619 widget->style->black_gc,
2622 bin_window_width - highlight_x,
2627 y_offset += max_height;
2630 GtkTreeIter parent = iter;
2633 tree = node->children;
2636 g_assert (node != tree->nil);
2638 while (node->left != tree->nil)
2640 has_child = gtk_tree_model_iter_children (tree_view->priv->model,
2646 TREE_VIEW_INTERNAL_ASSERT (has_child, FALSE);
2650 gboolean done = FALSE;
2653 node = _gtk_rbtree_next (tree, node);
2656 gboolean has_next = gtk_tree_model_iter_next (tree_view->priv->model, &iter);
2660 TREE_VIEW_INTERNAL_ASSERT (has_next, FALSE);
2664 GtkTreeIter parent_iter = iter;
2665 gboolean has_parent;
2667 node = tree->parent_node;
2668 tree = tree->parent_tree;
2670 /* we've run out of tree. It's okay to return though, as
2671 * we'd only break out of the while loop below. */
2673 has_parent = gtk_tree_model_iter_parent (tree_view->priv->model,
2679 TREE_VIEW_INTERNAL_ASSERT (has_parent, FALSE);
2685 while (y_offset < event->area.height);
2688 gtk_tree_path_free (cursor_path);
2691 gtk_tree_path_free (drag_dest_path);
2697 gtk_tree_view_expose (GtkWidget *widget,
2698 GdkEventExpose *event)
2700 GtkTreeView *tree_view;
2702 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2704 tree_view = GTK_TREE_VIEW (widget);
2706 if (event->window == tree_view->priv->bin_window)
2707 return gtk_tree_view_bin_expose (widget, event);
2713 gtk_tree_view_key_press (GtkWidget *widget,
2716 GtkTreeView *tree_view = (GtkTreeView *) widget;
2718 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
2720 if (event->keyval == GDK_Escape)
2722 tree_view->priv->cur_reorder = NULL;
2723 gtk_tree_view_button_release_drag_column (widget, NULL);
2727 return (* GTK_WIDGET_CLASS (parent_class)->key_press_event) (widget, event);
2730 /* FIXME Is this function necessary? Can I get an enter_notify event
2731 * w/o either an expose event or a mouse motion event?
2734 gtk_tree_view_enter_notify (GtkWidget *widget,
2735 GdkEventCrossing *event)
2737 GtkTreeView *tree_view;
2742 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2744 tree_view = GTK_TREE_VIEW (widget);
2746 /* Sanity check it */
2747 if (event->window != tree_view->priv->bin_window)
2750 if (tree_view->priv->tree == NULL)
2753 if ((tree_view->priv->button_pressed_node != NULL) &&
2754 (tree_view->priv->button_pressed_node != node))
2757 /* find the node internally */
2758 new_y = ((gint)event->y<TREE_VIEW_HEADER_HEIGHT (tree_view))?TREE_VIEW_HEADER_HEIGHT (tree_view):(gint)event->y;
2760 _gtk_rbtree_find_offset (tree_view->priv->tree,
2761 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, new_y),
2768 do_prelight (tree_view, tree, node, event->x, new_y);
2770 if (tree_view->priv->prelight_node)
2771 gtk_tree_view_queue_draw_node (tree_view,
2772 tree_view->priv->prelight_tree,
2773 tree_view->priv->prelight_node,
2780 gtk_tree_view_leave_notify (GtkWidget *widget,
2781 GdkEventCrossing *event)
2783 GtkTreeView *tree_view;
2785 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2787 tree_view = GTK_TREE_VIEW (widget);
2789 if (tree_view->priv->prelight_node)
2790 gtk_tree_view_queue_draw_node (tree_view,
2791 tree_view->priv->prelight_tree,
2792 tree_view->priv->prelight_node,
2795 ensure_unprelighted (tree_view);
2802 gtk_tree_view_focus_in (GtkWidget *widget,
2803 GdkEventFocus *event)
2805 GtkTreeView *tree_view;
2807 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2808 g_return_val_if_fail (event != NULL, FALSE);
2810 tree_view = GTK_TREE_VIEW (widget);
2812 GTK_WIDGET_SET_FLAGS (widget, GTK_HAS_FOCUS);
2814 /* FIXME don't redraw so much */
2815 gtk_widget_queue_draw (widget);
2822 gtk_tree_view_focus_out (GtkWidget *widget,
2823 GdkEventFocus *event)
2825 g_return_val_if_fail (GTK_IS_TREE_VIEW (widget), FALSE);
2826 g_return_val_if_fail (event != NULL, FALSE);
2828 GTK_WIDGET_UNSET_FLAGS (widget, GTK_HAS_FOCUS);
2830 /* FIXME don't redraw so much */
2831 gtk_widget_queue_draw (widget);
2840 set_source_row (GdkDragContext *context,
2841 GtkTreeModel *model,
2842 GtkTreePath *source_row)
2844 g_object_set_data_full (G_OBJECT (context),
2845 "gtk-tree-view-source-row",
2846 source_row ? gtk_tree_row_reference_new (model, source_row) : NULL,
2847 (GDestroyNotify) (source_row ? gtk_tree_row_reference_free : NULL));
2851 get_source_row (GdkDragContext *context)
2853 GtkTreeRowReference *ref =
2854 g_object_get_data (G_OBJECT (context), "gtk-tree-view-source-row");
2857 return gtk_tree_row_reference_get_path (ref);
2864 set_dest_row (GdkDragContext *context,
2865 GtkTreeModel *model,
2866 GtkTreePath *dest_row)
2868 g_object_set_data_full (G_OBJECT (context),
2869 "gtk-tree-view-dest-row",
2870 dest_row ? gtk_tree_row_reference_new (model, dest_row) : NULL,
2871 (GDestroyNotify) (dest_row ? gtk_tree_row_reference_free : NULL));
2875 get_dest_row (GdkDragContext *context)
2877 GtkTreeRowReference *ref =
2878 g_object_get_data (G_OBJECT (context), "gtk-tree-view-dest-row");
2881 return gtk_tree_row_reference_get_path (ref);
2886 /* Get/set whether drag_motion requested the drag data and
2887 * drag_data_received should thus not actually insert the data,
2888 * since the data doesn't result from a drop.
2891 set_status_pending (GdkDragContext *context,
2892 GdkDragAction suggested_action)
2894 g_object_set_data (G_OBJECT (context),
2895 "gtk-tree-view-status-pending",
2896 GINT_TO_POINTER (suggested_action));
2899 static GdkDragAction
2900 get_status_pending (GdkDragContext *context)
2902 return GPOINTER_TO_INT (g_object_get_data (G_OBJECT (context),
2903 "gtk-tree-view-status-pending"));
2906 static TreeViewDragInfo*
2907 get_info (GtkTreeView *tree_view)
2909 return g_object_get_data (G_OBJECT (tree_view), "gtk-tree-view-drag-info");
2913 clear_source_info (TreeViewDragInfo *di)
2915 if (di->source_target_list)
2916 gtk_target_list_unref (di->source_target_list);
2918 if (di->row_draggable_closure)
2919 g_closure_unref (di->row_draggable_closure);
2921 di->source_target_list = NULL;
2922 di->row_draggable_closure = NULL;
2926 clear_dest_info (TreeViewDragInfo *di)
2928 if (di->location_droppable_closure)
2929 g_closure_unref (di->location_droppable_closure);
2931 if (di->dest_target_list)
2932 gtk_target_list_unref (di->dest_target_list);
2934 di->location_droppable_closure = NULL;
2935 di->dest_target_list = NULL;
2939 destroy_info (TreeViewDragInfo *di)
2941 clear_source_info (di);
2942 clear_dest_info (di);
2946 static TreeViewDragInfo*
2947 ensure_info (GtkTreeView *tree_view)
2949 TreeViewDragInfo *di;
2951 di = get_info (tree_view);
2955 di = g_new0 (TreeViewDragInfo, 1);
2957 g_object_set_data_full (G_OBJECT (tree_view),
2958 "gtk-tree-view-drag-info",
2960 (GDestroyNotify) destroy_info);
2967 remove_info (GtkTreeView *tree_view)
2969 g_object_set_data (G_OBJECT (tree_view), "gtk-tree-view-drag-info", NULL);
2973 drag_scan_timeout (gpointer data)
2975 GtkTreeView *tree_view;
2977 GdkModifierType state;
2978 GtkTreePath *path = NULL;
2979 GtkTreeViewColumn *column = NULL;
2980 GdkRectangle visible_rect;
2982 tree_view = GTK_TREE_VIEW (data);
2984 gdk_window_get_pointer (tree_view->priv->bin_window,
2987 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
2989 /* See if we are near the edge. */
2990 if ((x - visible_rect.x) < SCROLL_EDGE_SIZE ||
2991 (visible_rect.x + visible_rect.width - x) < SCROLL_EDGE_SIZE ||
2992 (y - visible_rect.y) < SCROLL_EDGE_SIZE ||
2993 (visible_rect.y + visible_rect.height - y) < SCROLL_EDGE_SIZE)
2995 gtk_tree_view_get_path_at_pos (tree_view,
2996 tree_view->priv->bin_window,
3005 gtk_tree_view_scroll_to_cell (tree_view,
3010 gtk_tree_path_free (path);
3019 remove_scroll_timeout (GtkTreeView *tree_view)
3021 if (tree_view->priv->scroll_timeout != 0)
3023 gtk_timeout_remove (tree_view->priv->scroll_timeout);
3024 tree_view->priv->scroll_timeout = 0;
3028 check_model_dnd (GtkTreeModel *model,
3029 GType required_iface,
3030 const gchar *signal)
3032 if (model == NULL || !G_TYPE_CHECK_INSTANCE_TYPE ((model), required_iface))
3034 g_warning ("You must override the default '%s' handler "
3035 "on GtkTreeView when using models that don't support "
3036 "the %s interface and enabling drag-and-drop. The simplest way to do this "
3037 "is to connect to '%s' and call "
3038 "gtk_signal_emit_stop_by_name() in your signal handler to prevent "
3039 "the default handler from running. Look at the source code "
3040 "for the default handler in gtktreeview.c to get an idea what "
3041 "your handler should do. (gtktreeview.c is in the GTK source "
3042 "code.) If you're using GTK from a language other than C, "
3043 "there may be a more natural way to override default handlers, e.g. via derivation.",
3044 signal, g_type_name (required_iface), signal);
3052 remove_open_timeout (GtkTreeView *tree_view)
3054 if (tree_view->priv->open_dest_timeout != 0)
3056 gtk_timeout_remove (tree_view->priv->open_dest_timeout);
3057 tree_view->priv->open_dest_timeout = 0;
3063 open_row_timeout (gpointer data)
3065 GtkTreeView *tree_view = data;
3066 GtkTreePath *dest_path = NULL;
3067 GtkTreeViewDropPosition pos;
3069 gtk_tree_view_get_drag_dest_row (tree_view,
3074 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
3075 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
3077 gtk_tree_view_expand_row (tree_view, dest_path, FALSE);
3078 tree_view->priv->open_dest_timeout = 0;
3080 gtk_tree_path_free (dest_path);
3087 gtk_tree_path_free (dest_path);
3092 /* Returns TRUE if event should not be propagated to parent widgets */
3094 set_destination_row (GtkTreeView *tree_view,
3095 GdkDragContext *context,
3098 GdkDragAction *suggested_action,
3101 GtkTreePath *path = NULL;
3102 GtkTreeViewDropPosition pos;
3103 GtkTreeViewDropPosition old_pos;
3104 TreeViewDragInfo *di;
3106 GtkTreePath *old_dest_path = NULL;
3108 *suggested_action = 0;
3111 widget = GTK_WIDGET (tree_view);
3113 di = get_info (tree_view);
3117 /* someone unset us as a drag dest, note that if
3118 * we return FALSE drag_leave isn't called
3121 gtk_tree_view_set_drag_dest_row (tree_view,
3123 GTK_TREE_VIEW_DROP_BEFORE);
3125 remove_scroll_timeout (GTK_TREE_VIEW (widget));
3126 remove_open_timeout (GTK_TREE_VIEW (widget));
3128 return FALSE; /* no longer a drop site */
3131 *target = gtk_drag_dest_find_target (widget, context, di->dest_target_list);
3132 if (*target == GDK_NONE)
3137 if (!gtk_tree_view_get_dest_row_at_pos (tree_view,
3142 /* can't drop here */
3143 remove_open_timeout (tree_view);
3145 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3147 GTK_TREE_VIEW_DROP_BEFORE);
3149 /* don't propagate to parent though */
3155 /* If we left the current row's "open" zone, unset the timeout for
3158 gtk_tree_view_get_drag_dest_row (tree_view,
3162 if (old_dest_path &&
3163 (gtk_tree_path_compare (path, old_dest_path) != 0 ||
3164 !(pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
3165 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE)))
3166 remove_open_timeout (tree_view);
3169 gtk_tree_path_free (old_dest_path);
3171 if (TRUE /* FIXME if the location droppable predicate */)
3173 GtkWidget *source_widget;
3175 *suggested_action = context->suggested_action;
3177 source_widget = gtk_drag_get_source_widget (context);
3179 if (source_widget == widget)
3181 /* Default to MOVE, unless the user has
3182 * pressed ctrl or alt to affect available actions
3184 if ((context->actions & GDK_ACTION_MOVE) != 0)
3185 *suggested_action = GDK_ACTION_MOVE;
3188 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3193 /* can't drop here */
3194 remove_open_timeout (tree_view);
3196 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3198 GTK_TREE_VIEW_DROP_BEFORE);
3204 get_logical_dest_row (GtkTreeView *tree_view)
3207 /* adjust path to point to the row the drop goes in front of */
3208 GtkTreePath *path = NULL;
3209 GtkTreeViewDropPosition pos;
3211 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
3216 if (pos == GTK_TREE_VIEW_DROP_BEFORE)
3218 else if (pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE ||
3219 pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER)
3221 /* get first child, drop before it */
3222 gtk_tree_path_append_index (path, 0);
3226 g_assert (pos == GTK_TREE_VIEW_DROP_AFTER);
3227 gtk_tree_path_next (path);
3234 gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
3235 GdkEventMotion *event)
3237 GdkDragContext *context;
3238 TreeViewDragInfo *di;
3239 GtkTreePath *path = NULL;
3241 gint cell_x, cell_y;
3242 GtkTreeModel *model;
3244 di = get_info (tree_view);
3249 if (tree_view->priv->pressed_button < 0)
3252 if (!gtk_drag_check_threshold (GTK_WIDGET (tree_view),
3253 tree_view->priv->press_start_x,
3254 tree_view->priv->press_start_y,
3255 event->x, event->y))
3258 model = gtk_tree_view_get_model (tree_view);
3263 button = tree_view->priv->pressed_button;
3264 tree_view->priv->pressed_button = -1;
3266 gtk_tree_view_get_path_at_pos (tree_view,
3267 tree_view->priv->bin_window,
3268 tree_view->priv->press_start_x,
3269 tree_view->priv->press_start_y,
3278 /* FIXME if the path doesn't match the row_draggable predicate,
3279 * return FALSE and free path
3282 /* FIXME Check whether we're a start button, if not return FALSE and
3286 context = gtk_drag_begin (GTK_WIDGET (tree_view),
3287 di->source_target_list,
3292 gtk_drag_set_icon_default (context);
3297 row_pix = gtk_tree_view_create_row_drag_icon (tree_view,
3300 gtk_drag_set_icon_pixmap (context,
3301 gdk_drawable_get_colormap (row_pix),
3304 /* the + 1 is for the black border in the icon */
3305 tree_view->priv->press_start_x + 1,
3308 gdk_pixmap_unref (row_pix);
3311 set_source_row (context, model, path);
3312 gtk_tree_path_free (path);
3319 gtk_tree_view_drag_begin (GtkWidget *widget,
3320 GdkDragContext *context)
3326 gtk_tree_view_drag_end (GtkWidget *widget,
3327 GdkDragContext *context)
3332 /* Default signal implementations for the drag signals */
3334 gtk_tree_view_drag_data_get (GtkWidget *widget,
3335 GdkDragContext *context,
3336 GtkSelectionData *selection_data,
3340 GtkTreeView *tree_view;
3341 GtkTreeModel *model;
3342 TreeViewDragInfo *di;
3343 GtkTreePath *source_row;
3345 tree_view = GTK_TREE_VIEW (widget);
3347 model = gtk_tree_view_get_model (tree_view);
3352 di = get_info (GTK_TREE_VIEW (widget));
3357 source_row = get_source_row (context);
3359 if (source_row == NULL)
3362 /* We can implement the GTK_TREE_MODEL_ROW target generically for
3363 * any model; for DragSource models there are some other targets
3367 if (GTK_IS_TREE_DRAG_SOURCE (model) &&
3368 gtk_tree_drag_source_drag_data_get (GTK_TREE_DRAG_SOURCE (model),
3373 /* If drag_data_get does nothing, try providing row data. */
3374 if (selection_data->target == gdk_atom_intern ("GTK_TREE_MODEL_ROW", FALSE))
3376 gtk_selection_data_set_tree_row (selection_data,
3382 gtk_tree_path_free (source_row);
3387 gtk_tree_view_drag_data_delete (GtkWidget *widget,
3388 GdkDragContext *context)
3390 TreeViewDragInfo *di;
3391 GtkTreeModel *model;
3392 GtkTreeView *tree_view;
3393 GtkTreePath *source_row;
3395 tree_view = GTK_TREE_VIEW (widget);
3396 model = gtk_tree_view_get_model (tree_view);
3398 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_SOURCE, "drag_data_delete"))
3401 di = get_info (tree_view);
3406 source_row = get_source_row (context);
3408 if (source_row == NULL)
3411 gtk_tree_drag_source_drag_data_delete (GTK_TREE_DRAG_SOURCE (model),
3414 gtk_tree_path_free (source_row);
3416 set_source_row (context, NULL, NULL);
3420 gtk_tree_view_drag_leave (GtkWidget *widget,
3421 GdkDragContext *context,
3424 TreeViewDragInfo *di;
3426 di = get_info (GTK_TREE_VIEW (widget));
3428 /* unset any highlight row */
3429 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3431 GTK_TREE_VIEW_DROP_BEFORE);
3433 remove_scroll_timeout (GTK_TREE_VIEW (widget));
3434 remove_open_timeout (GTK_TREE_VIEW (widget));
3439 gtk_tree_view_drag_motion (GtkWidget *widget,
3440 GdkDragContext *context,
3445 GtkTreePath *path = NULL;
3446 GtkTreeViewDropPosition pos;
3447 GtkTreeView *tree_view;
3448 GdkDragAction suggested_action = 0;
3451 tree_view = GTK_TREE_VIEW (widget);
3453 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
3456 // gtk_tree_view_ensure_scroll_timeout (tree_view);
3458 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
3462 /* Can't drop here. */
3463 gdk_drag_status (context, 0, time);
3467 if (tree_view->priv->open_dest_timeout == 0 &&
3468 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
3469 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
3471 tree_view->priv->open_dest_timeout =
3472 gtk_timeout_add (500, open_row_timeout, tree_view);
3475 if (target == gdk_atom_intern ("GTK_TREE_MODEL_ROW", FALSE))
3477 /* Request data so we can use the source row when
3478 * determining whether to accept the drop
3480 set_status_pending (context, suggested_action);
3481 gtk_drag_get_data (widget, context, target, time);
3485 set_status_pending (context, 0);
3486 gdk_drag_status (context, suggested_action, time);
3491 gtk_tree_path_free (path);
3498 gtk_tree_view_drag_drop (GtkWidget *widget,
3499 GdkDragContext *context,
3504 GtkTreeView *tree_view;
3506 GdkDragAction suggested_action = 0;
3507 GdkAtom target = GDK_NONE;
3508 TreeViewDragInfo *di;
3509 GtkTreeModel *model;
3511 tree_view = GTK_TREE_VIEW (widget);
3513 model = gtk_tree_view_get_model (tree_view);
3515 remove_scroll_timeout (GTK_TREE_VIEW (widget));
3516 remove_open_timeout (GTK_TREE_VIEW (widget));
3518 di = get_info (tree_view);
3523 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_drop"))
3526 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
3529 path = get_logical_dest_row (tree_view);
3531 if (target != GDK_NONE && path != NULL)
3533 /* in case a motion had requested drag data, change things so we
3534 * treat drag data receives as a drop.
3536 set_status_pending (context, 0);
3538 set_dest_row (context, model, path);
3542 gtk_tree_path_free (path);
3544 /* Unset this thing */
3545 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3547 GTK_TREE_VIEW_DROP_BEFORE);
3549 if (target != GDK_NONE)
3551 gtk_drag_get_data (widget, context, target, time);
3559 gtk_tree_view_drag_data_received (GtkWidget *widget,
3560 GdkDragContext *context,
3563 GtkSelectionData *selection_data,
3568 TreeViewDragInfo *di;
3569 gboolean accepted = FALSE;
3570 GtkTreeModel *model;
3571 GtkTreeView *tree_view;
3572 GtkTreePath *dest_row;
3573 GdkDragAction suggested_action;
3575 tree_view = GTK_TREE_VIEW (widget);
3577 model = gtk_tree_view_get_model (tree_view);
3579 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_data_received"))
3582 di = get_info (tree_view);
3587 suggested_action = get_status_pending (context);
3589 if (suggested_action)
3591 /* We are getting this data due to a request in drag_motion,
3592 * rather than due to a request in drag_drop, so we are just
3593 * supposed to call drag_status, not actually paste in the
3596 path = get_logical_dest_row (tree_view);
3599 suggested_action = 0;
3601 if (suggested_action)
3603 GtkTreeModel *src_model = NULL;
3604 GtkTreePath *src_path = NULL;
3606 if (!gtk_selection_data_get_tree_row (selection_data,
3609 suggested_action = 0;
3611 if (suggested_action)
3613 if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model),
3617 suggested_action = 0;
3619 gtk_tree_path_free (src_path);
3623 gdk_drag_status (context, suggested_action, time);
3626 gtk_tree_path_free (path);
3628 /* If you can't drop, remove user drop indicator until the next motion */
3629 if (suggested_action == 0)
3630 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
3632 GTK_TREE_VIEW_DROP_BEFORE);
3637 dest_row = get_dest_row (context);
3639 if (dest_row == NULL)
3642 if (selection_data->length >= 0)
3644 if (gtk_tree_drag_dest_drag_data_received (GTK_TREE_DRAG_DEST (model),
3650 gtk_drag_finish (context,
3652 (context->action == GDK_ACTION_MOVE),
3655 gtk_tree_path_free (dest_row);
3658 set_dest_row (context, NULL, NULL);
3663 /* GtkContainer Methods
3668 gtk_tree_view_remove (GtkContainer *container,
3671 GtkTreeView *tree_view;
3672 GtkTreeViewChild *child = NULL;
3675 g_return_if_fail (GTK_IS_TREE_VIEW (container));
3677 tree_view = GTK_TREE_VIEW (container);
3679 tmp_list = tree_view->priv->children;
3682 child = tmp_list->data;
3683 if (child->widget == widget)
3685 gtk_widget_unparent (widget);
3687 tree_view->priv->children = g_list_remove_link (tree_view->priv->children, tmp_list);
3688 g_list_free_1 (tmp_list);
3693 tmp_list = tmp_list->next;
3696 tmp_list = tree_view->priv->columns;
3700 GtkTreeViewColumn *column;
3701 column = tmp_list->data;
3702 if (column->button == widget)
3704 gtk_widget_unparent (widget);
3707 tmp_list = tmp_list->next;
3713 gtk_tree_view_forall (GtkContainer *container,
3714 gboolean include_internals,
3715 GtkCallback callback,
3716 gpointer callback_data)
3718 GtkTreeView *tree_view;
3719 GtkTreeViewChild *child = NULL;
3720 GtkTreeViewColumn *column;
3723 g_return_if_fail (GTK_IS_TREE_VIEW (container));
3724 g_return_if_fail (callback != NULL);
3726 tree_view = GTK_TREE_VIEW (container);
3728 tmp_list = tree_view->priv->children;
3731 child = tmp_list->data;
3732 tmp_list = tmp_list->next;
3734 (* callback) (child->widget, callback_data);
3736 if (include_internals == FALSE)
3739 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
3741 column = tmp_list->data;
3744 (* callback) (column->button, callback_data);
3748 /* Returns TRUE if the focus is within the headers, after the focus operation is
3752 gtk_tree_view_header_focus (GtkTreeView *tree_view,
3753 GtkDirectionType dir)
3755 GtkWidget *focus_child;
3756 GtkContainer *container;
3758 GList *last_column, *first_column;
3761 if (! GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
3764 focus_child = GTK_CONTAINER (tree_view)->focus_child;
3765 container = GTK_CONTAINER (tree_view);
3767 last_column = g_list_last (tree_view->priv->columns);
3770 if (GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (last_column->data)->button) &&
3771 GTK_TREE_VIEW_COLUMN (last_column->data)->visible)
3773 last_column = last_column->prev;
3776 /* No headers are visible, or are focusable. We can't focus in or out.
3778 if (last_column == NULL)
3781 first_column = tree_view->priv->columns;
3782 while (first_column)
3784 if (GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (first_column->data)->button) &&
3785 GTK_TREE_VIEW_COLUMN (first_column->data)->visible)
3787 first_column = first_column->next;
3792 case GTK_DIR_TAB_BACKWARD:
3793 case GTK_DIR_TAB_FORWARD:
3796 if (focus_child == NULL)
3798 if (tree_view->priv->focus_column != NULL)
3799 focus_child = tree_view->priv->focus_column->button;
3801 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
3802 gtk_widget_grab_focus (focus_child);
3809 if (focus_child == NULL)
3811 if (tree_view->priv->focus_column != NULL)
3812 focus_child = tree_view->priv->focus_column->button;
3813 else if (dir == GTK_DIR_LEFT)
3814 focus_child = GTK_TREE_VIEW_COLUMN (last_column->data)->button;
3816 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
3817 gtk_widget_grab_focus (focus_child);
3821 if (gtk_container_focus (GTK_CONTAINER (focus_child), dir))
3823 /* The focus moves inside the button. */
3824 /* This is probably a great example of bad UI */
3828 /* We need to move the focus among the row of buttons. */
3829 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
3830 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
3833 if (tmp_list == first_column && dir == GTK_DIR_LEFT)
3835 focus_child = GTK_TREE_VIEW_COLUMN (last_column->data)->button;
3836 gtk_widget_grab_focus (focus_child);
3839 else if (tmp_list == last_column && dir == GTK_DIR_RIGHT)
3841 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
3842 gtk_widget_grab_focus (focus_child);
3848 GtkTreeViewColumn *column;
3850 if (dir == GTK_DIR_RIGHT)
3851 tmp_list = tmp_list->next;
3853 tmp_list = tmp_list->prev;
3855 if (tmp_list == NULL)
3857 g_warning ("Internal button not found");
3860 column = tmp_list->data;
3861 if (column->button &&
3863 GTK_WIDGET_CAN_FOCUS (column->button))
3865 focus_child = column->button;
3866 gtk_widget_grab_focus (column->button);
3872 g_assert_not_reached ();
3876 /* if focus child is non-null, we assume it's been set to the current focus child
3880 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
3881 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
3884 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
3886 /* If the following isn't true, then the view is smaller then the scrollpane.
3888 if ((focus_child->allocation.x + focus_child->allocation.width) <=
3889 (tree_view->priv->hadjustment->upper))
3891 /* Scroll to the button, if needed */
3892 if ((tree_view->priv->hadjustment->value + tree_view->priv->hadjustment->page_size) <
3893 (focus_child->allocation.x + focus_child->allocation.width))
3894 gtk_adjustment_set_value (tree_view->priv->hadjustment,
3895 focus_child->allocation.x + focus_child->allocation.width -
3896 tree_view->priv->hadjustment->page_size);
3897 else if (tree_view->priv->hadjustment->value > focus_child->allocation.x)
3898 gtk_adjustment_set_value (tree_view->priv->hadjustment,
3899 focus_child->allocation.x);
3903 return (focus_child != NULL);
3906 /* We make the assumption that if container->focus_child != NULL, the focus must
3907 * be in the header. For now, this is accurate. It may not be in the future.
3910 /* The sordid relationship between focus_column and scroll_column:
3912 * The focus_column represents the column that currently has keyboard focus, and
3913 * is used when navigating columns by keyboard. scroll_column is used for
3914 * handling scrolling by keyboard, such that in cases.
3917 gtk_tree_view_focus (GtkContainer *container,
3918 GtkDirectionType direction)
3920 GtkTreeView *tree_view;
3921 GtkWidget *focus_child;
3923 GtkRBTree *cursor_tree;
3924 GtkRBNode *cursor_node;
3925 GtkTreePath *cursor_path;
3927 g_return_val_if_fail (GTK_IS_TREE_VIEW (container), FALSE);
3928 g_return_val_if_fail (GTK_WIDGET_VISIBLE (container), FALSE);
3930 tree_view = GTK_TREE_VIEW (container);
3932 if (!GTK_WIDGET_IS_SENSITIVE (container))
3935 focus_child = container->focus_child;
3937 /* Case 1. Headers currently have focus. */
3944 gtk_tree_view_header_focus (tree_view, direction);
3946 case GTK_DIR_TAB_BACKWARD:
3949 case GTK_DIR_TAB_FORWARD:
3951 if (tree_view->priv->tree == NULL)
3953 gtk_tree_view_set_cursor_focus (tree_view);
3958 /* Case 2. We don't have focus at all. */
3959 if (!GTK_WIDGET_HAS_FOCUS (container))
3961 if (tree_view->priv->tree == NULL &&
3962 (direction == GTK_DIR_TAB_BACKWARD ||
3963 direction == GTK_DIR_UP))
3964 return gtk_tree_view_header_focus (tree_view, direction);
3965 if (((direction == GTK_DIR_TAB_FORWARD) ||
3966 (direction == GTK_DIR_RIGHT) ||
3967 (direction == GTK_DIR_DOWN) ||
3968 (direction == GTK_DIR_LEFT)) &&
3969 gtk_tree_view_header_focus (tree_view, direction))
3972 if (tree_view->priv->tree == NULL)
3974 gtk_tree_view_set_cursor_focus (tree_view);
3978 /* Case 3. We have focus already. */
3979 if (tree_view->priv->tree == NULL)
3980 return gtk_tree_view_header_focus (tree_view, direction);
3982 if (direction == GTK_DIR_TAB_BACKWARD)
3983 return (gtk_tree_view_header_focus (tree_view, direction));
3984 else if (direction == GTK_DIR_TAB_FORWARD)
3987 /* Other directions caught by the keybindings */
3988 gtk_tree_view_set_cursor_focus (tree_view);
3994 gtk_tree_view_set_focus_child (GtkContainer *container,
3997 GtkTreeView *tree_view = GTK_TREE_VIEW (container);
4000 for (list = tree_view->priv->columns; list; list = list->next)
4002 if (GTK_TREE_VIEW_COLUMN (list->data)->button == child)
4004 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (list->data);
4009 (* parent_class->set_focus_child) (container, child);
4013 gtk_tree_view_set_adjustments (GtkTreeView *tree_view,
4014 GtkAdjustment *hadj,
4015 GtkAdjustment *vadj)
4017 gboolean need_adjust = FALSE;
4019 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
4022 g_return_if_fail (GTK_IS_ADJUSTMENT (hadj));
4024 hadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
4026 g_return_if_fail (GTK_IS_ADJUSTMENT (vadj));
4028 vadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
4030 if (tree_view->priv->hadjustment && (tree_view->priv->hadjustment != hadj))
4032 gtk_signal_disconnect_by_data (GTK_OBJECT (tree_view->priv->hadjustment), tree_view);
4033 gtk_object_unref (GTK_OBJECT (tree_view->priv->hadjustment));
4036 if (tree_view->priv->vadjustment && (tree_view->priv->vadjustment != vadj))
4038 gtk_signal_disconnect_by_data (GTK_OBJECT (tree_view->priv->vadjustment), tree_view);
4039 gtk_object_unref (GTK_OBJECT (tree_view->priv->vadjustment));
4042 if (tree_view->priv->hadjustment != hadj)
4044 tree_view->priv->hadjustment = hadj;
4045 gtk_object_ref (GTK_OBJECT (tree_view->priv->hadjustment));
4046 gtk_object_sink (GTK_OBJECT (tree_view->priv->hadjustment));
4048 gtk_signal_connect (GTK_OBJECT (tree_view->priv->hadjustment), "value_changed",
4049 (GtkSignalFunc) gtk_tree_view_adjustment_changed,
4054 if (tree_view->priv->vadjustment != vadj)
4056 tree_view->priv->vadjustment = vadj;
4057 gtk_object_ref (GTK_OBJECT (tree_view->priv->vadjustment));
4058 gtk_object_sink (GTK_OBJECT (tree_view->priv->vadjustment));
4060 gtk_signal_connect (GTK_OBJECT (tree_view->priv->vadjustment), "value_changed",
4061 (GtkSignalFunc) gtk_tree_view_adjustment_changed,
4067 gtk_tree_view_adjustment_changed (NULL, tree_view);
4071 gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
4072 GtkMovementStep step,
4074 gboolean extend_selection)
4076 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
4077 g_return_if_fail (step == GTK_MOVEMENT_LOGICAL_POSITIONS ||
4078 step == GTK_MOVEMENT_VISUAL_POSITIONS ||
4079 step == GTK_MOVEMENT_DISPLAY_LINES ||
4080 step == GTK_MOVEMENT_PAGES ||
4081 step == GTK_MOVEMENT_BUFFER_ENDS);
4083 if (tree_view->priv->tree == NULL)
4088 /* currently we make no distinction. When we go bi-di, we need to */
4089 case GTK_MOVEMENT_LOGICAL_POSITIONS:
4090 case GTK_MOVEMENT_VISUAL_POSITIONS:
4091 gtk_tree_view_move_cursor_left_right (tree_view, count);
4093 case GTK_MOVEMENT_DISPLAY_LINES:
4094 gtk_tree_view_move_cursor_up_down (tree_view, count, extend_selection);
4096 case GTK_MOVEMENT_PAGES:
4097 gtk_tree_view_move_cursor_page_up_down (tree_view, count, extend_selection);
4099 case GTK_MOVEMENT_BUFFER_ENDS:
4100 gtk_tree_view_move_cursor_start_end (tree_view, count, extend_selection);
4103 g_assert_not_reached ();
4107 /* TreeModel Callbacks
4111 gtk_tree_view_range_changed (GtkTreeModel *model,
4114 GtkTreePath *end_path,
4115 GtkTreeIter *end_iter,
4118 GtkTreeView *tree_view = (GtkTreeView *)data;
4122 gboolean dirty_marked;
4123 gboolean free_path = FALSE;
4124 gint vertical_separator;
4127 g_return_if_fail (path != NULL || iter != NULL);
4129 gtk_widget_style_get (GTK_WIDGET (data), "vertical_separator", &vertical_separator, NULL);
4133 path = gtk_tree_model_get_path (model, iter);
4136 else if (iter == NULL)
4137 gtk_tree_model_get_iter (model, iter, path);
4139 if (_gtk_tree_view_find_node (tree_view,
4143 /* We aren't actually showing the node */
4149 dirty_marked = gtk_tree_view_discover_dirty_iter (tree_view,
4151 gtk_tree_path_get_depth (path),
4154 if (GTK_RBNODE_GET_HEIGHT (node) != height + vertical_separator)
4156 _gtk_rbtree_node_set_height (tree, node, height + vertical_separator);
4157 gtk_widget_queue_resize (GTK_WIDGET (data));
4161 gtk_widget_queue_resize (GTK_WIDGET (data));
4163 gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
4167 gtk_tree_path_free (path);
4171 gtk_tree_view_inserted (GtkTreeModel *model,
4176 GtkTreeView *tree_view = (GtkTreeView *) data;
4178 GtkRBTree *tmptree, *tree;
4179 GtkRBNode *tmpnode = NULL;
4183 gboolean free_path = FALSE;
4185 if (tree_view->priv->tree == NULL)
4186 tree_view->priv->tree = _gtk_rbtree_new ();
4188 tmptree = tree = tree_view->priv->tree;
4189 g_return_if_fail (path != NULL || iter != NULL);
4193 path = gtk_tree_model_get_path (model, iter);
4196 else if (iter == NULL)
4197 gtk_tree_model_get_iter (model, iter, path);
4199 /* Update all row-references */
4200 gtk_tree_row_reference_inserted (G_OBJECT (data), path);
4202 depth = gtk_tree_path_get_depth (path);
4203 indices = gtk_tree_path_get_indices (path);
4205 /* First, find the parent tree */
4206 while (i < depth - 1)
4208 if (tmptree == NULL)
4210 /* We aren't showing the node */
4214 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
4215 if (tmpnode == NULL)
4217 g_warning ("A node was inserted with a parent that's not in the tree.\n" \
4218 "This possibly means that a GtkTreeModel inserted a child node\n" \
4219 "before the parent was inserted.");
4222 else if (!GTK_RBNODE_FLAG_SET (tmpnode, GTK_RBNODE_IS_PARENT))
4224 /* FIXME enforce correct behavior on model, probably */
4225 /* In theory, the model should have emitted has_child_toggled here. We
4226 * try to catch it anyway, just to be safe, in case the model hasn't.
4228 GtkTreePath *tmppath = _gtk_tree_view_find_path (tree_view,
4231 gtk_tree_view_has_child_toggled (model, tmppath, NULL, data);
4232 gtk_tree_path_free (tmppath);
4236 tmptree = tmpnode->children;
4245 gtk_tree_model_ref_node (tree_view->priv->model, iter);
4246 max_height = gtk_tree_view_insert_iter_height (tree_view,
4250 if (indices[depth - 1] == 0)
4252 tmpnode = _gtk_rbtree_find_count (tree, 1);
4253 _gtk_rbtree_insert_before (tree, tmpnode, max_height);
4257 tmpnode = _gtk_rbtree_find_count (tree, indices[depth - 1]);
4258 _gtk_rbtree_insert_after (tree, tmpnode, max_height);
4261 _gtk_tree_view_update_size (tree_view);
4265 gtk_tree_path_free (path);
4269 gtk_tree_view_has_child_toggled (GtkTreeModel *model,
4274 GtkTreeView *tree_view = (GtkTreeView *)data;
4275 GtkTreeIter real_iter;
4279 gboolean free_path = FALSE;
4281 g_return_if_fail (path != NULL || iter != NULL);
4288 path = gtk_tree_model_get_path (model, iter);
4291 else if (iter == NULL)
4292 gtk_tree_model_get_iter (model, &real_iter, path);
4294 if (_gtk_tree_view_find_node (tree_view,
4298 /* We aren't actually showing the node */
4304 has_child = gtk_tree_model_iter_has_child (model, &real_iter);
4307 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT) == has_child)
4311 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PARENT);
4313 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_PARENT);
4315 if (has_child && GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST))
4317 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
4318 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS))
4322 for (list = tree_view->priv->columns; list; list = list->next)
4323 if (GTK_TREE_VIEW_COLUMN (list->data)->visible)
4325 GTK_TREE_VIEW_COLUMN (list->data)->dirty = TRUE;
4329 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
4333 /* FIXME: Just redraw the node */
4334 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
4339 gtk_tree_path_free (path);
4343 gtk_tree_view_deleted (GtkTreeModel *model,
4347 GtkTreeView *tree_view = (GtkTreeView *)data;
4352 g_return_if_fail (path != NULL);
4354 if (_gtk_tree_view_find_node (tree_view, path, &tree, &node))
4360 gtk_tree_row_reference_deleted (G_OBJECT (data), path);
4362 /* next, update the selection */
4363 if (tree_view->priv->anchor)
4365 GtkTreePath *anchor_path;
4367 /* the row reference may not have been updated yet. If it has not,
4368 * then anchor_path and path being equal indicates that the anchor
4369 * row was deleted. If it has, then anchor_path == NULL indicates the
4370 * the anchor row was deleted.
4373 anchor_path = gtk_tree_row_reference_get_path (tree_view->priv->anchor);
4375 if (anchor_path == NULL ||
4376 gtk_tree_path_compare (path, anchor_path) == 0)
4378 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED) &&
4379 tree_view->priv->selection)
4380 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->selection),
4381 "selection_changed");
4385 gtk_tree_path_free (anchor_path);
4388 for (list = tree_view->priv->columns; list; list = list->next)
4389 if (((GtkTreeViewColumn *)list->data)->visible &&
4390 ((GtkTreeViewColumn *)list->data)->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
4391 ((GtkTreeViewColumn *)list->data)->dirty = TRUE;
4393 /* Ensure we don't have a dangling pointer to a dead node */
4394 ensure_unprelighted (tree_view);
4396 g_assert (tree_view->priv->prelight_node == NULL);
4398 if (tree->root->count == 1)
4400 if (tree_view->priv->tree == tree)
4401 tree_view->priv->tree = NULL;
4403 _gtk_rbtree_remove (tree);
4407 _gtk_rbtree_remove_node (tree, node);
4410 _gtk_tree_view_update_size (GTK_TREE_VIEW (data));
4415 gtk_tree_view_reordered (GtkTreeModel *model,
4416 GtkTreePath *parent,
4421 GtkTreeView *tree_view = GTK_TREE_VIEW (data);
4426 len = gtk_tree_model_iter_n_children (model, iter);
4431 gtk_tree_row_reference_reordered (G_OBJECT (data),
4436 if (_gtk_tree_view_find_node (tree_view,
4442 /* We need to special case the parent path */
4444 tree = tree_view->priv->tree;
4446 tree = node->children;
4451 /* FIXME: we need to unprelight our tree, if it's prelit. */
4452 _gtk_rbtree_reorder (tree, new_order, len);
4454 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
4458 /* Internal tree functions
4463 gtk_tree_view_get_background_xrange (GtkTreeView *tree_view,
4465 GtkTreeViewColumn *column,
4469 GtkTreeViewColumn *tmp_column = NULL;
4480 for (list = tree_view->priv->columns; list; list = list->next)
4482 tmp_column = list->data;
4484 if (tmp_column == column)
4487 if (tmp_column->visible)
4488 total_width += tmp_column->width;
4491 if (tmp_column != column)
4493 g_warning (G_STRLOC": passed-in column isn't in the tree");
4502 if (column->visible)
4503 *x2 = total_width + column->width;
4505 *x2 = total_width; /* width of 0 */
4510 gtk_tree_view_get_cell_xrange (GtkTreeView *tree_view,
4512 GtkTreeViewColumn *column,
4516 GtkTreeViewColumn *tmp_column = NULL;
4529 for (list = tree_view->priv->columns; list; list = list->next)
4531 tmp_column = list->data;
4533 if (tmp_column == column)
4536 if (tmp_column->visible)
4537 total_width += tmp_column->width;
4542 if (tmp_column != column)
4544 g_warning (G_STRLOC": passed-in column isn't in the tree");
4548 /* Remember we're getting the cell range, i.e. the cell_area passed
4549 * to the cell renderer.
4552 if (i == tree_view->priv->expander_column)
4553 total_width += tree_view->priv->tab_offset * _gtk_rbtree_get_depth (tree);
4560 if (column->visible)
4561 *x2 = total_width + column->displayed_width;
4563 *x2 = total_width; /* width of 0 */
4568 gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
4574 GtkTreeViewColumn *tmp_column = NULL;
4580 for (list = tree_view->priv->columns; list; list = list->next)
4582 tmp_column = list->data;
4584 if (i == tree_view->priv->expander_column)
4586 x_offset = total_width;
4590 if (tmp_column->visible)
4591 total_width += tmp_column->width;
4599 if (tmp_column && tmp_column->visible)
4601 /* +1 because x2 isn't included in the range. */
4603 *x2 = x_offset + tree_view->priv->tab_offset + 1;
4607 /* return an empty range, the expander column is hidden */
4614 gtk_tree_view_setup_model (GtkTreeView *tree_view)
4619 tree_view->priv->tree = NULL;
4621 g_signal_connectc (tree_view->priv->model,
4623 (GCallback) gtk_tree_view_range_changed,
4626 g_signal_connectc (tree_view->priv->model,
4628 (GCallback) gtk_tree_view_inserted,
4631 g_signal_connectc (tree_view->priv->model,
4632 "has_child_toggled",
4633 (GCallback) gtk_tree_view_has_child_toggled,
4636 g_signal_connectc (tree_view->priv->model,
4638 (GCallback) gtk_tree_view_deleted,
4641 g_signal_connectc (tree_view->priv->model,
4643 (GCallback) gtk_tree_view_reordered,
4647 if (tree_view->priv->columns == NULL)
4650 path = gtk_tree_path_new_root ();
4652 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, path))
4654 tree_view->priv->tree = _gtk_rbtree_new ();
4655 gtk_tree_view_build_tree (tree_view, tree_view->priv->tree, &iter, 1, FALSE, GTK_WIDGET_REALIZED (tree_view));
4658 gtk_tree_path_free (path);
4660 /* FIXME: do I need to do this? gtk_tree_view_create_buttons (tree_view); */
4662 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_MODEL_SETUP);
4666 gtk_tree_view_insert_iter_height (GtkTreeView *tree_view,
4671 GtkTreeViewColumn *column;
4673 gint max_height = 0;
4675 gint vertical_separator;
4679 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical_separator", &vertical_separator, NULL);
4680 /* do stuff with node */
4681 for (list = tree_view->priv->columns; list; list = list->next)
4683 gint height = 0, width = 0;
4684 column = list->data;
4686 if (!column->visible)
4689 if (column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
4695 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter);
4697 gtk_tree_view_column_cell_get_size (column, NULL, NULL, NULL, &width, &height);
4698 max_height = MAX (max_height, vertical_separator + height);
4700 if (i == tree_view->priv->expander_column &&
4701 TREE_VIEW_DRAW_EXPANDERS (tree_view))
4702 _gtk_tree_view_column_set_width (column,
4703 MAX (column->width, depth * tree_view->priv->tab_offset + width));
4705 _gtk_tree_view_column_set_width (column,
4706 MAX (column->width, width));
4714 gtk_tree_view_build_tree (GtkTreeView *tree_view,
4719 gboolean calc_bounds)
4721 GtkRBNode *temp = NULL;
4728 max_height = gtk_tree_view_insert_iter_height (tree_view,
4733 gtk_tree_model_ref_node (tree_view->priv->model, iter);
4734 temp = _gtk_rbtree_insert_after (tree, temp, max_height);
4739 if (gtk_tree_model_iter_children (tree_view->priv->model, &child, iter))
4741 temp->children = _gtk_rbtree_new ();
4742 temp->children->parent_tree = tree;
4743 temp->children->parent_node = temp;
4744 gtk_tree_view_build_tree (tree_view, temp->children, &child, depth + 1, recurse, calc_bounds);
4747 if (gtk_tree_model_iter_has_child (tree_view->priv->model, iter))
4749 if ((temp->flags>K_RBNODE_IS_PARENT) != GTK_RBNODE_IS_PARENT)
4750 temp->flags ^= GTK_RBNODE_IS_PARENT;
4751 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
4754 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
4758 gtk_tree_view_calc_size (GtkTreeView *tree_view,
4766 GtkTreeViewColumn *column;
4768 gint vertical_separator;
4771 TREE_VIEW_INTERNAL_ASSERT_VOID (tree != NULL);
4773 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical_separator", &vertical_separator, NULL);
4776 while (temp->left != tree->nil)
4782 /* Do stuff with node */
4783 for (list = tree_view->priv->columns, i = 0; i < tree_view->priv->n_columns; list = list->next, i++)
4785 gint height = 0, width = 0;
4786 column = list->data;
4788 if (!column->visible)
4791 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter);
4792 gtk_tree_view_column_cell_get_size (column, NULL, NULL, NULL, &width, &height);
4793 max_height = MAX (max_height, vertical_separator + height);
4795 /* FIXME: I'm getting the width of all nodes here. )-: */
4796 if (column->dirty == FALSE)
4799 if (column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
4803 if (i == tree_view->priv->expander_column &&
4804 TREE_VIEW_DRAW_EXPANDERS (tree_view))
4805 _gtk_tree_view_column_set_width (column,
4806 MAX (column->width, depth * tree_view->priv->tab_offset + width));
4808 _gtk_tree_view_column_set_width (column, MAX (column->width, width));
4811 _gtk_rbtree_node_set_height (tree, temp, max_height);
4813 if (temp->children != NULL &&
4814 gtk_tree_model_iter_children (tree_view->priv->model, &child, iter))
4815 gtk_tree_view_calc_size (tree_view, temp->children, &child, depth + 1);
4816 temp = _gtk_rbtree_next (tree, temp);
4818 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
4822 gtk_tree_view_discover_dirty_iter (GtkTreeView *tree_view,
4827 GtkTreeViewColumn *column;
4830 gboolean retval = FALSE;
4836 for (i = 0, list = tree_view->priv->columns; list; list = list->next, i++)
4839 column = list->data;
4840 if (column->dirty == TRUE || column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
4842 if (!column->visible)
4845 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter);
4849 gtk_tree_view_column_cell_get_size (column,
4851 &width, &tmpheight);
4852 *height = MAX (*height, tmpheight);
4856 gtk_tree_view_column_cell_get_size (column,
4860 if (i == tree_view->priv->expander_column &&
4861 TREE_VIEW_DRAW_EXPANDERS (tree_view))
4863 if (depth * tree_view->priv->tab_offset + width > column->width)
4865 column->dirty = TRUE;
4871 if (width > column->width)
4873 column->dirty = TRUE;
4883 gtk_tree_view_discover_dirty (GtkTreeView *tree_view,
4888 GtkRBNode *temp = tree->root;
4889 GtkTreeViewColumn *column;
4892 gboolean is_all_dirty;
4894 TREE_VIEW_INTERNAL_ASSERT_VOID (tree != NULL);
4896 while (temp->left != tree->nil)
4901 TREE_VIEW_INTERNAL_ASSERT_VOID (temp != NULL);
4902 is_all_dirty = TRUE;
4903 for (list = tree_view->priv->columns; list; list = list->next)
4905 column = list->data;
4906 if (column->dirty == FALSE)
4908 is_all_dirty = FALSE;
4916 gtk_tree_view_discover_dirty_iter (tree_view,
4920 if (gtk_tree_model_iter_children (tree_view->priv->model, &child, iter) &&
4921 temp->children != NULL)
4922 gtk_tree_view_discover_dirty (tree_view, temp->children, &child, depth + 1);
4923 temp = _gtk_rbtree_next (tree, temp);
4925 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
4930 gtk_tree_view_check_dirty (GtkTreeView *tree_view)
4933 gboolean dirty = FALSE;
4935 GtkTreeViewColumn *column;
4938 if (!GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_MODEL_SETUP) &&
4939 tree_view->priv->model)
4940 gtk_tree_view_setup_model (tree_view);
4942 for (list = tree_view->priv->columns; list; list = list->next)
4944 column = list->data;
4948 if (column->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
4953 w = MAX (w, column->button->requisition.width);
4955 _gtk_tree_view_column_set_width (column, w);
4963 if (tree_view->priv->model == NULL)
4966 path = gtk_tree_path_new_root ();
4967 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, path))
4969 gtk_tree_view_calc_size (tree_view, tree_view->priv->tree, &iter, 1);
4970 _gtk_tree_view_update_size (tree_view);
4973 gtk_tree_path_free (path);
4975 for (list = tree_view->priv->columns; list; list = list->next)
4977 column = list->data;
4978 column->dirty = FALSE;
4982 /* Make sure the node is visible vertically */
4984 gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
4990 offset = _gtk_rbtree_node_find_offset (tree, node);
4992 /* we reverse the order, b/c in the unusual case of the
4993 * node's height being taller then the visible area, we'd rather
4994 * have the node flush to the top
4996 if (offset + GTK_RBNODE_GET_HEIGHT (node) >
4997 tree_view->priv->vadjustment->value + tree_view->priv->vadjustment->page_size)
4998 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment),
4999 offset + GTK_RBNODE_GET_HEIGHT (node) -
5000 tree_view->priv->vadjustment->page_size);
5001 if (offset < tree_view->priv->vadjustment->value)
5002 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment),
5006 /* This function could be more efficient.
5007 * I'll optimize it if profiling seems to imply that
5011 _gtk_tree_view_find_path (GtkTreeView *tree_view,
5016 GtkRBTree *tmp_tree;
5017 GtkRBNode *tmp_node, *last;
5020 path = gtk_tree_path_new ();
5022 g_return_val_if_fail (node != NULL, path);
5023 g_return_val_if_fail (node != tree->nil, path);
5025 count = 1 + node->left->count;
5028 tmp_node = node->parent;
5032 while (tmp_node != tmp_tree->nil)
5034 if (tmp_node->right == last)
5035 count += 1 + tmp_node->left->count;
5037 tmp_node = tmp_node->parent;
5039 gtk_tree_path_prepend_index (path, count - 1);
5040 last = tmp_tree->parent_node;
5041 tmp_tree = tmp_tree->parent_tree;
5044 count = 1 + last->left->count;
5045 tmp_node = last->parent;
5051 /* Returns TRUE if we ran out of tree before finding the path.
5054 _gtk_tree_view_find_node (GtkTreeView *tree_view,
5059 GtkRBNode *tmpnode = NULL;
5060 GtkRBTree *tmptree = tree_view->priv->tree;
5061 gint *indices = gtk_tree_path_get_indices (path);
5062 gint depth = gtk_tree_path_get_depth (path);
5072 if (tmptree == NULL)
5078 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
5086 tmptree = tmpnode->children;
5092 gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
5095 GtkMovementStep step,
5098 g_return_if_fail ((modmask & GDK_SHIFT_MASK) == 0);
5100 gtk_binding_entry_add_signal (binding_set, keyval, modmask,
5102 GTK_TYPE_ENUM, step,
5103 GTK_TYPE_INT, count,
5104 GTK_TYPE_BOOL, FALSE);
5106 /* Selection-extending version */
5107 gtk_binding_entry_add_signal (binding_set, keyval, modmask | GDK_SHIFT_MASK,
5109 GTK_TYPE_ENUM, step,
5110 GTK_TYPE_INT, count,
5111 GTK_TYPE_BOOL, TRUE);
5115 gtk_tree_view_unref_tree_helper (GtkTreeModel *model,
5122 g_return_if_fail (node != NULL);
5127 GtkRBTree *new_tree;
5128 GtkRBNode *new_node;
5130 new_tree = node->children;
5131 new_node = new_tree->root;
5133 while (new_node && new_node->left != new_tree->nil)
5134 new_node = new_node->left;
5136 g_return_if_fail (gtk_tree_model_iter_children (model, &child, iter));
5137 gtk_tree_view_unref_tree_helper (model, &child, new_tree, new_node);
5140 gtk_tree_model_unref_node (model, iter);
5141 node = _gtk_rbtree_next (tree, node);
5143 while (gtk_tree_model_iter_next (model, iter));
5147 gtk_tree_view_unref_tree (GtkTreeView *tree_view,
5155 while (node && node->left != tree->nil)
5158 g_return_if_fail (node != NULL);
5159 path = _gtk_tree_view_find_path (tree_view, tree, node);
5160 gtk_tree_model_get_iter (GTK_TREE_MODEL (tree_view->priv->model),
5162 gtk_tree_view_unref_tree_helper (GTK_TREE_MODEL (tree_view->priv->model), &iter, tree, node);
5163 gtk_tree_path_free (path);
5167 gtk_tree_view_set_column_drag_info (GtkTreeView *tree_view,
5168 GtkTreeViewColumn *column)
5170 GtkTreeViewColumn *left_column;
5171 GtkTreeViewColumn *cur_column = NULL;
5172 GtkTreeViewColumnReorder *reorder;
5177 /* We want to precalculate the motion list such that we know what column slots
5182 /* First, identify all possible drop spots */
5183 tmp_list = tree_view->priv->columns;
5187 g_assert (tmp_list);
5189 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5190 tmp_list = tmp_list->next;
5192 if (cur_column->visible == FALSE)
5195 /* If it's not the column moving and func tells us to skip over the column, we continue. */
5196 if (left_column != column && cur_column != column &&
5197 tree_view->priv->column_drop_func &&
5198 ! (* tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5200 left_column = cur_column;
5203 reorder = g_new (GtkTreeViewColumnReorder, 1);
5204 reorder->left_column = left_column;
5205 left_column = reorder->right_column = cur_column;
5207 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
5210 /* Add the last one */
5211 if (tree_view->priv->column_drop_func == NULL ||
5212 ((left_column != column) &&
5213 (* tree_view->priv->column_drop_func) (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data)))
5215 reorder = g_new (GtkTreeViewColumnReorder, 1);
5216 reorder->left_column = left_column;
5217 reorder->right_column = NULL;
5218 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
5221 /* We quickly check to see if it even makes sense to reorder columns. */
5222 /* If there is nothing that can be moved, then we return */
5224 if (tree_view->priv->column_drag_info == NULL)
5227 /* We know there are always 2 slots possbile, as you can always return column. */
5228 /* If that's all there is, return */
5229 if (tree_view->priv->column_drag_info->next->next == NULL &&
5230 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->data)->right_column == column &&
5231 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->next->data)->left_column == column)
5233 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
5234 g_free (tmp_list->data);
5235 g_list_free (tree_view->priv->column_drag_info);
5236 tree_view->priv->column_drag_info = NULL;
5239 /* We fill in the ranges for the columns, now that we've isolated them */
5240 left = - TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
5242 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
5244 reorder = (GtkTreeViewColumnReorder *) tmp_list->data;
5246 reorder->left_align = left;
5247 if (tmp_list->next != NULL)
5249 g_assert (tmp_list->next->data);
5250 left = reorder->right_align = (reorder->right_column->button->allocation.x +
5251 reorder->right_column->button->allocation.width +
5252 ((GtkTreeViewColumnReorder *)tmp_list->next->data)->left_column->button->allocation.x)/2;
5258 gdk_window_get_size (tree_view->priv->header_window, &width, NULL);
5259 reorder->right_align = width + TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
5265 _gtk_tree_view_column_start_drag (GtkTreeView *tree_view,
5266 GtkTreeViewColumn *column)
5268 GdkEvent send_event;
5269 GtkAllocation allocation;
5270 gint x, y, width, height;
5272 g_return_if_fail (tree_view->priv->column_drag_info == NULL);
5274 gtk_tree_view_set_column_drag_info (tree_view, column);
5276 if (tree_view->priv->column_drag_info == NULL)
5279 if (tree_view->priv->drag_window == NULL)
5281 GdkWindowAttr attributes;
5282 guint attributes_mask;
5284 attributes.window_type = GDK_WINDOW_CHILD;
5285 attributes.wclass = GDK_INPUT_OUTPUT;
5286 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
5287 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
5288 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
5289 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
5291 tree_view->priv->drag_window = gdk_window_new (tree_view->priv->bin_window,
5294 gdk_window_set_user_data (tree_view->priv->drag_window, GTK_WIDGET (tree_view));
5297 gdk_pointer_ungrab (GDK_CURRENT_TIME);
5298 gdk_keyboard_ungrab (GDK_CURRENT_TIME);
5300 gtk_grab_remove (column->button);
5302 send_event.crossing.type = GDK_LEAVE_NOTIFY;
5303 send_event.crossing.send_event = TRUE;
5304 send_event.crossing.window = column->button->window;
5305 send_event.crossing.subwindow = NULL;
5306 send_event.crossing.detail = GDK_NOTIFY_ANCESTOR;
5307 send_event.crossing.time = GDK_CURRENT_TIME;
5309 gtk_propagate_event (column->button, &send_event);
5311 send_event.button.type = GDK_BUTTON_RELEASE;
5312 send_event.button.window = GDK_ROOT_PARENT ();
5313 send_event.button.send_event = TRUE;
5314 send_event.button.time = GDK_CURRENT_TIME;
5315 send_event.button.x = -1;
5316 send_event.button.y = -1;
5317 send_event.button.axes = NULL;
5318 send_event.button.state = 0;
5319 send_event.button.button = 1;
5320 send_event.button.device = gdk_core_pointer;
5321 send_event.button.x_root = 0;
5322 send_event.button.y_root = 0;
5324 gtk_propagate_event (column->button, &send_event);
5326 gdk_window_move_resize (tree_view->priv->drag_window,
5327 column->button->allocation.x,
5328 column->button->allocation.y + column->button->allocation.height,
5329 column->button->allocation.width,
5330 column->button->allocation.height);
5331 gdk_window_reparent (column->button->window, tree_view->priv->drag_window, 0, 0);
5332 tree_view->priv->drag_column_x = column->button->allocation.x;
5333 allocation = column->button->allocation;
5335 gtk_widget_size_allocate (column->button, &allocation);
5336 gtk_widget_set_parent_window (column->button, tree_view->priv->drag_window);
5338 tree_view->priv->drag_column = column;
5339 gdk_window_show (tree_view->priv->drag_window);
5341 gdk_window_get_origin (tree_view->priv->header_window, &x, &y);
5342 gdk_window_get_size (tree_view->priv->header_window, &width, &height);
5344 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5345 while (gtk_events_pending ())
5346 gtk_main_iteration ();
5348 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
5349 gdk_pointer_grab (tree_view->priv->drag_window,
5351 GDK_POINTER_MOTION_MASK|GDK_BUTTON_RELEASE_MASK,
5352 NULL, NULL, GDK_CURRENT_TIME);
5353 gdk_keyboard_grab (tree_view->priv->drag_window,
5360 gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
5363 GdkRectangle *clip_rect)
5367 if (!GTK_WIDGET_REALIZED (tree_view))
5371 rect.width = tree_view->priv->width;
5373 rect.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
5374 rect.height = BACKGROUND_HEIGHT (node);
5378 GdkRectangle new_rect;
5380 gdk_rectangle_intersect (clip_rect, &rect, &new_rect);
5382 gdk_window_invalidate_rect (tree_view->priv->bin_window, &new_rect, TRUE);
5386 gdk_window_invalidate_rect (tree_view->priv->bin_window, &rect, TRUE);
5391 gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
5393 GdkRectangle *clip_rect)
5395 GtkRBTree *tree = NULL;
5396 GtkRBNode *node = NULL;
5398 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
5401 gtk_tree_view_queue_draw_node (tree_view, tree, node, clip_rect);
5404 /* x and y are the mouse position
5407 gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
5417 gint vertical_separator;
5418 gint expander_height;
5420 gtk_widget_style_get (GTK_WIDGET (tree_view),
5421 "vertical_separator", &vertical_separator,
5422 "expander_height", &expander_height,
5425 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
5428 widget = GTK_WIDGET (tree_view);
5430 gtk_tree_view_get_arrow_xrange (tree_view, &x_offset, NULL);
5433 area.y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
5434 area.width = tree_view->priv->tab_offset - 2;
5435 area.height = CELL_HEIGHT (node, vertical_separator);
5437 if (node == tree_view->priv->button_pressed_node)
5439 if (x >= area.x && x <= (area.x + area.width) &&
5440 y >= area.y && y <= (area.y + area.height))
5441 state = GTK_STATE_ACTIVE;
5443 state = GTK_STATE_NORMAL;
5447 if (node == tree_view->priv->prelight_node &&
5448 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
5449 state = GTK_STATE_PRELIGHT;
5451 state = GTK_STATE_NORMAL;
5454 gtk_paint_expander (widget->style,
5455 tree_view->priv->bin_window,
5461 (area.y + (area.height - expander_height) / 2 - (area.height + 1) % 2),
5462 node->children != NULL);
5467 _gtk_tree_view_update_col_width (GtkTreeView *tree_view)
5469 GList *list, *last_column;
5470 GtkTreeViewColumn *column;
5473 for (last_column = g_list_last (tree_view->priv->columns);
5475 !(GTK_TREE_VIEW_COLUMN (last_column->data)->visible) &&
5476 GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (last_column->data)->button);
5477 last_column = last_column->prev)
5480 if (last_column == NULL)
5483 for (list = tree_view->priv->columns; list != last_column; list = list->next)
5485 column = GTK_TREE_VIEW_COLUMN (list->data);
5486 if (! column->visible)
5489 width += column->width;
5490 column->displayed_width = (CLAMP (column->width, (column->min_width!=-1)?column->min_width:column->width, (column->max_width!=-1)?column->max_width:column->width));
5492 column = GTK_TREE_VIEW_COLUMN (last_column->data);
5493 column->displayed_width = MAX (GTK_WIDGET (tree_view)->allocation.width, tree_view->priv->width) - width;
5497 gtk_tree_view_set_cursor_focus (GtkTreeView *tree_view)
5500 GtkTreePath *cursor_path;
5502 if ((tree_view->priv->tree == NULL) ||
5503 (! GTK_WIDGET_REALIZED (tree_view)))
5506 if (tree_view->priv->selection == NULL)
5507 tree_view->priv->selection =
5508 _gtk_tree_selection_new_with_tree_view (tree_view);
5510 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
5511 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5514 if (tree_view->priv->cursor)
5515 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5517 if (cursor_path == NULL)
5519 GtkTreePath *tmp_path = gtk_tree_path_new_root ();
5520 /* FIXME: Get the first one visible!!! */
5521 if (tree_view->priv->cursor)
5522 gtk_tree_row_reference_free (tree_view->priv->cursor);
5524 tree_view->priv->cursor =
5525 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, tmp_path);
5526 cursor_path = tmp_path;
5529 gtk_tree_selection_select_path (tree_view->priv->selection, cursor_path);
5530 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
5531 gtk_tree_path_free (cursor_path);
5536 gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
5538 gboolean extend_selection)
5540 GtkRBTree *cursor_tree = NULL;
5541 GtkRBNode *cursor_node = NULL;
5542 GtkRBTree *new_cursor_tree = NULL;
5543 GtkRBNode *new_cursor_node = NULL;
5544 GtkTreePath *cursor_path = NULL;
5547 if (tree_view->priv->cursor)
5548 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5550 if (cursor_path == NULL)
5553 _gtk_tree_view_find_node (tree_view, cursor_path,
5554 &cursor_tree, &cursor_node);
5557 _gtk_rbtree_prev_full (cursor_tree, cursor_node,
5558 &new_cursor_tree, &new_cursor_node);
5560 _gtk_rbtree_next_full (cursor_tree, cursor_node,
5561 &new_cursor_tree, &new_cursor_node);
5563 if (new_cursor_node)
5565 gtk_tree_path_free (cursor_path);
5567 cursor_path = _gtk_tree_view_find_path (tree_view, new_cursor_tree, new_cursor_node);
5568 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
5572 extend_selection?GDK_SHIFT_MASK:0);
5573 gtk_tree_row_reference_free (tree_view->priv->cursor);
5574 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, cursor_path);
5575 gtk_tree_view_clamp_node_visible (tree_view, new_cursor_tree, new_cursor_node);
5579 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
5582 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5583 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
5584 gtk_tree_path_free (cursor_path);
5588 gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
5590 gboolean extend_selection)
5592 g_print ("gtk_tree_view_move_cursor_page_up_down\n");
5596 gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
5599 GtkRBTree *cursor_tree = NULL;
5600 GtkRBNode *cursor_node = NULL;
5601 GtkTreePath *cursor_path = NULL;
5603 g_print ("gtk_tree_view_move_cursor_left_right\n");
5606 if (tree_view->priv->cursor)
5607 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5609 if (cursor_path == NULL)
5612 _gtk_tree_view_find_node (tree_view, cursor_path,
5613 &cursor_tree, &cursor_node);
5614 gtk_tree_path_free (cursor_path);
5620 gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
5622 gboolean extend_selection)
5624 GtkRBTree *cursor_tree;
5625 GtkRBNode *cursor_node;
5628 g_return_if_fail (tree_view->priv->tree != NULL);
5632 cursor_tree = tree_view->priv->tree;
5633 cursor_node = cursor_tree->root;
5634 while (cursor_node && cursor_node->left != cursor_tree->nil)
5635 cursor_node = cursor_node->left;
5639 cursor_tree = tree_view->priv->tree;
5640 cursor_node = cursor_tree->root;
5643 while (cursor_node && cursor_node->right != cursor_tree->nil)
5644 cursor_node = cursor_node->right;
5645 if (cursor_node->children == NULL)
5648 cursor_tree = cursor_node->children;
5649 cursor_node = cursor_tree->root;
5654 path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
5655 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
5659 extend_selection?GDK_SHIFT_MASK:0);
5661 gtk_tree_row_reference_free (tree_view->priv->cursor);
5662 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
5663 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
5667 gtk_tree_view_real_set_anchor (GtkTreeView *tree_view)
5673 gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view)
5675 GtkRBTree *cursor_tree = NULL;
5676 GtkRBNode *cursor_node = NULL;
5677 GtkTreePath *cursor_path = NULL;
5680 if (tree_view->priv->cursor)
5681 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5683 if (cursor_path == NULL)
5686 _gtk_tree_view_find_node (tree_view, cursor_path,
5687 &cursor_tree, &cursor_node);
5688 if (cursor_tree == NULL)
5691 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
5697 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
5699 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5700 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
5701 gtk_tree_path_free (cursor_path);
5707 gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
5712 GtkTreePath *cursor_path = NULL;
5714 g_print ("in gtk_tree_view_real_expand_collapse_cursor_row\n");
5716 if (tree_view->priv->cursor)
5717 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5719 if (cursor_path == NULL)
5723 gtk_tree_view_expand_row (tree_view, cursor_path, open_all);
5725 gtk_tree_view_collapse_row (tree_view, cursor_path);
5727 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5728 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
5729 gtk_tree_path_free (cursor_path);
5733 gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view)
5735 GtkRBTree *cursor_tree = NULL;
5736 GtkRBNode *cursor_node = NULL;
5737 GtkTreePath *cursor_path = NULL;
5740 if (tree_view->priv->cursor)
5741 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
5743 if (cursor_path == NULL)
5746 _gtk_tree_view_find_node (tree_view, cursor_path,
5747 &cursor_tree, &cursor_node);
5748 if (cursor_tree == NULL)
5751 if (cursor_tree->parent_node)
5753 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
5754 cursor_node = cursor_tree->parent_node;
5755 cursor_tree = cursor_tree->parent_tree;
5757 gtk_tree_path_up (cursor_path);
5758 gtk_tree_row_reference_free (tree_view->priv->cursor);
5759 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, cursor_path);
5760 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
5767 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
5769 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5770 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
5771 gtk_tree_path_free (cursor_path);
5775 _gtk_tree_view_update_size (GtkTreeView *tree_view)
5779 GtkTreeViewColumn *column;
5780 gint vertical_separator;
5783 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical_separator", &vertical_separator, NULL);
5785 if (tree_view->priv->model == NULL)
5787 tree_view->priv->width = 0;
5788 tree_view->priv->height = 0;
5789 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
5794 for (list = tree_view->priv->columns, i = 0; list; list = list->next, i++)
5796 column = list->data;
5797 if (!column->visible)
5799 width += TREE_VIEW_COLUMN_WIDTH (column);
5802 if (tree_view->priv->tree == NULL)
5805 height = tree_view->priv->tree->root->offset + vertical_separator;
5807 if (tree_view->priv->width != width)
5809 tree_view->priv->width = width;
5810 tree_view->priv->hadjustment->upper = width;
5811 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->hadjustment), "changed");
5814 if (tree_view->priv->height != height)
5816 tree_view->priv->height = height;
5817 tree_view->priv->vadjustment->upper = tree_view->priv->height;
5818 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->vadjustment), "changed");
5821 if (GTK_WIDGET_REALIZED (tree_view))
5823 gdk_window_resize (tree_view->priv->bin_window, MAX (width, GTK_WIDGET (tree_view)->allocation.width), height + TREE_VIEW_HEADER_HEIGHT (tree_view));
5824 gdk_window_resize (tree_view->priv->header_window, MAX (width, GTK_WIDGET (tree_view)->allocation.width), tree_view->priv->header_height);
5826 _gtk_tree_view_update_col_width (tree_view);
5829 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
5832 /* this function returns the new width of the column being resized given
5833 * the column and x position of the cursor; the x cursor position is passed
5834 * in as a pointer and automagicly corrected if it's beyond min/max limits
5837 gtk_tree_view_new_column_width (GtkTreeView *tree_view,
5841 GtkTreeViewColumn *column;
5844 /* first translate the x position from widget->window
5845 * to clist->clist_window
5848 column = g_list_nth (tree_view->priv->columns, i)->data;
5849 width = *x - column->button->allocation.x;
5851 /* Clamp down the value */
5852 if (column->min_width == -1)
5853 width = MAX (column->button->requisition.width,
5856 width = MAX (column->min_width,
5858 if (column->max_width != -1)
5859 width = MIN (width, column->max_width != -1);
5860 *x = column->button->allocation.x + width;
5868 gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
5869 GtkTreeView *tree_view)
5871 if (GTK_WIDGET_REALIZED (tree_view))
5873 gdk_window_move (tree_view->priv->bin_window,
5874 - tree_view->priv->hadjustment->value,
5875 - tree_view->priv->vadjustment->value);
5876 gdk_window_move (tree_view->priv->header_window,
5877 - tree_view->priv->hadjustment->value,
5880 gdk_window_process_updates (tree_view->priv->bin_window, TRUE);
5881 gdk_window_process_updates (tree_view->priv->header_window, TRUE);
5891 * gtk_tree_view_new:
5893 * Creates a new #GtkTreeView widget.
5895 * Return value: A newly created #GtkTreeView widget.
5898 gtk_tree_view_new (void)
5900 GtkTreeView *tree_view;
5902 tree_view = GTK_TREE_VIEW (gtk_type_new (gtk_tree_view_get_type ()));
5904 return GTK_WIDGET (tree_view);
5908 * gtk_tree_view_new_with_model:
5909 * @model: the model.
5911 * Creates a new #GtkTreeView widget with the model initialized to @model.
5913 * Return value: A newly created #GtkTreeView widget.
5916 gtk_tree_view_new_with_model (GtkTreeModel *model)
5918 GtkTreeView *tree_view;
5920 tree_view = GTK_TREE_VIEW (gtk_type_new (gtk_tree_view_get_type ()));
5921 gtk_tree_view_set_model (tree_view, model);
5923 return GTK_WIDGET (tree_view);
5930 * gtk_tree_view_get_model:
5931 * @tree_view: a #GtkTreeView
5933 * Returns the model the the #GtkTreeView is based on. Returns NULL if the
5936 * Return value: A #GtkTreeModel, or NULL if none is currently being used.
5939 gtk_tree_view_get_model (GtkTreeView *tree_view)
5941 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
5943 return tree_view->priv->model;
5947 * gtk_tree_view_set_model:
5948 * @tree_view: A #GtkTreeNode.
5949 * @model: The model.
5951 * Sets the model for a #GtkTreeView. If the @tree_view already has a model
5952 * set, it will remove it before setting the new model. If @model is NULL, then
5953 * it will unset the old model.
5956 gtk_tree_view_set_model (GtkTreeView *tree_view,
5957 GtkTreeModel *model)
5959 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
5961 if (model == tree_view->priv->model)
5965 g_object_ref (model);
5967 if (tree_view->priv->model != NULL)
5969 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_MODEL_SETUP))
5971 g_signal_handlers_disconnect_matched (G_OBJECT (tree_view->priv->model),
5972 G_SIGNAL_MATCH_DATA,
5975 g_signal_handlers_disconnect_matched (G_OBJECT (tree_view->priv->model),
5976 G_SIGNAL_MATCH_DATA,
5979 g_signal_handlers_disconnect_matched (G_OBJECT (tree_view->priv->model),
5980 G_SIGNAL_MATCH_DATA,
5983 g_signal_handlers_disconnect_matched (G_OBJECT (tree_view->priv->model),
5984 G_SIGNAL_MATCH_DATA,
5987 g_signal_handlers_disconnect_matched (G_OBJECT (tree_view->priv->model),
5988 G_SIGNAL_MATCH_DATA,
5991 if (tree_view->priv->tree)
5992 _gtk_rbtree_free (tree_view->priv->tree);
5995 if (tree_view->priv->drag_dest_row)
5996 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
5998 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_MODEL_SETUP);
5999 g_object_unref (tree_view->priv->model);
6002 tree_view->priv->model = model;
6006 tree_view->priv->tree = NULL;
6007 if (GTK_WIDGET_REALIZED (tree_view))
6008 _gtk_tree_view_update_size (tree_view);
6010 else if (GTK_WIDGET_REALIZED (tree_view))
6012 gtk_tree_view_setup_model (tree_view);
6013 _gtk_tree_view_update_size (tree_view);
6016 g_object_notify (G_OBJECT (tree_view), "model");
6020 * gtk_tree_view_get_selection:
6021 * @tree_view: A #GtkTreeView.
6023 * Gets the #GtkTreeSelection associated with @tree_view.
6025 * Return value: A #GtkTreeSelection object.
6028 gtk_tree_view_get_selection (GtkTreeView *tree_view)
6030 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
6032 if (tree_view->priv->selection == NULL)
6033 tree_view->priv->selection = _gtk_tree_selection_new_with_tree_view (tree_view);
6035 return tree_view->priv->selection;
6039 * gtk_tree_view_get_hadjustment:
6040 * @tree_view: A #GtkTreeView
6042 * Gets the #GtkAdjustment currently being used for the horizontal aspect.
6044 * Return value: A #GtkAdjustment object, or NULL if none is currently being
6048 gtk_tree_view_get_hadjustment (GtkTreeView *tree_view)
6050 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
6052 if (tree_view->priv->hadjustment == NULL)
6053 gtk_tree_view_set_hadjustment (tree_view, NULL);
6055 return tree_view->priv->hadjustment;
6059 * gtk_tree_view_set_hadjustment:
6060 * @tree_view: A #GtkTreeView
6061 * @adjustment: The #GtkAdjustment to set, or NULL
6063 * Sets the #GtkAdjustment for the current horizontal aspect.
6066 gtk_tree_view_set_hadjustment (GtkTreeView *tree_view,
6067 GtkAdjustment *adjustment)
6069 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6071 gtk_tree_view_set_adjustments (tree_view,
6073 tree_view->priv->vadjustment);
6075 g_object_notify (G_OBJECT (tree_view), "hadjustment");
6079 * gtk_tree_view_get_vadjustment:
6080 * @tree_view: A #GtkTreeView
6082 * Gets the #GtkAdjustment currently being used for the vertical aspect.
6084 * Return value: A #GtkAdjustment object, or NULL if none is currently being
6088 gtk_tree_view_get_vadjustment (GtkTreeView *tree_view)
6090 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
6092 if (tree_view->priv->vadjustment == NULL)
6093 gtk_tree_view_set_vadjustment (tree_view, NULL);
6095 return tree_view->priv->vadjustment;
6099 * gtk_tree_view_set_vadjustment:
6100 * @tree_view: A #GtkTreeView
6101 * @adjustment: The #GtkAdjustment to set, or NULL
6103 * Sets the #GtkAdjustment for the current vertical aspect.
6106 gtk_tree_view_set_vadjustment (GtkTreeView *tree_view,
6107 GtkAdjustment *adjustment)
6109 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6111 gtk_tree_view_set_adjustments (tree_view,
6112 tree_view->priv->hadjustment,
6115 g_object_notify (G_OBJECT (tree_view), "vadjustment");
6118 /* Column and header operations */
6121 * gtk_tree_view_get_headers_visible:
6122 * @tree_view: A #GtkTreeView.
6124 * Returns TRUE if the headers on the @tree_view are visible.
6126 * Return value: Whether the headers are visible or not.
6129 gtk_tree_view_get_headers_visible (GtkTreeView *tree_view)
6131 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
6133 return GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
6137 * gtk_tree_view_set_headers_visible:
6138 * @tree_view: A #GtkTreeView.
6139 * @headers_visible: TRUE if the headers are visible
6141 * Sets the the visibility state of the headers.
6144 gtk_tree_view_set_headers_visible (GtkTreeView *tree_view,
6145 gboolean headers_visible)
6149 GtkTreeViewColumn *column;
6151 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6153 headers_visible = !! headers_visible;
6155 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE) == headers_visible)
6158 if (headers_visible)
6159 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
6161 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
6163 if (GTK_WIDGET_REALIZED (tree_view))
6165 gdk_window_get_position (tree_view->priv->bin_window, &x, &y);
6166 if (headers_visible)
6168 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));
6170 if (GTK_WIDGET_MAPPED (tree_view))
6171 gtk_tree_view_map_buttons (tree_view);
6175 gdk_window_move_resize (tree_view->priv->bin_window, x, y, tree_view->priv->width, tree_view->priv->height);
6177 for (list = tree_view->priv->columns; list; list = list->next)
6179 column = list->data;
6180 gtk_widget_unmap (column->button);
6182 gdk_window_hide (tree_view->priv->header_window);
6186 tree_view->priv->vadjustment->page_size = GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
6187 tree_view->priv->vadjustment->page_increment = (GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view)) / 2;
6188 tree_view->priv->vadjustment->lower = 0;
6189 tree_view->priv->vadjustment->upper = tree_view->priv->height;
6190 gtk_signal_emit_by_name (GTK_OBJECT (tree_view->priv->vadjustment), "changed");
6192 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6194 g_object_notify (G_OBJECT (tree_view), "headers_visible");
6199 * gtk_tree_view_columns_autosize:
6200 * @tree_view: A #GtkTreeView.
6202 * Resizes all columns to their optimal width.
6205 gtk_tree_view_columns_autosize (GtkTreeView *tree_view)
6207 gboolean dirty = FALSE;
6209 GtkTreeViewColumn *column;
6211 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6213 for (list = tree_view->priv->columns; list; list = list->next)
6215 column = list->data;
6216 if (column->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
6218 column->dirty = TRUE;
6223 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6227 * gtk_tree_view_set_headers_clickable:
6228 * @tree_view: A #GtkTreeView.
6229 * @setting: TRUE if the columns are clickable.
6231 * Allow the column title buttons to be clicked.
6234 gtk_tree_view_set_headers_clickable (GtkTreeView *tree_view,
6239 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6240 g_return_if_fail (tree_view->priv->model != NULL);
6242 for (list = tree_view->priv->columns; list; list = list->next)
6243 gtk_tree_view_column_set_clickable (GTK_TREE_VIEW_COLUMN (list->data), setting);
6245 g_object_notify (G_OBJECT (tree_view), "headers_clickable");
6250 * gtk_tree_view_set_rules_hint
6251 * @tree_view: a #GtkTreeView
6252 * @setting: %TRUE if the tree requires reading across rows
6254 * This function tells GTK+ that the user interface for your
6255 * application requires users to read across tree rows and associate
6256 * cells with one another. By default, GTK+ will then render the tree
6257 * with alternating row colors. <emphasis>DO NOT</emphasis> use it
6258 * just because you prefer the appearance of the ruled tree; that's a
6259 * question for the theme. Some themes will draw tree rows in
6260 * alternating colors even when rules are turned off, and users who
6261 * prefer that appearance all the time can choose those themes. You
6262 * should call this function only as a <emphasis>semantic</emphasis>
6263 * hint to the theme engine that your tree makes alternating colors
6264 * useful from a functional standpoint (since it has lots of columns,
6269 gtk_tree_view_set_rules_hint (GtkTreeView *tree_view,
6272 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6274 setting = setting != FALSE;
6276 if (tree_view->priv->has_rules != setting)
6278 tree_view->priv->has_rules = setting;
6279 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
6282 g_object_notify (G_OBJECT (tree_view), "rules_hint");
6286 * gtk_tree_view_get_rules_hint
6287 * @tree_view: a #GtkTreeView
6289 * Gets the setting set by gtk_tree_view_set_rules_hint().
6291 * Return value: %TRUE if rules are useful for the user of this tree
6294 gtk_tree_view_get_rules_hint (GtkTreeView *tree_view)
6296 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
6298 return tree_view->priv->has_rules;
6301 /* Public Column functions
6305 * gtk_tree_view_append_column:
6306 * @tree_view: A #GtkTreeView.
6307 * @column: The #GtkTreeViewColumn to add.
6309 * Appends @column to the list of columns.
6311 * Return value: The number of columns in @tree_view after appending.
6314 gtk_tree_view_append_column (GtkTreeView *tree_view,
6315 GtkTreeViewColumn *column)
6317 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
6318 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
6319 g_return_val_if_fail (column->tree_view == NULL, -1);
6321 return gtk_tree_view_insert_column (tree_view, column, -1);
6326 * gtk_tree_view_remove_column:
6327 * @tree_view: A #GtkTreeView.
6328 * @column: The #GtkTreeViewColumn to remove.
6330 * Removes @column from @tree_view.
6332 * Return value: The number of columns in @tree_view after removing.
6335 gtk_tree_view_remove_column (GtkTreeView *tree_view,
6336 GtkTreeViewColumn *column)
6338 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
6339 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
6340 g_return_val_if_fail (column->tree_view == GTK_WIDGET (tree_view), -1);
6342 _gtk_tree_view_column_unset_tree_view (column);
6344 if (tree_view->priv->focus_column == column)
6345 tree_view->priv->focus_column = NULL;
6347 tree_view->priv->columns = g_list_remove (tree_view->priv->columns, column);
6349 tree_view->priv->n_columns--;
6351 if (GTK_WIDGET_REALIZED (tree_view))
6355 _gtk_tree_view_column_unrealize_button (column);
6356 for (list = tree_view->priv->columns; list; list = list->next)
6358 column = GTK_TREE_VIEW_COLUMN (list->data);
6359 if (column->visible)
6360 column->dirty = TRUE;
6363 if (tree_view->priv->n_columns == 0 &&
6364 gtk_tree_view_get_headers_visible (tree_view))
6365 gdk_window_hide (tree_view->priv->header_window);
6367 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6370 g_object_unref (G_OBJECT (column));
6371 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLUMNS_CHANGED], 0);
6373 return tree_view->priv->n_columns;
6377 * gtk_tree_view_insert_column:
6378 * @tree_view: A #GtkTreeView.
6379 * @column: The #GtkTreeViewColumn to be inserted.
6380 * @position: The position to insert @column in.
6382 * This inserts the @column into the @tree_view at @position. If @position is
6383 * -1, then the column is inserted at the end.
6385 * Return value: The number of columns in @tree_view after insertion.
6388 gtk_tree_view_insert_column (GtkTreeView *tree_view,
6389 GtkTreeViewColumn *column,
6392 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
6393 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
6394 g_return_val_if_fail (column->tree_view == NULL, -1);
6396 g_object_ref (G_OBJECT (column));
6398 if (tree_view->priv->n_columns == 0 &&
6399 GTK_WIDGET_REALIZED (tree_view) &&
6400 gtk_tree_view_get_headers_visible (tree_view))
6402 gdk_window_show (tree_view->priv->header_window);
6405 tree_view->priv->columns = g_list_insert (tree_view->priv->columns,
6407 tree_view->priv->n_columns++;
6409 _gtk_tree_view_column_set_tree_view (column, tree_view);
6411 if (GTK_WIDGET_REALIZED (tree_view))
6415 _gtk_tree_view_column_realize_button (column);
6417 for (list = tree_view->priv->columns; list; list = list->next)
6419 column = GTK_TREE_VIEW_COLUMN (list->data);
6420 if (column->visible)
6421 column->dirty = TRUE;
6423 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6426 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLUMNS_CHANGED], 0);
6428 return tree_view->priv->n_columns;
6432 * gtk_tree_view_insert_column_with_attributes:
6433 * @tree_view: A #GtkTreeView
6434 * @position: The position to insert the new column in.
6435 * @title: The title to set the header to.
6436 * @cell: The #GtkCellRenderer.
6437 * @Varargs: A NULL terminated list of attributes.
6439 * Creates a new #GtkTreeViewColumn and inserts it into the @tree_view at
6440 * @position. If @position is -1, then the newly created column is inserted at
6441 * the end. The column is initialized with the attributes given.
6443 * Return value: The number of columns in @tree_view after insertion.
6446 gtk_tree_view_insert_column_with_attributes (GtkTreeView *tree_view,
6449 GtkCellRenderer *cell,
6452 GtkTreeViewColumn *column;
6457 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
6459 column = gtk_tree_view_column_new ();
6461 gtk_tree_view_column_set_title (column, title);
6462 gtk_tree_view_column_set_cell_renderer (column, cell);
6464 va_start (args, cell);
6466 attribute = va_arg (args, gchar *);
6468 while (attribute != NULL)
6470 column_id = va_arg (args, gint);
6471 gtk_tree_view_column_add_attribute (column, attribute, column_id);
6472 attribute = va_arg (args, gchar *);
6477 gtk_tree_view_insert_column (tree_view, column, position);
6478 g_object_unref (column);
6480 return tree_view->priv->n_columns;
6484 * gtk_tree_view_insert_column_with_data_func:
6485 * @tree_view: a #GtkTreeView
6486 * @position: Position to insert, -1 for append
6487 * @title: column title
6488 * @cell: cell renderer for column
6489 * @func: function to set attributes of cell renderer
6490 * @data: data for @func
6491 * @dnotify: destroy notifier for @data
6493 * Convenience function that inserts a new column into the #GtkTreeView
6494 * with the given cell renderer and a #GtkCellDataFunc to set cell renderer
6495 * attributes (normally using data from the model). See also
6496 * gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_set_cell_renderer().
6498 * Return value: number of columns in the tree view post-insert
6501 gtk_tree_view_insert_column_with_data_func (GtkTreeView *tree_view,
6504 GtkCellRenderer *cell,
6505 GtkTreeCellDataFunc func,
6507 GDestroyNotify dnotify)
6509 GtkTreeViewColumn *column;
6511 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
6513 column = gtk_tree_view_column_new ();
6515 gtk_tree_view_column_set_title (column, title);
6516 gtk_tree_view_column_set_cell_renderer (column, cell);
6517 gtk_tree_view_column_set_cell_data_func (column, func, data, dnotify);
6519 gtk_tree_view_insert_column (tree_view, column, position);
6521 g_object_unref (column);
6523 return tree_view->priv->n_columns;
6527 * gtk_tree_view_get_column:
6528 * @tree_view: A #GtkTreeView.
6529 * @n: The position of the column, counting from 0.
6531 * Gets the #GtkTreeViewColumn at the given position in the #tree_view.
6533 * Return value: The #GtkTreeViewColumn, or NULL if the position is outside the
6537 gtk_tree_view_get_column (GtkTreeView *tree_view,
6540 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
6542 if (n < 0 || n >= tree_view->priv->n_columns)
6545 if (tree_view->priv->columns == NULL)
6548 return GTK_TREE_VIEW_COLUMN (g_list_nth (tree_view->priv->columns, n)->data);
6552 * gtk_tree_view_get_columns:
6553 * @tree_view: A #GtkTreeView
6555 * Returns a #GList of all the #GtkTreeViewColumn s currently in @tree_view.
6556 * The returned list must be freed with g_list_free ().
6558 * Return value: A list of #GtkTreeViewColumn s
6561 gtk_tree_view_get_columns (GtkTreeView *tree_view)
6563 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
6565 return g_list_copy (tree_view->priv->columns);
6569 * gtk_tree_view_move_column_after:
6570 * @tree_view: A #GtkTreeView
6571 * @column: The #GtkTreeViewColumn to be moved.
6572 * @base_column: The #GtkTreeViewColumn to be moved relative to.
6574 * Moves @column to be after to @base_column. If @base_column is NULL, then
6575 * @column is placed in the first position.
6578 gtk_tree_view_move_column_after (GtkTreeView *tree_view,
6579 GtkTreeViewColumn *column,
6580 GtkTreeViewColumn *base_column)
6582 GList *column_list_el, *base_el = NULL;
6584 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6586 column_list_el = g_list_find (tree_view->priv->columns, column);
6587 g_return_if_fail (column_list_el != NULL);
6591 base_el = g_list_find (tree_view->priv->columns, base_column);
6592 g_return_if_fail (base_el != NULL);
6595 if (column_list_el->prev == base_el)
6598 tree_view->priv->columns = g_list_remove_link (tree_view->priv->columns, column_list_el);
6599 if (base_el == NULL)
6601 column_list_el->prev = NULL;
6602 column_list_el->next = tree_view->priv->columns;
6603 if (column_list_el->next)
6604 column_list_el->next->prev = column_list_el;
6605 tree_view->priv->columns = column_list_el;
6609 column_list_el->prev = base_el;
6610 column_list_el->next = base_el->next;
6611 if (column_list_el->next)
6612 column_list_el->next->prev = column_list_el;
6613 base_el->next = column_list_el;
6616 if (GTK_WIDGET_REALIZED (tree_view))
6618 //gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6619 _gtk_tree_view_update_size (tree_view);
6620 gtk_tree_view_size_allocate_buttons (GTK_WIDGET (tree_view));
6623 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLUMNS_CHANGED], 0);
6627 * gtk_tree_view_set_expander_column:
6628 * @tree_view: A #GtkTreeView
6629 * @col: The column to draw the expander arrow at.
6631 * Sets the column offset to draw the expander arrow at.
6634 gtk_tree_view_set_expander_column (GtkTreeView *tree_view,
6637 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6639 if (tree_view->priv->expander_column != col)
6641 tree_view->priv->expander_column = col;
6643 g_object_notify (G_OBJECT (tree_view), "expander_column");
6648 * gtk_tree_view_get_expander_column:
6651 * Returns the offset of the column that is the current expander column. This
6652 * column has the expander arrow drawn next to it.
6654 * Return value: The offset of the expander column.
6657 gtk_tree_view_get_expander_column (GtkTreeView *tree_view)
6659 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
6661 return tree_view->priv->expander_column;
6666 * gtk_tree_view_set_column_drag_function:
6667 * @tree_view: A #GtkTreeView.
6668 * @func: A function to determine which columns are reorderable, or NULL.
6669 * @user_data: User data to be passed to @func, or NULL
6670 * @destroy: Destroy notifier for @user_data, or NULL
6672 * Sets a user function for determining where a column may be dropped when
6673 * dragged. This function is called on every column pair in turn at the
6674 * beginning of a column drag to determine where a drop can take place. The
6675 * arguments passed to @func are: the @tree_view, the #GtkTreeViewColumn being
6676 * dragged, the two #GtkTreeViewColumn s determining the drop spot, and
6677 * @user_data. If either of the #GtkTreeViewColumn arguments for the drop spot
6678 * are NULL, then they indicate an edge. If @func is set to be NULL, then
6679 * @tree_view reverts to the default behavior of allowing all columns to be
6680 * dropped everywhere.
6683 gtk_tree_view_set_column_drag_function (GtkTreeView *tree_view,
6684 GtkTreeViewColumnDropFunc func,
6686 GtkDestroyNotify destroy)
6688 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6690 if (tree_view->priv->column_drop_func_data_destroy)
6691 (* tree_view->priv->column_drop_func_data_destroy) (tree_view->priv->column_drop_func_data);
6693 tree_view->priv->column_drop_func = func;
6694 tree_view->priv->column_drop_func_data = user_data;
6695 tree_view->priv->column_drop_func_data_destroy = destroy;
6699 * gtk_tree_view_scroll_to_point:
6700 * @tree_view: a #GtkTreeView
6701 * @tree_x: X coordinate of new top-left pixel of visible area
6702 * @tree_y: Y coordinate of new top-left pixel of visible area
6704 * Scrolls the tree view such that the top-left corner of the visible
6705 * area is @tree_x, @tree_y, where @tree_x and @tree_y are specified
6706 * in tree window coordinates. The @tree_view must be realized before
6707 * this function is called. If it isn't, you probably want ot be
6708 * using gtk_tree_view_scroll_to_cell.
6711 gtk_tree_view_scroll_to_point (GtkTreeView *tree_view,
6715 GtkAdjustment *hadj;
6716 GtkAdjustment *vadj;
6718 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6719 g_return_if_fail (GTK_WIDGET_REALIZED (tree_view));
6721 hadj = tree_view->priv->hadjustment;
6722 vadj = tree_view->priv->vadjustment;
6724 gtk_adjustment_set_value (hadj, CLAMP (tree_x, hadj->lower, hadj->upper));
6725 gtk_adjustment_set_value (vadj, CLAMP (tree_y, vadj->lower, vadj->upper));
6729 * gtk_tree_view_scroll_to_cell
6730 * @tree_view: A #GtkTreeView.
6731 * @path: The path of the row to move to.
6732 * @column: The #GtkTreeViewColumn to move horizontally to.
6733 * @row_align: The vertical alignment of the row specified by @path.
6734 * @col_align: The horizontal alignment of the column specified by @column.
6736 * Moves the alignments of @tree_view to the position specified by
6737 * @column and @path. If @column is NULL, then no horizontal
6738 * scrolling occurs. Likewise, if @path is NULL no vertical scrolling
6739 * occurs. @row_align determines where the row is placed, and
6740 * @col_align determines where @column is placed. Both are expected
6741 * to be between 0.0 and 1.0. 0.0 means left/top alignment, 1.0 means
6742 * right/bottom alignment, 0.5 means center.
6745 gtk_tree_view_scroll_to_cell (GtkTreeView *tree_view,
6747 GtkTreeViewColumn *column,
6751 GdkRectangle cell_rect;
6752 GdkRectangle vis_rect;
6753 gint dest_x, dest_y;
6755 /* FIXME work on unmapped/unrealized trees? maybe implement when
6756 * we do incremental reflow for trees
6759 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6760 g_return_if_fail (row_align >= 0.0);
6761 g_return_if_fail (row_align <= 1.0);
6762 g_return_if_fail (col_align >= 0.0);
6763 g_return_if_fail (col_align <= 1.0);
6764 g_return_if_fail (path != NULL || column != NULL);
6766 row_align = CLAMP (row_align, 0.0, 1.0);
6767 col_align = CLAMP (col_align, 0.0, 1.0);
6769 if (! GTK_WIDGET_REALIZED (tree_view))
6772 tree_view->priv->scroll_to_path = gtk_tree_path_copy (path);
6774 tree_view->priv->scroll_to_column = column;
6775 tree_view->priv->scroll_to_row_align = row_align;
6776 tree_view->priv->scroll_to_col_align = col_align;
6781 gtk_tree_view_get_cell_area (tree_view, path, column, &cell_rect);
6782 gtk_tree_view_get_visible_rect (tree_view, &vis_rect);
6784 dest_x = vis_rect.x;
6785 dest_y = vis_rect.y;
6789 dest_x = cell_rect.x +
6790 cell_rect.width * row_align -
6791 vis_rect.width * row_align;
6796 dest_y = cell_rect.y +
6797 cell_rect.height * col_align -
6798 vis_rect.height * col_align;
6801 gtk_tree_view_scroll_to_point (tree_view, dest_x, dest_y);
6806 * gtk_tree_view_row_activated:
6807 * @tree_view: A #GtkTreeView
6808 * @path: The #GtkTreePath to be activated.
6809 * @column: The #GtkTreeViewColumn to be activated.
6811 * Activates the cell determined by @path and @column.
6814 gtk_tree_view_row_activated (GtkTreeView *tree_view,
6816 GtkTreeViewColumn *column)
6818 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6820 /* FIXME: Actually activate the path internally, not just emit the signal */
6821 /* g_warning ("FIXME: Actually activate the path internally, not just emit the signal\n"); */
6822 g_signal_emit (G_OBJECT(tree_view), tree_view_signals[ROW_ACTIVATED], 0, path, column);
6827 gtk_tree_view_expand_all_helper (GtkRBTree *tree,
6831 GtkTreeView *tree_view = data;
6834 _gtk_rbtree_traverse (node->children,
6835 node->children->root,
6837 gtk_tree_view_expand_all_helper,
6839 else if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT && node->children == NULL)
6845 node->children = _gtk_rbtree_new ();
6846 node->children->parent_tree = tree;
6847 node->children->parent_node = node;
6848 path = _gtk_tree_view_find_path (tree_view, tree, node);
6849 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
6850 gtk_tree_model_iter_children (tree_view->priv->model, &child, &iter);
6851 gtk_tree_view_build_tree (tree_view,
6854 gtk_tree_path_get_depth (path) + 1,
6856 GTK_WIDGET_REALIZED (tree_view));
6857 gtk_tree_path_free (path);
6862 * gtk_tree_view_expand_all:
6863 * @tree_view: A #GtkTreeView.
6865 * Recursively expands all nodes in the @tree_view.
6868 gtk_tree_view_expand_all (GtkTreeView *tree_view)
6870 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6871 g_return_if_fail (tree_view->priv->tree != NULL);
6873 _gtk_rbtree_traverse (tree_view->priv->tree,
6874 tree_view->priv->tree->root,
6876 gtk_tree_view_expand_all_helper,
6879 _gtk_tree_view_update_size (tree_view);
6883 gtk_tree_view_collapse_all_helper (GtkRBTree *tree,
6892 path = _gtk_tree_view_find_path (GTK_TREE_VIEW (data),
6894 node->children->root);
6895 gtk_tree_model_get_iter (GTK_TREE_VIEW (data)->priv->model,
6898 gtk_tree_view_discover_dirty (GTK_TREE_VIEW (data),
6901 gtk_tree_path_get_depth (path));
6903 /* Ensure we don't have a dangling pointer to a dead node */
6904 ensure_unprelighted (GTK_TREE_VIEW (data));
6906 _gtk_rbtree_remove (node->children);
6907 gtk_tree_path_free (path);
6912 * gtk_tree_view_collapse_all:
6913 * @tree_view: A #GtkTreeView.
6915 * Recursively collapses all visible, expanded nodes in @tree_view.
6918 gtk_tree_view_collapse_all (GtkTreeView *tree_view)
6920 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6921 g_return_if_fail (tree_view->priv->tree != NULL);
6923 _gtk_rbtree_traverse (tree_view->priv->tree,
6924 tree_view->priv->tree->root,
6926 gtk_tree_view_collapse_all_helper,
6929 if (GTK_WIDGET_MAPPED (tree_view))
6930 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
6933 /* FIXME the bool return values for expand_row and collapse_row are
6934 * not analagous; they should be TRUE if the row had children and
6935 * was not already in the requested state.
6939 * gtk_tree_view_expand_row:
6940 * @tree_view: a #GtkTreeView
6941 * @path: path to a row
6942 * @open_all: whether to recursively expand, or just expand immediate children
6944 * Opens the row so its children are visible
6946 * Return value: %TRUE if the row existed and had children
6949 gtk_tree_view_expand_row (GtkTreeView *tree_view,
6959 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
6960 g_return_val_if_fail (tree_view->priv->model != NULL, FALSE);
6961 g_return_val_if_fail (path != NULL, FALSE);
6963 if (_gtk_tree_view_find_node (tree_view,
6972 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
6973 if (! gtk_tree_model_iter_has_child (tree_view->priv->model, &iter))
6976 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[EXPAND_ROW], 0, &iter, path, &expand);
6981 node->children = _gtk_rbtree_new ();
6982 node->children->parent_tree = tree;
6983 node->children->parent_node = node;
6985 gtk_tree_model_iter_children (tree_view->priv->model, &child, &iter);
6986 gtk_tree_view_build_tree (tree_view,
6989 gtk_tree_path_get_depth (path) + 1,
6991 GTK_WIDGET_REALIZED (tree_view));
6993 if (GTK_WIDGET_MAPPED (tree_view))
6994 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
7000 * gtk_tree_view_collapse_row:
7001 * @tree_view: a #GtkTreeView
7002 * @path: path to a row in the @tree_view
7004 * Collapses a row (hides its child rows, if they exist.)
7006 * Return value: %TRUE if the row was collapsed.
7009 gtk_tree_view_collapse_row (GtkTreeView *tree_view,
7017 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
7018 g_return_val_if_fail (tree_view->priv->tree != NULL, FALSE);
7019 g_return_val_if_fail (path != NULL, FALSE);
7021 if (_gtk_tree_view_find_node (tree_view,
7027 if (node->children == NULL)
7030 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
7032 g_signal_emit (G_OBJECT (tree_view), tree_view_signals[COLLAPSE_ROW], 0, &iter, path, &collapse);
7037 TREE_VIEW_INTERNAL_ASSERT (gtk_tree_model_iter_children (tree_view->priv->model,
7041 gtk_tree_view_discover_dirty (tree_view,
7044 gtk_tree_path_get_depth (path));
7046 /* Ensure we don't have a dangling pointer to a dead node */
7047 ensure_unprelighted (tree_view);
7049 g_assert (tree_view->priv->prelight_node == NULL);
7051 _gtk_rbtree_remove (node->children);
7053 if (GTK_WIDGET_MAPPED (tree_view))
7054 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
7060 gtk_tree_view_map_expanded_rows_helper (GtkTreeView *tree_view,
7063 GtkTreeViewMappingFunc func,
7071 if (tree == NULL || tree->root == NULL)
7076 indices = gtk_tree_path_get_indices (path);
7077 depth = gtk_tree_path_get_depth (path);
7079 while (node && node->left != tree->nil)
7086 gtk_tree_path_append_index (path, 0);
7087 gtk_tree_view_map_expanded_rows_helper (tree_view, node->children, path, func, user_data);
7088 gtk_tree_path_up (path);
7089 (* func) (tree_view, path, user_data);
7092 indices[depth -1] = i;
7093 node = _gtk_rbtree_next (tree, node);
7098 * gtk_tree_view_map_expanded_rows:
7099 * @tree_view: A #GtkTreeView
7100 * @func: A function to be called
7101 * @data: User data to be passed to the function.
7103 * Calls @func on all expanded rows.
7106 gtk_tree_view_map_expanded_rows (GtkTreeView *tree_view,
7107 GtkTreeViewMappingFunc func,
7112 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7113 g_return_if_fail (func != NULL);
7115 path = gtk_tree_path_new_root ();
7117 gtk_tree_view_map_expanded_rows_helper (tree_view,
7118 tree_view->priv->tree,
7119 path, func, user_data);
7121 gtk_tree_path_free (path);
7124 static GtkTargetEntry row_targets[] = {
7125 { "GTK_TREE_MODEL_ROW", GTK_TARGET_SAME_WIDGET, 0 }
7129 * gtk_tree_view_set_reorderable:
7130 * @tree_view: A #GtkTreeView.
7131 * @reorderable: TRUE, if the tree can be reordered.
7133 * This function is a convenience function to allow you to reorder models that
7134 * support the #GtkDragSourceIface and the #GtkDragDestIface. Both
7135 * #GtkTreeStore and #GtkListStore support these. If @reorderable is TRUE, then
7136 * the user can reorder the model by dragging and dropping columns. The
7137 * developer will can listen to these changes by connecting to the model's
7140 * This function does not give you any degree of control over the order -- any
7141 * reorderering is allowed. If more control is needed, you should probably
7142 * handle drag and drop manually.
7145 gtk_tree_view_set_reorderable (GtkTreeView *tree_view,
7146 gboolean reorderable)
7148 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7150 if (tree_view->priv->reorderable == (reorderable?TRUE:FALSE))
7153 gtk_tree_view_set_rows_drag_source (tree_view,
7156 G_N_ELEMENTS (row_targets),
7159 gtk_tree_view_set_rows_drag_dest (tree_view,
7161 G_N_ELEMENTS (row_targets),
7165 g_object_notify (G_OBJECT (tree_view), "reorderable");
7170 * gtk_tree_view_get_path_at_pos:
7171 * @tree_view: A #GtkTreeView.
7172 * @window: The #GdkWindow to check against.
7173 * @x: The x position to be identified.
7174 * @y: The y position to be identified.
7175 * @path: A pointer to a #GtkTreePath pointer to be filled in, or %NULL
7176 * @column: A pointer to a #GtkTreeViewColumn pointer to be filled in, or %NULL
7177 * @cell_x: A pointer where the X coordinate relative to the cell can be placed, or %NULL
7178 * @cell_y: A pointer where the Y coordinate relative to the cell can be placed, or %NULL
7180 * Finds the path at the point (@x, @y) relative to @window. If @window is
7181 * NULL, then the point is found relative to the widget coordinates. This
7182 * function is expected to be called after an event, with event->window being
7183 * passed in as @window. It is primarily for things like popup menus. If @path
7184 * is non-NULL, then it will be filled with the #GtkTreePath at that point.
7185 * This path should be freed with #gtk_tree_path_free. If @column is non-NULL,
7186 * then it will be filled with the column at that point. @cell_x and @cell_y
7187 * return the coordinates relative to the cell background (i.e. the
7188 * background_area passed to gtk_cell_renderer_render()). This function only
7189 * works if @tree_view is realized.
7191 * Return value: TRUE if a row exists at that coordinate.
7194 gtk_tree_view_get_path_at_pos (GtkTreeView *tree_view,
7199 GtkTreeViewColumn **column,
7207 g_return_val_if_fail (tree_view != NULL, FALSE);
7208 g_return_val_if_fail (tree_view->priv->tree != NULL, FALSE);
7209 g_return_val_if_fail (tree_view->priv->bin_window != NULL, FALSE);
7212 g_return_val_if_fail (window == tree_view->priv->bin_window, FALSE);
7219 if (x > tree_view->priv->hadjustment->upper)
7225 if (column || cell_x)
7227 GtkTreeViewColumn *tmp_column;
7228 GtkTreeViewColumn *last_column = NULL;
7230 gint remaining_x = x;
7231 gboolean found = FALSE;
7233 for (list = tree_view->priv->columns; list; list = list->next)
7235 tmp_column = list->data;
7237 if (tmp_column->visible == FALSE)
7240 last_column = tmp_column;
7241 if (remaining_x <= tmp_column->width)
7246 *column = tmp_column;
7249 *cell_x = remaining_x;
7253 remaining_x -= tmp_column->width;
7259 *column = last_column;
7262 *cell_x = last_column->width + remaining_x;
7268 y_offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
7269 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, y),
7274 if (y < TREE_VIEW_HEADER_HEIGHT (tree_view))
7277 y_offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
7278 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, y + tree_view->priv->vadjustment->value),
7289 *path = _gtk_tree_view_find_path (tree_view, tree, node);
7296 * gtk_tree_view_get_cell_area:
7297 * @tree_view: a #GtkTreeView
7298 * @path: a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
7299 * @column: a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
7300 * @rect: rectangle to fill with cell rect
7302 * Fills the bounding rectangle in tree window coordinates for the cell at the
7303 * row specified by @path and the column specified by @column. If @path is
7304 * %NULL, the y and height fields of the rectangle will be filled with 0. If
7305 * @column is %NULL, the x and width fields will be filled with 0. The sum of
7306 * all cell rects does not cover the entire tree; there are extra pixels in
7307 * between rows, for example. The returned rectangle is equivalent to the
7308 * @cell_area passed to gtk_cell_renderer_render(). This function is only valid
7309 * if #tree_view is realized.
7312 gtk_tree_view_get_cell_area (GtkTreeView *tree_view,
7314 GtkTreeViewColumn *column,
7317 GtkRBTree *tree = NULL;
7318 GtkRBNode *node = NULL;
7319 gint vertical_separator;
7321 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7322 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
7323 g_return_if_fail (rect != NULL);
7325 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical_separator", &vertical_separator, NULL);
7334 /* Get vertical coords */
7336 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
7340 g_warning (G_STRLOC": no row corresponding to path");
7344 /* Remember that the rbtree stores node height including the vertical
7345 * separator, see comment at top of file.
7347 rect->y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
7349 rect->height = CELL_HEIGHT (node, vertical_separator);
7356 gtk_tree_view_get_cell_xrange (tree_view, tree, column, &rect->x, &x2);
7357 rect->width = x2 - rect->x;
7362 * gtk_tree_view_get_background_area:
7363 * @tree_view: a #GtkTreeView
7364 * @path: a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
7365 * @column: a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
7366 * @rect: rectangle to fill with cell background rect
7368 * Fills the bounding rectangle in tree window coordinates for the
7369 * cell at the row specified by @path and the column specified by
7370 * @column. If @path is %NULL, the y and height fields of the
7371 * rectangle will be filled with 0. If @column is %NULL, the x and
7372 * width fields will be filled with 0. The returned rectangle is
7373 * equivalent to the @background_area passed to
7374 * gtk_cell_renderer_render(). These background areas tile to cover
7375 * the entire tree window (except for the area used for header
7376 * buttons). Contrast with the cell_area, returned by
7377 * gtk_tree_view_get_cell_area(), which returns only the cell itself,
7378 * excluding surrounding borders and the tree expander area.
7382 gtk_tree_view_get_background_area (GtkTreeView *tree_view,
7384 GtkTreeViewColumn *column,
7387 GtkRBTree *tree = NULL;
7388 GtkRBNode *node = NULL;
7390 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7391 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
7392 g_return_if_fail (rect != NULL);
7401 /* Get vertical coords */
7403 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
7407 g_warning (G_STRLOC": no row corresponding to path");
7411 rect->y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
7413 rect->height = BACKGROUND_HEIGHT (node);
7420 gtk_tree_view_get_background_xrange (tree_view, tree, column, &rect->x, &x2);
7421 rect->width = x2 - rect->x;
7426 * gtk_tree_view_get_visible_rect:
7427 * @tree_view: a #GtkTreeView
7428 * @visible_rect: rectangle to fill
7430 * Fills @visible_rect with the currently-visible region of the
7431 * buffer, in tree coordinates. Convert to widget coordinates with
7432 * gtk_tree_view_tree_to_widget_coords(). Tree coordinates start at
7433 * 0,0 for row 0 of the tree, and cover the entire scrollable area of
7437 gtk_tree_view_get_visible_rect (GtkTreeView *tree_view,
7438 GdkRectangle *visible_rect)
7442 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7444 widget = GTK_WIDGET (tree_view);
7448 visible_rect->x = tree_view->priv->hadjustment->value;
7449 visible_rect->y = tree_view->priv->vadjustment->value;
7450 visible_rect->width = widget->allocation.width;
7451 visible_rect->height = widget->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
7456 * gtk_tree_view_widget_to_tree_coords:
7457 * @tree_view: a #GtkTreeView
7458 * @wx: widget X coordinate
7459 * @wy: widget Y coordinate
7460 * @tx: return location for tree X coordinate
7461 * @ty: return location for tree Y coordinate
7463 * Converts widget coordinates to coordinates for the
7464 * tree window (the full scrollable area of the tree).
7468 gtk_tree_view_widget_to_tree_coords (GtkTreeView *tree_view,
7474 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7478 *tx = wx + tree_view->priv->hadjustment->value;
7483 *ty = wy + tree_view->priv->vadjustment->value;
7488 * gtk_tree_view_tree_to_widget_coords:
7489 * @tree_view: a #GtkTreeView
7490 * @tx: tree X coordinate
7491 * @ty: tree Y coordinate
7492 * @wx: return location for widget X coordinate
7493 * @wy: return location for widget Y coordinate
7495 * Converts tree coordinates (coordinates in full scrollable area of the tree)
7496 * to widget coordinates.
7500 gtk_tree_view_tree_to_widget_coords (GtkTreeView *tree_view,
7506 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7510 *wx = tx - tree_view->priv->hadjustment->value;
7515 *wy = ty - tree_view->priv->vadjustment->value;
7521 gtk_tree_view_set_rows_drag_source (GtkTreeView *tree_view,
7522 GdkModifierType start_button_mask,
7523 const GtkTargetEntry *targets,
7525 GdkDragAction actions,
7526 GtkTreeViewDraggableFunc row_draggable_func,
7529 TreeViewDragInfo *di;
7531 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7533 di = ensure_info (tree_view);
7534 clear_source_info (di);
7536 di->start_button_mask = start_button_mask;
7537 di->source_target_list = gtk_target_list_new (targets, n_targets);
7538 di->source_actions = actions;
7540 if (row_draggable_func)
7542 di->row_draggable_closure = g_cclosure_new ((GCallback) row_draggable_func,
7544 g_closure_ref (di->row_draggable_closure);
7545 g_closure_sink (di->row_draggable_closure);
7548 di->source_set = TRUE;
7552 gtk_tree_view_set_rows_drag_dest (GtkTreeView *tree_view,
7553 const GtkTargetEntry *targets,
7555 GdkDragAction actions,
7556 GtkTreeViewDroppableFunc location_droppable_func,
7559 TreeViewDragInfo *di;
7561 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7563 gtk_drag_dest_set (GTK_WIDGET (tree_view),
7569 di = ensure_info (tree_view);
7570 clear_dest_info (di);
7573 di->dest_target_list = gtk_target_list_new (targets, n_targets);
7575 if (location_droppable_func)
7577 di->location_droppable_closure = g_cclosure_new ((GCallback) location_droppable_func,
7579 g_closure_ref (di->location_droppable_closure);
7580 g_closure_sink (di->location_droppable_closure);
7583 di->dest_set = TRUE;
7587 gtk_tree_view_unset_rows_drag_source (GtkTreeView *tree_view)
7589 TreeViewDragInfo *di;
7591 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7593 di = get_info (tree_view);
7599 clear_source_info (di);
7600 di->source_set = FALSE;
7603 if (!di->dest_set && !di->source_set)
7604 remove_info (tree_view);
7609 gtk_tree_view_unset_rows_drag_dest (GtkTreeView *tree_view)
7611 TreeViewDragInfo *di;
7613 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7615 di = get_info (tree_view);
7621 gtk_drag_dest_unset (GTK_WIDGET (tree_view));
7622 clear_dest_info (di);
7623 di->dest_set = FALSE;
7626 if (!di->dest_set && !di->source_set)
7627 remove_info (tree_view);
7632 gtk_tree_view_set_drag_dest_row (GtkTreeView *tree_view,
7634 GtkTreeViewDropPosition pos)
7636 GtkTreePath *current_dest;
7637 /* Note; this function is exported to allow a custom DND
7638 * implementation, so it can't touch TreeViewDragInfo
7641 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7643 current_dest = NULL;
7645 if (tree_view->priv->drag_dest_row)
7646 current_dest = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
7650 gtk_tree_view_queue_draw_path (tree_view, current_dest, NULL);
7651 gtk_tree_path_free (current_dest);
7654 if (tree_view->priv->drag_dest_row)
7655 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
7657 tree_view->priv->drag_dest_pos = pos;
7661 tree_view->priv->drag_dest_row =
7662 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
7663 gtk_tree_view_queue_draw_path (tree_view, path, NULL);
7666 tree_view->priv->drag_dest_row = NULL;
7670 gtk_tree_view_get_drag_dest_row (GtkTreeView *tree_view,
7672 GtkTreeViewDropPosition *pos)
7674 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
7678 if (tree_view->priv->drag_dest_row)
7679 *path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
7685 *pos = tree_view->priv->drag_dest_pos;
7689 gtk_tree_view_get_dest_row_at_pos (GtkTreeView *tree_view,
7693 GtkTreeViewDropPosition *pos)
7696 gdouble offset_into_row;
7700 GtkTreeViewColumn *column = NULL;
7701 GtkTreePath *tmp_path = NULL;
7703 /* Note; this function is exported to allow a custom DND
7704 * implementation, so it can't touch TreeViewDragInfo
7707 g_return_val_if_fail (tree_view != NULL, FALSE);
7708 g_return_val_if_fail (drag_x >= 0, FALSE);
7709 g_return_val_if_fail (drag_y >= 0, FALSE);
7710 g_return_val_if_fail (tree_view->priv->bin_window != NULL, FALSE);
7716 if (tree_view->priv->tree == NULL)
7719 /* remember that drag_x and drag_y are in widget coords, convert to tree window */
7721 gtk_tree_view_widget_to_tree_coords (tree_view, drag_x, drag_y,
7724 /* If in the top quarter of a row, we drop before that row; if
7725 * in the bottom quarter, drop after that row; if in the middle,
7726 * and the row has children, drop into the row.
7729 if (!gtk_tree_view_get_path_at_pos (tree_view,
7730 tree_view->priv->bin_window,
7738 gtk_tree_view_get_background_area (tree_view, tmp_path, column,
7741 offset_into_row = cell_y;
7746 gtk_tree_path_free (tmp_path);
7750 quarter = cell.height / 4.0;
7754 if (offset_into_row < quarter)
7756 *pos = GTK_TREE_VIEW_DROP_BEFORE;
7758 else if (offset_into_row < quarter * 2)
7760 *pos = GTK_TREE_VIEW_DROP_INTO_OR_BEFORE;
7762 else if (offset_into_row < quarter * 3)
7764 *pos = GTK_TREE_VIEW_DROP_INTO_OR_AFTER;
7768 *pos = GTK_TREE_VIEW_DROP_AFTER;
7777 /* KEEP IN SYNC WITH GTK_TREE_VIEW_BIN_EXPOSE */
7779 * gtk_tree_view_create_row_drag_icon:
7780 * @tree_view: a #GtkTreeView
7781 * @path: a #GtkTreePath in @tree_view
7783 * Creates a GdkPixmap representation of the row at @path. This image is used
7786 * Return value: a newly allocatdd pixmap of the drag icon.
7789 gtk_tree_view_create_row_drag_icon (GtkTreeView *tree_view,
7795 GtkCellRenderer *cell;
7799 GdkRectangle background_area;
7802 /* start drawing inside the black outline */
7804 GdkDrawable *drawable;
7805 gint bin_window_width;
7807 widget = GTK_WIDGET (tree_view);
7809 depth = gtk_tree_path_get_depth (path);
7811 _gtk_tree_view_find_node (tree_view,
7819 if (!gtk_tree_model_get_iter (tree_view->priv->model,
7826 background_area.y = y;
7827 background_area.height = BACKGROUND_HEIGHT (node);
7829 gdk_drawable_get_size (tree_view->priv->bin_window,
7830 &bin_window_width, NULL);
7832 drawable = gdk_pixmap_new (tree_view->priv->bin_window,
7833 bin_window_width + 2,
7834 background_area.height + 2,
7837 gdk_draw_rectangle (drawable,
7838 widget->style->base_gc[GTK_WIDGET_STATE (widget)],
7841 bin_window_width + 2,
7842 background_area.height + 2);
7844 gdk_draw_rectangle (drawable,
7845 widget->style->black_gc,
7848 bin_window_width + 1,
7849 background_area.height + 1);
7851 for (i = 0, list = tree_view->priv->columns; i < tree_view->priv->n_columns; i++, list = list->next)
7853 GtkTreeViewColumn *column = list->data;
7854 GdkRectangle cell_area;
7856 gint vertical_separator;
7858 if (!column->visible)
7861 cell = column->cell;
7862 gtk_tree_view_column_cell_set_cell_data (column,
7863 tree_view->priv->model,
7866 background_area.x = cell_offset;
7867 background_area.width = column->displayed_width;
7869 cell_area = background_area;
7871 gtk_widget_style_get (widget, "vertical_separator", &vertical_separator, NULL);
7872 cell_area.y += vertical_separator / 2;
7873 cell_area.height -= vertical_separator;
7875 if (i == tree_view->priv->expander_column &&
7876 TREE_VIEW_DRAW_EXPANDERS(tree_view))
7878 cell_area.x += depth * tree_view->priv->tab_offset;
7879 cell_area.width -= depth * tree_view->priv->tab_offset;
7882 g_object_get (G_OBJECT (cell), "visible", &visible, NULL);
7884 gtk_cell_renderer_render (cell,
7892 cell_offset += column->displayed_width;