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.
23 #include <gdk/gdkkeysyms.h>
25 #include "gtktreeview.h"
26 #include "gtkrbtree.h"
27 #include "gtktreednd.h"
28 #include "gtktreeprivate.h"
29 #include "gtkcellrenderer.h"
30 #include "gtkextendedlayout.h"
32 #include "gtkmarshalers.h"
33 #include "gtkbuildable.h"
34 #include "gtkbutton.h"
35 #include "gtkalignment.h"
41 #include "gtkbindings.h"
42 #include "gtkcontainer.h"
45 #include "gtktreemodelsort.h"
46 #include "gtktooltip.h"
47 #include "gtkprivate.h"
50 #define GTK_TREE_VIEW_PRIORITY_VALIDATE (GDK_PRIORITY_REDRAW + 5)
51 #define GTK_TREE_VIEW_PRIORITY_SCROLL_SYNC (GTK_TREE_VIEW_PRIORITY_VALIDATE + 2)
52 #define GTK_TREE_VIEW_TIME_MS_PER_IDLE 30
53 #define SCROLL_EDGE_SIZE 15
54 #define EXPANDER_EXTRA_PADDING 4
55 #define GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT 5000
56 #define AUTO_EXPAND_TIMEOUT 500
58 /* The "background" areas of all rows/cells add up to cover the entire tree.
59 * The background includes all inter-row and inter-cell spacing.
60 * The "cell" areas are the cell_area passed in to gtk_cell_renderer_render(),
61 * i.e. just the cells, no spacing.
64 #define BACKGROUND_HEIGHT(node) (GTK_RBNODE_GET_HEIGHT (node))
65 #define CELL_HEIGHT(node, separator) ((BACKGROUND_HEIGHT (node)) - (separator))
67 /* Translate from bin_window coordinates to rbtree (tree coordinates) and
70 #define TREE_WINDOW_Y_TO_RBTREE_Y(tree_view,y) ((y) + tree_view->priv->dy)
71 #define RBTREE_Y_TO_TREE_WINDOW_Y(tree_view,y) ((y) - tree_view->priv->dy)
73 /* This is in bin_window coordinates */
74 #define BACKGROUND_FIRST_PIXEL(tree_view,tree,node) (RBTREE_Y_TO_TREE_WINDOW_Y (tree_view, _gtk_rbtree_node_find_offset ((tree), (node))))
75 #define CELL_FIRST_PIXEL(tree_view,tree,node,separator) (BACKGROUND_FIRST_PIXEL (tree_view,tree,node) + separator/2)
77 #define ROW_HEIGHT(tree_view,height) \
78 ((height > 0) ? (height) : (tree_view)->priv->expander_size)
81 typedef struct _GtkTreeViewChild GtkTreeViewChild;
82 struct _GtkTreeViewChild
92 typedef struct _TreeViewDragInfo TreeViewDragInfo;
93 struct _TreeViewDragInfo
95 GdkModifierType start_button_mask;
96 GtkTargetList *_unused_source_target_list;
97 GdkDragAction source_actions;
99 GtkTargetList *_unused_dest_target_list;
101 guint source_set : 1;
121 EXPAND_COLLAPSE_CURSOR_ROW,
122 SELECT_CURSOR_PARENT,
123 START_INTERACTIVE_SEARCH,
133 PROP_HEADERS_VISIBLE,
134 PROP_HEADERS_CLICKABLE,
135 PROP_EXPANDER_COLUMN,
140 PROP_FIXED_HEIGHT_MODE,
141 PROP_HOVER_SELECTION,
144 PROP_LEVEL_INDENTATION,
146 PROP_ENABLE_GRID_LINES,
147 PROP_ENABLE_TREE_LINES,
152 static void gtk_tree_view_finalize (GObject *object);
153 static void gtk_tree_view_set_property (GObject *object,
157 static void gtk_tree_view_get_property (GObject *object,
162 /* gtkobject signals */
163 static void gtk_tree_view_destroy (GtkObject *object);
165 /* gtkwidget signals */
166 static void gtk_tree_view_realize (GtkWidget *widget);
167 static void gtk_tree_view_unrealize (GtkWidget *widget);
168 static void gtk_tree_view_map (GtkWidget *widget);
169 static void gtk_tree_view_size_request (GtkWidget *widget,
170 GtkRequisition *requisition);
171 static void gtk_tree_view_size_allocate (GtkWidget *widget,
172 GtkAllocation *allocation);
173 static gboolean gtk_tree_view_expose (GtkWidget *widget,
174 GdkEventExpose *event);
175 static gboolean gtk_tree_view_key_press (GtkWidget *widget,
177 static gboolean gtk_tree_view_key_release (GtkWidget *widget,
179 static gboolean gtk_tree_view_motion (GtkWidget *widget,
180 GdkEventMotion *event);
181 static gboolean gtk_tree_view_enter_notify (GtkWidget *widget,
182 GdkEventCrossing *event);
183 static gboolean gtk_tree_view_leave_notify (GtkWidget *widget,
184 GdkEventCrossing *event);
185 static gboolean gtk_tree_view_button_press (GtkWidget *widget,
186 GdkEventButton *event);
187 static gboolean gtk_tree_view_button_release (GtkWidget *widget,
188 GdkEventButton *event);
189 static gboolean gtk_tree_view_grab_broken (GtkWidget *widget,
190 GdkEventGrabBroken *event);
192 static gboolean gtk_tree_view_configure (GtkWidget *widget,
193 GdkEventConfigure *event);
196 static void gtk_tree_view_set_focus_child (GtkContainer *container,
198 static gint gtk_tree_view_focus_out (GtkWidget *widget,
199 GdkEventFocus *event);
200 static gint gtk_tree_view_focus (GtkWidget *widget,
201 GtkDirectionType direction);
202 static void gtk_tree_view_grab_focus (GtkWidget *widget);
203 static void gtk_tree_view_style_set (GtkWidget *widget,
204 GtkStyle *previous_style);
205 static void gtk_tree_view_grab_notify (GtkWidget *widget,
206 gboolean was_grabbed);
207 static void gtk_tree_view_state_changed (GtkWidget *widget,
208 GtkStateType previous_state);
210 /* container signals */
211 static void gtk_tree_view_remove (GtkContainer *container,
213 static void gtk_tree_view_forall (GtkContainer *container,
214 gboolean include_internals,
215 GtkCallback callback,
216 gpointer callback_data);
218 /* Source side drag signals */
219 static void gtk_tree_view_drag_begin (GtkWidget *widget,
220 GdkDragContext *context);
221 static void gtk_tree_view_drag_end (GtkWidget *widget,
222 GdkDragContext *context);
223 static void gtk_tree_view_drag_data_get (GtkWidget *widget,
224 GdkDragContext *context,
225 GtkSelectionData *selection_data,
228 static void gtk_tree_view_drag_data_delete (GtkWidget *widget,
229 GdkDragContext *context);
231 /* Target side drag signals */
232 static void gtk_tree_view_drag_leave (GtkWidget *widget,
233 GdkDragContext *context,
235 static gboolean gtk_tree_view_drag_motion (GtkWidget *widget,
236 GdkDragContext *context,
240 static gboolean gtk_tree_view_drag_drop (GtkWidget *widget,
241 GdkDragContext *context,
245 static void gtk_tree_view_drag_data_received (GtkWidget *widget,
246 GdkDragContext *context,
249 GtkSelectionData *selection_data,
253 /* tree_model signals */
254 static void gtk_tree_view_set_adjustments (GtkTreeView *tree_view,
256 GtkAdjustment *vadj);
257 static gboolean gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
258 GtkMovementStep step,
260 static gboolean gtk_tree_view_real_select_all (GtkTreeView *tree_view);
261 static gboolean gtk_tree_view_real_unselect_all (GtkTreeView *tree_view);
262 static gboolean gtk_tree_view_real_select_cursor_row (GtkTreeView *tree_view,
263 gboolean start_editing);
264 static gboolean gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view);
265 static gboolean gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
269 static gboolean gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view);
270 static void gtk_tree_view_row_changed (GtkTreeModel *model,
274 static void gtk_tree_view_row_inserted (GtkTreeModel *model,
278 static void gtk_tree_view_row_has_child_toggled (GtkTreeModel *model,
282 static void gtk_tree_view_row_deleted (GtkTreeModel *model,
285 static void gtk_tree_view_rows_reordered (GtkTreeModel *model,
291 /* Incremental reflow */
292 static gboolean validate_row (GtkTreeView *tree_view,
297 static void validate_visible_area (GtkTreeView *tree_view);
298 static gboolean validate_rows_handler (GtkTreeView *tree_view);
299 static gboolean do_validate_rows (GtkTreeView *tree_view,
300 gboolean size_request);
301 static gboolean validate_rows (GtkTreeView *tree_view);
302 static gboolean presize_handler_callback (gpointer data);
303 static void install_presize_handler (GtkTreeView *tree_view);
304 static void install_scroll_sync_handler (GtkTreeView *tree_view);
305 static void gtk_tree_view_set_top_row (GtkTreeView *tree_view,
308 static void gtk_tree_view_dy_to_top_row (GtkTreeView *tree_view);
309 static void gtk_tree_view_top_row_to_dy (GtkTreeView *tree_view);
310 static void invalidate_empty_focus (GtkTreeView *tree_view);
312 /* Internal functions */
313 static gboolean gtk_tree_view_is_expander_column (GtkTreeView *tree_view,
314 GtkTreeViewColumn *column);
315 static void gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
318 gboolean add_shifted_binding,
319 GtkMovementStep step,
321 static gint gtk_tree_view_unref_and_check_selection_tree (GtkTreeView *tree_view,
323 static void gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
325 const GdkRectangle *clip_rect);
326 static void gtk_tree_view_queue_draw_arrow (GtkTreeView *tree_view,
329 const GdkRectangle *clip_rect);
330 static void gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
335 static void gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
339 static gint gtk_tree_view_new_column_width (GtkTreeView *tree_view,
342 static void gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
343 GtkTreeView *tree_view);
344 static void gtk_tree_view_build_tree (GtkTreeView *tree_view,
349 static void gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
352 static void gtk_tree_view_clamp_column_visible (GtkTreeView *tree_view,
353 GtkTreeViewColumn *column,
354 gboolean focus_to_cell);
355 static gboolean gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
356 GdkEventMotion *event);
357 static void gtk_tree_view_focus_to_cursor (GtkTreeView *tree_view);
358 static void gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
360 static void gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
362 static void gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
364 static void gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
366 static gboolean gtk_tree_view_real_collapse_row (GtkTreeView *tree_view,
371 static gboolean gtk_tree_view_real_expand_row (GtkTreeView *tree_view,
377 static void gtk_tree_view_real_set_cursor (GtkTreeView *tree_view,
379 gboolean clear_and_select,
380 gboolean clamp_node);
381 static gboolean gtk_tree_view_has_special_cell (GtkTreeView *tree_view);
382 static void column_sizing_notify (GObject *object,
385 static gboolean expand_collapse_timeout (gpointer data);
386 static void add_expand_collapse_timeout (GtkTreeView *tree_view,
390 static void remove_expand_collapse_timeout (GtkTreeView *tree_view);
391 static void cancel_arrow_animation (GtkTreeView *tree_view);
392 static gboolean do_expand_collapse (GtkTreeView *tree_view);
393 static void gtk_tree_view_stop_rubber_band (GtkTreeView *tree_view);
395 /* interactive search */
396 static void gtk_tree_view_ensure_interactive_directory (GtkTreeView *tree_view);
397 static void gtk_tree_view_search_dialog_hide (GtkWidget *search_dialog,
398 GtkTreeView *tree_view);
399 static void gtk_tree_view_search_position_func (GtkTreeView *tree_view,
400 GtkWidget *search_dialog,
402 static void gtk_tree_view_search_disable_popdown (GtkEntry *entry,
405 static void gtk_tree_view_search_preedit_changed (GtkIMContext *im_context,
406 GtkTreeView *tree_view);
407 static void gtk_tree_view_search_activate (GtkEntry *entry,
408 GtkTreeView *tree_view);
409 static gboolean gtk_tree_view_real_search_enable_popdown(gpointer data);
410 static void gtk_tree_view_search_enable_popdown (GtkWidget *widget,
412 static gboolean gtk_tree_view_search_delete_event (GtkWidget *widget,
414 GtkTreeView *tree_view);
415 static gboolean gtk_tree_view_search_button_press_event (GtkWidget *widget,
416 GdkEventButton *event,
417 GtkTreeView *tree_view);
418 static gboolean gtk_tree_view_search_scroll_event (GtkWidget *entry,
419 GdkEventScroll *event,
420 GtkTreeView *tree_view);
421 static gboolean gtk_tree_view_search_key_press_event (GtkWidget *entry,
423 GtkTreeView *tree_view);
424 static gboolean gtk_tree_view_search_move (GtkWidget *window,
425 GtkTreeView *tree_view,
427 static gboolean gtk_tree_view_search_equal_func (GtkTreeModel *model,
431 gpointer search_data);
432 static gboolean gtk_tree_view_search_iter (GtkTreeModel *model,
433 GtkTreeSelection *selection,
438 static void gtk_tree_view_search_init (GtkWidget *entry,
439 GtkTreeView *tree_view);
440 static void gtk_tree_view_put (GtkTreeView *tree_view,
441 GtkWidget *child_widget,
446 static gboolean gtk_tree_view_start_editing (GtkTreeView *tree_view,
447 GtkTreePath *cursor_path);
448 static void gtk_tree_view_real_start_editing (GtkTreeView *tree_view,
449 GtkTreeViewColumn *column,
451 GtkCellEditable *cell_editable,
452 GdkRectangle *cell_area,
455 static void gtk_tree_view_stop_editing (GtkTreeView *tree_view,
456 gboolean cancel_editing);
457 static gboolean gtk_tree_view_real_start_interactive_search (GtkTreeView *tree_view,
458 gboolean keybinding);
459 static gboolean gtk_tree_view_start_interactive_search (GtkTreeView *tree_view);
460 static GtkTreeViewColumn *gtk_tree_view_get_drop_column (GtkTreeView *tree_view,
461 GtkTreeViewColumn *column,
465 static void gtk_tree_view_buildable_add_child (GtkBuildable *tree_view,
469 static void gtk_tree_view_buildable_init (GtkBuildableIface *iface);
470 static void gtk_tree_view_extended_layout_init (GtkExtendedLayoutIface *iface);
472 static gboolean scroll_row_timeout (gpointer data);
473 static void add_scroll_timeout (GtkTreeView *tree_view);
474 static void remove_scroll_timeout (GtkTreeView *tree_view);
476 static guint tree_view_signals [LAST_SIGNAL] = { 0 };
483 G_DEFINE_TYPE_WITH_CODE (GtkTreeView, gtk_tree_view, GTK_TYPE_CONTAINER,
484 G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
485 gtk_tree_view_buildable_init)
486 G_IMPLEMENT_INTERFACE (GTK_TYPE_EXTENDED_LAYOUT,
487 gtk_tree_view_extended_layout_init))
491 gtk_tree_view_class_init (GtkTreeViewClass *class)
493 GObjectClass *o_class;
494 GtkObjectClass *object_class;
495 GtkWidgetClass *widget_class;
496 GtkContainerClass *container_class;
497 GtkBindingSet *binding_set;
499 binding_set = gtk_binding_set_by_class (class);
501 o_class = (GObjectClass *) class;
502 object_class = (GtkObjectClass *) class;
503 widget_class = (GtkWidgetClass *) class;
504 container_class = (GtkContainerClass *) class;
506 /* GObject signals */
507 o_class->set_property = gtk_tree_view_set_property;
508 o_class->get_property = gtk_tree_view_get_property;
509 o_class->finalize = gtk_tree_view_finalize;
511 /* GtkObject signals */
512 object_class->destroy = gtk_tree_view_destroy;
514 /* GtkWidget signals */
515 widget_class->map = gtk_tree_view_map;
516 widget_class->realize = gtk_tree_view_realize;
517 widget_class->unrealize = gtk_tree_view_unrealize;
518 widget_class->size_request = gtk_tree_view_size_request;
519 widget_class->size_allocate = gtk_tree_view_size_allocate;
520 widget_class->button_press_event = gtk_tree_view_button_press;
521 widget_class->button_release_event = gtk_tree_view_button_release;
522 widget_class->grab_broken_event = gtk_tree_view_grab_broken;
523 /*widget_class->configure_event = gtk_tree_view_configure;*/
524 widget_class->motion_notify_event = gtk_tree_view_motion;
525 widget_class->expose_event = gtk_tree_view_expose;
526 widget_class->key_press_event = gtk_tree_view_key_press;
527 widget_class->key_release_event = gtk_tree_view_key_release;
528 widget_class->enter_notify_event = gtk_tree_view_enter_notify;
529 widget_class->leave_notify_event = gtk_tree_view_leave_notify;
530 widget_class->focus_out_event = gtk_tree_view_focus_out;
531 widget_class->drag_begin = gtk_tree_view_drag_begin;
532 widget_class->drag_end = gtk_tree_view_drag_end;
533 widget_class->drag_data_get = gtk_tree_view_drag_data_get;
534 widget_class->drag_data_delete = gtk_tree_view_drag_data_delete;
535 widget_class->drag_leave = gtk_tree_view_drag_leave;
536 widget_class->drag_motion = gtk_tree_view_drag_motion;
537 widget_class->drag_drop = gtk_tree_view_drag_drop;
538 widget_class->drag_data_received = gtk_tree_view_drag_data_received;
539 widget_class->focus = gtk_tree_view_focus;
540 widget_class->grab_focus = gtk_tree_view_grab_focus;
541 widget_class->style_set = gtk_tree_view_style_set;
542 widget_class->grab_notify = gtk_tree_view_grab_notify;
543 widget_class->state_changed = gtk_tree_view_state_changed;
545 /* GtkContainer signals */
546 container_class->remove = gtk_tree_view_remove;
547 container_class->forall = gtk_tree_view_forall;
548 container_class->set_focus_child = gtk_tree_view_set_focus_child;
550 class->set_scroll_adjustments = gtk_tree_view_set_adjustments;
551 class->move_cursor = gtk_tree_view_real_move_cursor;
552 class->select_all = gtk_tree_view_real_select_all;
553 class->unselect_all = gtk_tree_view_real_unselect_all;
554 class->select_cursor_row = gtk_tree_view_real_select_cursor_row;
555 class->toggle_cursor_row = gtk_tree_view_real_toggle_cursor_row;
556 class->expand_collapse_cursor_row = gtk_tree_view_real_expand_collapse_cursor_row;
557 class->select_cursor_parent = gtk_tree_view_real_select_cursor_parent;
558 class->start_interactive_search = gtk_tree_view_start_interactive_search;
562 g_object_class_install_property (o_class,
564 g_param_spec_object ("model",
565 P_("TreeView Model"),
566 P_("The model for the tree view"),
568 GTK_PARAM_READWRITE));
570 g_object_class_install_property (o_class,
572 g_param_spec_object ("hadjustment",
573 P_("Horizontal Adjustment"),
574 P_("Horizontal Adjustment for the widget"),
576 GTK_PARAM_READWRITE));
578 g_object_class_install_property (o_class,
580 g_param_spec_object ("vadjustment",
581 P_("Vertical Adjustment"),
582 P_("Vertical Adjustment for the widget"),
584 GTK_PARAM_READWRITE));
586 g_object_class_install_property (o_class,
587 PROP_HEADERS_VISIBLE,
588 g_param_spec_boolean ("headers-visible",
589 P_("Headers Visible"),
590 P_("Show the column header buttons"),
592 GTK_PARAM_READWRITE));
594 g_object_class_install_property (o_class,
595 PROP_HEADERS_CLICKABLE,
596 g_param_spec_boolean ("headers-clickable",
597 P_("Headers Clickable"),
598 P_("Column headers respond to click events"),
600 GTK_PARAM_READWRITE));
602 g_object_class_install_property (o_class,
603 PROP_EXPANDER_COLUMN,
604 g_param_spec_object ("expander-column",
605 P_("Expander Column"),
606 P_("Set the column for the expander column"),
607 GTK_TYPE_TREE_VIEW_COLUMN,
608 GTK_PARAM_READWRITE));
610 g_object_class_install_property (o_class,
612 g_param_spec_boolean ("reorderable",
614 P_("View is reorderable"),
616 GTK_PARAM_READWRITE));
618 g_object_class_install_property (o_class,
620 g_param_spec_boolean ("rules-hint",
622 P_("Set a hint to the theme engine to draw rows in alternating colors"),
624 GTK_PARAM_READWRITE));
626 g_object_class_install_property (o_class,
628 g_param_spec_boolean ("enable-search",
630 P_("View allows user to search through columns interactively"),
632 GTK_PARAM_READWRITE));
634 g_object_class_install_property (o_class,
636 g_param_spec_int ("search-column",
638 P_("Model column to search through during interactive search"),
642 GTK_PARAM_READWRITE));
645 * GtkTreeView:fixed-height-mode:
647 * Setting the ::fixed-height-mode property to %TRUE speeds up
648 * #GtkTreeView by assuming that all rows have the same height.
649 * Only enable this option if all rows are the same height.
650 * Please see gtk_tree_view_set_fixed_height_mode() for more
651 * information on this option.
655 g_object_class_install_property (o_class,
656 PROP_FIXED_HEIGHT_MODE,
657 g_param_spec_boolean ("fixed-height-mode",
658 P_("Fixed Height Mode"),
659 P_("Speeds up GtkTreeView by assuming that all rows have the same height"),
661 GTK_PARAM_READWRITE));
664 * GtkTreeView:hover-selection:
666 * Enables of disables the hover selection mode of @tree_view.
667 * Hover selection makes the selected row follow the pointer.
668 * Currently, this works only for the selection modes
669 * %GTK_SELECTION_SINGLE and %GTK_SELECTION_BROWSE.
671 * This mode is primarily intended for treeviews in popups, e.g.
672 * in #GtkComboBox or #GtkEntryCompletion.
676 g_object_class_install_property (o_class,
677 PROP_HOVER_SELECTION,
678 g_param_spec_boolean ("hover-selection",
679 P_("Hover Selection"),
680 P_("Whether the selection should follow the pointer"),
682 GTK_PARAM_READWRITE));
685 * GtkTreeView:hover-expand:
687 * Enables of disables the hover expansion mode of @tree_view.
688 * Hover expansion makes rows expand or collapse if the pointer moves
691 * This mode is primarily intended for treeviews in popups, e.g.
692 * in #GtkComboBox or #GtkEntryCompletion.
696 g_object_class_install_property (o_class,
698 g_param_spec_boolean ("hover-expand",
700 P_("Whether rows should be expanded/collapsed when the pointer moves over them"),
702 GTK_PARAM_READWRITE));
705 * GtkTreeView:show-expanders:
707 * %TRUE if the view has expanders.
711 g_object_class_install_property (o_class,
713 g_param_spec_boolean ("show-expanders",
714 P_("Show Expanders"),
715 P_("View has expanders"),
717 GTK_PARAM_READWRITE));
720 * GtkTreeView:level-indentation:
722 * Extra indentation for each level.
726 g_object_class_install_property (o_class,
727 PROP_LEVEL_INDENTATION,
728 g_param_spec_int ("level-indentation",
729 P_("Level Indentation"),
730 P_("Extra indentation for each level"),
734 GTK_PARAM_READWRITE));
736 g_object_class_install_property (o_class,
738 g_param_spec_boolean ("rubber-banding",
739 P_("Rubber Banding"),
740 P_("Whether to enable selection of multiple items by dragging the mouse pointer"),
742 GTK_PARAM_READWRITE));
744 g_object_class_install_property (o_class,
745 PROP_ENABLE_GRID_LINES,
746 g_param_spec_enum ("enable-grid-lines",
747 P_("Enable Grid Lines"),
748 P_("Whether grid lines should be drawn in the tree view"),
749 GTK_TYPE_TREE_VIEW_GRID_LINES,
750 GTK_TREE_VIEW_GRID_LINES_NONE,
751 GTK_PARAM_READWRITE));
753 g_object_class_install_property (o_class,
754 PROP_ENABLE_TREE_LINES,
755 g_param_spec_boolean ("enable-tree-lines",
756 P_("Enable Tree Lines"),
757 P_("Whether tree lines should be drawn in the tree view"),
759 GTK_PARAM_READWRITE));
761 g_object_class_install_property (o_class,
763 g_param_spec_int ("tooltip-column",
764 P_("Tooltip Column"),
765 P_("The column in the model containing the tooltip texts for the rows"),
769 GTK_PARAM_READWRITE));
771 /* Style properties */
772 #define _TREE_VIEW_EXPANDER_SIZE 12
773 #define _TREE_VIEW_VERTICAL_SEPARATOR 2
774 #define _TREE_VIEW_HORIZONTAL_SEPARATOR 2
776 gtk_widget_class_install_style_property (widget_class,
777 g_param_spec_int ("expander-size",
779 P_("Size of the expander arrow"),
782 _TREE_VIEW_EXPANDER_SIZE,
783 GTK_PARAM_READABLE));
785 gtk_widget_class_install_style_property (widget_class,
786 g_param_spec_int ("vertical-separator",
787 P_("Vertical Separator Width"),
788 P_("Vertical space between cells. Must be an even number"),
791 _TREE_VIEW_VERTICAL_SEPARATOR,
792 GTK_PARAM_READABLE));
794 gtk_widget_class_install_style_property (widget_class,
795 g_param_spec_int ("horizontal-separator",
796 P_("Horizontal Separator Width"),
797 P_("Horizontal space between cells. Must be an even number"),
800 _TREE_VIEW_HORIZONTAL_SEPARATOR,
801 GTK_PARAM_READABLE));
803 gtk_widget_class_install_style_property (widget_class,
804 g_param_spec_boolean ("allow-rules",
806 P_("Allow drawing of alternating color rows"),
808 GTK_PARAM_READABLE));
810 gtk_widget_class_install_style_property (widget_class,
811 g_param_spec_boolean ("indent-expanders",
812 P_("Indent Expanders"),
813 P_("Make the expanders indented"),
815 GTK_PARAM_READABLE));
817 gtk_widget_class_install_style_property (widget_class,
818 g_param_spec_boxed ("even-row-color",
819 P_("Even Row Color"),
820 P_("Color to use for even rows"),
822 GTK_PARAM_READABLE));
824 gtk_widget_class_install_style_property (widget_class,
825 g_param_spec_boxed ("odd-row-color",
827 P_("Color to use for odd rows"),
829 GTK_PARAM_READABLE));
831 gtk_widget_class_install_style_property (widget_class,
832 g_param_spec_boolean ("row-ending-details",
833 P_("Row Ending details"),
834 P_("Enable extended row background theming"),
836 GTK_PARAM_READABLE));
838 gtk_widget_class_install_style_property (widget_class,
839 g_param_spec_int ("grid-line-width",
840 P_("Grid line width"),
841 P_("Width, in pixels, of the tree view grid lines"),
843 GTK_PARAM_READABLE));
845 gtk_widget_class_install_style_property (widget_class,
846 g_param_spec_int ("tree-line-width",
847 P_("Tree line width"),
848 P_("Width, in pixels, of the tree view lines"),
850 GTK_PARAM_READABLE));
852 gtk_widget_class_install_style_property (widget_class,
853 g_param_spec_string ("grid-line-pattern",
854 P_("Grid line pattern"),
855 P_("Dash pattern used to draw the tree view grid lines"),
857 GTK_PARAM_READABLE));
859 gtk_widget_class_install_style_property (widget_class,
860 g_param_spec_string ("tree-line-pattern",
861 P_("Tree line pattern"),
862 P_("Dash pattern used to draw the tree view lines"),
864 GTK_PARAM_READABLE));
868 * GtkTreeView::set-scroll-adjustments
869 * @horizontal: the horizontal #GtkAdjustment
870 * @vertical: the vertical #GtkAdjustment
872 * Set the scroll adjustments for the tree view. Usually scrolled containers
873 * like #GtkScrolledWindow will emit this signal to connect two instances
874 * of #GtkScrollbar to the scroll directions of the #GtkTreeView.
876 widget_class->set_scroll_adjustments_signal =
877 g_signal_new (I_("set-scroll-adjustments"),
878 G_TYPE_FROM_CLASS (o_class),
879 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
880 G_STRUCT_OFFSET (GtkTreeViewClass, set_scroll_adjustments),
882 _gtk_marshal_VOID__OBJECT_OBJECT,
885 GTK_TYPE_ADJUSTMENT);
888 * GtkTreeView::row-activated:
889 * @tree_view: the object on which the signal is emitted
890 * @path: the #GtkTreePath for the activated row
891 * @column: the #GtkTreeViewColumn in which the activation occurred
893 * The "row-activated" signal is emitted when the method
894 * gtk_tree_view_row_activated() is called or the user double clicks
895 * a treeview row. It is also emitted when a non-editable row is
896 * selected and one of the keys: Space, Shift+Space, Return or
899 * For selection handling refer to the <link linkend="TreeWidget">tree
900 * widget conceptual overview</link> as well as #GtkTreeSelection.
902 tree_view_signals[ROW_ACTIVATED] =
903 g_signal_new (I_("row-activated"),
904 G_TYPE_FROM_CLASS (o_class),
905 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
906 G_STRUCT_OFFSET (GtkTreeViewClass, row_activated),
908 _gtk_marshal_VOID__BOXED_OBJECT,
911 GTK_TYPE_TREE_VIEW_COLUMN);
914 * GtkTreeView::test-expand-row:
915 * @tree_view: the object on which the signal is emitted
916 * @iter: the tree iter of the row to expand
917 * @path: a tree path that points to the row
919 * The given row is about to be expanded (show its children nodes). Use this
920 * signal if you need to control the expandability of individual rows.
922 * Returns: %FALSE to allow expansion, %TRUE to reject
924 tree_view_signals[TEST_EXPAND_ROW] =
925 g_signal_new (I_("test-expand-row"),
926 G_TYPE_FROM_CLASS (o_class),
928 G_STRUCT_OFFSET (GtkTreeViewClass, test_expand_row),
929 _gtk_boolean_handled_accumulator, NULL,
930 _gtk_marshal_BOOLEAN__BOXED_BOXED,
936 * GtkTreeView::test-collapse-row:
937 * @tree_view: the object on which the signal is emitted
938 * @iter: the tree iter of the row to collapse
939 * @path: a tree path that points to the row
941 * The given row is about to be collapsed (hide its children nodes). Use this
942 * signal if you need to control the collapsibility of individual rows.
944 * Returns: %FALSE to allow collapsing, %TRUE to reject
946 tree_view_signals[TEST_COLLAPSE_ROW] =
947 g_signal_new (I_("test-collapse-row"),
948 G_TYPE_FROM_CLASS (o_class),
950 G_STRUCT_OFFSET (GtkTreeViewClass, test_collapse_row),
951 _gtk_boolean_handled_accumulator, NULL,
952 _gtk_marshal_BOOLEAN__BOXED_BOXED,
958 * GtkTreeView::row-expanded:
959 * @tree_view: the object on which the signal is emitted
960 * @iter: the tree iter of the expanded row
961 * @path: a tree path that points to the row
963 * The given row has been expanded (child nodes are shown).
965 tree_view_signals[ROW_EXPANDED] =
966 g_signal_new (I_("row-expanded"),
967 G_TYPE_FROM_CLASS (o_class),
969 G_STRUCT_OFFSET (GtkTreeViewClass, row_expanded),
971 _gtk_marshal_VOID__BOXED_BOXED,
977 * GtkTreeView::row-collapsed:
978 * @tree_view: the object on which the signal is emitted
979 * @iter: the tree iter of the collapsed row
980 * @path: a tree path that points to the row
982 * The given row has been collapsed (child nodes are hidden).
984 tree_view_signals[ROW_COLLAPSED] =
985 g_signal_new (I_("row-collapsed"),
986 G_TYPE_FROM_CLASS (o_class),
988 G_STRUCT_OFFSET (GtkTreeViewClass, row_collapsed),
990 _gtk_marshal_VOID__BOXED_BOXED,
996 * GtkTreeView::columns-changed:
997 * @tree_view: the object on which the signal is emitted
999 * The number of columns of the treeview has changed.
1001 tree_view_signals[COLUMNS_CHANGED] =
1002 g_signal_new (I_("columns-changed"),
1003 G_TYPE_FROM_CLASS (o_class),
1005 G_STRUCT_OFFSET (GtkTreeViewClass, columns_changed),
1007 _gtk_marshal_VOID__VOID,
1011 * GtkTreeView::cursor-changed:
1012 * @tree_view: the object on which the signal is emitted
1014 * The position of the cursor (focused cell) has changed.
1016 tree_view_signals[CURSOR_CHANGED] =
1017 g_signal_new (I_("cursor-changed"),
1018 G_TYPE_FROM_CLASS (o_class),
1020 G_STRUCT_OFFSET (GtkTreeViewClass, cursor_changed),
1022 _gtk_marshal_VOID__VOID,
1025 tree_view_signals[MOVE_CURSOR] =
1026 g_signal_new (I_("move-cursor"),
1027 G_TYPE_FROM_CLASS (object_class),
1028 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1029 G_STRUCT_OFFSET (GtkTreeViewClass, move_cursor),
1031 _gtk_marshal_BOOLEAN__ENUM_INT,
1033 GTK_TYPE_MOVEMENT_STEP,
1036 tree_view_signals[SELECT_ALL] =
1037 g_signal_new (I_("select-all"),
1038 G_TYPE_FROM_CLASS (object_class),
1039 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1040 G_STRUCT_OFFSET (GtkTreeViewClass, select_all),
1042 _gtk_marshal_BOOLEAN__VOID,
1045 tree_view_signals[UNSELECT_ALL] =
1046 g_signal_new (I_("unselect-all"),
1047 G_TYPE_FROM_CLASS (object_class),
1048 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1049 G_STRUCT_OFFSET (GtkTreeViewClass, unselect_all),
1051 _gtk_marshal_BOOLEAN__VOID,
1054 tree_view_signals[SELECT_CURSOR_ROW] =
1055 g_signal_new (I_("select-cursor-row"),
1056 G_TYPE_FROM_CLASS (object_class),
1057 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1058 G_STRUCT_OFFSET (GtkTreeViewClass, select_cursor_row),
1060 _gtk_marshal_BOOLEAN__BOOLEAN,
1064 tree_view_signals[TOGGLE_CURSOR_ROW] =
1065 g_signal_new (I_("toggle-cursor-row"),
1066 G_TYPE_FROM_CLASS (object_class),
1067 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1068 G_STRUCT_OFFSET (GtkTreeViewClass, toggle_cursor_row),
1070 _gtk_marshal_BOOLEAN__VOID,
1073 tree_view_signals[EXPAND_COLLAPSE_CURSOR_ROW] =
1074 g_signal_new (I_("expand-collapse-cursor-row"),
1075 G_TYPE_FROM_CLASS (object_class),
1076 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1077 G_STRUCT_OFFSET (GtkTreeViewClass, expand_collapse_cursor_row),
1079 _gtk_marshal_BOOLEAN__BOOLEAN_BOOLEAN_BOOLEAN,
1085 tree_view_signals[SELECT_CURSOR_PARENT] =
1086 g_signal_new (I_("select-cursor-parent"),
1087 G_TYPE_FROM_CLASS (object_class),
1088 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1089 G_STRUCT_OFFSET (GtkTreeViewClass, select_cursor_parent),
1091 _gtk_marshal_BOOLEAN__VOID,
1094 tree_view_signals[START_INTERACTIVE_SEARCH] =
1095 g_signal_new (I_("start-interactive-search"),
1096 G_TYPE_FROM_CLASS (object_class),
1097 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1098 G_STRUCT_OFFSET (GtkTreeViewClass, start_interactive_search),
1100 _gtk_marshal_BOOLEAN__VOID,
1104 gtk_tree_view_add_move_binding (binding_set, GDK_Up, 0, TRUE,
1105 GTK_MOVEMENT_DISPLAY_LINES, -1);
1106 gtk_tree_view_add_move_binding (binding_set, GDK_KP_Up, 0, TRUE,
1107 GTK_MOVEMENT_DISPLAY_LINES, -1);
1109 gtk_tree_view_add_move_binding (binding_set, GDK_Down, 0, TRUE,
1110 GTK_MOVEMENT_DISPLAY_LINES, 1);
1111 gtk_tree_view_add_move_binding (binding_set, GDK_KP_Down, 0, TRUE,
1112 GTK_MOVEMENT_DISPLAY_LINES, 1);
1114 gtk_tree_view_add_move_binding (binding_set, GDK_p, GDK_CONTROL_MASK, FALSE,
1115 GTK_MOVEMENT_DISPLAY_LINES, -1);
1117 gtk_tree_view_add_move_binding (binding_set, GDK_n, GDK_CONTROL_MASK, FALSE,
1118 GTK_MOVEMENT_DISPLAY_LINES, 1);
1120 gtk_tree_view_add_move_binding (binding_set, GDK_Home, 0, TRUE,
1121 GTK_MOVEMENT_BUFFER_ENDS, -1);
1122 gtk_tree_view_add_move_binding (binding_set, GDK_KP_Home, 0, TRUE,
1123 GTK_MOVEMENT_BUFFER_ENDS, -1);
1125 gtk_tree_view_add_move_binding (binding_set, GDK_End, 0, TRUE,
1126 GTK_MOVEMENT_BUFFER_ENDS, 1);
1127 gtk_tree_view_add_move_binding (binding_set, GDK_KP_End, 0, TRUE,
1128 GTK_MOVEMENT_BUFFER_ENDS, 1);
1130 gtk_tree_view_add_move_binding (binding_set, GDK_Page_Up, 0, TRUE,
1131 GTK_MOVEMENT_PAGES, -1);
1132 gtk_tree_view_add_move_binding (binding_set, GDK_KP_Page_Up, 0, TRUE,
1133 GTK_MOVEMENT_PAGES, -1);
1135 gtk_tree_view_add_move_binding (binding_set, GDK_Page_Down, 0, TRUE,
1136 GTK_MOVEMENT_PAGES, 1);
1137 gtk_tree_view_add_move_binding (binding_set, GDK_KP_Page_Down, 0, TRUE,
1138 GTK_MOVEMENT_PAGES, 1);
1141 gtk_binding_entry_add_signal (binding_set, GDK_Right, 0, "move-cursor", 2,
1142 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1145 gtk_binding_entry_add_signal (binding_set, GDK_Left, 0, "move-cursor", 2,
1146 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1149 gtk_binding_entry_add_signal (binding_set, GDK_KP_Right, 0, "move-cursor", 2,
1150 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1153 gtk_binding_entry_add_signal (binding_set, GDK_KP_Left, 0, "move-cursor", 2,
1154 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1157 gtk_binding_entry_add_signal (binding_set, GDK_Right, GDK_CONTROL_MASK,
1159 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1162 gtk_binding_entry_add_signal (binding_set, GDK_Left, GDK_CONTROL_MASK,
1164 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1167 gtk_binding_entry_add_signal (binding_set, GDK_KP_Right, GDK_CONTROL_MASK,
1169 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1172 gtk_binding_entry_add_signal (binding_set, GDK_KP_Left, GDK_CONTROL_MASK,
1174 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1177 gtk_binding_entry_add_signal (binding_set, GDK_space, GDK_CONTROL_MASK, "toggle-cursor-row", 0);
1178 gtk_binding_entry_add_signal (binding_set, GDK_KP_Space, GDK_CONTROL_MASK, "toggle-cursor-row", 0);
1180 gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_CONTROL_MASK, "select-all", 0);
1181 gtk_binding_entry_add_signal (binding_set, GDK_slash, GDK_CONTROL_MASK, "select-all", 0);
1183 gtk_binding_entry_add_signal (binding_set, GDK_A, GDK_CONTROL_MASK | GDK_SHIFT_MASK, "unselect-all", 0);
1184 gtk_binding_entry_add_signal (binding_set, GDK_backslash, GDK_CONTROL_MASK, "unselect-all", 0);
1186 gtk_binding_entry_add_signal (binding_set, GDK_space, GDK_SHIFT_MASK, "select-cursor-row", 1,
1187 G_TYPE_BOOLEAN, TRUE);
1188 gtk_binding_entry_add_signal (binding_set, GDK_KP_Space, GDK_SHIFT_MASK, "select-cursor-row", 1,
1189 G_TYPE_BOOLEAN, TRUE);
1191 gtk_binding_entry_add_signal (binding_set, GDK_space, 0, "select-cursor-row", 1,
1192 G_TYPE_BOOLEAN, TRUE);
1193 gtk_binding_entry_add_signal (binding_set, GDK_KP_Space, 0, "select-cursor-row", 1,
1194 G_TYPE_BOOLEAN, TRUE);
1195 gtk_binding_entry_add_signal (binding_set, GDK_Return, 0, "select-cursor-row", 1,
1196 G_TYPE_BOOLEAN, TRUE);
1197 gtk_binding_entry_add_signal (binding_set, GDK_ISO_Enter, 0, "select-cursor-row", 1,
1198 G_TYPE_BOOLEAN, TRUE);
1199 gtk_binding_entry_add_signal (binding_set, GDK_KP_Enter, 0, "select-cursor-row", 1,
1200 G_TYPE_BOOLEAN, TRUE);
1202 /* expand and collapse rows */
1203 gtk_binding_entry_add_signal (binding_set, GDK_plus, 0, "expand-collapse-cursor-row", 3,
1204 G_TYPE_BOOLEAN, TRUE,
1205 G_TYPE_BOOLEAN, TRUE,
1206 G_TYPE_BOOLEAN, FALSE);
1208 gtk_binding_entry_add_signal (binding_set, GDK_asterisk, 0,
1209 "expand-collapse-cursor-row", 3,
1210 G_TYPE_BOOLEAN, TRUE,
1211 G_TYPE_BOOLEAN, TRUE,
1212 G_TYPE_BOOLEAN, TRUE);
1213 gtk_binding_entry_add_signal (binding_set, GDK_KP_Multiply, 0,
1214 "expand-collapse-cursor-row", 3,
1215 G_TYPE_BOOLEAN, TRUE,
1216 G_TYPE_BOOLEAN, TRUE,
1217 G_TYPE_BOOLEAN, TRUE);
1219 gtk_binding_entry_add_signal (binding_set, GDK_slash, 0,
1220 "expand-collapse-cursor-row", 3,
1221 G_TYPE_BOOLEAN, TRUE,
1222 G_TYPE_BOOLEAN, FALSE,
1223 G_TYPE_BOOLEAN, FALSE);
1224 gtk_binding_entry_add_signal (binding_set, GDK_KP_Divide, 0,
1225 "expand-collapse-cursor-row", 3,
1226 G_TYPE_BOOLEAN, TRUE,
1227 G_TYPE_BOOLEAN, FALSE,
1228 G_TYPE_BOOLEAN, FALSE);
1230 /* Not doable on US keyboards */
1231 gtk_binding_entry_add_signal (binding_set, GDK_plus, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1232 G_TYPE_BOOLEAN, TRUE,
1233 G_TYPE_BOOLEAN, TRUE,
1234 G_TYPE_BOOLEAN, TRUE);
1235 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, 0, "expand-collapse-cursor-row", 3,
1236 G_TYPE_BOOLEAN, TRUE,
1237 G_TYPE_BOOLEAN, TRUE,
1238 G_TYPE_BOOLEAN, FALSE);
1239 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1240 G_TYPE_BOOLEAN, TRUE,
1241 G_TYPE_BOOLEAN, TRUE,
1242 G_TYPE_BOOLEAN, TRUE);
1243 gtk_binding_entry_add_signal (binding_set, GDK_KP_Add, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1244 G_TYPE_BOOLEAN, TRUE,
1245 G_TYPE_BOOLEAN, TRUE,
1246 G_TYPE_BOOLEAN, TRUE);
1247 gtk_binding_entry_add_signal (binding_set, GDK_Right, GDK_SHIFT_MASK,
1248 "expand-collapse-cursor-row", 3,
1249 G_TYPE_BOOLEAN, FALSE,
1250 G_TYPE_BOOLEAN, TRUE,
1251 G_TYPE_BOOLEAN, TRUE);
1252 gtk_binding_entry_add_signal (binding_set, GDK_KP_Right, GDK_SHIFT_MASK,
1253 "expand-collapse-cursor-row", 3,
1254 G_TYPE_BOOLEAN, FALSE,
1255 G_TYPE_BOOLEAN, TRUE,
1256 G_TYPE_BOOLEAN, TRUE);
1257 gtk_binding_entry_add_signal (binding_set, GDK_Right,
1258 GDK_CONTROL_MASK | GDK_SHIFT_MASK,
1259 "expand-collapse-cursor-row", 3,
1260 G_TYPE_BOOLEAN, FALSE,
1261 G_TYPE_BOOLEAN, TRUE,
1262 G_TYPE_BOOLEAN, TRUE);
1263 gtk_binding_entry_add_signal (binding_set, GDK_KP_Right,
1264 GDK_CONTROL_MASK | GDK_SHIFT_MASK,
1265 "expand-collapse-cursor-row", 3,
1266 G_TYPE_BOOLEAN, FALSE,
1267 G_TYPE_BOOLEAN, TRUE,
1268 G_TYPE_BOOLEAN, TRUE);
1270 gtk_binding_entry_add_signal (binding_set, GDK_minus, 0, "expand-collapse-cursor-row", 3,
1271 G_TYPE_BOOLEAN, TRUE,
1272 G_TYPE_BOOLEAN, FALSE,
1273 G_TYPE_BOOLEAN, FALSE);
1274 gtk_binding_entry_add_signal (binding_set, GDK_minus, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1275 G_TYPE_BOOLEAN, TRUE,
1276 G_TYPE_BOOLEAN, FALSE,
1277 G_TYPE_BOOLEAN, TRUE);
1278 gtk_binding_entry_add_signal (binding_set, GDK_KP_Subtract, 0, "expand-collapse-cursor-row", 3,
1279 G_TYPE_BOOLEAN, TRUE,
1280 G_TYPE_BOOLEAN, FALSE,
1281 G_TYPE_BOOLEAN, FALSE);
1282 gtk_binding_entry_add_signal (binding_set, GDK_KP_Subtract, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1283 G_TYPE_BOOLEAN, TRUE,
1284 G_TYPE_BOOLEAN, FALSE,
1285 G_TYPE_BOOLEAN, TRUE);
1286 gtk_binding_entry_add_signal (binding_set, GDK_Left, GDK_SHIFT_MASK,
1287 "expand-collapse-cursor-row", 3,
1288 G_TYPE_BOOLEAN, FALSE,
1289 G_TYPE_BOOLEAN, FALSE,
1290 G_TYPE_BOOLEAN, TRUE);
1291 gtk_binding_entry_add_signal (binding_set, GDK_KP_Left, GDK_SHIFT_MASK,
1292 "expand-collapse-cursor-row", 3,
1293 G_TYPE_BOOLEAN, FALSE,
1294 G_TYPE_BOOLEAN, FALSE,
1295 G_TYPE_BOOLEAN, TRUE);
1296 gtk_binding_entry_add_signal (binding_set, GDK_Left,
1297 GDK_CONTROL_MASK | GDK_SHIFT_MASK,
1298 "expand-collapse-cursor-row", 3,
1299 G_TYPE_BOOLEAN, FALSE,
1300 G_TYPE_BOOLEAN, FALSE,
1301 G_TYPE_BOOLEAN, TRUE);
1302 gtk_binding_entry_add_signal (binding_set, GDK_KP_Left,
1303 GDK_CONTROL_MASK | GDK_SHIFT_MASK,
1304 "expand-collapse-cursor-row", 3,
1305 G_TYPE_BOOLEAN, FALSE,
1306 G_TYPE_BOOLEAN, FALSE,
1307 G_TYPE_BOOLEAN, TRUE);
1309 gtk_binding_entry_add_signal (binding_set, GDK_BackSpace, 0, "select-cursor-parent", 0);
1310 gtk_binding_entry_add_signal (binding_set, GDK_BackSpace, GDK_CONTROL_MASK, "select-cursor-parent", 0);
1312 gtk_binding_entry_add_signal (binding_set, GDK_f, GDK_CONTROL_MASK, "start-interactive-search", 0);
1314 gtk_binding_entry_add_signal (binding_set, GDK_F, GDK_CONTROL_MASK, "start-interactive-search", 0);
1316 g_type_class_add_private (o_class, sizeof (GtkTreeViewPrivate));
1320 gtk_tree_view_buildable_init (GtkBuildableIface *iface)
1322 iface->add_child = gtk_tree_view_buildable_add_child;
1326 gtk_tree_view_init (GtkTreeView *tree_view)
1328 tree_view->priv = G_TYPE_INSTANCE_GET_PRIVATE (tree_view, GTK_TYPE_TREE_VIEW, GtkTreeViewPrivate);
1330 GTK_WIDGET_SET_FLAGS (tree_view, GTK_CAN_FOCUS);
1332 gtk_widget_set_redraw_on_allocate (GTK_WIDGET (tree_view), FALSE);
1334 tree_view->priv->flags = GTK_TREE_VIEW_SHOW_EXPANDERS
1335 | GTK_TREE_VIEW_DRAW_KEYFOCUS
1336 | GTK_TREE_VIEW_HEADERS_VISIBLE;
1338 /* We need some padding */
1339 tree_view->priv->dy = 0;
1340 tree_view->priv->cursor_offset = 0;
1341 tree_view->priv->n_columns = 0;
1342 tree_view->priv->header_height = 1;
1343 tree_view->priv->x_drag = 0;
1344 tree_view->priv->drag_pos = -1;
1345 tree_view->priv->header_has_focus = FALSE;
1346 tree_view->priv->pressed_button = -1;
1347 tree_view->priv->press_start_x = -1;
1348 tree_view->priv->press_start_y = -1;
1349 tree_view->priv->reorderable = FALSE;
1350 tree_view->priv->presize_handler_timer = 0;
1351 tree_view->priv->scroll_sync_timer = 0;
1352 tree_view->priv->fixed_height = -1;
1353 tree_view->priv->fixed_height_mode = FALSE;
1354 tree_view->priv->fixed_height_check = 0;
1355 gtk_tree_view_set_adjustments (tree_view, NULL, NULL);
1356 tree_view->priv->selection = _gtk_tree_selection_new_with_tree_view (tree_view);
1357 tree_view->priv->enable_search = TRUE;
1358 tree_view->priv->search_column = -1;
1359 tree_view->priv->search_position_func = gtk_tree_view_search_position_func;
1360 tree_view->priv->search_equal_func = gtk_tree_view_search_equal_func;
1361 tree_view->priv->search_custom_entry_set = FALSE;
1362 tree_view->priv->typeselect_flush_timeout = 0;
1363 tree_view->priv->init_hadjust_value = TRUE;
1364 tree_view->priv->width = 0;
1366 tree_view->priv->hover_selection = FALSE;
1367 tree_view->priv->hover_expand = FALSE;
1369 tree_view->priv->level_indentation = 0;
1371 tree_view->priv->rubber_banding_enable = FALSE;
1373 tree_view->priv->grid_lines = GTK_TREE_VIEW_GRID_LINES_NONE;
1374 tree_view->priv->tree_lines_enabled = FALSE;
1376 tree_view->priv->tooltip_column = -1;
1378 tree_view->priv->post_validation_flag = FALSE;
1380 tree_view->priv->last_button_x = -1;
1381 tree_view->priv->last_button_y = -1;
1390 gtk_tree_view_set_property (GObject *object,
1392 const GValue *value,
1395 GtkTreeView *tree_view;
1397 tree_view = GTK_TREE_VIEW (object);
1402 gtk_tree_view_set_model (tree_view, g_value_get_object (value));
1404 case PROP_HADJUSTMENT:
1405 gtk_tree_view_set_hadjustment (tree_view, g_value_get_object (value));
1407 case PROP_VADJUSTMENT:
1408 gtk_tree_view_set_vadjustment (tree_view, g_value_get_object (value));
1410 case PROP_HEADERS_VISIBLE:
1411 gtk_tree_view_set_headers_visible (tree_view, g_value_get_boolean (value));
1413 case PROP_HEADERS_CLICKABLE:
1414 gtk_tree_view_set_headers_clickable (tree_view, g_value_get_boolean (value));
1416 case PROP_EXPANDER_COLUMN:
1417 gtk_tree_view_set_expander_column (tree_view, g_value_get_object (value));
1419 case PROP_REORDERABLE:
1420 gtk_tree_view_set_reorderable (tree_view, g_value_get_boolean (value));
1422 case PROP_RULES_HINT:
1423 gtk_tree_view_set_rules_hint (tree_view, g_value_get_boolean (value));
1425 case PROP_ENABLE_SEARCH:
1426 gtk_tree_view_set_enable_search (tree_view, g_value_get_boolean (value));
1428 case PROP_SEARCH_COLUMN:
1429 gtk_tree_view_set_search_column (tree_view, g_value_get_int (value));
1431 case PROP_FIXED_HEIGHT_MODE:
1432 gtk_tree_view_set_fixed_height_mode (tree_view, g_value_get_boolean (value));
1434 case PROP_HOVER_SELECTION:
1435 tree_view->priv->hover_selection = g_value_get_boolean (value);
1437 case PROP_HOVER_EXPAND:
1438 tree_view->priv->hover_expand = g_value_get_boolean (value);
1440 case PROP_SHOW_EXPANDERS:
1441 gtk_tree_view_set_show_expanders (tree_view, g_value_get_boolean (value));
1443 case PROP_LEVEL_INDENTATION:
1444 tree_view->priv->level_indentation = g_value_get_int (value);
1446 case PROP_RUBBER_BANDING:
1447 tree_view->priv->rubber_banding_enable = g_value_get_boolean (value);
1449 case PROP_ENABLE_GRID_LINES:
1450 gtk_tree_view_set_grid_lines (tree_view, g_value_get_enum (value));
1452 case PROP_ENABLE_TREE_LINES:
1453 gtk_tree_view_set_enable_tree_lines (tree_view, g_value_get_boolean (value));
1455 case PROP_TOOLTIP_COLUMN:
1456 gtk_tree_view_set_tooltip_column (tree_view, g_value_get_int (value));
1459 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1465 gtk_tree_view_get_property (GObject *object,
1470 GtkTreeView *tree_view;
1472 tree_view = GTK_TREE_VIEW (object);
1477 g_value_set_object (value, tree_view->priv->model);
1479 case PROP_HADJUSTMENT:
1480 g_value_set_object (value, tree_view->priv->hadjustment);
1482 case PROP_VADJUSTMENT:
1483 g_value_set_object (value, tree_view->priv->vadjustment);
1485 case PROP_HEADERS_VISIBLE:
1486 g_value_set_boolean (value, gtk_tree_view_get_headers_visible (tree_view));
1488 case PROP_HEADERS_CLICKABLE:
1489 g_value_set_boolean (value, gtk_tree_view_get_headers_clickable (tree_view));
1491 case PROP_EXPANDER_COLUMN:
1492 g_value_set_object (value, tree_view->priv->expander_column);
1494 case PROP_REORDERABLE:
1495 g_value_set_boolean (value, tree_view->priv->reorderable);
1497 case PROP_RULES_HINT:
1498 g_value_set_boolean (value, tree_view->priv->has_rules);
1500 case PROP_ENABLE_SEARCH:
1501 g_value_set_boolean (value, tree_view->priv->enable_search);
1503 case PROP_SEARCH_COLUMN:
1504 g_value_set_int (value, tree_view->priv->search_column);
1506 case PROP_FIXED_HEIGHT_MODE:
1507 g_value_set_boolean (value, tree_view->priv->fixed_height_mode);
1509 case PROP_HOVER_SELECTION:
1510 g_value_set_boolean (value, tree_view->priv->hover_selection);
1512 case PROP_HOVER_EXPAND:
1513 g_value_set_boolean (value, tree_view->priv->hover_expand);
1515 case PROP_SHOW_EXPANDERS:
1516 g_value_set_boolean (value, GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS));
1518 case PROP_LEVEL_INDENTATION:
1519 g_value_set_int (value, tree_view->priv->level_indentation);
1521 case PROP_RUBBER_BANDING:
1522 g_value_set_boolean (value, tree_view->priv->rubber_banding_enable);
1524 case PROP_ENABLE_GRID_LINES:
1525 g_value_set_enum (value, tree_view->priv->grid_lines);
1527 case PROP_ENABLE_TREE_LINES:
1528 g_value_set_boolean (value, tree_view->priv->tree_lines_enabled);
1530 case PROP_TOOLTIP_COLUMN:
1531 g_value_set_int (value, tree_view->priv->tooltip_column);
1534 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1540 gtk_tree_view_finalize (GObject *object)
1542 G_OBJECT_CLASS (gtk_tree_view_parent_class)->finalize (object);
1548 gtk_tree_view_buildable_add_child (GtkBuildable *tree_view,
1549 GtkBuilder *builder,
1553 gtk_tree_view_append_column (GTK_TREE_VIEW (tree_view), GTK_TREE_VIEW_COLUMN (child));
1556 /* GtkObject Methods
1560 gtk_tree_view_free_rbtree (GtkTreeView *tree_view)
1562 _gtk_rbtree_free (tree_view->priv->tree);
1564 tree_view->priv->tree = NULL;
1565 tree_view->priv->button_pressed_node = NULL;
1566 tree_view->priv->button_pressed_tree = NULL;
1567 tree_view->priv->prelight_tree = NULL;
1568 tree_view->priv->prelight_node = NULL;
1569 tree_view->priv->expanded_collapsed_node = NULL;
1570 tree_view->priv->expanded_collapsed_tree = NULL;
1574 gtk_tree_view_destroy (GtkObject *object)
1576 GtkTreeView *tree_view = GTK_TREE_VIEW (object);
1579 gtk_tree_view_stop_editing (tree_view, TRUE);
1581 if (tree_view->priv->columns != NULL)
1583 list = tree_view->priv->columns;
1586 GtkTreeViewColumn *column;
1587 column = GTK_TREE_VIEW_COLUMN (list->data);
1589 gtk_tree_view_remove_column (tree_view, column);
1591 tree_view->priv->columns = NULL;
1594 if (tree_view->priv->tree != NULL)
1596 gtk_tree_view_unref_and_check_selection_tree (tree_view, tree_view->priv->tree);
1598 gtk_tree_view_free_rbtree (tree_view);
1601 if (tree_view->priv->selection != NULL)
1603 _gtk_tree_selection_set_tree_view (tree_view->priv->selection, NULL);
1604 g_object_unref (tree_view->priv->selection);
1605 tree_view->priv->selection = NULL;
1608 if (tree_view->priv->scroll_to_path != NULL)
1610 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
1611 tree_view->priv->scroll_to_path = NULL;
1614 if (tree_view->priv->drag_dest_row != NULL)
1616 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
1617 tree_view->priv->drag_dest_row = NULL;
1620 if (tree_view->priv->top_row != NULL)
1622 gtk_tree_row_reference_free (tree_view->priv->top_row);
1623 tree_view->priv->top_row = NULL;
1626 if (tree_view->priv->column_drop_func_data &&
1627 tree_view->priv->column_drop_func_data_destroy)
1629 tree_view->priv->column_drop_func_data_destroy (tree_view->priv->column_drop_func_data);
1630 tree_view->priv->column_drop_func_data = NULL;
1633 if (tree_view->priv->destroy_count_destroy &&
1634 tree_view->priv->destroy_count_data)
1636 tree_view->priv->destroy_count_destroy (tree_view->priv->destroy_count_data);
1637 tree_view->priv->destroy_count_data = NULL;
1640 gtk_tree_row_reference_free (tree_view->priv->cursor);
1641 tree_view->priv->cursor = NULL;
1643 gtk_tree_row_reference_free (tree_view->priv->anchor);
1644 tree_view->priv->anchor = NULL;
1646 /* destroy interactive search dialog */
1647 if (tree_view->priv->search_window)
1649 gtk_widget_destroy (tree_view->priv->search_window);
1650 tree_view->priv->search_window = NULL;
1651 tree_view->priv->search_entry = NULL;
1652 if (tree_view->priv->typeselect_flush_timeout)
1654 g_source_remove (tree_view->priv->typeselect_flush_timeout);
1655 tree_view->priv->typeselect_flush_timeout = 0;
1659 if (tree_view->priv->search_destroy && tree_view->priv->search_user_data)
1661 tree_view->priv->search_destroy (tree_view->priv->search_user_data);
1662 tree_view->priv->search_user_data = NULL;
1665 if (tree_view->priv->search_position_destroy && tree_view->priv->search_position_user_data)
1667 tree_view->priv->search_position_destroy (tree_view->priv->search_position_user_data);
1668 tree_view->priv->search_position_user_data = NULL;
1671 if (tree_view->priv->row_separator_destroy && tree_view->priv->row_separator_data)
1673 tree_view->priv->row_separator_destroy (tree_view->priv->row_separator_data);
1674 tree_view->priv->row_separator_data = NULL;
1677 gtk_tree_view_set_model (tree_view, NULL);
1679 if (tree_view->priv->hadjustment)
1681 g_object_unref (tree_view->priv->hadjustment);
1682 tree_view->priv->hadjustment = NULL;
1684 if (tree_view->priv->vadjustment)
1686 g_object_unref (tree_view->priv->vadjustment);
1687 tree_view->priv->vadjustment = NULL;
1690 GTK_OBJECT_CLASS (gtk_tree_view_parent_class)->destroy (object);
1695 /* GtkWidget Methods
1698 /* GtkWidget::map helper */
1700 gtk_tree_view_map_buttons (GtkTreeView *tree_view)
1704 g_return_if_fail (GTK_WIDGET_MAPPED (tree_view));
1706 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
1708 GtkTreeViewColumn *column;
1710 for (list = tree_view->priv->columns; list; list = list->next)
1712 column = list->data;
1713 if (GTK_WIDGET_VISIBLE (column->button) &&
1714 !GTK_WIDGET_MAPPED (column->button))
1715 gtk_widget_map (column->button);
1717 for (list = tree_view->priv->columns; list; list = list->next)
1719 column = list->data;
1720 if (column->visible == FALSE)
1722 if (column->resizable)
1724 gdk_window_raise (column->window);
1725 gdk_window_show (column->window);
1728 gdk_window_hide (column->window);
1730 gdk_window_show (tree_view->priv->header_window);
1735 gtk_tree_view_map (GtkWidget *widget)
1737 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
1740 GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
1742 tmp_list = tree_view->priv->children;
1745 GtkTreeViewChild *child = tmp_list->data;
1746 tmp_list = tmp_list->next;
1748 if (GTK_WIDGET_VISIBLE (child->widget))
1750 if (!GTK_WIDGET_MAPPED (child->widget))
1751 gtk_widget_map (child->widget);
1754 gdk_window_show (tree_view->priv->bin_window);
1756 gtk_tree_view_map_buttons (tree_view);
1758 gdk_window_show (widget->window);
1762 gtk_tree_view_realize (GtkWidget *widget)
1764 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
1766 GdkWindowAttr attributes;
1767 gint attributes_mask;
1769 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
1771 /* Make the main, clipping window */
1772 attributes.window_type = GDK_WINDOW_CHILD;
1773 attributes.x = widget->allocation.x;
1774 attributes.y = widget->allocation.y;
1775 attributes.width = widget->allocation.width;
1776 attributes.height = widget->allocation.height;
1777 attributes.wclass = GDK_INPUT_OUTPUT;
1778 attributes.visual = gtk_widget_get_visual (widget);
1779 attributes.colormap = gtk_widget_get_colormap (widget);
1780 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK;
1782 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
1784 widget->window = gdk_window_new (gtk_widget_get_parent_window (widget),
1785 &attributes, attributes_mask);
1786 gdk_window_set_user_data (widget->window, widget);
1788 /* Make the window for the tree */
1790 attributes.y = TREE_VIEW_HEADER_HEIGHT (tree_view);
1791 attributes.width = MAX (tree_view->priv->width, widget->allocation.width);
1792 attributes.height = widget->allocation.height;
1793 attributes.event_mask = (GDK_EXPOSURE_MASK |
1795 GDK_POINTER_MOTION_MASK |
1796 GDK_ENTER_NOTIFY_MASK |
1797 GDK_LEAVE_NOTIFY_MASK |
1798 GDK_BUTTON_PRESS_MASK |
1799 GDK_BUTTON_RELEASE_MASK |
1800 gtk_widget_get_events (widget));
1802 tree_view->priv->bin_window = gdk_window_new (widget->window,
1803 &attributes, attributes_mask);
1804 gdk_window_set_user_data (tree_view->priv->bin_window, widget);
1806 /* Make the column header window */
1809 attributes.width = MAX (tree_view->priv->width, widget->allocation.width);
1810 attributes.height = tree_view->priv->header_height;
1811 attributes.event_mask = (GDK_EXPOSURE_MASK |
1813 GDK_BUTTON_PRESS_MASK |
1814 GDK_BUTTON_RELEASE_MASK |
1815 GDK_KEY_PRESS_MASK |
1816 GDK_KEY_RELEASE_MASK |
1817 gtk_widget_get_events (widget));
1819 tree_view->priv->header_window = gdk_window_new (widget->window,
1820 &attributes, attributes_mask);
1821 gdk_window_set_user_data (tree_view->priv->header_window, widget);
1823 /* Add them all up. */
1824 widget->style = gtk_style_attach (widget->style, widget->window);
1825 gdk_window_set_back_pixmap (widget->window, NULL, FALSE);
1826 gdk_window_set_background (tree_view->priv->bin_window, &widget->style->base[widget->state]);
1827 gtk_style_set_background (widget->style, tree_view->priv->header_window, GTK_STATE_NORMAL);
1829 tmp_list = tree_view->priv->children;
1832 GtkTreeViewChild *child = tmp_list->data;
1833 tmp_list = tmp_list->next;
1835 gtk_widget_set_parent_window (child->widget, tree_view->priv->bin_window);
1838 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
1839 _gtk_tree_view_column_realize_button (GTK_TREE_VIEW_COLUMN (tmp_list->data));
1841 /* Need to call those here, since they create GCs */
1842 gtk_tree_view_set_grid_lines (tree_view, tree_view->priv->grid_lines);
1843 gtk_tree_view_set_enable_tree_lines (tree_view, tree_view->priv->tree_lines_enabled);
1845 install_presize_handler (tree_view);
1849 gtk_tree_view_unrealize (GtkWidget *widget)
1851 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
1852 GtkTreeViewPrivate *priv = tree_view->priv;
1855 if (priv->scroll_timeout != 0)
1857 g_source_remove (priv->scroll_timeout);
1858 priv->scroll_timeout = 0;
1861 if (priv->auto_expand_timeout != 0)
1863 g_source_remove (priv->auto_expand_timeout);
1864 priv->auto_expand_timeout = 0;
1867 if (priv->open_dest_timeout != 0)
1869 g_source_remove (priv->open_dest_timeout);
1870 priv->open_dest_timeout = 0;
1873 remove_expand_collapse_timeout (tree_view);
1875 if (priv->presize_handler_timer != 0)
1877 g_source_remove (priv->presize_handler_timer);
1878 priv->presize_handler_timer = 0;
1881 if (priv->validate_rows_timer != 0)
1883 g_source_remove (priv->validate_rows_timer);
1884 priv->validate_rows_timer = 0;
1887 if (priv->scroll_sync_timer != 0)
1889 g_source_remove (priv->scroll_sync_timer);
1890 priv->scroll_sync_timer = 0;
1893 if (priv->typeselect_flush_timeout)
1895 g_source_remove (priv->typeselect_flush_timeout);
1896 priv->typeselect_flush_timeout = 0;
1899 for (list = priv->columns; list; list = list->next)
1900 _gtk_tree_view_column_unrealize_button (GTK_TREE_VIEW_COLUMN (list->data));
1902 gdk_window_set_user_data (priv->bin_window, NULL);
1903 gdk_window_destroy (priv->bin_window);
1904 priv->bin_window = NULL;
1906 gdk_window_set_user_data (priv->header_window, NULL);
1907 gdk_window_destroy (priv->header_window);
1908 priv->header_window = NULL;
1910 if (priv->drag_window)
1912 gdk_window_set_user_data (priv->drag_window, NULL);
1913 gdk_window_destroy (priv->drag_window);
1914 priv->drag_window = NULL;
1917 if (priv->drag_highlight_window)
1919 gdk_window_set_user_data (priv->drag_highlight_window, NULL);
1920 gdk_window_destroy (priv->drag_highlight_window);
1921 priv->drag_highlight_window = NULL;
1924 if (priv->tree_line_gc)
1926 g_object_unref (priv->tree_line_gc);
1927 priv->tree_line_gc = NULL;
1930 if (priv->grid_line_gc)
1932 g_object_unref (priv->grid_line_gc);
1933 priv->grid_line_gc = NULL;
1936 GTK_WIDGET_CLASS (gtk_tree_view_parent_class)->unrealize (widget);
1939 /* GtkWidget::size_request helper */
1941 gtk_tree_view_size_request_columns (GtkTreeView *tree_view)
1945 tree_view->priv->header_height = 0;
1947 if (tree_view->priv->model)
1949 for (list = tree_view->priv->columns; list; list = list->next)
1951 GtkRequisition requisition;
1952 GtkTreeViewColumn *column = list->data;
1954 if (column->button == NULL)
1957 column = list->data;
1959 gtk_widget_size_request (column->button, &requisition);
1960 column->button_request = requisition.width;
1961 tree_view->priv->header_height = MAX (tree_view->priv->header_height, requisition.height);
1967 /* Called only by ::size_request */
1969 gtk_tree_view_update_size (GtkTreeView *tree_view)
1972 GtkTreeViewColumn *column;
1975 if (tree_view->priv->model == NULL)
1977 tree_view->priv->width = 0;
1978 tree_view->priv->prev_width = 0;
1979 tree_view->priv->height = 0;
1983 tree_view->priv->prev_width = tree_view->priv->width;
1984 tree_view->priv->width = 0;
1986 /* keep this in sync with size_allocate below */
1987 for (list = tree_view->priv->columns, i = 0; list; list = list->next, i++)
1989 gint real_requested_width = 0;
1990 column = list->data;
1991 if (!column->visible)
1994 if (column->use_resized_width)
1996 real_requested_width = column->resized_width;
1998 else if (column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
2000 real_requested_width = column->fixed_width;
2002 else if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
2004 real_requested_width = MAX (column->requested_width, column->button_request);
2008 real_requested_width = column->requested_width;
2011 if (column->min_width != -1)
2012 real_requested_width = MAX (real_requested_width, column->min_width);
2013 if (column->max_width != -1)
2014 real_requested_width = MIN (real_requested_width, column->max_width);
2016 tree_view->priv->width += real_requested_width;
2019 if (tree_view->priv->tree == NULL)
2020 tree_view->priv->height = 0;
2022 tree_view->priv->height = tree_view->priv->tree->root->offset;
2026 gtk_tree_view_size_request (GtkWidget *widget,
2027 GtkRequisition *requisition)
2029 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
2032 /* we validate some rows initially just to make sure we have some size.
2033 * In practice, with a lot of static lists, this should get a good width.
2035 do_validate_rows (tree_view, FALSE);
2036 gtk_tree_view_size_request_columns (tree_view);
2037 gtk_tree_view_update_size (GTK_TREE_VIEW (widget));
2039 requisition->width = tree_view->priv->width;
2040 requisition->height = tree_view->priv->height + TREE_VIEW_HEADER_HEIGHT (tree_view);
2042 tmp_list = tree_view->priv->children;
2046 GtkTreeViewChild *child = tmp_list->data;
2047 GtkRequisition child_requisition;
2049 tmp_list = tmp_list->next;
2051 if (GTK_WIDGET_VISIBLE (child->widget))
2052 gtk_widget_size_request (child->widget, &child_requisition);
2058 invalidate_column (GtkTreeView *tree_view,
2059 GtkTreeViewColumn *column)
2061 gint column_offset = 0;
2063 GtkWidget *widget = GTK_WIDGET (tree_view);
2066 if (!GTK_WIDGET_REALIZED (widget))
2069 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
2070 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
2072 list = (rtl ? list->prev : list->next))
2074 GtkTreeViewColumn *tmpcolumn = list->data;
2075 if (tmpcolumn == column)
2077 GdkRectangle invalid_rect;
2079 invalid_rect.x = column_offset;
2081 invalid_rect.width = column->width;
2082 invalid_rect.height = widget->allocation.height;
2084 gdk_window_invalidate_rect (widget->window, &invalid_rect, TRUE);
2088 column_offset += tmpcolumn->width;
2093 invalidate_last_column (GtkTreeView *tree_view)
2098 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
2100 for (last_column = (rtl ? g_list_first (tree_view->priv->columns) : g_list_last (tree_view->priv->columns));
2102 last_column = (rtl ? last_column->next : last_column->prev))
2104 if (GTK_TREE_VIEW_COLUMN (last_column->data)->visible)
2106 invalidate_column (tree_view, last_column->data);
2113 gtk_tree_view_get_real_requested_width_from_column (GtkTreeView *tree_view,
2114 GtkTreeViewColumn *column)
2116 gint real_requested_width;
2118 if (column->use_resized_width)
2120 real_requested_width = column->resized_width;
2122 else if (column->column_type == GTK_TREE_VIEW_COLUMN_FIXED)
2124 real_requested_width = column->fixed_width;
2126 else if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
2128 real_requested_width = MAX (column->requested_width, column->button_request);
2132 real_requested_width = column->requested_width;
2133 if (real_requested_width < 0)
2134 real_requested_width = 0;
2137 if (column->min_width != -1)
2138 real_requested_width = MAX (real_requested_width, column->min_width);
2139 if (column->max_width != -1)
2140 real_requested_width = MIN (real_requested_width, column->max_width);
2142 return real_requested_width;
2146 gtk_tree_view_get_real_natural_width_from_column (GtkTreeView *tree_view,
2147 GtkTreeViewColumn *column)
2149 GtkTreeViewColumnPrivate *column_priv;
2150 GtkRequisition button_natural_size;
2151 gint column_natural_width;
2153 column_priv = GTK_TREE_VIEW_COLUMN_GET_PRIVATE (column);
2154 column_natural_width = column_priv->natural_width;
2156 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
2158 gtk_extended_layout_get_desired_size (GTK_EXTENDED_LAYOUT (column->button),
2159 NULL, &button_natural_size);
2161 column_natural_width = MAX (column_natural_width, button_natural_size.width);
2164 return column_natural_width;
2167 /* GtkWidget::size_allocate helper */
2169 gtk_tree_view_size_allocate_columns (GtkWidget *widget,
2170 gboolean *width_changed)
2172 GtkTreeView *tree_view;
2173 GList *list, *first_column, *last_column;
2174 GtkTreeViewColumn *column;
2175 GtkAllocation allocation;
2176 gint width = 0, natural_width;
2177 gint extra, extra_per_column, extra_for_last;
2178 gint full_requested_width = 0;
2179 gint full_natural_width = 0;
2180 gint number_of_expand_columns = 0;
2181 gboolean column_changed = FALSE;
2183 gboolean update_expand;
2185 tree_view = GTK_TREE_VIEW (widget);
2187 for (last_column = g_list_last (tree_view->priv->columns);
2188 last_column && !(GTK_TREE_VIEW_COLUMN (last_column->data)->visible);
2189 last_column = last_column->prev)
2191 if (last_column == NULL)
2194 for (first_column = g_list_first (tree_view->priv->columns);
2195 first_column && !(GTK_TREE_VIEW_COLUMN (first_column->data)->visible);
2196 first_column = first_column->next)
2200 allocation.height = tree_view->priv->header_height;
2202 rtl = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);
2204 /* find out how many extra space and expandable columns we have */
2205 for (list = tree_view->priv->columns; list != last_column->next; list = list->next)
2207 column = (GtkTreeViewColumn *)list->data;
2209 if (!column->visible)
2212 full_requested_width += gtk_tree_view_get_real_requested_width_from_column (tree_view, column);
2213 full_natural_width += gtk_tree_view_get_real_natural_width_from_column (tree_view, column);
2216 number_of_expand_columns++;
2219 /* Only update the expand value if the width of the widget has changed,
2220 * or the number of expand columns has changed, or if there are no expand
2221 * columns, or if we didn't have an size-allocation yet after the
2222 * last validated node.
2224 update_expand = (width_changed && *width_changed == TRUE)
2225 || number_of_expand_columns != tree_view->priv->last_number_of_expand_columns
2226 || number_of_expand_columns == 0
2227 || tree_view->priv->post_validation_flag == TRUE;
2229 tree_view->priv->post_validation_flag = FALSE;
2233 extra = tree_view->priv->last_extra_space;
2234 extra_for_last = MAX (widget->allocation.width - full_requested_width - extra, 0);
2238 full_natural_width -= full_requested_width;
2239 extra = MAX (widget->allocation.width - full_requested_width, 0);
2240 natural_width = MIN (extra, full_natural_width);
2243 tree_view->priv->last_extra_space = extra;
2246 if (number_of_expand_columns > 0)
2247 extra_per_column = extra/number_of_expand_columns;
2249 extra_per_column = 0;
2253 tree_view->priv->last_extra_space_per_column = extra_per_column;
2254 tree_view->priv->last_number_of_expand_columns = number_of_expand_columns;
2257 for (list = (rtl ? last_column : first_column);
2258 list != (rtl ? first_column->prev : last_column->next);
2259 list = (rtl ? list->prev : list->next))
2261 gint real_requested_width = 0;
2262 gint real_natural_width = 0;
2265 column = list->data;
2266 old_width = column->width;
2268 if (!column->visible)
2271 /* We need to handle the dragged button specially.
2273 if (column == tree_view->priv->drag_column)
2275 GtkAllocation drag_allocation;
2276 gdk_drawable_get_size (tree_view->priv->drag_window,
2277 &(drag_allocation.width),
2278 &(drag_allocation.height));
2279 drag_allocation.x = 0;
2280 drag_allocation.y = 0;
2281 gtk_widget_size_allocate (tree_view->priv->drag_column->button,
2283 width += drag_allocation.width;
2287 real_requested_width = gtk_tree_view_get_real_requested_width_from_column (tree_view, column);
2288 real_natural_width = gtk_tree_view_get_real_natural_width_from_column (tree_view, column);
2289 real_natural_width -= real_requested_width;
2291 allocation.x = width;
2292 column->width = real_requested_width;
2294 if (full_natural_width > 0)
2295 column->width += natural_width * real_natural_width / full_natural_width;
2298 if (number_of_expand_columns == 1)
2300 /* We add the remander to the last column as
2302 column->width += extra;
2306 column->width += extra_per_column;
2307 extra -= extra_per_column;
2308 number_of_expand_columns --;
2311 else if (number_of_expand_columns == 0 &&
2312 list == last_column)
2314 column->width += extra;
2317 /* In addition to expand, the last column can get even more
2318 * extra space so all available space is filled up.
2320 if (extra_for_last > 0 && list == last_column)
2321 column->width += extra_for_last;
2323 g_object_notify (G_OBJECT (column), "width");
2325 allocation.width = column->width;
2326 width += column->width;
2328 if (column->width > old_width)
2329 column_changed = TRUE;
2331 gtk_widget_size_allocate (column->button, &allocation);
2334 gdk_window_move_resize (column->window,
2335 allocation.x + (rtl ? 0 : allocation.width) - TREE_VIEW_DRAG_WIDTH/2,
2337 TREE_VIEW_DRAG_WIDTH, allocation.height);
2340 /* We change the width here. The user might have been resizing columns,
2341 * so the total width of the tree view changes.
2343 tree_view->priv->width = width;
2345 *width_changed = TRUE;
2348 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
2353 gtk_tree_view_size_allocate (GtkWidget *widget,
2354 GtkAllocation *allocation)
2356 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
2358 gboolean width_changed = FALSE;
2359 gint old_width = widget->allocation.width;
2361 if (allocation->width != widget->allocation.width)
2362 width_changed = TRUE;
2364 widget->allocation = *allocation;
2366 tmp_list = tree_view->priv->children;
2370 GtkAllocation allocation;
2372 GtkTreeViewChild *child = tmp_list->data;
2373 tmp_list = tmp_list->next;
2375 /* totally ignore our child's requisition */
2376 allocation.x = child->x;
2377 allocation.y = child->y;
2378 allocation.width = child->width;
2379 allocation.height = child->height;
2380 gtk_widget_size_allocate (child->widget, &allocation);
2383 /* We size-allocate the columns first because the width of the
2384 * tree view (used in updating the adjustments below) might change.
2386 gtk_tree_view_size_allocate_columns (widget, &width_changed);
2388 tree_view->priv->hadjustment->page_size = allocation->width;
2389 tree_view->priv->hadjustment->page_increment = allocation->width * 0.9;
2390 tree_view->priv->hadjustment->step_increment = allocation->width * 0.1;
2391 tree_view->priv->hadjustment->lower = 0;
2392 tree_view->priv->hadjustment->upper = MAX (tree_view->priv->hadjustment->page_size, tree_view->priv->width);
2394 if (gtk_widget_get_direction(widget) == GTK_TEXT_DIR_RTL)
2396 if (allocation->width < tree_view->priv->width)
2398 if (tree_view->priv->init_hadjust_value)
2400 tree_view->priv->hadjustment->value = MAX (tree_view->priv->width - allocation->width, 0);
2401 tree_view->priv->init_hadjust_value = FALSE;
2403 else if (allocation->width != old_width)
2405 tree_view->priv->hadjustment->value = CLAMP (tree_view->priv->hadjustment->value - allocation->width + old_width, 0, tree_view->priv->width - allocation->width);
2408 tree_view->priv->hadjustment->value = CLAMP (tree_view->priv->width - (tree_view->priv->prev_width - tree_view->priv->hadjustment->value), 0, tree_view->priv->width - allocation->width);
2412 tree_view->priv->hadjustment->value = 0;
2413 tree_view->priv->init_hadjust_value = TRUE;
2417 if (tree_view->priv->hadjustment->value + allocation->width > tree_view->priv->width)
2418 tree_view->priv->hadjustment->value = MAX (tree_view->priv->width - allocation->width, 0);
2420 gtk_adjustment_changed (tree_view->priv->hadjustment);
2422 tree_view->priv->vadjustment->page_size = allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view);
2423 tree_view->priv->vadjustment->step_increment = tree_view->priv->vadjustment->page_size * 0.1;
2424 tree_view->priv->vadjustment->page_increment = tree_view->priv->vadjustment->page_size * 0.9;
2425 tree_view->priv->vadjustment->lower = 0;
2426 tree_view->priv->vadjustment->upper = MAX (tree_view->priv->vadjustment->page_size, tree_view->priv->height);
2428 gtk_adjustment_changed (tree_view->priv->vadjustment);
2430 /* now the adjustments and window sizes are in sync, we can sync toprow/dy again */
2431 if (tree_view->priv->height <= tree_view->priv->vadjustment->page_size)
2432 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment), 0);
2433 else if (tree_view->priv->vadjustment->value + tree_view->priv->vadjustment->page_size > tree_view->priv->height)
2434 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment),
2435 tree_view->priv->height - tree_view->priv->vadjustment->page_size);
2436 else if (gtk_tree_row_reference_valid (tree_view->priv->top_row))
2437 gtk_tree_view_top_row_to_dy (tree_view);
2439 gtk_tree_view_dy_to_top_row (tree_view);
2441 if (GTK_WIDGET_REALIZED (widget))
2443 gdk_window_move_resize (widget->window,
2444 allocation->x, allocation->y,
2445 allocation->width, allocation->height);
2446 gdk_window_move_resize (tree_view->priv->header_window,
2447 - (gint) tree_view->priv->hadjustment->value,
2449 MAX (tree_view->priv->width, allocation->width),
2450 tree_view->priv->header_height);
2451 gdk_window_move_resize (tree_view->priv->bin_window,
2452 - (gint) tree_view->priv->hadjustment->value,
2453 TREE_VIEW_HEADER_HEIGHT (tree_view),
2454 MAX (tree_view->priv->width, allocation->width),
2455 allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view));
2458 if (tree_view->priv->tree == NULL)
2459 invalidate_empty_focus (tree_view);
2461 if (GTK_WIDGET_REALIZED (widget))
2463 gboolean has_expand_column = FALSE;
2464 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
2466 if (gtk_tree_view_column_get_expand (GTK_TREE_VIEW_COLUMN (tmp_list->data)))
2468 has_expand_column = TRUE;
2473 /* This little hack only works if we have an LTR locale, and no column has the */
2476 if (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_LTR &&
2477 ! has_expand_column)
2478 invalidate_last_column (tree_view);
2480 gtk_widget_queue_draw (widget);
2485 /* Grabs the focus and unsets the GTK_TREE_VIEW_DRAW_KEYFOCUS flag */
2487 grab_focus_and_unset_draw_keyfocus (GtkTreeView *tree_view)
2489 if (GTK_WIDGET_CAN_FOCUS (tree_view) && !GTK_WIDGET_HAS_FOCUS (tree_view))
2490 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
2491 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
2494 static inline gboolean
2495 row_is_separator (GtkTreeView *tree_view,
2499 gboolean is_separator = FALSE;
2501 if (tree_view->priv->row_separator_func)
2503 GtkTreeIter tmpiter;
2508 gtk_tree_model_get_iter (tree_view->priv->model, &tmpiter, path);
2510 is_separator = tree_view->priv->row_separator_func (tree_view->priv->model,
2512 tree_view->priv->row_separator_data);
2515 return is_separator;
2519 gtk_tree_view_button_press (GtkWidget *widget,
2520 GdkEventButton *event)
2522 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
2524 GtkTreeViewColumn *column = NULL;
2526 GdkRectangle background_area;
2527 GdkRectangle cell_area;
2528 gint vertical_separator;
2529 gint horizontal_separator;
2530 gboolean path_is_selectable;
2533 rtl = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);
2534 gtk_tree_view_stop_editing (tree_view, FALSE);
2535 gtk_widget_style_get (widget,
2536 "vertical-separator", &vertical_separator,
2537 "horizontal-separator", &horizontal_separator,
2541 /* Because grab_focus can cause reentrancy, we delay grab_focus until after
2542 * we're done handling the button press.
2545 if (event->window == tree_view->priv->bin_window)
2555 gint pre_val, aft_val;
2556 GtkTreeViewColumn *column = NULL;
2557 GtkCellRenderer *focus_cell = NULL;
2558 gint column_handled_click = FALSE;
2559 gboolean row_double_click = FALSE;
2561 gboolean node_selected;
2564 if (tree_view->priv->tree == NULL)
2566 grab_focus_and_unset_draw_keyfocus (tree_view);
2570 /* are we in an arrow? */
2571 if (tree_view->priv->prelight_node &&
2572 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT) &&
2573 TREE_VIEW_DRAW_EXPANDERS (tree_view))
2575 if (event->button == 1)
2577 gtk_grab_add (widget);
2578 tree_view->priv->button_pressed_node = tree_view->priv->prelight_node;
2579 tree_view->priv->button_pressed_tree = tree_view->priv->prelight_tree;
2580 gtk_tree_view_draw_arrow (GTK_TREE_VIEW (widget),
2581 tree_view->priv->prelight_tree,
2582 tree_view->priv->prelight_node,
2587 grab_focus_and_unset_draw_keyfocus (tree_view);
2591 /* find the node that was clicked */
2592 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
2595 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
2599 /* We clicked in dead space */
2600 grab_focus_and_unset_draw_keyfocus (tree_view);
2604 /* Get the path and the node */
2605 path = _gtk_tree_view_find_path (tree_view, tree, node);
2606 path_is_selectable = !row_is_separator (tree_view, NULL, path);
2608 if (!path_is_selectable)
2610 gtk_tree_path_free (path);
2611 grab_focus_and_unset_draw_keyfocus (tree_view);
2615 depth = gtk_tree_path_get_depth (path);
2616 background_area.y = y_offset + event->y;
2617 background_area.height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
2618 background_area.x = 0;
2621 /* Let the column have a chance at selecting it. */
2622 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
2623 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
2624 list; list = (rtl ? list->prev : list->next))
2626 GtkTreeViewColumn *candidate = list->data;
2628 if (!candidate->visible)
2631 background_area.width = candidate->width;
2632 if ((background_area.x > (gint) event->x) ||
2633 (background_area.x + background_area.width <= (gint) event->x))
2635 background_area.x += background_area.width;
2639 /* we found the focus column */
2641 cell_area = background_area;
2642 cell_area.width -= horizontal_separator;
2643 cell_area.height -= vertical_separator;
2644 cell_area.x += horizontal_separator/2;
2645 cell_area.y += vertical_separator/2;
2646 if (gtk_tree_view_is_expander_column (tree_view, column))
2649 cell_area.x += (depth - 1) * tree_view->priv->level_indentation;
2650 cell_area.width -= (depth - 1) * tree_view->priv->level_indentation;
2652 if (TREE_VIEW_DRAW_EXPANDERS (tree_view))
2655 cell_area.x += depth * tree_view->priv->expander_size;
2656 cell_area.width -= depth * tree_view->priv->expander_size;
2664 gtk_tree_path_free (path);
2665 grab_focus_and_unset_draw_keyfocus (tree_view);
2669 tree_view->priv->focus_column = column;
2671 /* decide if we edit */
2672 if (event->type == GDK_BUTTON_PRESS && event->button == 1 &&
2673 !(event->state & gtk_accelerator_get_default_mod_mask ()))
2675 GtkTreePath *anchor;
2678 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
2679 gtk_tree_view_column_cell_set_cell_data (column,
2680 tree_view->priv->model,
2682 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
2683 node->children?TRUE:FALSE);
2685 if (tree_view->priv->anchor)
2686 anchor = gtk_tree_row_reference_get_path (tree_view->priv->anchor);
2690 if ((anchor && !gtk_tree_path_compare (anchor, path))
2691 || !_gtk_tree_view_column_has_editable_cell (column))
2693 GtkCellEditable *cell_editable = NULL;
2695 /* FIXME: get the right flags */
2698 path_string = gtk_tree_path_to_string (path);
2700 if (_gtk_tree_view_column_cell_event (column,
2707 if (cell_editable != NULL)
2713 _gtk_tree_view_column_get_neighbor_sizes (column, _gtk_tree_view_column_get_edited_cell (column), &left, &right);
2716 area.width -= right + left;
2718 gtk_tree_view_real_start_editing (tree_view,
2725 g_free (path_string);
2726 gtk_tree_path_free (path);
2727 gtk_tree_path_free (anchor);
2730 column_handled_click = TRUE;
2732 g_free (path_string);
2735 gtk_tree_path_free (anchor);
2739 node_selected = GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED);
2740 pre_val = tree_view->priv->vadjustment->value;
2742 /* we only handle selection modifications on the first button press
2744 if (event->type == GDK_BUTTON_PRESS)
2746 if ((event->state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
2747 tree_view->priv->ctrl_pressed = TRUE;
2748 if ((event->state & GDK_SHIFT_MASK) == GDK_SHIFT_MASK)
2749 tree_view->priv->shift_pressed = TRUE;
2751 focus_cell = _gtk_tree_view_column_get_cell_at_pos (column, event->x - background_area.x);
2753 gtk_tree_view_column_focus_cell (column, focus_cell);
2755 if (event->state & GDK_CONTROL_MASK)
2757 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
2758 gtk_tree_view_real_toggle_cursor_row (tree_view);
2760 else if (event->state & GDK_SHIFT_MASK)
2762 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
2763 gtk_tree_view_real_select_cursor_row (tree_view, FALSE);
2767 gtk_tree_view_real_set_cursor (tree_view, path, TRUE, TRUE);
2770 tree_view->priv->ctrl_pressed = FALSE;
2771 tree_view->priv->shift_pressed = FALSE;
2774 /* the treeview may have been scrolled because of _set_cursor,
2778 aft_val = tree_view->priv->vadjustment->value;
2779 dval = pre_val - aft_val;
2781 cell_area.y += dval;
2782 background_area.y += dval;
2784 /* Save press to possibly begin a drag
2786 if (!column_handled_click &&
2787 !tree_view->priv->in_grab &&
2788 tree_view->priv->pressed_button < 0)
2790 tree_view->priv->pressed_button = event->button;
2791 tree_view->priv->press_start_x = event->x;
2792 tree_view->priv->press_start_y = event->y;
2794 if (tree_view->priv->rubber_banding_enable
2796 && tree_view->priv->selection->type == GTK_SELECTION_MULTIPLE)
2798 tree_view->priv->press_start_y += tree_view->priv->dy;
2799 tree_view->priv->rubber_band_x = event->x;
2800 tree_view->priv->rubber_band_y = event->y + tree_view->priv->dy;
2801 tree_view->priv->rubber_band_status = RUBBER_BAND_MAYBE_START;
2803 if ((event->state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
2804 tree_view->priv->rubber_band_ctrl = TRUE;
2805 if ((event->state & GDK_SHIFT_MASK) == GDK_SHIFT_MASK)
2806 tree_view->priv->rubber_band_shift = TRUE;
2810 /* Test if a double click happened on the same row. */
2811 if (event->button == 1 && event->type == GDK_BUTTON_PRESS)
2813 if (tree_view->priv->last_button_x != -1)
2815 int double_click_time, double_click_distance;
2817 g_object_get (gtk_settings_get_default (),
2818 "gtk-double-click-time", &double_click_time,
2819 "gtk-double-click-distance", &double_click_distance,
2822 /* Same conditions as _gdk_event_button_generate */
2823 if ((event->time < tree_view->priv->last_button_time + double_click_time) &&
2824 (ABS (event->x - tree_view->priv->last_button_x) <= double_click_distance) &&
2825 (ABS (event->y - tree_view->priv->last_button_y) <= double_click_distance))
2827 /* We do no longer compare paths of this row and the
2828 * row clicked previously. We use the double click
2829 * distance to decide whether this is a valid click,
2830 * allowing the mouse to slightly move over another row.
2832 row_double_click = TRUE;
2835 tree_view->priv->last_button_time = 0;
2836 tree_view->priv->last_button_x = -1;
2837 tree_view->priv->last_button_y = -1;
2841 tree_view->priv->last_button_time = event->time;
2842 tree_view->priv->last_button_x = event->x;
2843 tree_view->priv->last_button_y = event->y;
2847 if (row_double_click)
2849 gtk_grab_remove (widget);
2850 gtk_tree_view_row_activated (tree_view, path, column);
2852 if (tree_view->priv->pressed_button == event->button)
2853 tree_view->priv->pressed_button = -1;
2856 gtk_tree_path_free (path);
2858 /* If we activated the row through a double click we don't want to grab
2859 * focus back, as moving focus to another widget is pretty common.
2861 if (!row_double_click)
2862 grab_focus_and_unset_draw_keyfocus (tree_view);
2867 /* We didn't click in the window. Let's check to see if we clicked on a column resize window.
2869 for (i = 0, list = tree_view->priv->columns; list; list = list->next, i++)
2871 column = list->data;
2872 if (event->window == column->window &&
2873 column->resizable &&
2878 if (event->type == GDK_2BUTTON_PRESS &&
2879 gtk_tree_view_column_get_sizing (column) != GTK_TREE_VIEW_COLUMN_AUTOSIZE)
2881 column->use_resized_width = FALSE;
2882 _gtk_tree_view_column_autosize (tree_view, column);
2886 if (gdk_pointer_grab (column->window, FALSE,
2887 GDK_POINTER_MOTION_HINT_MASK |
2888 GDK_BUTTON1_MOTION_MASK |
2889 GDK_BUTTON_RELEASE_MASK,
2890 NULL, NULL, event->time))
2893 gtk_grab_add (widget);
2894 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
2895 column->resized_width = column->width - tree_view->priv->last_extra_space_per_column;
2897 /* block attached dnd signal handler */
2898 drag_data = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2900 g_signal_handlers_block_matched (widget,
2901 G_SIGNAL_MATCH_DATA,
2905 tree_view->priv->drag_pos = i;
2906 tree_view->priv->x_drag = column->button->allocation.x + (rtl ? 0 : column->button->allocation.width);
2908 if (!GTK_WIDGET_HAS_FOCUS (widget))
2909 gtk_widget_grab_focus (widget);
2917 /* GtkWidget::button_release_event helper */
2919 gtk_tree_view_button_release_drag_column (GtkWidget *widget,
2920 GdkEventButton *event)
2922 GtkTreeView *tree_view;
2926 tree_view = GTK_TREE_VIEW (widget);
2928 rtl = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);
2929 gdk_display_pointer_ungrab (gtk_widget_get_display (widget), GDK_CURRENT_TIME);
2930 gdk_display_keyboard_ungrab (gtk_widget_get_display (widget), GDK_CURRENT_TIME);
2932 /* Move the button back */
2933 g_object_ref (tree_view->priv->drag_column->button);
2934 gtk_container_remove (GTK_CONTAINER (tree_view), tree_view->priv->drag_column->button);
2935 gtk_widget_set_parent_window (tree_view->priv->drag_column->button, tree_view->priv->header_window);
2936 gtk_widget_set_parent (tree_view->priv->drag_column->button, GTK_WIDGET (tree_view));
2937 g_object_unref (tree_view->priv->drag_column->button);
2938 gtk_widget_queue_resize (widget);
2939 if (tree_view->priv->drag_column->resizable)
2941 gdk_window_raise (tree_view->priv->drag_column->window);
2942 gdk_window_show (tree_view->priv->drag_column->window);
2945 gdk_window_hide (tree_view->priv->drag_column->window);
2947 gtk_widget_grab_focus (tree_view->priv->drag_column->button);
2951 if (tree_view->priv->cur_reorder &&
2952 tree_view->priv->cur_reorder->right_column != tree_view->priv->drag_column)
2953 gtk_tree_view_move_column_after (tree_view, tree_view->priv->drag_column,
2954 tree_view->priv->cur_reorder->right_column);
2958 if (tree_view->priv->cur_reorder &&
2959 tree_view->priv->cur_reorder->left_column != tree_view->priv->drag_column)
2960 gtk_tree_view_move_column_after (tree_view, tree_view->priv->drag_column,
2961 tree_view->priv->cur_reorder->left_column);
2963 tree_view->priv->drag_column = NULL;
2964 gdk_window_hide (tree_view->priv->drag_window);
2966 for (l = tree_view->priv->column_drag_info; l != NULL; l = l->next)
2967 g_slice_free (GtkTreeViewColumnReorder, l->data);
2968 g_list_free (tree_view->priv->column_drag_info);
2969 tree_view->priv->column_drag_info = NULL;
2970 tree_view->priv->cur_reorder = NULL;
2972 if (tree_view->priv->drag_highlight_window)
2973 gdk_window_hide (tree_view->priv->drag_highlight_window);
2975 /* Reset our flags */
2976 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_UNSET;
2977 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
2982 /* GtkWidget::button_release_event helper */
2984 gtk_tree_view_button_release_column_resize (GtkWidget *widget,
2985 GdkEventButton *event)
2987 GtkTreeView *tree_view;
2990 tree_view = GTK_TREE_VIEW (widget);
2992 tree_view->priv->drag_pos = -1;
2994 /* unblock attached dnd signal handler */
2995 drag_data = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2997 g_signal_handlers_unblock_matched (widget,
2998 G_SIGNAL_MATCH_DATA,
3002 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
3003 gtk_grab_remove (widget);
3004 gdk_display_pointer_ungrab (gdk_drawable_get_display (event->window),
3010 gtk_tree_view_button_release (GtkWidget *widget,
3011 GdkEventButton *event)
3013 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
3015 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
3016 return gtk_tree_view_button_release_drag_column (widget, event);
3018 if (tree_view->priv->rubber_band_status)
3019 gtk_tree_view_stop_rubber_band (tree_view);
3021 if (tree_view->priv->pressed_button == event->button)
3022 tree_view->priv->pressed_button = -1;
3024 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
3025 return gtk_tree_view_button_release_column_resize (widget, event);
3027 if (tree_view->priv->button_pressed_node == NULL)
3030 if (event->button == 1)
3032 gtk_grab_remove (widget);
3033 if (tree_view->priv->button_pressed_node == tree_view->priv->prelight_node &&
3034 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
3036 GtkTreePath *path = NULL;
3038 path = _gtk_tree_view_find_path (tree_view,
3039 tree_view->priv->button_pressed_tree,
3040 tree_view->priv->button_pressed_node);
3041 /* Actually activate the node */
3042 if (tree_view->priv->button_pressed_node->children == NULL)
3043 gtk_tree_view_real_expand_row (tree_view, path,
3044 tree_view->priv->button_pressed_tree,
3045 tree_view->priv->button_pressed_node,
3048 gtk_tree_view_real_collapse_row (GTK_TREE_VIEW (widget), path,
3049 tree_view->priv->button_pressed_tree,
3050 tree_view->priv->button_pressed_node, TRUE);
3051 gtk_tree_path_free (path);
3054 tree_view->priv->button_pressed_tree = NULL;
3055 tree_view->priv->button_pressed_node = NULL;
3062 gtk_tree_view_grab_broken (GtkWidget *widget,
3063 GdkEventGrabBroken *event)
3065 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
3067 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
3068 gtk_tree_view_button_release_drag_column (widget, (GdkEventButton *)event);
3070 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
3071 gtk_tree_view_button_release_column_resize (widget, (GdkEventButton *)event);
3078 gtk_tree_view_configure (GtkWidget *widget,
3079 GdkEventConfigure *event)
3081 GtkTreeView *tree_view;
3083 tree_view = GTK_TREE_VIEW (widget);
3084 tree_view->priv->search_position_func (tree_view, tree_view->priv->search_window);
3090 /* GtkWidget::motion_event function set.
3094 coords_are_over_arrow (GtkTreeView *tree_view,
3097 /* these are in bin window coords */
3104 if (!GTK_WIDGET_REALIZED (tree_view))
3107 if ((node->flags & GTK_RBNODE_IS_PARENT) == 0)
3110 arrow.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
3112 arrow.height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
3114 gtk_tree_view_get_arrow_xrange (tree_view, tree, &arrow.x, &x2);
3116 arrow.width = x2 - arrow.x;
3118 return (x >= arrow.x &&
3119 x < (arrow.x + arrow.width) &&
3121 y < (arrow.y + arrow.height));
3125 auto_expand_timeout (gpointer data)
3127 GtkTreeView *tree_view = GTK_TREE_VIEW (data);
3130 if (tree_view->priv->prelight_node)
3132 path = _gtk_tree_view_find_path (tree_view,
3133 tree_view->priv->prelight_tree,
3134 tree_view->priv->prelight_node);
3136 if (tree_view->priv->prelight_node->children)
3137 gtk_tree_view_collapse_row (tree_view, path);
3139 gtk_tree_view_expand_row (tree_view, path, FALSE);
3141 gtk_tree_path_free (path);
3144 tree_view->priv->auto_expand_timeout = 0;
3150 remove_auto_expand_timeout (GtkTreeView *tree_view)
3152 if (tree_view->priv->auto_expand_timeout != 0)
3154 g_source_remove (tree_view->priv->auto_expand_timeout);
3155 tree_view->priv->auto_expand_timeout = 0;
3160 do_prelight (GtkTreeView *tree_view,
3163 /* these are in bin_window coords */
3167 if (tree_view->priv->prelight_tree == tree &&
3168 tree_view->priv->prelight_node == node)
3170 /* We are still on the same node,
3171 but we might need to take care of the arrow */
3173 if (tree && node && TREE_VIEW_DRAW_EXPANDERS (tree_view))
3175 gboolean over_arrow;
3178 over_arrow = coords_are_over_arrow (tree_view, tree, node, x, y);
3179 flag_set = GTK_TREE_VIEW_FLAG_SET (tree_view,
3180 GTK_TREE_VIEW_ARROW_PRELIT);
3182 if (over_arrow != flag_set)
3185 GTK_TREE_VIEW_SET_FLAG (tree_view,
3186 GTK_TREE_VIEW_ARROW_PRELIT);
3188 GTK_TREE_VIEW_UNSET_FLAG (tree_view,
3189 GTK_TREE_VIEW_ARROW_PRELIT);
3191 gtk_tree_view_draw_arrow (tree_view, tree, node, x, y);
3198 if (tree_view->priv->prelight_tree && tree_view->priv->prelight_node)
3200 /* Unprelight the old node and arrow */
3202 GTK_RBNODE_UNSET_FLAG (tree_view->priv->prelight_node,
3203 GTK_RBNODE_IS_PRELIT);
3205 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT)
3206 && TREE_VIEW_DRAW_EXPANDERS (tree_view))
3208 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
3210 gtk_tree_view_draw_arrow (tree_view,
3211 tree_view->priv->prelight_tree,
3212 tree_view->priv->prelight_node,
3217 _gtk_tree_view_queue_draw_node (tree_view,
3218 tree_view->priv->prelight_tree,
3219 tree_view->priv->prelight_node,
3224 if (tree_view->priv->hover_expand)
3225 remove_auto_expand_timeout (tree_view);
3227 /* Set the new prelight values */
3228 tree_view->priv->prelight_node = node;
3229 tree_view->priv->prelight_tree = tree;
3234 /* Prelight the new node and arrow */
3236 if (TREE_VIEW_DRAW_EXPANDERS (tree_view)
3237 && coords_are_over_arrow (tree_view, tree, node, x, y))
3239 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
3241 gtk_tree_view_draw_arrow (tree_view, tree, node, x, y);
3244 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PRELIT);
3246 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
3248 if (tree_view->priv->hover_expand)
3250 tree_view->priv->auto_expand_timeout =
3251 gdk_threads_add_timeout (AUTO_EXPAND_TIMEOUT, auto_expand_timeout, tree_view);
3256 prelight_or_select (GtkTreeView *tree_view,
3259 /* these are in bin_window coords */
3263 GtkSelectionMode mode = gtk_tree_selection_get_mode (tree_view->priv->selection);
3265 if (tree_view->priv->hover_selection &&
3266 (mode == GTK_SELECTION_SINGLE || mode == GTK_SELECTION_BROWSE) &&
3267 !(tree_view->priv->edited_column &&
3268 tree_view->priv->edited_column->editable_widget))
3272 if (!GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
3276 path = _gtk_tree_view_find_path (tree_view, tree, node);
3277 gtk_tree_selection_select_path (tree_view->priv->selection, path);
3278 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
3280 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
3281 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, FALSE);
3283 gtk_tree_path_free (path);
3287 else if (mode == GTK_SELECTION_SINGLE)
3288 gtk_tree_selection_unselect_all (tree_view->priv->selection);
3291 do_prelight (tree_view, tree, node, x, y);
3295 ensure_unprelighted (GtkTreeView *tree_view)
3297 do_prelight (tree_view,
3299 -1000, -1000); /* coords not possibly over an arrow */
3301 g_assert (tree_view->priv->prelight_node == NULL);
3307 /* Our motion arrow is either a box (in the case of the original spot)
3308 * or an arrow. It is expander_size wide.
3331 gtk_tree_view_motion_draw_column_motion_arrow (GtkTreeView *tree_view)
3333 GtkTreeViewColumnReorder *reorder = tree_view->priv->cur_reorder;
3334 GtkWidget *widget = GTK_WIDGET (tree_view);
3335 GdkBitmap *mask = NULL;
3340 gint arrow_type = DRAG_COLUMN_WINDOW_STATE_UNSET;
3341 GdkWindowAttr attributes;
3342 guint attributes_mask;
3345 reorder->left_column == tree_view->priv->drag_column ||
3346 reorder->right_column == tree_view->priv->drag_column)
3347 arrow_type = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
3348 else if (reorder->left_column || reorder->right_column)
3350 GdkRectangle visible_rect;
3351 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
3352 if (reorder->left_column)
3353 x = reorder->left_column->button->allocation.x + reorder->left_column->button->allocation.width;
3355 x = reorder->right_column->button->allocation.x;
3357 if (x < visible_rect.x)
3358 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT;
3359 else if (x > visible_rect.x + visible_rect.width)
3360 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT;
3362 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW;
3365 /* We want to draw the rectangle over the initial location. */
3366 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
3371 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
3373 if (tree_view->priv->drag_highlight_window)
3375 gdk_window_set_user_data (tree_view->priv->drag_highlight_window,
3377 gdk_window_destroy (tree_view->priv->drag_highlight_window);
3380 attributes.window_type = GDK_WINDOW_CHILD;
3381 attributes.wclass = GDK_INPUT_OUTPUT;
3382 attributes.x = tree_view->priv->drag_column_x;
3384 width = attributes.width = tree_view->priv->drag_column->button->allocation.width;
3385 height = attributes.height = tree_view->priv->drag_column->button->allocation.height;
3386 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
3387 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
3388 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
3389 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
3390 tree_view->priv->drag_highlight_window = gdk_window_new (tree_view->priv->header_window, &attributes, attributes_mask);
3391 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
3393 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
3394 gc = gdk_gc_new (mask);
3396 gdk_gc_set_foreground (gc, &col);
3397 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
3399 gdk_gc_set_foreground(gc, &col);
3400 gdk_draw_rectangle (mask, gc, TRUE, 2, 2, width - 4, height - 4);
3401 g_object_unref (gc);
3403 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
3405 if (mask) g_object_unref (mask);
3406 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
3409 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW)
3415 width = tree_view->priv->expander_size;
3417 /* Get x, y, width, height of arrow */
3418 gdk_window_get_origin (tree_view->priv->header_window, &x, &y);
3419 if (reorder->left_column)
3421 x += reorder->left_column->button->allocation.x + reorder->left_column->button->allocation.width - width/2;
3422 height = reorder->left_column->button->allocation.height;
3426 x += reorder->right_column->button->allocation.x - width/2;
3427 height = reorder->right_column->button->allocation.height;
3429 y -= tree_view->priv->expander_size/2; /* The arrow takes up only half the space */
3430 height += tree_view->priv->expander_size;
3432 /* Create the new window */
3433 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW)
3435 if (tree_view->priv->drag_highlight_window)
3437 gdk_window_set_user_data (tree_view->priv->drag_highlight_window,
3439 gdk_window_destroy (tree_view->priv->drag_highlight_window);
3442 attributes.window_type = GDK_WINDOW_TEMP;
3443 attributes.wclass = GDK_INPUT_OUTPUT;
3444 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
3445 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
3446 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
3447 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
3450 attributes.width = width;
3451 attributes.height = height;
3452 tree_view->priv->drag_highlight_window = gdk_window_new (gtk_widget_get_root_window (widget),
3453 &attributes, attributes_mask);
3454 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
3456 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
3457 gc = gdk_gc_new (mask);
3459 gdk_gc_set_foreground (gc, &col);
3460 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
3462 /* Draw the 2 arrows as per above */
3464 gdk_gc_set_foreground (gc, &col);
3465 for (i = 0; i < width; i ++)
3467 if (i == (width/2 - 1))
3469 gdk_draw_line (mask, gc, i, j, i, height - j);
3470 if (i < (width/2 - 1))
3475 g_object_unref (gc);
3476 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
3478 if (mask) g_object_unref (mask);
3481 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ARROW;
3482 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
3484 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT ||
3485 arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
3491 width = tree_view->priv->expander_size;
3493 /* Get x, y, width, height of arrow */
3494 width = width/2; /* remember, the arrow only takes half the available width */
3495 gdk_window_get_origin (widget->window, &x, &y);
3496 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
3497 x += widget->allocation.width - width;
3499 if (reorder->left_column)
3500 height = reorder->left_column->button->allocation.height;
3502 height = reorder->right_column->button->allocation.height;
3504 y -= tree_view->priv->expander_size;
3505 height += 2*tree_view->priv->expander_size;
3507 /* Create the new window */
3508 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT &&
3509 tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
3511 if (tree_view->priv->drag_highlight_window)
3513 gdk_window_set_user_data (tree_view->priv->drag_highlight_window,
3515 gdk_window_destroy (tree_view->priv->drag_highlight_window);
3518 attributes.window_type = GDK_WINDOW_TEMP;
3519 attributes.wclass = GDK_INPUT_OUTPUT;
3520 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
3521 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
3522 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
3523 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
3526 attributes.width = width;
3527 attributes.height = height;
3528 tree_view->priv->drag_highlight_window = gdk_window_new (NULL, &attributes, attributes_mask);
3529 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
3531 mask = gdk_pixmap_new (tree_view->priv->drag_highlight_window, width, height, 1);
3532 gc = gdk_gc_new (mask);
3534 gdk_gc_set_foreground (gc, &col);
3535 gdk_draw_rectangle (mask, gc, TRUE, 0, 0, width, height);
3537 /* Draw the 2 arrows as per above */
3539 gdk_gc_set_foreground (gc, &col);
3540 j = tree_view->priv->expander_size;
3541 for (i = 0; i < width; i ++)
3544 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT)
3548 gdk_draw_line (mask, gc, k, j, k, height - j);
3549 gdk_draw_line (mask, gc, k, 0, k, tree_view->priv->expander_size - j);
3550 gdk_draw_line (mask, gc, k, height, k, height - tree_view->priv->expander_size + j);
3553 g_object_unref (gc);
3554 gdk_window_shape_combine_mask (tree_view->priv->drag_highlight_window,
3556 if (mask) g_object_unref (mask);
3559 tree_view->priv->drag_column_window_state = arrow_type;
3560 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
3564 g_warning (G_STRLOC"Invalid GtkTreeViewColumnReorder struct");
3565 gdk_window_hide (tree_view->priv->drag_highlight_window);
3569 gdk_window_show (tree_view->priv->drag_highlight_window);
3570 gdk_window_raise (tree_view->priv->drag_highlight_window);
3574 gtk_tree_view_motion_resize_column (GtkWidget *widget,
3575 GdkEventMotion *event)
3579 GtkTreeViewColumn *column;
3580 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
3582 column = gtk_tree_view_get_column (tree_view, tree_view->priv->drag_pos);
3584 if (event->is_hint || event->window != widget->window)
3585 gtk_widget_get_pointer (widget, &x, NULL);
3589 if (tree_view->priv->hadjustment)
3590 x += tree_view->priv->hadjustment->value;
3592 new_width = gtk_tree_view_new_column_width (tree_view,
3593 tree_view->priv->drag_pos, &x);
3594 if (x != tree_view->priv->x_drag &&
3595 (new_width != column->fixed_width))
3597 column->use_resized_width = TRUE;
3598 column->resized_width = new_width;
3600 column->resized_width -= tree_view->priv->last_extra_space_per_column;
3601 gtk_widget_queue_resize (widget);
3609 gtk_tree_view_update_current_reorder (GtkTreeView *tree_view)
3611 GtkTreeViewColumnReorder *reorder = NULL;
3615 gdk_window_get_pointer (tree_view->priv->header_window, &mouse_x, NULL, NULL);
3616 for (list = tree_view->priv->column_drag_info; list; list = list->next)
3618 reorder = (GtkTreeViewColumnReorder *) list->data;
3619 if (mouse_x >= reorder->left_align && mouse_x < reorder->right_align)
3624 /* if (reorder && reorder == tree_view->priv->cur_reorder)
3627 tree_view->priv->cur_reorder = reorder;
3628 gtk_tree_view_motion_draw_column_motion_arrow (tree_view);
3632 gtk_tree_view_vertical_autoscroll (GtkTreeView *tree_view)
3634 GdkRectangle visible_rect;
3639 gdk_window_get_pointer (tree_view->priv->bin_window, NULL, &y, NULL);
3640 y += tree_view->priv->dy;
3642 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
3644 /* see if we are near the edge. */
3645 offset = y - (visible_rect.y + 2 * SCROLL_EDGE_SIZE);
3648 offset = y - (visible_rect.y + visible_rect.height - 2 * SCROLL_EDGE_SIZE);
3653 value = CLAMP (tree_view->priv->vadjustment->value + offset, 0.0,
3654 tree_view->priv->vadjustment->upper - tree_view->priv->vadjustment->page_size);
3655 gtk_adjustment_set_value (tree_view->priv->vadjustment, value);
3659 gtk_tree_view_horizontal_autoscroll (GtkTreeView *tree_view)
3661 GdkRectangle visible_rect;
3666 gdk_window_get_pointer (tree_view->priv->bin_window, &x, NULL, NULL);
3668 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
3670 /* See if we are near the edge. */
3671 offset = x - (visible_rect.x + SCROLL_EDGE_SIZE);
3674 offset = x - (visible_rect.x + visible_rect.width - SCROLL_EDGE_SIZE);
3680 value = CLAMP (tree_view->priv->hadjustment->value + offset,
3681 0.0, tree_view->priv->hadjustment->upper - tree_view->priv->hadjustment->page_size);
3682 gtk_adjustment_set_value (tree_view->priv->hadjustment, value);
3689 gtk_tree_view_motion_drag_column (GtkWidget *widget,
3690 GdkEventMotion *event)
3692 GtkTreeView *tree_view = (GtkTreeView *) widget;
3693 GtkTreeViewColumn *column = tree_view->priv->drag_column;
3697 if ((column == NULL) ||
3698 (event->window != tree_view->priv->drag_window))
3701 /* Handle moving the header */
3702 gdk_window_get_position (tree_view->priv->drag_window, &x, &y);
3703 x = CLAMP (x + (gint)event->x - column->drag_x, 0,
3704 MAX (tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.width) - column->button->allocation.width);
3705 gdk_window_move (tree_view->priv->drag_window, x, y);
3707 /* autoscroll, if needed */
3708 gtk_tree_view_horizontal_autoscroll (tree_view);
3709 /* Update the current reorder position and arrow; */
3710 gtk_tree_view_update_current_reorder (tree_view);
3716 gtk_tree_view_stop_rubber_band (GtkTreeView *tree_view)
3718 remove_scroll_timeout (tree_view);
3719 gtk_grab_remove (GTK_WIDGET (tree_view));
3721 if (tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
3723 GtkTreePath *tmp_path;
3725 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
3727 /* The anchor path should be set to the start path */
3728 tmp_path = _gtk_tree_view_find_path (tree_view,
3729 tree_view->priv->rubber_band_start_tree,
3730 tree_view->priv->rubber_band_start_node);
3732 if (tree_view->priv->anchor)
3733 gtk_tree_row_reference_free (tree_view->priv->anchor);
3735 tree_view->priv->anchor =
3736 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
3737 tree_view->priv->model,
3740 gtk_tree_path_free (tmp_path);
3742 /* ... and the cursor to the end path */
3743 tmp_path = _gtk_tree_view_find_path (tree_view,
3744 tree_view->priv->rubber_band_end_tree,
3745 tree_view->priv->rubber_band_end_node);
3746 gtk_tree_view_real_set_cursor (GTK_TREE_VIEW (tree_view), tmp_path, FALSE, FALSE);
3747 gtk_tree_path_free (tmp_path);
3749 _gtk_tree_selection_emit_changed (tree_view->priv->selection);
3752 /* Clear status variables */
3753 tree_view->priv->rubber_band_status = RUBBER_BAND_OFF;
3754 tree_view->priv->rubber_band_shift = 0;
3755 tree_view->priv->rubber_band_ctrl = 0;
3757 tree_view->priv->rubber_band_start_node = NULL;
3758 tree_view->priv->rubber_band_start_tree = NULL;
3759 tree_view->priv->rubber_band_end_node = NULL;
3760 tree_view->priv->rubber_band_end_tree = NULL;
3764 gtk_tree_view_update_rubber_band_selection_range (GtkTreeView *tree_view,
3765 GtkRBTree *start_tree,
3766 GtkRBNode *start_node,
3767 GtkRBTree *end_tree,
3768 GtkRBNode *end_node,
3770 gboolean skip_start,
3773 if (start_node == end_node)
3776 /* We skip the first node and jump inside the loop */
3782 /* Small optimization by assuming insensitive nodes are never
3785 if (!GTK_RBNODE_FLAG_SET (start_node, GTK_RBNODE_IS_SELECTED))
3788 gboolean selectable;
3790 path = _gtk_tree_view_find_path (tree_view, start_tree, start_node);
3791 selectable = _gtk_tree_selection_row_is_selectable (tree_view->priv->selection, start_node, path);
3792 gtk_tree_path_free (path);
3795 goto node_not_selectable;
3800 if (tree_view->priv->rubber_band_shift)
3801 GTK_RBNODE_SET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3802 else if (tree_view->priv->rubber_band_ctrl)
3804 /* Toggle the selection state */
3805 if (GTK_RBNODE_FLAG_SET (start_node, GTK_RBNODE_IS_SELECTED))
3806 GTK_RBNODE_UNSET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3808 GTK_RBNODE_SET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3811 GTK_RBNODE_SET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3815 /* Mirror the above */
3816 if (tree_view->priv->rubber_band_shift)
3817 GTK_RBNODE_UNSET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3818 else if (tree_view->priv->rubber_band_ctrl)
3820 /* Toggle the selection state */
3821 if (GTK_RBNODE_FLAG_SET (start_node, GTK_RBNODE_IS_SELECTED))
3822 GTK_RBNODE_UNSET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3824 GTK_RBNODE_SET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3827 GTK_RBNODE_UNSET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3830 _gtk_tree_view_queue_draw_node (tree_view, start_tree, start_node, NULL);
3832 node_not_selectable:
3833 if (start_node == end_node)
3838 if (start_node->children)
3840 start_tree = start_node->children;
3841 start_node = start_tree->root;
3842 while (start_node->left != start_tree->nil)
3843 start_node = start_node->left;
3847 _gtk_rbtree_next_full (start_tree, start_node, &start_tree, &start_node);
3850 /* Ran out of tree */
3854 if (skip_end && start_node == end_node)
3861 gtk_tree_view_update_rubber_band_selection (GtkTreeView *tree_view)
3863 GtkRBTree *start_tree, *end_tree;
3864 GtkRBNode *start_node, *end_node;
3866 _gtk_rbtree_find_offset (tree_view->priv->tree, MIN (tree_view->priv->press_start_y, tree_view->priv->rubber_band_y), &start_tree, &start_node);
3867 _gtk_rbtree_find_offset (tree_view->priv->tree, MAX (tree_view->priv->press_start_y, tree_view->priv->rubber_band_y), &end_tree, &end_node);
3869 /* Handle the start area first */
3870 if (!tree_view->priv->rubber_band_start_node)
3872 gtk_tree_view_update_rubber_band_selection_range (tree_view,
3881 else if (_gtk_rbtree_node_find_offset (start_tree, start_node) <
3882 _gtk_rbtree_node_find_offset (tree_view->priv->rubber_band_start_tree, tree_view->priv->rubber_band_start_node))
3884 /* New node is above the old one; selection became bigger */
3885 gtk_tree_view_update_rubber_band_selection_range (tree_view,
3888 tree_view->priv->rubber_band_start_tree,
3889 tree_view->priv->rubber_band_start_node,
3894 else if (_gtk_rbtree_node_find_offset (start_tree, start_node) >
3895 _gtk_rbtree_node_find_offset (tree_view->priv->rubber_band_start_tree, tree_view->priv->rubber_band_start_node))
3897 /* New node is below the old one; selection became smaller */
3898 gtk_tree_view_update_rubber_band_selection_range (tree_view,
3899 tree_view->priv->rubber_band_start_tree,
3900 tree_view->priv->rubber_band_start_node,
3908 tree_view->priv->rubber_band_start_tree = start_tree;
3909 tree_view->priv->rubber_band_start_node = start_node;
3911 /* Next, handle the end area */
3912 if (!tree_view->priv->rubber_band_end_node)
3914 /* In the event this happens, start_node was also NULL; this case is
3920 /* Find the last node in the tree */
3921 _gtk_rbtree_find_offset (tree_view->priv->tree, tree_view->priv->height - 1,
3922 &end_tree, &end_node);
3924 /* Selection reached end of the tree */
3925 gtk_tree_view_update_rubber_band_selection_range (tree_view,
3926 tree_view->priv->rubber_band_end_tree,
3927 tree_view->priv->rubber_band_end_node,
3934 else if (_gtk_rbtree_node_find_offset (end_tree, end_node) >
3935 _gtk_rbtree_node_find_offset (tree_view->priv->rubber_band_end_tree, tree_view->priv->rubber_band_end_node))
3937 /* New node is below the old one; selection became bigger */
3938 gtk_tree_view_update_rubber_band_selection_range (tree_view,
3939 tree_view->priv->rubber_band_end_tree,
3940 tree_view->priv->rubber_band_end_node,
3947 else if (_gtk_rbtree_node_find_offset (end_tree, end_node) <
3948 _gtk_rbtree_node_find_offset (tree_view->priv->rubber_band_end_tree, tree_view->priv->rubber_band_end_node))
3950 /* New node is above the old one; selection became smaller */
3951 gtk_tree_view_update_rubber_band_selection_range (tree_view,
3954 tree_view->priv->rubber_band_end_tree,
3955 tree_view->priv->rubber_band_end_node,
3961 tree_view->priv->rubber_band_end_tree = end_tree;
3962 tree_view->priv->rubber_band_end_node = end_node;
3966 gtk_tree_view_update_rubber_band (GtkTreeView *tree_view)
3969 GdkRectangle old_area;
3970 GdkRectangle new_area;
3971 GdkRectangle common;
3972 GdkRegion *invalid_region;
3974 old_area.x = MIN (tree_view->priv->press_start_x, tree_view->priv->rubber_band_x);
3975 old_area.y = MIN (tree_view->priv->press_start_y, tree_view->priv->rubber_band_y) - tree_view->priv->dy;
3976 old_area.width = ABS (tree_view->priv->rubber_band_x - tree_view->priv->press_start_x) + 1;
3977 old_area.height = ABS (tree_view->priv->rubber_band_y - tree_view->priv->press_start_y) + 1;
3979 gdk_window_get_pointer (tree_view->priv->bin_window, &x, &y, NULL);
3982 y = MAX (y, 0) + tree_view->priv->dy;
3984 new_area.x = MIN (tree_view->priv->press_start_x, x);
3985 new_area.y = MIN (tree_view->priv->press_start_y, y) - tree_view->priv->dy;
3986 new_area.width = ABS (x - tree_view->priv->press_start_x) + 1;
3987 new_area.height = ABS (y - tree_view->priv->press_start_y) + 1;
3989 invalid_region = gdk_region_rectangle (&old_area);
3990 gdk_region_union_with_rect (invalid_region, &new_area);
3992 gdk_rectangle_intersect (&old_area, &new_area, &common);
3993 if (common.width > 2 && common.height > 2)
3995 GdkRegion *common_region;
3997 /* make sure the border is invalidated */
4003 common_region = gdk_region_rectangle (&common);
4005 gdk_region_subtract (invalid_region, common_region);
4006 gdk_region_destroy (common_region);
4009 gdk_window_invalidate_region (tree_view->priv->bin_window, invalid_region, TRUE);
4011 gdk_region_destroy (invalid_region);
4013 tree_view->priv->rubber_band_x = x;
4014 tree_view->priv->rubber_band_y = y;
4016 gtk_tree_view_update_rubber_band_selection (tree_view);
4020 gtk_tree_view_paint_rubber_band (GtkTreeView *tree_view,
4025 GdkRectangle rubber_rect;
4027 rubber_rect.x = MIN (tree_view->priv->press_start_x, tree_view->priv->rubber_band_x);
4028 rubber_rect.y = MIN (tree_view->priv->press_start_y, tree_view->priv->rubber_band_y) - tree_view->priv->dy;
4029 rubber_rect.width = ABS (tree_view->priv->press_start_x - tree_view->priv->rubber_band_x) + 1;
4030 rubber_rect.height = ABS (tree_view->priv->press_start_y - tree_view->priv->rubber_band_y) + 1;
4032 if (!gdk_rectangle_intersect (&rubber_rect, area, &rect))
4035 cr = gdk_cairo_create (tree_view->priv->bin_window);
4036 cairo_set_line_width (cr, 1.0);
4038 cairo_set_source_rgba (cr,
4039 GTK_WIDGET (tree_view)->style->fg[GTK_STATE_NORMAL].red / 65535.,
4040 GTK_WIDGET (tree_view)->style->fg[GTK_STATE_NORMAL].green / 65535.,
4041 GTK_WIDGET (tree_view)->style->fg[GTK_STATE_NORMAL].blue / 65535.,
4044 gdk_cairo_rectangle (cr, &rect);
4048 cairo_set_source_rgb (cr,
4049 GTK_WIDGET (tree_view)->style->fg[GTK_STATE_NORMAL].red / 65535.,
4050 GTK_WIDGET (tree_view)->style->fg[GTK_STATE_NORMAL].green / 65535.,
4051 GTK_WIDGET (tree_view)->style->fg[GTK_STATE_NORMAL].blue / 65535.);
4053 cairo_rectangle (cr,
4054 rubber_rect.x + 0.5, rubber_rect.y + 0.5,
4055 rubber_rect.width - 1, rubber_rect.height - 1);
4062 gtk_tree_view_motion_bin_window (GtkWidget *widget,
4063 GdkEventMotion *event)
4065 GtkTreeView *tree_view;
4070 tree_view = (GtkTreeView *) widget;
4072 if (tree_view->priv->tree == NULL)
4075 if (tree_view->priv->rubber_band_status == RUBBER_BAND_MAYBE_START)
4077 gtk_grab_add (GTK_WIDGET (tree_view));
4078 gtk_tree_view_update_rubber_band (tree_view);
4080 tree_view->priv->rubber_band_status = RUBBER_BAND_ACTIVE;
4082 else if (tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
4084 gtk_tree_view_update_rubber_band (tree_view);
4086 add_scroll_timeout (tree_view);
4089 /* only check for an initiated drag when a button is pressed */
4090 if (tree_view->priv->pressed_button >= 0
4091 && !tree_view->priv->rubber_band_status)
4092 gtk_tree_view_maybe_begin_dragging_row (tree_view, event);
4094 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
4098 _gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
4100 /* If we are currently pressing down a button, we don't want to prelight anything else. */
4101 if ((tree_view->priv->button_pressed_node != NULL) &&
4102 (tree_view->priv->button_pressed_node != node))
4105 prelight_or_select (tree_view, tree, node, event->x, event->y);
4111 gtk_tree_view_motion (GtkWidget *widget,
4112 GdkEventMotion *event)
4114 GtkTreeView *tree_view;
4116 tree_view = (GtkTreeView *) widget;
4118 /* Resizing a column */
4119 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
4120 return gtk_tree_view_motion_resize_column (widget, event);
4123 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
4124 return gtk_tree_view_motion_drag_column (widget, event);
4126 /* Sanity check it */
4127 if (event->window == tree_view->priv->bin_window)
4128 return gtk_tree_view_motion_bin_window (widget, event);
4133 /* Invalidate the focus rectangle near the edge of the bin_window; used when
4134 * the tree is empty.
4137 invalidate_empty_focus (GtkTreeView *tree_view)
4141 if (!GTK_WIDGET_HAS_FOCUS (tree_view))
4146 gdk_drawable_get_size (tree_view->priv->bin_window, &area.width, &area.height);
4147 gdk_window_invalidate_rect (tree_view->priv->bin_window, &area, FALSE);
4150 /* Draws a focus rectangle near the edge of the bin_window; used when the tree
4154 draw_empty_focus (GtkTreeView *tree_view, GdkRectangle *clip_area)
4158 if (!GTK_WIDGET_HAS_FOCUS (tree_view))
4161 gdk_drawable_get_size (tree_view->priv->bin_window, &w, &h);
4167 gtk_paint_focus (GTK_WIDGET (tree_view)->style,
4168 tree_view->priv->bin_window,
4169 GTK_WIDGET_STATE (tree_view),
4171 GTK_WIDGET (tree_view),
4177 gtk_tree_view_draw_grid_lines (GtkTreeView *tree_view,
4178 GdkEventExpose *event,
4179 gint n_visible_columns)
4181 GList *list = tree_view->priv->columns;
4185 if (tree_view->priv->grid_lines != GTK_TREE_VIEW_GRID_LINES_VERTICAL
4186 && tree_view->priv->grid_lines != GTK_TREE_VIEW_GRID_LINES_BOTH)
4189 /* Only draw the lines for visible rows and columns */
4190 for (list = tree_view->priv->columns; list; list = list->next, i++)
4192 GtkTreeViewColumn *column = list->data;
4194 /* We don't want a line for the last column */
4195 if (i == n_visible_columns - 1)
4198 if (! column->visible)
4201 current_x += column->width;
4203 gdk_draw_line (event->window,
4204 tree_view->priv->grid_line_gc,
4206 current_x - 1, tree_view->priv->height);
4210 /* Warning: Very scary function.
4211 * Modify at your own risk
4213 * KEEP IN SYNC WITH gtk_tree_view_create_row_drag_icon()!
4214 * FIXME: It's not...
4217 gtk_tree_view_bin_expose (GtkWidget *widget,
4218 GdkEventExpose *event)
4220 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
4225 GtkRBNode *cursor = NULL;
4226 GtkRBTree *cursor_tree = NULL;
4227 GtkRBNode *drag_highlight = NULL;
4228 GtkRBTree *drag_highlight_tree = NULL;
4231 gint y_offset, cell_offset;
4234 GdkRectangle background_area;
4235 GdkRectangle cell_area;
4238 gint expander_cell_width;
4239 gint bin_window_width;
4240 gint bin_window_height;
4241 GtkTreePath *cursor_path;
4242 GtkTreePath *drag_dest_path;
4243 GList *first_column, *last_column;
4244 gint vertical_separator;
4245 gint horizontal_separator;
4246 gint focus_line_width;
4247 gboolean allow_rules;
4248 gboolean has_special_cell;
4250 gint n_visible_columns;
4251 gint pointer_x, pointer_y;
4252 gint grid_line_width;
4253 gboolean got_pointer = FALSE;
4254 gboolean row_ending_details;
4255 gboolean draw_vgrid_lines, draw_hgrid_lines;
4257 rtl = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);
4259 gtk_widget_style_get (widget,
4260 "horizontal-separator", &horizontal_separator,
4261 "vertical-separator", &vertical_separator,
4262 "allow-rules", &allow_rules,
4263 "focus-line-width", &focus_line_width,
4264 "row-ending-details", &row_ending_details,
4267 if (tree_view->priv->tree == NULL)
4269 draw_empty_focus (tree_view, &event->area);
4273 /* clip event->area to the visible area */
4274 if (event->area.height < 0)
4277 validate_visible_area (tree_view);
4279 new_y = TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, event->area.y);
4283 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
4284 gdk_drawable_get_size (tree_view->priv->bin_window,
4285 &bin_window_width, &bin_window_height);
4287 if (tree_view->priv->height < bin_window_height)
4289 gtk_paint_flat_box (widget->style,
4296 0, tree_view->priv->height,
4298 bin_window_height - tree_view->priv->height);
4304 /* find the path for the node */
4305 path = _gtk_tree_view_find_path ((GtkTreeView *)widget,
4308 gtk_tree_model_get_iter (tree_view->priv->model,
4311 depth = gtk_tree_path_get_depth (path);
4312 gtk_tree_path_free (path);
4315 drag_dest_path = NULL;
4317 if (tree_view->priv->cursor)
4318 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
4321 _gtk_tree_view_find_node (tree_view, cursor_path,
4322 &cursor_tree, &cursor);
4324 if (tree_view->priv->drag_dest_row)
4325 drag_dest_path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
4328 _gtk_tree_view_find_node (tree_view, drag_dest_path,
4329 &drag_highlight_tree, &drag_highlight);
4332 tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_VERTICAL
4333 || tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_BOTH;
4335 tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_HORIZONTAL
4336 || tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_BOTH;
4338 if (draw_vgrid_lines || draw_hgrid_lines)
4339 gtk_widget_style_get (widget, "grid-line-width", &grid_line_width, NULL);
4341 n_visible_columns = 0;
4342 for (list = tree_view->priv->columns; list; list = list->next)
4344 if (! GTK_TREE_VIEW_COLUMN (list->data)->visible)
4346 n_visible_columns ++;
4349 /* Find the last column */
4350 for (last_column = g_list_last (tree_view->priv->columns);
4351 last_column && !(GTK_TREE_VIEW_COLUMN (last_column->data)->visible);
4352 last_column = last_column->prev)
4356 for (first_column = g_list_first (tree_view->priv->columns);
4357 first_column && !(GTK_TREE_VIEW_COLUMN (first_column->data)->visible);
4358 first_column = first_column->next)
4361 /* Actually process the expose event. To do this, we want to
4362 * start at the first node of the event, and walk the tree in
4363 * order, drawing each successive node.
4369 gboolean is_separator = FALSE;
4370 gboolean is_first = FALSE;
4371 gboolean is_last = FALSE;
4373 is_separator = row_is_separator (tree_view, &iter, NULL);
4375 max_height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
4378 highlight_x = 0; /* should match x coord of first cell */
4379 expander_cell_width = 0;
4381 background_area.y = y_offset + event->area.y;
4382 background_area.height = max_height;
4386 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PRELIT))
4387 flags |= GTK_CELL_RENDERER_PRELIT;
4389 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
4390 flags |= GTK_CELL_RENDERER_SELECTED;
4392 parity = _gtk_rbtree_node_find_parity (tree, node);
4394 /* we *need* to set cell data on all cells before the call
4395 * to _has_special_cell, else _has_special_cell() does not
4396 * return a correct value.
4398 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
4400 list = (rtl ? list->prev : list->next))
4402 GtkTreeViewColumn *column = list->data;
4403 gtk_tree_view_column_cell_set_cell_data (column,
4404 tree_view->priv->model,
4406 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
4407 node->children?TRUE:FALSE);
4410 has_special_cell = gtk_tree_view_has_special_cell (tree_view);
4412 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
4414 list = (rtl ? list->prev : list->next))
4416 GtkTreeViewColumn *column = list->data;
4417 const gchar *detail = NULL;
4420 if (!column->visible)
4423 if (cell_offset > event->area.x + event->area.width ||
4424 cell_offset + column->width < event->area.x)
4426 cell_offset += column->width;
4430 if (column->show_sort_indicator)
4431 flags |= GTK_CELL_RENDERER_SORTED;
4433 flags &= ~GTK_CELL_RENDERER_SORTED;
4436 flags |= GTK_CELL_RENDERER_FOCUSED;
4438 flags &= ~GTK_CELL_RENDERER_FOCUSED;
4440 background_area.x = cell_offset;
4441 background_area.width = column->width;
4443 cell_area = background_area;
4444 cell_area.y += vertical_separator / 2;
4445 cell_area.x += horizontal_separator / 2;
4446 cell_area.height -= vertical_separator;
4447 cell_area.width -= horizontal_separator;
4449 if (draw_vgrid_lines)
4451 if (list == first_column)
4453 cell_area.width -= grid_line_width / 2;
4455 else if (list == last_column)
4457 cell_area.x += grid_line_width / 2;
4458 cell_area.width -= grid_line_width / 2;
4462 cell_area.x += grid_line_width / 2;
4463 cell_area.width -= grid_line_width;
4467 if (draw_hgrid_lines)
4469 cell_area.y += grid_line_width / 2;
4470 cell_area.height -= grid_line_width;
4473 if (gdk_region_rect_in (event->region, &background_area) == GDK_OVERLAP_RECTANGLE_OUT)
4475 cell_offset += column->width;
4479 gtk_tree_view_column_cell_set_cell_data (column,
4480 tree_view->priv->model,
4482 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
4483 node->children?TRUE:FALSE);
4485 /* Select the detail for drawing the cell. relevant
4486 * factors are parity, sortedness, and whether to
4489 if (allow_rules && tree_view->priv->has_rules)
4491 if ((flags & GTK_CELL_RENDERER_SORTED) &&
4492 n_visible_columns >= 3)
4495 detail = "cell_odd_ruled_sorted";
4497 detail = "cell_even_ruled_sorted";
4502 detail = "cell_odd_ruled";
4504 detail = "cell_even_ruled";
4509 if ((flags & GTK_CELL_RENDERER_SORTED) &&
4510 n_visible_columns >= 3)
4513 detail = "cell_odd_sorted";
4515 detail = "cell_even_sorted";
4520 detail = "cell_odd";
4522 detail = "cell_even";
4528 if (widget->state == GTK_STATE_INSENSITIVE)
4529 state = GTK_STATE_INSENSITIVE;
4530 else if (flags & GTK_CELL_RENDERER_SELECTED)
4531 state = GTK_STATE_SELECTED;
4533 state = GTK_STATE_NORMAL;
4535 /* Draw background */
4536 if (row_ending_details)
4538 char new_detail[128];
4540 is_first = (rtl ? !list->next : !list->prev);
4541 is_last = (rtl ? !list->prev : !list->next);
4543 /* (I don't like the snprintfs either, but couldn't find a
4546 if (is_first && is_last)
4547 g_snprintf (new_detail, 127, "%s", detail);
4549 g_snprintf (new_detail, 127, "%s_start", detail);
4551 g_snprintf (new_detail, 127, "%s_end", detail);
4553 g_snprintf (new_detail, 128, "%s_middle", detail);
4555 gtk_paint_flat_box (widget->style,
4564 background_area.width,
4565 background_area.height);
4569 gtk_paint_flat_box (widget->style,
4578 background_area.width,
4579 background_area.height);
4582 if (draw_hgrid_lines)
4584 if (background_area.y > 0)
4585 gdk_draw_line (event->window,
4586 tree_view->priv->grid_line_gc,
4587 background_area.x, background_area.y,
4588 background_area.x + background_area.width,
4591 if (y_offset + max_height >= event->area.height)
4592 gdk_draw_line (event->window,
4593 tree_view->priv->grid_line_gc,
4594 background_area.x, background_area.y + max_height,
4595 background_area.x + background_area.width,
4596 background_area.y + max_height);
4599 if (gtk_tree_view_is_expander_column (tree_view, column))
4602 cell_area.x += (depth - 1) * tree_view->priv->level_indentation;
4603 cell_area.width -= (depth - 1) * tree_view->priv->level_indentation;
4605 if (TREE_VIEW_DRAW_EXPANDERS(tree_view))
4608 cell_area.x += depth * tree_view->priv->expander_size;
4609 cell_area.width -= depth * tree_view->priv->expander_size;
4612 /* If we have an expander column, the highlight underline
4613 * starts with that column, so that it indicates which
4614 * level of the tree we're dropping at.
4616 highlight_x = cell_area.x;
4617 expander_cell_width = cell_area.width;
4620 gtk_paint_hline (widget->style,
4627 cell_area.x + cell_area.width,
4628 cell_area.y + cell_area.height / 2);
4630 _gtk_tree_view_column_cell_render (column,
4636 if (TREE_VIEW_DRAW_EXPANDERS(tree_view)
4637 && (node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT)
4641 gdk_window_get_pointer (tree_view->priv->bin_window,
4642 &pointer_x, &pointer_y, NULL);
4646 gtk_tree_view_draw_arrow (GTK_TREE_VIEW (widget),
4649 pointer_x, pointer_y);
4655 gtk_paint_hline (widget->style,
4662 cell_area.x + cell_area.width,
4663 cell_area.y + cell_area.height / 2);
4665 _gtk_tree_view_column_cell_render (column,
4673 if (gtk_tree_view_is_expander_column (tree_view, column) &&
4674 tree_view->priv->tree_lines_enabled)
4676 gint x = background_area.x;
4677 gint mult = rtl ? -1 : 1;
4678 gint y0 = background_area.y;
4679 gint y1 = background_area.y + background_area.height/2;
4680 gint y2 = background_area.y + background_area.height;
4683 x += background_area.width - 1;
4685 if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT
4688 gdk_draw_line (event->window,
4689 tree_view->priv->tree_line_gc,
4690 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4692 x + tree_view->priv->expander_size * (depth - 1.1) * mult,
4697 gdk_draw_line (event->window,
4698 tree_view->priv->tree_line_gc,
4699 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4701 x + tree_view->priv->expander_size * (depth - 0.5) * mult,
4708 GtkRBNode *tmp_node;
4709 GtkRBTree *tmp_tree;
4711 if (!_gtk_rbtree_next (tree, node))
4712 gdk_draw_line (event->window,
4713 tree_view->priv->tree_line_gc,
4714 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4716 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4719 gdk_draw_line (event->window,
4720 tree_view->priv->tree_line_gc,
4721 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4723 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4726 tmp_node = tree->parent_node;
4727 tmp_tree = tree->parent_tree;
4729 for (i = depth - 2; i > 0; i--)
4731 if (_gtk_rbtree_next (tmp_tree, tmp_node))
4732 gdk_draw_line (event->window,
4733 tree_view->priv->tree_line_gc,
4734 x + tree_view->priv->expander_size * (i - 0.5) * mult,
4736 x + tree_view->priv->expander_size * (i - 0.5) * mult,
4739 tmp_node = tmp_tree->parent_node;
4740 tmp_tree = tmp_tree->parent_tree;
4745 if (node == cursor && has_special_cell &&
4746 ((column == tree_view->priv->focus_column &&
4747 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS) &&
4748 GTK_WIDGET_HAS_FOCUS (widget)) ||
4749 (column == tree_view->priv->edited_column)))
4751 _gtk_tree_view_column_cell_draw_focus (column,
4759 cell_offset += column->width;
4762 if (node == drag_highlight)
4764 /* Draw indicator for the drop
4766 gint highlight_y = -1;
4767 GtkRBTree *tree = NULL;
4768 GtkRBNode *node = NULL;
4771 switch (tree_view->priv->drag_dest_pos)
4773 case GTK_TREE_VIEW_DROP_BEFORE:
4774 highlight_y = background_area.y - 1;
4775 if (highlight_y < 0)
4779 case GTK_TREE_VIEW_DROP_AFTER:
4780 highlight_y = background_area.y + background_area.height - 1;
4783 case GTK_TREE_VIEW_DROP_INTO_OR_BEFORE:
4784 case GTK_TREE_VIEW_DROP_INTO_OR_AFTER:
4785 _gtk_tree_view_find_node (tree_view, drag_dest_path, &tree, &node);
4789 gdk_drawable_get_size (tree_view->priv->bin_window,
4792 if (row_ending_details)
4793 gtk_paint_focus (widget->style,
4794 tree_view->priv->bin_window,
4795 GTK_WIDGET_STATE (widget),
4799 ? (is_last ? "treeview-drop-indicator" : "treeview-drop-indicator-left" )
4800 : (is_last ? "treeview-drop-indicator-right" : "tree-view-drop-indicator-middle" )),
4801 0, BACKGROUND_FIRST_PIXEL (tree_view, tree, node)
4802 - focus_line_width / 2,
4803 width, ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node))
4804 - focus_line_width + 1);
4806 gtk_paint_focus (widget->style,
4807 tree_view->priv->bin_window,
4808 GTK_WIDGET_STATE (widget),
4811 "treeview-drop-indicator",
4812 0, BACKGROUND_FIRST_PIXEL (tree_view, tree, node)
4813 - focus_line_width / 2,
4814 width, ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node))
4815 - focus_line_width + 1);
4819 if (highlight_y >= 0)
4821 gdk_draw_line (event->window,
4822 widget->style->fg_gc[GTK_WIDGET_STATE (widget)],
4823 rtl ? highlight_x + expander_cell_width : highlight_x,
4825 rtl ? 0 : bin_window_width,
4830 /* draw the big row-spanning focus rectangle, if needed */
4831 if (!has_special_cell && node == cursor &&
4832 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS) &&
4833 GTK_WIDGET_HAS_FOCUS (widget))
4835 gint tmp_y, tmp_height;
4837 GtkStateType focus_rect_state;
4840 flags & GTK_CELL_RENDERER_SELECTED ? GTK_STATE_SELECTED :
4841 (flags & GTK_CELL_RENDERER_PRELIT ? GTK_STATE_PRELIGHT :
4842 (flags & GTK_CELL_RENDERER_INSENSITIVE ? GTK_STATE_INSENSITIVE :
4845 gdk_drawable_get_size (tree_view->priv->bin_window,
4848 if (draw_hgrid_lines)
4850 tmp_y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node) + grid_line_width / 2;
4851 tmp_height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node)) - grid_line_width;
4855 tmp_y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
4856 tmp_height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
4859 if (row_ending_details)
4860 gtk_paint_focus (widget->style,
4861 tree_view->priv->bin_window,
4866 ? (is_last ? "treeview" : "treeview-left" )
4867 : (is_last ? "treeview-right" : "treeview-middle" )),
4871 gtk_paint_focus (widget->style,
4872 tree_view->priv->bin_window,
4881 y_offset += max_height;
4884 GtkTreeIter parent = iter;
4887 tree = node->children;
4890 g_assert (node != tree->nil);
4892 while (node->left != tree->nil)
4894 has_child = gtk_tree_model_iter_children (tree_view->priv->model,
4900 TREE_VIEW_INTERNAL_ASSERT (has_child, FALSE);
4904 gboolean done = FALSE;
4908 node = _gtk_rbtree_next (tree, node);
4911 gboolean has_next = gtk_tree_model_iter_next (tree_view->priv->model, &iter);
4915 TREE_VIEW_INTERNAL_ASSERT (has_next, FALSE);
4919 GtkTreeIter parent_iter = iter;
4920 gboolean has_parent;
4922 node = tree->parent_node;
4923 tree = tree->parent_tree;
4925 /* we should go to done to free some memory */
4927 has_parent = gtk_tree_model_iter_parent (tree_view->priv->model,
4933 TREE_VIEW_INTERNAL_ASSERT (has_parent, FALSE);
4939 while (y_offset < event->area.height);
4942 gtk_tree_view_draw_grid_lines (tree_view, event, n_visible_columns);
4944 if (tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
4946 GdkRectangle *rectangles;
4949 gdk_region_get_rectangles (event->region,
4953 while (n_rectangles--)
4954 gtk_tree_view_paint_rubber_band (tree_view, &rectangles[n_rectangles]);
4956 g_free (rectangles);
4960 gtk_tree_path_free (cursor_path);
4963 gtk_tree_path_free (drag_dest_path);
4969 gtk_tree_view_expose (GtkWidget *widget,
4970 GdkEventExpose *event)
4972 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
4974 if (event->window == tree_view->priv->bin_window)
4979 retval = gtk_tree_view_bin_expose (widget, event);
4981 /* We can't just chain up to Container::expose as it will try to send the
4982 * event to the headers, so we handle propagating it to our children
4983 * (eg. widgets being edited) ourselves.
4985 tmp_list = tree_view->priv->children;
4988 GtkTreeViewChild *child = tmp_list->data;
4989 tmp_list = tmp_list->next;
4991 gtk_container_propagate_expose (GTK_CONTAINER (tree_view), child->widget, event);
4997 else if (event->window == tree_view->priv->header_window)
5001 for (list = tree_view->priv->columns; list != NULL; list = list->next)
5003 GtkTreeViewColumn *column = list->data;
5005 if (column == tree_view->priv->drag_column)
5008 if (column->visible)
5009 gtk_container_propagate_expose (GTK_CONTAINER (tree_view),
5014 else if (event->window == tree_view->priv->drag_window)
5016 gtk_container_propagate_expose (GTK_CONTAINER (tree_view),
5017 tree_view->priv->drag_column->button,
5031 /* returns 0x1 when no column has been found -- yes it's hackish */
5032 static GtkTreeViewColumn *
5033 gtk_tree_view_get_drop_column (GtkTreeView *tree_view,
5034 GtkTreeViewColumn *column,
5037 GtkTreeViewColumn *left_column = NULL;
5038 GtkTreeViewColumn *cur_column = NULL;
5041 if (!column->reorderable)
5042 return (GtkTreeViewColumn *)0x1;
5044 switch (drop_position)
5047 /* find first column where we can drop */
5048 tmp_list = tree_view->priv->columns;
5049 if (column == GTK_TREE_VIEW_COLUMN (tmp_list->data))
5050 return (GtkTreeViewColumn *)0x1;
5054 g_assert (tmp_list);
5056 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5057 tmp_list = tmp_list->next;
5059 if (left_column && left_column->visible == FALSE)
5062 if (!tree_view->priv->column_drop_func)
5065 if (!tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5067 left_column = cur_column;
5074 if (!tree_view->priv->column_drop_func)
5077 if (tree_view->priv->column_drop_func (tree_view, column, left_column, NULL, tree_view->priv->column_drop_func_data))
5080 return (GtkTreeViewColumn *)0x1;
5084 /* find first column after column where we can drop */
5085 tmp_list = tree_view->priv->columns;
5087 for (; tmp_list; tmp_list = tmp_list->next)
5088 if (GTK_TREE_VIEW_COLUMN (tmp_list->data) == column)
5091 if (!tmp_list || !tmp_list->next)
5092 return (GtkTreeViewColumn *)0x1;
5094 tmp_list = tmp_list->next;
5095 left_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5096 tmp_list = tmp_list->next;
5100 g_assert (tmp_list);
5102 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5103 tmp_list = tmp_list->next;
5105 if (left_column && left_column->visible == FALSE)
5107 left_column = cur_column;
5109 tmp_list = tmp_list->next;
5113 if (!tree_view->priv->column_drop_func)
5116 if (!tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5118 left_column = cur_column;
5125 if (!tree_view->priv->column_drop_func)
5128 if (tree_view->priv->column_drop_func (tree_view, column, left_column, NULL, tree_view->priv->column_drop_func_data))
5131 return (GtkTreeViewColumn *)0x1;
5135 /* find first column before column where we can drop */
5136 tmp_list = tree_view->priv->columns;
5138 for (; tmp_list; tmp_list = tmp_list->next)
5139 if (GTK_TREE_VIEW_COLUMN (tmp_list->data) == column)
5142 if (!tmp_list || !tmp_list->prev)
5143 return (GtkTreeViewColumn *)0x1;
5145 tmp_list = tmp_list->prev;
5146 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5147 tmp_list = tmp_list->prev;
5151 g_assert (tmp_list);
5153 left_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5155 if (left_column && !left_column->visible)
5157 /*if (!tmp_list->prev)
5158 return (GtkTreeViewColumn *)0x1;
5161 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->prev->data);
5162 tmp_list = tmp_list->prev->prev;
5165 cur_column = left_column;
5167 tmp_list = tmp_list->prev;
5171 if (!tree_view->priv->column_drop_func)
5174 if (tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5177 cur_column = left_column;
5178 tmp_list = tmp_list->prev;
5181 if (!tree_view->priv->column_drop_func)
5184 if (tree_view->priv->column_drop_func (tree_view, column, NULL, cur_column, tree_view->priv->column_drop_func_data))
5187 return (GtkTreeViewColumn *)0x1;
5191 /* same as DROP_HOME case, but doing it backwards */
5192 tmp_list = g_list_last (tree_view->priv->columns);
5195 if (column == GTK_TREE_VIEW_COLUMN (tmp_list->data))
5196 return (GtkTreeViewColumn *)0x1;
5200 g_assert (tmp_list);
5202 left_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5204 if (left_column && !left_column->visible)
5206 cur_column = left_column;
5207 tmp_list = tmp_list->prev;
5210 if (!tree_view->priv->column_drop_func)
5213 if (tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5216 cur_column = left_column;
5217 tmp_list = tmp_list->prev;
5220 if (!tree_view->priv->column_drop_func)
5223 if (tree_view->priv->column_drop_func (tree_view, column, NULL, cur_column, tree_view->priv->column_drop_func_data))
5226 return (GtkTreeViewColumn *)0x1;
5230 return (GtkTreeViewColumn *)0x1;
5234 gtk_tree_view_key_press (GtkWidget *widget,
5237 GtkTreeView *tree_view = (GtkTreeView *) widget;
5239 if (tree_view->priv->rubber_band_status)
5241 if (event->keyval == GDK_Escape)
5242 gtk_tree_view_stop_rubber_band (tree_view);
5247 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
5249 if (event->keyval == GDK_Escape)
5251 tree_view->priv->cur_reorder = NULL;
5252 gtk_tree_view_button_release_drag_column (widget, NULL);
5257 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
5259 GList *focus_column;
5262 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
5264 for (focus_column = tree_view->priv->columns;
5266 focus_column = focus_column->next)
5268 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (focus_column->data);
5270 if (GTK_WIDGET_HAS_FOCUS (column->button))
5275 (event->state & GDK_SHIFT_MASK) && (event->state & GDK_MOD1_MASK) &&
5276 (event->keyval == GDK_Left || event->keyval == GDK_KP_Left
5277 || event->keyval == GDK_Right || event->keyval == GDK_KP_Right))
5279 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (focus_column->data);
5281 if (!column->resizable)
5283 gtk_widget_error_bell (widget);
5287 if (event->keyval == (rtl ? GDK_Right : GDK_Left)
5288 || event->keyval == (rtl ? GDK_KP_Right : GDK_KP_Left))
5290 gint old_width = column->resized_width;
5292 column->resized_width = MAX (column->resized_width,
5294 column->resized_width -= 2;
5295 if (column->resized_width < 0)
5296 column->resized_width = 0;
5298 if (column->min_width == -1)
5299 column->resized_width = MAX (column->button->requisition.width,
5300 column->resized_width);
5302 column->resized_width = MAX (column->min_width,
5303 column->resized_width);
5305 if (column->max_width != -1)
5306 column->resized_width = MIN (column->resized_width,
5309 column->use_resized_width = TRUE;
5311 if (column->resized_width != old_width)
5312 gtk_widget_queue_resize (widget);
5314 gtk_widget_error_bell (widget);
5316 else if (event->keyval == (rtl ? GDK_Left : GDK_Right)
5317 || event->keyval == (rtl ? GDK_KP_Left : GDK_KP_Right))
5319 gint old_width = column->resized_width;
5321 column->resized_width = MAX (column->resized_width,
5323 column->resized_width += 2;
5325 if (column->max_width != -1)
5326 column->resized_width = MIN (column->resized_width,
5329 column->use_resized_width = TRUE;
5331 if (column->resized_width != old_width)
5332 gtk_widget_queue_resize (widget);
5334 gtk_widget_error_bell (widget);
5341 (event->state & GDK_MOD1_MASK) &&
5342 (event->keyval == GDK_Left || event->keyval == GDK_KP_Left
5343 || event->keyval == GDK_Right || event->keyval == GDK_KP_Right
5344 || event->keyval == GDK_Home || event->keyval == GDK_KP_Home
5345 || event->keyval == GDK_End || event->keyval == GDK_KP_End))
5347 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (focus_column->data);
5349 if (event->keyval == (rtl ? GDK_Right : GDK_Left)
5350 || event->keyval == (rtl ? GDK_KP_Right : GDK_KP_Left))
5352 GtkTreeViewColumn *col;
5353 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_LEFT);
5354 if (col != (GtkTreeViewColumn *)0x1)
5355 gtk_tree_view_move_column_after (tree_view, column, col);
5357 gtk_widget_error_bell (widget);
5359 else if (event->keyval == (rtl ? GDK_Left : GDK_Right)
5360 || event->keyval == (rtl ? GDK_KP_Left : GDK_KP_Right))
5362 GtkTreeViewColumn *col;
5363 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_RIGHT);
5364 if (col != (GtkTreeViewColumn *)0x1)
5365 gtk_tree_view_move_column_after (tree_view, column, col);
5367 gtk_widget_error_bell (widget);
5369 else if (event->keyval == GDK_Home || event->keyval == GDK_KP_Home)
5371 GtkTreeViewColumn *col;
5372 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_HOME);
5373 if (col != (GtkTreeViewColumn *)0x1)
5374 gtk_tree_view_move_column_after (tree_view, column, col);
5376 gtk_widget_error_bell (widget);
5378 else if (event->keyval == GDK_End || event->keyval == GDK_KP_End)
5380 GtkTreeViewColumn *col;
5381 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_END);
5382 if (col != (GtkTreeViewColumn *)0x1)
5383 gtk_tree_view_move_column_after (tree_view, column, col);
5385 gtk_widget_error_bell (widget);
5392 /* Chain up to the parent class. It handles the keybindings. */
5393 if (GTK_WIDGET_CLASS (gtk_tree_view_parent_class)->key_press_event (widget, event))
5396 if (tree_view->priv->search_entry_avoid_unhandled_binding)
5398 tree_view->priv->search_entry_avoid_unhandled_binding = FALSE;
5402 /* We pass the event to the search_entry. If its text changes, then we start
5403 * the typeahead find capabilities. */
5404 if (GTK_WIDGET_HAS_FOCUS (tree_view)
5405 && tree_view->priv->enable_search
5406 && !tree_view->priv->search_custom_entry_set)
5408 GdkEvent *new_event;
5410 const char *new_text;
5413 gboolean text_modified;
5414 gulong popup_menu_id;
5416 gtk_tree_view_ensure_interactive_directory (tree_view);
5418 /* Make a copy of the current text */
5419 old_text = g_strdup (gtk_entry_get_text (GTK_ENTRY (tree_view->priv->search_entry)));
5420 new_event = gdk_event_copy ((GdkEvent *) event);
5421 g_object_unref (((GdkEventKey *) new_event)->window);
5422 ((GdkEventKey *) new_event)->window = g_object_ref (tree_view->priv->search_window->window);
5423 gtk_widget_realize (tree_view->priv->search_window);
5425 popup_menu_id = g_signal_connect (tree_view->priv->search_entry,
5426 "popup-menu", G_CALLBACK (gtk_true),
5429 /* Move the entry off screen */
5430 screen = gtk_widget_get_screen (GTK_WIDGET (tree_view));
5431 gtk_window_move (GTK_WINDOW (tree_view->priv->search_window),
5432 gdk_screen_get_width (screen) + 1,
5433 gdk_screen_get_height (screen) + 1);
5434 gtk_widget_show (tree_view->priv->search_window);
5436 /* Send the event to the window. If the preedit_changed signal is emitted
5437 * during this event, we will set priv->imcontext_changed */
5438 tree_view->priv->imcontext_changed = FALSE;
5439 retval = gtk_widget_event (tree_view->priv->search_window, new_event);
5440 gdk_event_free (new_event);
5441 gtk_widget_hide (tree_view->priv->search_window);
5443 g_signal_handler_disconnect (tree_view->priv->search_entry,
5446 /* We check to make sure that the entry tried to handle the text, and that
5447 * the text has changed.
5449 new_text = gtk_entry_get_text (GTK_ENTRY (tree_view->priv->search_entry));
5450 text_modified = strcmp (old_text, new_text) != 0;
5452 if (tree_view->priv->imcontext_changed || /* we're in a preedit */
5453 (retval && text_modified)) /* ...or the text was modified */
5455 if (gtk_tree_view_real_start_interactive_search (tree_view, FALSE))
5457 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5462 gtk_entry_set_text (GTK_ENTRY (tree_view->priv->search_entry), "");
5472 gtk_tree_view_key_release (GtkWidget *widget,
5475 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
5477 if (tree_view->priv->rubber_band_status)
5480 return GTK_WIDGET_CLASS (gtk_tree_view_parent_class)->key_release_event (widget, event);
5483 /* FIXME Is this function necessary? Can I get an enter_notify event
5484 * w/o either an expose event or a mouse motion event?
5487 gtk_tree_view_enter_notify (GtkWidget *widget,
5488 GdkEventCrossing *event)
5490 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
5495 /* Sanity check it */
5496 if (event->window != tree_view->priv->bin_window)
5499 if (tree_view->priv->tree == NULL)
5502 if (event->mode == GDK_CROSSING_GRAB ||
5503 event->mode == GDK_CROSSING_GTK_GRAB ||
5504 event->mode == GDK_CROSSING_GTK_UNGRAB ||
5505 event->mode == GDK_CROSSING_STATE_CHANGED)
5508 /* find the node internally */
5509 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
5512 _gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
5514 if ((tree_view->priv->button_pressed_node == NULL) ||
5515 (tree_view->priv->button_pressed_node == node))
5516 prelight_or_select (tree_view, tree, node, event->x, event->y);
5522 gtk_tree_view_leave_notify (GtkWidget *widget,
5523 GdkEventCrossing *event)
5525 GtkTreeView *tree_view;
5527 if (event->mode == GDK_CROSSING_GRAB)
5530 tree_view = GTK_TREE_VIEW (widget);
5532 if (tree_view->priv->prelight_node)
5533 _gtk_tree_view_queue_draw_node (tree_view,
5534 tree_view->priv->prelight_tree,
5535 tree_view->priv->prelight_node,
5538 prelight_or_select (tree_view,
5540 -1000, -1000); /* coords not possibly over an arrow */
5547 gtk_tree_view_focus_out (GtkWidget *widget,
5548 GdkEventFocus *event)
5550 GtkTreeView *tree_view;
5552 tree_view = GTK_TREE_VIEW (widget);
5554 gtk_widget_queue_draw (widget);
5556 /* destroy interactive search dialog */
5557 if (tree_view->priv->search_window)
5558 gtk_tree_view_search_dialog_hide (tree_view->priv->search_window, tree_view);
5564 /* Incremental Reflow
5568 gtk_tree_view_node_queue_redraw (GtkTreeView *tree_view,
5574 y = _gtk_rbtree_node_find_offset (tree, node)
5575 - tree_view->priv->vadjustment->value
5576 + TREE_VIEW_HEADER_HEIGHT (tree_view);
5578 gtk_widget_queue_draw_area (GTK_WIDGET (tree_view),
5580 GTK_WIDGET (tree_view)->allocation.width,
5581 GTK_RBNODE_GET_HEIGHT (node));
5585 node_is_visible (GtkTreeView *tree_view,
5592 y = _gtk_rbtree_node_find_offset (tree, node);
5593 height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
5595 if (y >= tree_view->priv->vadjustment->value &&
5596 y + height <= (tree_view->priv->vadjustment->value
5597 + tree_view->priv->vadjustment->page_size))
5603 /* Returns TRUE if it updated the size
5606 validate_row (GtkTreeView *tree_view,
5612 GtkTreeViewColumn *column;
5613 GList *list, *first_column, *last_column;
5615 gint horizontal_separator;
5616 gint vertical_separator;
5617 gint focus_line_width;
5618 gint depth = gtk_tree_path_get_depth (path);
5619 gboolean retval = FALSE;
5620 gboolean is_separator = FALSE;
5621 gboolean draw_vgrid_lines, draw_hgrid_lines;
5623 gint grid_line_width;
5624 gboolean wide_separators;
5625 gint separator_height;
5627 /* double check the row needs validating */
5628 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) &&
5629 ! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
5632 is_separator = row_is_separator (tree_view, iter, NULL);
5634 gtk_widget_style_get (GTK_WIDGET (tree_view),
5635 "focus-padding", &focus_pad,
5636 "focus-line-width", &focus_line_width,
5637 "horizontal-separator", &horizontal_separator,
5638 "vertical-separator", &vertical_separator,
5639 "grid-line-width", &grid_line_width,
5640 "wide-separators", &wide_separators,
5641 "separator-height", &separator_height,
5645 tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_VERTICAL
5646 || tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_BOTH;
5648 tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_HORIZONTAL
5649 || tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_BOTH;
5651 for (last_column = g_list_last (tree_view->priv->columns);
5652 last_column && !(GTK_TREE_VIEW_COLUMN (last_column->data)->visible);
5653 last_column = last_column->prev)
5656 for (first_column = g_list_first (tree_view->priv->columns);
5657 first_column && !(GTK_TREE_VIEW_COLUMN (first_column->data)->visible);
5658 first_column = first_column->next)
5661 for (list = tree_view->priv->columns; list; list = list->next)
5663 GtkTreeViewColumnPrivate *column_priv;
5664 GtkRequisition requested_size;
5665 GtkRequisition natural_size;
5668 column = list->data;
5669 column_priv = GTK_TREE_VIEW_COLUMN_GET_PRIVATE (column);
5671 if (! column->visible)
5674 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID) && !column->dirty)
5677 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter,
5678 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
5679 node->children?TRUE:FALSE);
5680 gtk_tree_view_column_cell_get_size (column,
5682 &requested_size.width,
5683 &requested_size.height);
5684 gtk_extended_layout_get_desired_size (GTK_EXTENDED_LAYOUT (column),
5685 NULL, &natural_size);
5689 requested_size.height += vertical_separator;
5690 height = MAX (height, requested_size.height);
5691 height = MAX (height, tree_view->priv->expander_size);
5695 if (wide_separators)
5696 height = separator_height + 2 * focus_pad;
5698 height = 2 + 2 * focus_pad;
5701 if (gtk_tree_view_is_expander_column (tree_view, column))
5703 padding = horizontal_separator + (depth - 1) * tree_view->priv->level_indentation;
5705 if (TREE_VIEW_DRAW_EXPANDERS (tree_view))
5706 padding += depth * tree_view->priv->expander_size;
5709 padding = horizontal_separator;
5711 if (draw_vgrid_lines)
5713 if (list->data == first_column || list->data == last_column)
5714 padding += grid_line_width / 2.0;
5716 padding += grid_line_width;
5719 requested_size.width += padding;
5720 natural_size.width += padding;
5722 if (requested_size.width > column->requested_width ||
5723 natural_size.width > column_priv->natural_width)
5726 column->requested_width = requested_size.width;
5727 column_priv->natural_width = natural_size.width;
5731 if (draw_hgrid_lines)
5732 height += grid_line_width;
5734 if (height != GTK_RBNODE_GET_HEIGHT (node))
5737 _gtk_rbtree_node_set_height (tree, node, height);
5739 _gtk_rbtree_node_mark_valid (tree, node);
5740 tree_view->priv->post_validation_flag = TRUE;
5747 validate_visible_area (GtkTreeView *tree_view)
5749 GtkTreePath *path = NULL;
5750 GtkTreePath *above_path = NULL;
5752 GtkRBTree *tree = NULL;
5753 GtkRBNode *node = NULL;
5754 gboolean need_redraw = FALSE;
5755 gboolean size_changed = FALSE;
5757 gint area_above = 0;
5758 gint area_below = 0;
5760 if (tree_view->priv->tree == NULL)
5763 if (! GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID) &&
5764 tree_view->priv->scroll_to_path == NULL)
5767 total_height = GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
5769 if (total_height == 0)
5772 /* First, we check to see if we need to scroll anywhere
5774 if (tree_view->priv->scroll_to_path)
5776 path = gtk_tree_row_reference_get_path (tree_view->priv->scroll_to_path);
5777 if (path && !_gtk_tree_view_find_node (tree_view, path, &tree, &node))
5779 /* we are going to scroll, and will update dy */
5780 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
5781 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
5782 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
5784 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
5785 if (validate_row (tree_view, tree, node, &iter, path))
5786 size_changed = TRUE;
5789 if (tree_view->priv->scroll_to_use_align)
5791 gint height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
5792 area_above = (total_height - height) *
5793 tree_view->priv->scroll_to_row_align;
5794 area_below = total_height - area_above - height;
5795 area_above = MAX (area_above, 0);
5796 area_below = MAX (area_below, 0);
5801 * 1) row not visible
5805 gint height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
5807 dy = _gtk_rbtree_node_find_offset (tree, node);
5809 if (dy >= tree_view->priv->vadjustment->value &&
5810 dy + height <= (tree_view->priv->vadjustment->value
5811 + tree_view->priv->vadjustment->page_size))
5813 /* row visible: keep the row at the same position */
5814 area_above = dy - tree_view->priv->vadjustment->value;
5815 area_below = (tree_view->priv->vadjustment->value +
5816 tree_view->priv->vadjustment->page_size)
5821 /* row not visible */
5823 && dy + height <= tree_view->priv->vadjustment->page_size)
5825 /* row at the beginning -- fixed */
5827 area_below = tree_view->priv->vadjustment->page_size
5828 - area_above - height;
5830 else if (dy >= (tree_view->priv->vadjustment->upper -
5831 tree_view->priv->vadjustment->page_size))
5833 /* row at the end -- fixed */
5834 area_above = dy - (tree_view->priv->vadjustment->upper -
5835 tree_view->priv->vadjustment->page_size);
5836 area_below = tree_view->priv->vadjustment->page_size -
5837 area_above - height;
5841 area_above = tree_view->priv->vadjustment->page_size - height;
5847 /* row somewhere in the middle, bring it to the top
5851 area_below = total_height - height;
5857 /* the scroll to isn't valid; ignore it.
5860 if (tree_view->priv->scroll_to_path && !path)
5862 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
5863 tree_view->priv->scroll_to_path = NULL;
5866 gtk_tree_path_free (path);
5871 /* We didn't have a scroll_to set, so we just handle things normally
5877 offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
5878 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, 0),
5882 /* In this case, nothing has been validated */
5883 path = gtk_tree_path_new_first ();
5884 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
5888 path = _gtk_tree_view_find_path (tree_view, tree, node);
5889 total_height += offset;
5892 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
5894 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
5895 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
5897 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
5898 if (validate_row (tree_view, tree, node, &iter, path))
5899 size_changed = TRUE;
5902 area_below = total_height - ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
5905 above_path = gtk_tree_path_copy (path);
5907 /* if we do not validate any row above the new top_row, we will make sure
5908 * that the row immediately above top_row has been validated. (if we do not
5909 * do this, _gtk_rbtree_find_offset will find the row above top_row, because
5910 * when invalidated that row's height will be zero. and this will mess up
5913 if (area_above == 0)
5918 _gtk_tree_view_find_node (tree_view, above_path, &tmptree, &tmpnode);
5919 _gtk_rbtree_prev_full (tmptree, tmpnode, &tmptree, &tmpnode);
5923 GtkTreePath *tmppath;
5924 GtkTreeIter tmpiter;
5926 tmppath = _gtk_tree_view_find_path (tree_view, tmptree, tmpnode);
5927 gtk_tree_model_get_iter (tree_view->priv->model, &tmpiter, tmppath);
5929 if (GTK_RBNODE_FLAG_SET (tmpnode, GTK_RBNODE_INVALID) ||
5930 GTK_RBNODE_FLAG_SET (tmpnode, GTK_RBNODE_COLUMN_INVALID))
5932 _gtk_tree_view_queue_draw_node (tree_view, tmptree, tmpnode, NULL);
5933 if (validate_row (tree_view, tmptree, tmpnode, &tmpiter, tmppath))
5934 size_changed = TRUE;
5937 gtk_tree_path_free (tmppath);
5941 /* Now, we walk forwards and backwards, measuring rows. Unfortunately,
5942 * backwards is much slower then forward, as there is no iter_prev function.
5943 * We go forwards first in case we run out of tree. Then we go backwards to
5946 while (node && area_below > 0)
5950 GtkTreeIter parent = iter;
5953 tree = node->children;
5956 g_assert (node != tree->nil);
5958 while (node->left != tree->nil)
5960 has_child = gtk_tree_model_iter_children (tree_view->priv->model,
5963 TREE_VIEW_INTERNAL_ASSERT_VOID (has_child);
5964 gtk_tree_path_down (path);
5968 gboolean done = FALSE;
5971 node = _gtk_rbtree_next (tree, node);
5974 gboolean has_next = gtk_tree_model_iter_next (tree_view->priv->model, &iter);
5976 gtk_tree_path_next (path);
5979 TREE_VIEW_INTERNAL_ASSERT_VOID (has_next);
5983 GtkTreeIter parent_iter = iter;
5984 gboolean has_parent;
5986 node = tree->parent_node;
5987 tree = tree->parent_tree;
5990 has_parent = gtk_tree_model_iter_parent (tree_view->priv->model,
5993 gtk_tree_path_up (path);
5996 TREE_VIEW_INTERNAL_ASSERT_VOID (has_parent);
6005 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
6006 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
6008 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
6009 if (validate_row (tree_view, tree, node, &iter, path))
6010 size_changed = TRUE;
6013 area_below -= ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
6015 gtk_tree_path_free (path);
6017 /* If we ran out of tree, and have extra area_below left, we need to add it
6020 area_above += area_below;
6022 _gtk_tree_view_find_node (tree_view, above_path, &tree, &node);
6024 /* We walk backwards */
6025 while (area_above > 0)
6027 _gtk_rbtree_prev_full (tree, node, &tree, &node);
6029 /* Always find the new path in the tree. We cannot just assume
6030 * a gtk_tree_path_prev() is enough here, as there might be children
6031 * in between this node and the previous sibling node. If this
6032 * appears to be a performance hotspot in profiles, we can look into
6033 * intrigate logic for keeping path, node and iter in sync like
6034 * we do for forward walks. (Which will be hard because of the lacking
6041 gtk_tree_path_free (above_path);
6042 above_path = _gtk_tree_view_find_path (tree_view, tree, node);
6044 gtk_tree_model_get_iter (tree_view->priv->model, &iter, above_path);
6046 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
6047 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
6049 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
6050 if (validate_row (tree_view, tree, node, &iter, above_path))
6051 size_changed = TRUE;
6053 area_above -= ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
6056 /* if we scrolled to a path, we need to set the dy here,
6057 * and sync the top row accordingly
6059 if (tree_view->priv->scroll_to_path)
6061 gtk_tree_view_set_top_row (tree_view, above_path, -area_above);
6062 gtk_tree_view_top_row_to_dy (tree_view);
6066 else if (tree_view->priv->height <= tree_view->priv->vadjustment->page_size)
6068 /* when we are not scrolling, we should never set dy to something
6069 * else than zero. we update top_row to be in sync with dy = 0.
6071 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment), 0);
6072 gtk_tree_view_dy_to_top_row (tree_view);
6074 else if (tree_view->priv->vadjustment->value + tree_view->priv->vadjustment->page_size > tree_view->priv->height)
6076 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment), tree_view->priv->height - tree_view->priv->vadjustment->page_size);
6077 gtk_tree_view_dy_to_top_row (tree_view);
6080 gtk_tree_view_top_row_to_dy (tree_view);
6082 /* update width/height and queue a resize */
6085 GtkRequisition requisition;
6087 /* We temporarily guess a size, under the assumption that it will be the
6088 * same when we get our next size_allocate. If we don't do this, we'll be
6089 * in an inconsistent state if we call top_row_to_dy. */
6091 gtk_widget_size_request (GTK_WIDGET (tree_view), &requisition);
6092 tree_view->priv->hadjustment->upper = MAX (tree_view->priv->hadjustment->upper, (gfloat)requisition.width);
6093 tree_view->priv->vadjustment->upper = MAX (tree_view->priv->vadjustment->upper, (gfloat)requisition.height);
6094 gtk_adjustment_changed (tree_view->priv->hadjustment);
6095 gtk_adjustment_changed (tree_view->priv->vadjustment);
6096 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6099 if (tree_view->priv->scroll_to_path)
6101 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
6102 tree_view->priv->scroll_to_path = NULL;
6106 gtk_tree_path_free (above_path);
6108 if (tree_view->priv->scroll_to_column)
6110 tree_view->priv->scroll_to_column = NULL;
6113 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
6117 initialize_fixed_height_mode (GtkTreeView *tree_view)
6119 if (!tree_view->priv->tree)
6122 if (tree_view->priv->fixed_height < 0)
6127 GtkRBTree *tree = NULL;
6128 GtkRBNode *node = NULL;
6130 tree = tree_view->priv->tree;
6133 path = _gtk_tree_view_find_path (tree_view, tree, node);
6134 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
6136 validate_row (tree_view, tree, node, &iter, path);
6138 gtk_tree_path_free (path);
6140 tree_view->priv->fixed_height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
6143 _gtk_rbtree_set_fixed_height (tree_view->priv->tree,
6144 tree_view->priv->fixed_height, TRUE);
6147 /* Our strategy for finding nodes to validate is a little convoluted. We find
6148 * the left-most uninvalidated node. We then try walking right, validating
6149 * nodes. Once we find a valid node, we repeat the previous process of finding
6150 * the first invalid node.
6154 do_validate_rows (GtkTreeView *tree_view, gboolean queue_resize)
6156 GtkRBTree *tree = NULL;
6157 GtkRBNode *node = NULL;
6158 gboolean validated_area = FALSE;
6160 GtkTreePath *path = NULL;
6165 gint prev_height = -1;
6166 gboolean fixed_height = TRUE;
6168 g_assert (tree_view);
6170 if (tree_view->priv->tree == NULL)
6173 if (tree_view->priv->fixed_height_mode)
6175 if (tree_view->priv->fixed_height < 0)
6176 initialize_fixed_height_mode (tree_view);
6181 timer = g_timer_new ();
6182 g_timer_start (timer);
6186 if (! GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID))
6194 node = _gtk_rbtree_next (tree, node);
6197 TREE_VIEW_INTERNAL_ASSERT (gtk_tree_model_iter_next (tree_view->priv->model, &iter), FALSE);
6198 gtk_tree_path_next (path);
6202 gtk_tree_path_free (path);
6209 tree = tree_view->priv->tree;
6210 node = tree_view->priv->tree->root;
6212 g_assert (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_DESCENDANTS_INVALID));
6216 if (node->left != tree->nil &&
6217 GTK_RBNODE_FLAG_SET (node->left, GTK_RBNODE_DESCENDANTS_INVALID))
6221 else if (node->right != tree->nil &&
6222 GTK_RBNODE_FLAG_SET (node->right, GTK_RBNODE_DESCENDANTS_INVALID))
6226 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
6227 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
6231 else if (node->children != NULL)
6233 tree = node->children;
6237 /* RBTree corruption! All bad */
6238 g_assert_not_reached ();
6241 path = _gtk_tree_view_find_path (tree_view, tree, node);
6242 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
6245 validated_area = validate_row (tree_view, tree, node, &iter, path) ||
6248 if (!tree_view->priv->fixed_height_check)
6252 height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
6253 if (prev_height < 0)
6254 prev_height = height;
6255 else if (prev_height != height)
6256 fixed_height = FALSE;
6261 while (g_timer_elapsed (timer, NULL) < GTK_TREE_VIEW_TIME_MS_PER_IDLE / 1000.);
6263 if (!tree_view->priv->fixed_height_check)
6266 _gtk_rbtree_set_fixed_height (tree_view->priv->tree, prev_height, FALSE);
6268 tree_view->priv->fixed_height_check = 1;
6274 GtkRequisition requisition;
6275 /* We temporarily guess a size, under the assumption that it will be the
6276 * same when we get our next size_allocate. If we don't do this, we'll be
6277 * in an inconsistent state when we call top_row_to_dy. */
6279 gtk_widget_size_request (GTK_WIDGET (tree_view), &requisition);
6280 tree_view->priv->hadjustment->upper = MAX (tree_view->priv->hadjustment->upper, (gfloat)requisition.width);
6281 tree_view->priv->vadjustment->upper = MAX (tree_view->priv->vadjustment->upper, (gfloat)requisition.height);
6282 gtk_adjustment_changed (tree_view->priv->hadjustment);
6283 gtk_adjustment_changed (tree_view->priv->vadjustment);
6286 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6289 if (path) gtk_tree_path_free (path);
6290 g_timer_destroy (timer);
6296 validate_rows (GtkTreeView *tree_view)
6300 retval = do_validate_rows (tree_view, TRUE);
6302 if (! retval && tree_view->priv->validate_rows_timer)
6304 g_source_remove (tree_view->priv->validate_rows_timer);
6305 tree_view->priv->validate_rows_timer = 0;
6312 validate_rows_handler (GtkTreeView *tree_view)
6316 retval = do_validate_rows (tree_view, TRUE);
6317 if (! retval && tree_view->priv->validate_rows_timer)
6319 g_source_remove (tree_view->priv->validate_rows_timer);
6320 tree_view->priv->validate_rows_timer = 0;
6327 do_presize_handler (GtkTreeView *tree_view)
6329 if (tree_view->priv->mark_rows_col_dirty)
6331 if (tree_view->priv->tree)
6332 _gtk_rbtree_column_invalid (tree_view->priv->tree);
6333 tree_view->priv->mark_rows_col_dirty = FALSE;
6335 validate_visible_area (tree_view);
6336 tree_view->priv->presize_handler_timer = 0;
6338 if (tree_view->priv->fixed_height_mode)
6340 GtkRequisition requisition;
6342 gtk_widget_size_request (GTK_WIDGET (tree_view), &requisition);
6344 tree_view->priv->hadjustment->upper = MAX (tree_view->priv->hadjustment->upper, (gfloat)requisition.width);
6345 tree_view->priv->vadjustment->upper = MAX (tree_view->priv->vadjustment->upper, (gfloat)requisition.height);
6346 gtk_adjustment_changed (tree_view->priv->hadjustment);
6347 gtk_adjustment_changed (tree_view->priv->vadjustment);
6348 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6355 presize_handler_callback (gpointer data)
6357 do_presize_handler (GTK_TREE_VIEW (data));
6363 install_presize_handler (GtkTreeView *tree_view)
6365 if (! GTK_WIDGET_REALIZED (tree_view))
6368 if (! tree_view->priv->presize_handler_timer)
6370 tree_view->priv->presize_handler_timer =
6371 gdk_threads_add_idle_full (GTK_PRIORITY_RESIZE - 2, presize_handler_callback, tree_view, NULL);
6373 if (! tree_view->priv->validate_rows_timer)
6375 tree_view->priv->validate_rows_timer =
6376 gdk_threads_add_idle_full (GTK_TREE_VIEW_PRIORITY_VALIDATE, (GSourceFunc) validate_rows_handler, tree_view, NULL);
6381 scroll_sync_handler (GtkTreeView *tree_view)
6383 if (tree_view->priv->height <= tree_view->priv->vadjustment->page_size)
6384 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment), 0);
6385 else if (gtk_tree_row_reference_valid (tree_view->priv->top_row))
6386 gtk_tree_view_top_row_to_dy (tree_view);
6388 gtk_tree_view_dy_to_top_row (tree_view);
6390 tree_view->priv->scroll_sync_timer = 0;
6396 install_scroll_sync_handler (GtkTreeView *tree_view)
6398 if (! GTK_WIDGET_REALIZED (tree_view))
6401 if (!tree_view->priv->scroll_sync_timer)
6403 tree_view->priv->scroll_sync_timer =
6404 gdk_threads_add_idle_full (GTK_TREE_VIEW_PRIORITY_SCROLL_SYNC, (GSourceFunc) scroll_sync_handler, tree_view, NULL);
6409 gtk_tree_view_set_top_row (GtkTreeView *tree_view,
6413 gtk_tree_row_reference_free (tree_view->priv->top_row);
6417 tree_view->priv->top_row = NULL;
6418 tree_view->priv->top_row_dy = 0;
6422 tree_view->priv->top_row = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
6423 tree_view->priv->top_row_dy = offset;
6427 /* Always call this iff dy is in the visible range. If the tree is empty, then
6428 * it's set to be NULL, and top_row_dy is 0;
6431 gtk_tree_view_dy_to_top_row (GtkTreeView *tree_view)
6438 if (tree_view->priv->tree == NULL)
6440 gtk_tree_view_set_top_row (tree_view, NULL, 0);
6444 offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
6445 tree_view->priv->dy,
6450 tree_view->priv->top_row = NULL;
6451 tree_view->priv->top_row_dy = 0;
6455 path = _gtk_tree_view_find_path (tree_view, tree, node);
6456 gtk_tree_view_set_top_row (tree_view, path, offset);
6457 gtk_tree_path_free (path);
6463 gtk_tree_view_top_row_to_dy (GtkTreeView *tree_view)
6470 /* Avoid recursive calls */
6471 if (tree_view->priv->in_top_row_to_dy)
6474 if (tree_view->priv->top_row)
6475 path = gtk_tree_row_reference_get_path (tree_view->priv->top_row);
6482 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
6485 gtk_tree_path_free (path);
6489 /* keep dy and set new toprow */
6490 gtk_tree_row_reference_free (tree_view->priv->top_row);
6491 tree_view->priv->top_row = NULL;
6492 tree_view->priv->top_row_dy = 0;
6493 /* DO NOT install the idle handler */
6494 gtk_tree_view_dy_to_top_row (tree_view);
6498 if (ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node))
6499 < tree_view->priv->top_row_dy)
6501 /* new top row -- do NOT install the idle handler */
6502 gtk_tree_view_dy_to_top_row (tree_view);
6506 new_dy = _gtk_rbtree_node_find_offset (tree, node);
6507 new_dy += tree_view->priv->top_row_dy;
6509 if (new_dy + tree_view->priv->vadjustment->page_size > tree_view->priv->height)
6510 new_dy = tree_view->priv->height - tree_view->priv->vadjustment->page_size;
6512 new_dy = MAX (0, new_dy);
6514 tree_view->priv->in_top_row_to_dy = TRUE;
6515 gtk_adjustment_set_value (tree_view->priv->vadjustment, (gdouble)new_dy);
6516 tree_view->priv->in_top_row_to_dy = FALSE;
6521 _gtk_tree_view_install_mark_rows_col_dirty (GtkTreeView *tree_view)
6523 tree_view->priv->mark_rows_col_dirty = TRUE;
6525 install_presize_handler (tree_view);
6529 * This function works synchronously (due to the while (validate_rows...)
6532 * There was a check for column_type != GTK_TREE_VIEW_COLUMN_AUTOSIZE
6533 * here. You now need to check that yourself.
6536 _gtk_tree_view_column_autosize (GtkTreeView *tree_view,
6537 GtkTreeViewColumn *column)
6539 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6540 g_return_if_fail (GTK_IS_TREE_VIEW_COLUMN (column));
6542 _gtk_tree_view_column_cell_set_dirty (column, FALSE);
6544 do_presize_handler (tree_view);
6545 while (validate_rows (tree_view));
6547 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6553 set_source_row (GdkDragContext *context,
6554 GtkTreeModel *model,
6555 GtkTreePath *source_row)
6557 g_object_set_data_full (G_OBJECT (context),
6558 I_("gtk-tree-view-source-row"),
6559 source_row ? gtk_tree_row_reference_new (model, source_row) : NULL,
6560 (GDestroyNotify) (source_row ? gtk_tree_row_reference_free : NULL));
6564 get_source_row (GdkDragContext *context)
6566 GtkTreeRowReference *ref =
6567 g_object_get_data (G_OBJECT (context), "gtk-tree-view-source-row");
6570 return gtk_tree_row_reference_get_path (ref);
6577 GtkTreeRowReference *dest_row;
6578 guint path_down_mode : 1;
6579 guint empty_view_drop : 1;
6580 guint drop_append_mode : 1;
6585 dest_row_free (gpointer data)
6587 DestRow *dr = (DestRow *)data;
6589 gtk_tree_row_reference_free (dr->dest_row);
6590 g_slice_free (DestRow, dr);
6594 set_dest_row (GdkDragContext *context,
6595 GtkTreeModel *model,
6596 GtkTreePath *dest_row,
6597 gboolean path_down_mode,
6598 gboolean empty_view_drop,
6599 gboolean drop_append_mode)
6605 g_object_set_data_full (G_OBJECT (context), I_("gtk-tree-view-dest-row"),
6610 dr = g_slice_new (DestRow);
6612 dr->dest_row = gtk_tree_row_reference_new (model, dest_row);
6613 dr->path_down_mode = path_down_mode != FALSE;
6614 dr->empty_view_drop = empty_view_drop != FALSE;
6615 dr->drop_append_mode = drop_append_mode != FALSE;
6617 g_object_set_data_full (G_OBJECT (context), I_("gtk-tree-view-dest-row"),
6618 dr, (GDestroyNotify) dest_row_free);
6622 get_dest_row (GdkDragContext *context,
6623 gboolean *path_down_mode)
6626 g_object_get_data (G_OBJECT (context), "gtk-tree-view-dest-row");
6630 GtkTreePath *path = NULL;
6633 *path_down_mode = dr->path_down_mode;
6636 path = gtk_tree_row_reference_get_path (dr->dest_row);
6637 else if (dr->empty_view_drop)
6638 path = gtk_tree_path_new_from_indices (0, -1);
6642 if (path && dr->drop_append_mode)
6643 gtk_tree_path_next (path);
6651 /* Get/set whether drag_motion requested the drag data and
6652 * drag_data_received should thus not actually insert the data,
6653 * since the data doesn't result from a drop.
6656 set_status_pending (GdkDragContext *context,
6657 GdkDragAction suggested_action)
6659 g_object_set_data (G_OBJECT (context),
6660 I_("gtk-tree-view-status-pending"),
6661 GINT_TO_POINTER (suggested_action));
6664 static GdkDragAction
6665 get_status_pending (GdkDragContext *context)
6667 return GPOINTER_TO_INT (g_object_get_data (G_OBJECT (context),
6668 "gtk-tree-view-status-pending"));
6671 static TreeViewDragInfo*
6672 get_info (GtkTreeView *tree_view)
6674 return g_object_get_data (G_OBJECT (tree_view), "gtk-tree-view-drag-info");
6678 destroy_info (TreeViewDragInfo *di)
6680 g_slice_free (TreeViewDragInfo, di);
6683 static TreeViewDragInfo*
6684 ensure_info (GtkTreeView *tree_view)
6686 TreeViewDragInfo *di;
6688 di = get_info (tree_view);
6692 di = g_slice_new0 (TreeViewDragInfo);
6694 g_object_set_data_full (G_OBJECT (tree_view),
6695 I_("gtk-tree-view-drag-info"),
6697 (GDestroyNotify) destroy_info);
6704 remove_info (GtkTreeView *tree_view)
6706 g_object_set_data (G_OBJECT (tree_view), I_("gtk-tree-view-drag-info"), NULL);
6711 drag_scan_timeout (gpointer data)
6713 GtkTreeView *tree_view;
6715 GdkModifierType state;
6716 GtkTreePath *path = NULL;
6717 GtkTreeViewColumn *column = NULL;
6718 GdkRectangle visible_rect;
6720 GDK_THREADS_ENTER ();
6722 tree_view = GTK_TREE_VIEW (data);
6724 gdk_window_get_pointer (tree_view->priv->bin_window,
6727 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
6729 /* See if we are near the edge. */
6730 if ((x - visible_rect.x) < SCROLL_EDGE_SIZE ||
6731 (visible_rect.x + visible_rect.width - x) < SCROLL_EDGE_SIZE ||
6732 (y - visible_rect.y) < SCROLL_EDGE_SIZE ||
6733 (visible_rect.y + visible_rect.height - y) < SCROLL_EDGE_SIZE)
6735 gtk_tree_view_get_path_at_pos (tree_view,
6736 tree_view->priv->bin_window,
6745 gtk_tree_view_scroll_to_cell (tree_view,
6751 gtk_tree_path_free (path);
6755 GDK_THREADS_LEAVE ();
6762 add_scroll_timeout (GtkTreeView *tree_view)
6764 if (tree_view->priv->scroll_timeout == 0)
6766 tree_view->priv->scroll_timeout =
6767 gdk_threads_add_timeout (150, scroll_row_timeout, tree_view);
6772 remove_scroll_timeout (GtkTreeView *tree_view)
6774 if (tree_view->priv->scroll_timeout != 0)
6776 g_source_remove (tree_view->priv->scroll_timeout);
6777 tree_view->priv->scroll_timeout = 0;
6782 check_model_dnd (GtkTreeModel *model,
6783 GType required_iface,
6784 const gchar *signal)
6786 if (model == NULL || !G_TYPE_CHECK_INSTANCE_TYPE ((model), required_iface))
6788 g_warning ("You must override the default '%s' handler "
6789 "on GtkTreeView when using models that don't support "
6790 "the %s interface and enabling drag-and-drop. The simplest way to do this "
6791 "is to connect to '%s' and call "
6792 "g_signal_stop_emission_by_name() in your signal handler to prevent "
6793 "the default handler from running. Look at the source code "
6794 "for the default handler in gtktreeview.c to get an idea what "
6795 "your handler should do. (gtktreeview.c is in the GTK source "
6796 "code.) If you're using GTK from a language other than C, "
6797 "there may be a more natural way to override default handlers, e.g. via derivation.",
6798 signal, g_type_name (required_iface), signal);
6806 remove_open_timeout (GtkTreeView *tree_view)
6808 if (tree_view->priv->open_dest_timeout != 0)
6810 g_source_remove (tree_view->priv->open_dest_timeout);
6811 tree_view->priv->open_dest_timeout = 0;
6817 open_row_timeout (gpointer data)
6819 GtkTreeView *tree_view = data;
6820 GtkTreePath *dest_path = NULL;
6821 GtkTreeViewDropPosition pos;
6822 gboolean result = FALSE;
6824 gtk_tree_view_get_drag_dest_row (tree_view,
6829 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
6830 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
6832 gtk_tree_view_expand_row (tree_view, dest_path, FALSE);
6833 tree_view->priv->open_dest_timeout = 0;
6835 gtk_tree_path_free (dest_path);
6840 gtk_tree_path_free (dest_path);
6849 scroll_row_timeout (gpointer data)
6851 GtkTreeView *tree_view = data;
6853 gtk_tree_view_vertical_autoscroll (tree_view);
6855 if (tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
6856 gtk_tree_view_update_rubber_band (tree_view);
6861 /* Returns TRUE if event should not be propagated to parent widgets */
6863 set_destination_row (GtkTreeView *tree_view,
6864 GdkDragContext *context,
6865 /* coordinates relative to the widget */
6868 GdkDragAction *suggested_action,
6871 GtkTreePath *path = NULL;
6872 GtkTreeViewDropPosition pos;
6873 GtkTreeViewDropPosition old_pos;
6874 TreeViewDragInfo *di;
6876 GtkTreePath *old_dest_path = NULL;
6877 gboolean can_drop = FALSE;
6879 *suggested_action = 0;
6882 widget = GTK_WIDGET (tree_view);
6884 di = get_info (tree_view);
6886 if (di == NULL || y - TREE_VIEW_HEADER_HEIGHT (tree_view) < 0)
6888 /* someone unset us as a drag dest, note that if
6889 * we return FALSE drag_leave isn't called
6892 gtk_tree_view_set_drag_dest_row (tree_view,
6894 GTK_TREE_VIEW_DROP_BEFORE);
6896 remove_scroll_timeout (GTK_TREE_VIEW (widget));
6897 remove_open_timeout (GTK_TREE_VIEW (widget));
6899 return FALSE; /* no longer a drop site */
6902 *target = gtk_drag_dest_find_target (widget, context,
6903 gtk_drag_dest_get_target_list (widget));
6904 if (*target == GDK_NONE)
6909 if (!gtk_tree_view_get_dest_row_at_pos (tree_view,
6915 GtkTreeModel *model;
6917 remove_open_timeout (tree_view);
6919 /* the row got dropped on empty space, let's setup a special case
6923 gtk_tree_path_free (path);
6925 model = gtk_tree_view_get_model (tree_view);
6927 n_children = gtk_tree_model_iter_n_children (model, NULL);
6930 pos = GTK_TREE_VIEW_DROP_AFTER;
6931 path = gtk_tree_path_new_from_indices (n_children - 1, -1);
6935 pos = GTK_TREE_VIEW_DROP_BEFORE;
6936 path = gtk_tree_path_new_from_indices (0, -1);
6946 /* If we left the current row's "open" zone, unset the timeout for
6949 gtk_tree_view_get_drag_dest_row (tree_view,
6953 if (old_dest_path &&
6954 (gtk_tree_path_compare (path, old_dest_path) != 0 ||
6955 !(pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
6956 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE)))
6957 remove_open_timeout (tree_view);
6960 gtk_tree_path_free (old_dest_path);
6962 if (TRUE /* FIXME if the location droppable predicate */)
6970 GtkWidget *source_widget;
6972 *suggested_action = context->suggested_action;
6973 source_widget = gtk_drag_get_source_widget (context);
6975 if (source_widget == widget)
6977 /* Default to MOVE, unless the user has
6978 * pressed ctrl or shift to affect available actions
6980 if ((context->actions & GDK_ACTION_MOVE) != 0)
6981 *suggested_action = GDK_ACTION_MOVE;
6984 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
6989 /* can't drop here */
6990 remove_open_timeout (tree_view);
6992 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
6994 GTK_TREE_VIEW_DROP_BEFORE);
6998 gtk_tree_path_free (path);
7004 get_logical_dest_row (GtkTreeView *tree_view,
7005 gboolean *path_down_mode,
7006 gboolean *drop_append_mode)
7008 /* adjust path to point to the row the drop goes in front of */
7009 GtkTreePath *path = NULL;
7010 GtkTreeViewDropPosition pos;
7012 g_return_val_if_fail (path_down_mode != NULL, NULL);
7013 g_return_val_if_fail (drop_append_mode != NULL, NULL);
7015 *path_down_mode = FALSE;
7016 *drop_append_mode = 0;
7018 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
7023 if (pos == GTK_TREE_VIEW_DROP_BEFORE)
7025 else if (pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE ||
7026 pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER)
7027 *path_down_mode = TRUE;
7031 GtkTreeModel *model = gtk_tree_view_get_model (tree_view);
7033 g_assert (pos == GTK_TREE_VIEW_DROP_AFTER);
7035 if (!gtk_tree_model_get_iter (model, &iter, path) ||
7036 !gtk_tree_model_iter_next (model, &iter))
7037 *drop_append_mode = 1;
7040 *drop_append_mode = 0;
7041 gtk_tree_path_next (path);
7049 gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
7050 GdkEventMotion *event)
7052 GtkWidget *widget = GTK_WIDGET (tree_view);
7053 GdkDragContext *context;
7054 TreeViewDragInfo *di;
7055 GtkTreePath *path = NULL;
7057 gint cell_x, cell_y;
7058 GtkTreeModel *model;
7059 gboolean retval = FALSE;
7061 di = get_info (tree_view);
7063 if (di == NULL || !di->source_set)
7066 if (tree_view->priv->pressed_button < 0)
7069 if (!gtk_drag_check_threshold (widget,
7070 tree_view->priv->press_start_x,
7071 tree_view->priv->press_start_y,
7072 event->x, event->y))
7075 model = gtk_tree_view_get_model (tree_view);
7080 button = tree_view->priv->pressed_button;
7081 tree_view->priv->pressed_button = -1;
7083 gtk_tree_view_get_path_at_pos (tree_view,
7084 tree_view->priv->press_start_x,
7085 tree_view->priv->press_start_y,
7094 if (!GTK_IS_TREE_DRAG_SOURCE (model) ||
7095 !gtk_tree_drag_source_row_draggable (GTK_TREE_DRAG_SOURCE (model),
7099 if (!(GDK_BUTTON1_MASK << (button - 1) & di->start_button_mask))
7102 /* Now we can begin the drag */
7106 context = gtk_drag_begin (widget,
7107 gtk_drag_source_get_target_list (widget),
7112 set_source_row (context, model, path);
7116 gtk_tree_path_free (path);
7123 gtk_tree_view_drag_begin (GtkWidget *widget,
7124 GdkDragContext *context)
7126 GtkTreeView *tree_view;
7127 GtkTreePath *path = NULL;
7128 gint cell_x, cell_y;
7130 TreeViewDragInfo *di;
7132 tree_view = GTK_TREE_VIEW (widget);
7134 /* if the user uses a custom DND source impl, we don't set the icon here */
7135 di = get_info (tree_view);
7137 if (di == NULL || !di->source_set)
7140 gtk_tree_view_get_path_at_pos (tree_view,
7141 tree_view->priv->press_start_x,
7142 tree_view->priv->press_start_y,
7148 g_return_if_fail (path != NULL);
7150 row_pix = gtk_tree_view_create_row_drag_icon (tree_view,
7153 gtk_drag_set_icon_pixmap (context,
7154 gdk_drawable_get_colormap (row_pix),
7157 /* the + 1 is for the black border in the icon */
7158 tree_view->priv->press_start_x + 1,
7161 g_object_unref (row_pix);
7162 gtk_tree_path_free (path);
7166 gtk_tree_view_drag_end (GtkWidget *widget,
7167 GdkDragContext *context)
7172 /* Default signal implementations for the drag signals */
7174 gtk_tree_view_drag_data_get (GtkWidget *widget,
7175 GdkDragContext *context,
7176 GtkSelectionData *selection_data,
7180 GtkTreeView *tree_view;
7181 GtkTreeModel *model;
7182 TreeViewDragInfo *di;
7183 GtkTreePath *source_row;
7185 tree_view = GTK_TREE_VIEW (widget);
7187 model = gtk_tree_view_get_model (tree_view);
7192 di = get_info (GTK_TREE_VIEW (widget));
7197 source_row = get_source_row (context);
7199 if (source_row == NULL)
7202 /* We can implement the GTK_TREE_MODEL_ROW target generically for
7203 * any model; for DragSource models there are some other targets
7207 if (GTK_IS_TREE_DRAG_SOURCE (model) &&
7208 gtk_tree_drag_source_drag_data_get (GTK_TREE_DRAG_SOURCE (model),
7213 /* If drag_data_get does nothing, try providing row data. */
7214 if (selection_data->target == gdk_atom_intern_static_string ("GTK_TREE_MODEL_ROW"))
7216 gtk_tree_set_row_drag_data (selection_data,
7222 gtk_tree_path_free (source_row);
7227 gtk_tree_view_drag_data_delete (GtkWidget *widget,
7228 GdkDragContext *context)
7230 TreeViewDragInfo *di;
7231 GtkTreeModel *model;
7232 GtkTreeView *tree_view;
7233 GtkTreePath *source_row;
7235 tree_view = GTK_TREE_VIEW (widget);
7236 model = gtk_tree_view_get_model (tree_view);
7238 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_SOURCE, "drag_data_delete"))
7241 di = get_info (tree_view);
7246 source_row = get_source_row (context);
7248 if (source_row == NULL)
7251 gtk_tree_drag_source_drag_data_delete (GTK_TREE_DRAG_SOURCE (model),
7254 gtk_tree_path_free (source_row);
7256 set_source_row (context, NULL, NULL);
7260 gtk_tree_view_drag_leave (GtkWidget *widget,
7261 GdkDragContext *context,
7264 /* unset any highlight row */
7265 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
7267 GTK_TREE_VIEW_DROP_BEFORE);
7269 remove_scroll_timeout (GTK_TREE_VIEW (widget));
7270 remove_open_timeout (GTK_TREE_VIEW (widget));
7275 gtk_tree_view_drag_motion (GtkWidget *widget,
7276 GdkDragContext *context,
7277 /* coordinates relative to the widget */
7283 GtkTreePath *path = NULL;
7284 GtkTreeViewDropPosition pos;
7285 GtkTreeView *tree_view;
7286 GdkDragAction suggested_action = 0;
7289 tree_view = GTK_TREE_VIEW (widget);
7291 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
7294 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
7296 /* we only know this *after* set_desination_row */
7297 empty = tree_view->priv->empty_view_drop;
7299 if (path == NULL && !empty)
7301 /* Can't drop here. */
7302 gdk_drag_status (context, 0, time);
7306 if (tree_view->priv->open_dest_timeout == 0 &&
7307 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
7308 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
7310 tree_view->priv->open_dest_timeout =
7311 gdk_threads_add_timeout (AUTO_EXPAND_TIMEOUT, open_row_timeout, tree_view);
7315 add_scroll_timeout (tree_view);
7318 if (target == gdk_atom_intern_static_string ("GTK_TREE_MODEL_ROW"))
7320 /* Request data so we can use the source row when
7321 * determining whether to accept the drop
7323 set_status_pending (context, suggested_action);
7324 gtk_drag_get_data (widget, context, target, time);
7328 set_status_pending (context, 0);
7329 gdk_drag_status (context, suggested_action, time);
7334 gtk_tree_path_free (path);
7341 gtk_tree_view_drag_drop (GtkWidget *widget,
7342 GdkDragContext *context,
7343 /* coordinates relative to the widget */
7348 GtkTreeView *tree_view;
7350 GdkDragAction suggested_action = 0;
7351 GdkAtom target = GDK_NONE;
7352 TreeViewDragInfo *di;
7353 GtkTreeModel *model;
7354 gboolean path_down_mode;
7355 gboolean drop_append_mode;
7357 tree_view = GTK_TREE_VIEW (widget);
7359 model = gtk_tree_view_get_model (tree_view);
7361 remove_scroll_timeout (GTK_TREE_VIEW (widget));
7362 remove_open_timeout (GTK_TREE_VIEW (widget));
7364 di = get_info (tree_view);
7369 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_drop"))
7372 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
7375 path = get_logical_dest_row (tree_view, &path_down_mode, &drop_append_mode);
7377 if (target != GDK_NONE && path != NULL)
7379 /* in case a motion had requested drag data, change things so we
7380 * treat drag data receives as a drop.
7382 set_status_pending (context, 0);
7383 set_dest_row (context, model, path,
7384 path_down_mode, tree_view->priv->empty_view_drop,
7389 gtk_tree_path_free (path);
7391 /* Unset this thing */
7392 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
7394 GTK_TREE_VIEW_DROP_BEFORE);
7396 if (target != GDK_NONE)
7398 gtk_drag_get_data (widget, context, target, time);
7406 gtk_tree_view_drag_data_received (GtkWidget *widget,
7407 GdkDragContext *context,
7408 /* coordinates relative to the widget */
7411 GtkSelectionData *selection_data,
7416 TreeViewDragInfo *di;
7417 gboolean accepted = FALSE;
7418 GtkTreeModel *model;
7419 GtkTreeView *tree_view;
7420 GtkTreePath *dest_row;
7421 GdkDragAction suggested_action;
7422 gboolean path_down_mode;
7423 gboolean drop_append_mode;
7425 tree_view = GTK_TREE_VIEW (widget);
7427 model = gtk_tree_view_get_model (tree_view);
7429 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_data_received"))
7432 di = get_info (tree_view);
7437 suggested_action = get_status_pending (context);
7439 if (suggested_action)
7441 /* We are getting this data due to a request in drag_motion,
7442 * rather than due to a request in drag_drop, so we are just
7443 * supposed to call drag_status, not actually paste in the
7446 path = get_logical_dest_row (tree_view, &path_down_mode,
7450 suggested_action = 0;
7451 else if (path_down_mode)
7452 gtk_tree_path_down (path);
7454 if (suggested_action)
7456 if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model),
7462 path_down_mode = FALSE;
7463 gtk_tree_path_up (path);
7465 if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model),
7468 suggested_action = 0;
7471 suggested_action = 0;
7475 gdk_drag_status (context, suggested_action, time);
7478 gtk_tree_path_free (path);
7480 /* If you can't drop, remove user drop indicator until the next motion */
7481 if (suggested_action == 0)
7482 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
7484 GTK_TREE_VIEW_DROP_BEFORE);
7489 dest_row = get_dest_row (context, &path_down_mode);
7491 if (dest_row == NULL)
7494 if (selection_data->length >= 0)
7498 gtk_tree_path_down (dest_row);
7499 if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model),
7500 dest_row, selection_data))
7501 gtk_tree_path_up (dest_row);
7505 if (selection_data->length >= 0)
7507 if (gtk_tree_drag_dest_drag_data_received (GTK_TREE_DRAG_DEST (model),
7513 gtk_drag_finish (context,
7515 (context->action == GDK_ACTION_MOVE),
7518 if (gtk_tree_path_get_depth (dest_row) == 1
7519 && gtk_tree_path_get_indices (dest_row)[0] == 0)
7521 /* special special case drag to "0", scroll to first item */
7522 if (!tree_view->priv->scroll_to_path)
7523 gtk_tree_view_scroll_to_cell (tree_view, dest_row, NULL, FALSE, 0.0, 0.0);
7526 gtk_tree_path_free (dest_row);
7529 set_dest_row (context, NULL, NULL, FALSE, FALSE, FALSE);
7534 /* GtkContainer Methods
7539 gtk_tree_view_remove (GtkContainer *container,
7542 GtkTreeView *tree_view = GTK_TREE_VIEW (container);
7543 GtkTreeViewChild *child = NULL;
7546 tmp_list = tree_view->priv->children;
7549 child = tmp_list->data;
7550 if (child->widget == widget)
7552 gtk_widget_unparent (widget);
7554 tree_view->priv->children = g_list_remove_link (tree_view->priv->children, tmp_list);
7555 g_list_free_1 (tmp_list);
7556 g_slice_free (GtkTreeViewChild, child);
7560 tmp_list = tmp_list->next;
7563 tmp_list = tree_view->priv->columns;
7567 GtkTreeViewColumn *column;
7568 column = tmp_list->data;
7569 if (column->button == widget)
7571 gtk_widget_unparent (widget);
7574 tmp_list = tmp_list->next;
7579 gtk_tree_view_forall (GtkContainer *container,
7580 gboolean include_internals,
7581 GtkCallback callback,
7582 gpointer callback_data)
7584 GtkTreeView *tree_view = GTK_TREE_VIEW (container);
7585 GtkTreeViewChild *child = NULL;
7586 GtkTreeViewColumn *column;
7589 tmp_list = tree_view->priv->children;
7592 child = tmp_list->data;
7593 tmp_list = tmp_list->next;
7595 (* callback) (child->widget, callback_data);
7597 if (include_internals == FALSE)
7600 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
7602 column = tmp_list->data;
7605 (* callback) (column->button, callback_data);
7609 /* Returns TRUE if the treeview contains no "special" (editable or activatable)
7610 * cells. If so we draw one big row-spanning focus rectangle.
7613 gtk_tree_view_has_special_cell (GtkTreeView *tree_view)
7617 for (list = tree_view->priv->columns; list; list = list->next)
7619 if (!((GtkTreeViewColumn *)list->data)->visible)
7621 if (_gtk_tree_view_column_count_special_cells (list->data))
7629 column_sizing_notify (GObject *object,
7633 GtkTreeViewColumn *c = GTK_TREE_VIEW_COLUMN (object);
7635 if (gtk_tree_view_column_get_sizing (c) != GTK_TREE_VIEW_COLUMN_FIXED)
7636 /* disable fixed height mode */
7637 g_object_set (data, "fixed-height-mode", FALSE, NULL);
7641 * gtk_tree_view_set_fixed_height_mode:
7642 * @tree_view: a #GtkTreeView
7643 * @enable: %TRUE to enable fixed height mode
7645 * Enables or disables the fixed height mode of @tree_view.
7646 * Fixed height mode speeds up #GtkTreeView by assuming that all
7647 * rows have the same height.
7648 * Only enable this option if all rows are the same height and all
7649 * columns are of type %GTK_TREE_VIEW_COLUMN_FIXED.
7654 gtk_tree_view_set_fixed_height_mode (GtkTreeView *tree_view,
7659 enable = enable != FALSE;
7661 if (enable == tree_view->priv->fixed_height_mode)
7666 tree_view->priv->fixed_height_mode = 0;
7667 tree_view->priv->fixed_height = -1;
7669 /* force a revalidation */
7670 install_presize_handler (tree_view);
7674 /* make sure all columns are of type FIXED */
7675 for (l = tree_view->priv->columns; l; l = l->next)
7677 GtkTreeViewColumn *c = l->data;
7679 g_return_if_fail (gtk_tree_view_column_get_sizing (c) == GTK_TREE_VIEW_COLUMN_FIXED);
7682 /* yes, we really have to do this is in a separate loop */
7683 for (l = tree_view->priv->columns; l; l = l->next)
7684 g_signal_connect (l->data, "notify::sizing",
7685 G_CALLBACK (column_sizing_notify), tree_view);
7687 tree_view->priv->fixed_height_mode = 1;
7688 tree_view->priv->fixed_height = -1;
7690 if (tree_view->priv->tree)
7691 initialize_fixed_height_mode (tree_view);
7694 g_object_notify (G_OBJECT (tree_view), "fixed-height-mode");
7698 * gtk_tree_view_get_fixed_height_mode:
7699 * @tree_view: a #GtkTreeView
7701 * Returns whether fixed height mode is turned on for @tree_view.
7703 * Return value: %TRUE if @tree_view is in fixed height mode
7708 gtk_tree_view_get_fixed_height_mode (GtkTreeView *tree_view)
7710 return tree_view->priv->fixed_height_mode;
7713 /* Returns TRUE if the focus is within the headers, after the focus operation is
7717 gtk_tree_view_header_focus (GtkTreeView *tree_view,
7718 GtkDirectionType dir,
7719 gboolean clamp_column_visible)
7721 GtkWidget *focus_child;
7723 GList *last_column, *first_column;
7727 if (! GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
7730 focus_child = GTK_CONTAINER (tree_view)->focus_child;
7732 first_column = tree_view->priv->columns;
7733 while (first_column)
7735 if (GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (first_column->data)->button) &&
7736 GTK_TREE_VIEW_COLUMN (first_column->data)->visible &&
7737 (GTK_TREE_VIEW_COLUMN (first_column->data)->clickable ||
7738 GTK_TREE_VIEW_COLUMN (first_column->data)->reorderable))
7740 first_column = first_column->next;
7743 /* No headers are visible, or are focusable. We can't focus in or out.
7745 if (first_column == NULL)
7748 last_column = g_list_last (tree_view->priv->columns);
7751 if (GTK_WIDGET_CAN_FOCUS (GTK_TREE_VIEW_COLUMN (last_column->data)->button) &&
7752 GTK_TREE_VIEW_COLUMN (last_column->data)->visible &&
7753 (GTK_TREE_VIEW_COLUMN (last_column->data)->clickable ||
7754 GTK_TREE_VIEW_COLUMN (last_column->data)->reorderable))
7756 last_column = last_column->prev;
7760 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
7764 case GTK_DIR_TAB_BACKWARD:
7765 case GTK_DIR_TAB_FORWARD:
7768 if (focus_child == NULL)
7770 if (tree_view->priv->focus_column != NULL && GTK_WIDGET_CAN_FOCUS (tree_view->priv->focus_column->button))
7771 focus_child = tree_view->priv->focus_column->button;
7773 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
7774 gtk_widget_grab_focus (focus_child);
7781 if (focus_child == NULL)
7783 if (tree_view->priv->focus_column != NULL)
7784 focus_child = tree_view->priv->focus_column->button;
7785 else if (dir == GTK_DIR_LEFT)
7786 focus_child = GTK_TREE_VIEW_COLUMN (last_column->data)->button;
7788 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
7789 gtk_widget_grab_focus (focus_child);
7793 if (gtk_widget_child_focus (focus_child, dir))
7795 /* The focus moves inside the button. */
7796 /* This is probably a great example of bad UI */
7800 /* We need to move the focus among the row of buttons. */
7801 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
7802 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
7805 if ((tmp_list == first_column && dir == (rtl ? GTK_DIR_RIGHT : GTK_DIR_LEFT))
7806 || (tmp_list == last_column && dir == (rtl ? GTK_DIR_LEFT : GTK_DIR_RIGHT)))
7808 gtk_widget_error_bell (GTK_WIDGET (tree_view));
7814 GtkTreeViewColumn *column;
7816 if (dir == (rtl ? GTK_DIR_LEFT : GTK_DIR_RIGHT))
7817 tmp_list = tmp_list->next;
7819 tmp_list = tmp_list->prev;
7821 if (tmp_list == NULL)
7823 g_warning ("Internal button not found");
7826 column = tmp_list->data;
7827 if (column->button &&
7829 GTK_WIDGET_CAN_FOCUS (column->button))
7831 focus_child = column->button;
7832 gtk_widget_grab_focus (column->button);
7838 g_assert_not_reached ();
7842 /* if focus child is non-null, we assume it's been set to the current focus child
7846 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
7847 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
7849 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
7853 if (clamp_column_visible)
7855 gtk_tree_view_clamp_column_visible (tree_view,
7856 tree_view->priv->focus_column,
7861 return (focus_child != NULL);
7864 /* This function returns in 'path' the first focusable path, if the given path
7865 * is already focusable, it's the returned one.
7868 search_first_focusable_path (GtkTreeView *tree_view,
7870 gboolean search_forward,
7871 GtkRBTree **new_tree,
7872 GtkRBNode **new_node)
7874 GtkRBTree *tree = NULL;
7875 GtkRBNode *node = NULL;
7877 if (!path || !*path)
7880 _gtk_tree_view_find_node (tree_view, *path, &tree, &node);
7885 while (node && row_is_separator (tree_view, NULL, *path))
7888 _gtk_rbtree_next_full (tree, node, &tree, &node);
7890 _gtk_rbtree_prev_full (tree, node, &tree, &node);
7893 gtk_tree_path_free (*path);
7896 *path = _gtk_tree_view_find_path (tree_view, tree, node);
7907 return (*path != NULL);
7911 gtk_tree_view_focus (GtkWidget *widget,
7912 GtkDirectionType direction)
7914 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
7915 GtkContainer *container = GTK_CONTAINER (widget);
7916 GtkWidget *focus_child;
7918 if (!GTK_WIDGET_IS_SENSITIVE (container) || !GTK_WIDGET_CAN_FOCUS (widget))
7921 focus_child = container->focus_child;
7923 gtk_tree_view_stop_editing (GTK_TREE_VIEW (widget), FALSE);
7924 /* Case 1. Headers currently have focus. */
7931 gtk_tree_view_header_focus (tree_view, direction, TRUE);
7933 case GTK_DIR_TAB_BACKWARD:
7936 case GTK_DIR_TAB_FORWARD:
7938 gtk_widget_grab_focus (widget);
7941 g_assert_not_reached ();
7946 /* Case 2. We don't have focus at all. */
7947 if (!GTK_WIDGET_HAS_FOCUS (container))
7949 if (!gtk_tree_view_header_focus (tree_view, direction, FALSE))
7950 gtk_widget_grab_focus (widget);
7954 /* Case 3. We have focus already. */
7955 if (direction == GTK_DIR_TAB_BACKWARD)
7956 return (gtk_tree_view_header_focus (tree_view, direction, FALSE));
7957 else if (direction == GTK_DIR_TAB_FORWARD)
7960 /* Other directions caught by the keybindings */
7961 gtk_widget_grab_focus (widget);
7966 gtk_tree_view_grab_focus (GtkWidget *widget)
7968 GTK_WIDGET_CLASS (gtk_tree_view_parent_class)->grab_focus (widget);
7970 gtk_tree_view_focus_to_cursor (GTK_TREE_VIEW (widget));
7974 gtk_tree_view_style_set (GtkWidget *widget,
7975 GtkStyle *previous_style)
7977 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
7979 GtkTreeViewColumn *column;
7981 if (GTK_WIDGET_REALIZED (widget))
7983 gdk_window_set_back_pixmap (widget->window, NULL, FALSE);
7984 gdk_window_set_background (tree_view->priv->bin_window, &widget->style->base[widget->state]);
7985 gtk_style_set_background (widget->style, tree_view->priv->header_window, GTK_STATE_NORMAL);
7987 gtk_tree_view_set_grid_lines (tree_view, tree_view->priv->grid_lines);
7988 gtk_tree_view_set_enable_tree_lines (tree_view, tree_view->priv->tree_lines_enabled);
7991 gtk_widget_style_get (widget,
7992 "expander-size", &tree_view->priv->expander_size,
7994 tree_view->priv->expander_size += EXPANDER_EXTRA_PADDING;
7996 for (list = tree_view->priv->columns; list; list = list->next)
7998 column = list->data;
7999 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
8002 tree_view->priv->fixed_height = -1;
8003 _gtk_rbtree_mark_invalid (tree_view->priv->tree);
8005 gtk_widget_queue_resize (widget);
8010 gtk_tree_view_set_focus_child (GtkContainer *container,
8013 GtkTreeView *tree_view = GTK_TREE_VIEW (container);
8016 for (list = tree_view->priv->columns; list; list = list->next)
8018 if (GTK_TREE_VIEW_COLUMN (list->data)->button == child)
8020 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (list->data);
8025 GTK_CONTAINER_CLASS (gtk_tree_view_parent_class)->set_focus_child (container, child);
8029 gtk_tree_view_set_adjustments (GtkTreeView *tree_view,
8030 GtkAdjustment *hadj,
8031 GtkAdjustment *vadj)
8033 gboolean need_adjust = FALSE;
8035 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8038 g_return_if_fail (GTK_IS_ADJUSTMENT (hadj));
8040 hadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
8042 g_return_if_fail (GTK_IS_ADJUSTMENT (vadj));
8044 vadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
8046 if (tree_view->priv->hadjustment && (tree_view->priv->hadjustment != hadj))
8048 g_signal_handlers_disconnect_by_func (tree_view->priv->hadjustment,
8049 gtk_tree_view_adjustment_changed,
8051 g_object_unref (tree_view->priv->hadjustment);
8054 if (tree_view->priv->vadjustment && (tree_view->priv->vadjustment != vadj))
8056 g_signal_handlers_disconnect_by_func (tree_view->priv->vadjustment,
8057 gtk_tree_view_adjustment_changed,
8059 g_object_unref (tree_view->priv->vadjustment);
8062 if (tree_view->priv->hadjustment != hadj)
8064 tree_view->priv->hadjustment = hadj;
8065 g_object_ref_sink (tree_view->priv->hadjustment);
8067 g_signal_connect (tree_view->priv->hadjustment, "value-changed",
8068 G_CALLBACK (gtk_tree_view_adjustment_changed),
8073 if (tree_view->priv->vadjustment != vadj)
8075 tree_view->priv->vadjustment = vadj;
8076 g_object_ref_sink (tree_view->priv->vadjustment);
8078 g_signal_connect (tree_view->priv->vadjustment, "value-changed",
8079 G_CALLBACK (gtk_tree_view_adjustment_changed),
8085 gtk_tree_view_adjustment_changed (NULL, tree_view);
8090 gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
8091 GtkMovementStep step,
8094 GdkModifierType state;
8096 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
8097 g_return_val_if_fail (step == GTK_MOVEMENT_LOGICAL_POSITIONS ||
8098 step == GTK_MOVEMENT_VISUAL_POSITIONS ||
8099 step == GTK_MOVEMENT_DISPLAY_LINES ||
8100 step == GTK_MOVEMENT_PAGES ||
8101 step == GTK_MOVEMENT_BUFFER_ENDS, FALSE);
8103 if (tree_view->priv->tree == NULL)
8105 if (!GTK_WIDGET_HAS_FOCUS (GTK_WIDGET (tree_view)))
8108 gtk_tree_view_stop_editing (tree_view, FALSE);
8109 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
8110 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
8112 if (gtk_get_current_event_state (&state))
8114 if ((state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
8115 tree_view->priv->ctrl_pressed = TRUE;
8116 if ((state & GDK_SHIFT_MASK) == GDK_SHIFT_MASK)
8117 tree_view->priv->shift_pressed = TRUE;
8119 /* else we assume not pressed */
8123 /* currently we make no distinction. When we go bi-di, we need to */
8124 case GTK_MOVEMENT_LOGICAL_POSITIONS:
8125 case GTK_MOVEMENT_VISUAL_POSITIONS:
8126 gtk_tree_view_move_cursor_left_right (tree_view, count);
8128 case GTK_MOVEMENT_DISPLAY_LINES:
8129 gtk_tree_view_move_cursor_up_down (tree_view, count);
8131 case GTK_MOVEMENT_PAGES:
8132 gtk_tree_view_move_cursor_page_up_down (tree_view, count);
8134 case GTK_MOVEMENT_BUFFER_ENDS:
8135 gtk_tree_view_move_cursor_start_end (tree_view, count);
8138 g_assert_not_reached ();
8141 tree_view->priv->ctrl_pressed = FALSE;
8142 tree_view->priv->shift_pressed = FALSE;
8148 gtk_tree_view_put (GtkTreeView *tree_view,
8149 GtkWidget *child_widget,
8150 /* in bin_window coordinates */
8156 GtkTreeViewChild *child;
8158 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8159 g_return_if_fail (GTK_IS_WIDGET (child_widget));
8161 child = g_slice_new (GtkTreeViewChild);
8163 child->widget = child_widget;
8166 child->width = width;
8167 child->height = height;
8169 tree_view->priv->children = g_list_append (tree_view->priv->children, child);
8171 if (GTK_WIDGET_REALIZED (tree_view))
8172 gtk_widget_set_parent_window (child->widget, tree_view->priv->bin_window);
8174 gtk_widget_set_parent (child_widget, GTK_WIDGET (tree_view));
8178 _gtk_tree_view_child_move_resize (GtkTreeView *tree_view,
8180 /* in tree coordinates */
8186 GtkTreeViewChild *child = NULL;
8188 GdkRectangle allocation;
8190 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8191 g_return_if_fail (GTK_IS_WIDGET (widget));
8193 for (list = tree_view->priv->children; list; list = list->next)
8195 if (((GtkTreeViewChild *)list->data)->widget == widget)
8204 allocation.x = child->x = x;
8205 allocation.y = child->y = y;
8206 allocation.width = child->width = width;
8207 allocation.height = child->height = height;
8209 if (GTK_WIDGET_REALIZED (widget))
8210 gtk_widget_size_allocate (widget, &allocation);
8214 /* TreeModel Callbacks
8218 gtk_tree_view_row_changed (GtkTreeModel *model,
8223 GtkTreeView *tree_view = (GtkTreeView *)data;
8226 gboolean free_path = FALSE;
8228 GtkTreePath *cursor_path;
8230 g_return_if_fail (path != NULL || iter != NULL);
8232 if (tree_view->priv->cursor != NULL)
8233 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
8237 if (tree_view->priv->edited_column &&
8238 (cursor_path == NULL || gtk_tree_path_compare (cursor_path, path) == 0))
8239 gtk_tree_view_stop_editing (tree_view, TRUE);
8241 if (cursor_path != NULL)
8242 gtk_tree_path_free (cursor_path);
8246 path = gtk_tree_model_get_path (model, iter);
8249 else if (iter == NULL)
8250 gtk_tree_model_get_iter (model, iter, path);
8252 if (_gtk_tree_view_find_node (tree_view,
8256 /* We aren't actually showing the node */
8262 if (tree_view->priv->fixed_height_mode
8263 && tree_view->priv->fixed_height >= 0)
8265 _gtk_rbtree_node_set_height (tree, node, tree_view->priv->fixed_height);
8266 if (GTK_WIDGET_REALIZED (tree_view))
8267 gtk_tree_view_node_queue_redraw (tree_view, tree, node);
8271 _gtk_rbtree_node_mark_invalid (tree, node);
8272 for (list = tree_view->priv->columns; list; list = list->next)
8274 GtkTreeViewColumn *column;
8276 column = list->data;
8277 if (! column->visible)
8280 if (column->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
8282 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
8288 if (GTK_WIDGET_REALIZED (tree_view) && !tree_view->priv->fixed_height_mode)
8289 install_presize_handler (tree_view);
8291 gtk_tree_path_free (path);
8295 gtk_tree_view_row_inserted (GtkTreeModel *model,
8300 GtkTreeView *tree_view = (GtkTreeView *) data;
8302 GtkRBTree *tmptree, *tree;
8303 GtkRBNode *tmpnode = NULL;
8307 gboolean free_path = FALSE;
8308 gboolean node_visible = TRUE;
8310 g_return_if_fail (path != NULL || iter != NULL);
8312 if (tree_view->priv->fixed_height_mode
8313 && tree_view->priv->fixed_height >= 0)
8314 height = tree_view->priv->fixed_height;
8320 path = gtk_tree_model_get_path (model, iter);
8323 else if (iter == NULL)
8324 gtk_tree_model_get_iter (model, iter, path);
8326 if (tree_view->priv->tree == NULL)
8327 tree_view->priv->tree = _gtk_rbtree_new ();
8329 tmptree = tree = tree_view->priv->tree;
8331 /* Update all row-references */
8332 gtk_tree_row_reference_inserted (G_OBJECT (data), path);
8333 depth = gtk_tree_path_get_depth (path);
8334 indices = gtk_tree_path_get_indices (path);
8336 /* First, find the parent tree */
8337 while (i < depth - 1)
8339 if (tmptree == NULL)
8341 /* We aren't showing the node */
8342 node_visible = FALSE;
8346 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
8347 if (tmpnode == NULL)
8349 g_warning ("A node was inserted with a parent that's not in the tree.\n" \
8350 "This possibly means that a GtkTreeModel inserted a child node\n" \
8351 "before the parent was inserted.");
8354 else if (!GTK_RBNODE_FLAG_SET (tmpnode, GTK_RBNODE_IS_PARENT))
8356 /* FIXME enforce correct behavior on model, probably */
8357 /* In theory, the model should have emitted has_child_toggled here. We
8358 * try to catch it anyway, just to be safe, in case the model hasn't.
8360 GtkTreePath *tmppath = _gtk_tree_view_find_path (tree_view,
8363 gtk_tree_view_row_has_child_toggled (model, tmppath, NULL, data);
8364 gtk_tree_path_free (tmppath);
8368 tmptree = tmpnode->children;
8375 node_visible = FALSE;
8380 gtk_tree_model_ref_node (tree_view->priv->model, iter);
8381 if (indices[depth - 1] == 0)
8383 tmpnode = _gtk_rbtree_find_count (tree, 1);
8384 tmpnode = _gtk_rbtree_insert_before (tree, tmpnode, height, FALSE);
8388 tmpnode = _gtk_rbtree_find_count (tree, indices[depth - 1]);
8389 tmpnode = _gtk_rbtree_insert_after (tree, tmpnode, height, FALSE);
8396 _gtk_rbtree_node_mark_valid (tree, tmpnode);
8398 if (node_visible && node_is_visible (tree_view, tree, tmpnode))
8399 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8401 gtk_widget_queue_resize_no_redraw (GTK_WIDGET (tree_view));
8404 install_presize_handler (tree_view);
8406 gtk_tree_path_free (path);
8410 gtk_tree_view_row_has_child_toggled (GtkTreeModel *model,
8415 GtkTreeView *tree_view = (GtkTreeView *)data;
8416 GtkTreeIter real_iter;
8420 gboolean free_path = FALSE;
8422 g_return_if_fail (path != NULL || iter != NULL);
8429 path = gtk_tree_model_get_path (model, iter);
8432 else if (iter == NULL)
8433 gtk_tree_model_get_iter (model, &real_iter, path);
8435 if (_gtk_tree_view_find_node (tree_view,
8439 /* We aren't actually showing the node */
8445 has_child = gtk_tree_model_iter_has_child (model, &real_iter);
8448 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT) == has_child)
8452 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PARENT);
8454 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_PARENT);
8456 if (has_child && GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST))
8458 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
8459 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS))
8463 for (list = tree_view->priv->columns; list; list = list->next)
8464 if (GTK_TREE_VIEW_COLUMN (list->data)->visible)
8466 GTK_TREE_VIEW_COLUMN (list->data)->dirty = TRUE;
8467 _gtk_tree_view_column_cell_set_dirty (GTK_TREE_VIEW_COLUMN (list->data), TRUE);
8471 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8475 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
8480 gtk_tree_path_free (path);
8484 count_children_helper (GtkRBTree *tree,
8489 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, data);
8490 (*((gint *)data))++;
8494 check_selection_helper (GtkRBTree *tree,
8498 gint *value = (gint *)data;
8500 *value = GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED);
8502 if (node->children && !*value)
8503 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, check_selection_helper, data);
8507 gtk_tree_view_row_deleted (GtkTreeModel *model,
8511 GtkTreeView *tree_view = (GtkTreeView *)data;
8515 gint selection_changed = FALSE;
8517 g_return_if_fail (path != NULL);
8519 gtk_tree_row_reference_deleted (G_OBJECT (data), path);
8521 if (_gtk_tree_view_find_node (tree_view, path, &tree, &node))
8527 /* check if the selection has been changed */
8528 _gtk_rbtree_traverse (tree, node, G_POST_ORDER,
8529 check_selection_helper, &selection_changed);
8531 for (list = tree_view->priv->columns; list; list = list->next)
8532 if (((GtkTreeViewColumn *)list->data)->visible &&
8533 ((GtkTreeViewColumn *)list->data)->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
8534 _gtk_tree_view_column_cell_set_dirty ((GtkTreeViewColumn *)list->data, TRUE);
8536 /* Ensure we don't have a dangling pointer to a dead node */
8537 ensure_unprelighted (tree_view);
8539 /* Cancel editting if we've started */
8540 gtk_tree_view_stop_editing (tree_view, TRUE);
8542 /* If we have a node expanded/collapsed timeout, remove it */
8543 remove_expand_collapse_timeout (tree_view);
8545 if (tree_view->priv->destroy_count_func)
8547 gint child_count = 0;
8549 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, &child_count);
8550 tree_view->priv->destroy_count_func (tree_view, path, child_count, tree_view->priv->destroy_count_data);
8553 if (tree->root->count == 1)
8555 if (tree_view->priv->tree == tree)
8556 tree_view->priv->tree = NULL;
8558 _gtk_rbtree_remove (tree);
8562 _gtk_rbtree_remove_node (tree, node);
8565 if (! gtk_tree_row_reference_valid (tree_view->priv->top_row))
8567 gtk_tree_row_reference_free (tree_view->priv->top_row);
8568 tree_view->priv->top_row = NULL;
8571 install_scroll_sync_handler (tree_view);
8573 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8575 if (selection_changed)
8576 g_signal_emit_by_name (tree_view->priv->selection, "changed");
8580 gtk_tree_view_rows_reordered (GtkTreeModel *model,
8581 GtkTreePath *parent,
8586 GtkTreeView *tree_view = GTK_TREE_VIEW (data);
8591 len = gtk_tree_model_iter_n_children (model, iter);
8596 gtk_tree_row_reference_reordered (G_OBJECT (data),
8601 if (_gtk_tree_view_find_node (tree_view,
8607 /* We need to special case the parent path */
8609 tree = tree_view->priv->tree;
8611 tree = node->children;
8616 if (tree_view->priv->edited_column)
8617 gtk_tree_view_stop_editing (tree_view, TRUE);
8619 /* we need to be unprelighted */
8620 ensure_unprelighted (tree_view);
8622 /* clear the timeout */
8623 cancel_arrow_animation (tree_view);
8625 _gtk_rbtree_reorder (tree, new_order, len);
8627 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
8629 gtk_tree_view_dy_to_top_row (tree_view);
8633 /* Internal tree functions
8638 gtk_tree_view_get_background_xrange (GtkTreeView *tree_view,
8640 GtkTreeViewColumn *column,
8644 GtkTreeViewColumn *tmp_column = NULL;
8655 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
8658 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
8660 list = (rtl ? list->prev : list->next))
8662 tmp_column = list->data;
8664 if (tmp_column == column)
8667 if (tmp_column->visible)
8668 total_width += tmp_column->width;
8671 if (tmp_column != column)
8673 g_warning (G_STRLOC": passed-in column isn't in the tree");
8682 if (column->visible)
8683 *x2 = total_width + column->width;
8685 *x2 = total_width; /* width of 0 */
8689 gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
8696 GtkTreeViewColumn *tmp_column = NULL;
8698 gboolean indent_expanders;
8701 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
8704 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
8706 list = (rtl ? list->prev : list->next))
8708 tmp_column = list->data;
8710 if (gtk_tree_view_is_expander_column (tree_view, tmp_column))
8713 x_offset = total_width + tmp_column->width - tree_view->priv->expander_size;
8715 x_offset = total_width;
8719 if (tmp_column->visible)
8720 total_width += tmp_column->width;
8723 gtk_widget_style_get (GTK_WIDGET (tree_view),
8724 "indent-expanders", &indent_expanders,
8727 if (indent_expanders)
8730 x_offset -= tree_view->priv->expander_size * _gtk_rbtree_get_depth (tree);
8732 x_offset += tree_view->priv->expander_size * _gtk_rbtree_get_depth (tree);
8737 if (tmp_column && tmp_column->visible)
8738 /* +1 because x2 isn't included in the range. */
8739 *x2 = *x1 + tree_view->priv->expander_size + 1;
8745 gtk_tree_view_build_tree (GtkTreeView *tree_view,
8751 GtkRBNode *temp = NULL;
8752 GtkTreePath *path = NULL;
8753 gboolean is_list = GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST);
8757 gtk_tree_model_ref_node (tree_view->priv->model, iter);
8758 temp = _gtk_rbtree_insert_after (tree, temp, 0, FALSE);
8760 if (tree_view->priv->fixed_height > 0)
8762 if (GTK_RBNODE_FLAG_SET (temp, GTK_RBNODE_INVALID))
8764 _gtk_rbtree_node_set_height (tree, temp, tree_view->priv->fixed_height);
8765 _gtk_rbtree_node_mark_valid (tree, temp);
8777 path = gtk_tree_model_get_path (tree_view->priv->model, iter);
8779 gtk_tree_path_next (path);
8781 if (gtk_tree_model_iter_children (tree_view->priv->model, &child, iter))
8785 g_signal_emit (tree_view, tree_view_signals[TEST_EXPAND_ROW], 0, iter, path, &expand);
8787 if (gtk_tree_model_iter_has_child (tree_view->priv->model, iter)
8790 temp->children = _gtk_rbtree_new ();
8791 temp->children->parent_tree = tree;
8792 temp->children->parent_node = temp;
8793 gtk_tree_view_build_tree (tree_view, temp->children, &child, depth + 1, recurse);
8798 if (gtk_tree_model_iter_has_child (tree_view->priv->model, iter))
8800 if ((temp->flags>K_RBNODE_IS_PARENT) != GTK_RBNODE_IS_PARENT)
8801 temp->flags ^= GTK_RBNODE_IS_PARENT;
8804 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
8807 gtk_tree_path_free (path);
8810 /* Make sure the node is visible vertically */
8812 gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
8816 gint node_dy, height;
8817 GtkTreePath *path = NULL;
8819 if (!GTK_WIDGET_REALIZED (tree_view))
8822 /* just return if the node is visible, avoiding a costly expose */
8823 node_dy = _gtk_rbtree_node_find_offset (tree, node);
8824 height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
8825 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID)
8826 && node_dy >= tree_view->priv->vadjustment->value
8827 && node_dy + height <= (tree_view->priv->vadjustment->value
8828 + tree_view->priv->vadjustment->page_size))
8831 path = _gtk_tree_view_find_path (tree_view, tree, node);
8834 /* We process updates because we want to clear old selected items when we scroll.
8835 * if this is removed, we get a "selection streak" at the bottom. */
8836 gdk_window_process_updates (tree_view->priv->bin_window, TRUE);
8837 gtk_tree_view_scroll_to_cell (tree_view, path, NULL, FALSE, 0.0, 0.0);
8838 gtk_tree_path_free (path);
8843 gtk_tree_view_clamp_column_visible (GtkTreeView *tree_view,
8844 GtkTreeViewColumn *column,
8845 gboolean focus_to_cell)
8852 x = column->button->allocation.x;
8853 width = column->button->allocation.width;
8855 if (width > tree_view->priv->hadjustment->page_size)
8857 /* The column is larger than the horizontal page size. If the
8858 * column has cells which can be focussed individually, then we make
8859 * sure the cell which gets focus is fully visible (if even the
8860 * focus cell is bigger than the page size, we make sure the
8861 * left-hand side of the cell is visible).
8863 * If the column does not have those so-called special cells, we
8864 * make sure the left-hand side of the column is visible.
8867 if (focus_to_cell && gtk_tree_view_has_special_cell (tree_view))
8869 GtkTreePath *cursor_path;
8870 GdkRectangle background_area, cell_area, focus_area;
8872 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
8874 gtk_tree_view_get_cell_area (tree_view,
8875 cursor_path, column, &cell_area);
8876 gtk_tree_view_get_background_area (tree_view,
8877 cursor_path, column,
8880 gtk_tree_path_free (cursor_path);
8882 _gtk_tree_view_column_get_focus_area (column,
8888 width = focus_area.width;
8890 if (width < tree_view->priv->hadjustment->page_size)
8892 if ((tree_view->priv->hadjustment->value + tree_view->priv->hadjustment->page_size) < (x + width))
8893 gtk_adjustment_set_value (tree_view->priv->hadjustment,
8894 x + width - tree_view->priv->hadjustment->page_size);
8895 else if (tree_view->priv->hadjustment->value > x)
8896 gtk_adjustment_set_value (tree_view->priv->hadjustment, x);
8900 gtk_adjustment_set_value (tree_view->priv->hadjustment,
8902 tree_view->priv->hadjustment->lower,
8903 tree_view->priv->hadjustment->upper
8904 - tree_view->priv->hadjustment->page_size));
8908 if ((tree_view->priv->hadjustment->value + tree_view->priv->hadjustment->page_size) < (x + width))
8909 gtk_adjustment_set_value (tree_view->priv->hadjustment,
8910 x + width - tree_view->priv->hadjustment->page_size);
8911 else if (tree_view->priv->hadjustment->value > x)
8912 gtk_adjustment_set_value (tree_view->priv->hadjustment, x);
8916 /* This function could be more efficient. I'll optimize it if profiling seems
8917 * to imply that it is important */
8919 _gtk_tree_view_find_path (GtkTreeView *tree_view,
8924 GtkRBTree *tmp_tree;
8925 GtkRBNode *tmp_node, *last;
8928 path = gtk_tree_path_new ();
8930 g_return_val_if_fail (node != NULL, path);
8931 g_return_val_if_fail (node != tree->nil, path);
8933 count = 1 + node->left->count;
8936 tmp_node = node->parent;
8940 while (tmp_node != tmp_tree->nil)
8942 if (tmp_node->right == last)
8943 count += 1 + tmp_node->left->count;
8945 tmp_node = tmp_node->parent;
8947 gtk_tree_path_prepend_index (path, count - 1);
8948 last = tmp_tree->parent_node;
8949 tmp_tree = tmp_tree->parent_tree;
8952 count = 1 + last->left->count;
8953 tmp_node = last->parent;
8959 /* Returns TRUE if we ran out of tree before finding the path. If the path is
8960 * invalid (ie. points to a node that's not in the tree), *tree and *node are
8964 _gtk_tree_view_find_node (GtkTreeView *tree_view,
8969 GtkRBNode *tmpnode = NULL;
8970 GtkRBTree *tmptree = tree_view->priv->tree;
8971 gint *indices = gtk_tree_path_get_indices (path);
8972 gint depth = gtk_tree_path_get_depth (path);
8978 if (depth == 0 || tmptree == NULL)
8982 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
8984 if (tmpnode == NULL)
8998 tmptree = tmpnode->children;
8999 if (tmptree == NULL)
9006 gtk_tree_view_is_expander_column (GtkTreeView *tree_view,
9007 GtkTreeViewColumn *column)
9011 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST))
9014 if (tree_view->priv->expander_column != NULL)
9016 if (tree_view->priv->expander_column == column)
9022 for (list = tree_view->priv->columns;
9025 if (((GtkTreeViewColumn *)list->data)->visible)
9027 if (list && list->data == column)
9034 gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
9037 gboolean add_shifted_binding,
9038 GtkMovementStep step,
9042 gtk_binding_entry_add_signal (binding_set, keyval, modmask,
9047 if (add_shifted_binding)
9048 gtk_binding_entry_add_signal (binding_set, keyval, GDK_SHIFT_MASK,
9053 if ((modmask & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
9056 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK | GDK_SHIFT_MASK,
9061 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK,
9068 gtk_tree_view_unref_tree_helper (GtkTreeModel *model,
9073 gint retval = FALSE;
9076 g_return_val_if_fail (node != NULL, FALSE);
9081 GtkRBTree *new_tree;
9082 GtkRBNode *new_node;
9084 new_tree = node->children;
9085 new_node = new_tree->root;
9087 while (new_node && new_node->left != new_tree->nil)
9088 new_node = new_node->left;
9090 if (!gtk_tree_model_iter_children (model, &child, iter))
9093 retval = retval || gtk_tree_view_unref_tree_helper (model, &child, new_tree, new_node);
9096 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
9098 gtk_tree_model_unref_node (model, iter);
9099 node = _gtk_rbtree_next (tree, node);
9101 while (gtk_tree_model_iter_next (model, iter));
9107 gtk_tree_view_unref_and_check_selection_tree (GtkTreeView *tree_view,
9119 while (node && node->left != tree->nil)
9122 g_return_val_if_fail (node != NULL, FALSE);
9123 path = _gtk_tree_view_find_path (tree_view, tree, node);
9124 gtk_tree_model_get_iter (GTK_TREE_MODEL (tree_view->priv->model),
9126 retval = gtk_tree_view_unref_tree_helper (GTK_TREE_MODEL (tree_view->priv->model), &iter, tree, node);
9127 gtk_tree_path_free (path);
9133 gtk_tree_view_set_column_drag_info (GtkTreeView *tree_view,
9134 GtkTreeViewColumn *column)
9136 GtkTreeViewColumn *left_column;
9137 GtkTreeViewColumn *cur_column = NULL;
9138 GtkTreeViewColumnReorder *reorder;
9143 /* We want to precalculate the motion list such that we know what column slots
9147 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
9149 /* First, identify all possible drop spots */
9151 tmp_list = g_list_last (tree_view->priv->columns);
9153 tmp_list = g_list_first (tree_view->priv->columns);
9157 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
9158 tmp_list = rtl?g_list_previous (tmp_list):g_list_next (tmp_list);
9160 if (cur_column->visible == FALSE)
9163 /* If it's not the column moving and func tells us to skip over the column, we continue. */
9164 if (left_column != column && cur_column != column &&
9165 tree_view->priv->column_drop_func &&
9166 ! tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
9168 left_column = cur_column;
9171 reorder = g_slice_new0 (GtkTreeViewColumnReorder);
9172 reorder->left_column = left_column;
9173 left_column = reorder->right_column = cur_column;
9175 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
9178 /* Add the last one */
9179 if (tree_view->priv->column_drop_func == NULL ||
9180 ((left_column != column) &&
9181 tree_view->priv->column_drop_func (tree_view, column, left_column, NULL, tree_view->priv->column_drop_func_data)))
9183 reorder = g_slice_new0 (GtkTreeViewColumnReorder);
9184 reorder->left_column = left_column;
9185 reorder->right_column = NULL;
9186 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
9189 /* We quickly check to see if it even makes sense to reorder columns. */
9190 /* If there is nothing that can be moved, then we return */
9192 if (tree_view->priv->column_drag_info == NULL)
9195 /* We know there are always 2 slots possbile, as you can always return column. */
9196 /* If that's all there is, return */
9197 if (tree_view->priv->column_drag_info->next == NULL ||
9198 (tree_view->priv->column_drag_info->next->next == NULL &&
9199 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->data)->right_column == column &&
9200 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->next->data)->left_column == column))
9202 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
9203 g_slice_free (GtkTreeViewColumnReorder, tmp_list->data);
9204 g_list_free (tree_view->priv->column_drag_info);
9205 tree_view->priv->column_drag_info = NULL;
9208 /* We fill in the ranges for the columns, now that we've isolated them */
9209 left = - TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
9211 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
9213 reorder = (GtkTreeViewColumnReorder *) tmp_list->data;
9215 reorder->left_align = left;
9216 if (tmp_list->next != NULL)
9218 g_assert (tmp_list->next->data);
9219 left = reorder->right_align = (reorder->right_column->button->allocation.x +
9220 reorder->right_column->button->allocation.width +
9221 ((GtkTreeViewColumnReorder *)tmp_list->next->data)->left_column->button->allocation.x)/2;
9227 gdk_drawable_get_size (tree_view->priv->header_window, &width, NULL);
9228 reorder->right_align = width + TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
9234 _gtk_tree_view_column_start_drag (GtkTreeView *tree_view,
9235 GtkTreeViewColumn *column)
9237 GdkEvent *send_event;
9238 GtkAllocation allocation;
9239 gint x, y, width, height;
9240 GdkScreen *screen = gtk_widget_get_screen (GTK_WIDGET (tree_view));
9241 GdkDisplay *display = gdk_screen_get_display (screen);
9243 g_return_if_fail (tree_view->priv->column_drag_info == NULL);
9244 g_return_if_fail (tree_view->priv->cur_reorder == NULL);
9246 gtk_tree_view_set_column_drag_info (tree_view, column);
9248 if (tree_view->priv->column_drag_info == NULL)
9251 if (tree_view->priv->drag_window == NULL)
9253 GdkWindowAttr attributes;
9254 guint attributes_mask;
9256 attributes.window_type = GDK_WINDOW_CHILD;
9257 attributes.wclass = GDK_INPUT_OUTPUT;
9258 attributes.x = column->button->allocation.x;
9260 attributes.width = column->button->allocation.width;
9261 attributes.height = column->button->allocation.height;
9262 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
9263 attributes.colormap = gtk_widget_get_colormap (GTK_WIDGET (tree_view));
9264 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
9265 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
9267 tree_view->priv->drag_window = gdk_window_new (tree_view->priv->bin_window,
9270 gdk_window_set_user_data (tree_view->priv->drag_window, GTK_WIDGET (tree_view));
9273 gdk_display_pointer_ungrab (display, GDK_CURRENT_TIME);
9274 gdk_display_keyboard_ungrab (display, GDK_CURRENT_TIME);
9276 gtk_grab_remove (column->button);
9278 send_event = gdk_event_new (GDK_LEAVE_NOTIFY);
9279 send_event->crossing.send_event = TRUE;
9280 send_event->crossing.window = g_object_ref (GTK_BUTTON (column->button)->event_window);
9281 send_event->crossing.subwindow = NULL;
9282 send_event->crossing.detail = GDK_NOTIFY_ANCESTOR;
9283 send_event->crossing.time = GDK_CURRENT_TIME;
9285 gtk_propagate_event (column->button, send_event);
9286 gdk_event_free (send_event);
9288 send_event = gdk_event_new (GDK_BUTTON_RELEASE);
9289 send_event->button.window = g_object_ref (gdk_screen_get_root_window (screen));
9290 send_event->button.send_event = TRUE;
9291 send_event->button.time = GDK_CURRENT_TIME;
9292 send_event->button.x = -1;
9293 send_event->button.y = -1;
9294 send_event->button.axes = NULL;
9295 send_event->button.state = 0;
9296 send_event->button.button = 1;
9297 send_event->button.device = gdk_display_get_core_pointer (display);
9298 send_event->button.x_root = 0;
9299 send_event->button.y_root = 0;
9301 gtk_propagate_event (column->button, send_event);
9302 gdk_event_free (send_event);
9304 /* Kids, don't try this at home */
9305 g_object_ref (column->button);
9306 gtk_container_remove (GTK_CONTAINER (tree_view), column->button);
9307 gtk_widget_set_parent_window (column->button, tree_view->priv->drag_window);
9308 gtk_widget_set_parent (column->button, GTK_WIDGET (tree_view));
9309 g_object_unref (column->button);
9311 tree_view->priv->drag_column_x = column->button->allocation.x;
9312 allocation = column->button->allocation;
9314 gtk_widget_size_allocate (column->button, &allocation);
9315 gtk_widget_set_parent_window (column->button, tree_view->priv->drag_window);
9317 tree_view->priv->drag_column = column;
9318 gdk_window_show (tree_view->priv->drag_window);
9320 gdk_window_get_origin (tree_view->priv->header_window, &x, &y);
9321 gdk_drawable_get_size (tree_view->priv->header_window, &width, &height);
9323 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
9324 while (gtk_events_pending ())
9325 gtk_main_iteration ();
9327 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
9328 gdk_pointer_grab (tree_view->priv->drag_window,
9330 GDK_POINTER_MOTION_MASK|GDK_BUTTON_RELEASE_MASK,
9331 NULL, NULL, GDK_CURRENT_TIME);
9332 gdk_keyboard_grab (tree_view->priv->drag_window,
9338 gtk_tree_view_queue_draw_arrow (GtkTreeView *tree_view,
9341 const GdkRectangle *clip_rect)
9345 if (!GTK_WIDGET_REALIZED (tree_view))
9349 rect.width = MAX (tree_view->priv->expander_size, MAX (tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.width));
9351 rect.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
9352 rect.height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
9356 GdkRectangle new_rect;
9358 gdk_rectangle_intersect (clip_rect, &rect, &new_rect);
9360 gdk_window_invalidate_rect (tree_view->priv->bin_window, &new_rect, TRUE);
9364 gdk_window_invalidate_rect (tree_view->priv->bin_window, &rect, TRUE);
9369 _gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
9372 const GdkRectangle *clip_rect)
9376 if (!GTK_WIDGET_REALIZED (tree_view))
9380 rect.width = MAX (tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.width);
9382 rect.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
9383 rect.height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
9387 GdkRectangle new_rect;
9389 gdk_rectangle_intersect (clip_rect, &rect, &new_rect);
9391 gdk_window_invalidate_rect (tree_view->priv->bin_window, &new_rect, TRUE);
9395 gdk_window_invalidate_rect (tree_view->priv->bin_window, &rect, TRUE);
9400 gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
9402 const GdkRectangle *clip_rect)
9404 GtkRBTree *tree = NULL;
9405 GtkRBNode *node = NULL;
9407 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
9410 _gtk_tree_view_queue_draw_node (tree_view, tree, node, clip_rect);
9413 /* x and y are the mouse position
9416 gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
9419 /* in bin_window coordinates */
9428 gint vertical_separator;
9430 GtkExpanderStyle expander_style;
9432 gtk_widget_style_get (GTK_WIDGET (tree_view),
9433 "vertical-separator", &vertical_separator,
9435 expander_size = tree_view->priv->expander_size - EXPANDER_EXTRA_PADDING;
9437 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
9440 widget = GTK_WIDGET (tree_view);
9442 gtk_tree_view_get_arrow_xrange (tree_view, tree, &x_offset, &x2);
9445 area.y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
9446 area.width = expander_size + 2;
9447 area.height = MAX (CELL_HEIGHT (node, vertical_separator), (expander_size - vertical_separator));
9449 if (GTK_WIDGET_STATE (tree_view) == GTK_STATE_INSENSITIVE)
9451 state = GTK_STATE_INSENSITIVE;
9453 else if (node == tree_view->priv->button_pressed_node)
9455 if (x >= area.x && x <= (area.x + area.width) &&
9456 y >= area.y && y <= (area.y + area.height))
9457 state = GTK_STATE_ACTIVE;
9459 state = GTK_STATE_NORMAL;
9463 if (node == tree_view->priv->prelight_node &&
9464 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
9465 state = GTK_STATE_PRELIGHT;
9467 state = GTK_STATE_NORMAL;
9470 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
9471 expander_style = GTK_EXPANDER_SEMI_EXPANDED;
9472 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
9473 expander_style = GTK_EXPANDER_SEMI_COLLAPSED;
9474 else if (node->children != NULL)
9475 expander_style = GTK_EXPANDER_EXPANDED;
9477 expander_style = GTK_EXPANDER_COLLAPSED;
9479 gtk_paint_expander (widget->style,
9480 tree_view->priv->bin_window,
9485 area.x + area.width / 2,
9486 area.y + area.height / 2,
9491 gtk_tree_view_focus_to_cursor (GtkTreeView *tree_view)
9494 GtkTreePath *cursor_path;
9496 if ((tree_view->priv->tree == NULL) ||
9497 (! GTK_WIDGET_REALIZED (tree_view)))
9501 if (tree_view->priv->cursor)
9502 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9504 if (cursor_path == NULL)
9506 /* Consult the selection before defaulting to the
9507 * first focusable element
9509 GList *selected_rows;
9510 GtkTreeModel *model;
9511 GtkTreeSelection *selection;
9513 selection = gtk_tree_view_get_selection (tree_view);
9514 selected_rows = gtk_tree_selection_get_selected_rows (selection, &model);
9518 cursor_path = gtk_tree_path_copy((const GtkTreePath *)(selected_rows->data));
9519 g_list_foreach (selected_rows, (GFunc)gtk_tree_path_free, NULL);
9520 g_list_free (selected_rows);
9524 cursor_path = gtk_tree_path_new_first ();
9525 search_first_focusable_path (tree_view, &cursor_path,
9529 gtk_tree_row_reference_free (tree_view->priv->cursor);
9530 tree_view->priv->cursor = NULL;
9534 if (tree_view->priv->selection->type == GTK_SELECTION_MULTIPLE)
9535 gtk_tree_view_real_set_cursor (tree_view, cursor_path, FALSE, FALSE);
9537 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, FALSE);
9543 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
9545 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
9546 gtk_tree_path_free (cursor_path);
9548 if (tree_view->priv->focus_column == NULL)
9551 for (list = tree_view->priv->columns; list; list = list->next)
9553 if (GTK_TREE_VIEW_COLUMN (list->data)->visible)
9555 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (list->data);
9564 gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
9567 gint selection_count;
9568 GtkRBTree *cursor_tree = NULL;
9569 GtkRBNode *cursor_node = NULL;
9570 GtkRBTree *new_cursor_tree = NULL;
9571 GtkRBNode *new_cursor_node = NULL;
9572 GtkTreePath *cursor_path = NULL;
9573 gboolean grab_focus = TRUE;
9574 gboolean selectable;
9576 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
9580 if (!gtk_tree_row_reference_valid (tree_view->priv->cursor))
9581 /* FIXME: we lost the cursor; should we get the first? */
9584 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9585 _gtk_tree_view_find_node (tree_view, cursor_path,
9586 &cursor_tree, &cursor_node);
9588 if (cursor_tree == NULL)
9589 /* FIXME: we lost the cursor; should we get the first? */
9592 selection_count = gtk_tree_selection_count_selected_rows (tree_view->priv->selection);
9593 selectable = _gtk_tree_selection_row_is_selectable (tree_view->priv->selection,
9597 if (selection_count == 0
9598 && tree_view->priv->selection->type != GTK_SELECTION_NONE
9599 && !tree_view->priv->ctrl_pressed
9602 /* Don't move the cursor, but just select the current node */
9603 new_cursor_tree = cursor_tree;
9604 new_cursor_node = cursor_node;
9609 _gtk_rbtree_prev_full (cursor_tree, cursor_node,
9610 &new_cursor_tree, &new_cursor_node);
9612 _gtk_rbtree_next_full (cursor_tree, cursor_node,
9613 &new_cursor_tree, &new_cursor_node);
9616 gtk_tree_path_free (cursor_path);
9618 if (new_cursor_node)
9620 cursor_path = _gtk_tree_view_find_path (tree_view,
9621 new_cursor_tree, new_cursor_node);
9623 search_first_focusable_path (tree_view, &cursor_path,
9629 gtk_tree_path_free (cursor_path);
9633 * If the list has only one item and multi-selection is set then select
9634 * the row (if not yet selected).
9636 if (tree_view->priv->selection->type == GTK_SELECTION_MULTIPLE &&
9637 new_cursor_node == NULL)
9640 _gtk_rbtree_next_full (cursor_tree, cursor_node,
9641 &new_cursor_tree, &new_cursor_node);
9643 _gtk_rbtree_prev_full (cursor_tree, cursor_node,
9644 &new_cursor_tree, &new_cursor_node);
9646 if (new_cursor_node == NULL
9647 && !GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_SELECTED))
9649 new_cursor_node = cursor_node;
9650 new_cursor_tree = cursor_tree;
9654 new_cursor_node = NULL;
9658 if (new_cursor_node)
9660 cursor_path = _gtk_tree_view_find_path (tree_view, new_cursor_tree, new_cursor_node);
9661 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, TRUE);
9662 gtk_tree_path_free (cursor_path);
9666 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
9668 if (!tree_view->priv->shift_pressed)
9670 if (! gtk_widget_keynav_failed (GTK_WIDGET (tree_view),
9672 GTK_DIR_UP : GTK_DIR_DOWN))
9674 GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (tree_view));
9677 gtk_widget_child_focus (toplevel,
9679 GTK_DIR_TAB_BACKWARD :
9680 GTK_DIR_TAB_FORWARD);
9687 gtk_widget_error_bell (GTK_WIDGET (tree_view));
9692 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
9696 gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
9699 GtkRBTree *cursor_tree = NULL;
9700 GtkRBNode *cursor_node = NULL;
9701 GtkTreePath *old_cursor_path = NULL;
9702 GtkTreePath *cursor_path = NULL;
9703 GtkRBTree *start_cursor_tree = NULL;
9704 GtkRBNode *start_cursor_node = NULL;
9707 gint vertical_separator;
9709 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
9712 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
9713 old_cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9715 /* This is sorta weird. Focus in should give us a cursor */
9718 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical-separator", &vertical_separator, NULL);
9719 _gtk_tree_view_find_node (tree_view, old_cursor_path,
9720 &cursor_tree, &cursor_node);
9722 if (cursor_tree == NULL)
9724 /* FIXME: we lost the cursor. Should we try to get one? */
9725 gtk_tree_path_free (old_cursor_path);
9728 g_return_if_fail (cursor_node != NULL);
9730 y = _gtk_rbtree_node_find_offset (cursor_tree, cursor_node);
9731 window_y = RBTREE_Y_TO_TREE_WINDOW_Y (tree_view, y);
9732 y += tree_view->priv->cursor_offset;
9733 y += count * (int)tree_view->priv->vadjustment->page_increment;
9734 y = CLAMP (y, (gint)tree_view->priv->vadjustment->lower, (gint)tree_view->priv->vadjustment->upper - vertical_separator);
9736 if (y >= tree_view->priv->height)
9737 y = tree_view->priv->height - 1;
9739 tree_view->priv->cursor_offset =
9740 _gtk_rbtree_find_offset (tree_view->priv->tree, y,
9741 &cursor_tree, &cursor_node);
9743 if (tree_view->priv->cursor_offset > BACKGROUND_HEIGHT (cursor_node))
9745 _gtk_rbtree_next_full (cursor_tree, cursor_node,
9746 &cursor_tree, &cursor_node);
9747 tree_view->priv->cursor_offset -= BACKGROUND_HEIGHT (cursor_node);
9750 y -= tree_view->priv->cursor_offset;
9751 cursor_path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
9753 start_cursor_tree = cursor_tree;
9754 start_cursor_node = cursor_node;
9756 if (! search_first_focusable_path (tree_view, &cursor_path,
9758 &cursor_tree, &cursor_node))
9760 /* It looks like we reached the end of the view without finding
9761 * a focusable row. We will step backwards to find the last
9764 cursor_tree = start_cursor_tree;
9765 cursor_node = start_cursor_node;
9766 cursor_path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
9768 search_first_focusable_path (tree_view, &cursor_path,
9770 &cursor_tree, &cursor_node);
9777 y = _gtk_rbtree_node_find_offset (cursor_tree, cursor_node);
9779 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, FALSE);
9782 gtk_tree_view_scroll_to_point (tree_view, -1, y);
9783 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
9784 _gtk_tree_view_queue_draw_node (tree_view, cursor_tree, cursor_node, NULL);
9786 if (!gtk_tree_path_compare (old_cursor_path, cursor_path))
9787 gtk_widget_error_bell (GTK_WIDGET (tree_view));
9789 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
9792 gtk_tree_path_free (old_cursor_path);
9793 gtk_tree_path_free (cursor_path);
9797 gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
9800 GtkRBTree *cursor_tree = NULL;
9801 GtkRBNode *cursor_node = NULL;
9802 GtkTreePath *cursor_path = NULL;
9803 GtkTreeViewColumn *column;
9806 gboolean found_column = FALSE;
9809 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
9811 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
9814 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
9815 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9819 _gtk_tree_view_find_node (tree_view, cursor_path, &cursor_tree, &cursor_node);
9820 if (cursor_tree == NULL)
9822 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, cursor_path) == FALSE)
9824 gtk_tree_path_free (cursor_path);
9827 gtk_tree_path_free (cursor_path);
9829 list = rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns);
9830 if (tree_view->priv->focus_column)
9832 for (; list; list = (rtl ? list->prev : list->next))
9834 if (list->data == tree_view->priv->focus_column)
9841 gboolean left, right;
9843 column = list->data;
9844 if (column->visible == FALSE)
9847 gtk_tree_view_column_cell_set_cell_data (column,
9848 tree_view->priv->model,
9850 GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_PARENT),
9851 cursor_node->children?TRUE:FALSE);
9855 right = list->prev ? TRUE : FALSE;
9856 left = list->next ? TRUE : FALSE;
9860 left = list->prev ? TRUE : FALSE;
9861 right = list->next ? TRUE : FALSE;
9864 if (_gtk_tree_view_column_cell_focus (column, count, left, right))
9866 tree_view->priv->focus_column = column;
9867 found_column = TRUE;
9872 list = rtl ? list->prev : list->next;
9874 list = rtl ? list->next : list->prev;
9879 if (!gtk_tree_view_has_special_cell (tree_view))
9880 _gtk_tree_view_queue_draw_node (tree_view,
9884 g_signal_emit (tree_view, tree_view_signals[CURSOR_CHANGED], 0);
9885 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
9889 gtk_widget_error_bell (GTK_WIDGET (tree_view));
9892 gtk_tree_view_clamp_column_visible (tree_view,
9893 tree_view->priv->focus_column, TRUE);
9897 gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
9900 GtkRBTree *cursor_tree;
9901 GtkRBNode *cursor_node;
9903 GtkTreePath *old_path;
9905 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
9908 g_return_if_fail (tree_view->priv->tree != NULL);
9910 gtk_tree_view_get_cursor (tree_view, &old_path, NULL);
9912 cursor_tree = tree_view->priv->tree;
9913 cursor_node = cursor_tree->root;
9917 while (cursor_node && cursor_node->left != cursor_tree->nil)
9918 cursor_node = cursor_node->left;
9920 /* Now go forward to find the first focusable row. */
9921 path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
9922 search_first_focusable_path (tree_view, &path,
9923 TRUE, &cursor_tree, &cursor_node);
9929 while (cursor_node && cursor_node->right != cursor_tree->nil)
9930 cursor_node = cursor_node->right;
9931 if (cursor_node->children == NULL)
9934 cursor_tree = cursor_node->children;
9935 cursor_node = cursor_tree->root;
9939 /* Now go backwards to find last focusable row. */
9940 path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
9941 search_first_focusable_path (tree_view, &path,
9942 FALSE, &cursor_tree, &cursor_node);
9948 if (gtk_tree_path_compare (old_path, path))
9950 gtk_tree_view_real_set_cursor (tree_view, path, TRUE, TRUE);
9951 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
9955 gtk_widget_error_bell (GTK_WIDGET (tree_view));
9959 gtk_tree_path_free (old_path);
9960 gtk_tree_path_free (path);
9964 gtk_tree_view_real_select_all (GtkTreeView *tree_view)
9966 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
9969 if (tree_view->priv->selection->type != GTK_SELECTION_MULTIPLE)
9972 gtk_tree_selection_select_all (tree_view->priv->selection);
9978 gtk_tree_view_real_unselect_all (GtkTreeView *tree_view)
9980 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
9983 if (tree_view->priv->selection->type != GTK_SELECTION_MULTIPLE)
9986 gtk_tree_selection_unselect_all (tree_view->priv->selection);
9992 gtk_tree_view_real_select_cursor_row (GtkTreeView *tree_view,
9993 gboolean start_editing)
9995 GtkRBTree *new_tree = NULL;
9996 GtkRBNode *new_node = NULL;
9997 GtkRBTree *cursor_tree = NULL;
9998 GtkRBNode *cursor_node = NULL;
9999 GtkTreePath *cursor_path = NULL;
10000 GtkTreeSelectMode mode = 0;
10002 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
10005 if (tree_view->priv->cursor)
10006 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
10008 if (cursor_path == NULL)
10011 _gtk_tree_view_find_node (tree_view, cursor_path,
10012 &cursor_tree, &cursor_node);
10014 if (cursor_tree == NULL)
10016 gtk_tree_path_free (cursor_path);
10020 if (!tree_view->priv->shift_pressed && start_editing &&
10021 tree_view->priv->focus_column)
10023 if (gtk_tree_view_start_editing (tree_view, cursor_path))
10025 gtk_tree_path_free (cursor_path);
10030 if (tree_view->priv->ctrl_pressed)
10031 mode |= GTK_TREE_SELECT_MODE_TOGGLE;
10032 if (tree_view->priv->shift_pressed)
10033 mode |= GTK_TREE_SELECT_MODE_EXTEND;
10035 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
10042 /* We bail out if the original (tree, node) don't exist anymore after
10043 * handling the selection-changed callback. We do return TRUE because
10044 * the key press has been handled at this point.
10046 _gtk_tree_view_find_node (tree_view, cursor_path, &new_tree, &new_node);
10048 if (cursor_tree != new_tree || cursor_node != new_node)
10051 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
10053 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
10054 _gtk_tree_view_queue_draw_node (tree_view, cursor_tree, cursor_node, NULL);
10056 if (!tree_view->priv->shift_pressed)
10057 gtk_tree_view_row_activated (tree_view, cursor_path,
10058 tree_view->priv->focus_column);
10060 gtk_tree_path_free (cursor_path);
10066 gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view)
10068 GtkRBTree *new_tree = NULL;
10069 GtkRBNode *new_node = NULL;
10070 GtkRBTree *cursor_tree = NULL;
10071 GtkRBNode *cursor_node = NULL;
10072 GtkTreePath *cursor_path = NULL;
10074 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
10077 cursor_path = NULL;
10078 if (tree_view->priv->cursor)
10079 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
10081 if (cursor_path == NULL)
10084 _gtk_tree_view_find_node (tree_view, cursor_path,
10085 &cursor_tree, &cursor_node);
10086 if (cursor_tree == NULL)
10088 gtk_tree_path_free (cursor_path);
10092 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
10096 GTK_TREE_SELECT_MODE_TOGGLE,
10099 /* We bail out if the original (tree, node) don't exist anymore after
10100 * handling the selection-changed callback. We do return TRUE because
10101 * the key press has been handled at this point.
10103 _gtk_tree_view_find_node (tree_view, cursor_path, &new_tree, &new_node);
10105 if (cursor_tree != new_tree || cursor_node != new_node)
10108 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
10110 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
10111 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
10112 gtk_tree_path_free (cursor_path);
10118 gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
10123 GtkTreePath *cursor_path = NULL;
10127 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
10130 cursor_path = NULL;
10131 if (tree_view->priv->cursor)
10132 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
10134 if (cursor_path == NULL)
10137 if (_gtk_tree_view_find_node (tree_view, cursor_path, &tree, &node))
10140 /* Don't handle the event if we aren't an expander */
10141 if (!((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT))
10145 && gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL)
10149 gtk_tree_view_real_expand_row (tree_view, cursor_path, tree, node, open_all, TRUE);
10151 gtk_tree_view_real_collapse_row (tree_view, cursor_path, tree, node, TRUE);
10153 gtk_tree_path_free (cursor_path);
10159 gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view)
10161 GtkRBTree *cursor_tree = NULL;
10162 GtkRBNode *cursor_node = NULL;
10163 GtkTreePath *cursor_path = NULL;
10164 GdkModifierType state;
10166 if (! GTK_WIDGET_HAS_FOCUS (tree_view))
10169 cursor_path = NULL;
10170 if (tree_view->priv->cursor)
10171 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
10173 if (cursor_path == NULL)
10176 _gtk_tree_view_find_node (tree_view, cursor_path,
10177 &cursor_tree, &cursor_node);
10178 if (cursor_tree == NULL)
10180 gtk_tree_path_free (cursor_path);
10184 if (cursor_tree->parent_node)
10186 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
10187 cursor_node = cursor_tree->parent_node;
10188 cursor_tree = cursor_tree->parent_tree;
10190 gtk_tree_path_up (cursor_path);
10192 if (gtk_get_current_event_state (&state))
10194 if ((state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
10195 tree_view->priv->ctrl_pressed = TRUE;
10198 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, FALSE);
10199 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
10201 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
10202 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
10203 gtk_tree_path_free (cursor_path);
10205 tree_view->priv->ctrl_pressed = FALSE;
10212 tree_view->priv->search_entry_avoid_unhandled_binding = TRUE;
10217 gtk_tree_view_search_entry_flush_timeout (GtkTreeView *tree_view)
10219 gtk_tree_view_search_dialog_hide (tree_view->priv->search_window, tree_view);
10220 tree_view->priv->typeselect_flush_timeout = 0;
10225 /* Cut and paste from gtkwindow.c */
10227 send_focus_change (GtkWidget *widget,
10230 GdkEvent *fevent = gdk_event_new (GDK_FOCUS_CHANGE);
10232 g_object_ref (widget);
10235 GTK_WIDGET_SET_FLAGS (widget, GTK_HAS_FOCUS);
10237 GTK_WIDGET_UNSET_FLAGS (widget, GTK_HAS_FOCUS);
10239 fevent->focus_change.type = GDK_FOCUS_CHANGE;
10240 fevent->focus_change.window = g_object_ref (widget->window);
10241 fevent->focus_change.in = in;
10243 gtk_widget_event (widget, fevent);
10245 g_object_notify (G_OBJECT (widget), "has-focus");
10247 g_object_unref (widget);
10248 gdk_event_free (fevent);
10252 gtk_tree_view_ensure_interactive_directory (GtkTreeView *tree_view)
10254 GtkWidget *frame, *vbox, *toplevel;
10257 if (tree_view->priv->search_custom_entry_set)
10260 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (tree_view));
10261 screen = gtk_widget_get_screen (GTK_WIDGET (tree_view));
10263 if (tree_view->priv->search_window != NULL)
10265 if (GTK_WINDOW (toplevel)->group)
10266 gtk_window_group_add_window (GTK_WINDOW (toplevel)->group,
10267 GTK_WINDOW (tree_view->priv->search_window));
10268 else if (GTK_WINDOW (tree_view->priv->search_window)->group)
10269 gtk_window_group_remove_window (GTK_WINDOW (tree_view->priv->search_window)->group,
10270 GTK_WINDOW (tree_view->priv->search_window));
10271 gtk_window_set_screen (GTK_WINDOW (tree_view->priv->search_window), screen);
10275 tree_view->priv->search_window = gtk_window_new (GTK_WINDOW_POPUP);
10276 gtk_window_set_screen (GTK_WINDOW (tree_view->priv->search_window), screen);
10278 if (GTK_WINDOW (toplevel)->group)
10279 gtk_window_group_add_window (GTK_WINDOW (toplevel)->group,
10280 GTK_WINDOW (tree_view->priv->search_window));
10282 gtk_window_set_type_hint (GTK_WINDOW (tree_view->priv->search_window),
10283 GDK_WINDOW_TYPE_HINT_UTILITY);
10284 gtk_window_set_modal (GTK_WINDOW (tree_view->priv->search_window), TRUE);
10285 g_signal_connect (tree_view->priv->search_window, "delete-event",
10286 G_CALLBACK (gtk_tree_view_search_delete_event),
10288 g_signal_connect (tree_view->priv->search_window, "key-press-event",
10289 G_CALLBACK (gtk_tree_view_search_key_press_event),
10291 g_signal_connect (tree_view->priv->search_window, "button-press-event",
10292 G_CALLBACK (gtk_tree_view_search_button_press_event),
10294 g_signal_connect (tree_view->priv->search_window, "scroll-event",
10295 G_CALLBACK (gtk_tree_view_search_scroll_event),
10298 frame = gtk_frame_new (NULL);
10299 gtk_frame_set_shadow_type (GTK_FRAME (frame), GTK_SHADOW_ETCHED_IN);
10300 gtk_widget_show (frame);
10301 gtk_container_add (GTK_CONTAINER (tree_view->priv->search_window), frame);
10303 vbox = gtk_vbox_new (FALSE, 0);
10304 gtk_widget_show (vbox);
10305 gtk_container_add (GTK_CONTAINER (frame), vbox);
10306 gtk_container_set_border_width (GTK_CONTAINER (vbox), 3);
10309 tree_view->priv->search_entry = gtk_entry_new ();
10310 gtk_widget_show (tree_view->priv->search_entry);
10311 g_signal_connect (tree_view->priv->search_entry, "populate-popup",
10312 G_CALLBACK (gtk_tree_view_search_disable_popdown),
10314 g_signal_connect (tree_view->priv->search_entry,
10315 "activate", G_CALLBACK (gtk_tree_view_search_activate),
10317 g_signal_connect (GTK_ENTRY (tree_view->priv->search_entry)->im_context,
10319 G_CALLBACK (gtk_tree_view_search_preedit_changed),
10321 gtk_container_add (GTK_CONTAINER (vbox),
10322 tree_view->priv->search_entry);
10324 gtk_widget_realize (tree_view->priv->search_entry);
10327 /* Pops up the interactive search entry. If keybinding is TRUE then the user
10328 * started this by typing the start_interactive_search keybinding. Otherwise, it came from
10331 gtk_tree_view_real_start_interactive_search (GtkTreeView *tree_view,
10332 gboolean keybinding)
10334 /* We only start interactive search if we have focus or the columns
10335 * have focus. If one of our children have focus, we don't want to
10336 * start the search.
10339 gboolean found_focus = FALSE;
10340 GtkWidgetClass *entry_parent_class;
10342 if (!tree_view->priv->enable_search && !keybinding)
10345 if (tree_view->priv->search_custom_entry_set)
10348 if (tree_view->priv->search_window != NULL &&
10349 GTK_WIDGET_VISIBLE (tree_view->priv->search_window))
10352 for (list = tree_view->priv->columns; list; list = list->next)
10354 GtkTreeViewColumn *column;
10356 column = list->data;
10357 if (! column->visible)
10360 if (GTK_WIDGET_HAS_FOCUS (column->button))
10362 found_focus = TRUE;
10367 if (GTK_WIDGET_HAS_FOCUS (tree_view))
10368 found_focus = TRUE;
10373 if (tree_view->priv->search_column < 0)
10376 gtk_tree_view_ensure_interactive_directory (tree_view);
10379 gtk_entry_set_text (GTK_ENTRY (tree_view->priv->search_entry), "");
10381 /* done, show it */
10382 tree_view->priv->search_position_func (tree_view, tree_view->priv->search_window, tree_view->priv->search_position_user_data);
10383 gtk_widget_show (tree_view->priv->search_window);
10384 if (tree_view->priv->search_entry_changed_id == 0)
10386 tree_view->priv->search_entry_changed_id =
10387 g_signal_connect (tree_view->priv->search_entry, "changed",
10388 G_CALLBACK (gtk_tree_view_search_init),
10392 tree_view->priv->typeselect_flush_timeout =
10393 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
10394 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
10397 /* Grab focus will select all the text. We don't want that to happen, so we
10398 * call the parent instance and bypass the selection change. This is probably
10399 * really non-kosher. */
10400 entry_parent_class = g_type_class_peek_parent (GTK_ENTRY_GET_CLASS (tree_view->priv->search_entry));
10401 (entry_parent_class->grab_focus) (tree_view->priv->search_entry);
10403 /* send focus-in event */
10404 send_focus_change (tree_view->priv->search_entry, TRUE);
10406 /* search first matching iter */
10407 gtk_tree_view_search_init (tree_view->priv->search_entry, tree_view);
10413 gtk_tree_view_start_interactive_search (GtkTreeView *tree_view)
10415 return gtk_tree_view_real_start_interactive_search (tree_view, TRUE);
10418 /* this function returns the new width of the column being resized given
10419 * the column and x position of the cursor; the x cursor position is passed
10420 * in as a pointer and automagicly corrected if it's beyond min/max limits
10423 gtk_tree_view_new_column_width (GtkTreeView *tree_view,
10427 GtkTreeViewColumn *column;
10431 /* first translate the x position from widget->window
10432 * to clist->clist_window
10434 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
10435 column = g_list_nth (tree_view->priv->columns, i)->data;
10436 width = rtl ? (column->button->allocation.x + column->button->allocation.width - *x) : (*x - column->button->allocation.x);
10438 /* Clamp down the value */
10439 if (column->min_width == -1)
10440 width = MAX (column->button->requisition.width,
10443 width = MAX (column->min_width,
10445 if (column->max_width != -1)
10446 width = MIN (width, column->max_width);
10448 *x = rtl ? (column->button->allocation.x + column->button->allocation.width - width) : (column->button->allocation.x + width);
10454 /* FIXME this adjust_allocation is a big cut-and-paste from
10455 * GtkCList, needs to be some "official" way to do this
10465 /* The window to which widget->window is relative */
10466 #define ALLOCATION_WINDOW(widget) \
10467 (GTK_WIDGET_NO_WINDOW (widget) ? \
10468 (widget)->window : \
10469 gdk_window_get_parent ((widget)->window))
10472 adjust_allocation_recurse (GtkWidget *widget,
10475 ScrollData *scroll_data = data;
10477 /* Need to really size allocate instead of just poking
10478 * into widget->allocation if the widget is not realized.
10479 * FIXME someone figure out why this was.
10481 if (!GTK_WIDGET_REALIZED (widget))
10483 if (GTK_WIDGET_VISIBLE (widget))
10485 GdkRectangle tmp_rectangle = widget->allocation;
10486 tmp_rectangle.x += scroll_data->dx;
10487 tmp_rectangle.y += scroll_data->dy;
10489 gtk_widget_size_allocate (widget, &tmp_rectangle);
10494 if (ALLOCATION_WINDOW (widget) == scroll_data->window)
10496 widget->allocation.x += scroll_data->dx;
10497 widget->allocation.y += scroll_data->dy;
10499 if (GTK_IS_CONTAINER (widget))
10500 gtk_container_forall (GTK_CONTAINER (widget),
10501 adjust_allocation_recurse,
10508 adjust_allocation (GtkWidget *widget,
10512 ScrollData scroll_data;
10514 if (GTK_WIDGET_REALIZED (widget))
10515 scroll_data.window = ALLOCATION_WINDOW (widget);
10517 scroll_data.window = NULL;
10519 scroll_data.dx = dx;
10520 scroll_data.dy = dy;
10522 adjust_allocation_recurse (widget, &scroll_data);
10527 gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
10528 GtkTreeView *tree_view)
10530 if (GTK_WIDGET_REALIZED (tree_view))
10534 gdk_window_move (tree_view->priv->bin_window,
10535 - tree_view->priv->hadjustment->value,
10536 TREE_VIEW_HEADER_HEIGHT (tree_view));
10537 gdk_window_move (tree_view->priv->header_window,
10538 - tree_view->priv->hadjustment->value,
10540 dy = tree_view->priv->dy - (int) tree_view->priv->vadjustment->value;
10541 if (dy && tree_view->priv->edited_column)
10543 if (GTK_IS_WIDGET (tree_view->priv->edited_column->editable_widget))
10547 GtkTreeViewChild *child = NULL;
10549 widget = GTK_WIDGET (tree_view->priv->edited_column->editable_widget);
10550 adjust_allocation (widget, 0, dy);
10552 for (list = tree_view->priv->children; list; list = list->next)
10554 child = (GtkTreeViewChild *)list->data;
10555 if (child->widget == widget)
10563 gdk_window_scroll (tree_view->priv->bin_window, 0, dy);
10565 if (tree_view->priv->dy != (int) tree_view->priv->vadjustment->value)
10567 /* update our dy and top_row */
10568 tree_view->priv->dy = (int) tree_view->priv->vadjustment->value;
10570 if (!tree_view->priv->in_top_row_to_dy)
10571 gtk_tree_view_dy_to_top_row (tree_view);
10574 gdk_window_process_updates (tree_view->priv->header_window, TRUE);
10575 gdk_window_process_updates (tree_view->priv->bin_window, TRUE);
10585 * gtk_tree_view_new:
10587 * Creates a new #GtkTreeView widget.
10589 * Return value: A newly created #GtkTreeView widget.
10592 gtk_tree_view_new (void)
10594 return g_object_new (GTK_TYPE_TREE_VIEW, NULL);
10598 * gtk_tree_view_new_with_model:
10599 * @model: the model.
10601 * Creates a new #GtkTreeView widget with the model initialized to @model.
10603 * Return value: A newly created #GtkTreeView widget.
10606 gtk_tree_view_new_with_model (GtkTreeModel *model)
10608 return g_object_new (GTK_TYPE_TREE_VIEW, "model", model, NULL);
10611 /* Public Accessors
10615 * gtk_tree_view_get_model:
10616 * @tree_view: a #GtkTreeView
10618 * Returns the model the #GtkTreeView is based on. Returns %NULL if the
10621 * Return value: A #GtkTreeModel, or %NULL if none is currently being used.
10624 gtk_tree_view_get_model (GtkTreeView *tree_view)
10626 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
10628 return tree_view->priv->model;
10632 * gtk_tree_view_set_model:
10633 * @tree_view: A #GtkTreeNode.
10634 * @model: The model.
10636 * Sets the model for a #GtkTreeView. If the @tree_view already has a model
10637 * set, it will remove it before setting the new model. If @model is %NULL,
10638 * then it will unset the old model.
10641 gtk_tree_view_set_model (GtkTreeView *tree_view,
10642 GtkTreeModel *model)
10644 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10645 g_return_if_fail (model == NULL || GTK_IS_TREE_MODEL (model));
10647 if (model == tree_view->priv->model)
10650 if (tree_view->priv->scroll_to_path)
10652 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
10653 tree_view->priv->scroll_to_path = NULL;
10656 if (tree_view->priv->model)
10658 GList *tmplist = tree_view->priv->columns;
10660 gtk_tree_view_unref_and_check_selection_tree (tree_view, tree_view->priv->tree);
10661 gtk_tree_view_stop_editing (tree_view, TRUE);
10663 remove_expand_collapse_timeout (tree_view);
10665 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10666 gtk_tree_view_row_changed,
10668 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10669 gtk_tree_view_row_inserted,
10671 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10672 gtk_tree_view_row_has_child_toggled,
10674 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10675 gtk_tree_view_row_deleted,
10677 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10678 gtk_tree_view_rows_reordered,
10681 for (; tmplist; tmplist = tmplist->next)
10682 _gtk_tree_view_column_unset_model (tmplist->data,
10683 tree_view->priv->model);
10685 if (tree_view->priv->tree)
10686 gtk_tree_view_free_rbtree (tree_view);
10688 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
10689 tree_view->priv->drag_dest_row = NULL;
10690 gtk_tree_row_reference_free (tree_view->priv->cursor);
10691 tree_view->priv->cursor = NULL;
10692 gtk_tree_row_reference_free (tree_view->priv->anchor);
10693 tree_view->priv->anchor = NULL;
10694 gtk_tree_row_reference_free (tree_view->priv->top_row);
10695 tree_view->priv->top_row = NULL;
10696 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
10697 tree_view->priv->scroll_to_path = NULL;
10699 tree_view->priv->scroll_to_column = NULL;
10701 g_object_unref (tree_view->priv->model);
10703 tree_view->priv->search_column = -1;
10704 tree_view->priv->fixed_height_check = 0;
10705 tree_view->priv->fixed_height = -1;
10706 tree_view->priv->dy = tree_view->priv->top_row_dy = 0;
10707 tree_view->priv->last_button_x = -1;
10708 tree_view->priv->last_button_y = -1;
10711 tree_view->priv->model = model;
10713 if (tree_view->priv->model)
10718 GtkTreeModelFlags flags;
10720 if (tree_view->priv->search_column == -1)
10722 for (i = 0; i < gtk_tree_model_get_n_columns (model); i++)
10724 GType type = gtk_tree_model_get_column_type (model, i);
10726 if (g_value_type_transformable (type, G_TYPE_STRING))
10728 tree_view->priv->search_column = i;
10734 g_object_ref (tree_view->priv->model);
10735 g_signal_connect (tree_view->priv->model,
10737 G_CALLBACK (gtk_tree_view_row_changed),
10739 g_signal_connect (tree_view->priv->model,
10741 G_CALLBACK (gtk_tree_view_row_inserted),
10743 g_signal_connect (tree_view->priv->model,
10744 "row-has-child-toggled",
10745 G_CALLBACK (gtk_tree_view_row_has_child_toggled),
10747 g_signal_connect (tree_view->priv->model,
10749 G_CALLBACK (gtk_tree_view_row_deleted),
10751 g_signal_connect (tree_view->priv->model,
10753 G_CALLBACK (gtk_tree_view_rows_reordered),
10756 flags = gtk_tree_model_get_flags (tree_view->priv->model);
10757 if ((flags & GTK_TREE_MODEL_LIST_ONLY) == GTK_TREE_MODEL_LIST_ONLY)
10758 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
10760 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
10762 path = gtk_tree_path_new_first ();
10763 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, path))
10765 tree_view->priv->tree = _gtk_rbtree_new ();
10766 gtk_tree_view_build_tree (tree_view, tree_view->priv->tree, &iter, 1, FALSE);
10768 gtk_tree_path_free (path);
10770 /* FIXME: do I need to do this? gtk_tree_view_create_buttons (tree_view); */
10771 install_presize_handler (tree_view);
10774 g_object_notify (G_OBJECT (tree_view), "model");
10776 if (tree_view->priv->selection)
10777 _gtk_tree_selection_emit_changed (tree_view->priv->selection);
10779 if (GTK_WIDGET_REALIZED (tree_view))
10780 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
10784 * gtk_tree_view_get_selection:
10785 * @tree_view: A #GtkTreeView.
10787 * Gets the #GtkTreeSelection associated with @tree_view.
10789 * Return value: A #GtkTreeSelection object.
10792 gtk_tree_view_get_selection (GtkTreeView *tree_view)
10794 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
10796 return tree_view->priv->selection;
10800 * gtk_tree_view_get_hadjustment:
10801 * @tree_view: A #GtkTreeView
10803 * Gets the #GtkAdjustment currently being used for the horizontal aspect.
10805 * Return value: A #GtkAdjustment object, or %NULL if none is currently being
10809 gtk_tree_view_get_hadjustment (GtkTreeView *tree_view)
10811 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
10813 if (tree_view->priv->hadjustment == NULL)
10814 gtk_tree_view_set_hadjustment (tree_view, NULL);
10816 return tree_view->priv->hadjustment;
10820 * gtk_tree_view_set_hadjustment:
10821 * @tree_view: A #GtkTreeView
10822 * @adjustment: The #GtkAdjustment to set, or %NULL
10824 * Sets the #GtkAdjustment for the current horizontal aspect.
10827 gtk_tree_view_set_hadjustment (GtkTreeView *tree_view,
10828 GtkAdjustment *adjustment)
10830 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10832 gtk_tree_view_set_adjustments (tree_view,
10834 tree_view->priv->vadjustment);
10836 g_object_notify (G_OBJECT (tree_view), "hadjustment");
10840 * gtk_tree_view_get_vadjustment:
10841 * @tree_view: A #GtkTreeView
10843 * Gets the #GtkAdjustment currently being used for the vertical aspect.
10845 * Return value: A #GtkAdjustment object, or %NULL if none is currently being
10849 gtk_tree_view_get_vadjustment (GtkTreeView *tree_view)
10851 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
10853 if (tree_view->priv->vadjustment == NULL)
10854 gtk_tree_view_set_vadjustment (tree_view, NULL);
10856 return tree_view->priv->vadjustment;
10860 * gtk_tree_view_set_vadjustment:
10861 * @tree_view: A #GtkTreeView
10862 * @adjustment: The #GtkAdjustment to set, or %NULL
10864 * Sets the #GtkAdjustment for the current vertical aspect.
10867 gtk_tree_view_set_vadjustment (GtkTreeView *tree_view,
10868 GtkAdjustment *adjustment)
10870 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10872 gtk_tree_view_set_adjustments (tree_view,
10873 tree_view->priv->hadjustment,
10876 g_object_notify (G_OBJECT (tree_view), "vadjustment");
10879 /* Column and header operations */
10882 * gtk_tree_view_get_headers_visible:
10883 * @tree_view: A #GtkTreeView.
10885 * Returns %TRUE if the headers on the @tree_view are visible.
10887 * Return value: Whether the headers are visible or not.
10890 gtk_tree_view_get_headers_visible (GtkTreeView *tree_view)
10892 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
10894 return GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
10898 * gtk_tree_view_set_headers_visible:
10899 * @tree_view: A #GtkTreeView.
10900 * @headers_visible: %TRUE if the headers are visible
10902 * Sets the visibility state of the headers.
10905 gtk_tree_view_set_headers_visible (GtkTreeView *tree_view,
10906 gboolean headers_visible)
10910 GtkTreeViewColumn *column;
10912 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10914 headers_visible = !! headers_visible;
10916 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE) == headers_visible)
10919 if (headers_visible)
10920 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
10922 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
10924 if (GTK_WIDGET_REALIZED (tree_view))
10926 gdk_window_get_position (tree_view->priv->bin_window, &x, &y);
10927 if (headers_visible)
10929 gdk_window_move_resize (tree_view->priv->bin_window, x, y + TREE_VIEW_HEADER_HEIGHT (tree_view), tree_view->priv->width, GTK_WIDGET (tree_view)->allocation.height - + TREE_VIEW_HEADER_HEIGHT (tree_view));
10931 if (GTK_WIDGET_MAPPED (tree_view))
10932 gtk_tree_view_map_buttons (tree_view);
10936 gdk_window_move_resize (tree_view->priv->bin_window, x, y, tree_view->priv->width, tree_view->priv->height);
10938 for (list = tree_view->priv->columns; list; list = list->next)
10940 column = list->data;
10941 gtk_widget_unmap (column->button);
10943 gdk_window_hide (tree_view->priv->header_window);
10947 tree_view->priv->vadjustment->page_size = GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
10948 tree_view->priv->vadjustment->page_increment = (GTK_WIDGET (tree_view)->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view)) / 2;
10949 tree_view->priv->vadjustment->lower = 0;
10950 tree_view->priv->vadjustment->upper = tree_view->priv->height;
10951 gtk_adjustment_changed (tree_view->priv->vadjustment);
10953 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
10955 g_object_notify (G_OBJECT (tree_view), "headers-visible");
10959 * gtk_tree_view_columns_autosize:
10960 * @tree_view: A #GtkTreeView.
10962 * Resizes all columns to their optimal width. Only works after the
10963 * treeview has been realized.
10966 gtk_tree_view_columns_autosize (GtkTreeView *tree_view)
10968 gboolean dirty = FALSE;
10970 GtkTreeViewColumn *column;
10972 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10974 for (list = tree_view->priv->columns; list; list = list->next)
10976 column = list->data;
10977 if (column->column_type == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
10979 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
10984 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
10988 * gtk_tree_view_set_headers_clickable:
10989 * @tree_view: A #GtkTreeView.
10990 * @setting: %TRUE if the columns are clickable.
10992 * Allow the column title buttons to be clicked.
10995 gtk_tree_view_set_headers_clickable (GtkTreeView *tree_view,
11000 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11002 for (list = tree_view->priv->columns; list; list = list->next)
11003 gtk_tree_view_column_set_clickable (GTK_TREE_VIEW_COLUMN (list->data), setting);
11005 g_object_notify (G_OBJECT (tree_view), "headers-clickable");
11010 * gtk_tree_view_get_headers_clickable:
11011 * @tree_view: A #GtkTreeView.
11013 * Returns whether all header columns are clickable.
11015 * Return value: %TRUE if all header columns are clickable, otherwise %FALSE
11020 gtk_tree_view_get_headers_clickable (GtkTreeView *tree_view)
11024 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
11026 for (list = tree_view->priv->columns; list; list = list->next)
11027 if (!GTK_TREE_VIEW_COLUMN (list->data)->clickable)
11034 * gtk_tree_view_set_rules_hint
11035 * @tree_view: a #GtkTreeView
11036 * @setting: %TRUE if the tree requires reading across rows
11038 * This function tells GTK+ that the user interface for your
11039 * application requires users to read across tree rows and associate
11040 * cells with one another. By default, GTK+ will then render the tree
11041 * with alternating row colors. Do <emphasis>not</emphasis> use it
11042 * just because you prefer the appearance of the ruled tree; that's a
11043 * question for the theme. Some themes will draw tree rows in
11044 * alternating colors even when rules are turned off, and users who
11045 * prefer that appearance all the time can choose those themes. You
11046 * should call this function only as a <emphasis>semantic</emphasis>
11047 * hint to the theme engine that your tree makes alternating colors
11048 * useful from a functional standpoint (since it has lots of columns,
11053 gtk_tree_view_set_rules_hint (GtkTreeView *tree_view,
11056 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11058 setting = setting != FALSE;
11060 if (tree_view->priv->has_rules != setting)
11062 tree_view->priv->has_rules = setting;
11063 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
11066 g_object_notify (G_OBJECT (tree_view), "rules-hint");
11070 * gtk_tree_view_get_rules_hint
11071 * @tree_view: a #GtkTreeView
11073 * Gets the setting set by gtk_tree_view_set_rules_hint().
11075 * Return value: %TRUE if rules are useful for the user of this tree
11078 gtk_tree_view_get_rules_hint (GtkTreeView *tree_view)
11080 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
11082 return tree_view->priv->has_rules;
11085 /* Public Column functions
11089 * gtk_tree_view_append_column:
11090 * @tree_view: A #GtkTreeView.
11091 * @column: The #GtkTreeViewColumn to add.
11093 * Appends @column to the list of columns. If @tree_view has "fixed_height"
11094 * mode enabled, then @column must have its "sizing" property set to be
11095 * GTK_TREE_VIEW_COLUMN_FIXED.
11097 * Return value: The number of columns in @tree_view after appending.
11100 gtk_tree_view_append_column (GtkTreeView *tree_view,
11101 GtkTreeViewColumn *column)
11103 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11104 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
11105 g_return_val_if_fail (column->tree_view == NULL, -1);
11107 return gtk_tree_view_insert_column (tree_view, column, -1);
11112 * gtk_tree_view_remove_column:
11113 * @tree_view: A #GtkTreeView.
11114 * @column: The #GtkTreeViewColumn to remove.
11116 * Removes @column from @tree_view.
11118 * Return value: The number of columns in @tree_view after removing.
11121 gtk_tree_view_remove_column (GtkTreeView *tree_view,
11122 GtkTreeViewColumn *column)
11124 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11125 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
11126 g_return_val_if_fail (column->tree_view == GTK_WIDGET (tree_view), -1);
11128 if (tree_view->priv->focus_column == column)
11129 tree_view->priv->focus_column = NULL;
11131 if (tree_view->priv->edited_column == column)
11133 gtk_tree_view_stop_editing (tree_view, TRUE);
11135 /* no need to, but just to be sure ... */
11136 tree_view->priv->edited_column = NULL;
11139 g_signal_handlers_disconnect_by_func (column,
11140 G_CALLBACK (column_sizing_notify),
11143 _gtk_tree_view_column_unset_tree_view (column);
11145 tree_view->priv->columns = g_list_remove (tree_view->priv->columns, column);
11146 tree_view->priv->n_columns--;
11148 if (GTK_WIDGET_REALIZED (tree_view))
11152 _gtk_tree_view_column_unrealize_button (column);
11153 for (list = tree_view->priv->columns; list; list = list->next)
11155 GtkTreeViewColumn *tmp_column;
11157 tmp_column = GTK_TREE_VIEW_COLUMN (list->data);
11158 if (tmp_column->visible)
11159 _gtk_tree_view_column_cell_set_dirty (tmp_column, TRUE);
11162 if (tree_view->priv->n_columns == 0 &&
11163 gtk_tree_view_get_headers_visible (tree_view))
11164 gdk_window_hide (tree_view->priv->header_window);
11166 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
11169 g_object_unref (column);
11170 g_signal_emit (tree_view, tree_view_signals[COLUMNS_CHANGED], 0);
11172 return tree_view->priv->n_columns;
11176 * gtk_tree_view_insert_column:
11177 * @tree_view: A #GtkTreeView.
11178 * @column: The #GtkTreeViewColumn to be inserted.
11179 * @position: The position to insert @column in.
11181 * This inserts the @column into the @tree_view at @position. If @position is
11182 * -1, then the column is inserted at the end. If @tree_view has
11183 * "fixed_height" mode enabled, then @column must have its "sizing" property
11184 * set to be GTK_TREE_VIEW_COLUMN_FIXED.
11186 * Return value: The number of columns in @tree_view after insertion.
11189 gtk_tree_view_insert_column (GtkTreeView *tree_view,
11190 GtkTreeViewColumn *column,
11193 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11194 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
11195 g_return_val_if_fail (column->tree_view == NULL, -1);
11197 if (tree_view->priv->fixed_height_mode)
11198 g_return_val_if_fail (gtk_tree_view_column_get_sizing (column)
11199 == GTK_TREE_VIEW_COLUMN_FIXED, -1);
11201 g_object_ref_sink (column);
11203 if (tree_view->priv->n_columns == 0 &&
11204 GTK_WIDGET_REALIZED (tree_view) &&
11205 gtk_tree_view_get_headers_visible (tree_view))
11207 gdk_window_show (tree_view->priv->header_window);
11210 g_signal_connect (column, "notify::sizing",
11211 G_CALLBACK (column_sizing_notify), tree_view);
11213 tree_view->priv->columns = g_list_insert (tree_view->priv->columns,
11215 tree_view->priv->n_columns++;
11217 _gtk_tree_view_column_set_tree_view (column, tree_view);
11219 if (GTK_WIDGET_REALIZED (tree_view))
11223 _gtk_tree_view_column_realize_button (column);
11225 for (list = tree_view->priv->columns; list; list = list->next)
11227 column = GTK_TREE_VIEW_COLUMN (list->data);
11228 if (column->visible)
11229 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
11231 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
11234 g_signal_emit (tree_view, tree_view_signals[COLUMNS_CHANGED], 0);
11236 return tree_view->priv->n_columns;
11240 * gtk_tree_view_insert_column_with_attributes:
11241 * @tree_view: A #GtkTreeView
11242 * @position: The position to insert the new column in.
11243 * @title: The title to set the header to.
11244 * @cell: The #GtkCellRenderer.
11245 * @Varargs: A %NULL-terminated list of attributes.
11247 * Creates a new #GtkTreeViewColumn and inserts it into the @tree_view at
11248 * @position. If @position is -1, then the newly created column is inserted at
11249 * the end. The column is initialized with the attributes given. If @tree_view
11250 * has "fixed_height" mode enabled, then the new column will have its sizing
11251 * property set to be GTK_TREE_VIEW_COLUMN_FIXED.
11253 * Return value: The number of columns in @tree_view after insertion.
11256 gtk_tree_view_insert_column_with_attributes (GtkTreeView *tree_view,
11258 const gchar *title,
11259 GtkCellRenderer *cell,
11262 GtkTreeViewColumn *column;
11267 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11269 column = gtk_tree_view_column_new ();
11270 if (tree_view->priv->fixed_height_mode)
11271 gtk_tree_view_column_set_sizing (column, GTK_TREE_VIEW_COLUMN_FIXED);
11273 gtk_tree_view_column_set_title (column, title);
11274 gtk_tree_view_column_pack_start (column, cell, TRUE);
11276 va_start (args, cell);
11278 attribute = va_arg (args, gchar *);
11280 while (attribute != NULL)
11282 column_id = va_arg (args, gint);
11283 gtk_tree_view_column_add_attribute (column, cell, attribute, column_id);
11284 attribute = va_arg (args, gchar *);
11289 gtk_tree_view_insert_column (tree_view, column, position);
11291 return tree_view->priv->n_columns;
11295 * gtk_tree_view_insert_column_with_data_func:
11296 * @tree_view: a #GtkTreeView
11297 * @position: Position to insert, -1 for append
11298 * @title: column title
11299 * @cell: cell renderer for column
11300 * @func: function to set attributes of cell renderer
11301 * @data: data for @func
11302 * @dnotify: destroy notifier for @data
11304 * Convenience function that inserts a new column into the #GtkTreeView
11305 * with the given cell renderer and a #GtkCellDataFunc to set cell renderer
11306 * attributes (normally using data from the model). See also
11307 * gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start().
11308 * If @tree_view has "fixed_height" mode enabled, then the new column will have its
11309 * "sizing" property set to be GTK_TREE_VIEW_COLUMN_FIXED.
11311 * Return value: number of columns in the tree view post-insert
11314 gtk_tree_view_insert_column_with_data_func (GtkTreeView *tree_view,
11316 const gchar *title,
11317 GtkCellRenderer *cell,
11318 GtkTreeCellDataFunc func,
11320 GDestroyNotify dnotify)
11322 GtkTreeViewColumn *column;
11324 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11326 column = gtk_tree_view_column_new ();
11327 if (tree_view->priv->fixed_height_mode)
11328 gtk_tree_view_column_set_sizing (column, GTK_TREE_VIEW_COLUMN_FIXED);
11330 gtk_tree_view_column_set_title (column, title);
11331 gtk_tree_view_column_pack_start (column, cell, TRUE);
11332 gtk_tree_view_column_set_cell_data_func (column, cell, func, data, dnotify);
11334 gtk_tree_view_insert_column (tree_view, column, position);
11336 return tree_view->priv->n_columns;
11340 * gtk_tree_view_get_column:
11341 * @tree_view: A #GtkTreeView.
11342 * @n: The position of the column, counting from 0.
11344 * Gets the #GtkTreeViewColumn at the given position in the #tree_view.
11346 * Return value: The #GtkTreeViewColumn, or %NULL if the position is outside the
11347 * range of columns.
11349 GtkTreeViewColumn *
11350 gtk_tree_view_get_column (GtkTreeView *tree_view,
11353 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
11355 if (n < 0 || n >= tree_view->priv->n_columns)
11358 if (tree_view->priv->columns == NULL)
11361 return GTK_TREE_VIEW_COLUMN (g_list_nth (tree_view->priv->columns, n)->data);
11365 * gtk_tree_view_get_columns:
11366 * @tree_view: A #GtkTreeView
11368 * Returns a #GList of all the #GtkTreeViewColumn s currently in @tree_view.
11369 * The returned list must be freed with g_list_free ().
11371 * Return value: A list of #GtkTreeViewColumn s
11374 gtk_tree_view_get_columns (GtkTreeView *tree_view)
11376 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
11378 return g_list_copy (tree_view->priv->columns);
11382 * gtk_tree_view_move_column_after:
11383 * @tree_view: A #GtkTreeView
11384 * @column: The #GtkTreeViewColumn to be moved.
11385 * @base_column: The #GtkTreeViewColumn to be moved relative to, or %NULL.
11387 * Moves @column to be after to @base_column. If @base_column is %NULL, then
11388 * @column is placed in the first position.
11391 gtk_tree_view_move_column_after (GtkTreeView *tree_view,
11392 GtkTreeViewColumn *column,
11393 GtkTreeViewColumn *base_column)
11395 GList *column_list_el, *base_el = NULL;
11397 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11399 column_list_el = g_list_find (tree_view->priv->columns, column);
11400 g_return_if_fail (column_list_el != NULL);
11404 base_el = g_list_find (tree_view->priv->columns, base_column);
11405 g_return_if_fail (base_el != NULL);
11408 if (column_list_el->prev == base_el)
11411 tree_view->priv->columns = g_list_remove_link (tree_view->priv->columns, column_list_el);
11412 if (base_el == NULL)
11414 column_list_el->prev = NULL;
11415 column_list_el->next = tree_view->priv->columns;
11416 if (column_list_el->next)
11417 column_list_el->next->prev = column_list_el;
11418 tree_view->priv->columns = column_list_el;
11422 column_list_el->prev = base_el;
11423 column_list_el->next = base_el->next;
11424 if (column_list_el->next)
11425 column_list_el->next->prev = column_list_el;
11426 base_el->next = column_list_el;
11429 if (GTK_WIDGET_REALIZED (tree_view))
11431 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
11432 gtk_tree_view_size_allocate_columns (GTK_WIDGET (tree_view), NULL);
11435 g_signal_emit (tree_view, tree_view_signals[COLUMNS_CHANGED], 0);
11439 * gtk_tree_view_set_expander_column:
11440 * @tree_view: A #GtkTreeView
11441 * @column: %NULL, or the column to draw the expander arrow at.
11443 * Sets the column to draw the expander arrow at. It must be in @tree_view.
11444 * If @column is %NULL, then the expander arrow is always at the first
11447 * If you do not want expander arrow to appear in your tree, set the
11448 * expander column to a hidden column.
11451 gtk_tree_view_set_expander_column (GtkTreeView *tree_view,
11452 GtkTreeViewColumn *column)
11454 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11455 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
11457 if (tree_view->priv->expander_column != column)
11463 /* Confirm that column is in tree_view */
11464 for (list = tree_view->priv->columns; list; list = list->next)
11465 if (list->data == column)
11467 g_return_if_fail (list != NULL);
11470 tree_view->priv->expander_column = column;
11471 g_object_notify (G_OBJECT (tree_view), "expander-column");
11476 * gtk_tree_view_get_expander_column:
11477 * @tree_view: A #GtkTreeView
11479 * Returns the column that is the current expander column. This
11480 * column has the expander arrow drawn next to it.
11482 * Return value: The expander column.
11484 GtkTreeViewColumn *
11485 gtk_tree_view_get_expander_column (GtkTreeView *tree_view)
11489 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
11491 for (list = tree_view->priv->columns; list; list = list->next)
11492 if (gtk_tree_view_is_expander_column (tree_view, GTK_TREE_VIEW_COLUMN (list->data)))
11493 return (GtkTreeViewColumn *) list->data;
11499 * gtk_tree_view_set_column_drag_function:
11500 * @tree_view: A #GtkTreeView.
11501 * @func: A function to determine which columns are reorderable, or %NULL.
11502 * @user_data: User data to be passed to @func, or %NULL
11503 * @destroy: Destroy notifier for @user_data, or %NULL
11505 * Sets a user function for determining where a column may be dropped when
11506 * dragged. This function is called on every column pair in turn at the
11507 * beginning of a column drag to determine where a drop can take place. The
11508 * arguments passed to @func are: the @tree_view, the #GtkTreeViewColumn being
11509 * dragged, the two #GtkTreeViewColumn s determining the drop spot, and
11510 * @user_data. If either of the #GtkTreeViewColumn arguments for the drop spot
11511 * are %NULL, then they indicate an edge. If @func is set to be %NULL, then
11512 * @tree_view reverts to the default behavior of allowing all columns to be
11513 * dropped everywhere.
11516 gtk_tree_view_set_column_drag_function (GtkTreeView *tree_view,
11517 GtkTreeViewColumnDropFunc func,
11518 gpointer user_data,
11519 GDestroyNotify destroy)
11521 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11523 if (tree_view->priv->column_drop_func_data_destroy)
11524 tree_view->priv->column_drop_func_data_destroy (tree_view->priv->column_drop_func_data);
11526 tree_view->priv->column_drop_func = func;
11527 tree_view->priv->column_drop_func_data = user_data;
11528 tree_view->priv->column_drop_func_data_destroy = destroy;
11532 * gtk_tree_view_scroll_to_point:
11533 * @tree_view: a #GtkTreeView
11534 * @tree_x: X coordinate of new top-left pixel of visible area, or -1
11535 * @tree_y: Y coordinate of new top-left pixel of visible area, or -1
11537 * Scrolls the tree view such that the top-left corner of the visible
11538 * area is @tree_x, @tree_y, where @tree_x and @tree_y are specified
11539 * in tree coordinates. The @tree_view must be realized before
11540 * this function is called. If it isn't, you probably want to be
11541 * using gtk_tree_view_scroll_to_cell().
11543 * If either @tree_x or @tree_y are -1, then that direction isn't scrolled.
11546 gtk_tree_view_scroll_to_point (GtkTreeView *tree_view,
11550 GtkAdjustment *hadj;
11551 GtkAdjustment *vadj;
11553 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11554 g_return_if_fail (GTK_WIDGET_REALIZED (tree_view));
11556 hadj = tree_view->priv->hadjustment;
11557 vadj = tree_view->priv->vadjustment;
11560 gtk_adjustment_set_value (hadj, CLAMP (tree_x, hadj->lower, hadj->upper - hadj->page_size));
11562 gtk_adjustment_set_value (vadj, CLAMP (tree_y, vadj->lower, vadj->upper - vadj->page_size));
11566 * gtk_tree_view_scroll_to_cell:
11567 * @tree_view: A #GtkTreeView.
11568 * @path: The path of the row to move to, or %NULL.
11569 * @column: The #GtkTreeViewColumn to move horizontally to, or %NULL.
11570 * @use_align: whether to use alignment arguments, or %FALSE.
11571 * @row_align: The vertical alignment of the row specified by @path.
11572 * @col_align: The horizontal alignment of the column specified by @column.
11574 * Moves the alignments of @tree_view to the position specified by @column and
11575 * @path. If @column is %NULL, then no horizontal scrolling occurs. Likewise,
11576 * if @path is %NULL no vertical scrolling occurs. At a minimum, one of @column
11577 * or @path need to be non-%NULL. @row_align determines where the row is
11578 * placed, and @col_align determines where @column is placed. Both are expected
11579 * to be between 0.0 and 1.0. 0.0 means left/top alignment, 1.0 means
11580 * right/bottom alignment, 0.5 means center.
11582 * If @use_align is %FALSE, then the alignment arguments are ignored, and the
11583 * tree does the minimum amount of work to scroll the cell onto the screen.
11584 * This means that the cell will be scrolled to the edge closest to its current
11585 * position. If the cell is currently visible on the screen, nothing is done.
11587 * This function only works if the model is set, and @path is a valid row on the
11588 * model. If the model changes before the @tree_view is realized, the centered
11589 * path will be modified to reflect this change.
11592 gtk_tree_view_scroll_to_cell (GtkTreeView *tree_view,
11594 GtkTreeViewColumn *column,
11595 gboolean use_align,
11599 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11600 g_return_if_fail (tree_view->priv->model != NULL);
11601 g_return_if_fail (tree_view->priv->tree != NULL);
11602 g_return_if_fail (row_align >= 0.0 && row_align <= 1.0);
11603 g_return_if_fail (col_align >= 0.0 && col_align <= 1.0);
11604 g_return_if_fail (path != NULL || column != NULL);
11607 g_print ("gtk_tree_view_scroll_to_cell:\npath: %s\ncolumn: %s\nuse_align: %d\nrow_align: %f\ncol_align: %f\n",
11608 gtk_tree_path_to_string (path), column?"non-null":"null", use_align, row_align, col_align);
11610 row_align = CLAMP (row_align, 0.0, 1.0);
11611 col_align = CLAMP (col_align, 0.0, 1.0);
11614 /* Note: Despite the benefits that come from having one code path for the
11615 * scrolling code, we short-circuit validate_visible_area's immplementation as
11616 * it is much slower than just going to the point.
11618 if (! GTK_WIDGET_VISIBLE (tree_view) ||
11619 ! GTK_WIDGET_REALIZED (tree_view) ||
11620 GTK_WIDGET_ALLOC_NEEDED (tree_view) ||
11621 GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID))
11623 if (tree_view->priv->scroll_to_path)
11624 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
11626 tree_view->priv->scroll_to_path = NULL;
11627 tree_view->priv->scroll_to_column = NULL;
11630 tree_view->priv->scroll_to_path = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
11632 tree_view->priv->scroll_to_column = column;
11633 tree_view->priv->scroll_to_use_align = use_align;
11634 tree_view->priv->scroll_to_row_align = row_align;
11635 tree_view->priv->scroll_to_col_align = col_align;
11637 install_presize_handler (tree_view);
11641 GdkRectangle cell_rect;
11642 GdkRectangle vis_rect;
11643 gint dest_x, dest_y;
11645 gtk_tree_view_get_background_area (tree_view, path, column, &cell_rect);
11646 gtk_tree_view_get_visible_rect (tree_view, &vis_rect);
11648 cell_rect.y = TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, cell_rect.y);
11650 dest_x = vis_rect.x;
11651 dest_y = vis_rect.y;
11657 dest_x = cell_rect.x - ((vis_rect.width - cell_rect.width) * col_align);
11661 if (cell_rect.x < vis_rect.x)
11662 dest_x = cell_rect.x;
11663 if (cell_rect.x + cell_rect.width > vis_rect.x + vis_rect.width)
11664 dest_x = cell_rect.x + cell_rect.width - vis_rect.width;
11672 dest_y = cell_rect.y - ((vis_rect.height - cell_rect.height) * row_align);
11673 dest_y = MAX (dest_y, 0);
11677 if (cell_rect.y < vis_rect.y)
11678 dest_y = cell_rect.y;
11679 if (cell_rect.y + cell_rect.height > vis_rect.y + vis_rect.height)
11680 dest_y = cell_rect.y + cell_rect.height - vis_rect.height;
11684 gtk_tree_view_scroll_to_point (tree_view, dest_x, dest_y);
11689 * gtk_tree_view_row_activated:
11690 * @tree_view: A #GtkTreeView
11691 * @path: The #GtkTreePath to be activated.
11692 * @column: The #GtkTreeViewColumn to be activated.
11694 * Activates the cell determined by @path and @column.
11697 gtk_tree_view_row_activated (GtkTreeView *tree_view,
11699 GtkTreeViewColumn *column)
11701 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11703 g_signal_emit (tree_view, tree_view_signals[ROW_ACTIVATED], 0, path, column);
11708 gtk_tree_view_expand_all_emission_helper (GtkRBTree *tree,
11712 GtkTreeView *tree_view = data;
11714 if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT &&
11720 path = _gtk_tree_view_find_path (tree_view, tree, node);
11721 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
11723 g_signal_emit (tree_view, tree_view_signals[ROW_EXPANDED], 0, &iter, path);
11725 gtk_tree_path_free (path);
11728 if (node->children)
11729 _gtk_rbtree_traverse (node->children,
11730 node->children->root,
11732 gtk_tree_view_expand_all_emission_helper,
11737 * gtk_tree_view_expand_all:
11738 * @tree_view: A #GtkTreeView.
11740 * Recursively expands all nodes in the @tree_view.
11743 gtk_tree_view_expand_all (GtkTreeView *tree_view)
11749 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11751 if (tree_view->priv->tree == NULL)
11754 path = gtk_tree_path_new_first ();
11755 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
11759 gtk_tree_view_real_expand_row (tree_view, path, tree, node, TRUE, FALSE);
11760 node = _gtk_rbtree_next (tree, node);
11761 gtk_tree_path_next (path);
11764 gtk_tree_path_free (path);
11767 /* Timeout to animate the expander during expands and collapses */
11769 expand_collapse_timeout (gpointer data)
11771 return do_expand_collapse (data);
11775 add_expand_collapse_timeout (GtkTreeView *tree_view,
11780 if (tree_view->priv->expand_collapse_timeout != 0)
11783 tree_view->priv->expand_collapse_timeout =
11784 gdk_threads_add_timeout (50, expand_collapse_timeout, tree_view);
11785 tree_view->priv->expanded_collapsed_tree = tree;
11786 tree_view->priv->expanded_collapsed_node = node;
11789 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
11791 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
11795 remove_expand_collapse_timeout (GtkTreeView *tree_view)
11797 if (tree_view->priv->expand_collapse_timeout)
11799 g_source_remove (tree_view->priv->expand_collapse_timeout);
11800 tree_view->priv->expand_collapse_timeout = 0;
11803 if (tree_view->priv->expanded_collapsed_node != NULL)
11805 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_EXPANDED);
11806 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_COLLAPSED);
11808 tree_view->priv->expanded_collapsed_node = NULL;
11813 cancel_arrow_animation (GtkTreeView *tree_view)
11815 if (tree_view->priv->expand_collapse_timeout)
11817 while (do_expand_collapse (tree_view));
11819 remove_expand_collapse_timeout (tree_view);
11824 do_expand_collapse (GtkTreeView *tree_view)
11828 gboolean expanding;
11834 node = tree_view->priv->expanded_collapsed_node;
11835 tree = tree_view->priv->expanded_collapsed_tree;
11837 if (node->children == NULL)
11842 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
11844 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
11845 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
11850 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
11852 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
11859 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
11861 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
11862 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
11866 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
11868 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
11877 gtk_tree_view_queue_draw_arrow (tree_view, tree, node, NULL);
11886 * gtk_tree_view_collapse_all:
11887 * @tree_view: A #GtkTreeView.
11889 * Recursively collapses all visible, expanded nodes in @tree_view.
11892 gtk_tree_view_collapse_all (GtkTreeView *tree_view)
11899 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11901 if (tree_view->priv->tree == NULL)
11904 path = gtk_tree_path_new ();
11905 gtk_tree_path_down (path);
11906 indices = gtk_tree_path_get_indices (path);
11908 tree = tree_view->priv->tree;
11910 while (node && node->left != tree->nil)
11915 if (node->children)
11916 gtk_tree_view_real_collapse_row (tree_view, path, tree, node, FALSE);
11918 node = _gtk_rbtree_next (tree, node);
11921 gtk_tree_path_free (path);
11925 * gtk_tree_view_expand_to_path:
11926 * @tree_view: A #GtkTreeView.
11927 * @path: path to a row.
11929 * Expands the row at @path. This will also expand all parent rows of
11930 * @path as necessary.
11935 gtk_tree_view_expand_to_path (GtkTreeView *tree_view,
11942 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11943 g_return_if_fail (path != NULL);
11945 depth = gtk_tree_path_get_depth (path);
11946 indices = gtk_tree_path_get_indices (path);
11948 tmp = gtk_tree_path_new ();
11949 g_return_if_fail (tmp != NULL);
11951 for (i = 0; i < depth; i++)
11953 gtk_tree_path_append_index (tmp, indices[i]);
11954 gtk_tree_view_expand_row (tree_view, tmp, FALSE);
11957 gtk_tree_path_free (tmp);
11960 /* FIXME the bool return values for expand_row and collapse_row are
11961 * not analagous; they should be TRUE if the row had children and
11962 * was not already in the requested state.
11967 gtk_tree_view_real_expand_row (GtkTreeView *tree_view,
11979 g_object_get (gtk_widget_get_settings (GTK_WIDGET (tree_view)),
11980 "gtk-enable-animations", &animate,
11983 remove_auto_expand_timeout (tree_view);
11985 if (node->children && !open_all)
11988 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
11991 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
11992 if (! gtk_tree_model_iter_has_child (tree_view->priv->model, &iter))
11996 if (node->children && open_all)
11998 gboolean retval = FALSE;
11999 GtkTreePath *tmp_path = gtk_tree_path_copy (path);
12001 gtk_tree_path_append_index (tmp_path, 0);
12002 tree = node->children;
12004 while (node->left != tree->nil)
12006 /* try to expand the children */
12010 t = gtk_tree_view_real_expand_row (tree_view, tmp_path, tree, node,
12015 gtk_tree_path_next (tmp_path);
12016 node = _gtk_rbtree_next (tree, node);
12018 while (node != NULL);
12020 gtk_tree_path_free (tmp_path);
12025 g_signal_emit (tree_view, tree_view_signals[TEST_EXPAND_ROW], 0, &iter, path, &expand);
12027 if (!gtk_tree_model_iter_has_child (tree_view->priv->model, &iter))
12033 node->children = _gtk_rbtree_new ();
12034 node->children->parent_tree = tree;
12035 node->children->parent_node = node;
12037 gtk_tree_model_iter_children (tree_view->priv->model, &temp, &iter);
12039 gtk_tree_view_build_tree (tree_view,
12042 gtk_tree_path_get_depth (path) + 1,
12045 remove_expand_collapse_timeout (tree_view);
12048 add_expand_collapse_timeout (tree_view, tree, node, TRUE);
12050 install_presize_handler (tree_view);
12052 g_signal_emit (tree_view, tree_view_signals[ROW_EXPANDED], 0, &iter, path);
12053 if (open_all && node->children)
12055 _gtk_rbtree_traverse (node->children,
12056 node->children->root,
12058 gtk_tree_view_expand_all_emission_helper,
12066 * gtk_tree_view_expand_row:
12067 * @tree_view: a #GtkTreeView
12068 * @path: path to a row
12069 * @open_all: whether to recursively expand, or just expand immediate children
12071 * Opens the row so its children are visible.
12073 * Return value: %TRUE if the row existed and had children
12076 gtk_tree_view_expand_row (GtkTreeView *tree_view,
12083 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
12084 g_return_val_if_fail (tree_view->priv->model != NULL, FALSE);
12085 g_return_val_if_fail (path != NULL, FALSE);
12087 if (_gtk_tree_view_find_node (tree_view,
12094 return gtk_tree_view_real_expand_row (tree_view, path, tree, node, open_all, FALSE);
12100 gtk_tree_view_real_collapse_row (GtkTreeView *tree_view,
12107 GtkTreeIter children;
12111 GdkWindow *child, *parent;
12114 g_object_get (gtk_widget_get_settings (GTK_WIDGET (tree_view)),
12115 "gtk-enable-animations", &animate,
12118 remove_auto_expand_timeout (tree_view);
12120 if (node->children == NULL)
12123 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
12125 g_signal_emit (tree_view, tree_view_signals[TEST_COLLAPSE_ROW], 0, &iter, path, &collapse);
12130 /* if the prelighted node is a child of us, we want to unprelight it. We have
12131 * a chance to prelight the correct node below */
12133 if (tree_view->priv->prelight_tree)
12135 GtkRBTree *parent_tree;
12136 GtkRBNode *parent_node;
12138 parent_tree = tree_view->priv->prelight_tree->parent_tree;
12139 parent_node = tree_view->priv->prelight_tree->parent_node;
12140 while (parent_tree)
12142 if (parent_tree == tree && parent_node == node)
12144 ensure_unprelighted (tree_view);
12147 parent_node = parent_tree->parent_node;
12148 parent_tree = parent_tree->parent_tree;
12152 TREE_VIEW_INTERNAL_ASSERT (gtk_tree_model_iter_children (tree_view->priv->model, &children, &iter), FALSE);
12154 for (list = tree_view->priv->columns; list; list = list->next)
12156 GtkTreeViewColumn *column = list->data;
12158 if (column->visible == FALSE)
12160 if (gtk_tree_view_column_get_sizing (column) == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
12161 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
12164 if (tree_view->priv->destroy_count_func)
12166 GtkTreePath *child_path;
12167 gint child_count = 0;
12168 child_path = gtk_tree_path_copy (path);
12169 gtk_tree_path_down (child_path);
12170 if (node->children)
12171 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, &child_count);
12172 tree_view->priv->destroy_count_func (tree_view, child_path, child_count, tree_view->priv->destroy_count_data);
12173 gtk_tree_path_free (child_path);
12176 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
12178 GtkTreePath *cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
12180 if (gtk_tree_path_is_ancestor (path, cursor_path))
12182 gtk_tree_row_reference_free (tree_view->priv->cursor);
12183 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
12184 tree_view->priv->model,
12187 gtk_tree_path_free (cursor_path);
12190 if (gtk_tree_row_reference_valid (tree_view->priv->anchor))
12192 GtkTreePath *anchor_path = gtk_tree_row_reference_get_path (tree_view->priv->anchor);
12193 if (gtk_tree_path_is_ancestor (path, anchor_path))
12195 gtk_tree_row_reference_free (tree_view->priv->anchor);
12196 tree_view->priv->anchor = NULL;
12198 gtk_tree_path_free (anchor_path);
12201 /* Stop a pending double click */
12202 tree_view->priv->last_button_x = -1;
12203 tree_view->priv->last_button_y = -1;
12205 remove_expand_collapse_timeout (tree_view);
12207 if (gtk_tree_view_unref_and_check_selection_tree (tree_view, node->children))
12209 _gtk_rbtree_remove (node->children);
12210 g_signal_emit_by_name (tree_view->priv->selection, "changed");
12213 _gtk_rbtree_remove (node->children);
12216 add_expand_collapse_timeout (tree_view, tree, node, FALSE);
12218 if (GTK_WIDGET_MAPPED (tree_view))
12220 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
12223 g_signal_emit (tree_view, tree_view_signals[ROW_COLLAPSED], 0, &iter, path);
12225 if (GTK_WIDGET_MAPPED (tree_view))
12227 /* now that we've collapsed all rows, we want to try to set the prelight
12228 * again. To do this, we fake a motion event and send it to ourselves. */
12230 child = tree_view->priv->bin_window;
12231 parent = gdk_window_get_parent (child);
12233 if (gdk_window_get_pointer (parent, &x, &y, NULL) == child)
12235 GdkEventMotion event;
12236 gint child_x, child_y;
12238 gdk_window_get_position (child, &child_x, &child_y);
12240 event.window = tree_view->priv->bin_window;
12241 event.x = x - child_x;
12242 event.y = y - child_y;
12244 /* despite the fact this isn't a real event, I'm almost positive it will
12245 * never trigger a drag event. maybe_drag is the only function that uses
12246 * more than just event.x and event.y. */
12247 gtk_tree_view_motion_bin_window (GTK_WIDGET (tree_view), &event);
12255 * gtk_tree_view_collapse_row:
12256 * @tree_view: a #GtkTreeView
12257 * @path: path to a row in the @tree_view
12259 * Collapses a row (hides its child rows, if they exist).
12261 * Return value: %TRUE if the row was collapsed.
12264 gtk_tree_view_collapse_row (GtkTreeView *tree_view,
12270 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
12271 g_return_val_if_fail (tree_view->priv->tree != NULL, FALSE);
12272 g_return_val_if_fail (path != NULL, FALSE);
12274 if (_gtk_tree_view_find_node (tree_view,
12280 if (tree == NULL || node->children == NULL)
12283 return gtk_tree_view_real_collapse_row (tree_view, path, tree, node, FALSE);
12287 gtk_tree_view_map_expanded_rows_helper (GtkTreeView *tree_view,
12290 GtkTreeViewMappingFunc func,
12291 gpointer user_data)
12295 if (tree == NULL || tree->root == NULL)
12300 while (node && node->left != tree->nil)
12305 if (node->children)
12307 (* func) (tree_view, path, user_data);
12308 gtk_tree_path_down (path);
12309 gtk_tree_view_map_expanded_rows_helper (tree_view, node->children, path, func, user_data);
12310 gtk_tree_path_up (path);
12312 gtk_tree_path_next (path);
12313 node = _gtk_rbtree_next (tree, node);
12318 * gtk_tree_view_map_expanded_rows:
12319 * @tree_view: A #GtkTreeView
12320 * @func: A function to be called
12321 * @data: User data to be passed to the function.
12323 * Calls @func on all expanded rows.
12326 gtk_tree_view_map_expanded_rows (GtkTreeView *tree_view,
12327 GtkTreeViewMappingFunc func,
12328 gpointer user_data)
12332 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12333 g_return_if_fail (func != NULL);
12335 path = gtk_tree_path_new_first ();
12337 gtk_tree_view_map_expanded_rows_helper (tree_view,
12338 tree_view->priv->tree,
12339 path, func, user_data);
12341 gtk_tree_path_free (path);
12345 * gtk_tree_view_row_expanded:
12346 * @tree_view: A #GtkTreeView.
12347 * @path: A #GtkTreePath to test expansion state.
12349 * Returns %TRUE if the node pointed to by @path is expanded in @tree_view.
12351 * Return value: %TRUE if #path is expanded.
12354 gtk_tree_view_row_expanded (GtkTreeView *tree_view,
12360 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
12361 g_return_val_if_fail (path != NULL, FALSE);
12363 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
12368 return (node->children != NULL);
12372 * gtk_tree_view_get_reorderable:
12373 * @tree_view: a #GtkTreeView
12375 * Retrieves whether the user can reorder the tree via drag-and-drop. See
12376 * gtk_tree_view_set_reorderable().
12378 * Return value: %TRUE if the tree can be reordered.
12381 gtk_tree_view_get_reorderable (GtkTreeView *tree_view)
12383 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
12385 return tree_view->priv->reorderable;
12389 * gtk_tree_view_set_reorderable:
12390 * @tree_view: A #GtkTreeView.
12391 * @reorderable: %TRUE, if the tree can be reordered.
12393 * This function is a convenience function to allow you to reorder
12394 * models that support the #GtkDragSourceIface and the
12395 * #GtkDragDestIface. Both #GtkTreeStore and #GtkListStore support
12396 * these. If @reorderable is %TRUE, then the user can reorder the
12397 * model by dragging and dropping rows. The developer can listen to
12398 * these changes by connecting to the model's row_inserted and
12399 * row_deleted signals. The reordering is implemented by setting up
12400 * the tree view as a drag source and destination. Therefore, drag and
12401 * drop can not be used in a reorderable view for any other purpose.
12403 * This function does not give you any degree of control over the order -- any
12404 * reordering is allowed. If more control is needed, you should probably
12405 * handle drag and drop manually.
12408 gtk_tree_view_set_reorderable (GtkTreeView *tree_view,
12409 gboolean reorderable)
12411 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12413 reorderable = reorderable != FALSE;
12415 if (tree_view->priv->reorderable == reorderable)
12420 const GtkTargetEntry row_targets[] = {
12421 { "GTK_TREE_MODEL_ROW", GTK_TARGET_SAME_WIDGET, 0 }
12424 gtk_tree_view_enable_model_drag_source (tree_view,
12427 G_N_ELEMENTS (row_targets),
12429 gtk_tree_view_enable_model_drag_dest (tree_view,
12431 G_N_ELEMENTS (row_targets),
12436 gtk_tree_view_unset_rows_drag_source (tree_view);
12437 gtk_tree_view_unset_rows_drag_dest (tree_view);
12440 tree_view->priv->reorderable = reorderable;
12442 g_object_notify (G_OBJECT (tree_view), "reorderable");
12446 gtk_tree_view_real_set_cursor (GtkTreeView *tree_view,
12448 gboolean clear_and_select,
12449 gboolean clamp_node)
12451 GtkRBTree *tree = NULL;
12452 GtkRBNode *node = NULL;
12454 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
12456 GtkTreePath *cursor_path;
12457 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
12458 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
12459 gtk_tree_path_free (cursor_path);
12462 gtk_tree_row_reference_free (tree_view->priv->cursor);
12463 tree_view->priv->cursor = NULL;
12465 /* One cannot set the cursor on a separator. Also, if
12466 * _gtk_tree_view_find_node returns TRUE, it ran out of tree
12467 * before finding the tree and node belonging to path. The
12468 * path maps to a non-existing path and we will silently bail out.
12469 * We unset tree and node to avoid further processing.
12471 if (!row_is_separator (tree_view, NULL, path)
12472 && _gtk_tree_view_find_node (tree_view, path, &tree, &node) == FALSE)
12474 tree_view->priv->cursor =
12475 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
12476 tree_view->priv->model,
12487 GtkRBTree *new_tree = NULL;
12488 GtkRBNode *new_node = NULL;
12490 if (clear_and_select && !tree_view->priv->ctrl_pressed)
12492 GtkTreeSelectMode mode = 0;
12494 if (tree_view->priv->ctrl_pressed)
12495 mode |= GTK_TREE_SELECT_MODE_TOGGLE;
12496 if (tree_view->priv->shift_pressed)
12497 mode |= GTK_TREE_SELECT_MODE_EXTEND;
12499 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
12500 node, tree, path, mode,
12504 /* We have to re-find tree and node here again, somebody might have
12505 * cleared the node or the whole tree in the GtkTreeSelection::changed
12506 * callback. If the nodes differ we bail out here.
12508 _gtk_tree_view_find_node (tree_view, path, &new_tree, &new_node);
12510 if (tree != new_tree || node != new_node)
12515 gtk_tree_view_clamp_node_visible (tree_view, tree, node);
12516 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
12520 g_signal_emit (tree_view, tree_view_signals[CURSOR_CHANGED], 0);
12524 * gtk_tree_view_get_cursor:
12525 * @tree_view: A #GtkTreeView
12526 * @path: A pointer to be filled with the current cursor path, or %NULL
12527 * @focus_column: A pointer to be filled with the current focus column, or %NULL
12529 * Fills in @path and @focus_column with the current path and focus column. If
12530 * the cursor isn't currently set, then *@path will be %NULL. If no column
12531 * currently has focus, then *@focus_column will be %NULL.
12533 * The returned #GtkTreePath must be freed with gtk_tree_path_free() when
12534 * you are done with it.
12537 gtk_tree_view_get_cursor (GtkTreeView *tree_view,
12538 GtkTreePath **path,
12539 GtkTreeViewColumn **focus_column)
12541 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12545 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
12546 *path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
12553 *focus_column = tree_view->priv->focus_column;
12558 * gtk_tree_view_set_cursor:
12559 * @tree_view: A #GtkTreeView
12560 * @path: A #GtkTreePath
12561 * @focus_column: A #GtkTreeViewColumn, or %NULL
12562 * @start_editing: %TRUE if the specified cell should start being edited.
12564 * Sets the current keyboard focus to be at @path, and selects it. This is
12565 * useful when you want to focus the user's attention on a particular row. If
12566 * @focus_column is not %NULL, then focus is given to the column specified by
12567 * it. Additionally, if @focus_column is specified, and @start_editing is
12568 * %TRUE, then editing should be started in the specified cell.
12569 * This function is often followed by @gtk_widget_grab_focus (@tree_view)
12570 * in order to give keyboard focus to the widget. Please note that editing
12571 * can only happen when the widget is realized.
12573 * If @path is invalid for @model, the current cursor (if any) will be unset
12574 * and the function will return without failing.
12577 gtk_tree_view_set_cursor (GtkTreeView *tree_view,
12579 GtkTreeViewColumn *focus_column,
12580 gboolean start_editing)
12582 gtk_tree_view_set_cursor_on_cell (tree_view, path, focus_column,
12583 NULL, start_editing);
12587 * gtk_tree_view_set_cursor_on_cell:
12588 * @tree_view: A #GtkTreeView
12589 * @path: A #GtkTreePath
12590 * @focus_column: A #GtkTreeViewColumn, or %NULL
12591 * @focus_cell: A #GtkCellRenderer, or %NULL
12592 * @start_editing: %TRUE if the specified cell should start being edited.
12594 * Sets the current keyboard focus to be at @path, and selects it. This is
12595 * useful when you want to focus the user's attention on a particular row. If
12596 * @focus_column is not %NULL, then focus is given to the column specified by
12597 * it. If @focus_column and @focus_cell are not %NULL, and @focus_column
12598 * contains 2 or more editable or activatable cells, then focus is given to
12599 * the cell specified by @focus_cell. Additionally, if @focus_column is
12600 * specified, and @start_editing is %TRUE, then editing should be started in
12601 * the specified cell. This function is often followed by
12602 * @gtk_widget_grab_focus (@tree_view) in order to give keyboard focus to the
12603 * widget. Please note that editing can only happen when the widget is
12606 * If @path is invalid for @model, the current cursor (if any) will be unset
12607 * and the function will return without failing.
12612 gtk_tree_view_set_cursor_on_cell (GtkTreeView *tree_view,
12614 GtkTreeViewColumn *focus_column,
12615 GtkCellRenderer *focus_cell,
12616 gboolean start_editing)
12618 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12619 g_return_if_fail (path != NULL);
12620 g_return_if_fail (focus_column == NULL || GTK_IS_TREE_VIEW_COLUMN (focus_column));
12622 if (!tree_view->priv->model)
12627 g_return_if_fail (focus_column);
12628 g_return_if_fail (GTK_IS_CELL_RENDERER (focus_cell));
12631 /* cancel the current editing, if it exists */
12632 if (tree_view->priv->edited_column &&
12633 tree_view->priv->edited_column->editable_widget)
12634 gtk_tree_view_stop_editing (tree_view, TRUE);
12636 gtk_tree_view_real_set_cursor (tree_view, path, TRUE, TRUE);
12638 if (focus_column && focus_column->visible)
12641 gboolean column_in_tree = FALSE;
12643 for (list = tree_view->priv->columns; list; list = list->next)
12644 if (list->data == focus_column)
12646 column_in_tree = TRUE;
12649 g_return_if_fail (column_in_tree);
12650 tree_view->priv->focus_column = focus_column;
12652 gtk_tree_view_column_focus_cell (focus_column, focus_cell);
12654 gtk_tree_view_start_editing (tree_view, path);
12659 * gtk_tree_view_get_bin_window:
12660 * @tree_view: A #GtkTreeView
12662 * Returns the window that @tree_view renders to. This is used primarily to
12663 * compare to <literal>event->window</literal> to confirm that the event on
12664 * @tree_view is on the right window.
12666 * Return value: A #GdkWindow, or %NULL when @tree_view hasn't been realized yet
12669 gtk_tree_view_get_bin_window (GtkTreeView *tree_view)
12671 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
12673 return tree_view->priv->bin_window;
12677 * gtk_tree_view_get_path_at_pos:
12678 * @tree_view: A #GtkTreeView.
12679 * @x: The x position to be identified (relative to bin_window).
12680 * @y: The y position to be identified (relative to bin_window).
12681 * @path: A pointer to a #GtkTreePath pointer to be filled in, or %NULL
12682 * @column: A pointer to a #GtkTreeViewColumn pointer to be filled in, or %NULL
12683 * @cell_x: A pointer where the X coordinate relative to the cell can be placed, or %NULL
12684 * @cell_y: A pointer where the Y coordinate relative to the cell can be placed, or %NULL
12686 * Finds the path at the point (@x, @y), relative to bin_window coordinates
12687 * (please see gtk_tree_view_get_bin_window()).
12688 * That is, @x and @y are relative to an events coordinates. @x and @y must
12689 * come from an event on the @tree_view only where <literal>event->window ==
12690 * gtk_tree_view_get_bin_window (<!-- -->)</literal>. It is primarily for
12691 * things like popup menus. If @path is non-%NULL, then it will be filled
12692 * with the #GtkTreePath at that point. This path should be freed with
12693 * gtk_tree_path_free(). If @column is non-%NULL, then it will be filled
12694 * with the column at that point. @cell_x and @cell_y return the coordinates
12695 * relative to the cell background (i.e. the @background_area passed to
12696 * gtk_cell_renderer_render()). This function is only meaningful if
12697 * @tree_view is realized. Therefore this function will always return %FALSE
12698 * if @tree_view is not realized or does not have a model.
12700 * For converting widget coordinates (eg. the ones you get from
12701 * GtkWidget::query-tooltip), please see
12702 * gtk_tree_view_convert_widget_to_bin_window_coords().
12704 * Return value: %TRUE if a row exists at that coordinate.
12707 gtk_tree_view_get_path_at_pos (GtkTreeView *tree_view,
12710 GtkTreePath **path,
12711 GtkTreeViewColumn **column,
12719 g_return_val_if_fail (tree_view != NULL, FALSE);
12726 if (tree_view->priv->bin_window == NULL)
12729 if (tree_view->priv->tree == NULL)
12732 if (x > tree_view->priv->hadjustment->upper)
12735 if (x < 0 || y < 0)
12738 if (column || cell_x)
12740 GtkTreeViewColumn *tmp_column;
12741 GtkTreeViewColumn *last_column = NULL;
12743 gint remaining_x = x;
12744 gboolean found = FALSE;
12747 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
12748 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
12750 list = (rtl ? list->prev : list->next))
12752 tmp_column = list->data;
12754 if (tmp_column->visible == FALSE)
12757 last_column = tmp_column;
12758 if (remaining_x <= tmp_column->width)
12763 *column = tmp_column;
12766 *cell_x = remaining_x;
12770 remaining_x -= tmp_column->width;
12773 /* If found is FALSE and there is a last_column, then it the remainder
12774 * space is in that area
12781 *column = last_column;
12784 *cell_x = last_column->width + remaining_x;
12793 y_offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
12794 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, y),
12801 *cell_y = y_offset;
12804 *path = _gtk_tree_view_find_path (tree_view, tree, node);
12811 * gtk_tree_view_get_cell_area:
12812 * @tree_view: a #GtkTreeView
12813 * @path: a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
12814 * @column: a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
12815 * @rect: rectangle to fill with cell rect
12817 * Fills the bounding rectangle in bin_window coordinates for the cell at the
12818 * row specified by @path and the column specified by @column. If @path is
12819 * %NULL, or points to a path not currently displayed, the @y and @height fields
12820 * of the rectangle will be filled with 0. If @column is %NULL, the @x and @width
12821 * fields will be filled with 0. The sum of all cell rects does not cover the
12822 * entire tree; there are extra pixels in between rows, for example. The
12823 * returned rectangle is equivalent to the @cell_area passed to
12824 * gtk_cell_renderer_render(). This function is only valid if @tree_view is
12828 gtk_tree_view_get_cell_area (GtkTreeView *tree_view,
12830 GtkTreeViewColumn *column,
12831 GdkRectangle *rect)
12833 GtkRBTree *tree = NULL;
12834 GtkRBNode *node = NULL;
12835 gint vertical_separator;
12836 gint horizontal_separator;
12838 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12839 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
12840 g_return_if_fail (rect != NULL);
12841 g_return_if_fail (!column || column->tree_view == (GtkWidget *) tree_view);
12842 g_return_if_fail (GTK_WIDGET_REALIZED (tree_view));
12844 gtk_widget_style_get (GTK_WIDGET (tree_view),
12845 "vertical-separator", &vertical_separator,
12846 "horizontal-separator", &horizontal_separator,
12856 rect->x = column->button->allocation.x + horizontal_separator/2;
12857 rect->width = column->button->allocation.width - horizontal_separator;
12862 gboolean ret = _gtk_tree_view_find_node (tree_view, path, &tree, &node);
12864 /* Get vertical coords */
12865 if ((!ret && tree == NULL) || ret)
12868 rect->y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
12869 rect->height = MAX (CELL_HEIGHT (node, vertical_separator), tree_view->priv->expander_size - vertical_separator);
12872 gtk_tree_view_is_expander_column (tree_view, column))
12874 gint depth = gtk_tree_path_get_depth (path);
12877 rtl = gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL;
12880 rect->x += (depth - 1) * tree_view->priv->level_indentation;
12881 rect->width -= (depth - 1) * tree_view->priv->level_indentation;
12883 if (TREE_VIEW_DRAW_EXPANDERS (tree_view))
12886 rect->x += depth * tree_view->priv->expander_size;
12887 rect->width -= depth * tree_view->priv->expander_size;
12890 rect->width = MAX (rect->width, 0);
12896 * gtk_tree_view_get_background_area:
12897 * @tree_view: a #GtkTreeView
12898 * @path: a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
12899 * @column: a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
12900 * @rect: rectangle to fill with cell background rect
12902 * Fills the bounding rectangle in bin_window coordinates for the cell at the
12903 * row specified by @path and the column specified by @column. If @path is
12904 * %NULL, or points to a node not found in the tree, the @y and @height fields of
12905 * the rectangle will be filled with 0. If @column is %NULL, the @x and @width
12906 * fields will be filled with 0. The returned rectangle is equivalent to the
12907 * @background_area passed to gtk_cell_renderer_render(). These background
12908 * areas tile to cover the entire bin window. Contrast with the @cell_area,
12909 * returned by gtk_tree_view_get_cell_area(), which returns only the cell
12910 * itself, excluding surrounding borders and the tree expander area.
12914 gtk_tree_view_get_background_area (GtkTreeView *tree_view,
12916 GtkTreeViewColumn *column,
12917 GdkRectangle *rect)
12919 GtkRBTree *tree = NULL;
12920 GtkRBNode *node = NULL;
12922 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12923 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
12924 g_return_if_fail (rect != NULL);
12933 /* Get vertical coords */
12935 if (!_gtk_tree_view_find_node (tree_view, path, &tree, &node) &&
12939 rect->y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
12941 rect->height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
12948 gtk_tree_view_get_background_xrange (tree_view, tree, column, &rect->x, &x2);
12949 rect->width = x2 - rect->x;
12954 * gtk_tree_view_get_visible_rect:
12955 * @tree_view: a #GtkTreeView
12956 * @visible_rect: rectangle to fill
12958 * Fills @visible_rect with the currently-visible region of the
12959 * buffer, in tree coordinates. Convert to bin_window coordinates with
12960 * gtk_tree_view_convert_tree_to_bin_window_coords().
12961 * Tree coordinates start at 0,0 for row 0 of the tree, and cover the entire
12962 * scrollable area of the tree.
12965 gtk_tree_view_get_visible_rect (GtkTreeView *tree_view,
12966 GdkRectangle *visible_rect)
12970 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12972 widget = GTK_WIDGET (tree_view);
12976 visible_rect->x = tree_view->priv->hadjustment->value;
12977 visible_rect->y = tree_view->priv->vadjustment->value;
12978 visible_rect->width = widget->allocation.width;
12979 visible_rect->height = widget->allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
12984 * gtk_tree_view_widget_to_tree_coords:
12985 * @tree_view: a #GtkTreeView
12986 * @wx: X coordinate relative to bin_window
12987 * @wy: Y coordinate relative to bin_window
12988 * @tx: return location for tree X coordinate
12989 * @ty: return location for tree Y coordinate
12991 * Converts bin_window coordinates to coordinates for the
12992 * tree (the full scrollable area of the tree).
12994 * Deprecated: 2.12: Due to historial reasons the name of this function is
12995 * incorrect. For converting coordinates relative to the widget to
12996 * bin_window coordinates, please see
12997 * gtk_tree_view_convert_widget_to_bin_window_coords().
13001 gtk_tree_view_widget_to_tree_coords (GtkTreeView *tree_view,
13007 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13010 *tx = wx + tree_view->priv->hadjustment->value;
13012 *ty = wy + tree_view->priv->dy;
13016 * gtk_tree_view_tree_to_widget_coords:
13017 * @tree_view: a #GtkTreeView
13018 * @tx: tree X coordinate
13019 * @ty: tree Y coordinate
13020 * @wx: return location for X coordinate relative to bin_window
13021 * @wy: return location for Y coordinate relative to bin_window
13023 * Converts tree coordinates (coordinates in full scrollable area of the tree)
13024 * to bin_window coordinates.
13026 * Deprecated: 2.12: Due to historial reasons the name of this function is
13027 * incorrect. For converting bin_window coordinates to coordinates relative
13028 * to bin_window, please see
13029 * gtk_tree_view_convert_bin_window_to_widget_coords().
13033 gtk_tree_view_tree_to_widget_coords (GtkTreeView *tree_view,
13039 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13042 *wx = tx - tree_view->priv->hadjustment->value;
13044 *wy = ty - tree_view->priv->dy;
13049 * gtk_tree_view_convert_widget_to_tree_coords:
13050 * @tree_view: a #GtkTreeView
13051 * @wx: X coordinate relative to the widget
13052 * @wy: Y coordinate relative to the widget
13053 * @tx: return location for tree X coordinate
13054 * @ty: return location for tree Y coordinate
13056 * Converts widget coordinates to coordinates for the
13057 * tree (the full scrollable area of the tree).
13062 gtk_tree_view_convert_widget_to_tree_coords (GtkTreeView *tree_view,
13070 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13072 gtk_tree_view_convert_widget_to_bin_window_coords (tree_view,
13075 gtk_tree_view_convert_bin_window_to_tree_coords (tree_view,
13081 * gtk_tree_view_convert_tree_to_widget_coords:
13082 * @tree_view: a #GtkTreeView
13083 * @tx: X coordinate relative to the tree
13084 * @ty: Y coordinate relative to the tree
13085 * @wx: return location for widget X coordinate
13086 * @wy: return location for widget Y coordinate
13088 * Converts tree coordinates (coordinates in full scrollable area of the tree)
13089 * to widget coordinates.
13094 gtk_tree_view_convert_tree_to_widget_coords (GtkTreeView *tree_view,
13102 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13104 gtk_tree_view_convert_tree_to_bin_window_coords (tree_view,
13107 gtk_tree_view_convert_bin_window_to_widget_coords (tree_view,
13113 * gtk_tree_view_convert_widget_to_bin_window_coords:
13114 * @tree_view: a #GtkTreeView
13115 * @wx: X coordinate relative to the widget
13116 * @wy: Y coordinate relative to the widget
13117 * @bx: return location for bin_window X coordinate
13118 * @by: return location for bin_window Y coordinate
13120 * Converts widget coordinates to coordinates for the bin_window
13121 * (see gtk_tree_view_get_bin_window()).
13126 gtk_tree_view_convert_widget_to_bin_window_coords (GtkTreeView *tree_view,
13132 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13135 *bx = wx + tree_view->priv->hadjustment->value;
13137 *by = wy - TREE_VIEW_HEADER_HEIGHT (tree_view);
13141 * gtk_tree_view_convert_bin_window_to_widget_coords:
13142 * @tree_view: a #GtkTreeView
13143 * @bx: bin_window X coordinate
13144 * @by: bin_window Y coordinate
13145 * @wx: return location for widget X coordinate
13146 * @wy: return location for widget Y coordinate
13148 * Converts bin_window coordinates (see gtk_tree_view_get_bin_window())
13149 * to widget relative coordinates.
13154 gtk_tree_view_convert_bin_window_to_widget_coords (GtkTreeView *tree_view,
13160 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13163 *wx = bx - tree_view->priv->hadjustment->value;
13165 *wy = by + TREE_VIEW_HEADER_HEIGHT (tree_view);
13169 * gtk_tree_view_convert_tree_to_bin_window_coords:
13170 * @tree_view: a #GtkTreeView
13171 * @tx: tree X coordinate
13172 * @ty: tree Y coordinate
13173 * @bx: return location for X coordinate relative to bin_window
13174 * @by: return location for Y coordinate relative to bin_window
13176 * Converts tree coordinates (coordinates in full scrollable area of the tree)
13177 * to bin_window coordinates.
13182 gtk_tree_view_convert_tree_to_bin_window_coords (GtkTreeView *tree_view,
13188 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13193 *by = ty - tree_view->priv->dy;
13197 * gtk_tree_view_convert_bin_window_to_tree_coords:
13198 * @tree_view: a #GtkTreeView
13199 * @bx: X coordinate relative to bin_window
13200 * @by: Y coordinate relative to bin_window
13201 * @tx: return location for tree X coordinate
13202 * @ty: return location for tree Y coordinate
13204 * Converts bin_window coordinates to coordinates for the
13205 * tree (the full scrollable area of the tree).
13210 gtk_tree_view_convert_bin_window_to_tree_coords (GtkTreeView *tree_view,
13216 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13221 *ty = by + tree_view->priv->dy;
13227 * gtk_tree_view_get_visible_range:
13228 * @tree_view: A #GtkTreeView
13229 * @start_path: Return location for start of region, or %NULL.
13230 * @end_path: Return location for end of region, or %NULL.
13232 * Sets @start_path and @end_path to be the first and last visible path.
13233 * Note that there may be invisible paths in between.
13235 * The paths should be freed with gtk_tree_path_free() after use.
13237 * Returns: %TRUE, if valid paths were placed in @start_path and @end_path.
13242 gtk_tree_view_get_visible_range (GtkTreeView *tree_view,
13243 GtkTreePath **start_path,
13244 GtkTreePath **end_path)
13250 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
13252 if (!tree_view->priv->tree)
13259 _gtk_rbtree_find_offset (tree_view->priv->tree,
13260 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, 0),
13263 *start_path = _gtk_tree_view_find_path (tree_view, tree, node);
13272 if (tree_view->priv->height < tree_view->priv->vadjustment->page_size)
13273 y = tree_view->priv->height - 1;
13275 y = TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, tree_view->priv->vadjustment->page_size) - 1;
13277 _gtk_rbtree_find_offset (tree_view->priv->tree, y, &tree, &node);
13279 *end_path = _gtk_tree_view_find_path (tree_view, tree, node);
13288 unset_reorderable (GtkTreeView *tree_view)
13290 if (tree_view->priv->reorderable)
13292 tree_view->priv->reorderable = FALSE;
13293 g_object_notify (G_OBJECT (tree_view), "reorderable");
13298 * gtk_tree_view_enable_model_drag_source:
13299 * @tree_view: a #GtkTreeView
13300 * @start_button_mask: Mask of allowed buttons to start drag
13301 * @targets: the table of targets that the drag will support
13302 * @n_targets: the number of items in @targets
13303 * @actions: the bitmask of possible actions for a drag from this
13306 * Turns @tree_view into a drag source for automatic DND. Calling this
13307 * method sets #GtkTreeView:reorderable to %FALSE.
13310 gtk_tree_view_enable_model_drag_source (GtkTreeView *tree_view,
13311 GdkModifierType start_button_mask,
13312 const GtkTargetEntry *targets,
13314 GdkDragAction actions)
13316 TreeViewDragInfo *di;
13318 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13320 gtk_drag_source_set (GTK_WIDGET (tree_view),
13326 di = ensure_info (tree_view);
13328 di->start_button_mask = start_button_mask;
13329 di->source_actions = actions;
13330 di->source_set = TRUE;
13332 unset_reorderable (tree_view);
13336 * gtk_tree_view_enable_model_drag_dest:
13337 * @tree_view: a #GtkTreeView
13338 * @targets: the table of targets that the drag will support
13339 * @n_targets: the number of items in @targets
13340 * @actions: the bitmask of possible actions for a drag from this
13343 * Turns @tree_view into a drop destination for automatic DND. Calling
13344 * this method sets #GtkTreeView:reorderable to %FALSE.
13347 gtk_tree_view_enable_model_drag_dest (GtkTreeView *tree_view,
13348 const GtkTargetEntry *targets,
13350 GdkDragAction actions)
13352 TreeViewDragInfo *di;
13354 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13356 gtk_drag_dest_set (GTK_WIDGET (tree_view),
13362 di = ensure_info (tree_view);
13363 di->dest_set = TRUE;
13365 unset_reorderable (tree_view);
13369 * gtk_tree_view_unset_rows_drag_source:
13370 * @tree_view: a #GtkTreeView
13372 * Undoes the effect of
13373 * gtk_tree_view_enable_model_drag_source(). Calling this method sets
13374 * #GtkTreeView:reorderable to %FALSE.
13377 gtk_tree_view_unset_rows_drag_source (GtkTreeView *tree_view)
13379 TreeViewDragInfo *di;
13381 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13383 di = get_info (tree_view);
13387 if (di->source_set)
13389 gtk_drag_source_unset (GTK_WIDGET (tree_view));
13390 di->source_set = FALSE;
13393 if (!di->dest_set && !di->source_set)
13394 remove_info (tree_view);
13397 unset_reorderable (tree_view);
13401 * gtk_tree_view_unset_rows_drag_dest:
13402 * @tree_view: a #GtkTreeView
13404 * Undoes the effect of
13405 * gtk_tree_view_enable_model_drag_dest(). Calling this method sets
13406 * #GtkTreeView:reorderable to %FALSE.
13409 gtk_tree_view_unset_rows_drag_dest (GtkTreeView *tree_view)
13411 TreeViewDragInfo *di;
13413 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13415 di = get_info (tree_view);
13421 gtk_drag_dest_unset (GTK_WIDGET (tree_view));
13422 di->dest_set = FALSE;
13425 if (!di->dest_set && !di->source_set)
13426 remove_info (tree_view);
13429 unset_reorderable (tree_view);
13433 * gtk_tree_view_set_drag_dest_row:
13434 * @tree_view: a #GtkTreeView
13435 * @path: The path of the row to highlight, or %NULL.
13436 * @pos: Specifies whether to drop before, after or into the row
13438 * Sets the row that is highlighted for feedback.
13441 gtk_tree_view_set_drag_dest_row (GtkTreeView *tree_view,
13443 GtkTreeViewDropPosition pos)
13445 GtkTreePath *current_dest;
13447 /* Note; this function is exported to allow a custom DND
13448 * implementation, so it can't touch TreeViewDragInfo
13451 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13453 current_dest = NULL;
13455 if (tree_view->priv->drag_dest_row)
13457 current_dest = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
13458 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
13461 /* special case a drop on an empty model */
13462 tree_view->priv->empty_view_drop = 0;
13464 if (pos == GTK_TREE_VIEW_DROP_BEFORE && path
13465 && gtk_tree_path_get_depth (path) == 1
13466 && gtk_tree_path_get_indices (path)[0] == 0)
13470 n_children = gtk_tree_model_iter_n_children (tree_view->priv->model,
13474 tree_view->priv->empty_view_drop = 1;
13477 tree_view->priv->drag_dest_pos = pos;
13481 tree_view->priv->drag_dest_row =
13482 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
13483 gtk_tree_view_queue_draw_path (tree_view, path, NULL);
13486 tree_view->priv->drag_dest_row = NULL;
13490 GtkRBTree *tree, *new_tree;
13491 GtkRBNode *node, *new_node;
13493 _gtk_tree_view_find_node (tree_view, current_dest, &tree, &node);
13494 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
13498 _gtk_rbtree_next_full (tree, node, &new_tree, &new_node);
13499 if (new_tree && new_node)
13500 _gtk_tree_view_queue_draw_node (tree_view, new_tree, new_node, NULL);
13502 _gtk_rbtree_prev_full (tree, node, &new_tree, &new_node);
13503 if (new_tree && new_node)
13504 _gtk_tree_view_queue_draw_node (tree_view, new_tree, new_node, NULL);
13506 gtk_tree_path_free (current_dest);
13511 * gtk_tree_view_get_drag_dest_row:
13512 * @tree_view: a #GtkTreeView
13513 * @path: Return location for the path of the highlighted row, or %NULL.
13514 * @pos: Return location for the drop position, or %NULL
13516 * Gets information about the row that is highlighted for feedback.
13519 gtk_tree_view_get_drag_dest_row (GtkTreeView *tree_view,
13520 GtkTreePath **path,
13521 GtkTreeViewDropPosition *pos)
13523 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13527 if (tree_view->priv->drag_dest_row)
13528 *path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
13531 if (tree_view->priv->empty_view_drop)
13532 *path = gtk_tree_path_new_from_indices (0, -1);
13539 *pos = tree_view->priv->drag_dest_pos;
13543 * gtk_tree_view_get_dest_row_at_pos:
13544 * @tree_view: a #GtkTreeView
13545 * @drag_x: the position to determine the destination row for
13546 * @drag_y: the position to determine the destination row for
13547 * @path: Return location for the path of the highlighted row, or %NULL.
13548 * @pos: Return location for the drop position, or %NULL
13550 * Determines the destination row for a given position. @drag_x and
13551 * @drag_y are expected to be in widget coordinates. This function is only
13552 * meaningful if @tree_view is realized. Therefore this function will always
13553 * return %FALSE if @tree_view is not realized or does not have a model.
13555 * Return value: whether there is a row at the given position, %TRUE if this
13556 * is indeed the case.
13559 gtk_tree_view_get_dest_row_at_pos (GtkTreeView *tree_view,
13562 GtkTreePath **path,
13563 GtkTreeViewDropPosition *pos)
13567 gdouble offset_into_row;
13570 GtkTreeViewColumn *column = NULL;
13571 GtkTreePath *tmp_path = NULL;
13573 /* Note; this function is exported to allow a custom DND
13574 * implementation, so it can't touch TreeViewDragInfo
13577 g_return_val_if_fail (tree_view != NULL, FALSE);
13578 g_return_val_if_fail (drag_x >= 0, FALSE);
13579 g_return_val_if_fail (drag_y >= 0, FALSE);
13584 if (tree_view->priv->bin_window == NULL)
13587 if (tree_view->priv->tree == NULL)
13590 /* If in the top third of a row, we drop before that row; if
13591 * in the bottom third, drop after that row; if in the middle,
13592 * and the row has children, drop into the row.
13594 gtk_tree_view_convert_widget_to_bin_window_coords (tree_view, drag_x, drag_y,
13597 if (!gtk_tree_view_get_path_at_pos (tree_view,
13606 gtk_tree_view_get_background_area (tree_view, tmp_path, column,
13609 offset_into_row = cell_y;
13614 gtk_tree_path_free (tmp_path);
13618 third = cell.height / 3.0;
13622 if (offset_into_row < third)
13624 *pos = GTK_TREE_VIEW_DROP_BEFORE;
13626 else if (offset_into_row < (cell.height / 2.0))
13628 *pos = GTK_TREE_VIEW_DROP_INTO_OR_BEFORE;
13630 else if (offset_into_row < third * 2.0)
13632 *pos = GTK_TREE_VIEW_DROP_INTO_OR_AFTER;
13636 *pos = GTK_TREE_VIEW_DROP_AFTER;
13645 /* KEEP IN SYNC WITH GTK_TREE_VIEW_BIN_EXPOSE */
13647 * gtk_tree_view_create_row_drag_icon:
13648 * @tree_view: a #GtkTreeView
13649 * @path: a #GtkTreePath in @tree_view
13651 * Creates a #GdkPixmap representation of the row at @path.
13652 * This image is used for a drag icon.
13654 * Return value: a newly-allocated pixmap of the drag icon.
13657 gtk_tree_view_create_row_drag_icon (GtkTreeView *tree_view,
13665 GdkRectangle background_area;
13666 GdkRectangle expose_area;
13669 /* start drawing inside the black outline */
13671 GdkDrawable *drawable;
13672 gint bin_window_width;
13673 gboolean is_separator = FALSE;
13676 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
13677 g_return_val_if_fail (path != NULL, NULL);
13679 widget = GTK_WIDGET (tree_view);
13681 if (!GTK_WIDGET_REALIZED (tree_view))
13684 depth = gtk_tree_path_get_depth (path);
13686 _gtk_tree_view_find_node (tree_view,
13694 if (!gtk_tree_model_get_iter (tree_view->priv->model,
13699 is_separator = row_is_separator (tree_view, &iter, NULL);
13703 background_area.y = y;
13704 background_area.height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
13706 gdk_drawable_get_size (tree_view->priv->bin_window,
13707 &bin_window_width, NULL);
13709 drawable = gdk_pixmap_new (tree_view->priv->bin_window,
13710 bin_window_width + 2,
13711 background_area.height + 2,
13716 expose_area.width = bin_window_width + 2;
13717 expose_area.height = background_area.height + 2;
13719 gdk_draw_rectangle (drawable,
13720 widget->style->base_gc [GTK_WIDGET_STATE (widget)],
13723 bin_window_width + 2,
13724 background_area.height + 2);
13726 rtl = gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL;
13728 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
13730 list = (rtl ? list->prev : list->next))
13732 GtkTreeViewColumn *column = list->data;
13733 GdkRectangle cell_area;
13734 gint vertical_separator;
13736 if (!column->visible)
13739 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, &iter,
13740 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
13741 node->children?TRUE:FALSE);
13743 background_area.x = cell_offset;
13744 background_area.width = column->width;
13746 gtk_widget_style_get (widget,
13747 "vertical-separator", &vertical_separator,
13750 cell_area = background_area;
13752 cell_area.y += vertical_separator / 2;
13753 cell_area.height -= vertical_separator;
13755 if (gtk_tree_view_is_expander_column (tree_view, column))
13758 cell_area.x += (depth - 1) * tree_view->priv->level_indentation;
13759 cell_area.width -= (depth - 1) * tree_view->priv->level_indentation;
13761 if (TREE_VIEW_DRAW_EXPANDERS(tree_view))
13764 cell_area.x += depth * tree_view->priv->expander_size;
13765 cell_area.width -= depth * tree_view->priv->expander_size;
13769 if (gtk_tree_view_column_cell_is_visible (column))
13772 gtk_paint_hline (widget->style,
13779 cell_area.x + cell_area.width,
13780 cell_area.y + cell_area.height / 2);
13782 _gtk_tree_view_column_cell_render (column,
13789 cell_offset += column->width;
13792 gdk_draw_rectangle (drawable,
13793 widget->style->black_gc,
13796 bin_window_width + 1,
13797 background_area.height + 1);
13804 * gtk_tree_view_set_destroy_count_func:
13805 * @tree_view: A #GtkTreeView
13806 * @func: Function to be called when a view row is destroyed, or %NULL
13807 * @data: User data to be passed to @func, or %NULL
13808 * @destroy: Destroy notifier for @data, or %NULL
13810 * This function should almost never be used. It is meant for private use by
13811 * ATK for determining the number of visible children that are removed when the
13812 * user collapses a row, or a row is deleted.
13815 gtk_tree_view_set_destroy_count_func (GtkTreeView *tree_view,
13816 GtkTreeDestroyCountFunc func,
13818 GDestroyNotify destroy)
13820 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13822 if (tree_view->priv->destroy_count_destroy)
13823 tree_view->priv->destroy_count_destroy (tree_view->priv->destroy_count_data);
13825 tree_view->priv->destroy_count_func = func;
13826 tree_view->priv->destroy_count_data = data;
13827 tree_view->priv->destroy_count_destroy = destroy;
13832 * Interactive search
13836 * gtk_tree_view_set_enable_search:
13837 * @tree_view: A #GtkTreeView
13838 * @enable_search: %TRUE, if the user can search interactively
13840 * If @enable_search is set, then the user can type in text to search through
13841 * the tree interactively (this is sometimes called "typeahead find").
13843 * Note that even if this is %FALSE, the user can still initiate a search
13844 * using the "start-interactive-search" key binding.
13847 gtk_tree_view_set_enable_search (GtkTreeView *tree_view,
13848 gboolean enable_search)
13850 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13852 enable_search = !!enable_search;
13854 if (tree_view->priv->enable_search != enable_search)
13856 tree_view->priv->enable_search = enable_search;
13857 g_object_notify (G_OBJECT (tree_view), "enable-search");
13862 * gtk_tree_view_get_enable_search:
13863 * @tree_view: A #GtkTreeView
13865 * Returns whether or not the tree allows to start interactive searching
13866 * by typing in text.
13868 * Return value: whether or not to let the user search interactively
13871 gtk_tree_view_get_enable_search (GtkTreeView *tree_view)
13873 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
13875 return tree_view->priv->enable_search;
13880 * gtk_tree_view_get_search_column:
13881 * @tree_view: A #GtkTreeView
13883 * Gets the column searched on by the interactive search code.
13885 * Return value: the column the interactive search code searches in.
13888 gtk_tree_view_get_search_column (GtkTreeView *tree_view)
13890 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
13892 return (tree_view->priv->search_column);
13896 * gtk_tree_view_set_search_column:
13897 * @tree_view: A #GtkTreeView
13898 * @column: the column of the model to search in, or -1 to disable searching
13900 * Sets @column as the column where the interactive search code should
13901 * search in for the current model.
13903 * If the search column is set, users can use the "start-interactive-search"
13904 * key binding to bring up search popup. The enable-search property controls
13905 * whether simply typing text will also start an interactive search.
13907 * Note that @column refers to a column of the current model. The search
13908 * column is reset to -1 when the model is changed.
13911 gtk_tree_view_set_search_column (GtkTreeView *tree_view,
13914 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13915 g_return_if_fail (column >= -1);
13917 if (tree_view->priv->search_column == column)
13920 tree_view->priv->search_column = column;
13921 g_object_notify (G_OBJECT (tree_view), "search-column");
13925 * gtk_tree_view_get_search_equal_func:
13926 * @tree_view: A #GtkTreeView
13928 * Returns the compare function currently in use.
13930 * Return value: the currently used compare function for the search code.
13933 GtkTreeViewSearchEqualFunc
13934 gtk_tree_view_get_search_equal_func (GtkTreeView *tree_view)
13936 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
13938 return tree_view->priv->search_equal_func;
13942 * gtk_tree_view_set_search_equal_func:
13943 * @tree_view: A #GtkTreeView
13944 * @search_equal_func: the compare function to use during the search
13945 * @search_user_data: user data to pass to @search_equal_func, or %NULL
13946 * @search_destroy: Destroy notifier for @search_user_data, or %NULL
13948 * Sets the compare function for the interactive search capabilities; note
13949 * that somewhat like strcmp() returning 0 for equality
13950 * #GtkTreeViewSearchEqualFunc returns %FALSE on matches.
13953 gtk_tree_view_set_search_equal_func (GtkTreeView *tree_view,
13954 GtkTreeViewSearchEqualFunc search_equal_func,
13955 gpointer search_user_data,
13956 GDestroyNotify search_destroy)
13958 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13959 g_return_if_fail (search_equal_func != NULL);
13961 if (tree_view->priv->search_destroy)
13962 tree_view->priv->search_destroy (tree_view->priv->search_user_data);
13964 tree_view->priv->search_equal_func = search_equal_func;
13965 tree_view->priv->search_user_data = search_user_data;
13966 tree_view->priv->search_destroy = search_destroy;
13967 if (tree_view->priv->search_equal_func == NULL)
13968 tree_view->priv->search_equal_func = gtk_tree_view_search_equal_func;
13972 * gtk_tree_view_get_search_entry:
13973 * @tree_view: A #GtkTreeView
13975 * Returns the #GtkEntry which is currently in use as interactive search
13976 * entry for @tree_view. In case the built-in entry is being used, %NULL
13977 * will be returned.
13979 * Return value: the entry currently in use as search entry.
13984 gtk_tree_view_get_search_entry (GtkTreeView *tree_view)
13986 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
13988 if (tree_view->priv->search_custom_entry_set)
13989 return GTK_ENTRY (tree_view->priv->search_entry);
13995 * gtk_tree_view_set_search_entry:
13996 * @tree_view: A #GtkTreeView
13997 * @entry: the entry the interactive search code of @tree_view should use or %NULL
13999 * Sets the entry which the interactive search code will use for this
14000 * @tree_view. This is useful when you want to provide a search entry
14001 * in our interface at all time at a fixed position. Passing %NULL for
14002 * @entry will make the interactive search code use the built-in popup
14008 gtk_tree_view_set_search_entry (GtkTreeView *tree_view,
14011 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14012 g_return_if_fail (entry == NULL || GTK_IS_ENTRY (entry));
14014 if (tree_view->priv->search_custom_entry_set)
14016 if (tree_view->priv->search_entry_changed_id)
14018 g_signal_handler_disconnect (tree_view->priv->search_entry,
14019 tree_view->priv->search_entry_changed_id);
14020 tree_view->priv->search_entry_changed_id = 0;
14022 g_signal_handlers_disconnect_by_func (tree_view->priv->search_entry,
14023 G_CALLBACK (gtk_tree_view_search_key_press_event),
14026 g_object_unref (tree_view->priv->search_entry);
14028 else if (tree_view->priv->search_window)
14030 gtk_widget_destroy (tree_view->priv->search_window);
14032 tree_view->priv->search_window = NULL;
14037 tree_view->priv->search_entry = g_object_ref (entry);
14038 tree_view->priv->search_custom_entry_set = TRUE;
14040 if (tree_view->priv->search_entry_changed_id == 0)
14042 tree_view->priv->search_entry_changed_id =
14043 g_signal_connect (tree_view->priv->search_entry, "changed",
14044 G_CALLBACK (gtk_tree_view_search_init),
14048 g_signal_connect (tree_view->priv->search_entry, "key-press-event",
14049 G_CALLBACK (gtk_tree_view_search_key_press_event),
14052 gtk_tree_view_search_init (tree_view->priv->search_entry, tree_view);
14056 tree_view->priv->search_entry = NULL;
14057 tree_view->priv->search_custom_entry_set = FALSE;
14062 * gtk_tree_view_set_search_position_func:
14063 * @tree_view: A #GtkTreeView
14064 * @func: the function to use to position the search dialog, or %NULL
14065 * to use the default search position function
14066 * @data: user data to pass to @func, or %NULL
14067 * @destroy: Destroy notifier for @data, or %NULL
14069 * Sets the function to use when positioning the search dialog.
14074 gtk_tree_view_set_search_position_func (GtkTreeView *tree_view,
14075 GtkTreeViewSearchPositionFunc func,
14076 gpointer user_data,
14077 GDestroyNotify destroy)
14079 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14081 if (tree_view->priv->search_position_destroy)
14082 tree_view->priv->search_position_destroy (tree_view->priv->search_position_user_data);
14084 tree_view->priv->search_position_func = func;
14085 tree_view->priv->search_position_user_data = user_data;
14086 tree_view->priv->search_position_destroy = destroy;
14087 if (tree_view->priv->search_position_func == NULL)
14088 tree_view->priv->search_position_func = gtk_tree_view_search_position_func;
14092 * gtk_tree_view_get_search_position_func:
14093 * @tree_view: A #GtkTreeView
14095 * Returns the positioning function currently in use.
14097 * Return value: the currently used function for positioning the search dialog.
14101 GtkTreeViewSearchPositionFunc
14102 gtk_tree_view_get_search_position_func (GtkTreeView *tree_view)
14104 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
14106 return tree_view->priv->search_position_func;
14111 gtk_tree_view_search_dialog_hide (GtkWidget *search_dialog,
14112 GtkTreeView *tree_view)
14114 if (tree_view->priv->disable_popdown)
14117 if (tree_view->priv->search_entry_changed_id)
14119 g_signal_handler_disconnect (tree_view->priv->search_entry,
14120 tree_view->priv->search_entry_changed_id);
14121 tree_view->priv->search_entry_changed_id = 0;
14123 if (tree_view->priv->typeselect_flush_timeout)
14125 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14126 tree_view->priv->typeselect_flush_timeout = 0;
14129 if (GTK_WIDGET_VISIBLE (search_dialog))
14131 /* send focus-in event */
14132 send_focus_change (GTK_WIDGET (tree_view->priv->search_entry), FALSE);
14133 gtk_widget_hide (search_dialog);
14134 gtk_entry_set_text (GTK_ENTRY (tree_view->priv->search_entry), "");
14135 send_focus_change (GTK_WIDGET (tree_view), TRUE);
14140 gtk_tree_view_search_position_func (GtkTreeView *tree_view,
14141 GtkWidget *search_dialog,
14142 gpointer user_data)
14145 gint tree_x, tree_y;
14146 gint tree_width, tree_height;
14147 GdkWindow *tree_window = GTK_WIDGET (tree_view)->window;
14148 GdkScreen *screen = gdk_drawable_get_screen (tree_window);
14149 GtkRequisition requisition;
14151 GdkRectangle monitor;
14153 monitor_num = gdk_screen_get_monitor_at_window (screen, tree_window);
14154 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
14156 gtk_widget_realize (search_dialog);
14158 gdk_window_get_origin (tree_window, &tree_x, &tree_y);
14159 gdk_drawable_get_size (tree_window,
14162 gtk_widget_size_request (search_dialog, &requisition);
14164 if (tree_x + tree_width > gdk_screen_get_width (screen))
14165 x = gdk_screen_get_width (screen) - requisition.width;
14166 else if (tree_x + tree_width - requisition.width < 0)
14169 x = tree_x + tree_width - requisition.width;
14171 if (tree_y + tree_height + requisition.height > gdk_screen_get_height (screen))
14172 y = gdk_screen_get_height (screen) - requisition.height;
14173 else if (tree_y + tree_height < 0) /* isn't really possible ... */
14176 y = tree_y + tree_height;
14178 gtk_window_move (GTK_WINDOW (search_dialog), x, y);
14182 gtk_tree_view_search_disable_popdown (GtkEntry *entry,
14186 GtkTreeView *tree_view = (GtkTreeView *)data;
14188 tree_view->priv->disable_popdown = 1;
14189 g_signal_connect (menu, "hide",
14190 G_CALLBACK (gtk_tree_view_search_enable_popdown), data);
14193 /* Because we're visible but offscreen, we just set a flag in the preedit
14197 gtk_tree_view_search_preedit_changed (GtkIMContext *im_context,
14198 GtkTreeView *tree_view)
14200 tree_view->priv->imcontext_changed = 1;
14201 if (tree_view->priv->typeselect_flush_timeout)
14203 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14204 tree_view->priv->typeselect_flush_timeout =
14205 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
14206 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
14213 gtk_tree_view_search_activate (GtkEntry *entry,
14214 GtkTreeView *tree_view)
14220 gtk_tree_view_search_dialog_hide (tree_view->priv->search_window,
14223 /* If we have a row selected and it's the cursor row, we activate
14225 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
14227 path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
14229 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
14231 if (node && GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
14232 gtk_tree_view_row_activated (tree_view, path, tree_view->priv->focus_column);
14234 gtk_tree_path_free (path);
14239 gtk_tree_view_real_search_enable_popdown (gpointer data)
14241 GtkTreeView *tree_view = (GtkTreeView *)data;
14243 tree_view->priv->disable_popdown = 0;
14249 gtk_tree_view_search_enable_popdown (GtkWidget *widget,
14252 gdk_threads_add_timeout_full (G_PRIORITY_HIGH, 200, gtk_tree_view_real_search_enable_popdown, g_object_ref (data), g_object_unref);
14256 gtk_tree_view_search_delete_event (GtkWidget *widget,
14257 GdkEventAny *event,
14258 GtkTreeView *tree_view)
14260 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
14262 gtk_tree_view_search_dialog_hide (widget, tree_view);
14268 gtk_tree_view_search_button_press_event (GtkWidget *widget,
14269 GdkEventButton *event,
14270 GtkTreeView *tree_view)
14272 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
14274 gtk_tree_view_search_dialog_hide (widget, tree_view);
14276 if (event->window == tree_view->priv->bin_window)
14277 gtk_tree_view_button_press (GTK_WIDGET (tree_view), event);
14283 gtk_tree_view_search_scroll_event (GtkWidget *widget,
14284 GdkEventScroll *event,
14285 GtkTreeView *tree_view)
14287 gboolean retval = FALSE;
14289 if (event->direction == GDK_SCROLL_UP)
14291 gtk_tree_view_search_move (widget, tree_view, TRUE);
14294 else if (event->direction == GDK_SCROLL_DOWN)
14296 gtk_tree_view_search_move (widget, tree_view, FALSE);
14300 /* renew the flush timeout */
14301 if (retval && tree_view->priv->typeselect_flush_timeout
14302 && !tree_view->priv->search_custom_entry_set)
14304 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14305 tree_view->priv->typeselect_flush_timeout =
14306 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
14307 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
14315 gtk_tree_view_search_key_press_event (GtkWidget *widget,
14316 GdkEventKey *event,
14317 GtkTreeView *tree_view)
14319 gboolean retval = FALSE;
14321 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
14322 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
14324 /* close window and cancel the search */
14325 if (!tree_view->priv->search_custom_entry_set
14326 && (event->keyval == GDK_Escape ||
14327 event->keyval == GDK_Tab ||
14328 event->keyval == GDK_KP_Tab ||
14329 event->keyval == GDK_ISO_Left_Tab))
14331 gtk_tree_view_search_dialog_hide (widget, tree_view);
14335 /* select previous matching iter */
14336 if (event->keyval == GDK_Up || event->keyval == GDK_KP_Up)
14338 if (!gtk_tree_view_search_move (widget, tree_view, TRUE))
14339 gtk_widget_error_bell (widget);
14344 if (((event->state & (GTK_DEFAULT_ACCEL_MOD_MASK | GDK_SHIFT_MASK)) == (GTK_DEFAULT_ACCEL_MOD_MASK | GDK_SHIFT_MASK))
14345 && (event->keyval == GDK_g || event->keyval == GDK_G))
14347 if (!gtk_tree_view_search_move (widget, tree_view, TRUE))
14348 gtk_widget_error_bell (widget);
14353 /* select next matching iter */
14354 if (event->keyval == GDK_Down || event->keyval == GDK_KP_Down)
14356 if (!gtk_tree_view_search_move (widget, tree_view, FALSE))
14357 gtk_widget_error_bell (widget);
14362 if (((event->state & (GTK_DEFAULT_ACCEL_MOD_MASK | GDK_SHIFT_MASK)) == GTK_DEFAULT_ACCEL_MOD_MASK)
14363 && (event->keyval == GDK_g || event->keyval == GDK_G))
14365 if (!gtk_tree_view_search_move (widget, tree_view, FALSE))
14366 gtk_widget_error_bell (widget);
14371 /* renew the flush timeout */
14372 if (retval && tree_view->priv->typeselect_flush_timeout
14373 && !tree_view->priv->search_custom_entry_set)
14375 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14376 tree_view->priv->typeselect_flush_timeout =
14377 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
14378 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
14385 /* this function returns FALSE if there is a search string but
14386 * nothing was found, and TRUE otherwise.
14389 gtk_tree_view_search_move (GtkWidget *window,
14390 GtkTreeView *tree_view,
14398 GtkTreeModel *model;
14399 GtkTreeSelection *selection;
14401 text = gtk_entry_get_text (GTK_ENTRY (tree_view->priv->search_entry));
14403 g_return_val_if_fail (text != NULL, FALSE);
14405 len = strlen (text);
14407 if (up && tree_view->priv->selected_iter == 1)
14408 return strlen (text) < 1;
14410 len = strlen (text);
14415 model = gtk_tree_view_get_model (tree_view);
14416 selection = gtk_tree_view_get_selection (tree_view);
14419 gtk_tree_selection_unselect_all (selection);
14420 if (!gtk_tree_model_get_iter_first (model, &iter))
14423 ret = gtk_tree_view_search_iter (model, selection, &iter, text,
14424 &count, up?((tree_view->priv->selected_iter) - 1):((tree_view->priv->selected_iter + 1)));
14429 tree_view->priv->selected_iter += up?(-1):(1);
14434 /* return to old iter */
14436 gtk_tree_model_get_iter_first (model, &iter);
14437 gtk_tree_view_search_iter (model, selection,
14439 &count, tree_view->priv->selected_iter);
14445 gtk_tree_view_search_equal_func (GtkTreeModel *model,
14449 gpointer search_data)
14451 gboolean retval = TRUE;
14453 gchar *normalized_string;
14454 gchar *normalized_key;
14455 gchar *case_normalized_string = NULL;
14456 gchar *case_normalized_key = NULL;
14457 GValue value = {0,};
14458 GValue transformed = {0,};
14460 gtk_tree_model_get_value (model, iter, column, &value);
14462 g_value_init (&transformed, G_TYPE_STRING);
14464 if (!g_value_transform (&value, &transformed))
14466 g_value_unset (&value);
14470 g_value_unset (&value);
14472 str = g_value_get_string (&transformed);
14475 g_value_unset (&transformed);
14479 normalized_string = g_utf8_normalize (str, -1, G_NORMALIZE_ALL);
14480 normalized_key = g_utf8_normalize (key, -1, G_NORMALIZE_ALL);
14482 if (normalized_string && normalized_key)
14484 case_normalized_string = g_utf8_casefold (normalized_string, -1);
14485 case_normalized_key = g_utf8_casefold (normalized_key, -1);
14487 if (strncmp (case_normalized_key, case_normalized_string, strlen (case_normalized_key)) == 0)
14491 g_value_unset (&transformed);
14492 g_free (normalized_key);
14493 g_free (normalized_string);
14494 g_free (case_normalized_key);
14495 g_free (case_normalized_string);
14501 gtk_tree_view_search_iter (GtkTreeModel *model,
14502 GtkTreeSelection *selection,
14508 GtkRBTree *tree = NULL;
14509 GtkRBNode *node = NULL;
14512 GtkTreeView *tree_view = gtk_tree_selection_get_tree_view (selection);
14514 path = gtk_tree_model_get_path (model, iter);
14515 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
14519 if (! tree_view->priv->search_equal_func (model, tree_view->priv->search_column, text, iter, tree_view->priv->search_user_data))
14524 gtk_tree_view_scroll_to_cell (tree_view, path, NULL,
14526 gtk_tree_selection_select_iter (selection, iter);
14527 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
14530 gtk_tree_path_free (path);
14536 if (node->children)
14538 gboolean has_child;
14541 tree = node->children;
14544 while (node->left != tree->nil)
14548 has_child = gtk_tree_model_iter_children (model, iter, &tmp);
14549 gtk_tree_path_down (path);
14552 TREE_VIEW_INTERNAL_ASSERT (has_child, FALSE);
14556 gboolean done = FALSE;
14560 node = _gtk_rbtree_next (tree, node);
14566 has_next = gtk_tree_model_iter_next (model, iter);
14569 gtk_tree_path_next (path);
14572 TREE_VIEW_INTERNAL_ASSERT (has_next, FALSE);
14576 gboolean has_parent;
14577 GtkTreeIter tmp_iter = *iter;
14579 node = tree->parent_node;
14580 tree = tree->parent_tree;
14585 gtk_tree_path_free (path);
14587 /* we've run out of tree, done with this func */
14591 has_parent = gtk_tree_model_iter_parent (model,
14594 gtk_tree_path_up (path);
14597 TREE_VIEW_INTERNAL_ASSERT (has_parent, FALSE);
14609 gtk_tree_view_search_init (GtkWidget *entry,
14610 GtkTreeView *tree_view)
14616 GtkTreeModel *model;
14617 GtkTreeSelection *selection;
14619 g_return_if_fail (GTK_IS_ENTRY (entry));
14620 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14622 text = gtk_entry_get_text (GTK_ENTRY (entry));
14624 model = gtk_tree_view_get_model (tree_view);
14625 selection = gtk_tree_view_get_selection (tree_view);
14628 gtk_tree_selection_unselect_all (selection);
14629 if (tree_view->priv->typeselect_flush_timeout
14630 && !tree_view->priv->search_custom_entry_set)
14632 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14633 tree_view->priv->typeselect_flush_timeout =
14634 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
14635 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
14642 if (!gtk_tree_model_get_iter_first (model, &iter))
14645 ret = gtk_tree_view_search_iter (model, selection,
14650 tree_view->priv->selected_iter = 1;
14654 gtk_tree_view_remove_widget (GtkCellEditable *cell_editable,
14655 GtkTreeView *tree_view)
14657 if (tree_view->priv->edited_column == NULL)
14660 _gtk_tree_view_column_stop_editing (tree_view->priv->edited_column);
14661 tree_view->priv->edited_column = NULL;
14663 if (GTK_WIDGET_HAS_FOCUS (cell_editable))
14664 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
14666 g_signal_handlers_disconnect_by_func (cell_editable,
14667 gtk_tree_view_remove_widget,
14670 gtk_container_remove (GTK_CONTAINER (tree_view),
14671 GTK_WIDGET (cell_editable));
14673 /* FIXME should only redraw a single node */
14674 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
14678 gtk_tree_view_start_editing (GtkTreeView *tree_view,
14679 GtkTreePath *cursor_path)
14682 GdkRectangle background_area;
14683 GdkRectangle cell_area;
14684 GtkCellEditable *editable_widget = NULL;
14685 gchar *path_string;
14686 guint flags = 0; /* can be 0, as the flags are primarily for rendering */
14687 gint retval = FALSE;
14688 GtkRBTree *cursor_tree;
14689 GtkRBNode *cursor_node;
14691 g_assert (tree_view->priv->focus_column);
14693 if (! GTK_WIDGET_REALIZED (tree_view))
14696 if (_gtk_tree_view_find_node (tree_view, cursor_path, &cursor_tree, &cursor_node) ||
14697 cursor_node == NULL)
14700 path_string = gtk_tree_path_to_string (cursor_path);
14701 gtk_tree_model_get_iter (tree_view->priv->model, &iter, cursor_path);
14703 validate_row (tree_view, cursor_tree, cursor_node, &iter, cursor_path);
14705 gtk_tree_view_column_cell_set_cell_data (tree_view->priv->focus_column,
14706 tree_view->priv->model,
14708 GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_PARENT),
14709 cursor_node->children?TRUE:FALSE);
14710 gtk_tree_view_get_background_area (tree_view,
14712 tree_view->priv->focus_column,
14714 gtk_tree_view_get_cell_area (tree_view,
14716 tree_view->priv->focus_column,
14719 if (_gtk_tree_view_column_cell_event (tree_view->priv->focus_column,
14728 if (editable_widget != NULL)
14732 GtkCellRenderer *cell;
14735 cell = _gtk_tree_view_column_get_edited_cell (tree_view->priv->focus_column);
14737 _gtk_tree_view_column_get_neighbor_sizes (tree_view->priv->focus_column, cell, &left, &right);
14740 area.width -= right + left;
14742 gtk_tree_view_real_start_editing (tree_view,
14743 tree_view->priv->focus_column,
14752 g_free (path_string);
14757 gtk_tree_view_real_start_editing (GtkTreeView *tree_view,
14758 GtkTreeViewColumn *column,
14760 GtkCellEditable *cell_editable,
14761 GdkRectangle *cell_area,
14765 gint pre_val = tree_view->priv->vadjustment->value;
14766 GtkRequisition requisition;
14768 tree_view->priv->edited_column = column;
14769 _gtk_tree_view_column_start_editing (column, GTK_CELL_EDITABLE (cell_editable));
14771 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
14772 cell_area->y += pre_val - (int)tree_view->priv->vadjustment->value;
14774 gtk_widget_size_request (GTK_WIDGET (cell_editable), &requisition);
14776 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
14778 if (requisition.height < cell_area->height)
14780 gint diff = cell_area->height - requisition.height;
14781 gtk_tree_view_put (tree_view,
14782 GTK_WIDGET (cell_editable),
14783 cell_area->x, cell_area->y + diff/2,
14784 cell_area->width, requisition.height);
14788 gtk_tree_view_put (tree_view,
14789 GTK_WIDGET (cell_editable),
14790 cell_area->x, cell_area->y,
14791 cell_area->width, cell_area->height);
14794 gtk_cell_editable_start_editing (GTK_CELL_EDITABLE (cell_editable),
14795 (GdkEvent *)event);
14797 gtk_widget_grab_focus (GTK_WIDGET (cell_editable));
14798 g_signal_connect (cell_editable, "remove-widget",
14799 G_CALLBACK (gtk_tree_view_remove_widget), tree_view);
14803 gtk_tree_view_stop_editing (GtkTreeView *tree_view,
14804 gboolean cancel_editing)
14806 GtkTreeViewColumn *column;
14807 GtkCellRenderer *cell;
14809 if (tree_view->priv->edited_column == NULL)
14813 * This is very evil. We need to do this, because
14814 * gtk_cell_editable_editing_done may trigger gtk_tree_view_row_changed
14815 * later on. If gtk_tree_view_row_changed notices
14816 * tree_view->priv->edited_column != NULL, it'll call
14817 * gtk_tree_view_stop_editing again. Bad things will happen then.
14819 * Please read that again if you intend to modify anything here.
14822 column = tree_view->priv->edited_column;
14823 tree_view->priv->edited_column = NULL;
14825 cell = _gtk_tree_view_column_get_edited_cell (column);
14826 gtk_cell_renderer_stop_editing (cell, cancel_editing);
14828 if (!cancel_editing)
14829 gtk_cell_editable_editing_done (column->editable_widget);
14831 tree_view->priv->edited_column = column;
14833 gtk_cell_editable_remove_widget (column->editable_widget);
14838 * gtk_tree_view_set_hover_selection:
14839 * @tree_view: a #GtkTreeView
14840 * @hover: %TRUE to enable hover selection mode
14842 * Enables of disables the hover selection mode of @tree_view.
14843 * Hover selection makes the selected row follow the pointer.
14844 * Currently, this works only for the selection modes
14845 * %GTK_SELECTION_SINGLE and %GTK_SELECTION_BROWSE.
14850 gtk_tree_view_set_hover_selection (GtkTreeView *tree_view,
14853 hover = hover != FALSE;
14855 if (hover != tree_view->priv->hover_selection)
14857 tree_view->priv->hover_selection = hover;
14859 g_object_notify (G_OBJECT (tree_view), "hover-selection");
14864 * gtk_tree_view_get_hover_selection:
14865 * @tree_view: a #GtkTreeView
14867 * Returns whether hover selection mode is turned on for @tree_view.
14869 * Return value: %TRUE if @tree_view is in hover selection mode
14874 gtk_tree_view_get_hover_selection (GtkTreeView *tree_view)
14876 return tree_view->priv->hover_selection;
14880 * gtk_tree_view_set_hover_expand:
14881 * @tree_view: a #GtkTreeView
14882 * @expand: %TRUE to enable hover selection mode
14884 * Enables of disables the hover expansion mode of @tree_view.
14885 * Hover expansion makes rows expand or collapse if the pointer
14891 gtk_tree_view_set_hover_expand (GtkTreeView *tree_view,
14894 expand = expand != FALSE;
14896 if (expand != tree_view->priv->hover_expand)
14898 tree_view->priv->hover_expand = expand;
14900 g_object_notify (G_OBJECT (tree_view), "hover-expand");
14905 * gtk_tree_view_get_hover_expand:
14906 * @tree_view: a #GtkTreeView
14908 * Returns whether hover expansion mode is turned on for @tree_view.
14910 * Return value: %TRUE if @tree_view is in hover expansion mode
14915 gtk_tree_view_get_hover_expand (GtkTreeView *tree_view)
14917 return tree_view->priv->hover_expand;
14921 * gtk_tree_view_set_rubber_banding:
14922 * @tree_view: a #GtkTreeView
14923 * @enable: %TRUE to enable rubber banding
14925 * Enables or disables rubber banding in @tree_view. If the selection mode
14926 * is #GTK_SELECTION_MULTIPLE, rubber banding will allow the user to select
14927 * multiple rows by dragging the mouse.
14932 gtk_tree_view_set_rubber_banding (GtkTreeView *tree_view,
14935 enable = enable != FALSE;
14937 if (enable != tree_view->priv->rubber_banding_enable)
14939 tree_view->priv->rubber_banding_enable = enable;
14941 g_object_notify (G_OBJECT (tree_view), "rubber-banding");
14946 * gtk_tree_view_get_rubber_banding:
14947 * @tree_view: a #GtkTreeView
14949 * Returns whether rubber banding is turned on for @tree_view. If the
14950 * selection mode is #GTK_SELECTION_MULTIPLE, rubber banding will allow the
14951 * user to select multiple rows by dragging the mouse.
14953 * Return value: %TRUE if rubber banding in @tree_view is enabled.
14958 gtk_tree_view_get_rubber_banding (GtkTreeView *tree_view)
14960 return tree_view->priv->rubber_banding_enable;
14964 * gtk_tree_view_is_rubber_banding_active:
14965 * @tree_view: a #GtkTreeView
14967 * Returns whether a rubber banding operation is currently being done
14970 * Return value: %TRUE if a rubber banding operation is currently being
14971 * done in @tree_view.
14976 gtk_tree_view_is_rubber_banding_active (GtkTreeView *tree_view)
14978 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
14980 if (tree_view->priv->rubber_banding_enable
14981 && tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
14988 * gtk_tree_view_get_row_separator_func:
14989 * @tree_view: a #GtkTreeView
14991 * Returns the current row separator function.
14993 * Return value: the current row separator function.
14997 GtkTreeViewRowSeparatorFunc
14998 gtk_tree_view_get_row_separator_func (GtkTreeView *tree_view)
15000 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
15002 return tree_view->priv->row_separator_func;
15006 * gtk_tree_view_set_row_separator_func:
15007 * @tree_view: a #GtkTreeView
15008 * @func: a #GtkTreeViewRowSeparatorFunc
15009 * @data: user data to pass to @func, or %NULL
15010 * @destroy: destroy notifier for @data, or %NULL
15012 * Sets the row separator function, which is used to determine
15013 * whether a row should be drawn as a separator. If the row separator
15014 * function is %NULL, no separators are drawn. This is the default value.
15019 gtk_tree_view_set_row_separator_func (GtkTreeView *tree_view,
15020 GtkTreeViewRowSeparatorFunc func,
15022 GDestroyNotify destroy)
15024 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15026 if (tree_view->priv->row_separator_destroy)
15027 tree_view->priv->row_separator_destroy (tree_view->priv->row_separator_data);
15029 tree_view->priv->row_separator_func = func;
15030 tree_view->priv->row_separator_data = data;
15031 tree_view->priv->row_separator_destroy = destroy;
15033 /* Have the tree recalculate heights */
15034 _gtk_rbtree_mark_invalid (tree_view->priv->tree);
15035 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
15040 gtk_tree_view_grab_notify (GtkWidget *widget,
15041 gboolean was_grabbed)
15043 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
15045 tree_view->priv->in_grab = !was_grabbed;
15049 tree_view->priv->pressed_button = -1;
15051 if (tree_view->priv->rubber_band_status)
15052 gtk_tree_view_stop_rubber_band (tree_view);
15057 gtk_tree_view_state_changed (GtkWidget *widget,
15058 GtkStateType previous_state)
15060 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
15062 if (GTK_WIDGET_REALIZED (widget))
15064 gdk_window_set_back_pixmap (widget->window, NULL, FALSE);
15065 gdk_window_set_background (tree_view->priv->bin_window, &widget->style->base[widget->state]);
15068 gtk_widget_queue_draw (widget);
15072 * gtk_tree_view_get_grid_lines:
15073 * @tree_view: a #GtkTreeView
15075 * Returns which grid lines are enabled in @tree_view.
15077 * Return value: a #GtkTreeViewGridLines value indicating which grid lines
15082 GtkTreeViewGridLines
15083 gtk_tree_view_get_grid_lines (GtkTreeView *tree_view)
15085 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), 0);
15087 return tree_view->priv->grid_lines;
15091 * gtk_tree_view_set_grid_lines:
15092 * @tree_view: a #GtkTreeView
15093 * @grid_lines: a #GtkTreeViewGridLines value indicating which grid lines to
15096 * Sets which grid lines to draw in @tree_view.
15101 gtk_tree_view_set_grid_lines (GtkTreeView *tree_view,
15102 GtkTreeViewGridLines grid_lines)
15104 GtkTreeViewPrivate *priv;
15106 GtkTreeViewGridLines old_grid_lines;
15108 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15110 priv = tree_view->priv;
15111 widget = GTK_WIDGET (tree_view);
15113 old_grid_lines = priv->grid_lines;
15114 priv->grid_lines = grid_lines;
15116 if (GTK_WIDGET_REALIZED (widget))
15118 if (grid_lines == GTK_TREE_VIEW_GRID_LINES_NONE &&
15119 priv->grid_line_gc)
15121 g_object_unref (priv->grid_line_gc);
15122 priv->grid_line_gc = NULL;
15125 if (grid_lines != GTK_TREE_VIEW_GRID_LINES_NONE &&
15126 !priv->grid_line_gc)
15131 gtk_widget_style_get (widget,
15132 "grid-line-width", &line_width,
15133 "grid-line-pattern", (gchar *)&dash_list,
15136 priv->grid_line_gc = gdk_gc_new (widget->window);
15137 gdk_gc_copy (priv->grid_line_gc, widget->style->black_gc);
15139 gdk_gc_set_line_attributes (priv->grid_line_gc, line_width,
15140 GDK_LINE_ON_OFF_DASH,
15141 GDK_CAP_BUTT, GDK_JOIN_MITER);
15142 gdk_gc_set_dashes (priv->grid_line_gc, 0, dash_list, 2);
15144 g_free (dash_list);
15148 if (old_grid_lines != grid_lines)
15150 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
15152 g_object_notify (G_OBJECT (tree_view), "enable-grid-lines");
15157 * gtk_tree_view_get_enable_tree_lines:
15158 * @tree_view: a #GtkTreeView.
15160 * Returns whether or not tree lines are drawn in @tree_view.
15162 * Return value: %TRUE if tree lines are drawn in @tree_view, %FALSE
15168 gtk_tree_view_get_enable_tree_lines (GtkTreeView *tree_view)
15170 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
15172 return tree_view->priv->tree_lines_enabled;
15176 * gtk_tree_view_set_enable_tree_lines:
15177 * @tree_view: a #GtkTreeView
15178 * @enabled: %TRUE to enable tree line drawing, %FALSE otherwise.
15180 * Sets whether to draw lines interconnecting the expanders in @tree_view.
15181 * This does not have any visible effects for lists.
15186 gtk_tree_view_set_enable_tree_lines (GtkTreeView *tree_view,
15189 GtkTreeViewPrivate *priv;
15191 gboolean was_enabled;
15193 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15195 enabled = enabled != FALSE;
15197 priv = tree_view->priv;
15198 widget = GTK_WIDGET (tree_view);
15200 was_enabled = priv->tree_lines_enabled;
15202 priv->tree_lines_enabled = enabled;
15204 if (GTK_WIDGET_REALIZED (widget))
15206 if (!enabled && priv->tree_line_gc)
15208 g_object_unref (priv->tree_line_gc);
15209 priv->tree_line_gc = NULL;
15212 if (enabled && !priv->tree_line_gc)
15216 gtk_widget_style_get (widget,
15217 "tree-line-width", &line_width,
15218 "tree-line-pattern", (gchar *)&dash_list,
15221 priv->tree_line_gc = gdk_gc_new (widget->window);
15222 gdk_gc_copy (priv->tree_line_gc, widget->style->black_gc);
15224 gdk_gc_set_line_attributes (priv->tree_line_gc, line_width,
15225 GDK_LINE_ON_OFF_DASH,
15226 GDK_CAP_BUTT, GDK_JOIN_MITER);
15227 gdk_gc_set_dashes (priv->tree_line_gc, 0, dash_list, 2);
15229 g_free (dash_list);
15233 if (was_enabled != enabled)
15235 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
15237 g_object_notify (G_OBJECT (tree_view), "enable-tree-lines");
15243 * gtk_tree_view_set_show_expanders:
15244 * @tree_view: a #GtkTreeView
15245 * @enabled: %TRUE to enable expander drawing, %FALSE otherwise.
15247 * Sets whether to draw and enable expanders and indent child rows in
15248 * @tree_view. When disabled there will be no expanders visible in trees
15249 * and there will be no way to expand and collapse rows by default. Also
15250 * note that hiding the expanders will disable the default indentation. You
15251 * can set a custom indentation in this case using
15252 * gtk_tree_view_set_level_indentation().
15253 * This does not have any visible effects for lists.
15258 gtk_tree_view_set_show_expanders (GtkTreeView *tree_view,
15261 gboolean was_enabled;
15263 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15265 enabled = enabled != FALSE;
15266 was_enabled = GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS);
15269 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS);
15271 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS);
15273 if (enabled != was_enabled)
15274 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
15278 * gtk_tree_view_get_show_expanders:
15279 * @tree_view: a #GtkTreeView.
15281 * Returns whether or not expanders are drawn in @tree_view.
15283 * Return value: %TRUE if expanders are drawn in @tree_view, %FALSE
15289 gtk_tree_view_get_show_expanders (GtkTreeView *tree_view)
15291 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
15293 return GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS);
15297 * gtk_tree_view_set_level_indentation:
15298 * @tree_view: a #GtkTreeView
15299 * @indentation: the amount, in pixels, of extra indentation in @tree_view.
15301 * Sets the amount of extra indentation for child levels to use in @tree_view
15302 * in addition to the default indentation. The value should be specified in
15303 * pixels, a value of 0 disables this feature and in this case only the default
15304 * indentation will be used.
15305 * This does not have any visible effects for lists.
15310 gtk_tree_view_set_level_indentation (GtkTreeView *tree_view,
15313 tree_view->priv->level_indentation = indentation;
15315 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
15319 * gtk_tree_view_get_level_indentation:
15320 * @tree_view: a #GtkTreeView.
15322 * Returns the amount, in pixels, of extra indentation for child levels
15325 * Return value: the amount of extra indentation for child levels in
15326 * @tree_view. A return value of 0 means that this feature is disabled.
15331 gtk_tree_view_get_level_indentation (GtkTreeView *tree_view)
15333 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), 0);
15335 return tree_view->priv->level_indentation;
15339 * gtk_tree_view_set_tooltip_row:
15340 * @tree_view: a #GtkTreeView
15341 * @tooltip: a #GtkTooltip
15342 * @path: a #GtkTreePath
15344 * Sets the tip area of @tooltip to be the area covered by the row at @path.
15345 * See also gtk_tree_view_set_tooltip_column() for a simpler alternative.
15346 * See also gtk_tooltip_set_tip_area().
15351 gtk_tree_view_set_tooltip_row (GtkTreeView *tree_view,
15352 GtkTooltip *tooltip,
15355 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15356 g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
15358 gtk_tree_view_set_tooltip_cell (tree_view, tooltip, path, NULL, NULL);
15362 * gtk_tree_view_set_tooltip_cell:
15363 * @tree_view: a #GtkTreeView
15364 * @tooltip: a #GtkTooltip
15365 * @path: a #GtkTreePath or %NULL
15366 * @column: a #GtkTreeViewColumn or %NULL
15367 * @cell: a #GtkCellRenderer or %NULL
15369 * Sets the tip area of @tooltip to the area @path, @column and @cell have
15370 * in common. For example if @path is %NULL and @column is set, the tip
15371 * area will be set to the full area covered by @column. See also
15372 * gtk_tooltip_set_tip_area().
15374 * Note that if @path is not specified and @cell is set and part of a column
15375 * containing the expander, the tooltip might not show and hide at the correct
15376 * position. In such cases @path must be set to the current node under the
15377 * mouse cursor for this function to operate correctly.
15379 * See also gtk_tree_view_set_tooltip_column() for a simpler alternative.
15384 gtk_tree_view_set_tooltip_cell (GtkTreeView *tree_view,
15385 GtkTooltip *tooltip,
15387 GtkTreeViewColumn *column,
15388 GtkCellRenderer *cell)
15392 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15393 g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
15394 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
15395 g_return_if_fail (cell == NULL || GTK_IS_CELL_RENDERER (cell));
15397 /* Determine x values. */
15398 if (column && cell)
15403 /* We always pass in path here, whether it is NULL or not.
15404 * For cells in expander columns path must be specified so that
15405 * we can correctly account for the indentation. This also means
15406 * that the tooltip is constrained vertically by the "Determine y
15407 * values" code below; this is not a real problem since cells actually
15408 * don't stretch vertically in constrast to columns.
15410 gtk_tree_view_get_cell_area (tree_view, path, column, &tmp);
15411 gtk_tree_view_column_cell_get_position (column, cell, &start, &width);
15413 gtk_tree_view_convert_bin_window_to_widget_coords (tree_view,
15416 rect.width = width;
15422 gtk_tree_view_get_background_area (tree_view, NULL, column, &tmp);
15423 gtk_tree_view_convert_bin_window_to_widget_coords (tree_view,
15426 rect.width = tmp.width;
15431 rect.width = GTK_WIDGET (tree_view)->allocation.width;
15434 /* Determine y values. */
15439 gtk_tree_view_get_background_area (tree_view, path, NULL, &tmp);
15440 gtk_tree_view_convert_bin_window_to_widget_coords (tree_view,
15443 rect.height = tmp.height;
15448 rect.height = tree_view->priv->vadjustment->page_size;
15451 gtk_tooltip_set_tip_area (tooltip, &rect);
15455 * gtk_tree_view_get_tooltip_context:
15456 * @tree_view: a #GtkTreeView
15457 * @x: the x coordinate (relative to widget coordinates)
15458 * @y: the y coordinate (relative to widget coordinates)
15459 * @keyboard_tip: whether this is a keyboard tooltip or not
15460 * @model: a pointer to receive a #GtkTreeModel or %NULL
15461 * @path: a pointer to receive a #GtkTreePath or %NULL
15462 * @iter: a pointer to receive a #GtkTreeIter or %NULL
15464 * This function is supposed to be used in a #GtkWidget::query-tooltip
15465 * signal handler for #GtkTreeView. The @x, @y and @keyboard_tip values
15466 * which are received in the signal handler, should be passed to this
15467 * function without modification.
15469 * The return value indicates whether there is a tree view row at the given
15470 * coordinates (%TRUE) or not (%FALSE) for mouse tooltips. For keyboard
15471 * tooltips the row returned will be the cursor row. When %TRUE, then any of
15472 * @model, @path and @iter which have been provided will be set to point to
15473 * that row and the corresponding model. @x and @y will always be converted
15474 * to be relative to @tree_view's bin_window if @keyboard_tooltip is %FALSE.
15476 * Return value: whether or not the given tooltip context points to a row.
15481 gtk_tree_view_get_tooltip_context (GtkTreeView *tree_view,
15484 gboolean keyboard_tip,
15485 GtkTreeModel **model,
15486 GtkTreePath **path,
15489 GtkTreePath *tmppath = NULL;
15491 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
15492 g_return_val_if_fail (x != NULL, FALSE);
15493 g_return_val_if_fail (y != NULL, FALSE);
15497 gtk_tree_view_get_cursor (tree_view, &tmppath, NULL);
15504 gtk_tree_view_convert_widget_to_bin_window_coords (tree_view, *x, *y,
15507 if (!gtk_tree_view_get_path_at_pos (tree_view, *x, *y,
15508 &tmppath, NULL, NULL, NULL))
15513 *model = gtk_tree_view_get_model (tree_view);
15516 gtk_tree_model_get_iter (gtk_tree_view_get_model (tree_view),
15522 gtk_tree_path_free (tmppath);
15528 gtk_tree_view_set_tooltip_query_cb (GtkWidget *widget,
15531 gboolean keyboard_tip,
15532 GtkTooltip *tooltip,
15535 GValue value = { 0, };
15536 GValue transformed = { 0, };
15539 GtkTreeModel *model;
15540 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
15542 if (!gtk_tree_view_get_tooltip_context (GTK_TREE_VIEW (widget),
15545 &model, &path, &iter))
15548 gtk_tree_model_get_value (model, &iter,
15549 tree_view->priv->tooltip_column, &value);
15551 g_value_init (&transformed, G_TYPE_STRING);
15553 if (!g_value_transform (&value, &transformed))
15555 g_value_unset (&value);
15556 gtk_tree_path_free (path);
15561 g_value_unset (&value);
15563 if (!g_value_get_string (&transformed))
15565 g_value_unset (&transformed);
15566 gtk_tree_path_free (path);
15571 gtk_tooltip_set_markup (tooltip, g_value_get_string (&transformed));
15572 gtk_tree_view_set_tooltip_row (tree_view, tooltip, path);
15574 gtk_tree_path_free (path);
15575 g_value_unset (&transformed);
15581 * gtk_tree_view_set_tooltip_column:
15582 * @tree_view: a #GtkTreeView
15583 * @column: an integer, which is a valid column number for @tree_view's model
15585 * If you only plan to have simple (text-only) tooltips on full rows, you
15586 * can use this function to have #GtkTreeView handle these automatically
15587 * for you. @column should be set to the column in @tree_view's model
15588 * containing the tooltip texts, or -1 to disable this feature.
15590 * When enabled, #GtkWidget::has-tooltip will be set to %TRUE and
15591 * @tree_view will connect a #GtkWidget::query-tooltip signal handler.
15593 * Note that the signal handler sets the text with gtk_tooltip_set_markup(),
15594 * so &, <, etc have to be escaped in the text.
15599 gtk_tree_view_set_tooltip_column (GtkTreeView *tree_view,
15602 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15604 if (column == tree_view->priv->tooltip_column)
15609 g_signal_handlers_disconnect_by_func (tree_view,
15610 gtk_tree_view_set_tooltip_query_cb,
15612 gtk_widget_set_has_tooltip (GTK_WIDGET (tree_view), FALSE);
15616 if (tree_view->priv->tooltip_column == -1)
15618 g_signal_connect (tree_view, "query-tooltip",
15619 G_CALLBACK (gtk_tree_view_set_tooltip_query_cb), NULL);
15620 gtk_widget_set_has_tooltip (GTK_WIDGET (tree_view), TRUE);
15624 tree_view->priv->tooltip_column = column;
15625 g_object_notify (G_OBJECT (tree_view), "tooltip-column");
15629 * gtk_tree_view_get_tooltip_column:
15630 * @tree_view: a #GtkTreeView
15632 * Returns the column of @tree_view's model which is being used for
15633 * displaying tooltips on @tree_view's rows.
15635 * Return value: the index of the tooltip column that is currently being
15636 * used, or -1 if this is disabled.
15641 gtk_tree_view_get_tooltip_column (GtkTreeView *tree_view)
15643 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), 0);
15645 return tree_view->priv->tooltip_column;
15649 gtk_tree_view_extended_layout_get_desired_size (GtkExtendedLayout *layout,
15650 GtkRequisition *minimal_size,
15651 GtkRequisition *desired_size)
15653 GtkTreeView *tree_view;
15654 gint natural_width = 0;
15655 GList *column_iter;
15656 GtkRequisition requisition;
15658 tree_view = GTK_TREE_VIEW (layout);
15660 gtk_widget_size_request (GTK_WIDGET (layout), &requisition);
15662 for (column_iter = tree_view->priv->columns; column_iter; column_iter = column_iter->next)
15664 GtkTreeViewColumn *column = column_iter->data;
15666 if (!column->visible)
15669 natural_width += gtk_tree_view_get_real_natural_width_from_column (tree_view, column);
15673 *minimal_size = requisition;
15677 desired_size->height = requisition.height;
15678 desired_size->width = natural_width;
15683 gtk_tree_view_extended_layout_init (GtkExtendedLayoutIface *iface)
15685 iface->get_desired_size = gtk_tree_view_extended_layout_get_desired_size;
15689 #define __GTK_TREE_VIEW_C__
15690 #include "gtkaliasdef.c"