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.
24 #include <gdk/gdkkeysyms.h>
26 #include "gtktreeview.h"
27 #include "gtkrbtree.h"
28 #include "gtktreednd.h"
29 #include "gtktreeprivate.h"
30 #include "gtkcellrenderer.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 "gtkscrollable.h"
48 #include "gtkprivate.h"
49 #include "gtkwidgetprivate.h"
50 #include "gtkentryprivate.h"
55 * @Short_description: A widget for displaying both trees and lists
57 * @See_also: #GtkTreeViewColumn, #GtkTreeSelection, #GtkTreeDnd, #GtkTreeMode,
58 * #GtkTreeSortable, #GtkTreeModelSort, #GtkListStore, #GtkTreeStore,
59 * #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf,
60 * #GtkCellRendererText, #GtkCellRendererToggle
62 * Widget that displays any object that implements the #GtkTreeModel interface.
64 * Please refer to the <link linkend="TreeWidget">tree widget conceptual
65 * overview</link> for an overview of all the objects and data types related
66 * to the tree widget and how they work together.
68 * Several different coordinate systems are exposed in the GtkTreeView API.
71 * <inlinegraphic fileref="tree-view-coordinates.png" format="PNG"></inlinegraphic>
72 * <variablelist><title>Coordinate systems in GtkTreeView API</title>
73 * <varlistentry><term>Widget coordinates</term>
76 * Coordinates relative to the widget (usually <literal>widget->window</literal>).
80 * <varlistentry><term>Bin window coordinates</term>
83 * Coordinates relative to the window that GtkTreeView renders to.
87 * <varlistentry><term>Tree coordinates</term>
90 * Coordinates relative to the entire scrollable area of GtkTreeView. These
91 * coordinates start at (0, 0) for row 0 of the tree.
97 * Several functions are available for converting between the different
98 * coordinate systems. The most common translations are between widget and bin
99 * window coordinates and between bin window and tree coordinates. For the
100 * former you can use gtk_tree_view_convert_widget_to_bin_window_coords()
101 * (and vice versa), for the latter gtk_tree_view_convert_bin_window_to_tree_coords()
104 * <refsect2 id="GtkTreeView-BUILDER-UI">
105 * <title>GtkTreeView as GtkBuildable</title>
106 * The GtkTreeView implementation of the GtkBuildable interface accepts
107 * #GtkTreeViewColumn objects as <child> elements and exposes the
108 * internal #GtkTreeSelection in UI definitions.
110 * <title>A UI definition fragment with GtkTreeView</title>
111 * <programlisting><![CDATA[
112 * <object class="GtkTreeView" id="treeview">
113 * <property name="model">liststore1</property>
115 * <object class="GtkTreeViewColumn" id="test-column">
116 * <property name="title">Test</property>
118 * <object class="GtkCellRendererText" id="test-renderer"/>
120 * <attribute name="text">1</attribute>
125 * <child internal-child="selection">
126 * <object class="GtkTreeSelection" id="selection">
127 * <signal name="changed" handler="on_treeview_selection_changed"/>
131 * ]]></programlisting>
137 #define GTK_TREE_VIEW_PRIORITY_VALIDATE (GDK_PRIORITY_REDRAW + 5)
138 #define GTK_TREE_VIEW_PRIORITY_SCROLL_SYNC (GTK_TREE_VIEW_PRIORITY_VALIDATE + 2)
139 #define GTK_TREE_VIEW_TIME_MS_PER_IDLE 30
140 #define SCROLL_EDGE_SIZE 15
141 #define EXPANDER_EXTRA_PADDING 4
142 #define GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT 5000
143 #define AUTO_EXPAND_TIMEOUT 500
145 /* The "background" areas of all rows/cells add up to cover the entire tree.
146 * The background includes all inter-row and inter-cell spacing.
147 * The "cell" areas are the cell_area passed in to gtk_cell_renderer_render(),
148 * i.e. just the cells, no spacing.
151 #define BACKGROUND_HEIGHT(node) (GTK_RBNODE_GET_HEIGHT (node))
152 #define CELL_HEIGHT(node, separator) ((BACKGROUND_HEIGHT (node)) - (separator))
154 /* Translate from bin_window coordinates to rbtree (tree coordinates) and
157 #define TREE_WINDOW_Y_TO_RBTREE_Y(tree_view,y) ((y) + tree_view->priv->dy)
158 #define RBTREE_Y_TO_TREE_WINDOW_Y(tree_view,y) ((y) - tree_view->priv->dy)
160 /* This is in bin_window coordinates */
161 #define BACKGROUND_FIRST_PIXEL(tree_view,tree,node) (RBTREE_Y_TO_TREE_WINDOW_Y (tree_view, _gtk_rbtree_node_find_offset ((tree), (node))))
162 #define CELL_FIRST_PIXEL(tree_view,tree,node,separator) (BACKGROUND_FIRST_PIXEL (tree_view,tree,node) + separator/2)
164 #define ROW_HEIGHT(tree_view,height) \
165 ((height > 0) ? (height) : (tree_view)->priv->expander_size)
168 typedef struct _GtkTreeViewChild GtkTreeViewChild;
169 struct _GtkTreeViewChild
179 typedef struct _TreeViewDragInfo TreeViewDragInfo;
180 struct _TreeViewDragInfo
182 GdkModifierType start_button_mask;
183 GtkTargetList *_unused_source_target_list;
184 GdkDragAction source_actions;
186 GtkTargetList *_unused_dest_target_list;
188 guint source_set : 1;
208 EXPAND_COLLAPSE_CURSOR_ROW,
209 SELECT_CURSOR_PARENT,
210 START_INTERACTIVE_SEARCH,
222 PROP_HEADERS_VISIBLE,
223 PROP_HEADERS_CLICKABLE,
224 PROP_EXPANDER_COLUMN,
229 PROP_FIXED_HEIGHT_MODE,
230 PROP_HOVER_SELECTION,
233 PROP_LEVEL_INDENTATION,
235 PROP_ENABLE_GRID_LINES,
236 PROP_ENABLE_TREE_LINES,
241 static void gtk_tree_view_finalize (GObject *object);
242 static void gtk_tree_view_set_property (GObject *object,
246 static void gtk_tree_view_get_property (GObject *object,
251 /* gtkwidget signals */
252 static void gtk_tree_view_destroy (GtkWidget *widget);
253 static void gtk_tree_view_realize (GtkWidget *widget);
254 static void gtk_tree_view_unrealize (GtkWidget *widget);
255 static void gtk_tree_view_map (GtkWidget *widget);
256 static void gtk_tree_view_get_preferred_width (GtkWidget *widget,
259 static void gtk_tree_view_get_preferred_height (GtkWidget *widget,
262 static void gtk_tree_view_size_request (GtkWidget *widget,
263 GtkRequisition *requisition);
264 static void gtk_tree_view_size_allocate (GtkWidget *widget,
265 GtkAllocation *allocation);
266 static gboolean gtk_tree_view_draw (GtkWidget *widget,
268 static gboolean gtk_tree_view_key_press (GtkWidget *widget,
270 static gboolean gtk_tree_view_key_release (GtkWidget *widget,
272 static gboolean gtk_tree_view_motion (GtkWidget *widget,
273 GdkEventMotion *event);
274 static gboolean gtk_tree_view_enter_notify (GtkWidget *widget,
275 GdkEventCrossing *event);
276 static gboolean gtk_tree_view_leave_notify (GtkWidget *widget,
277 GdkEventCrossing *event);
278 static gboolean gtk_tree_view_button_press (GtkWidget *widget,
279 GdkEventButton *event);
280 static gboolean gtk_tree_view_button_release (GtkWidget *widget,
281 GdkEventButton *event);
282 static gboolean gtk_tree_view_grab_broken (GtkWidget *widget,
283 GdkEventGrabBroken *event);
285 static gboolean gtk_tree_view_configure (GtkWidget *widget,
286 GdkEventConfigure *event);
289 static void gtk_tree_view_set_focus_child (GtkContainer *container,
291 static gint gtk_tree_view_focus_out (GtkWidget *widget,
292 GdkEventFocus *event);
293 static gint gtk_tree_view_focus (GtkWidget *widget,
294 GtkDirectionType direction);
295 static void gtk_tree_view_grab_focus (GtkWidget *widget);
296 static void gtk_tree_view_style_set (GtkWidget *widget,
297 GtkStyle *previous_style);
298 static void gtk_tree_view_grab_notify (GtkWidget *widget,
299 gboolean was_grabbed);
300 static void gtk_tree_view_state_changed (GtkWidget *widget,
301 GtkStateType previous_state);
303 /* container signals */
304 static void gtk_tree_view_remove (GtkContainer *container,
306 static void gtk_tree_view_forall (GtkContainer *container,
307 gboolean include_internals,
308 GtkCallback callback,
309 gpointer callback_data);
311 /* Source side drag signals */
312 static void gtk_tree_view_drag_begin (GtkWidget *widget,
313 GdkDragContext *context);
314 static void gtk_tree_view_drag_end (GtkWidget *widget,
315 GdkDragContext *context);
316 static void gtk_tree_view_drag_data_get (GtkWidget *widget,
317 GdkDragContext *context,
318 GtkSelectionData *selection_data,
321 static void gtk_tree_view_drag_data_delete (GtkWidget *widget,
322 GdkDragContext *context);
324 /* Target side drag signals */
325 static void gtk_tree_view_drag_leave (GtkWidget *widget,
326 GdkDragContext *context,
328 static gboolean gtk_tree_view_drag_motion (GtkWidget *widget,
329 GdkDragContext *context,
333 static gboolean gtk_tree_view_drag_drop (GtkWidget *widget,
334 GdkDragContext *context,
338 static void gtk_tree_view_drag_data_received (GtkWidget *widget,
339 GdkDragContext *context,
342 GtkSelectionData *selection_data,
346 /* tree_model signals */
347 static void gtk_tree_view_set_hadjustment (GtkTreeView *tree_view,
348 GtkAdjustment *adjustment);
349 static void gtk_tree_view_set_vadjustment (GtkTreeView *tree_view,
350 GtkAdjustment *adjustment);
351 static gboolean gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
352 GtkMovementStep step,
354 static gboolean gtk_tree_view_real_select_all (GtkTreeView *tree_view);
355 static gboolean gtk_tree_view_real_unselect_all (GtkTreeView *tree_view);
356 static gboolean gtk_tree_view_real_select_cursor_row (GtkTreeView *tree_view,
357 gboolean start_editing);
358 static gboolean gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view);
359 static gboolean gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
363 static gboolean gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view);
364 static void gtk_tree_view_row_changed (GtkTreeModel *model,
368 static void gtk_tree_view_row_inserted (GtkTreeModel *model,
372 static void gtk_tree_view_row_has_child_toggled (GtkTreeModel *model,
376 static void gtk_tree_view_row_deleted (GtkTreeModel *model,
379 static void gtk_tree_view_rows_reordered (GtkTreeModel *model,
385 /* Incremental reflow */
386 static gboolean validate_row (GtkTreeView *tree_view,
391 static void validate_visible_area (GtkTreeView *tree_view);
392 static gboolean validate_rows_handler (GtkTreeView *tree_view);
393 static gboolean do_validate_rows (GtkTreeView *tree_view,
394 gboolean size_request);
395 static gboolean validate_rows (GtkTreeView *tree_view);
396 static gboolean presize_handler_callback (gpointer data);
397 static void install_presize_handler (GtkTreeView *tree_view);
398 static void install_scroll_sync_handler (GtkTreeView *tree_view);
399 static void gtk_tree_view_set_top_row (GtkTreeView *tree_view,
402 static void gtk_tree_view_dy_to_top_row (GtkTreeView *tree_view);
403 static void gtk_tree_view_top_row_to_dy (GtkTreeView *tree_view);
404 static void invalidate_empty_focus (GtkTreeView *tree_view);
406 /* Internal functions */
407 static gboolean gtk_tree_view_is_expander_column (GtkTreeView *tree_view,
408 GtkTreeViewColumn *column);
409 static void gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
412 gboolean add_shifted_binding,
413 GtkMovementStep step,
415 static gint gtk_tree_view_unref_and_check_selection_tree (GtkTreeView *tree_view,
417 static void gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
419 const GdkRectangle *clip_rect);
420 static void gtk_tree_view_queue_draw_arrow (GtkTreeView *tree_view,
423 static void gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
429 static void gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
433 static gint gtk_tree_view_new_column_width (GtkTreeView *tree_view,
436 static void gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
437 GtkTreeView *tree_view);
438 static void gtk_tree_view_build_tree (GtkTreeView *tree_view,
443 static void gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
446 static void gtk_tree_view_clamp_column_visible (GtkTreeView *tree_view,
447 GtkTreeViewColumn *column,
448 gboolean focus_to_cell);
449 static gboolean gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
450 GdkEventMotion *event);
451 static void gtk_tree_view_focus_to_cursor (GtkTreeView *tree_view);
452 static void gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
454 static void gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
456 static void gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
458 static void gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
460 static gboolean gtk_tree_view_real_collapse_row (GtkTreeView *tree_view,
465 static gboolean gtk_tree_view_real_expand_row (GtkTreeView *tree_view,
471 static void gtk_tree_view_real_set_cursor (GtkTreeView *tree_view,
473 gboolean clear_and_select,
474 gboolean clamp_node);
475 static gboolean gtk_tree_view_has_special_cell (GtkTreeView *tree_view);
476 static void column_sizing_notify (GObject *object,
479 static gboolean expand_collapse_timeout (gpointer data);
480 static void add_expand_collapse_timeout (GtkTreeView *tree_view,
484 static void remove_expand_collapse_timeout (GtkTreeView *tree_view);
485 static void cancel_arrow_animation (GtkTreeView *tree_view);
486 static gboolean do_expand_collapse (GtkTreeView *tree_view);
487 static void gtk_tree_view_stop_rubber_band (GtkTreeView *tree_view);
488 static void update_prelight (GtkTreeView *tree_view,
492 /* interactive search */
493 static void gtk_tree_view_ensure_interactive_directory (GtkTreeView *tree_view);
494 static void gtk_tree_view_search_dialog_hide (GtkWidget *search_dialog,
495 GtkTreeView *tree_view,
497 static void gtk_tree_view_search_position_func (GtkTreeView *tree_view,
498 GtkWidget *search_dialog,
500 static void gtk_tree_view_search_disable_popdown (GtkEntry *entry,
503 static void gtk_tree_view_search_preedit_changed (GtkIMContext *im_context,
504 GtkTreeView *tree_view);
505 static void gtk_tree_view_search_activate (GtkEntry *entry,
506 GtkTreeView *tree_view);
507 static gboolean gtk_tree_view_real_search_enable_popdown(gpointer data);
508 static void gtk_tree_view_search_enable_popdown (GtkWidget *widget,
510 static gboolean gtk_tree_view_search_delete_event (GtkWidget *widget,
512 GtkTreeView *tree_view);
513 static gboolean gtk_tree_view_search_button_press_event (GtkWidget *widget,
514 GdkEventButton *event,
515 GtkTreeView *tree_view);
516 static gboolean gtk_tree_view_search_scroll_event (GtkWidget *entry,
517 GdkEventScroll *event,
518 GtkTreeView *tree_view);
519 static gboolean gtk_tree_view_search_key_press_event (GtkWidget *entry,
521 GtkTreeView *tree_view);
522 static gboolean gtk_tree_view_search_move (GtkWidget *window,
523 GtkTreeView *tree_view,
525 static gboolean gtk_tree_view_search_equal_func (GtkTreeModel *model,
529 gpointer search_data);
530 static gboolean gtk_tree_view_search_iter (GtkTreeModel *model,
531 GtkTreeSelection *selection,
536 static void gtk_tree_view_search_init (GtkWidget *entry,
537 GtkTreeView *tree_view);
538 static void gtk_tree_view_put (GtkTreeView *tree_view,
539 GtkWidget *child_widget,
544 static gboolean gtk_tree_view_start_editing (GtkTreeView *tree_view,
545 GtkTreePath *cursor_path);
546 static void gtk_tree_view_real_start_editing (GtkTreeView *tree_view,
547 GtkTreeViewColumn *column,
549 GtkCellEditable *cell_editable,
550 GdkRectangle *cell_area,
553 static void gtk_tree_view_stop_editing (GtkTreeView *tree_view,
554 gboolean cancel_editing);
555 static gboolean gtk_tree_view_real_start_interactive_search (GtkTreeView *tree_view,
557 gboolean keybinding);
558 static gboolean gtk_tree_view_start_interactive_search (GtkTreeView *tree_view);
559 static GtkTreeViewColumn *gtk_tree_view_get_drop_column (GtkTreeView *tree_view,
560 GtkTreeViewColumn *column,
564 static void gtk_tree_view_buildable_add_child (GtkBuildable *tree_view,
568 static GObject *gtk_tree_view_buildable_get_internal_child (GtkBuildable *buildable,
570 const gchar *childname);
571 static void gtk_tree_view_buildable_init (GtkBuildableIface *iface);
574 static gboolean scroll_row_timeout (gpointer data);
575 static void add_scroll_timeout (GtkTreeView *tree_view);
576 static void remove_scroll_timeout (GtkTreeView *tree_view);
578 static guint tree_view_signals [LAST_SIGNAL] = { 0 };
585 G_DEFINE_TYPE_WITH_CODE (GtkTreeView, gtk_tree_view, GTK_TYPE_CONTAINER,
586 G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
587 gtk_tree_view_buildable_init)
588 G_IMPLEMENT_INTERFACE (GTK_TYPE_SCROLLABLE, NULL))
591 gtk_tree_view_class_init (GtkTreeViewClass *class)
593 GObjectClass *o_class;
594 GtkWidgetClass *widget_class;
595 GtkContainerClass *container_class;
596 GtkBindingSet *binding_set;
598 binding_set = gtk_binding_set_by_class (class);
600 o_class = (GObjectClass *) class;
601 widget_class = (GtkWidgetClass *) class;
602 container_class = (GtkContainerClass *) class;
604 /* GObject signals */
605 o_class->set_property = gtk_tree_view_set_property;
606 o_class->get_property = gtk_tree_view_get_property;
607 o_class->finalize = gtk_tree_view_finalize;
609 /* GtkWidget signals */
610 widget_class->destroy = gtk_tree_view_destroy;
611 widget_class->map = gtk_tree_view_map;
612 widget_class->realize = gtk_tree_view_realize;
613 widget_class->unrealize = gtk_tree_view_unrealize;
614 widget_class->get_preferred_width = gtk_tree_view_get_preferred_width;
615 widget_class->get_preferred_height = gtk_tree_view_get_preferred_height;
616 widget_class->size_allocate = gtk_tree_view_size_allocate;
617 widget_class->button_press_event = gtk_tree_view_button_press;
618 widget_class->button_release_event = gtk_tree_view_button_release;
619 widget_class->grab_broken_event = gtk_tree_view_grab_broken;
620 /*widget_class->configure_event = gtk_tree_view_configure;*/
621 widget_class->motion_notify_event = gtk_tree_view_motion;
622 widget_class->draw = gtk_tree_view_draw;
623 widget_class->key_press_event = gtk_tree_view_key_press;
624 widget_class->key_release_event = gtk_tree_view_key_release;
625 widget_class->enter_notify_event = gtk_tree_view_enter_notify;
626 widget_class->leave_notify_event = gtk_tree_view_leave_notify;
627 widget_class->focus_out_event = gtk_tree_view_focus_out;
628 widget_class->drag_begin = gtk_tree_view_drag_begin;
629 widget_class->drag_end = gtk_tree_view_drag_end;
630 widget_class->drag_data_get = gtk_tree_view_drag_data_get;
631 widget_class->drag_data_delete = gtk_tree_view_drag_data_delete;
632 widget_class->drag_leave = gtk_tree_view_drag_leave;
633 widget_class->drag_motion = gtk_tree_view_drag_motion;
634 widget_class->drag_drop = gtk_tree_view_drag_drop;
635 widget_class->drag_data_received = gtk_tree_view_drag_data_received;
636 widget_class->focus = gtk_tree_view_focus;
637 widget_class->grab_focus = gtk_tree_view_grab_focus;
638 widget_class->style_set = gtk_tree_view_style_set;
639 widget_class->grab_notify = gtk_tree_view_grab_notify;
640 widget_class->state_changed = gtk_tree_view_state_changed;
642 /* GtkContainer signals */
643 container_class->remove = gtk_tree_view_remove;
644 container_class->forall = gtk_tree_view_forall;
645 container_class->set_focus_child = gtk_tree_view_set_focus_child;
647 class->move_cursor = gtk_tree_view_real_move_cursor;
648 class->select_all = gtk_tree_view_real_select_all;
649 class->unselect_all = gtk_tree_view_real_unselect_all;
650 class->select_cursor_row = gtk_tree_view_real_select_cursor_row;
651 class->toggle_cursor_row = gtk_tree_view_real_toggle_cursor_row;
652 class->expand_collapse_cursor_row = gtk_tree_view_real_expand_collapse_cursor_row;
653 class->select_cursor_parent = gtk_tree_view_real_select_cursor_parent;
654 class->start_interactive_search = gtk_tree_view_start_interactive_search;
658 g_object_class_install_property (o_class,
660 g_param_spec_object ("model",
661 P_("TreeView Model"),
662 P_("The model for the tree view"),
664 GTK_PARAM_READWRITE));
666 g_object_class_override_property (o_class, PROP_HADJUSTMENT, "hadjustment");
667 g_object_class_override_property (o_class, PROP_VADJUSTMENT, "vadjustment");
668 g_object_class_override_property (o_class, PROP_HSCROLL_POLICY, "hscroll-policy");
669 g_object_class_override_property (o_class, PROP_VSCROLL_POLICY, "vscroll-policy");
671 g_object_class_install_property (o_class,
672 PROP_HEADERS_VISIBLE,
673 g_param_spec_boolean ("headers-visible",
674 P_("Headers Visible"),
675 P_("Show the column header buttons"),
677 GTK_PARAM_READWRITE));
679 g_object_class_install_property (o_class,
680 PROP_HEADERS_CLICKABLE,
681 g_param_spec_boolean ("headers-clickable",
682 P_("Headers Clickable"),
683 P_("Column headers respond to click events"),
685 GTK_PARAM_READWRITE));
687 g_object_class_install_property (o_class,
688 PROP_EXPANDER_COLUMN,
689 g_param_spec_object ("expander-column",
690 P_("Expander Column"),
691 P_("Set the column for the expander column"),
692 GTK_TYPE_TREE_VIEW_COLUMN,
693 GTK_PARAM_READWRITE));
695 g_object_class_install_property (o_class,
697 g_param_spec_boolean ("reorderable",
699 P_("View is reorderable"),
701 GTK_PARAM_READWRITE));
703 g_object_class_install_property (o_class,
705 g_param_spec_boolean ("rules-hint",
707 P_("Set a hint to the theme engine to draw rows in alternating colors"),
709 GTK_PARAM_READWRITE));
711 g_object_class_install_property (o_class,
713 g_param_spec_boolean ("enable-search",
715 P_("View allows user to search through columns interactively"),
717 GTK_PARAM_READWRITE));
719 g_object_class_install_property (o_class,
721 g_param_spec_int ("search-column",
723 P_("Model column to search through during interactive search"),
727 GTK_PARAM_READWRITE));
730 * GtkTreeView:fixed-height-mode:
732 * Setting the ::fixed-height-mode property to %TRUE speeds up
733 * #GtkTreeView by assuming that all rows have the same height.
734 * Only enable this option if all rows are the same height.
735 * Please see gtk_tree_view_set_fixed_height_mode() for more
736 * information on this option.
740 g_object_class_install_property (o_class,
741 PROP_FIXED_HEIGHT_MODE,
742 g_param_spec_boolean ("fixed-height-mode",
743 P_("Fixed Height Mode"),
744 P_("Speeds up GtkTreeView by assuming that all rows have the same height"),
746 GTK_PARAM_READWRITE));
749 * GtkTreeView:hover-selection:
751 * Enables or disables the hover selection mode of @tree_view.
752 * Hover selection makes the selected row follow the pointer.
753 * Currently, this works only for the selection modes
754 * %GTK_SELECTION_SINGLE and %GTK_SELECTION_BROWSE.
756 * This mode is primarily intended for treeviews in popups, e.g.
757 * in #GtkComboBox or #GtkEntryCompletion.
761 g_object_class_install_property (o_class,
762 PROP_HOVER_SELECTION,
763 g_param_spec_boolean ("hover-selection",
764 P_("Hover Selection"),
765 P_("Whether the selection should follow the pointer"),
767 GTK_PARAM_READWRITE));
770 * GtkTreeView:hover-expand:
772 * Enables or disables the hover expansion mode of @tree_view.
773 * Hover expansion makes rows expand or collapse if the pointer moves
776 * This mode is primarily intended for treeviews in popups, e.g.
777 * in #GtkComboBox or #GtkEntryCompletion.
781 g_object_class_install_property (o_class,
783 g_param_spec_boolean ("hover-expand",
785 P_("Whether rows should be expanded/collapsed when the pointer moves over them"),
787 GTK_PARAM_READWRITE));
790 * GtkTreeView:show-expanders:
792 * %TRUE if the view has expanders.
796 g_object_class_install_property (o_class,
798 g_param_spec_boolean ("show-expanders",
799 P_("Show Expanders"),
800 P_("View has expanders"),
802 GTK_PARAM_READWRITE));
805 * GtkTreeView:level-indentation:
807 * Extra indentation for each level.
811 g_object_class_install_property (o_class,
812 PROP_LEVEL_INDENTATION,
813 g_param_spec_int ("level-indentation",
814 P_("Level Indentation"),
815 P_("Extra indentation for each level"),
819 GTK_PARAM_READWRITE));
821 g_object_class_install_property (o_class,
823 g_param_spec_boolean ("rubber-banding",
824 P_("Rubber Banding"),
825 P_("Whether to enable selection of multiple items by dragging the mouse pointer"),
827 GTK_PARAM_READWRITE));
829 g_object_class_install_property (o_class,
830 PROP_ENABLE_GRID_LINES,
831 g_param_spec_enum ("enable-grid-lines",
832 P_("Enable Grid Lines"),
833 P_("Whether grid lines should be drawn in the tree view"),
834 GTK_TYPE_TREE_VIEW_GRID_LINES,
835 GTK_TREE_VIEW_GRID_LINES_NONE,
836 GTK_PARAM_READWRITE));
838 g_object_class_install_property (o_class,
839 PROP_ENABLE_TREE_LINES,
840 g_param_spec_boolean ("enable-tree-lines",
841 P_("Enable Tree Lines"),
842 P_("Whether tree lines should be drawn in the tree view"),
844 GTK_PARAM_READWRITE));
846 g_object_class_install_property (o_class,
848 g_param_spec_int ("tooltip-column",
849 P_("Tooltip Column"),
850 P_("The column in the model containing the tooltip texts for the rows"),
854 GTK_PARAM_READWRITE));
856 /* Style properties */
857 #define _TREE_VIEW_EXPANDER_SIZE 12
858 #define _TREE_VIEW_VERTICAL_SEPARATOR 2
859 #define _TREE_VIEW_HORIZONTAL_SEPARATOR 2
861 gtk_widget_class_install_style_property (widget_class,
862 g_param_spec_int ("expander-size",
864 P_("Size of the expander arrow"),
867 _TREE_VIEW_EXPANDER_SIZE,
868 GTK_PARAM_READABLE));
870 gtk_widget_class_install_style_property (widget_class,
871 g_param_spec_int ("vertical-separator",
872 P_("Vertical Separator Width"),
873 P_("Vertical space between cells. Must be an even number"),
876 _TREE_VIEW_VERTICAL_SEPARATOR,
877 GTK_PARAM_READABLE));
879 gtk_widget_class_install_style_property (widget_class,
880 g_param_spec_int ("horizontal-separator",
881 P_("Horizontal Separator Width"),
882 P_("Horizontal space between cells. Must be an even number"),
885 _TREE_VIEW_HORIZONTAL_SEPARATOR,
886 GTK_PARAM_READABLE));
888 gtk_widget_class_install_style_property (widget_class,
889 g_param_spec_boolean ("allow-rules",
891 P_("Allow drawing of alternating color rows"),
893 GTK_PARAM_READABLE));
895 gtk_widget_class_install_style_property (widget_class,
896 g_param_spec_boolean ("indent-expanders",
897 P_("Indent Expanders"),
898 P_("Make the expanders indented"),
900 GTK_PARAM_READABLE));
902 gtk_widget_class_install_style_property (widget_class,
903 g_param_spec_boxed ("even-row-color",
904 P_("Even Row Color"),
905 P_("Color to use for even rows"),
907 GTK_PARAM_READABLE));
909 gtk_widget_class_install_style_property (widget_class,
910 g_param_spec_boxed ("odd-row-color",
912 P_("Color to use for odd rows"),
914 GTK_PARAM_READABLE));
916 gtk_widget_class_install_style_property (widget_class,
917 g_param_spec_int ("grid-line-width",
918 P_("Grid line width"),
919 P_("Width, in pixels, of the tree view grid lines"),
921 GTK_PARAM_READABLE));
923 gtk_widget_class_install_style_property (widget_class,
924 g_param_spec_int ("tree-line-width",
925 P_("Tree line width"),
926 P_("Width, in pixels, of the tree view lines"),
928 GTK_PARAM_READABLE));
930 gtk_widget_class_install_style_property (widget_class,
931 g_param_spec_string ("grid-line-pattern",
932 P_("Grid line pattern"),
933 P_("Dash pattern used to draw the tree view grid lines"),
935 GTK_PARAM_READABLE));
937 gtk_widget_class_install_style_property (widget_class,
938 g_param_spec_string ("tree-line-pattern",
939 P_("Tree line pattern"),
940 P_("Dash pattern used to draw the tree view lines"),
942 GTK_PARAM_READABLE));
946 * GtkTreeView::row-activated:
947 * @tree_view: the object on which the signal is emitted
948 * @path: the #GtkTreePath for the activated row
949 * @column: the #GtkTreeViewColumn in which the activation occurred
951 * The "row-activated" signal is emitted when the method
952 * gtk_tree_view_row_activated() is called or the user double clicks
953 * a treeview row. It is also emitted when a non-editable row is
954 * selected and one of the keys: Space, Shift+Space, Return or
957 * For selection handling refer to the <link linkend="TreeWidget">tree
958 * widget conceptual overview</link> as well as #GtkTreeSelection.
960 tree_view_signals[ROW_ACTIVATED] =
961 g_signal_new (I_("row-activated"),
962 G_TYPE_FROM_CLASS (o_class),
963 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
964 G_STRUCT_OFFSET (GtkTreeViewClass, row_activated),
966 _gtk_marshal_VOID__BOXED_OBJECT,
969 GTK_TYPE_TREE_VIEW_COLUMN);
972 * GtkTreeView::test-expand-row:
973 * @tree_view: the object on which the signal is emitted
974 * @iter: the tree iter of the row to expand
975 * @path: a tree path that points to the row
977 * The given row is about to be expanded (show its children nodes). Use this
978 * signal if you need to control the expandability of individual rows.
980 * Returns: %FALSE to allow expansion, %TRUE to reject
982 tree_view_signals[TEST_EXPAND_ROW] =
983 g_signal_new (I_("test-expand-row"),
984 G_TYPE_FROM_CLASS (o_class),
986 G_STRUCT_OFFSET (GtkTreeViewClass, test_expand_row),
987 _gtk_boolean_handled_accumulator, NULL,
988 _gtk_marshal_BOOLEAN__BOXED_BOXED,
994 * GtkTreeView::test-collapse-row:
995 * @tree_view: the object on which the signal is emitted
996 * @iter: the tree iter of the row to collapse
997 * @path: a tree path that points to the row
999 * The given row is about to be collapsed (hide its children nodes). Use this
1000 * signal if you need to control the collapsibility of individual rows.
1002 * Returns: %FALSE to allow collapsing, %TRUE to reject
1004 tree_view_signals[TEST_COLLAPSE_ROW] =
1005 g_signal_new (I_("test-collapse-row"),
1006 G_TYPE_FROM_CLASS (o_class),
1008 G_STRUCT_OFFSET (GtkTreeViewClass, test_collapse_row),
1009 _gtk_boolean_handled_accumulator, NULL,
1010 _gtk_marshal_BOOLEAN__BOXED_BOXED,
1013 GTK_TYPE_TREE_PATH);
1016 * GtkTreeView::row-expanded:
1017 * @tree_view: the object on which the signal is emitted
1018 * @iter: the tree iter of the expanded row
1019 * @path: a tree path that points to the row
1021 * The given row has been expanded (child nodes are shown).
1023 tree_view_signals[ROW_EXPANDED] =
1024 g_signal_new (I_("row-expanded"),
1025 G_TYPE_FROM_CLASS (o_class),
1027 G_STRUCT_OFFSET (GtkTreeViewClass, row_expanded),
1029 _gtk_marshal_VOID__BOXED_BOXED,
1032 GTK_TYPE_TREE_PATH);
1035 * GtkTreeView::row-collapsed:
1036 * @tree_view: the object on which the signal is emitted
1037 * @iter: the tree iter of the collapsed row
1038 * @path: a tree path that points to the row
1040 * The given row has been collapsed (child nodes are hidden).
1042 tree_view_signals[ROW_COLLAPSED] =
1043 g_signal_new (I_("row-collapsed"),
1044 G_TYPE_FROM_CLASS (o_class),
1046 G_STRUCT_OFFSET (GtkTreeViewClass, row_collapsed),
1048 _gtk_marshal_VOID__BOXED_BOXED,
1051 GTK_TYPE_TREE_PATH);
1054 * GtkTreeView::columns-changed:
1055 * @tree_view: the object on which the signal is emitted
1057 * The number of columns of the treeview has changed.
1059 tree_view_signals[COLUMNS_CHANGED] =
1060 g_signal_new (I_("columns-changed"),
1061 G_TYPE_FROM_CLASS (o_class),
1063 G_STRUCT_OFFSET (GtkTreeViewClass, columns_changed),
1065 _gtk_marshal_VOID__VOID,
1069 * GtkTreeView::cursor-changed:
1070 * @tree_view: the object on which the signal is emitted
1072 * The position of the cursor (focused cell) has changed.
1074 tree_view_signals[CURSOR_CHANGED] =
1075 g_signal_new (I_("cursor-changed"),
1076 G_TYPE_FROM_CLASS (o_class),
1078 G_STRUCT_OFFSET (GtkTreeViewClass, cursor_changed),
1080 _gtk_marshal_VOID__VOID,
1083 tree_view_signals[MOVE_CURSOR] =
1084 g_signal_new (I_("move-cursor"),
1085 G_TYPE_FROM_CLASS (o_class),
1086 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1087 G_STRUCT_OFFSET (GtkTreeViewClass, move_cursor),
1089 _gtk_marshal_BOOLEAN__ENUM_INT,
1091 GTK_TYPE_MOVEMENT_STEP,
1094 tree_view_signals[SELECT_ALL] =
1095 g_signal_new (I_("select-all"),
1096 G_TYPE_FROM_CLASS (o_class),
1097 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1098 G_STRUCT_OFFSET (GtkTreeViewClass, select_all),
1100 _gtk_marshal_BOOLEAN__VOID,
1103 tree_view_signals[UNSELECT_ALL] =
1104 g_signal_new (I_("unselect-all"),
1105 G_TYPE_FROM_CLASS (o_class),
1106 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1107 G_STRUCT_OFFSET (GtkTreeViewClass, unselect_all),
1109 _gtk_marshal_BOOLEAN__VOID,
1112 tree_view_signals[SELECT_CURSOR_ROW] =
1113 g_signal_new (I_("select-cursor-row"),
1114 G_TYPE_FROM_CLASS (o_class),
1115 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1116 G_STRUCT_OFFSET (GtkTreeViewClass, select_cursor_row),
1118 _gtk_marshal_BOOLEAN__BOOLEAN,
1122 tree_view_signals[TOGGLE_CURSOR_ROW] =
1123 g_signal_new (I_("toggle-cursor-row"),
1124 G_TYPE_FROM_CLASS (o_class),
1125 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1126 G_STRUCT_OFFSET (GtkTreeViewClass, toggle_cursor_row),
1128 _gtk_marshal_BOOLEAN__VOID,
1131 tree_view_signals[EXPAND_COLLAPSE_CURSOR_ROW] =
1132 g_signal_new (I_("expand-collapse-cursor-row"),
1133 G_TYPE_FROM_CLASS (o_class),
1134 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1135 G_STRUCT_OFFSET (GtkTreeViewClass, expand_collapse_cursor_row),
1137 _gtk_marshal_BOOLEAN__BOOLEAN_BOOLEAN_BOOLEAN,
1143 tree_view_signals[SELECT_CURSOR_PARENT] =
1144 g_signal_new (I_("select-cursor-parent"),
1145 G_TYPE_FROM_CLASS (o_class),
1146 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1147 G_STRUCT_OFFSET (GtkTreeViewClass, select_cursor_parent),
1149 _gtk_marshal_BOOLEAN__VOID,
1152 tree_view_signals[START_INTERACTIVE_SEARCH] =
1153 g_signal_new (I_("start-interactive-search"),
1154 G_TYPE_FROM_CLASS (o_class),
1155 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
1156 G_STRUCT_OFFSET (GtkTreeViewClass, start_interactive_search),
1158 _gtk_marshal_BOOLEAN__VOID,
1162 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_Up, 0, TRUE,
1163 GTK_MOVEMENT_DISPLAY_LINES, -1);
1164 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_KP_Up, 0, TRUE,
1165 GTK_MOVEMENT_DISPLAY_LINES, -1);
1167 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_Down, 0, TRUE,
1168 GTK_MOVEMENT_DISPLAY_LINES, 1);
1169 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_KP_Down, 0, TRUE,
1170 GTK_MOVEMENT_DISPLAY_LINES, 1);
1172 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_p, GDK_CONTROL_MASK, FALSE,
1173 GTK_MOVEMENT_DISPLAY_LINES, -1);
1175 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_n, GDK_CONTROL_MASK, FALSE,
1176 GTK_MOVEMENT_DISPLAY_LINES, 1);
1178 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_Home, 0, TRUE,
1179 GTK_MOVEMENT_BUFFER_ENDS, -1);
1180 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_KP_Home, 0, TRUE,
1181 GTK_MOVEMENT_BUFFER_ENDS, -1);
1183 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_End, 0, TRUE,
1184 GTK_MOVEMENT_BUFFER_ENDS, 1);
1185 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_KP_End, 0, TRUE,
1186 GTK_MOVEMENT_BUFFER_ENDS, 1);
1188 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_Page_Up, 0, TRUE,
1189 GTK_MOVEMENT_PAGES, -1);
1190 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_KP_Page_Up, 0, TRUE,
1191 GTK_MOVEMENT_PAGES, -1);
1193 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_Page_Down, 0, TRUE,
1194 GTK_MOVEMENT_PAGES, 1);
1195 gtk_tree_view_add_move_binding (binding_set, GDK_KEY_KP_Page_Down, 0, TRUE,
1196 GTK_MOVEMENT_PAGES, 1);
1199 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Right, 0, "move-cursor", 2,
1200 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1203 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Left, 0, "move-cursor", 2,
1204 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1207 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Right, 0, "move-cursor", 2,
1208 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1211 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Left, 0, "move-cursor", 2,
1212 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1215 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Right, GDK_CONTROL_MASK,
1217 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1220 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Left, GDK_CONTROL_MASK,
1222 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1225 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Right, GDK_CONTROL_MASK,
1227 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1230 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Left, GDK_CONTROL_MASK,
1232 G_TYPE_ENUM, GTK_MOVEMENT_VISUAL_POSITIONS,
1235 gtk_binding_entry_add_signal (binding_set, GDK_KEY_space, GDK_CONTROL_MASK, "toggle-cursor-row", 0);
1236 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Space, GDK_CONTROL_MASK, "toggle-cursor-row", 0);
1238 gtk_binding_entry_add_signal (binding_set, GDK_KEY_a, GDK_CONTROL_MASK, "select-all", 0);
1239 gtk_binding_entry_add_signal (binding_set, GDK_KEY_slash, GDK_CONTROL_MASK, "select-all", 0);
1241 gtk_binding_entry_add_signal (binding_set, GDK_KEY_A, GDK_CONTROL_MASK | GDK_SHIFT_MASK, "unselect-all", 0);
1242 gtk_binding_entry_add_signal (binding_set, GDK_KEY_backslash, GDK_CONTROL_MASK, "unselect-all", 0);
1244 gtk_binding_entry_add_signal (binding_set, GDK_KEY_space, GDK_SHIFT_MASK, "select-cursor-row", 1,
1245 G_TYPE_BOOLEAN, TRUE);
1246 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Space, GDK_SHIFT_MASK, "select-cursor-row", 1,
1247 G_TYPE_BOOLEAN, TRUE);
1249 gtk_binding_entry_add_signal (binding_set, GDK_KEY_space, 0, "select-cursor-row", 1,
1250 G_TYPE_BOOLEAN, TRUE);
1251 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Space, 0, "select-cursor-row", 1,
1252 G_TYPE_BOOLEAN, TRUE);
1253 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Return, 0, "select-cursor-row", 1,
1254 G_TYPE_BOOLEAN, TRUE);
1255 gtk_binding_entry_add_signal (binding_set, GDK_KEY_ISO_Enter, 0, "select-cursor-row", 1,
1256 G_TYPE_BOOLEAN, TRUE);
1257 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Enter, 0, "select-cursor-row", 1,
1258 G_TYPE_BOOLEAN, TRUE);
1260 /* expand and collapse rows */
1261 gtk_binding_entry_add_signal (binding_set, GDK_KEY_plus, 0, "expand-collapse-cursor-row", 3,
1262 G_TYPE_BOOLEAN, TRUE,
1263 G_TYPE_BOOLEAN, TRUE,
1264 G_TYPE_BOOLEAN, FALSE);
1266 gtk_binding_entry_add_signal (binding_set, GDK_KEY_asterisk, 0,
1267 "expand-collapse-cursor-row", 3,
1268 G_TYPE_BOOLEAN, TRUE,
1269 G_TYPE_BOOLEAN, TRUE,
1270 G_TYPE_BOOLEAN, TRUE);
1271 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Multiply, 0,
1272 "expand-collapse-cursor-row", 3,
1273 G_TYPE_BOOLEAN, TRUE,
1274 G_TYPE_BOOLEAN, TRUE,
1275 G_TYPE_BOOLEAN, TRUE);
1277 gtk_binding_entry_add_signal (binding_set, GDK_KEY_slash, 0,
1278 "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_KEY_KP_Divide, 0,
1283 "expand-collapse-cursor-row", 3,
1284 G_TYPE_BOOLEAN, TRUE,
1285 G_TYPE_BOOLEAN, FALSE,
1286 G_TYPE_BOOLEAN, FALSE);
1288 /* Not doable on US keyboards */
1289 gtk_binding_entry_add_signal (binding_set, GDK_KEY_plus, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1290 G_TYPE_BOOLEAN, TRUE,
1291 G_TYPE_BOOLEAN, TRUE,
1292 G_TYPE_BOOLEAN, TRUE);
1293 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Add, 0, "expand-collapse-cursor-row", 3,
1294 G_TYPE_BOOLEAN, TRUE,
1295 G_TYPE_BOOLEAN, TRUE,
1296 G_TYPE_BOOLEAN, FALSE);
1297 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Add, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1298 G_TYPE_BOOLEAN, TRUE,
1299 G_TYPE_BOOLEAN, TRUE,
1300 G_TYPE_BOOLEAN, TRUE);
1301 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Add, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1302 G_TYPE_BOOLEAN, TRUE,
1303 G_TYPE_BOOLEAN, TRUE,
1304 G_TYPE_BOOLEAN, TRUE);
1305 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Right, GDK_SHIFT_MASK,
1306 "expand-collapse-cursor-row", 3,
1307 G_TYPE_BOOLEAN, FALSE,
1308 G_TYPE_BOOLEAN, TRUE,
1309 G_TYPE_BOOLEAN, TRUE);
1310 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Right, GDK_SHIFT_MASK,
1311 "expand-collapse-cursor-row", 3,
1312 G_TYPE_BOOLEAN, FALSE,
1313 G_TYPE_BOOLEAN, TRUE,
1314 G_TYPE_BOOLEAN, TRUE);
1315 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Right,
1316 GDK_CONTROL_MASK | GDK_SHIFT_MASK,
1317 "expand-collapse-cursor-row", 3,
1318 G_TYPE_BOOLEAN, FALSE,
1319 G_TYPE_BOOLEAN, TRUE,
1320 G_TYPE_BOOLEAN, TRUE);
1321 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Right,
1322 GDK_CONTROL_MASK | GDK_SHIFT_MASK,
1323 "expand-collapse-cursor-row", 3,
1324 G_TYPE_BOOLEAN, FALSE,
1325 G_TYPE_BOOLEAN, TRUE,
1326 G_TYPE_BOOLEAN, TRUE);
1328 gtk_binding_entry_add_signal (binding_set, GDK_KEY_minus, 0, "expand-collapse-cursor-row", 3,
1329 G_TYPE_BOOLEAN, TRUE,
1330 G_TYPE_BOOLEAN, FALSE,
1331 G_TYPE_BOOLEAN, FALSE);
1332 gtk_binding_entry_add_signal (binding_set, GDK_KEY_minus, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1333 G_TYPE_BOOLEAN, TRUE,
1334 G_TYPE_BOOLEAN, FALSE,
1335 G_TYPE_BOOLEAN, TRUE);
1336 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Subtract, 0, "expand-collapse-cursor-row", 3,
1337 G_TYPE_BOOLEAN, TRUE,
1338 G_TYPE_BOOLEAN, FALSE,
1339 G_TYPE_BOOLEAN, FALSE);
1340 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Subtract, GDK_SHIFT_MASK, "expand-collapse-cursor-row", 3,
1341 G_TYPE_BOOLEAN, TRUE,
1342 G_TYPE_BOOLEAN, FALSE,
1343 G_TYPE_BOOLEAN, TRUE);
1344 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Left, GDK_SHIFT_MASK,
1345 "expand-collapse-cursor-row", 3,
1346 G_TYPE_BOOLEAN, FALSE,
1347 G_TYPE_BOOLEAN, FALSE,
1348 G_TYPE_BOOLEAN, TRUE);
1349 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Left, GDK_SHIFT_MASK,
1350 "expand-collapse-cursor-row", 3,
1351 G_TYPE_BOOLEAN, FALSE,
1352 G_TYPE_BOOLEAN, FALSE,
1353 G_TYPE_BOOLEAN, TRUE);
1354 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Left,
1355 GDK_CONTROL_MASK | GDK_SHIFT_MASK,
1356 "expand-collapse-cursor-row", 3,
1357 G_TYPE_BOOLEAN, FALSE,
1358 G_TYPE_BOOLEAN, FALSE,
1359 G_TYPE_BOOLEAN, TRUE);
1360 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Left,
1361 GDK_CONTROL_MASK | GDK_SHIFT_MASK,
1362 "expand-collapse-cursor-row", 3,
1363 G_TYPE_BOOLEAN, FALSE,
1364 G_TYPE_BOOLEAN, FALSE,
1365 G_TYPE_BOOLEAN, TRUE);
1367 gtk_binding_entry_add_signal (binding_set, GDK_KEY_BackSpace, 0, "select-cursor-parent", 0);
1368 gtk_binding_entry_add_signal (binding_set, GDK_KEY_BackSpace, GDK_CONTROL_MASK, "select-cursor-parent", 0);
1370 gtk_binding_entry_add_signal (binding_set, GDK_KEY_f, GDK_CONTROL_MASK, "start-interactive-search", 0);
1372 gtk_binding_entry_add_signal (binding_set, GDK_KEY_F, GDK_CONTROL_MASK, "start-interactive-search", 0);
1374 g_type_class_add_private (o_class, sizeof (GtkTreeViewPrivate));
1378 gtk_tree_view_init (GtkTreeView *tree_view)
1380 tree_view->priv = G_TYPE_INSTANCE_GET_PRIVATE (tree_view, GTK_TYPE_TREE_VIEW, GtkTreeViewPrivate);
1382 gtk_widget_set_can_focus (GTK_WIDGET (tree_view), TRUE);
1383 gtk_widget_set_redraw_on_allocate (GTK_WIDGET (tree_view), FALSE);
1385 tree_view->priv->flags = GTK_TREE_VIEW_SHOW_EXPANDERS
1386 | GTK_TREE_VIEW_DRAW_KEYFOCUS
1387 | GTK_TREE_VIEW_HEADERS_VISIBLE;
1389 /* We need some padding */
1390 tree_view->priv->dy = 0;
1391 tree_view->priv->cursor_offset = 0;
1392 tree_view->priv->n_columns = 0;
1393 tree_view->priv->header_height = 1;
1394 tree_view->priv->x_drag = 0;
1395 tree_view->priv->drag_pos = -1;
1396 tree_view->priv->header_has_focus = FALSE;
1397 tree_view->priv->pressed_button = -1;
1398 tree_view->priv->press_start_x = -1;
1399 tree_view->priv->press_start_y = -1;
1400 tree_view->priv->reorderable = FALSE;
1401 tree_view->priv->presize_handler_timer = 0;
1402 tree_view->priv->scroll_sync_timer = 0;
1403 tree_view->priv->fixed_height = -1;
1404 tree_view->priv->fixed_height_mode = FALSE;
1405 tree_view->priv->fixed_height_check = 0;
1406 tree_view->priv->selection = _gtk_tree_selection_new_with_tree_view (tree_view);
1407 tree_view->priv->enable_search = TRUE;
1408 tree_view->priv->search_column = -1;
1409 tree_view->priv->search_position_func = gtk_tree_view_search_position_func;
1410 tree_view->priv->search_equal_func = gtk_tree_view_search_equal_func;
1411 tree_view->priv->search_custom_entry_set = FALSE;
1412 tree_view->priv->typeselect_flush_timeout = 0;
1413 tree_view->priv->init_hadjust_value = TRUE;
1414 tree_view->priv->width = 0;
1416 tree_view->priv->hover_selection = FALSE;
1417 tree_view->priv->hover_expand = FALSE;
1419 tree_view->priv->level_indentation = 0;
1421 tree_view->priv->rubber_banding_enable = FALSE;
1423 tree_view->priv->grid_lines = GTK_TREE_VIEW_GRID_LINES_NONE;
1424 tree_view->priv->tree_lines_enabled = FALSE;
1426 tree_view->priv->tooltip_column = -1;
1428 tree_view->priv->post_validation_flag = FALSE;
1430 tree_view->priv->last_button_x = -1;
1431 tree_view->priv->last_button_y = -1;
1433 tree_view->priv->event_last_x = -10000;
1434 tree_view->priv->event_last_y = -10000;
1436 gtk_tree_view_set_vadjustment (tree_view, NULL);
1437 gtk_tree_view_set_hadjustment (tree_view, NULL);
1446 gtk_tree_view_set_property (GObject *object,
1448 const GValue *value,
1451 GtkTreeView *tree_view;
1453 tree_view = GTK_TREE_VIEW (object);
1458 gtk_tree_view_set_model (tree_view, g_value_get_object (value));
1460 case PROP_HADJUSTMENT:
1461 gtk_tree_view_set_hadjustment (tree_view, g_value_get_object (value));
1463 case PROP_VADJUSTMENT:
1464 gtk_tree_view_set_vadjustment (tree_view, g_value_get_object (value));
1466 case PROP_HSCROLL_POLICY:
1467 tree_view->priv->hscroll_policy = g_value_get_enum (value);
1468 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
1470 case PROP_VSCROLL_POLICY:
1471 tree_view->priv->vscroll_policy = g_value_get_enum (value);
1472 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
1474 case PROP_HEADERS_VISIBLE:
1475 gtk_tree_view_set_headers_visible (tree_view, g_value_get_boolean (value));
1477 case PROP_HEADERS_CLICKABLE:
1478 gtk_tree_view_set_headers_clickable (tree_view, g_value_get_boolean (value));
1480 case PROP_EXPANDER_COLUMN:
1481 gtk_tree_view_set_expander_column (tree_view, g_value_get_object (value));
1483 case PROP_REORDERABLE:
1484 gtk_tree_view_set_reorderable (tree_view, g_value_get_boolean (value));
1486 case PROP_RULES_HINT:
1487 gtk_tree_view_set_rules_hint (tree_view, g_value_get_boolean (value));
1489 case PROP_ENABLE_SEARCH:
1490 gtk_tree_view_set_enable_search (tree_view, g_value_get_boolean (value));
1492 case PROP_SEARCH_COLUMN:
1493 gtk_tree_view_set_search_column (tree_view, g_value_get_int (value));
1495 case PROP_FIXED_HEIGHT_MODE:
1496 gtk_tree_view_set_fixed_height_mode (tree_view, g_value_get_boolean (value));
1498 case PROP_HOVER_SELECTION:
1499 tree_view->priv->hover_selection = g_value_get_boolean (value);
1501 case PROP_HOVER_EXPAND:
1502 tree_view->priv->hover_expand = g_value_get_boolean (value);
1504 case PROP_SHOW_EXPANDERS:
1505 gtk_tree_view_set_show_expanders (tree_view, g_value_get_boolean (value));
1507 case PROP_LEVEL_INDENTATION:
1508 tree_view->priv->level_indentation = g_value_get_int (value);
1510 case PROP_RUBBER_BANDING:
1511 tree_view->priv->rubber_banding_enable = g_value_get_boolean (value);
1513 case PROP_ENABLE_GRID_LINES:
1514 gtk_tree_view_set_grid_lines (tree_view, g_value_get_enum (value));
1516 case PROP_ENABLE_TREE_LINES:
1517 gtk_tree_view_set_enable_tree_lines (tree_view, g_value_get_boolean (value));
1519 case PROP_TOOLTIP_COLUMN:
1520 gtk_tree_view_set_tooltip_column (tree_view, g_value_get_int (value));
1523 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1529 gtk_tree_view_get_property (GObject *object,
1534 GtkTreeView *tree_view;
1536 tree_view = GTK_TREE_VIEW (object);
1541 g_value_set_object (value, tree_view->priv->model);
1543 case PROP_HADJUSTMENT:
1544 g_value_set_object (value, tree_view->priv->hadjustment);
1546 case PROP_VADJUSTMENT:
1547 g_value_set_object (value, tree_view->priv->vadjustment);
1549 case PROP_HSCROLL_POLICY:
1550 g_value_set_enum (value, tree_view->priv->hscroll_policy);
1552 case PROP_VSCROLL_POLICY:
1553 g_value_set_enum (value, tree_view->priv->vscroll_policy);
1555 case PROP_HEADERS_VISIBLE:
1556 g_value_set_boolean (value, gtk_tree_view_get_headers_visible (tree_view));
1558 case PROP_HEADERS_CLICKABLE:
1559 g_value_set_boolean (value, gtk_tree_view_get_headers_clickable (tree_view));
1561 case PROP_EXPANDER_COLUMN:
1562 g_value_set_object (value, tree_view->priv->expander_column);
1564 case PROP_REORDERABLE:
1565 g_value_set_boolean (value, tree_view->priv->reorderable);
1567 case PROP_RULES_HINT:
1568 g_value_set_boolean (value, tree_view->priv->has_rules);
1570 case PROP_ENABLE_SEARCH:
1571 g_value_set_boolean (value, tree_view->priv->enable_search);
1573 case PROP_SEARCH_COLUMN:
1574 g_value_set_int (value, tree_view->priv->search_column);
1576 case PROP_FIXED_HEIGHT_MODE:
1577 g_value_set_boolean (value, tree_view->priv->fixed_height_mode);
1579 case PROP_HOVER_SELECTION:
1580 g_value_set_boolean (value, tree_view->priv->hover_selection);
1582 case PROP_HOVER_EXPAND:
1583 g_value_set_boolean (value, tree_view->priv->hover_expand);
1585 case PROP_SHOW_EXPANDERS:
1586 g_value_set_boolean (value, GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS));
1588 case PROP_LEVEL_INDENTATION:
1589 g_value_set_int (value, tree_view->priv->level_indentation);
1591 case PROP_RUBBER_BANDING:
1592 g_value_set_boolean (value, tree_view->priv->rubber_banding_enable);
1594 case PROP_ENABLE_GRID_LINES:
1595 g_value_set_enum (value, tree_view->priv->grid_lines);
1597 case PROP_ENABLE_TREE_LINES:
1598 g_value_set_boolean (value, tree_view->priv->tree_lines_enabled);
1600 case PROP_TOOLTIP_COLUMN:
1601 g_value_set_int (value, tree_view->priv->tooltip_column);
1604 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1610 gtk_tree_view_finalize (GObject *object)
1612 G_OBJECT_CLASS (gtk_tree_view_parent_class)->finalize (object);
1616 static GtkBuildableIface *parent_buildable_iface;
1619 gtk_tree_view_buildable_init (GtkBuildableIface *iface)
1621 parent_buildable_iface = g_type_interface_peek_parent (iface);
1622 iface->add_child = gtk_tree_view_buildable_add_child;
1623 iface->get_internal_child = gtk_tree_view_buildable_get_internal_child;
1627 gtk_tree_view_buildable_add_child (GtkBuildable *tree_view,
1628 GtkBuilder *builder,
1632 gtk_tree_view_append_column (GTK_TREE_VIEW (tree_view), GTK_TREE_VIEW_COLUMN (child));
1636 gtk_tree_view_buildable_get_internal_child (GtkBuildable *buildable,
1637 GtkBuilder *builder,
1638 const gchar *childname)
1640 if (strcmp (childname, "selection") == 0)
1641 return G_OBJECT (GTK_TREE_VIEW (buildable)->priv->selection);
1643 return parent_buildable_iface->get_internal_child (buildable,
1648 /* GtkWidget Methods
1652 gtk_tree_view_free_rbtree (GtkTreeView *tree_view)
1654 _gtk_rbtree_free (tree_view->priv->tree);
1656 tree_view->priv->tree = NULL;
1657 tree_view->priv->button_pressed_node = NULL;
1658 tree_view->priv->button_pressed_tree = NULL;
1659 tree_view->priv->prelight_tree = NULL;
1660 tree_view->priv->prelight_node = NULL;
1661 tree_view->priv->expanded_collapsed_node = NULL;
1662 tree_view->priv->expanded_collapsed_tree = NULL;
1666 gtk_tree_view_destroy (GtkWidget *widget)
1668 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
1671 gtk_tree_view_stop_editing (tree_view, TRUE);
1673 if (tree_view->priv->columns != NULL)
1675 list = tree_view->priv->columns;
1678 GtkTreeViewColumn *column;
1679 column = GTK_TREE_VIEW_COLUMN (list->data);
1681 gtk_tree_view_remove_column (tree_view, column);
1683 tree_view->priv->columns = NULL;
1686 if (tree_view->priv->tree != NULL)
1688 gtk_tree_view_unref_and_check_selection_tree (tree_view, tree_view->priv->tree);
1690 gtk_tree_view_free_rbtree (tree_view);
1693 if (tree_view->priv->selection != NULL)
1695 _gtk_tree_selection_set_tree_view (tree_view->priv->selection, NULL);
1696 g_object_unref (tree_view->priv->selection);
1697 tree_view->priv->selection = NULL;
1700 if (tree_view->priv->scroll_to_path != NULL)
1702 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
1703 tree_view->priv->scroll_to_path = NULL;
1706 if (tree_view->priv->drag_dest_row != NULL)
1708 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
1709 tree_view->priv->drag_dest_row = NULL;
1712 if (tree_view->priv->top_row != NULL)
1714 gtk_tree_row_reference_free (tree_view->priv->top_row);
1715 tree_view->priv->top_row = NULL;
1718 if (tree_view->priv->column_drop_func_data &&
1719 tree_view->priv->column_drop_func_data_destroy)
1721 tree_view->priv->column_drop_func_data_destroy (tree_view->priv->column_drop_func_data);
1722 tree_view->priv->column_drop_func_data = NULL;
1725 if (tree_view->priv->destroy_count_destroy &&
1726 tree_view->priv->destroy_count_data)
1728 tree_view->priv->destroy_count_destroy (tree_view->priv->destroy_count_data);
1729 tree_view->priv->destroy_count_data = NULL;
1732 gtk_tree_row_reference_free (tree_view->priv->cursor);
1733 tree_view->priv->cursor = NULL;
1735 gtk_tree_row_reference_free (tree_view->priv->anchor);
1736 tree_view->priv->anchor = NULL;
1738 /* destroy interactive search dialog */
1739 if (tree_view->priv->search_window)
1741 gtk_widget_destroy (tree_view->priv->search_window);
1742 tree_view->priv->search_window = NULL;
1743 tree_view->priv->search_entry = NULL;
1744 if (tree_view->priv->typeselect_flush_timeout)
1746 g_source_remove (tree_view->priv->typeselect_flush_timeout);
1747 tree_view->priv->typeselect_flush_timeout = 0;
1751 if (tree_view->priv->search_destroy && tree_view->priv->search_user_data)
1753 tree_view->priv->search_destroy (tree_view->priv->search_user_data);
1754 tree_view->priv->search_user_data = NULL;
1757 if (tree_view->priv->search_position_destroy && tree_view->priv->search_position_user_data)
1759 tree_view->priv->search_position_destroy (tree_view->priv->search_position_user_data);
1760 tree_view->priv->search_position_user_data = NULL;
1763 if (tree_view->priv->row_separator_destroy && tree_view->priv->row_separator_data)
1765 tree_view->priv->row_separator_destroy (tree_view->priv->row_separator_data);
1766 tree_view->priv->row_separator_data = NULL;
1769 gtk_tree_view_set_model (tree_view, NULL);
1771 if (tree_view->priv->hadjustment)
1773 g_object_unref (tree_view->priv->hadjustment);
1774 tree_view->priv->hadjustment = NULL;
1776 if (tree_view->priv->vadjustment)
1778 g_object_unref (tree_view->priv->vadjustment);
1779 tree_view->priv->vadjustment = NULL;
1782 GTK_WIDGET_CLASS (gtk_tree_view_parent_class)->destroy (widget);
1785 /* GtkWidget::map helper */
1787 gtk_tree_view_map_buttons (GtkTreeView *tree_view)
1791 g_return_if_fail (gtk_widget_get_mapped (GTK_WIDGET (tree_view)));
1793 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
1795 GtkTreeViewColumn *column;
1797 for (list = tree_view->priv->columns; list; list = list->next)
1799 column = list->data;
1800 if (gtk_widget_get_visible (column->button) &&
1801 !gtk_widget_get_mapped (column->button))
1802 gtk_widget_map (column->button);
1804 for (list = tree_view->priv->columns; list; list = list->next)
1806 column = list->data;
1807 if (gtk_tree_view_column_get_visible (column) == FALSE)
1809 if (gtk_tree_view_column_get_resizable (column))
1811 gdk_window_raise (column->window);
1812 gdk_window_show (column->window);
1815 gdk_window_hide (column->window);
1817 gdk_window_show (tree_view->priv->header_window);
1822 gtk_tree_view_map (GtkWidget *widget)
1824 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
1827 gtk_widget_set_mapped (widget, TRUE);
1829 tmp_list = tree_view->priv->children;
1832 GtkTreeViewChild *child = tmp_list->data;
1833 tmp_list = tmp_list->next;
1835 if (gtk_widget_get_visible (child->widget))
1837 if (!gtk_widget_get_mapped (child->widget))
1838 gtk_widget_map (child->widget);
1841 gdk_window_show (tree_view->priv->bin_window);
1843 gtk_tree_view_map_buttons (tree_view);
1845 gdk_window_show (gtk_widget_get_window (widget));
1849 gtk_tree_view_realize (GtkWidget *widget)
1851 GtkAllocation allocation;
1853 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
1855 GdkWindowAttr attributes;
1857 gint attributes_mask;
1859 gtk_widget_set_realized (widget, TRUE);
1861 gtk_widget_get_allocation (widget, &allocation);
1863 /* Make the main, clipping window */
1864 attributes.window_type = GDK_WINDOW_CHILD;
1865 attributes.x = allocation.x;
1866 attributes.y = allocation.y;
1867 attributes.width = allocation.width;
1868 attributes.height = allocation.height;
1869 attributes.wclass = GDK_INPUT_OUTPUT;
1870 attributes.visual = gtk_widget_get_visual (widget);
1871 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK;
1873 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
1875 window = gdk_window_new (gtk_widget_get_parent_window (widget),
1876 &attributes, attributes_mask);
1877 gtk_widget_set_window (widget, window);
1878 gdk_window_set_user_data (window, widget);
1880 gtk_widget_get_allocation (widget, &allocation);
1882 /* Make the window for the tree */
1884 attributes.y = TREE_VIEW_HEADER_HEIGHT (tree_view);
1885 attributes.width = MAX (tree_view->priv->width, allocation.width);
1886 attributes.height = allocation.height;
1887 attributes.event_mask = (GDK_EXPOSURE_MASK |
1889 GDK_POINTER_MOTION_MASK |
1890 GDK_ENTER_NOTIFY_MASK |
1891 GDK_LEAVE_NOTIFY_MASK |
1892 GDK_BUTTON_PRESS_MASK |
1893 GDK_BUTTON_RELEASE_MASK |
1894 gtk_widget_get_events (widget));
1896 tree_view->priv->bin_window = gdk_window_new (window,
1897 &attributes, attributes_mask);
1898 gdk_window_set_user_data (tree_view->priv->bin_window, widget);
1900 gtk_widget_get_allocation (widget, &allocation);
1902 /* Make the column header window */
1905 attributes.width = MAX (tree_view->priv->width, allocation.width);
1906 attributes.height = tree_view->priv->header_height;
1907 attributes.event_mask = (GDK_EXPOSURE_MASK |
1909 GDK_ENTER_NOTIFY_MASK |
1910 GDK_LEAVE_NOTIFY_MASK |
1911 GDK_BUTTON_PRESS_MASK |
1912 GDK_BUTTON_RELEASE_MASK |
1913 GDK_KEY_PRESS_MASK |
1914 GDK_KEY_RELEASE_MASK |
1915 gtk_widget_get_events (widget));
1917 tree_view->priv->header_window = gdk_window_new (window,
1918 &attributes, attributes_mask);
1919 gdk_window_set_user_data (tree_view->priv->header_window, widget);
1921 /* Add them all up. */
1922 gtk_widget_style_attach (widget);
1923 style = gtk_widget_get_style (widget);
1924 gdk_window_set_background (tree_view->priv->bin_window,
1925 &style->base[gtk_widget_get_state (widget)]);
1926 gtk_style_set_background (style, tree_view->priv->header_window, GTK_STATE_NORMAL);
1928 tmp_list = tree_view->priv->children;
1931 GtkTreeViewChild *child = tmp_list->data;
1932 tmp_list = tmp_list->next;
1934 gtk_widget_set_parent_window (child->widget, tree_view->priv->bin_window);
1937 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
1938 _gtk_tree_view_column_realize_button (GTK_TREE_VIEW_COLUMN (tmp_list->data));
1940 /* Need to call those here, since they create GCs */
1941 gtk_tree_view_set_grid_lines (tree_view, tree_view->priv->grid_lines);
1942 gtk_tree_view_set_enable_tree_lines (tree_view, tree_view->priv->tree_lines_enabled);
1944 install_presize_handler (tree_view);
1948 gtk_tree_view_unrealize (GtkWidget *widget)
1950 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
1951 GtkTreeViewPrivate *priv = tree_view->priv;
1954 if (priv->scroll_timeout != 0)
1956 g_source_remove (priv->scroll_timeout);
1957 priv->scroll_timeout = 0;
1960 if (priv->auto_expand_timeout != 0)
1962 g_source_remove (priv->auto_expand_timeout);
1963 priv->auto_expand_timeout = 0;
1966 if (priv->open_dest_timeout != 0)
1968 g_source_remove (priv->open_dest_timeout);
1969 priv->open_dest_timeout = 0;
1972 remove_expand_collapse_timeout (tree_view);
1974 if (priv->presize_handler_timer != 0)
1976 g_source_remove (priv->presize_handler_timer);
1977 priv->presize_handler_timer = 0;
1980 if (priv->validate_rows_timer != 0)
1982 g_source_remove (priv->validate_rows_timer);
1983 priv->validate_rows_timer = 0;
1986 if (priv->scroll_sync_timer != 0)
1988 g_source_remove (priv->scroll_sync_timer);
1989 priv->scroll_sync_timer = 0;
1992 if (priv->typeselect_flush_timeout)
1994 g_source_remove (priv->typeselect_flush_timeout);
1995 priv->typeselect_flush_timeout = 0;
1998 for (list = priv->columns; list; list = list->next)
1999 _gtk_tree_view_column_unrealize_button (GTK_TREE_VIEW_COLUMN (list->data));
2001 gdk_window_set_user_data (priv->bin_window, NULL);
2002 gdk_window_destroy (priv->bin_window);
2003 priv->bin_window = NULL;
2005 gdk_window_set_user_data (priv->header_window, NULL);
2006 gdk_window_destroy (priv->header_window);
2007 priv->header_window = NULL;
2009 if (priv->drag_window)
2011 gdk_window_set_user_data (priv->drag_window, NULL);
2012 gdk_window_destroy (priv->drag_window);
2013 priv->drag_window = NULL;
2016 if (priv->drag_highlight_window)
2018 gdk_window_set_user_data (priv->drag_highlight_window, NULL);
2019 gdk_window_destroy (priv->drag_highlight_window);
2020 priv->drag_highlight_window = NULL;
2023 GTK_WIDGET_CLASS (gtk_tree_view_parent_class)->unrealize (widget);
2026 /* GtkWidget::size_request helper */
2028 gtk_tree_view_size_request_columns (GtkTreeView *tree_view)
2032 tree_view->priv->header_height = 0;
2034 if (tree_view->priv->model)
2036 for (list = tree_view->priv->columns; list; list = list->next)
2038 GtkRequisition requisition;
2039 GtkTreeViewColumn *column = list->data;
2041 if (column->button == NULL)
2044 column = list->data;
2046 gtk_widget_get_preferred_size (column->button, &requisition, NULL);
2047 column->button_request = requisition.width;
2048 tree_view->priv->header_height = MAX (tree_view->priv->header_height, requisition.height);
2054 /* Called only by ::size_request */
2056 gtk_tree_view_update_size (GtkTreeView *tree_view)
2059 GtkTreeViewColumn *column;
2062 if (tree_view->priv->model == NULL)
2064 tree_view->priv->width = 0;
2065 tree_view->priv->prev_width = 0;
2066 tree_view->priv->height = 0;
2070 tree_view->priv->prev_width = tree_view->priv->width;
2071 tree_view->priv->width = 0;
2073 /* keep this in sync with size_allocate below */
2074 for (list = tree_view->priv->columns, i = 0; list; list = list->next, i++)
2076 gint max_width, min_width;
2077 gint real_requested_width = 0;
2079 column = list->data;
2080 if (!gtk_tree_view_column_get_visible (column))
2083 if (column->use_resized_width)
2085 real_requested_width = column->resized_width;
2087 else if (gtk_tree_view_column_get_sizing (column) == GTK_TREE_VIEW_COLUMN_FIXED)
2089 real_requested_width = gtk_tree_view_column_get_fixed_width (column);
2091 else if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
2093 real_requested_width = MAX (column->requested_width, column->button_request);
2097 real_requested_width = column->requested_width;
2100 min_width = gtk_tree_view_column_get_min_width (column);
2101 if (min_width != -1)
2102 real_requested_width = MAX (real_requested_width, min_width);
2104 max_width = gtk_tree_view_column_get_max_width (column);
2105 if (max_width != -1)
2106 real_requested_width = MIN (real_requested_width, max_width);
2108 tree_view->priv->width += real_requested_width;
2111 if (tree_view->priv->tree == NULL)
2112 tree_view->priv->height = 0;
2114 tree_view->priv->height = tree_view->priv->tree->root->offset;
2118 gtk_tree_view_size_request (GtkWidget *widget,
2119 GtkRequisition *requisition)
2121 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
2124 /* we validate some rows initially just to make sure we have some size.
2125 * In practice, with a lot of static lists, this should get a good width.
2127 do_validate_rows (tree_view, FALSE);
2128 gtk_tree_view_size_request_columns (tree_view);
2129 gtk_tree_view_update_size (GTK_TREE_VIEW (widget));
2131 requisition->width = tree_view->priv->width;
2132 requisition->height = tree_view->priv->height + TREE_VIEW_HEADER_HEIGHT (tree_view);
2134 tmp_list = tree_view->priv->children;
2138 gtk_tree_view_get_preferred_width (GtkWidget *widget,
2142 GtkRequisition requisition;
2144 gtk_tree_view_size_request (widget, &requisition);
2146 *minimum = *natural = requisition.width;
2150 gtk_tree_view_get_preferred_height (GtkWidget *widget,
2154 GtkRequisition requisition;
2156 gtk_tree_view_size_request (widget, &requisition);
2158 *minimum = *natural = requisition.height;
2162 gtk_tree_view_calculate_width_before_expander (GtkTreeView *tree_view)
2168 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
2169 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
2170 list->data != tree_view->priv->expander_column;
2171 list = (rtl ? list->prev : list->next))
2173 GtkTreeViewColumn *column = list->data;
2175 width += gtk_tree_view_column_get_width (column);
2182 invalidate_column (GtkTreeView *tree_view,
2183 GtkTreeViewColumn *column)
2185 gint column_offset = 0;
2187 GtkWidget *widget = GTK_WIDGET (tree_view);
2190 if (!gtk_widget_get_realized (widget))
2193 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
2194 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
2196 list = (rtl ? list->prev : list->next))
2198 GtkTreeViewColumn *tmpcolumn = list->data;
2199 if (tmpcolumn == column)
2201 GtkAllocation allocation;
2202 GdkRectangle invalid_rect;
2204 gtk_widget_get_allocation (widget, &allocation);
2205 invalid_rect.x = column_offset;
2207 invalid_rect.width = gtk_tree_view_column_get_width (column);
2208 invalid_rect.height = allocation.height;
2210 gdk_window_invalidate_rect (gtk_widget_get_window (widget), &invalid_rect, TRUE);
2214 column_offset += gtk_tree_view_column_get_width (tmpcolumn);
2219 invalidate_last_column (GtkTreeView *tree_view)
2224 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
2226 for (last_column = (rtl ? g_list_first (tree_view->priv->columns) : g_list_last (tree_view->priv->columns));
2228 last_column = (rtl ? last_column->next : last_column->prev))
2230 if (gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (last_column->data)))
2232 invalidate_column (tree_view, last_column->data);
2239 gtk_tree_view_get_real_requested_width_from_column (GtkTreeView *tree_view,
2240 GtkTreeViewColumn *column)
2242 gint max_width, min_width;
2243 gint real_requested_width;
2245 if (column->use_resized_width)
2247 real_requested_width = column->resized_width;
2249 else if (gtk_tree_view_column_get_sizing (column) == GTK_TREE_VIEW_COLUMN_FIXED)
2251 real_requested_width = gtk_tree_view_column_get_fixed_width (column);
2253 else if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
2255 real_requested_width = MAX (column->requested_width, column->button_request);
2259 real_requested_width = column->requested_width;
2260 if (real_requested_width < 0)
2261 real_requested_width = 0;
2264 min_width = gtk_tree_view_column_get_min_width (column);
2265 if (min_width != -1)
2266 real_requested_width = MAX (real_requested_width, min_width);
2268 max_width = gtk_tree_view_column_get_max_width (column);
2269 if (max_width != -1)
2270 real_requested_width = MIN (real_requested_width, max_width);
2272 return real_requested_width;
2275 /* GtkWidget::size_allocate helper */
2277 gtk_tree_view_size_allocate_columns (GtkWidget *widget,
2278 gboolean *width_changed)
2280 GtkTreeView *tree_view;
2281 GList *list, *first_column, *last_column;
2282 GtkTreeViewColumn *column;
2283 GtkAllocation allocation;
2284 GtkAllocation widget_allocation;
2286 gint extra, extra_per_column, extra_for_last;
2287 gint full_requested_width = 0;
2288 gint number_of_expand_columns = 0;
2289 gboolean column_changed = FALSE;
2291 gboolean update_expand;
2293 tree_view = GTK_TREE_VIEW (widget);
2295 for (last_column = g_list_last (tree_view->priv->columns);
2297 !(gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (last_column->data)));
2298 last_column = last_column->prev)
2300 if (last_column == NULL)
2303 for (first_column = g_list_first (tree_view->priv->columns);
2305 !(gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (first_column->data)));
2306 first_column = first_column->next)
2310 allocation.height = tree_view->priv->header_height;
2312 rtl = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);
2314 /* find out how many extra space and expandable columns we have */
2315 for (list = tree_view->priv->columns; list != last_column->next; list = list->next)
2317 column = (GtkTreeViewColumn *)list->data;
2319 if (!gtk_tree_view_column_get_visible (column))
2322 full_requested_width += gtk_tree_view_get_real_requested_width_from_column (tree_view, column);
2324 if (gtk_tree_view_column_get_expand (column))
2325 number_of_expand_columns++;
2328 /* Only update the expand value if the width of the widget has changed,
2329 * or the number of expand columns has changed, or if there are no expand
2330 * columns, or if we didn't have an size-allocation yet after the
2331 * last validated node.
2333 update_expand = (width_changed && *width_changed == TRUE)
2334 || number_of_expand_columns != tree_view->priv->last_number_of_expand_columns
2335 || number_of_expand_columns == 0
2336 || tree_view->priv->post_validation_flag == TRUE;
2338 tree_view->priv->post_validation_flag = FALSE;
2340 gtk_widget_get_allocation (widget, &widget_allocation);
2343 extra = tree_view->priv->last_extra_space;
2344 extra_for_last = MAX (widget_allocation.width - full_requested_width - extra, 0);
2348 extra = MAX (widget_allocation.width - full_requested_width, 0);
2351 tree_view->priv->last_extra_space = extra;
2354 if (number_of_expand_columns > 0)
2355 extra_per_column = extra/number_of_expand_columns;
2357 extra_per_column = 0;
2361 tree_view->priv->last_extra_space_per_column = extra_per_column;
2362 tree_view->priv->last_number_of_expand_columns = number_of_expand_columns;
2365 for (list = (rtl ? last_column : first_column);
2366 list != (rtl ? first_column->prev : last_column->next);
2367 list = (rtl ? list->prev : list->next))
2369 gint real_requested_width = 0;
2370 gint old_width, column_width;
2372 column = list->data;
2373 old_width = gtk_tree_view_column_get_width (column);
2375 if (!gtk_tree_view_column_get_visible (column))
2378 /* We need to handle the dragged button specially.
2380 if (column == tree_view->priv->drag_column)
2382 GtkAllocation drag_allocation;
2384 drag_allocation.x = 0;
2385 drag_allocation.y = 0;
2386 drag_allocation.width = gdk_window_get_width (tree_view->priv->drag_window);
2387 drag_allocation.height = gdk_window_get_height (tree_view->priv->drag_window);
2388 gtk_widget_size_allocate (tree_view->priv->drag_column->button,
2390 width += drag_allocation.width;
2394 real_requested_width = gtk_tree_view_get_real_requested_width_from_column (tree_view, column);
2396 allocation.x = width;
2397 column->width = real_requested_width;
2399 if (gtk_tree_view_column_get_expand (column))
2401 if (number_of_expand_columns == 1)
2403 /* We add the remander to the last column as
2405 column->width += extra;
2409 column->width += extra_per_column;
2410 extra -= extra_per_column;
2411 number_of_expand_columns --;
2414 else if (number_of_expand_columns == 0 &&
2415 list == last_column)
2417 column->width += extra;
2420 /* In addition to expand, the last column can get even more
2421 * extra space so all available space is filled up.
2423 if (extra_for_last > 0 && list == last_column)
2424 column->width += extra_for_last;
2426 g_object_notify (G_OBJECT (column), "width");
2428 column_width = gtk_tree_view_column_get_width (column);
2429 allocation.width = column_width;
2430 width += column_width;
2432 if (column_width > old_width)
2433 column_changed = TRUE;
2435 gtk_widget_size_allocate (column->button, &allocation);
2438 gdk_window_move_resize (column->window,
2439 allocation.x + (rtl ? 0 : allocation.width) - TREE_VIEW_DRAG_WIDTH/2,
2441 TREE_VIEW_DRAG_WIDTH, allocation.height);
2444 /* We change the width here. The user might have been resizing columns,
2445 * so the total width of the tree view changes.
2447 tree_view->priv->width = width;
2449 *width_changed = TRUE;
2452 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
2457 gtk_tree_view_size_allocate (GtkWidget *widget,
2458 GtkAllocation *allocation)
2460 GtkAllocation widget_allocation;
2461 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
2463 gboolean width_changed = FALSE;
2466 gtk_widget_get_allocation (widget, &widget_allocation);
2467 old_width = widget_allocation.width;
2468 if (allocation->width != widget_allocation.width)
2469 width_changed = TRUE;
2471 gtk_widget_set_allocation (widget, allocation);
2473 tmp_list = tree_view->priv->children;
2477 GtkAllocation allocation;
2479 GtkTreeViewChild *child = tmp_list->data;
2480 tmp_list = tmp_list->next;
2482 /* totally ignore our child's requisition */
2483 allocation.x = child->x;
2484 allocation.y = child->y;
2485 allocation.width = child->width;
2486 allocation.height = child->height;
2487 gtk_widget_size_allocate (child->widget, &allocation);
2490 /* We size-allocate the columns first because the width of the
2491 * tree view (used in updating the adjustments below) might change.
2493 gtk_tree_view_size_allocate_columns (widget, &width_changed);
2495 g_object_freeze_notify (G_OBJECT (tree_view->priv->hadjustment));
2496 gtk_adjustment_set_page_size (tree_view->priv->hadjustment,
2498 gtk_adjustment_set_page_increment (tree_view->priv->hadjustment,
2499 allocation->width * 0.9);
2500 gtk_adjustment_set_step_increment (tree_view->priv->hadjustment,
2501 allocation->width * 0.1);
2502 gtk_adjustment_set_lower (tree_view->priv->hadjustment, 0);
2503 gtk_adjustment_set_upper (tree_view->priv->hadjustment,
2504 MAX (tree_view->priv->hadjustment->page_size,
2505 tree_view->priv->width));
2506 g_object_thaw_notify (G_OBJECT (tree_view->priv->hadjustment));
2508 if (gtk_widget_get_direction(widget) == GTK_TEXT_DIR_RTL)
2510 if (allocation->width < tree_view->priv->width)
2512 if (tree_view->priv->init_hadjust_value)
2514 gtk_adjustment_set_value (tree_view->priv->hadjustment,
2515 MAX (tree_view->priv->width -
2516 allocation->width, 0));
2517 tree_view->priv->init_hadjust_value = FALSE;
2519 else if (allocation->width != old_width)
2521 gtk_adjustment_set_value (tree_view->priv->hadjustment,
2522 CLAMP (tree_view->priv->hadjustment->value - allocation->width + old_width,
2524 tree_view->priv->width - allocation->width));
2527 gtk_adjustment_set_value (tree_view->priv->hadjustment,
2528 CLAMP (tree_view->priv->width - (tree_view->priv->prev_width - tree_view->priv->hadjustment->value),
2530 tree_view->priv->width - allocation->width));
2534 gtk_adjustment_set_value (tree_view->priv->hadjustment, 0);
2535 tree_view->priv->init_hadjust_value = TRUE;
2539 if (tree_view->priv->hadjustment->value + allocation->width > tree_view->priv->width)
2540 gtk_adjustment_set_value (tree_view->priv->hadjustment,
2541 MAX (tree_view->priv->width -
2542 allocation->width, 0));
2544 g_object_freeze_notify (G_OBJECT (tree_view->priv->vadjustment));
2545 gtk_adjustment_set_page_size (tree_view->priv->vadjustment,
2546 allocation->height -
2547 TREE_VIEW_HEADER_HEIGHT (tree_view));
2548 gtk_adjustment_set_step_increment (tree_view->priv->vadjustment,
2549 tree_view->priv->vadjustment->page_size * 0.1);
2550 gtk_adjustment_set_page_increment (tree_view->priv->vadjustment,
2551 tree_view->priv->vadjustment->page_size * 0.9);
2552 gtk_adjustment_set_lower (tree_view->priv->vadjustment, 0);
2553 gtk_adjustment_set_upper (tree_view->priv->vadjustment,
2554 MAX (tree_view->priv->vadjustment->page_size,
2555 tree_view->priv->height));
2556 g_object_thaw_notify (G_OBJECT (tree_view->priv->vadjustment));
2558 /* now the adjustments and window sizes are in sync, we can sync toprow/dy again */
2559 if (tree_view->priv->height <= tree_view->priv->vadjustment->page_size)
2560 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment), 0);
2561 else if (tree_view->priv->vadjustment->value + tree_view->priv->vadjustment->page_size > tree_view->priv->height)
2562 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment),
2563 tree_view->priv->height - tree_view->priv->vadjustment->page_size);
2564 else if (gtk_tree_row_reference_valid (tree_view->priv->top_row))
2565 gtk_tree_view_top_row_to_dy (tree_view);
2567 gtk_tree_view_dy_to_top_row (tree_view);
2569 if (gtk_widget_get_realized (widget))
2571 gdk_window_move_resize (gtk_widget_get_window (widget),
2572 allocation->x, allocation->y,
2573 allocation->width, allocation->height);
2574 gdk_window_move_resize (tree_view->priv->header_window,
2575 - (gint) tree_view->priv->hadjustment->value,
2577 MAX (tree_view->priv->width, allocation->width),
2578 tree_view->priv->header_height);
2579 gdk_window_move_resize (tree_view->priv->bin_window,
2580 - (gint) tree_view->priv->hadjustment->value,
2581 TREE_VIEW_HEADER_HEIGHT (tree_view),
2582 MAX (tree_view->priv->width, allocation->width),
2583 allocation->height - TREE_VIEW_HEADER_HEIGHT (tree_view));
2586 if (tree_view->priv->tree == NULL)
2587 invalidate_empty_focus (tree_view);
2589 if (gtk_widget_get_realized (widget))
2591 gboolean has_expand_column = FALSE;
2592 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
2594 if (gtk_tree_view_column_get_expand (GTK_TREE_VIEW_COLUMN (tmp_list->data)))
2596 has_expand_column = TRUE;
2601 if (width_changed && tree_view->priv->expander_column)
2603 /* Might seem awkward, but is the best heuristic I could come up
2604 * with. Only if the width of the columns before the expander
2605 * changes, we will update the prelight status. It is this
2606 * width that makes the expander move vertically. Always updating
2607 * prelight status causes trouble with hover selections.
2609 gint width_before_expander;
2611 width_before_expander = gtk_tree_view_calculate_width_before_expander (tree_view);
2613 if (tree_view->priv->prev_width_before_expander
2614 != width_before_expander)
2615 update_prelight (tree_view,
2616 tree_view->priv->event_last_x,
2617 tree_view->priv->event_last_y);
2619 tree_view->priv->prev_width_before_expander = width_before_expander;
2622 /* This little hack only works if we have an LTR locale, and no column has the */
2625 if (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_LTR &&
2626 ! has_expand_column)
2627 invalidate_last_column (tree_view);
2629 gtk_widget_queue_draw (widget);
2634 /* Grabs the focus and unsets the GTK_TREE_VIEW_DRAW_KEYFOCUS flag */
2636 grab_focus_and_unset_draw_keyfocus (GtkTreeView *tree_view)
2638 GtkWidget *widget = GTK_WIDGET (tree_view);
2640 if (gtk_widget_get_can_focus (widget) && !gtk_widget_has_focus (widget))
2641 gtk_widget_grab_focus (widget);
2642 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
2645 static inline gboolean
2646 row_is_separator (GtkTreeView *tree_view,
2650 gboolean is_separator = FALSE;
2652 if (tree_view->priv->row_separator_func)
2654 GtkTreeIter tmpiter;
2659 gtk_tree_model_get_iter (tree_view->priv->model, &tmpiter, path);
2661 is_separator = tree_view->priv->row_separator_func (tree_view->priv->model,
2663 tree_view->priv->row_separator_data);
2666 return is_separator;
2670 gtk_tree_view_button_press (GtkWidget *widget,
2671 GdkEventButton *event)
2673 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
2675 GtkTreeViewColumn *column = NULL;
2677 GdkRectangle background_area;
2678 GdkRectangle cell_area;
2679 gint vertical_separator;
2680 gint horizontal_separator;
2681 gboolean path_is_selectable;
2684 rtl = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);
2685 gtk_tree_view_stop_editing (tree_view, FALSE);
2686 gtk_widget_style_get (widget,
2687 "vertical-separator", &vertical_separator,
2688 "horizontal-separator", &horizontal_separator,
2692 /* Because grab_focus can cause reentrancy, we delay grab_focus until after
2693 * we're done handling the button press.
2696 if (event->window == tree_view->priv->bin_window)
2706 gint pre_val, aft_val;
2707 GtkTreeViewColumn *column = NULL;
2708 GtkCellRenderer *focus_cell = NULL;
2709 gint column_handled_click = FALSE;
2710 gboolean row_double_click = FALSE;
2712 gboolean node_selected;
2715 if (tree_view->priv->tree == NULL)
2717 grab_focus_and_unset_draw_keyfocus (tree_view);
2721 /* are we in an arrow? */
2722 if (tree_view->priv->prelight_node &&
2723 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT) &&
2724 TREE_VIEW_DRAW_EXPANDERS (tree_view))
2726 if (event->button == 1)
2728 gtk_grab_add (widget);
2729 tree_view->priv->button_pressed_node = tree_view->priv->prelight_node;
2730 tree_view->priv->button_pressed_tree = tree_view->priv->prelight_tree;
2731 gtk_tree_view_queue_draw_arrow (GTK_TREE_VIEW (widget),
2732 tree_view->priv->prelight_tree,
2733 tree_view->priv->prelight_node);
2736 grab_focus_and_unset_draw_keyfocus (tree_view);
2740 /* find the node that was clicked */
2741 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
2744 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
2748 /* We clicked in dead space */
2749 grab_focus_and_unset_draw_keyfocus (tree_view);
2753 /* Get the path and the node */
2754 path = _gtk_tree_view_find_path (tree_view, tree, node);
2755 path_is_selectable = !row_is_separator (tree_view, NULL, path);
2757 if (!path_is_selectable)
2759 gtk_tree_path_free (path);
2760 grab_focus_and_unset_draw_keyfocus (tree_view);
2764 depth = gtk_tree_path_get_depth (path);
2765 background_area.y = y_offset + event->y;
2766 background_area.height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
2767 background_area.x = 0;
2770 /* Let the column have a chance at selecting it. */
2771 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
2772 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
2773 list; list = (rtl ? list->prev : list->next))
2775 GtkTreeViewColumn *candidate = list->data;
2777 if (!gtk_tree_view_column_get_visible (candidate))
2780 background_area.width = candidate->width;
2781 if ((background_area.x > (gint) event->x) ||
2782 (background_area.x + background_area.width <= (gint) event->x))
2784 background_area.x += background_area.width;
2788 /* we found the focus column */
2790 cell_area = background_area;
2791 cell_area.width -= horizontal_separator;
2792 cell_area.height -= vertical_separator;
2793 cell_area.x += horizontal_separator/2;
2794 cell_area.y += vertical_separator/2;
2795 if (gtk_tree_view_is_expander_column (tree_view, column))
2798 cell_area.x += (depth - 1) * tree_view->priv->level_indentation;
2799 cell_area.width -= (depth - 1) * tree_view->priv->level_indentation;
2801 if (TREE_VIEW_DRAW_EXPANDERS (tree_view))
2804 cell_area.x += depth * tree_view->priv->expander_size;
2805 cell_area.width -= depth * tree_view->priv->expander_size;
2813 gtk_tree_path_free (path);
2814 grab_focus_and_unset_draw_keyfocus (tree_view);
2818 tree_view->priv->focus_column = column;
2820 /* decide if we edit */
2821 if (event->type == GDK_BUTTON_PRESS && event->button == 1 &&
2822 !(event->state & gtk_accelerator_get_default_mod_mask ()))
2824 GtkTreePath *anchor;
2827 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
2828 gtk_tree_view_column_cell_set_cell_data (column,
2829 tree_view->priv->model,
2831 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
2832 node->children?TRUE:FALSE);
2834 if (tree_view->priv->anchor)
2835 anchor = gtk_tree_row_reference_get_path (tree_view->priv->anchor);
2839 if ((anchor && !gtk_tree_path_compare (anchor, path))
2840 || !_gtk_tree_view_column_has_editable_cell (column))
2842 GtkCellEditable *cell_editable = NULL;
2844 /* FIXME: get the right flags */
2847 path_string = gtk_tree_path_to_string (path);
2849 if (_gtk_tree_view_column_cell_event (column,
2856 if (cell_editable != NULL)
2862 _gtk_tree_view_column_get_neighbor_sizes (column, _gtk_tree_view_column_get_edited_cell (column), &left, &right);
2865 area.width -= right + left;
2867 gtk_tree_view_real_start_editing (tree_view,
2874 g_free (path_string);
2875 gtk_tree_path_free (path);
2876 gtk_tree_path_free (anchor);
2879 column_handled_click = TRUE;
2881 g_free (path_string);
2884 gtk_tree_path_free (anchor);
2888 node_selected = GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED);
2889 pre_val = tree_view->priv->vadjustment->value;
2891 /* we only handle selection modifications on the first button press
2893 if (event->type == GDK_BUTTON_PRESS)
2895 if ((event->state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
2896 tree_view->priv->ctrl_pressed = TRUE;
2897 if ((event->state & GDK_SHIFT_MASK) == GDK_SHIFT_MASK)
2898 tree_view->priv->shift_pressed = TRUE;
2900 focus_cell = _gtk_tree_view_column_get_cell_at_pos (column, event->x - background_area.x);
2902 gtk_tree_view_column_focus_cell (column, focus_cell);
2904 if (event->state & GDK_CONTROL_MASK)
2906 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
2907 gtk_tree_view_real_toggle_cursor_row (tree_view);
2909 else if (event->state & GDK_SHIFT_MASK)
2911 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
2912 gtk_tree_view_real_select_cursor_row (tree_view, FALSE);
2916 gtk_tree_view_real_set_cursor (tree_view, path, TRUE, TRUE);
2919 tree_view->priv->ctrl_pressed = FALSE;
2920 tree_view->priv->shift_pressed = FALSE;
2923 /* the treeview may have been scrolled because of _set_cursor,
2927 aft_val = tree_view->priv->vadjustment->value;
2928 dval = pre_val - aft_val;
2930 cell_area.y += dval;
2931 background_area.y += dval;
2933 /* Save press to possibly begin a drag
2935 if (!column_handled_click &&
2936 !tree_view->priv->in_grab &&
2937 tree_view->priv->pressed_button < 0)
2939 tree_view->priv->pressed_button = event->button;
2940 tree_view->priv->press_start_x = event->x;
2941 tree_view->priv->press_start_y = event->y;
2943 if (tree_view->priv->rubber_banding_enable
2945 && tree_view->priv->selection->type == GTK_SELECTION_MULTIPLE)
2947 tree_view->priv->press_start_y += tree_view->priv->dy;
2948 tree_view->priv->rubber_band_x = event->x;
2949 tree_view->priv->rubber_band_y = event->y + tree_view->priv->dy;
2950 tree_view->priv->rubber_band_status = RUBBER_BAND_MAYBE_START;
2952 if ((event->state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
2953 tree_view->priv->rubber_band_ctrl = TRUE;
2954 if ((event->state & GDK_SHIFT_MASK) == GDK_SHIFT_MASK)
2955 tree_view->priv->rubber_band_shift = TRUE;
2959 /* Test if a double click happened on the same row. */
2960 if (event->button == 1 && event->type == GDK_BUTTON_PRESS)
2962 int double_click_time, double_click_distance;
2964 g_object_get (gtk_settings_get_default (),
2965 "gtk-double-click-time", &double_click_time,
2966 "gtk-double-click-distance", &double_click_distance,
2969 /* Same conditions as _gdk_event_button_generate */
2970 if (tree_view->priv->last_button_x != -1 &&
2971 (event->time < tree_view->priv->last_button_time + double_click_time) &&
2972 (ABS (event->x - tree_view->priv->last_button_x) <= double_click_distance) &&
2973 (ABS (event->y - tree_view->priv->last_button_y) <= double_click_distance))
2975 /* We do no longer compare paths of this row and the
2976 * row clicked previously. We use the double click
2977 * distance to decide whether this is a valid click,
2978 * allowing the mouse to slightly move over another row.
2980 row_double_click = TRUE;
2982 tree_view->priv->last_button_time = 0;
2983 tree_view->priv->last_button_x = -1;
2984 tree_view->priv->last_button_y = -1;
2988 tree_view->priv->last_button_time = event->time;
2989 tree_view->priv->last_button_x = event->x;
2990 tree_view->priv->last_button_y = event->y;
2994 if (row_double_click)
2996 gtk_grab_remove (widget);
2997 gtk_tree_view_row_activated (tree_view, path, column);
2999 if (tree_view->priv->pressed_button == event->button)
3000 tree_view->priv->pressed_button = -1;
3003 gtk_tree_path_free (path);
3005 /* If we activated the row through a double click we don't want to grab
3006 * focus back, as moving focus to another widget is pretty common.
3008 if (!row_double_click)
3009 grab_focus_and_unset_draw_keyfocus (tree_view);
3014 /* We didn't click in the window. Let's check to see if we clicked on a column resize window.
3016 for (i = 0, list = tree_view->priv->columns; list; list = list->next, i++)
3018 column = list->data;
3019 if (event->window == column->window &&
3020 gtk_tree_view_column_get_resizable (column) &&
3023 GtkAllocation button_allocation;
3026 if (event->type == GDK_2BUTTON_PRESS &&
3027 gtk_tree_view_column_get_sizing (column) != GTK_TREE_VIEW_COLUMN_AUTOSIZE)
3029 column->use_resized_width = FALSE;
3030 _gtk_tree_view_column_autosize (tree_view, column);
3034 if (gdk_pointer_grab (column->window, FALSE,
3035 GDK_POINTER_MOTION_HINT_MASK |
3036 GDK_BUTTON1_MOTION_MASK |
3037 GDK_BUTTON_RELEASE_MASK,
3038 NULL, NULL, event->time))
3041 gtk_grab_add (widget);
3042 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
3043 column->resized_width = gtk_tree_view_column_get_width (column) -
3044 tree_view->priv->last_extra_space_per_column;
3046 /* block attached dnd signal handler */
3047 drag_data = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
3049 g_signal_handlers_block_matched (widget,
3050 G_SIGNAL_MATCH_DATA,
3054 gtk_widget_get_allocation (column->button, &button_allocation);
3055 tree_view->priv->drag_pos = i;
3056 tree_view->priv->x_drag = button_allocation.x + (rtl ? 0 : button_allocation.width);
3058 if (!gtk_widget_has_focus (widget))
3059 gtk_widget_grab_focus (widget);
3067 /* GtkWidget::button_release_event helper */
3069 gtk_tree_view_button_release_drag_column (GtkWidget *widget,
3070 GdkEventButton *event)
3072 GtkTreeView *tree_view;
3076 tree_view = GTK_TREE_VIEW (widget);
3078 rtl = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);
3079 gdk_display_pointer_ungrab (gtk_widget_get_display (widget), GDK_CURRENT_TIME);
3080 gdk_display_keyboard_ungrab (gtk_widget_get_display (widget), GDK_CURRENT_TIME);
3082 /* Move the button back */
3083 g_object_ref (tree_view->priv->drag_column->button);
3084 gtk_container_remove (GTK_CONTAINER (tree_view), tree_view->priv->drag_column->button);
3085 gtk_widget_set_parent_window (tree_view->priv->drag_column->button, tree_view->priv->header_window);
3086 gtk_widget_set_parent (tree_view->priv->drag_column->button, GTK_WIDGET (tree_view));
3087 g_object_unref (tree_view->priv->drag_column->button);
3088 gtk_widget_queue_resize (widget);
3089 if (gtk_tree_view_column_get_resizable (tree_view->priv->drag_column))
3091 gdk_window_raise (tree_view->priv->drag_column->window);
3092 gdk_window_show (tree_view->priv->drag_column->window);
3095 gdk_window_hide (tree_view->priv->drag_column->window);
3097 gtk_widget_grab_focus (tree_view->priv->drag_column->button);
3101 if (tree_view->priv->cur_reorder &&
3102 tree_view->priv->cur_reorder->right_column != tree_view->priv->drag_column)
3103 gtk_tree_view_move_column_after (tree_view, tree_view->priv->drag_column,
3104 tree_view->priv->cur_reorder->right_column);
3108 if (tree_view->priv->cur_reorder &&
3109 tree_view->priv->cur_reorder->left_column != tree_view->priv->drag_column)
3110 gtk_tree_view_move_column_after (tree_view, tree_view->priv->drag_column,
3111 tree_view->priv->cur_reorder->left_column);
3113 tree_view->priv->drag_column = NULL;
3114 gdk_window_hide (tree_view->priv->drag_window);
3116 for (l = tree_view->priv->column_drag_info; l != NULL; l = l->next)
3117 g_slice_free (GtkTreeViewColumnReorder, l->data);
3118 g_list_free (tree_view->priv->column_drag_info);
3119 tree_view->priv->column_drag_info = NULL;
3120 tree_view->priv->cur_reorder = NULL;
3122 if (tree_view->priv->drag_highlight_window)
3123 gdk_window_hide (tree_view->priv->drag_highlight_window);
3125 /* Reset our flags */
3126 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_UNSET;
3127 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
3132 /* GtkWidget::button_release_event helper */
3134 gtk_tree_view_button_release_column_resize (GtkWidget *widget,
3135 GdkEventButton *event)
3137 GtkTreeView *tree_view;
3140 tree_view = GTK_TREE_VIEW (widget);
3142 tree_view->priv->drag_pos = -1;
3144 /* unblock attached dnd signal handler */
3145 drag_data = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
3147 g_signal_handlers_unblock_matched (widget,
3148 G_SIGNAL_MATCH_DATA,
3152 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE);
3153 gtk_grab_remove (widget);
3154 gdk_display_pointer_ungrab (gdk_window_get_display (event->window),
3160 gtk_tree_view_button_release (GtkWidget *widget,
3161 GdkEventButton *event)
3163 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
3165 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
3166 return gtk_tree_view_button_release_drag_column (widget, event);
3168 if (tree_view->priv->rubber_band_status)
3169 gtk_tree_view_stop_rubber_band (tree_view);
3171 if (tree_view->priv->pressed_button == event->button)
3172 tree_view->priv->pressed_button = -1;
3174 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
3175 return gtk_tree_view_button_release_column_resize (widget, event);
3177 if (tree_view->priv->button_pressed_node == NULL)
3180 if (event->button == 1)
3182 gtk_grab_remove (widget);
3183 if (tree_view->priv->button_pressed_node == tree_view->priv->prelight_node &&
3184 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
3186 GtkTreePath *path = NULL;
3188 path = _gtk_tree_view_find_path (tree_view,
3189 tree_view->priv->button_pressed_tree,
3190 tree_view->priv->button_pressed_node);
3191 /* Actually activate the node */
3192 if (tree_view->priv->button_pressed_node->children == NULL)
3193 gtk_tree_view_real_expand_row (tree_view, path,
3194 tree_view->priv->button_pressed_tree,
3195 tree_view->priv->button_pressed_node,
3198 gtk_tree_view_real_collapse_row (GTK_TREE_VIEW (widget), path,
3199 tree_view->priv->button_pressed_tree,
3200 tree_view->priv->button_pressed_node, TRUE);
3201 gtk_tree_path_free (path);
3204 tree_view->priv->button_pressed_tree = NULL;
3205 tree_view->priv->button_pressed_node = NULL;
3212 gtk_tree_view_grab_broken (GtkWidget *widget,
3213 GdkEventGrabBroken *event)
3215 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
3217 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
3218 gtk_tree_view_button_release_drag_column (widget, (GdkEventButton *)event);
3220 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
3221 gtk_tree_view_button_release_column_resize (widget, (GdkEventButton *)event);
3228 gtk_tree_view_configure (GtkWidget *widget,
3229 GdkEventConfigure *event)
3231 GtkTreeView *tree_view;
3233 tree_view = GTK_TREE_VIEW (widget);
3234 tree_view->priv->search_position_func (tree_view, tree_view->priv->search_window);
3240 /* GtkWidget::motion_event function set.
3244 coords_are_over_arrow (GtkTreeView *tree_view,
3247 /* these are in bin window coords */
3254 if (!gtk_widget_get_realized (GTK_WIDGET (tree_view)))
3257 if ((node->flags & GTK_RBNODE_IS_PARENT) == 0)
3260 arrow.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
3262 arrow.height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
3264 gtk_tree_view_get_arrow_xrange (tree_view, tree, &arrow.x, &x2);
3266 arrow.width = x2 - arrow.x;
3268 return (x >= arrow.x &&
3269 x < (arrow.x + arrow.width) &&
3271 y < (arrow.y + arrow.height));
3275 auto_expand_timeout (gpointer data)
3277 GtkTreeView *tree_view = GTK_TREE_VIEW (data);
3280 if (tree_view->priv->prelight_node)
3282 path = _gtk_tree_view_find_path (tree_view,
3283 tree_view->priv->prelight_tree,
3284 tree_view->priv->prelight_node);
3286 if (tree_view->priv->prelight_node->children)
3287 gtk_tree_view_collapse_row (tree_view, path);
3289 gtk_tree_view_expand_row (tree_view, path, FALSE);
3291 gtk_tree_path_free (path);
3294 tree_view->priv->auto_expand_timeout = 0;
3300 remove_auto_expand_timeout (GtkTreeView *tree_view)
3302 if (tree_view->priv->auto_expand_timeout != 0)
3304 g_source_remove (tree_view->priv->auto_expand_timeout);
3305 tree_view->priv->auto_expand_timeout = 0;
3310 do_prelight (GtkTreeView *tree_view,
3313 /* these are in bin_window coords */
3317 if (tree_view->priv->prelight_tree == tree &&
3318 tree_view->priv->prelight_node == node)
3320 /* We are still on the same node,
3321 but we might need to take care of the arrow */
3323 if (tree && node && TREE_VIEW_DRAW_EXPANDERS (tree_view))
3325 gboolean over_arrow;
3328 over_arrow = coords_are_over_arrow (tree_view, tree, node, x, y);
3329 flag_set = GTK_TREE_VIEW_FLAG_SET (tree_view,
3330 GTK_TREE_VIEW_ARROW_PRELIT);
3332 if (over_arrow != flag_set)
3335 GTK_TREE_VIEW_SET_FLAG (tree_view,
3336 GTK_TREE_VIEW_ARROW_PRELIT);
3338 GTK_TREE_VIEW_UNSET_FLAG (tree_view,
3339 GTK_TREE_VIEW_ARROW_PRELIT);
3341 gtk_tree_view_queue_draw_arrow (tree_view, tree, node);
3348 if (tree_view->priv->prelight_tree && tree_view->priv->prelight_node)
3350 /* Unprelight the old node and arrow */
3352 GTK_RBNODE_UNSET_FLAG (tree_view->priv->prelight_node,
3353 GTK_RBNODE_IS_PRELIT);
3355 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT)
3356 && TREE_VIEW_DRAW_EXPANDERS (tree_view))
3358 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
3360 gtk_tree_view_queue_draw_arrow (tree_view,
3361 tree_view->priv->prelight_tree,
3362 tree_view->priv->prelight_node);
3365 _gtk_tree_view_queue_draw_node (tree_view,
3366 tree_view->priv->prelight_tree,
3367 tree_view->priv->prelight_node,
3372 if (tree_view->priv->hover_expand)
3373 remove_auto_expand_timeout (tree_view);
3375 /* Set the new prelight values */
3376 tree_view->priv->prelight_node = node;
3377 tree_view->priv->prelight_tree = tree;
3382 /* Prelight the new node and arrow */
3384 if (TREE_VIEW_DRAW_EXPANDERS (tree_view)
3385 && coords_are_over_arrow (tree_view, tree, node, x, y))
3387 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_ARROW_PRELIT);
3389 gtk_tree_view_queue_draw_arrow (tree_view, tree, node);
3392 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PRELIT);
3394 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
3396 if (tree_view->priv->hover_expand)
3398 tree_view->priv->auto_expand_timeout =
3399 gdk_threads_add_timeout (AUTO_EXPAND_TIMEOUT, auto_expand_timeout, tree_view);
3404 prelight_or_select (GtkTreeView *tree_view,
3407 /* these are in bin_window coords */
3411 GtkSelectionMode mode = gtk_tree_selection_get_mode (tree_view->priv->selection);
3413 if (tree_view->priv->hover_selection &&
3414 (mode == GTK_SELECTION_SINGLE || mode == GTK_SELECTION_BROWSE) &&
3415 !(tree_view->priv->edited_column &&
3416 tree_view->priv->edited_column->editable_widget))
3420 if (!GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
3424 path = _gtk_tree_view_find_path (tree_view, tree, node);
3425 gtk_tree_selection_select_path (tree_view->priv->selection, path);
3426 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
3428 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
3429 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, FALSE);
3431 gtk_tree_path_free (path);
3435 else if (mode == GTK_SELECTION_SINGLE)
3436 gtk_tree_selection_unselect_all (tree_view->priv->selection);
3439 do_prelight (tree_view, tree, node, x, y);
3443 ensure_unprelighted (GtkTreeView *tree_view)
3445 do_prelight (tree_view,
3447 -1000, -1000); /* coords not possibly over an arrow */
3449 g_assert (tree_view->priv->prelight_node == NULL);
3453 update_prelight (GtkTreeView *tree_view,
3461 if (tree_view->priv->tree == NULL)
3466 ensure_unprelighted (tree_view);
3470 new_y = TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, y);
3474 _gtk_rbtree_find_offset (tree_view->priv->tree,
3475 new_y, &tree, &node);
3478 prelight_or_select (tree_view, tree, node, x, y);
3484 /* Our motion arrow is either a box (in the case of the original spot)
3485 * or an arrow. It is expander_size wide.
3508 gtk_tree_view_motion_draw_column_motion_arrow (GtkTreeView *tree_view)
3510 GtkTreeViewColumnReorder *reorder = tree_view->priv->cur_reorder;
3511 GtkWidget *widget = GTK_WIDGET (tree_view);
3512 cairo_surface_t *mask_image;
3513 cairo_region_t *mask_region;
3518 gint arrow_type = DRAG_COLUMN_WINDOW_STATE_UNSET;
3519 GdkWindowAttr attributes;
3520 guint attributes_mask;
3524 reorder->left_column == tree_view->priv->drag_column ||
3525 reorder->right_column == tree_view->priv->drag_column)
3526 arrow_type = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
3527 else if (reorder->left_column || reorder->right_column)
3529 GtkAllocation left_allocation, right_allocation;
3530 GdkRectangle visible_rect;
3532 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
3533 if (reorder->left_column)
3535 gtk_widget_get_allocation (reorder->left_column->button, &left_allocation);
3536 x = left_allocation.x + left_allocation.width;
3540 gtk_widget_get_allocation (reorder->right_column->button, &right_allocation);
3541 x = right_allocation.x;
3544 if (x < visible_rect.x)
3545 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT;
3546 else if (x > visible_rect.x + visible_rect.width)
3547 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT;
3549 arrow_type = DRAG_COLUMN_WINDOW_STATE_ARROW;
3552 /* We want to draw the rectangle over the initial location. */
3553 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
3555 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ORIGINAL)
3557 GtkAllocation drag_allocation;
3559 if (tree_view->priv->drag_highlight_window)
3561 gdk_window_set_user_data (tree_view->priv->drag_highlight_window,
3563 gdk_window_destroy (tree_view->priv->drag_highlight_window);
3566 attributes.window_type = GDK_WINDOW_CHILD;
3567 attributes.wclass = GDK_INPUT_OUTPUT;
3568 attributes.x = tree_view->priv->drag_column_x;
3570 gtk_widget_get_allocation (tree_view->priv->drag_column->button, &drag_allocation);
3571 width = attributes.width = drag_allocation.width;
3572 height = attributes.height = drag_allocation.height;
3573 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
3574 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
3575 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
3576 tree_view->priv->drag_highlight_window = gdk_window_new (tree_view->priv->header_window, &attributes, attributes_mask);
3577 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
3579 mask_image = cairo_image_surface_create (CAIRO_FORMAT_A1, width, height);
3580 cr = cairo_create (mask_image);
3582 cairo_rectangle (cr, 1, 1, width - 2, height - 2);
3586 mask_region = gdk_cairo_region_create_from_surface (mask_image);
3587 gdk_window_shape_combine_region (tree_view->priv->drag_highlight_window,
3590 cairo_region_destroy (mask_region);
3591 cairo_surface_destroy (mask_image);
3593 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ORIGINAL;
3596 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW)
3598 GtkAllocation button_allocation;
3600 width = tree_view->priv->expander_size;
3602 /* Get x, y, width, height of arrow */
3603 gdk_window_get_origin (tree_view->priv->header_window, &x, &y);
3604 if (reorder->left_column)
3606 gtk_widget_get_allocation (reorder->left_column->button, &button_allocation);
3607 x += button_allocation.x + button_allocation.width - width/2;
3608 height = button_allocation.height;
3612 gtk_widget_get_allocation (reorder->right_column->button, &button_allocation);
3613 x += button_allocation.x - width/2;
3614 height = button_allocation.height;
3616 y -= tree_view->priv->expander_size/2; /* The arrow takes up only half the space */
3617 height += tree_view->priv->expander_size;
3619 /* Create the new window */
3620 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW)
3622 if (tree_view->priv->drag_highlight_window)
3624 gdk_window_set_user_data (tree_view->priv->drag_highlight_window,
3626 gdk_window_destroy (tree_view->priv->drag_highlight_window);
3629 attributes.window_type = GDK_WINDOW_TEMP;
3630 attributes.wclass = GDK_INPUT_OUTPUT;
3631 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
3632 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
3633 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
3636 attributes.width = width;
3637 attributes.height = height;
3638 tree_view->priv->drag_highlight_window = gdk_window_new (gtk_widget_get_root_window (widget),
3639 &attributes, attributes_mask);
3640 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
3642 mask_image = cairo_image_surface_create (CAIRO_FORMAT_A1, width, height);
3644 cr = cairo_create (mask_image);
3645 cairo_move_to (cr, 0, 0);
3646 cairo_line_to (cr, width, 0);
3647 cairo_line_to (cr, width / 2., width / 2);
3648 cairo_move_to (cr, 0, height);
3649 cairo_line_to (cr, width, height);
3650 cairo_line_to (cr, width / 2., height - width / 2.);
3654 mask_region = gdk_cairo_region_create_from_surface (mask_image);
3655 gdk_window_shape_combine_region (tree_view->priv->drag_highlight_window,
3658 cairo_region_destroy (mask_region);
3659 cairo_surface_destroy (mask_image);
3662 tree_view->priv->drag_column_window_state = DRAG_COLUMN_WINDOW_STATE_ARROW;
3663 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
3665 else if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT ||
3666 arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
3668 GtkAllocation allocation;
3670 width = tree_view->priv->expander_size;
3672 /* Get x, y, width, height of arrow */
3673 width = width/2; /* remember, the arrow only takes half the available width */
3674 gdk_window_get_origin (gtk_widget_get_window (widget),
3676 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
3678 gtk_widget_get_allocation (widget, &allocation);
3679 x += allocation.width - width;
3682 if (reorder->left_column)
3684 gtk_widget_get_allocation (reorder->left_column->button, &allocation);
3685 height = allocation.height;
3689 gtk_widget_get_allocation (reorder->right_column->button, &allocation);
3690 height = allocation.height;
3693 y -= tree_view->priv->expander_size;
3694 height += 2*tree_view->priv->expander_size;
3696 /* Create the new window */
3697 if (tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT &&
3698 tree_view->priv->drag_column_window_state != DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT)
3700 if (tree_view->priv->drag_highlight_window)
3702 gdk_window_set_user_data (tree_view->priv->drag_highlight_window,
3704 gdk_window_destroy (tree_view->priv->drag_highlight_window);
3707 attributes.window_type = GDK_WINDOW_TEMP;
3708 attributes.wclass = GDK_INPUT_OUTPUT;
3709 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
3710 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
3711 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
3714 attributes.width = width;
3715 attributes.height = height;
3716 tree_view->priv->drag_highlight_window = gdk_window_new (NULL, &attributes, attributes_mask);
3717 gdk_window_set_user_data (tree_view->priv->drag_highlight_window, GTK_WIDGET (tree_view));
3719 mask_image = cairo_image_surface_create (CAIRO_FORMAT_A1, width, height);
3721 cr = cairo_create (mask_image);
3722 /* mirror if we're on the left */
3723 if (arrow_type == DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT)
3725 cairo_translate (cr, width, 0);
3726 cairo_scale (cr, -1, 1);
3728 cairo_move_to (cr, 0, 0);
3729 cairo_line_to (cr, width, width);
3730 cairo_line_to (cr, 0, tree_view->priv->expander_size);
3731 cairo_move_to (cr, 0, height);
3732 cairo_line_to (cr, width, height - width);
3733 cairo_line_to (cr, 0, height - tree_view->priv->expander_size);
3737 mask_region = gdk_cairo_region_create_from_surface (mask_image);
3738 gdk_window_shape_combine_region (tree_view->priv->drag_highlight_window,
3741 cairo_region_destroy (mask_region);
3742 cairo_surface_destroy (mask_image);
3745 tree_view->priv->drag_column_window_state = arrow_type;
3746 gdk_window_move (tree_view->priv->drag_highlight_window, x, y);
3750 g_warning (G_STRLOC"Invalid GtkTreeViewColumnReorder struct");
3751 gdk_window_hide (tree_view->priv->drag_highlight_window);
3755 gdk_window_show (tree_view->priv->drag_highlight_window);
3756 gdk_window_raise (tree_view->priv->drag_highlight_window);
3760 gtk_tree_view_motion_resize_column (GtkWidget *widget,
3761 GdkEventMotion *event)
3765 GtkTreeViewColumn *column;
3766 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
3768 column = gtk_tree_view_get_column (tree_view, tree_view->priv->drag_pos);
3770 if (event->is_hint || event->window != gtk_widget_get_window (widget))
3771 gtk_widget_get_pointer (widget, &x, NULL);
3775 if (tree_view->priv->hadjustment)
3776 x += tree_view->priv->hadjustment->value;
3778 new_width = gtk_tree_view_new_column_width (tree_view,
3779 tree_view->priv->drag_pos, &x);
3780 if (x != tree_view->priv->x_drag &&
3781 (new_width != gtk_tree_view_column_get_fixed_width (column)))
3783 column->use_resized_width = TRUE;
3784 column->resized_width = new_width;
3785 if (gtk_tree_view_column_get_expand (column))
3786 column->resized_width -= tree_view->priv->last_extra_space_per_column;
3787 gtk_widget_queue_resize (widget);
3795 gtk_tree_view_update_current_reorder (GtkTreeView *tree_view)
3797 GtkTreeViewColumnReorder *reorder = NULL;
3801 gdk_window_get_pointer (tree_view->priv->header_window, &mouse_x, NULL, NULL);
3802 for (list = tree_view->priv->column_drag_info; list; list = list->next)
3804 reorder = (GtkTreeViewColumnReorder *) list->data;
3805 if (mouse_x >= reorder->left_align && mouse_x < reorder->right_align)
3810 /* if (reorder && reorder == tree_view->priv->cur_reorder)
3813 tree_view->priv->cur_reorder = reorder;
3814 gtk_tree_view_motion_draw_column_motion_arrow (tree_view);
3818 gtk_tree_view_vertical_autoscroll (GtkTreeView *tree_view)
3820 GdkRectangle visible_rect;
3824 gdk_window_get_pointer (tree_view->priv->bin_window, NULL, &y, NULL);
3825 y += tree_view->priv->dy;
3827 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
3829 /* see if we are near the edge. */
3830 offset = y - (visible_rect.y + 2 * SCROLL_EDGE_SIZE);
3833 offset = y - (visible_rect.y + visible_rect.height - 2 * SCROLL_EDGE_SIZE);
3838 gtk_adjustment_set_value (tree_view->priv->vadjustment,
3839 MAX (tree_view->priv->vadjustment->value + offset, 0.0));
3843 gtk_tree_view_horizontal_autoscroll (GtkTreeView *tree_view)
3845 GdkRectangle visible_rect;
3849 gdk_window_get_pointer (tree_view->priv->bin_window, &x, NULL, NULL);
3851 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
3853 /* See if we are near the edge. */
3854 offset = x - (visible_rect.x + SCROLL_EDGE_SIZE);
3857 offset = x - (visible_rect.x + visible_rect.width - SCROLL_EDGE_SIZE);
3863 gtk_adjustment_set_value (tree_view->priv->hadjustment,
3864 MAX (tree_view->priv->hadjustment->value + offset, 0.0));
3871 gtk_tree_view_motion_drag_column (GtkWidget *widget,
3872 GdkEventMotion *event)
3874 GtkAllocation allocation, button_allocation;
3875 GtkTreeView *tree_view = (GtkTreeView *) widget;
3876 GtkTreeViewColumn *column = tree_view->priv->drag_column;
3880 if ((column == NULL) ||
3881 (event->window != tree_view->priv->drag_window))
3884 /* Handle moving the header */
3885 gdk_window_get_position (tree_view->priv->drag_window, &x, &y);
3886 gtk_widget_get_allocation (widget, &allocation);
3887 gtk_widget_get_allocation (column->button, &button_allocation);
3888 x = CLAMP (x + (gint)event->x - column->drag_x, 0,
3889 MAX (tree_view->priv->width, allocation.width) - button_allocation.width);
3890 gdk_window_move (tree_view->priv->drag_window, x, y);
3892 /* autoscroll, if needed */
3893 gtk_tree_view_horizontal_autoscroll (tree_view);
3894 /* Update the current reorder position and arrow; */
3895 gtk_tree_view_update_current_reorder (tree_view);
3901 gtk_tree_view_stop_rubber_band (GtkTreeView *tree_view)
3903 remove_scroll_timeout (tree_view);
3904 gtk_grab_remove (GTK_WIDGET (tree_view));
3906 if (tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
3908 GtkTreePath *tmp_path;
3910 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
3912 /* The anchor path should be set to the start path */
3913 tmp_path = _gtk_tree_view_find_path (tree_view,
3914 tree_view->priv->rubber_band_start_tree,
3915 tree_view->priv->rubber_band_start_node);
3917 if (tree_view->priv->anchor)
3918 gtk_tree_row_reference_free (tree_view->priv->anchor);
3920 tree_view->priv->anchor =
3921 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
3922 tree_view->priv->model,
3925 gtk_tree_path_free (tmp_path);
3927 /* ... and the cursor to the end path */
3928 tmp_path = _gtk_tree_view_find_path (tree_view,
3929 tree_view->priv->rubber_band_end_tree,
3930 tree_view->priv->rubber_band_end_node);
3931 gtk_tree_view_real_set_cursor (GTK_TREE_VIEW (tree_view), tmp_path, FALSE, FALSE);
3932 gtk_tree_path_free (tmp_path);
3934 _gtk_tree_selection_emit_changed (tree_view->priv->selection);
3937 /* Clear status variables */
3938 tree_view->priv->rubber_band_status = RUBBER_BAND_OFF;
3939 tree_view->priv->rubber_band_shift = 0;
3940 tree_view->priv->rubber_band_ctrl = 0;
3942 tree_view->priv->rubber_band_start_node = NULL;
3943 tree_view->priv->rubber_band_start_tree = NULL;
3944 tree_view->priv->rubber_band_end_node = NULL;
3945 tree_view->priv->rubber_band_end_tree = NULL;
3949 gtk_tree_view_update_rubber_band_selection_range (GtkTreeView *tree_view,
3950 GtkRBTree *start_tree,
3951 GtkRBNode *start_node,
3952 GtkRBTree *end_tree,
3953 GtkRBNode *end_node,
3955 gboolean skip_start,
3958 if (start_node == end_node)
3961 /* We skip the first node and jump inside the loop */
3967 /* Small optimization by assuming insensitive nodes are never
3970 if (!GTK_RBNODE_FLAG_SET (start_node, GTK_RBNODE_IS_SELECTED))
3973 gboolean selectable;
3975 path = _gtk_tree_view_find_path (tree_view, start_tree, start_node);
3976 selectable = _gtk_tree_selection_row_is_selectable (tree_view->priv->selection, start_node, path);
3977 gtk_tree_path_free (path);
3980 goto node_not_selectable;
3985 if (tree_view->priv->rubber_band_shift)
3986 GTK_RBNODE_SET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3987 else if (tree_view->priv->rubber_band_ctrl)
3989 /* Toggle the selection state */
3990 if (GTK_RBNODE_FLAG_SET (start_node, GTK_RBNODE_IS_SELECTED))
3991 GTK_RBNODE_UNSET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3993 GTK_RBNODE_SET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
3996 GTK_RBNODE_SET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
4000 /* Mirror the above */
4001 if (tree_view->priv->rubber_band_shift)
4002 GTK_RBNODE_UNSET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
4003 else if (tree_view->priv->rubber_band_ctrl)
4005 /* Toggle the selection state */
4006 if (GTK_RBNODE_FLAG_SET (start_node, GTK_RBNODE_IS_SELECTED))
4007 GTK_RBNODE_UNSET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
4009 GTK_RBNODE_SET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
4012 GTK_RBNODE_UNSET_FLAG (start_node, GTK_RBNODE_IS_SELECTED);
4015 _gtk_tree_view_queue_draw_node (tree_view, start_tree, start_node, NULL);
4017 node_not_selectable:
4018 if (start_node == end_node)
4023 if (start_node->children)
4025 start_tree = start_node->children;
4026 start_node = start_tree->root;
4027 while (start_node->left != start_tree->nil)
4028 start_node = start_node->left;
4032 _gtk_rbtree_next_full (start_tree, start_node, &start_tree, &start_node);
4035 /* Ran out of tree */
4039 if (skip_end && start_node == end_node)
4046 gtk_tree_view_update_rubber_band_selection (GtkTreeView *tree_view)
4048 GtkRBTree *start_tree, *end_tree;
4049 GtkRBNode *start_node, *end_node;
4051 _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);
4052 _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);
4054 /* Handle the start area first */
4055 if (!tree_view->priv->rubber_band_start_node)
4057 gtk_tree_view_update_rubber_band_selection_range (tree_view,
4066 else if (_gtk_rbtree_node_find_offset (start_tree, start_node) <
4067 _gtk_rbtree_node_find_offset (tree_view->priv->rubber_band_start_tree, tree_view->priv->rubber_band_start_node))
4069 /* New node is above the old one; selection became bigger */
4070 gtk_tree_view_update_rubber_band_selection_range (tree_view,
4073 tree_view->priv->rubber_band_start_tree,
4074 tree_view->priv->rubber_band_start_node,
4079 else if (_gtk_rbtree_node_find_offset (start_tree, start_node) >
4080 _gtk_rbtree_node_find_offset (tree_view->priv->rubber_band_start_tree, tree_view->priv->rubber_band_start_node))
4082 /* New node is below the old one; selection became smaller */
4083 gtk_tree_view_update_rubber_band_selection_range (tree_view,
4084 tree_view->priv->rubber_band_start_tree,
4085 tree_view->priv->rubber_band_start_node,
4093 tree_view->priv->rubber_band_start_tree = start_tree;
4094 tree_view->priv->rubber_band_start_node = start_node;
4096 /* Next, handle the end area */
4097 if (!tree_view->priv->rubber_band_end_node)
4099 /* In the event this happens, start_node was also NULL; this case is
4105 /* Find the last node in the tree */
4106 _gtk_rbtree_find_offset (tree_view->priv->tree, tree_view->priv->height - 1,
4107 &end_tree, &end_node);
4109 /* Selection reached end of the tree */
4110 gtk_tree_view_update_rubber_band_selection_range (tree_view,
4111 tree_view->priv->rubber_band_end_tree,
4112 tree_view->priv->rubber_band_end_node,
4119 else if (_gtk_rbtree_node_find_offset (end_tree, end_node) >
4120 _gtk_rbtree_node_find_offset (tree_view->priv->rubber_band_end_tree, tree_view->priv->rubber_band_end_node))
4122 /* New node is below the old one; selection became bigger */
4123 gtk_tree_view_update_rubber_band_selection_range (tree_view,
4124 tree_view->priv->rubber_band_end_tree,
4125 tree_view->priv->rubber_band_end_node,
4132 else if (_gtk_rbtree_node_find_offset (end_tree, end_node) <
4133 _gtk_rbtree_node_find_offset (tree_view->priv->rubber_band_end_tree, tree_view->priv->rubber_band_end_node))
4135 /* New node is above the old one; selection became smaller */
4136 gtk_tree_view_update_rubber_band_selection_range (tree_view,
4139 tree_view->priv->rubber_band_end_tree,
4140 tree_view->priv->rubber_band_end_node,
4146 tree_view->priv->rubber_band_end_tree = end_tree;
4147 tree_view->priv->rubber_band_end_node = end_node;
4151 gtk_tree_view_update_rubber_band (GtkTreeView *tree_view)
4154 GdkRectangle old_area;
4155 GdkRectangle new_area;
4156 GdkRectangle common;
4157 cairo_region_t *invalid_region;
4159 old_area.x = MIN (tree_view->priv->press_start_x, tree_view->priv->rubber_band_x);
4160 old_area.y = MIN (tree_view->priv->press_start_y, tree_view->priv->rubber_band_y) - tree_view->priv->dy;
4161 old_area.width = ABS (tree_view->priv->rubber_band_x - tree_view->priv->press_start_x) + 1;
4162 old_area.height = ABS (tree_view->priv->rubber_band_y - tree_view->priv->press_start_y) + 1;
4164 gdk_window_get_pointer (tree_view->priv->bin_window, &x, &y, NULL);
4167 y = MAX (y, 0) + tree_view->priv->dy;
4169 new_area.x = MIN (tree_view->priv->press_start_x, x);
4170 new_area.y = MIN (tree_view->priv->press_start_y, y) - tree_view->priv->dy;
4171 new_area.width = ABS (x - tree_view->priv->press_start_x) + 1;
4172 new_area.height = ABS (y - tree_view->priv->press_start_y) + 1;
4174 invalid_region = cairo_region_create_rectangle (&old_area);
4175 cairo_region_union_rectangle (invalid_region, &new_area);
4177 gdk_rectangle_intersect (&old_area, &new_area, &common);
4178 if (common.width > 2 && common.height > 2)
4180 cairo_region_t *common_region;
4182 /* make sure the border is invalidated */
4188 common_region = cairo_region_create_rectangle (&common);
4190 cairo_region_subtract (invalid_region, common_region);
4191 cairo_region_destroy (common_region);
4194 gdk_window_invalidate_region (tree_view->priv->bin_window, invalid_region, TRUE);
4196 cairo_region_destroy (invalid_region);
4198 tree_view->priv->rubber_band_x = x;
4199 tree_view->priv->rubber_band_y = y;
4201 gtk_tree_view_update_rubber_band_selection (tree_view);
4205 gtk_tree_view_paint_rubber_band (GtkTreeView *tree_view,
4213 rect.x = MIN (tree_view->priv->press_start_x, tree_view->priv->rubber_band_x);
4214 rect.y = MIN (tree_view->priv->press_start_y, tree_view->priv->rubber_band_y) - tree_view->priv->dy;
4215 rect.width = ABS (tree_view->priv->press_start_x - tree_view->priv->rubber_band_x) + 1;
4216 rect.height = ABS (tree_view->priv->press_start_y - tree_view->priv->rubber_band_y) + 1;
4218 cairo_set_line_width (cr, 1.0);
4220 style = gtk_widget_get_style (GTK_WIDGET (tree_view));
4222 gdk_cairo_set_source_color (cr, &style->fg[GTK_STATE_NORMAL]);
4224 gdk_cairo_rectangle (cr, &rect);
4226 cairo_paint_with_alpha (cr, 0.25);
4228 cairo_rectangle (cr,
4229 rect.x + 0.5, rect.y + 0.5,
4230 rect.width - 1, rect.height - 1);
4237 gtk_tree_view_motion_bin_window (GtkWidget *widget,
4238 GdkEventMotion *event)
4240 GtkTreeView *tree_view;
4245 tree_view = (GtkTreeView *) widget;
4247 if (tree_view->priv->tree == NULL)
4250 if (tree_view->priv->rubber_band_status == RUBBER_BAND_MAYBE_START)
4252 gtk_grab_add (GTK_WIDGET (tree_view));
4253 gtk_tree_view_update_rubber_band (tree_view);
4255 tree_view->priv->rubber_band_status = RUBBER_BAND_ACTIVE;
4257 else if (tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
4259 gtk_tree_view_update_rubber_band (tree_view);
4261 add_scroll_timeout (tree_view);
4264 /* only check for an initiated drag when a button is pressed */
4265 if (tree_view->priv->pressed_button >= 0
4266 && !tree_view->priv->rubber_band_status)
4267 gtk_tree_view_maybe_begin_dragging_row (tree_view, event);
4269 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
4273 _gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
4275 /* If we are currently pressing down a button, we don't want to prelight anything else. */
4276 if ((tree_view->priv->button_pressed_node != NULL) &&
4277 (tree_view->priv->button_pressed_node != node))
4280 tree_view->priv->event_last_x = event->x;
4281 tree_view->priv->event_last_y = event->y;
4283 prelight_or_select (tree_view, tree, node, event->x, event->y);
4289 gtk_tree_view_motion (GtkWidget *widget,
4290 GdkEventMotion *event)
4292 GtkTreeView *tree_view;
4294 tree_view = (GtkTreeView *) widget;
4296 /* Resizing a column */
4297 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_RESIZE))
4298 return gtk_tree_view_motion_resize_column (widget, event);
4301 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
4302 return gtk_tree_view_motion_drag_column (widget, event);
4304 /* Sanity check it */
4305 if (event->window == tree_view->priv->bin_window)
4306 return gtk_tree_view_motion_bin_window (widget, event);
4311 /* Invalidate the focus rectangle near the edge of the bin_window; used when
4312 * the tree is empty.
4315 invalidate_empty_focus (GtkTreeView *tree_view)
4319 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
4324 area.width = gdk_window_get_width (tree_view->priv->bin_window);
4325 area.height = gdk_window_get_height (tree_view->priv->bin_window);
4326 gdk_window_invalidate_rect (tree_view->priv->bin_window, &area, FALSE);
4329 /* Draws a focus rectangle near the edge of the bin_window; used when the tree
4333 draw_empty_focus (GtkTreeView *tree_view, cairo_t *cr)
4335 GtkWidget *widget = GTK_WIDGET (tree_view);
4338 if (!gtk_widget_has_focus (widget))
4341 w = gdk_window_get_width (tree_view->priv->bin_window) - 2;
4342 h = gdk_window_get_height (tree_view->priv->bin_window) - 2;
4345 gtk_paint_focus (gtk_widget_get_style (widget),
4347 gtk_widget_get_state (widget),
4354 GTK_TREE_VIEW_GRID_LINE,
4355 GTK_TREE_VIEW_TREE_LINE,
4356 GTK_TREE_VIEW_FOREGROUND_LINE
4357 } GtkTreeViewLineType;
4360 gtk_tree_view_draw_line (GtkTreeView *tree_view,
4362 GtkTreeViewLineType type,
4372 case GTK_TREE_VIEW_TREE_LINE:
4373 cairo_set_source_rgb (cr, 0, 0, 0);
4374 cairo_set_line_width (cr, tree_view->priv->tree_line_width);
4375 if (tree_view->priv->tree_line_dashes[0])
4377 tree_view->priv->tree_line_dashes,
4380 case GTK_TREE_VIEW_GRID_LINE:
4381 cairo_set_source_rgb (cr, 0, 0, 0);
4382 cairo_set_line_width (cr, tree_view->priv->grid_line_width);
4383 if (tree_view->priv->grid_line_dashes[0])
4385 tree_view->priv->grid_line_dashes,
4389 g_assert_not_reached ();
4391 case GTK_TREE_VIEW_FOREGROUND_LINE:
4392 cairo_set_line_width (cr, 1.0);
4393 gdk_cairo_set_source_color (cr,
4394 >k_widget_get_style (GTK_WIDGET (tree_view))->fg[gtk_widget_get_state (GTK_WIDGET (tree_view))]);
4398 cairo_move_to (cr, x1 + 0.5, y1 + 0.5);
4399 cairo_line_to (cr, x2 + 0.5, y2 + 0.5);
4406 gtk_tree_view_draw_grid_lines (GtkTreeView *tree_view,
4408 gint n_visible_columns)
4410 GList *list = tree_view->priv->columns;
4414 if (tree_view->priv->grid_lines != GTK_TREE_VIEW_GRID_LINES_VERTICAL
4415 && tree_view->priv->grid_lines != GTK_TREE_VIEW_GRID_LINES_BOTH)
4418 /* Only draw the lines for visible rows and columns */
4419 for (list = tree_view->priv->columns; list; list = list->next, i++)
4421 GtkTreeViewColumn *column = list->data;
4423 /* We don't want a line for the last column */
4424 if (i == n_visible_columns - 1)
4427 if (!gtk_tree_view_column_get_visible (column))
4430 current_x += gtk_tree_view_column_get_width (column);
4432 gtk_tree_view_draw_line (tree_view, cr,
4433 GTK_TREE_VIEW_GRID_LINE,
4435 current_x - 1, tree_view->priv->height);
4439 /* Warning: Very scary function.
4440 * Modify at your own risk
4442 * KEEP IN SYNC WITH gtk_tree_view_create_row_drag_icon()!
4443 * FIXME: It's not...
4446 gtk_tree_view_bin_draw (GtkWidget *widget,
4449 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
4455 GtkRBNode *cursor = NULL;
4456 GtkRBTree *cursor_tree = NULL;
4457 GtkRBNode *drag_highlight = NULL;
4458 GtkRBTree *drag_highlight_tree = NULL;
4461 gint y_offset, cell_offset;
4464 GdkRectangle background_area;
4465 GdkRectangle cell_area;
4469 gint expander_cell_width;
4470 gint bin_window_width;
4471 gint bin_window_height;
4472 GtkTreePath *cursor_path;
4473 GtkTreePath *drag_dest_path;
4474 GList *first_column, *last_column;
4475 gint vertical_separator;
4476 gint horizontal_separator;
4477 gint focus_line_width;
4478 gboolean allow_rules;
4479 gboolean has_special_cell;
4481 gint n_visible_columns;
4482 gint pointer_x, pointer_y;
4483 gint grid_line_width;
4484 gboolean got_pointer = FALSE;
4485 gboolean draw_vgrid_lines, draw_hgrid_lines;
4487 rtl = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);
4489 gtk_widget_style_get (widget,
4490 "horizontal-separator", &horizontal_separator,
4491 "vertical-separator", &vertical_separator,
4492 "allow-rules", &allow_rules,
4493 "focus-line-width", &focus_line_width,
4496 if (tree_view->priv->tree == NULL)
4498 draw_empty_focus (tree_view, cr);
4502 style = gtk_widget_get_style (widget);
4504 bin_window_width = gdk_window_get_width (tree_view->priv->bin_window);
4505 bin_window_height = gdk_window_get_height (tree_view->priv->bin_window);
4506 cairo_rectangle (cr, 0, 0, bin_window_width, bin_window_height);
4508 if (!gdk_cairo_get_clip_rectangle (cr, &clip))
4511 new_y = TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, clip.y);
4515 y_offset = -_gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
4517 if (tree_view->priv->height < bin_window_height)
4519 gtk_paint_flat_box (style,
4521 gtk_widget_get_state (widget),
4525 0, tree_view->priv->height,
4527 bin_window_height - tree_view->priv->height);
4533 /* find the path for the node */
4534 path = _gtk_tree_view_find_path ((GtkTreeView *)widget,
4537 gtk_tree_model_get_iter (tree_view->priv->model,
4540 depth = gtk_tree_path_get_depth (path);
4541 gtk_tree_path_free (path);
4544 drag_dest_path = NULL;
4546 if (tree_view->priv->cursor)
4547 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
4550 _gtk_tree_view_find_node (tree_view, cursor_path,
4551 &cursor_tree, &cursor);
4553 if (tree_view->priv->drag_dest_row)
4554 drag_dest_path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
4557 _gtk_tree_view_find_node (tree_view, drag_dest_path,
4558 &drag_highlight_tree, &drag_highlight);
4561 tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_VERTICAL
4562 || tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_BOTH;
4564 tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_HORIZONTAL
4565 || tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_BOTH;
4567 if (draw_vgrid_lines || draw_hgrid_lines)
4568 gtk_widget_style_get (widget, "grid-line-width", &grid_line_width, NULL);
4570 n_visible_columns = 0;
4571 for (list = tree_view->priv->columns; list; list = list->next)
4573 if (!gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (list->data)))
4575 n_visible_columns ++;
4578 /* Find the last column */
4579 for (last_column = g_list_last (tree_view->priv->columns);
4581 !(gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (last_column->data)));
4582 last_column = last_column->prev)
4586 for (first_column = g_list_first (tree_view->priv->columns);
4588 !(gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (first_column->data)));
4589 first_column = first_column->next)
4592 /* Actually process the expose event. To do this, we want to
4593 * start at the first node of the event, and walk the tree in
4594 * order, drawing each successive node.
4600 gboolean is_separator = FALSE;
4601 gboolean is_first = FALSE;
4602 gboolean is_last = FALSE;
4604 is_separator = row_is_separator (tree_view, &iter, NULL);
4606 max_height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
4609 highlight_x = 0; /* should match x coord of first cell */
4610 expander_cell_width = 0;
4612 background_area.y = y_offset + clip.y;
4613 background_area.height = max_height;
4617 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PRELIT))
4618 flags |= GTK_CELL_RENDERER_PRELIT;
4620 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
4621 flags |= GTK_CELL_RENDERER_SELECTED;
4623 parity = _gtk_rbtree_node_find_parity (tree, node);
4625 /* we *need* to set cell data on all cells before the call
4626 * to _has_special_cell, else _has_special_cell() does not
4627 * return a correct value.
4629 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
4631 list = (rtl ? list->prev : list->next))
4633 GtkTreeViewColumn *column = list->data;
4634 gtk_tree_view_column_cell_set_cell_data (column,
4635 tree_view->priv->model,
4637 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
4638 node->children?TRUE:FALSE);
4641 has_special_cell = gtk_tree_view_has_special_cell (tree_view);
4643 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
4645 list = (rtl ? list->prev : list->next))
4647 GtkTreeViewColumn *column = list->data;
4648 const gchar *detail = NULL;
4649 gchar new_detail[128];
4653 if (!gtk_tree_view_column_get_visible (column))
4656 width = gtk_tree_view_column_get_width (column);
4658 if (cell_offset > clip.x + clip.width ||
4659 cell_offset + width < clip.x)
4661 cell_offset += width;
4665 if (gtk_tree_view_column_get_sort_indicator (column))
4666 flags |= GTK_CELL_RENDERER_SORTED;
4668 flags &= ~GTK_CELL_RENDERER_SORTED;
4671 flags |= GTK_CELL_RENDERER_FOCUSED;
4673 flags &= ~GTK_CELL_RENDERER_FOCUSED;
4675 background_area.x = cell_offset;
4676 background_area.width = width;
4678 cell_area = background_area;
4679 cell_area.y += vertical_separator / 2;
4680 cell_area.x += horizontal_separator / 2;
4681 cell_area.height -= vertical_separator;
4682 cell_area.width -= horizontal_separator;
4684 if (draw_vgrid_lines)
4686 if (list == first_column)
4688 cell_area.width -= grid_line_width / 2;
4690 else if (list == last_column)
4692 cell_area.x += grid_line_width / 2;
4693 cell_area.width -= grid_line_width / 2;
4697 cell_area.x += grid_line_width / 2;
4698 cell_area.width -= grid_line_width;
4702 if (draw_hgrid_lines)
4704 cell_area.y += grid_line_width / 2;
4705 cell_area.height -= grid_line_width;
4708 if (!gdk_rectangle_intersect (&clip, &background_area, NULL))
4710 cell_offset += gtk_tree_view_column_get_width (column);
4714 gtk_tree_view_column_cell_set_cell_data (column,
4715 tree_view->priv->model,
4717 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
4718 node->children?TRUE:FALSE);
4720 /* Select the detail for drawing the cell. relevant
4721 * factors are parity, sortedness, and whether to
4724 if (allow_rules && tree_view->priv->has_rules)
4726 if ((flags & GTK_CELL_RENDERER_SORTED) &&
4727 n_visible_columns >= 3)
4730 detail = "cell_odd_ruled_sorted";
4732 detail = "cell_even_ruled_sorted";
4737 detail = "cell_odd_ruled";
4739 detail = "cell_even_ruled";
4744 if ((flags & GTK_CELL_RENDERER_SORTED) &&
4745 n_visible_columns >= 3)
4748 detail = "cell_odd_sorted";
4750 detail = "cell_even_sorted";
4755 detail = "cell_odd";
4757 detail = "cell_even";
4763 if (gtk_widget_get_state (widget) == GTK_STATE_INSENSITIVE)
4764 state = GTK_STATE_INSENSITIVE;
4765 else if (flags & GTK_CELL_RENDERER_SELECTED)
4766 state = GTK_STATE_SELECTED;
4768 state = GTK_STATE_NORMAL;
4770 /* Draw background */
4771 is_first = (rtl ? !list->next : !list->prev);
4772 is_last = (rtl ? !list->prev : !list->next);
4774 /* (I don't like the snprintfs either, but couldn't find a
4777 if (is_first && is_last)
4778 g_snprintf (new_detail, 127, "%s", detail);
4780 g_snprintf (new_detail, 127, "%s_start", detail);
4782 g_snprintf (new_detail, 127, "%s_end", detail);
4784 g_snprintf (new_detail, 127, "%s_middle", detail);
4786 gtk_paint_flat_box (style,
4794 background_area.width,
4795 background_area.height);
4797 if (gtk_tree_view_is_expander_column (tree_view, column))
4800 cell_area.x += (depth - 1) * tree_view->priv->level_indentation;
4801 cell_area.width -= (depth - 1) * tree_view->priv->level_indentation;
4803 if (TREE_VIEW_DRAW_EXPANDERS(tree_view))
4806 cell_area.x += depth * tree_view->priv->expander_size;
4807 cell_area.width -= depth * tree_view->priv->expander_size;
4810 /* If we have an expander column, the highlight underline
4811 * starts with that column, so that it indicates which
4812 * level of the tree we're dropping at.
4814 highlight_x = cell_area.x;
4815 expander_cell_width = cell_area.width;
4818 gtk_paint_hline (style,
4824 cell_area.x + cell_area.width,
4825 cell_area.y + cell_area.height / 2);
4827 _gtk_tree_view_column_cell_render (column,
4832 if (TREE_VIEW_DRAW_EXPANDERS(tree_view)
4833 && (node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT)
4837 gdk_window_get_pointer (tree_view->priv->bin_window,
4838 &pointer_x, &pointer_y, NULL);
4842 gtk_tree_view_draw_arrow (GTK_TREE_VIEW (widget),
4846 pointer_x, pointer_y);
4852 gtk_paint_hline (style,
4858 cell_area.x + cell_area.width,
4859 cell_area.y + cell_area.height / 2);
4861 _gtk_tree_view_column_cell_render (column,
4868 if (draw_hgrid_lines)
4870 if (background_area.y > 0)
4871 gtk_tree_view_draw_line (tree_view, cr,
4872 GTK_TREE_VIEW_GRID_LINE,
4873 background_area.x, background_area.y,
4874 background_area.x + background_area.width,
4877 if (y_offset + max_height >= clip.height)
4878 gtk_tree_view_draw_line (tree_view, cr,
4879 GTK_TREE_VIEW_GRID_LINE,
4880 background_area.x, background_area.y + max_height,
4881 background_area.x + background_area.width,
4882 background_area.y + max_height);
4885 if (gtk_tree_view_is_expander_column (tree_view, column) &&
4886 tree_view->priv->tree_lines_enabled)
4888 gint x = background_area.x;
4889 gint mult = rtl ? -1 : 1;
4890 gint y0 = background_area.y;
4891 gint y1 = background_area.y + background_area.height/2;
4892 gint y2 = background_area.y + background_area.height;
4895 x += background_area.width - 1;
4897 if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT
4900 gtk_tree_view_draw_line (tree_view, cr,
4901 GTK_TREE_VIEW_TREE_LINE,
4902 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4904 x + tree_view->priv->expander_size * (depth - 1.1) * mult,
4909 gtk_tree_view_draw_line (tree_view, cr,
4910 GTK_TREE_VIEW_TREE_LINE,
4911 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4913 x + tree_view->priv->expander_size * (depth - 0.5) * mult,
4920 GtkRBNode *tmp_node;
4921 GtkRBTree *tmp_tree;
4923 if (!_gtk_rbtree_next (tree, node))
4924 gtk_tree_view_draw_line (tree_view, cr,
4925 GTK_TREE_VIEW_TREE_LINE,
4926 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4928 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4931 gtk_tree_view_draw_line (tree_view, cr,
4932 GTK_TREE_VIEW_TREE_LINE,
4933 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4935 x + tree_view->priv->expander_size * (depth - 1.5) * mult,
4938 tmp_node = tree->parent_node;
4939 tmp_tree = tree->parent_tree;
4941 for (i = depth - 2; i > 0; i--)
4943 if (_gtk_rbtree_next (tmp_tree, tmp_node))
4944 gtk_tree_view_draw_line (tree_view, cr,
4945 GTK_TREE_VIEW_TREE_LINE,
4946 x + tree_view->priv->expander_size * (i - 0.5) * mult,
4948 x + tree_view->priv->expander_size * (i - 0.5) * mult,
4951 tmp_node = tmp_tree->parent_node;
4952 tmp_tree = tmp_tree->parent_tree;
4957 if (node == cursor && has_special_cell &&
4958 ((column == tree_view->priv->focus_column &&
4959 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS) &&
4960 gtk_widget_has_focus (widget)) ||
4961 (column == tree_view->priv->edited_column)))
4963 _gtk_tree_view_column_cell_draw_focus (column,
4970 cell_offset += gtk_tree_view_column_get_width (column);
4973 if (node == drag_highlight)
4975 /* Draw indicator for the drop
4977 gint highlight_y = -1;
4978 GtkRBTree *tree = NULL;
4979 GtkRBNode *node = NULL;
4981 switch (tree_view->priv->drag_dest_pos)
4983 case GTK_TREE_VIEW_DROP_BEFORE:
4984 highlight_y = background_area.y - 1;
4985 if (highlight_y < 0)
4989 case GTK_TREE_VIEW_DROP_AFTER:
4990 highlight_y = background_area.y + background_area.height - 1;
4993 case GTK_TREE_VIEW_DROP_INTO_OR_BEFORE:
4994 case GTK_TREE_VIEW_DROP_INTO_OR_AFTER:
4995 _gtk_tree_view_find_node (tree_view, drag_dest_path, &tree, &node);
5000 gtk_paint_focus (style,
5002 gtk_widget_get_state (widget),
5005 ? (is_last ? "treeview-drop-indicator" : "treeview-drop-indicator-left" )
5006 : (is_last ? "treeview-drop-indicator-right" : "tree-view-drop-indicator-middle" )),
5007 0, BACKGROUND_FIRST_PIXEL (tree_view, tree, node)
5008 - focus_line_width / 2,
5009 gdk_window_get_width (tree_view->priv->bin_window),
5010 ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node))
5011 - focus_line_width + 1);
5015 if (highlight_y >= 0)
5017 gtk_tree_view_draw_line (tree_view, cr,
5018 GTK_TREE_VIEW_FOREGROUND_LINE,
5019 rtl ? highlight_x + expander_cell_width : highlight_x,
5021 rtl ? 0 : bin_window_width,
5026 /* draw the big row-spanning focus rectangle, if needed */
5027 if (!has_special_cell && node == cursor &&
5028 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS) &&
5029 gtk_widget_has_focus (widget))
5031 gint tmp_y, tmp_height;
5032 GtkStateType focus_rect_state;
5035 flags & GTK_CELL_RENDERER_SELECTED ? GTK_STATE_SELECTED :
5036 (flags & GTK_CELL_RENDERER_PRELIT ? GTK_STATE_PRELIGHT :
5037 (flags & GTK_CELL_RENDERER_INSENSITIVE ? GTK_STATE_INSENSITIVE :
5040 if (draw_hgrid_lines)
5042 tmp_y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node) + grid_line_width / 2;
5043 tmp_height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node)) - grid_line_width;
5047 tmp_y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
5048 tmp_height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
5051 gtk_paint_focus (style,
5056 ? (is_last ? "treeview" : "treeview-left" )
5057 : (is_last ? "treeview-right" : "treeview-middle" )),
5059 gdk_window_get_width (tree_view->priv->bin_window),
5063 y_offset += max_height;
5066 GtkTreeIter parent = iter;
5069 tree = node->children;
5072 g_assert (node != tree->nil);
5074 while (node->left != tree->nil)
5076 has_child = gtk_tree_model_iter_children (tree_view->priv->model,
5082 TREE_VIEW_INTERNAL_ASSERT (has_child, FALSE);
5086 gboolean done = FALSE;
5090 node = _gtk_rbtree_next (tree, node);
5093 gboolean has_next = gtk_tree_model_iter_next (tree_view->priv->model, &iter);
5097 TREE_VIEW_INTERNAL_ASSERT (has_next, FALSE);
5101 GtkTreeIter parent_iter = iter;
5102 gboolean has_parent;
5104 node = tree->parent_node;
5105 tree = tree->parent_tree;
5107 /* we should go to done to free some memory */
5109 has_parent = gtk_tree_model_iter_parent (tree_view->priv->model,
5115 TREE_VIEW_INTERNAL_ASSERT (has_parent, FALSE);
5121 while (y_offset < clip.height);
5124 gtk_tree_view_draw_grid_lines (tree_view, cr, n_visible_columns);
5126 if (tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
5127 gtk_tree_view_paint_rubber_band (tree_view, cr);
5130 gtk_tree_path_free (cursor_path);
5133 gtk_tree_path_free (drag_dest_path);
5139 gtk_tree_view_draw (GtkWidget *widget,
5142 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
5144 if (gtk_cairo_should_draw_window (cr, tree_view->priv->bin_window))
5150 gtk_cairo_transform_to_window (cr, widget, tree_view->priv->bin_window);
5152 gtk_tree_view_bin_draw (widget, cr);
5156 /* We can't just chain up to Container::draw as it will try to send the
5157 * event to the headers, so we handle propagating it to our children
5158 * (eg. widgets being edited) ourselves.
5160 tmp_list = tree_view->priv->children;
5163 GtkTreeViewChild *child = tmp_list->data;
5164 tmp_list = tmp_list->next;
5166 gtk_container_propagate_draw (GTK_CONTAINER (tree_view), child->widget, cr);
5170 if (gtk_cairo_should_draw_window (cr, tree_view->priv->header_window))
5174 for (list = tree_view->priv->columns; list != NULL; list = list->next)
5176 GtkTreeViewColumn *column = list->data;
5178 if (column == tree_view->priv->drag_column)
5181 if (gtk_tree_view_column_get_visible (column))
5182 gtk_container_propagate_draw (GTK_CONTAINER (tree_view),
5188 if (tree_view->priv->drag_window &&
5189 gtk_cairo_should_draw_window (cr, tree_view->priv->drag_window))
5191 gtk_container_propagate_draw (GTK_CONTAINER (tree_view),
5192 tree_view->priv->drag_column->button,
5207 /* returns 0x1 when no column has been found -- yes it's hackish */
5208 static GtkTreeViewColumn *
5209 gtk_tree_view_get_drop_column (GtkTreeView *tree_view,
5210 GtkTreeViewColumn *column,
5213 GtkTreeViewColumn *left_column = NULL;
5214 GtkTreeViewColumn *cur_column = NULL;
5217 if (!gtk_tree_view_column_get_reorderable (column))
5218 return (GtkTreeViewColumn *)0x1;
5220 switch (drop_position)
5223 /* find first column where we can drop */
5224 tmp_list = tree_view->priv->columns;
5225 if (column == GTK_TREE_VIEW_COLUMN (tmp_list->data))
5226 return (GtkTreeViewColumn *)0x1;
5230 g_assert (tmp_list);
5232 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5233 tmp_list = tmp_list->next;
5236 gtk_tree_view_column_get_visible (left_column) == FALSE)
5239 if (!tree_view->priv->column_drop_func)
5242 if (!tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5244 left_column = cur_column;
5251 if (!tree_view->priv->column_drop_func)
5254 if (tree_view->priv->column_drop_func (tree_view, column, left_column, NULL, tree_view->priv->column_drop_func_data))
5257 return (GtkTreeViewColumn *)0x1;
5261 /* find first column after column where we can drop */
5262 tmp_list = tree_view->priv->columns;
5264 for (; tmp_list; tmp_list = tmp_list->next)
5265 if (GTK_TREE_VIEW_COLUMN (tmp_list->data) == column)
5268 if (!tmp_list || !tmp_list->next)
5269 return (GtkTreeViewColumn *)0x1;
5271 tmp_list = tmp_list->next;
5272 left_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5273 tmp_list = tmp_list->next;
5277 g_assert (tmp_list);
5279 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5280 tmp_list = tmp_list->next;
5283 gtk_tree_view_column_get_visible (left_column) == FALSE)
5285 left_column = cur_column;
5287 tmp_list = tmp_list->next;
5291 if (!tree_view->priv->column_drop_func)
5294 if (!tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5296 left_column = cur_column;
5303 if (!tree_view->priv->column_drop_func)
5306 if (tree_view->priv->column_drop_func (tree_view, column, left_column, NULL, tree_view->priv->column_drop_func_data))
5309 return (GtkTreeViewColumn *)0x1;
5313 /* find first column before column where we can drop */
5314 tmp_list = tree_view->priv->columns;
5316 for (; tmp_list; tmp_list = tmp_list->next)
5317 if (GTK_TREE_VIEW_COLUMN (tmp_list->data) == column)
5320 if (!tmp_list || !tmp_list->prev)
5321 return (GtkTreeViewColumn *)0x1;
5323 tmp_list = tmp_list->prev;
5324 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5325 tmp_list = tmp_list->prev;
5329 g_assert (tmp_list);
5331 left_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5334 gtk_tree_view_column_get_visible (left_column) == FALSE)
5336 /*if (!tmp_list->prev)
5337 return (GtkTreeViewColumn *)0x1;
5340 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->prev->data);
5341 tmp_list = tmp_list->prev->prev;
5344 cur_column = left_column;
5346 tmp_list = tmp_list->prev;
5350 if (!tree_view->priv->column_drop_func)
5353 if (tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5356 cur_column = left_column;
5357 tmp_list = tmp_list->prev;
5360 if (!tree_view->priv->column_drop_func)
5363 if (tree_view->priv->column_drop_func (tree_view, column, NULL, cur_column, tree_view->priv->column_drop_func_data))
5366 return (GtkTreeViewColumn *)0x1;
5370 /* same as DROP_HOME case, but doing it backwards */
5371 tmp_list = g_list_last (tree_view->priv->columns);
5374 if (column == GTK_TREE_VIEW_COLUMN (tmp_list->data))
5375 return (GtkTreeViewColumn *)0x1;
5379 g_assert (tmp_list);
5381 left_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
5384 gtk_tree_view_column_get_visible (left_column) == FALSE)
5386 cur_column = left_column;
5387 tmp_list = tmp_list->prev;
5390 if (!tree_view->priv->column_drop_func)
5393 if (tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
5396 cur_column = left_column;
5397 tmp_list = tmp_list->prev;
5400 if (!tree_view->priv->column_drop_func)
5403 if (tree_view->priv->column_drop_func (tree_view, column, NULL, cur_column, tree_view->priv->column_drop_func_data))
5406 return (GtkTreeViewColumn *)0x1;
5410 return (GtkTreeViewColumn *)0x1;
5414 gtk_tree_view_key_press (GtkWidget *widget,
5417 GtkTreeView *tree_view = (GtkTreeView *) widget;
5419 if (tree_view->priv->rubber_band_status)
5421 if (event->keyval == GDK_KEY_Escape)
5422 gtk_tree_view_stop_rubber_band (tree_view);
5427 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG))
5429 if (event->keyval == GDK_KEY_Escape)
5431 tree_view->priv->cur_reorder = NULL;
5432 gtk_tree_view_button_release_drag_column (widget, NULL);
5437 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
5439 GList *focus_column;
5442 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
5444 for (focus_column = tree_view->priv->columns;
5446 focus_column = focus_column->next)
5448 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (focus_column->data);
5450 if (gtk_widget_has_focus (column->button))
5455 (event->state & GDK_SHIFT_MASK) && (event->state & GDK_MOD1_MASK) &&
5456 (event->keyval == GDK_KEY_Left || event->keyval == GDK_KEY_KP_Left
5457 || event->keyval == GDK_KEY_Right || event->keyval == GDK_KEY_KP_Right))
5459 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (focus_column->data);
5460 gint max_width, min_width;
5462 if (!gtk_tree_view_column_get_resizable (column))
5464 gtk_widget_error_bell (widget);
5468 if (event->keyval == (rtl ? GDK_KEY_Right : GDK_KEY_Left)
5469 || event->keyval == (rtl ? GDK_KEY_KP_Right : GDK_KEY_KP_Left))
5471 GtkRequisition button_req;
5472 gint old_width = column->resized_width;
5474 gtk_widget_get_preferred_size (column->button, &button_req, NULL);
5476 column->resized_width = MAX (column->resized_width,
5477 gtk_tree_view_column_get_width (column));
5478 column->resized_width -= 2;
5479 if (column->resized_width < 0)
5480 column->resized_width = 0;
5482 min_width = gtk_tree_view_column_get_min_width (column);
5483 if (min_width == -1)
5484 column->resized_width = MAX (button_req.width,
5485 column->resized_width);
5488 column->resized_width = MAX (min_width,
5489 column->resized_width);
5492 max_width = gtk_tree_view_column_get_max_width (column);
5493 if (max_width != -1)
5494 column->resized_width = MIN (column->resized_width, max_width);
5496 column->use_resized_width = TRUE;
5498 if (column->resized_width != old_width)
5499 gtk_widget_queue_resize (widget);
5501 gtk_widget_error_bell (widget);
5503 else if (event->keyval == (rtl ? GDK_KEY_Left : GDK_KEY_Right)
5504 || event->keyval == (rtl ? GDK_KEY_KP_Left : GDK_KEY_KP_Right))
5506 gint old_width = column->resized_width;
5508 column->resized_width = MAX (column->resized_width,
5509 gtk_tree_view_column_get_width (column));
5510 column->resized_width += 2;
5512 max_width = gtk_tree_view_column_get_max_width (column);
5513 if (max_width != -1)
5514 column->resized_width = MIN (column->resized_width, max_width);
5516 column->use_resized_width = TRUE;
5518 if (column->resized_width != old_width)
5519 gtk_widget_queue_resize (widget);
5521 gtk_widget_error_bell (widget);
5528 (event->state & GDK_MOD1_MASK) &&
5529 (event->keyval == GDK_KEY_Left || event->keyval == GDK_KEY_KP_Left
5530 || event->keyval == GDK_KEY_Right || event->keyval == GDK_KEY_KP_Right
5531 || event->keyval == GDK_KEY_Home || event->keyval == GDK_KEY_KP_Home
5532 || event->keyval == GDK_KEY_End || event->keyval == GDK_KEY_KP_End))
5534 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (focus_column->data);
5536 if (event->keyval == (rtl ? GDK_KEY_Right : GDK_KEY_Left)
5537 || event->keyval == (rtl ? GDK_KEY_KP_Right : GDK_KEY_KP_Left))
5539 GtkTreeViewColumn *col;
5540 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_LEFT);
5541 if (col != (GtkTreeViewColumn *)0x1)
5542 gtk_tree_view_move_column_after (tree_view, column, col);
5544 gtk_widget_error_bell (widget);
5546 else if (event->keyval == (rtl ? GDK_KEY_Left : GDK_KEY_Right)
5547 || event->keyval == (rtl ? GDK_KEY_KP_Left : GDK_KEY_KP_Right))
5549 GtkTreeViewColumn *col;
5550 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_RIGHT);
5551 if (col != (GtkTreeViewColumn *)0x1)
5552 gtk_tree_view_move_column_after (tree_view, column, col);
5554 gtk_widget_error_bell (widget);
5556 else if (event->keyval == GDK_KEY_Home || event->keyval == GDK_KEY_KP_Home)
5558 GtkTreeViewColumn *col;
5559 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_HOME);
5560 if (col != (GtkTreeViewColumn *)0x1)
5561 gtk_tree_view_move_column_after (tree_view, column, col);
5563 gtk_widget_error_bell (widget);
5565 else if (event->keyval == GDK_KEY_End || event->keyval == GDK_KEY_KP_End)
5567 GtkTreeViewColumn *col;
5568 col = gtk_tree_view_get_drop_column (tree_view, column, DROP_END);
5569 if (col != (GtkTreeViewColumn *)0x1)
5570 gtk_tree_view_move_column_after (tree_view, column, col);
5572 gtk_widget_error_bell (widget);
5579 /* Chain up to the parent class. It handles the keybindings. */
5580 if (GTK_WIDGET_CLASS (gtk_tree_view_parent_class)->key_press_event (widget, event))
5583 if (tree_view->priv->search_entry_avoid_unhandled_binding)
5585 tree_view->priv->search_entry_avoid_unhandled_binding = FALSE;
5589 /* We pass the event to the search_entry. If its text changes, then we start
5590 * the typeahead find capabilities. */
5591 if (gtk_widget_has_focus (GTK_WIDGET (tree_view))
5592 && tree_view->priv->enable_search
5593 && !tree_view->priv->search_custom_entry_set)
5595 GdkEvent *new_event;
5597 const char *new_text;
5600 gboolean text_modified;
5601 gulong popup_menu_id;
5603 gtk_tree_view_ensure_interactive_directory (tree_view);
5605 /* Make a copy of the current text */
5606 old_text = g_strdup (gtk_entry_get_text (GTK_ENTRY (tree_view->priv->search_entry)));
5607 new_event = gdk_event_copy ((GdkEvent *) event);
5608 g_object_unref (((GdkEventKey *) new_event)->window);
5609 ((GdkEventKey *) new_event)->window = g_object_ref (gtk_widget_get_window (tree_view->priv->search_window));
5610 gtk_widget_realize (tree_view->priv->search_window);
5612 popup_menu_id = g_signal_connect (tree_view->priv->search_entry,
5613 "popup-menu", G_CALLBACK (gtk_true),
5616 /* Move the entry off screen */
5617 screen = gtk_widget_get_screen (GTK_WIDGET (tree_view));
5618 gtk_window_move (GTK_WINDOW (tree_view->priv->search_window),
5619 gdk_screen_get_width (screen) + 1,
5620 gdk_screen_get_height (screen) + 1);
5621 gtk_widget_show (tree_view->priv->search_window);
5623 /* Send the event to the window. If the preedit_changed signal is emitted
5624 * during this event, we will set priv->imcontext_changed */
5625 tree_view->priv->imcontext_changed = FALSE;
5626 retval = gtk_widget_event (tree_view->priv->search_window, new_event);
5627 gdk_event_free (new_event);
5628 gtk_widget_hide (tree_view->priv->search_window);
5630 g_signal_handler_disconnect (tree_view->priv->search_entry,
5633 /* We check to make sure that the entry tried to handle the text, and that
5634 * the text has changed.
5636 new_text = gtk_entry_get_text (GTK_ENTRY (tree_view->priv->search_entry));
5637 text_modified = strcmp (old_text, new_text) != 0;
5639 if (tree_view->priv->imcontext_changed || /* we're in a preedit */
5640 (retval && text_modified)) /* ...or the text was modified */
5642 if (gtk_tree_view_real_start_interactive_search (tree_view,
5643 gdk_event_get_device ((GdkEvent *) event),
5646 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
5651 gtk_entry_set_text (GTK_ENTRY (tree_view->priv->search_entry), "");
5661 gtk_tree_view_key_release (GtkWidget *widget,
5664 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
5666 if (tree_view->priv->rubber_band_status)
5669 return GTK_WIDGET_CLASS (gtk_tree_view_parent_class)->key_release_event (widget, event);
5672 /* FIXME Is this function necessary? Can I get an enter_notify event
5673 * w/o either an expose event or a mouse motion event?
5676 gtk_tree_view_enter_notify (GtkWidget *widget,
5677 GdkEventCrossing *event)
5679 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
5684 /* Sanity check it */
5685 if (event->window != tree_view->priv->bin_window)
5688 if (tree_view->priv->tree == NULL)
5691 if (event->mode == GDK_CROSSING_GRAB ||
5692 event->mode == GDK_CROSSING_GTK_GRAB ||
5693 event->mode == GDK_CROSSING_GTK_UNGRAB ||
5694 event->mode == GDK_CROSSING_STATE_CHANGED)
5697 /* find the node internally */
5698 new_y = TREE_WINDOW_Y_TO_RBTREE_Y(tree_view, event->y);
5701 _gtk_rbtree_find_offset (tree_view->priv->tree, new_y, &tree, &node);
5703 tree_view->priv->event_last_x = event->x;
5704 tree_view->priv->event_last_y = event->y;
5706 if ((tree_view->priv->button_pressed_node == NULL) ||
5707 (tree_view->priv->button_pressed_node == node))
5708 prelight_or_select (tree_view, tree, node, event->x, event->y);
5714 gtk_tree_view_leave_notify (GtkWidget *widget,
5715 GdkEventCrossing *event)
5717 GtkTreeView *tree_view;
5719 if (event->mode == GDK_CROSSING_GRAB)
5722 tree_view = GTK_TREE_VIEW (widget);
5724 if (tree_view->priv->prelight_node)
5725 _gtk_tree_view_queue_draw_node (tree_view,
5726 tree_view->priv->prelight_tree,
5727 tree_view->priv->prelight_node,
5730 tree_view->priv->event_last_x = -10000;
5731 tree_view->priv->event_last_y = -10000;
5733 prelight_or_select (tree_view,
5735 -1000, -1000); /* coords not possibly over an arrow */
5742 gtk_tree_view_focus_out (GtkWidget *widget,
5743 GdkEventFocus *event)
5745 GtkTreeView *tree_view;
5747 tree_view = GTK_TREE_VIEW (widget);
5749 gtk_widget_queue_draw (widget);
5751 /* destroy interactive search dialog */
5752 if (tree_view->priv->search_window)
5753 gtk_tree_view_search_dialog_hide (tree_view->priv->search_window, tree_view,
5754 gdk_event_get_device ((GdkEvent *) event));
5760 /* Incremental Reflow
5764 gtk_tree_view_node_queue_redraw (GtkTreeView *tree_view,
5768 GtkAllocation allocation;
5771 y = _gtk_rbtree_node_find_offset (tree, node)
5772 - tree_view->priv->vadjustment->value
5773 + TREE_VIEW_HEADER_HEIGHT (tree_view);
5775 gtk_widget_get_allocation (GTK_WIDGET (tree_view), &allocation);
5776 gtk_widget_queue_draw_area (GTK_WIDGET (tree_view),
5779 GTK_RBNODE_GET_HEIGHT (node));
5783 node_is_visible (GtkTreeView *tree_view,
5790 y = _gtk_rbtree_node_find_offset (tree, node);
5791 height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
5793 if (y >= tree_view->priv->vadjustment->value &&
5794 y + height <= (tree_view->priv->vadjustment->value
5795 + tree_view->priv->vadjustment->page_size))
5801 /* Returns TRUE if it updated the size
5804 validate_row (GtkTreeView *tree_view,
5810 GtkTreeViewColumn *column;
5811 GList *list, *first_column, *last_column;
5813 gint horizontal_separator;
5814 gint vertical_separator;
5815 gint focus_line_width;
5816 gint depth = gtk_tree_path_get_depth (path);
5817 gboolean retval = FALSE;
5818 gboolean is_separator = FALSE;
5819 gboolean draw_vgrid_lines, draw_hgrid_lines;
5821 gint grid_line_width;
5822 gboolean wide_separators;
5823 gint separator_height;
5825 /* double check the row needs validating */
5826 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) &&
5827 ! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
5830 is_separator = row_is_separator (tree_view, iter, NULL);
5832 gtk_widget_style_get (GTK_WIDGET (tree_view),
5833 "focus-padding", &focus_pad,
5834 "focus-line-width", &focus_line_width,
5835 "horizontal-separator", &horizontal_separator,
5836 "vertical-separator", &vertical_separator,
5837 "grid-line-width", &grid_line_width,
5838 "wide-separators", &wide_separators,
5839 "separator-height", &separator_height,
5843 tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_VERTICAL
5844 || tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_BOTH;
5846 tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_HORIZONTAL
5847 || tree_view->priv->grid_lines == GTK_TREE_VIEW_GRID_LINES_BOTH;
5849 for (last_column = g_list_last (tree_view->priv->columns);
5851 !(gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (last_column->data)));
5852 last_column = last_column->prev)
5855 for (first_column = g_list_first (tree_view->priv->columns);
5857 !(gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (first_column->data)));
5858 first_column = first_column->next)
5861 for (list = tree_view->priv->columns; list; list = list->next)
5866 column = list->data;
5868 if (!gtk_tree_view_column_get_visible (column))
5871 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID) && !column->dirty)
5874 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, iter,
5875 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
5876 node->children?TRUE:FALSE);
5877 gtk_tree_view_column_cell_get_size (column,
5879 &tmp_width, &tmp_height);
5883 tmp_height += vertical_separator;
5884 height = MAX (height, tmp_height);
5885 height = MAX (height, tree_view->priv->expander_size);
5889 if (wide_separators)
5890 height = separator_height + 2 * focus_pad;
5892 height = 2 + 2 * focus_pad;
5895 if (gtk_tree_view_is_expander_column (tree_view, column))
5897 tmp_width = tmp_width + horizontal_separator + (depth - 1) * tree_view->priv->level_indentation;
5899 if (TREE_VIEW_DRAW_EXPANDERS (tree_view))
5900 tmp_width += depth * tree_view->priv->expander_size;
5903 tmp_width = tmp_width + horizontal_separator;
5905 if (draw_vgrid_lines)
5907 if (list->data == first_column || list->data == last_column)
5908 tmp_width += grid_line_width / 2.0;
5910 tmp_width += grid_line_width;
5913 if (tmp_width > column->requested_width)
5916 column->requested_width = tmp_width;
5920 if (draw_hgrid_lines)
5921 height += grid_line_width;
5923 if (height != GTK_RBNODE_GET_HEIGHT (node))
5926 _gtk_rbtree_node_set_height (tree, node, height);
5928 _gtk_rbtree_node_mark_valid (tree, node);
5929 tree_view->priv->post_validation_flag = TRUE;
5936 validate_visible_area (GtkTreeView *tree_view)
5938 GtkAllocation allocation;
5939 GtkTreePath *path = NULL;
5940 GtkTreePath *above_path = NULL;
5942 GtkRBTree *tree = NULL;
5943 GtkRBNode *node = NULL;
5944 gboolean need_redraw = FALSE;
5945 gboolean size_changed = FALSE;
5947 gint area_above = 0;
5948 gint area_below = 0;
5950 if (tree_view->priv->tree == NULL)
5953 if (! GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID) &&
5954 tree_view->priv->scroll_to_path == NULL)
5957 gtk_widget_get_allocation (GTK_WIDGET (tree_view), &allocation);
5958 total_height = allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
5960 if (total_height == 0)
5963 /* First, we check to see if we need to scroll anywhere
5965 if (tree_view->priv->scroll_to_path)
5967 path = gtk_tree_row_reference_get_path (tree_view->priv->scroll_to_path);
5968 if (path && !_gtk_tree_view_find_node (tree_view, path, &tree, &node))
5970 /* we are going to scroll, and will update dy */
5971 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
5972 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
5973 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
5975 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
5976 if (validate_row (tree_view, tree, node, &iter, path))
5977 size_changed = TRUE;
5980 if (tree_view->priv->scroll_to_use_align)
5982 gint height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
5983 area_above = (total_height - height) *
5984 tree_view->priv->scroll_to_row_align;
5985 area_below = total_height - area_above - height;
5986 area_above = MAX (area_above, 0);
5987 area_below = MAX (area_below, 0);
5992 * 1) row not visible
5996 gint height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
5998 dy = _gtk_rbtree_node_find_offset (tree, node);
6000 if (dy >= tree_view->priv->vadjustment->value &&
6001 dy + height <= (tree_view->priv->vadjustment->value
6002 + tree_view->priv->vadjustment->page_size))
6004 /* row visible: keep the row at the same position */
6005 area_above = dy - tree_view->priv->vadjustment->value;
6006 area_below = (tree_view->priv->vadjustment->value +
6007 tree_view->priv->vadjustment->page_size)
6012 /* row not visible */
6014 && dy + height <= tree_view->priv->vadjustment->page_size)
6016 /* row at the beginning -- fixed */
6018 area_below = tree_view->priv->vadjustment->page_size
6019 - area_above - height;
6021 else if (dy >= (tree_view->priv->vadjustment->upper -
6022 tree_view->priv->vadjustment->page_size))
6024 /* row at the end -- fixed */
6025 area_above = dy - (tree_view->priv->vadjustment->upper -
6026 tree_view->priv->vadjustment->page_size);
6027 area_below = tree_view->priv->vadjustment->page_size -
6028 area_above - height;
6032 area_above = tree_view->priv->vadjustment->page_size - height;
6038 /* row somewhere in the middle, bring it to the top
6042 area_below = total_height - height;
6048 /* the scroll to isn't valid; ignore it.
6051 if (tree_view->priv->scroll_to_path && !path)
6053 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
6054 tree_view->priv->scroll_to_path = NULL;
6057 gtk_tree_path_free (path);
6062 /* We didn't have a scroll_to set, so we just handle things normally
6068 offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
6069 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, 0),
6073 /* In this case, nothing has been validated */
6074 path = gtk_tree_path_new_first ();
6075 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
6079 path = _gtk_tree_view_find_path (tree_view, tree, node);
6080 total_height += offset;
6083 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
6085 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
6086 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
6088 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
6089 if (validate_row (tree_view, tree, node, &iter, path))
6090 size_changed = TRUE;
6093 area_below = total_height - ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
6096 above_path = gtk_tree_path_copy (path);
6098 /* if we do not validate any row above the new top_row, we will make sure
6099 * that the row immediately above top_row has been validated. (if we do not
6100 * do this, _gtk_rbtree_find_offset will find the row above top_row, because
6101 * when invalidated that row's height will be zero. and this will mess up
6104 if (area_above == 0)
6109 _gtk_tree_view_find_node (tree_view, above_path, &tmptree, &tmpnode);
6110 _gtk_rbtree_prev_full (tmptree, tmpnode, &tmptree, &tmpnode);
6114 GtkTreePath *tmppath;
6115 GtkTreeIter tmpiter;
6117 tmppath = _gtk_tree_view_find_path (tree_view, tmptree, tmpnode);
6118 gtk_tree_model_get_iter (tree_view->priv->model, &tmpiter, tmppath);
6120 if (GTK_RBNODE_FLAG_SET (tmpnode, GTK_RBNODE_INVALID) ||
6121 GTK_RBNODE_FLAG_SET (tmpnode, GTK_RBNODE_COLUMN_INVALID))
6123 _gtk_tree_view_queue_draw_node (tree_view, tmptree, tmpnode, NULL);
6124 if (validate_row (tree_view, tmptree, tmpnode, &tmpiter, tmppath))
6125 size_changed = TRUE;
6128 gtk_tree_path_free (tmppath);
6132 /* Now, we walk forwards and backwards, measuring rows. Unfortunately,
6133 * backwards is much slower then forward, as there is no iter_prev function.
6134 * We go forwards first in case we run out of tree. Then we go backwards to
6137 while (node && area_below > 0)
6141 GtkTreeIter parent = iter;
6144 tree = node->children;
6147 g_assert (node != tree->nil);
6149 while (node->left != tree->nil)
6151 has_child = gtk_tree_model_iter_children (tree_view->priv->model,
6154 TREE_VIEW_INTERNAL_ASSERT_VOID (has_child);
6155 gtk_tree_path_down (path);
6159 gboolean done = FALSE;
6162 node = _gtk_rbtree_next (tree, node);
6165 gboolean has_next = gtk_tree_model_iter_next (tree_view->priv->model, &iter);
6167 gtk_tree_path_next (path);
6170 TREE_VIEW_INTERNAL_ASSERT_VOID (has_next);
6174 GtkTreeIter parent_iter = iter;
6175 gboolean has_parent;
6177 node = tree->parent_node;
6178 tree = tree->parent_tree;
6181 has_parent = gtk_tree_model_iter_parent (tree_view->priv->model,
6184 gtk_tree_path_up (path);
6187 TREE_VIEW_INTERNAL_ASSERT_VOID (has_parent);
6196 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
6197 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
6199 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
6200 if (validate_row (tree_view, tree, node, &iter, path))
6201 size_changed = TRUE;
6204 area_below -= ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
6206 gtk_tree_path_free (path);
6208 /* If we ran out of tree, and have extra area_below left, we need to add it
6211 area_above += area_below;
6213 _gtk_tree_view_find_node (tree_view, above_path, &tree, &node);
6215 /* We walk backwards */
6216 while (area_above > 0)
6218 _gtk_rbtree_prev_full (tree, node, &tree, &node);
6220 /* Always find the new path in the tree. We cannot just assume
6221 * a gtk_tree_path_prev() is enough here, as there might be children
6222 * in between this node and the previous sibling node. If this
6223 * appears to be a performance hotspot in profiles, we can look into
6224 * intrigate logic for keeping path, node and iter in sync like
6225 * we do for forward walks. (Which will be hard because of the lacking
6232 gtk_tree_path_free (above_path);
6233 above_path = _gtk_tree_view_find_path (tree_view, tree, node);
6235 gtk_tree_model_get_iter (tree_view->priv->model, &iter, above_path);
6237 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
6238 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
6240 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
6241 if (validate_row (tree_view, tree, node, &iter, above_path))
6242 size_changed = TRUE;
6244 area_above -= ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
6247 /* if we scrolled to a path, we need to set the dy here,
6248 * and sync the top row accordingly
6250 if (tree_view->priv->scroll_to_path)
6252 gtk_tree_view_set_top_row (tree_view, above_path, -area_above);
6253 gtk_tree_view_top_row_to_dy (tree_view);
6257 else if (tree_view->priv->height <= tree_view->priv->vadjustment->page_size)
6259 /* when we are not scrolling, we should never set dy to something
6260 * else than zero. we update top_row to be in sync with dy = 0.
6262 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment), 0);
6263 gtk_tree_view_dy_to_top_row (tree_view);
6265 else if (tree_view->priv->vadjustment->value + tree_view->priv->vadjustment->page_size > tree_view->priv->height)
6267 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment), tree_view->priv->height - tree_view->priv->vadjustment->page_size);
6268 gtk_tree_view_dy_to_top_row (tree_view);
6271 gtk_tree_view_top_row_to_dy (tree_view);
6273 /* update width/height and queue a resize */
6276 GtkRequisition requisition;
6278 /* We temporarily guess a size, under the assumption that it will be the
6279 * same when we get our next size_allocate. If we don't do this, we'll be
6280 * in an inconsistent state if we call top_row_to_dy. */
6282 gtk_widget_get_preferred_size (GTK_WIDGET (tree_view),
6283 &requisition, NULL);
6284 tree_view->priv->hadjustment->upper = MAX (tree_view->priv->hadjustment->upper, (gfloat)requisition.width);
6285 tree_view->priv->vadjustment->upper = MAX (tree_view->priv->vadjustment->upper, (gfloat)requisition.height);
6286 gtk_adjustment_changed (tree_view->priv->hadjustment);
6287 gtk_adjustment_changed (tree_view->priv->vadjustment);
6288 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6291 if (tree_view->priv->scroll_to_path)
6293 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
6294 tree_view->priv->scroll_to_path = NULL;
6298 gtk_tree_path_free (above_path);
6300 if (tree_view->priv->scroll_to_column)
6302 tree_view->priv->scroll_to_column = NULL;
6305 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
6309 initialize_fixed_height_mode (GtkTreeView *tree_view)
6311 if (!tree_view->priv->tree)
6314 if (tree_view->priv->fixed_height < 0)
6319 GtkRBTree *tree = NULL;
6320 GtkRBNode *node = NULL;
6322 tree = tree_view->priv->tree;
6325 path = _gtk_tree_view_find_path (tree_view, tree, node);
6326 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
6328 validate_row (tree_view, tree, node, &iter, path);
6330 gtk_tree_path_free (path);
6332 tree_view->priv->fixed_height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
6335 _gtk_rbtree_set_fixed_height (tree_view->priv->tree,
6336 tree_view->priv->fixed_height, TRUE);
6339 /* Our strategy for finding nodes to validate is a little convoluted. We find
6340 * the left-most uninvalidated node. We then try walking right, validating
6341 * nodes. Once we find a valid node, we repeat the previous process of finding
6342 * the first invalid node.
6346 do_validate_rows (GtkTreeView *tree_view, gboolean queue_resize)
6348 GtkRBTree *tree = NULL;
6349 GtkRBNode *node = NULL;
6350 gboolean validated_area = FALSE;
6352 GtkTreePath *path = NULL;
6357 gint prev_height = -1;
6358 gboolean fixed_height = TRUE;
6360 g_assert (tree_view);
6362 if (tree_view->priv->tree == NULL)
6365 if (tree_view->priv->fixed_height_mode)
6367 if (tree_view->priv->fixed_height < 0)
6368 initialize_fixed_height_mode (tree_view);
6373 timer = g_timer_new ();
6374 g_timer_start (timer);
6378 if (! GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID))
6386 node = _gtk_rbtree_next (tree, node);
6389 TREE_VIEW_INTERNAL_ASSERT (gtk_tree_model_iter_next (tree_view->priv->model, &iter), FALSE);
6390 gtk_tree_path_next (path);
6394 gtk_tree_path_free (path);
6401 tree = tree_view->priv->tree;
6402 node = tree_view->priv->tree->root;
6404 g_assert (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_DESCENDANTS_INVALID));
6408 if (node->left != tree->nil &&
6409 GTK_RBNODE_FLAG_SET (node->left, GTK_RBNODE_DESCENDANTS_INVALID))
6413 else if (node->right != tree->nil &&
6414 GTK_RBNODE_FLAG_SET (node->right, GTK_RBNODE_DESCENDANTS_INVALID))
6418 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
6419 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))
6423 else if (node->children != NULL)
6425 tree = node->children;
6429 /* RBTree corruption! All bad */
6430 g_assert_not_reached ();
6433 path = _gtk_tree_view_find_path (tree_view, tree, node);
6434 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
6437 validated_area = validate_row (tree_view, tree, node, &iter, path) ||
6440 if (!tree_view->priv->fixed_height_check)
6444 height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
6445 if (prev_height < 0)
6446 prev_height = height;
6447 else if (prev_height != height)
6448 fixed_height = FALSE;
6453 while (g_timer_elapsed (timer, NULL) < GTK_TREE_VIEW_TIME_MS_PER_IDLE / 1000.);
6455 if (!tree_view->priv->fixed_height_check)
6458 _gtk_rbtree_set_fixed_height (tree_view->priv->tree, prev_height, FALSE);
6460 tree_view->priv->fixed_height_check = 1;
6466 GtkRequisition requisition;
6468 /* We temporarily guess a size, under the assumption that it will be the
6469 * same when we get our next size_allocate. If we don't do this, we'll be
6470 * in an inconsistent state when we call top_row_to_dy. */
6472 /* FIXME: This is called from size_request, for some reason it is not infinitely
6473 * recursing, we cannot call gtk_widget_get_preferred_size() here because that's
6474 * not allowed (from inside ->get_preferred_width/height() implementations, one
6475 * should call the vfuncs directly). However what is desired here is the full
6476 * size including any margins and limited by any alignment (i.e. after
6477 * GtkWidget:adjust_size_request() is called).
6479 * Currently bypassing this but the real solution is to not update the scroll adjustments
6480 * untill we've recieved an allocation (never update scroll adjustments from size-requests).
6482 gtk_tree_view_size_request (GTK_WIDGET (tree_view), &requisition);
6484 tree_view->priv->hadjustment->upper = MAX (tree_view->priv->hadjustment->upper, (gfloat)requisition.width);
6485 tree_view->priv->vadjustment->upper = MAX (tree_view->priv->vadjustment->upper, (gfloat)requisition.height);
6486 gtk_adjustment_changed (tree_view->priv->hadjustment);
6487 gtk_adjustment_changed (tree_view->priv->vadjustment);
6490 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6493 if (path) gtk_tree_path_free (path);
6494 g_timer_destroy (timer);
6500 validate_rows (GtkTreeView *tree_view)
6504 retval = do_validate_rows (tree_view, TRUE);
6506 if (! retval && tree_view->priv->validate_rows_timer)
6508 g_source_remove (tree_view->priv->validate_rows_timer);
6509 tree_view->priv->validate_rows_timer = 0;
6516 validate_rows_handler (GtkTreeView *tree_view)
6520 retval = do_validate_rows (tree_view, TRUE);
6521 if (! retval && tree_view->priv->validate_rows_timer)
6523 g_source_remove (tree_view->priv->validate_rows_timer);
6524 tree_view->priv->validate_rows_timer = 0;
6531 do_presize_handler (GtkTreeView *tree_view)
6533 if (tree_view->priv->mark_rows_col_dirty)
6535 if (tree_view->priv->tree)
6536 _gtk_rbtree_column_invalid (tree_view->priv->tree);
6537 tree_view->priv->mark_rows_col_dirty = FALSE;
6539 validate_visible_area (tree_view);
6540 tree_view->priv->presize_handler_timer = 0;
6542 if (tree_view->priv->fixed_height_mode)
6544 GtkRequisition requisition;
6546 gtk_widget_get_preferred_size (GTK_WIDGET (tree_view),
6547 &requisition, NULL);
6549 tree_view->priv->hadjustment->upper = MAX (tree_view->priv->hadjustment->upper, (gfloat)requisition.width);
6550 tree_view->priv->vadjustment->upper = MAX (tree_view->priv->vadjustment->upper, (gfloat)requisition.height);
6551 gtk_adjustment_changed (tree_view->priv->hadjustment);
6552 gtk_adjustment_changed (tree_view->priv->vadjustment);
6553 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6560 presize_handler_callback (gpointer data)
6562 do_presize_handler (GTK_TREE_VIEW (data));
6568 install_presize_handler (GtkTreeView *tree_view)
6570 if (! gtk_widget_get_realized (GTK_WIDGET (tree_view)))
6573 if (! tree_view->priv->presize_handler_timer)
6575 tree_view->priv->presize_handler_timer =
6576 gdk_threads_add_idle_full (GTK_PRIORITY_RESIZE - 2, presize_handler_callback, tree_view, NULL);
6578 if (! tree_view->priv->validate_rows_timer)
6580 tree_view->priv->validate_rows_timer =
6581 gdk_threads_add_idle_full (GTK_TREE_VIEW_PRIORITY_VALIDATE, (GSourceFunc) validate_rows_handler, tree_view, NULL);
6586 gtk_tree_view_bin_process_updates (GtkTreeView *tree_view)
6588 /* Prior to drawing, we make sure the visible area is validated. */
6589 if (tree_view->priv->presize_handler_timer)
6591 g_source_remove (tree_view->priv->presize_handler_timer);
6592 tree_view->priv->presize_handler_timer = 0;
6594 do_presize_handler (tree_view);
6597 gdk_window_process_updates (tree_view->priv->bin_window, TRUE);
6601 scroll_sync_handler (GtkTreeView *tree_view)
6603 if (tree_view->priv->height <= tree_view->priv->vadjustment->page_size)
6604 gtk_adjustment_set_value (GTK_ADJUSTMENT (tree_view->priv->vadjustment), 0);
6605 else if (gtk_tree_row_reference_valid (tree_view->priv->top_row))
6606 gtk_tree_view_top_row_to_dy (tree_view);
6608 gtk_tree_view_dy_to_top_row (tree_view);
6610 tree_view->priv->scroll_sync_timer = 0;
6616 install_scroll_sync_handler (GtkTreeView *tree_view)
6618 if (!gtk_widget_get_realized (GTK_WIDGET (tree_view)))
6621 if (!tree_view->priv->scroll_sync_timer)
6623 tree_view->priv->scroll_sync_timer =
6624 gdk_threads_add_idle_full (GTK_TREE_VIEW_PRIORITY_SCROLL_SYNC, (GSourceFunc) scroll_sync_handler, tree_view, NULL);
6629 gtk_tree_view_set_top_row (GtkTreeView *tree_view,
6633 gtk_tree_row_reference_free (tree_view->priv->top_row);
6637 tree_view->priv->top_row = NULL;
6638 tree_view->priv->top_row_dy = 0;
6642 tree_view->priv->top_row = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
6643 tree_view->priv->top_row_dy = offset;
6647 /* Always call this iff dy is in the visible range. If the tree is empty, then
6648 * it's set to be NULL, and top_row_dy is 0;
6651 gtk_tree_view_dy_to_top_row (GtkTreeView *tree_view)
6658 if (tree_view->priv->tree == NULL)
6660 gtk_tree_view_set_top_row (tree_view, NULL, 0);
6664 offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
6665 tree_view->priv->dy,
6670 gtk_tree_view_set_top_row (tree_view, NULL, 0);
6674 path = _gtk_tree_view_find_path (tree_view, tree, node);
6675 gtk_tree_view_set_top_row (tree_view, path, offset);
6676 gtk_tree_path_free (path);
6682 gtk_tree_view_top_row_to_dy (GtkTreeView *tree_view)
6689 /* Avoid recursive calls */
6690 if (tree_view->priv->in_top_row_to_dy)
6693 if (tree_view->priv->top_row)
6694 path = gtk_tree_row_reference_get_path (tree_view->priv->top_row);
6701 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
6704 gtk_tree_path_free (path);
6708 /* keep dy and set new toprow */
6709 gtk_tree_row_reference_free (tree_view->priv->top_row);
6710 tree_view->priv->top_row = NULL;
6711 tree_view->priv->top_row_dy = 0;
6712 /* DO NOT install the idle handler */
6713 gtk_tree_view_dy_to_top_row (tree_view);
6717 if (ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node))
6718 < tree_view->priv->top_row_dy)
6720 /* new top row -- do NOT install the idle handler */
6721 gtk_tree_view_dy_to_top_row (tree_view);
6725 new_dy = _gtk_rbtree_node_find_offset (tree, node);
6726 new_dy += tree_view->priv->top_row_dy;
6728 if (new_dy + tree_view->priv->vadjustment->page_size > tree_view->priv->height)
6729 new_dy = tree_view->priv->height - tree_view->priv->vadjustment->page_size;
6731 new_dy = MAX (0, new_dy);
6733 tree_view->priv->in_top_row_to_dy = TRUE;
6734 gtk_adjustment_set_value (tree_view->priv->vadjustment, (gdouble)new_dy);
6735 tree_view->priv->in_top_row_to_dy = FALSE;
6740 _gtk_tree_view_install_mark_rows_col_dirty (GtkTreeView *tree_view)
6742 tree_view->priv->mark_rows_col_dirty = TRUE;
6744 install_presize_handler (tree_view);
6748 * This function works synchronously (due to the while (validate_rows...)
6751 * There was a check for column_type != GTK_TREE_VIEW_COLUMN_AUTOSIZE
6752 * here. You now need to check that yourself.
6755 _gtk_tree_view_column_autosize (GtkTreeView *tree_view,
6756 GtkTreeViewColumn *column)
6758 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
6759 g_return_if_fail (GTK_IS_TREE_VIEW_COLUMN (column));
6761 _gtk_tree_view_column_cell_set_dirty (column, FALSE);
6763 do_presize_handler (tree_view);
6764 while (validate_rows (tree_view));
6766 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
6772 set_source_row (GdkDragContext *context,
6773 GtkTreeModel *model,
6774 GtkTreePath *source_row)
6776 g_object_set_data_full (G_OBJECT (context),
6777 I_("gtk-tree-view-source-row"),
6778 source_row ? gtk_tree_row_reference_new (model, source_row) : NULL,
6779 (GDestroyNotify) (source_row ? gtk_tree_row_reference_free : NULL));
6783 get_source_row (GdkDragContext *context)
6785 GtkTreeRowReference *ref =
6786 g_object_get_data (G_OBJECT (context), "gtk-tree-view-source-row");
6789 return gtk_tree_row_reference_get_path (ref);
6796 GtkTreeRowReference *dest_row;
6797 guint path_down_mode : 1;
6798 guint empty_view_drop : 1;
6799 guint drop_append_mode : 1;
6804 dest_row_free (gpointer data)
6806 DestRow *dr = (DestRow *)data;
6808 gtk_tree_row_reference_free (dr->dest_row);
6809 g_slice_free (DestRow, dr);
6813 set_dest_row (GdkDragContext *context,
6814 GtkTreeModel *model,
6815 GtkTreePath *dest_row,
6816 gboolean path_down_mode,
6817 gboolean empty_view_drop,
6818 gboolean drop_append_mode)
6824 g_object_set_data_full (G_OBJECT (context), I_("gtk-tree-view-dest-row"),
6829 dr = g_slice_new (DestRow);
6831 dr->dest_row = gtk_tree_row_reference_new (model, dest_row);
6832 dr->path_down_mode = path_down_mode != FALSE;
6833 dr->empty_view_drop = empty_view_drop != FALSE;
6834 dr->drop_append_mode = drop_append_mode != FALSE;
6836 g_object_set_data_full (G_OBJECT (context), I_("gtk-tree-view-dest-row"),
6837 dr, (GDestroyNotify) dest_row_free);
6841 get_dest_row (GdkDragContext *context,
6842 gboolean *path_down_mode)
6845 g_object_get_data (G_OBJECT (context), "gtk-tree-view-dest-row");
6849 GtkTreePath *path = NULL;
6852 *path_down_mode = dr->path_down_mode;
6855 path = gtk_tree_row_reference_get_path (dr->dest_row);
6856 else if (dr->empty_view_drop)
6857 path = gtk_tree_path_new_from_indices (0, -1);
6861 if (path && dr->drop_append_mode)
6862 gtk_tree_path_next (path);
6870 /* Get/set whether drag_motion requested the drag data and
6871 * drag_data_received should thus not actually insert the data,
6872 * since the data doesn't result from a drop.
6875 set_status_pending (GdkDragContext *context,
6876 GdkDragAction suggested_action)
6878 g_object_set_data (G_OBJECT (context),
6879 I_("gtk-tree-view-status-pending"),
6880 GINT_TO_POINTER (suggested_action));
6883 static GdkDragAction
6884 get_status_pending (GdkDragContext *context)
6886 return GPOINTER_TO_INT (g_object_get_data (G_OBJECT (context),
6887 "gtk-tree-view-status-pending"));
6890 static TreeViewDragInfo*
6891 get_info (GtkTreeView *tree_view)
6893 return g_object_get_data (G_OBJECT (tree_view), "gtk-tree-view-drag-info");
6897 destroy_info (TreeViewDragInfo *di)
6899 g_slice_free (TreeViewDragInfo, di);
6902 static TreeViewDragInfo*
6903 ensure_info (GtkTreeView *tree_view)
6905 TreeViewDragInfo *di;
6907 di = get_info (tree_view);
6911 di = g_slice_new0 (TreeViewDragInfo);
6913 g_object_set_data_full (G_OBJECT (tree_view),
6914 I_("gtk-tree-view-drag-info"),
6916 (GDestroyNotify) destroy_info);
6923 remove_info (GtkTreeView *tree_view)
6925 g_object_set_data (G_OBJECT (tree_view), I_("gtk-tree-view-drag-info"), NULL);
6930 drag_scan_timeout (gpointer data)
6932 GtkTreeView *tree_view;
6934 GdkModifierType state;
6935 GtkTreePath *path = NULL;
6936 GtkTreeViewColumn *column = NULL;
6937 GdkRectangle visible_rect;
6939 GDK_THREADS_ENTER ();
6941 tree_view = GTK_TREE_VIEW (data);
6943 gdk_window_get_pointer (tree_view->priv->bin_window,
6946 gtk_tree_view_get_visible_rect (tree_view, &visible_rect);
6948 /* See if we are near the edge. */
6949 if ((x - visible_rect.x) < SCROLL_EDGE_SIZE ||
6950 (visible_rect.x + visible_rect.width - x) < SCROLL_EDGE_SIZE ||
6951 (y - visible_rect.y) < SCROLL_EDGE_SIZE ||
6952 (visible_rect.y + visible_rect.height - y) < SCROLL_EDGE_SIZE)
6954 gtk_tree_view_get_path_at_pos (tree_view,
6955 tree_view->priv->bin_window,
6964 gtk_tree_view_scroll_to_cell (tree_view,
6970 gtk_tree_path_free (path);
6974 GDK_THREADS_LEAVE ();
6981 add_scroll_timeout (GtkTreeView *tree_view)
6983 if (tree_view->priv->scroll_timeout == 0)
6985 tree_view->priv->scroll_timeout =
6986 gdk_threads_add_timeout (150, scroll_row_timeout, tree_view);
6991 remove_scroll_timeout (GtkTreeView *tree_view)
6993 if (tree_view->priv->scroll_timeout != 0)
6995 g_source_remove (tree_view->priv->scroll_timeout);
6996 tree_view->priv->scroll_timeout = 0;
7001 check_model_dnd (GtkTreeModel *model,
7002 GType required_iface,
7003 const gchar *signal)
7005 if (model == NULL || !G_TYPE_CHECK_INSTANCE_TYPE ((model), required_iface))
7007 g_warning ("You must override the default '%s' handler "
7008 "on GtkTreeView when using models that don't support "
7009 "the %s interface and enabling drag-and-drop. The simplest way to do this "
7010 "is to connect to '%s' and call "
7011 "g_signal_stop_emission_by_name() in your signal handler to prevent "
7012 "the default handler from running. Look at the source code "
7013 "for the default handler in gtktreeview.c to get an idea what "
7014 "your handler should do. (gtktreeview.c is in the GTK source "
7015 "code.) If you're using GTK from a language other than C, "
7016 "there may be a more natural way to override default handlers, e.g. via derivation.",
7017 signal, g_type_name (required_iface), signal);
7025 remove_open_timeout (GtkTreeView *tree_view)
7027 if (tree_view->priv->open_dest_timeout != 0)
7029 g_source_remove (tree_view->priv->open_dest_timeout);
7030 tree_view->priv->open_dest_timeout = 0;
7036 open_row_timeout (gpointer data)
7038 GtkTreeView *tree_view = data;
7039 GtkTreePath *dest_path = NULL;
7040 GtkTreeViewDropPosition pos;
7041 gboolean result = FALSE;
7043 gtk_tree_view_get_drag_dest_row (tree_view,
7048 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
7049 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
7051 gtk_tree_view_expand_row (tree_view, dest_path, FALSE);
7052 tree_view->priv->open_dest_timeout = 0;
7054 gtk_tree_path_free (dest_path);
7059 gtk_tree_path_free (dest_path);
7068 scroll_row_timeout (gpointer data)
7070 GtkTreeView *tree_view = data;
7072 gtk_tree_view_vertical_autoscroll (tree_view);
7074 if (tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
7075 gtk_tree_view_update_rubber_band (tree_view);
7080 /* Returns TRUE if event should not be propagated to parent widgets */
7082 set_destination_row (GtkTreeView *tree_view,
7083 GdkDragContext *context,
7084 /* coordinates relative to the widget */
7087 GdkDragAction *suggested_action,
7090 GtkTreePath *path = NULL;
7091 GtkTreeViewDropPosition pos;
7092 GtkTreeViewDropPosition old_pos;
7093 TreeViewDragInfo *di;
7095 GtkTreePath *old_dest_path = NULL;
7096 gboolean can_drop = FALSE;
7098 *suggested_action = 0;
7101 widget = GTK_WIDGET (tree_view);
7103 di = get_info (tree_view);
7105 if (di == NULL || y - TREE_VIEW_HEADER_HEIGHT (tree_view) < 0)
7107 /* someone unset us as a drag dest, note that if
7108 * we return FALSE drag_leave isn't called
7111 gtk_tree_view_set_drag_dest_row (tree_view,
7113 GTK_TREE_VIEW_DROP_BEFORE);
7115 remove_scroll_timeout (GTK_TREE_VIEW (widget));
7116 remove_open_timeout (GTK_TREE_VIEW (widget));
7118 return FALSE; /* no longer a drop site */
7121 *target = gtk_drag_dest_find_target (widget, context,
7122 gtk_drag_dest_get_target_list (widget));
7123 if (*target == GDK_NONE)
7128 if (!gtk_tree_view_get_dest_row_at_pos (tree_view,
7134 GtkTreeModel *model;
7136 remove_open_timeout (tree_view);
7138 /* the row got dropped on empty space, let's setup a special case
7142 gtk_tree_path_free (path);
7144 model = gtk_tree_view_get_model (tree_view);
7146 n_children = gtk_tree_model_iter_n_children (model, NULL);
7149 pos = GTK_TREE_VIEW_DROP_AFTER;
7150 path = gtk_tree_path_new_from_indices (n_children - 1, -1);
7154 pos = GTK_TREE_VIEW_DROP_BEFORE;
7155 path = gtk_tree_path_new_from_indices (0, -1);
7165 /* If we left the current row's "open" zone, unset the timeout for
7168 gtk_tree_view_get_drag_dest_row (tree_view,
7172 if (old_dest_path &&
7173 (gtk_tree_path_compare (path, old_dest_path) != 0 ||
7174 !(pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
7175 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE)))
7176 remove_open_timeout (tree_view);
7179 gtk_tree_path_free (old_dest_path);
7181 if (TRUE /* FIXME if the location droppable predicate */)
7189 GtkWidget *source_widget;
7191 *suggested_action = gdk_drag_context_get_suggested_action (context);
7192 source_widget = gtk_drag_get_source_widget (context);
7194 if (source_widget == widget)
7196 /* Default to MOVE, unless the user has
7197 * pressed ctrl or shift to affect available actions
7199 if ((gdk_drag_context_get_actions (context) & GDK_ACTION_MOVE) != 0)
7200 *suggested_action = GDK_ACTION_MOVE;
7203 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
7208 /* can't drop here */
7209 remove_open_timeout (tree_view);
7211 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
7213 GTK_TREE_VIEW_DROP_BEFORE);
7217 gtk_tree_path_free (path);
7223 get_logical_dest_row (GtkTreeView *tree_view,
7224 gboolean *path_down_mode,
7225 gboolean *drop_append_mode)
7227 /* adjust path to point to the row the drop goes in front of */
7228 GtkTreePath *path = NULL;
7229 GtkTreeViewDropPosition pos;
7231 g_return_val_if_fail (path_down_mode != NULL, NULL);
7232 g_return_val_if_fail (drop_append_mode != NULL, NULL);
7234 *path_down_mode = FALSE;
7235 *drop_append_mode = 0;
7237 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
7242 if (pos == GTK_TREE_VIEW_DROP_BEFORE)
7244 else if (pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE ||
7245 pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER)
7246 *path_down_mode = TRUE;
7250 GtkTreeModel *model = gtk_tree_view_get_model (tree_view);
7252 g_assert (pos == GTK_TREE_VIEW_DROP_AFTER);
7254 if (!gtk_tree_model_get_iter (model, &iter, path) ||
7255 !gtk_tree_model_iter_next (model, &iter))
7256 *drop_append_mode = 1;
7259 *drop_append_mode = 0;
7260 gtk_tree_path_next (path);
7268 gtk_tree_view_maybe_begin_dragging_row (GtkTreeView *tree_view,
7269 GdkEventMotion *event)
7271 GtkWidget *widget = GTK_WIDGET (tree_view);
7272 GdkDragContext *context;
7273 TreeViewDragInfo *di;
7274 GtkTreePath *path = NULL;
7276 gint cell_x, cell_y;
7277 GtkTreeModel *model;
7278 gboolean retval = FALSE;
7280 di = get_info (tree_view);
7282 if (di == NULL || !di->source_set)
7285 if (tree_view->priv->pressed_button < 0)
7288 if (!gtk_drag_check_threshold (widget,
7289 tree_view->priv->press_start_x,
7290 tree_view->priv->press_start_y,
7291 event->x, event->y))
7294 model = gtk_tree_view_get_model (tree_view);
7299 button = tree_view->priv->pressed_button;
7300 tree_view->priv->pressed_button = -1;
7302 gtk_tree_view_get_path_at_pos (tree_view,
7303 tree_view->priv->press_start_x,
7304 tree_view->priv->press_start_y,
7313 if (!GTK_IS_TREE_DRAG_SOURCE (model) ||
7314 !gtk_tree_drag_source_row_draggable (GTK_TREE_DRAG_SOURCE (model),
7318 if (!(GDK_BUTTON1_MASK << (button - 1) & di->start_button_mask))
7321 /* Now we can begin the drag */
7325 context = gtk_drag_begin (widget,
7326 gtk_drag_source_get_target_list (widget),
7331 set_source_row (context, model, path);
7335 gtk_tree_path_free (path);
7342 gtk_tree_view_drag_begin (GtkWidget *widget,
7343 GdkDragContext *context)
7345 GtkTreeView *tree_view;
7346 GtkTreePath *path = NULL;
7347 gint cell_x, cell_y;
7348 cairo_surface_t *row_pix;
7349 TreeViewDragInfo *di;
7351 tree_view = GTK_TREE_VIEW (widget);
7353 /* if the user uses a custom DND source impl, we don't set the icon here */
7354 di = get_info (tree_view);
7356 if (di == NULL || !di->source_set)
7359 gtk_tree_view_get_path_at_pos (tree_view,
7360 tree_view->priv->press_start_x,
7361 tree_view->priv->press_start_y,
7367 g_return_if_fail (path != NULL);
7369 row_pix = gtk_tree_view_create_row_drag_icon (tree_view,
7371 cairo_surface_set_device_offset (row_pix,
7372 /* the + 1 is for the black border in the icon */
7373 - (tree_view->priv->press_start_x + 1),
7376 gtk_drag_set_icon_surface (context, row_pix);
7378 cairo_surface_destroy (row_pix);
7379 gtk_tree_path_free (path);
7383 gtk_tree_view_drag_end (GtkWidget *widget,
7384 GdkDragContext *context)
7389 /* Default signal implementations for the drag signals */
7391 gtk_tree_view_drag_data_get (GtkWidget *widget,
7392 GdkDragContext *context,
7393 GtkSelectionData *selection_data,
7397 GtkTreeView *tree_view;
7398 GtkTreeModel *model;
7399 TreeViewDragInfo *di;
7400 GtkTreePath *source_row;
7402 tree_view = GTK_TREE_VIEW (widget);
7404 model = gtk_tree_view_get_model (tree_view);
7409 di = get_info (GTK_TREE_VIEW (widget));
7414 source_row = get_source_row (context);
7416 if (source_row == NULL)
7419 /* We can implement the GTK_TREE_MODEL_ROW target generically for
7420 * any model; for DragSource models there are some other targets
7424 if (GTK_IS_TREE_DRAG_SOURCE (model) &&
7425 gtk_tree_drag_source_drag_data_get (GTK_TREE_DRAG_SOURCE (model),
7430 /* If drag_data_get does nothing, try providing row data. */
7431 if (selection_data->target == gdk_atom_intern_static_string ("GTK_TREE_MODEL_ROW"))
7433 gtk_tree_set_row_drag_data (selection_data,
7439 gtk_tree_path_free (source_row);
7444 gtk_tree_view_drag_data_delete (GtkWidget *widget,
7445 GdkDragContext *context)
7447 TreeViewDragInfo *di;
7448 GtkTreeModel *model;
7449 GtkTreeView *tree_view;
7450 GtkTreePath *source_row;
7452 tree_view = GTK_TREE_VIEW (widget);
7453 model = gtk_tree_view_get_model (tree_view);
7455 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_SOURCE, "drag_data_delete"))
7458 di = get_info (tree_view);
7463 source_row = get_source_row (context);
7465 if (source_row == NULL)
7468 gtk_tree_drag_source_drag_data_delete (GTK_TREE_DRAG_SOURCE (model),
7471 gtk_tree_path_free (source_row);
7473 set_source_row (context, NULL, NULL);
7477 gtk_tree_view_drag_leave (GtkWidget *widget,
7478 GdkDragContext *context,
7481 /* unset any highlight row */
7482 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
7484 GTK_TREE_VIEW_DROP_BEFORE);
7486 remove_scroll_timeout (GTK_TREE_VIEW (widget));
7487 remove_open_timeout (GTK_TREE_VIEW (widget));
7492 gtk_tree_view_drag_motion (GtkWidget *widget,
7493 GdkDragContext *context,
7494 /* coordinates relative to the widget */
7500 GtkTreePath *path = NULL;
7501 GtkTreeViewDropPosition pos;
7502 GtkTreeView *tree_view;
7503 GdkDragAction suggested_action = 0;
7506 tree_view = GTK_TREE_VIEW (widget);
7508 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
7511 gtk_tree_view_get_drag_dest_row (tree_view, &path, &pos);
7513 /* we only know this *after* set_desination_row */
7514 empty = tree_view->priv->empty_view_drop;
7516 if (path == NULL && !empty)
7518 /* Can't drop here. */
7519 gdk_drag_status (context, 0, time);
7523 if (tree_view->priv->open_dest_timeout == 0 &&
7524 (pos == GTK_TREE_VIEW_DROP_INTO_OR_AFTER ||
7525 pos == GTK_TREE_VIEW_DROP_INTO_OR_BEFORE))
7527 tree_view->priv->open_dest_timeout =
7528 gdk_threads_add_timeout (AUTO_EXPAND_TIMEOUT, open_row_timeout, tree_view);
7532 add_scroll_timeout (tree_view);
7535 if (target == gdk_atom_intern_static_string ("GTK_TREE_MODEL_ROW"))
7537 /* Request data so we can use the source row when
7538 * determining whether to accept the drop
7540 set_status_pending (context, suggested_action);
7541 gtk_drag_get_data (widget, context, target, time);
7545 set_status_pending (context, 0);
7546 gdk_drag_status (context, suggested_action, time);
7551 gtk_tree_path_free (path);
7558 gtk_tree_view_drag_drop (GtkWidget *widget,
7559 GdkDragContext *context,
7560 /* coordinates relative to the widget */
7565 GtkTreeView *tree_view;
7567 GdkDragAction suggested_action = 0;
7568 GdkAtom target = GDK_NONE;
7569 TreeViewDragInfo *di;
7570 GtkTreeModel *model;
7571 gboolean path_down_mode;
7572 gboolean drop_append_mode;
7574 tree_view = GTK_TREE_VIEW (widget);
7576 model = gtk_tree_view_get_model (tree_view);
7578 remove_scroll_timeout (GTK_TREE_VIEW (widget));
7579 remove_open_timeout (GTK_TREE_VIEW (widget));
7581 di = get_info (tree_view);
7586 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_drop"))
7589 if (!set_destination_row (tree_view, context, x, y, &suggested_action, &target))
7592 path = get_logical_dest_row (tree_view, &path_down_mode, &drop_append_mode);
7594 if (target != GDK_NONE && path != NULL)
7596 /* in case a motion had requested drag data, change things so we
7597 * treat drag data receives as a drop.
7599 set_status_pending (context, 0);
7600 set_dest_row (context, model, path,
7601 path_down_mode, tree_view->priv->empty_view_drop,
7606 gtk_tree_path_free (path);
7608 /* Unset this thing */
7609 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
7611 GTK_TREE_VIEW_DROP_BEFORE);
7613 if (target != GDK_NONE)
7615 gtk_drag_get_data (widget, context, target, time);
7623 gtk_tree_view_drag_data_received (GtkWidget *widget,
7624 GdkDragContext *context,
7625 /* coordinates relative to the widget */
7628 GtkSelectionData *selection_data,
7633 TreeViewDragInfo *di;
7634 gboolean accepted = FALSE;
7635 GtkTreeModel *model;
7636 GtkTreeView *tree_view;
7637 GtkTreePath *dest_row;
7638 GdkDragAction suggested_action;
7639 gboolean path_down_mode;
7640 gboolean drop_append_mode;
7642 tree_view = GTK_TREE_VIEW (widget);
7644 model = gtk_tree_view_get_model (tree_view);
7646 if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag_data_received"))
7649 di = get_info (tree_view);
7654 suggested_action = get_status_pending (context);
7656 if (suggested_action)
7658 /* We are getting this data due to a request in drag_motion,
7659 * rather than due to a request in drag_drop, so we are just
7660 * supposed to call drag_status, not actually paste in the
7663 path = get_logical_dest_row (tree_view, &path_down_mode,
7667 suggested_action = 0;
7668 else if (path_down_mode)
7669 gtk_tree_path_down (path);
7671 if (suggested_action)
7673 if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model),
7679 path_down_mode = FALSE;
7680 gtk_tree_path_up (path);
7682 if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model),
7685 suggested_action = 0;
7688 suggested_action = 0;
7692 gdk_drag_status (context, suggested_action, time);
7695 gtk_tree_path_free (path);
7697 /* If you can't drop, remove user drop indicator until the next motion */
7698 if (suggested_action == 0)
7699 gtk_tree_view_set_drag_dest_row (GTK_TREE_VIEW (widget),
7701 GTK_TREE_VIEW_DROP_BEFORE);
7706 dest_row = get_dest_row (context, &path_down_mode);
7708 if (dest_row == NULL)
7711 if (selection_data->length >= 0)
7715 gtk_tree_path_down (dest_row);
7716 if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model),
7717 dest_row, selection_data))
7718 gtk_tree_path_up (dest_row);
7722 if (selection_data->length >= 0)
7724 if (gtk_tree_drag_dest_drag_data_received (GTK_TREE_DRAG_DEST (model),
7730 gtk_drag_finish (context,
7732 (gdk_drag_context_get_selected_action (context) == GDK_ACTION_MOVE),
7735 if (gtk_tree_path_get_depth (dest_row) == 1
7736 && gtk_tree_path_get_indices (dest_row)[0] == 0)
7738 /* special special case drag to "0", scroll to first item */
7739 if (!tree_view->priv->scroll_to_path)
7740 gtk_tree_view_scroll_to_cell (tree_view, dest_row, NULL, FALSE, 0.0, 0.0);
7743 gtk_tree_path_free (dest_row);
7746 set_dest_row (context, NULL, NULL, FALSE, FALSE, FALSE);
7751 /* GtkContainer Methods
7756 gtk_tree_view_remove (GtkContainer *container,
7759 GtkTreeView *tree_view = GTK_TREE_VIEW (container);
7760 GtkTreeViewChild *child = NULL;
7763 tmp_list = tree_view->priv->children;
7766 child = tmp_list->data;
7767 if (child->widget == widget)
7769 gtk_widget_unparent (widget);
7771 tree_view->priv->children = g_list_remove_link (tree_view->priv->children, tmp_list);
7772 g_list_free_1 (tmp_list);
7773 g_slice_free (GtkTreeViewChild, child);
7777 tmp_list = tmp_list->next;
7780 tmp_list = tree_view->priv->columns;
7784 GtkTreeViewColumn *column;
7785 column = tmp_list->data;
7786 if (column->button == widget)
7788 gtk_widget_unparent (widget);
7791 tmp_list = tmp_list->next;
7796 gtk_tree_view_forall (GtkContainer *container,
7797 gboolean include_internals,
7798 GtkCallback callback,
7799 gpointer callback_data)
7801 GtkTreeView *tree_view = GTK_TREE_VIEW (container);
7802 GtkTreeViewChild *child = NULL;
7803 GtkTreeViewColumn *column;
7806 tmp_list = tree_view->priv->children;
7809 child = tmp_list->data;
7810 tmp_list = tmp_list->next;
7812 (* callback) (child->widget, callback_data);
7814 if (include_internals == FALSE)
7817 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
7819 column = tmp_list->data;
7822 (* callback) (column->button, callback_data);
7826 /* Returns TRUE if the treeview contains no "special" (editable or activatable)
7827 * cells. If so we draw one big row-spanning focus rectangle.
7830 gtk_tree_view_has_special_cell (GtkTreeView *tree_view)
7834 for (list = tree_view->priv->columns; list; list = list->next)
7836 if (!gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (list->data)))
7838 if (_gtk_tree_view_column_count_special_cells (list->data))
7846 column_sizing_notify (GObject *object,
7850 GtkTreeViewColumn *c = GTK_TREE_VIEW_COLUMN (object);
7852 if (gtk_tree_view_column_get_sizing (c) != GTK_TREE_VIEW_COLUMN_FIXED)
7853 /* disable fixed height mode */
7854 g_object_set (data, "fixed-height-mode", FALSE, NULL);
7858 * gtk_tree_view_set_fixed_height_mode:
7859 * @tree_view: a #GtkTreeView
7860 * @enable: %TRUE to enable fixed height mode
7862 * Enables or disables the fixed height mode of @tree_view.
7863 * Fixed height mode speeds up #GtkTreeView by assuming that all
7864 * rows have the same height.
7865 * Only enable this option if all rows are the same height and all
7866 * columns are of type %GTK_TREE_VIEW_COLUMN_FIXED.
7871 gtk_tree_view_set_fixed_height_mode (GtkTreeView *tree_view,
7876 enable = enable != FALSE;
7878 if (enable == tree_view->priv->fixed_height_mode)
7883 tree_view->priv->fixed_height_mode = 0;
7884 tree_view->priv->fixed_height = -1;
7886 /* force a revalidation */
7887 install_presize_handler (tree_view);
7891 /* make sure all columns are of type FIXED */
7892 for (l = tree_view->priv->columns; l; l = l->next)
7894 GtkTreeViewColumn *c = l->data;
7896 g_return_if_fail (gtk_tree_view_column_get_sizing (c) == GTK_TREE_VIEW_COLUMN_FIXED);
7899 /* yes, we really have to do this is in a separate loop */
7900 for (l = tree_view->priv->columns; l; l = l->next)
7901 g_signal_connect (l->data, "notify::sizing",
7902 G_CALLBACK (column_sizing_notify), tree_view);
7904 tree_view->priv->fixed_height_mode = 1;
7905 tree_view->priv->fixed_height = -1;
7907 if (tree_view->priv->tree)
7908 initialize_fixed_height_mode (tree_view);
7911 g_object_notify (G_OBJECT (tree_view), "fixed-height-mode");
7915 * gtk_tree_view_get_fixed_height_mode:
7916 * @tree_view: a #GtkTreeView
7918 * Returns whether fixed height mode is turned on for @tree_view.
7920 * Return value: %TRUE if @tree_view is in fixed height mode
7925 gtk_tree_view_get_fixed_height_mode (GtkTreeView *tree_view)
7927 return tree_view->priv->fixed_height_mode;
7930 /* Returns TRUE if the focus is within the headers, after the focus operation is
7934 gtk_tree_view_header_focus (GtkTreeView *tree_view,
7935 GtkDirectionType dir,
7936 gboolean clamp_column_visible)
7938 GtkTreeViewColumn *column;
7939 GtkWidget *focus_child;
7941 GList *last_column, *first_column;
7945 if (! GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE))
7948 focus_child = gtk_container_get_focus_child (GTK_CONTAINER (tree_view));
7950 first_column = tree_view->priv->columns;
7951 while (first_column)
7953 column = GTK_TREE_VIEW_COLUMN (first_column->data);
7955 if (gtk_widget_get_can_focus (column->button) &&
7956 gtk_tree_view_column_get_visible (column) &&
7957 (gtk_tree_view_column_get_clickable (column) ||
7958 gtk_tree_view_column_get_reorderable (column)))
7960 first_column = first_column->next;
7963 /* No headers are visible, or are focusable. We can't focus in or out.
7965 if (first_column == NULL)
7968 last_column = g_list_last (tree_view->priv->columns);
7971 column = GTK_TREE_VIEW_COLUMN (last_column->data);
7973 if (gtk_widget_get_can_focus (column->button) &&
7974 gtk_tree_view_column_get_visible (column) &&
7975 (gtk_tree_view_column_get_clickable (column) ||
7976 gtk_tree_view_column_get_reorderable (column)))
7978 last_column = last_column->prev;
7982 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
7986 case GTK_DIR_TAB_BACKWARD:
7987 case GTK_DIR_TAB_FORWARD:
7990 if (focus_child == NULL)
7992 if (tree_view->priv->focus_column != NULL &&
7993 gtk_widget_get_can_focus (tree_view->priv->focus_column->button))
7994 focus_child = tree_view->priv->focus_column->button;
7996 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
7997 gtk_widget_grab_focus (focus_child);
8004 if (focus_child == NULL)
8006 if (tree_view->priv->focus_column != NULL)
8007 focus_child = tree_view->priv->focus_column->button;
8008 else if (dir == GTK_DIR_LEFT)
8009 focus_child = GTK_TREE_VIEW_COLUMN (last_column->data)->button;
8011 focus_child = GTK_TREE_VIEW_COLUMN (first_column->data)->button;
8012 gtk_widget_grab_focus (focus_child);
8016 if (gtk_widget_child_focus (focus_child, dir))
8018 /* The focus moves inside the button. */
8019 /* This is probably a great example of bad UI */
8023 /* We need to move the focus among the row of buttons. */
8024 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
8025 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
8028 if ((tmp_list == first_column && dir == (rtl ? GTK_DIR_RIGHT : GTK_DIR_LEFT))
8029 || (tmp_list == last_column && dir == (rtl ? GTK_DIR_LEFT : GTK_DIR_RIGHT)))
8031 gtk_widget_error_bell (GTK_WIDGET (tree_view));
8037 GtkTreeViewColumn *column;
8039 if (dir == (rtl ? GTK_DIR_LEFT : GTK_DIR_RIGHT))
8040 tmp_list = tmp_list->next;
8042 tmp_list = tmp_list->prev;
8044 if (tmp_list == NULL)
8046 g_warning ("Internal button not found");
8049 column = tmp_list->data;
8050 if (column->button &&
8051 gtk_tree_view_column_get_visible (column) &&
8052 gtk_widget_get_can_focus (column->button))
8054 focus_child = column->button;
8055 gtk_widget_grab_focus (column->button);
8061 g_assert_not_reached ();
8065 /* if focus child is non-null, we assume it's been set to the current focus child
8069 for (tmp_list = tree_view->priv->columns; tmp_list; tmp_list = tmp_list->next)
8070 if (GTK_TREE_VIEW_COLUMN (tmp_list->data)->button == focus_child)
8072 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
8076 if (clamp_column_visible)
8078 gtk_tree_view_clamp_column_visible (tree_view,
8079 tree_view->priv->focus_column,
8084 return (focus_child != NULL);
8087 /* This function returns in 'path' the first focusable path, if the given path
8088 * is already focusable, it's the returned one.
8091 search_first_focusable_path (GtkTreeView *tree_view,
8093 gboolean search_forward,
8094 GtkRBTree **new_tree,
8095 GtkRBNode **new_node)
8097 GtkRBTree *tree = NULL;
8098 GtkRBNode *node = NULL;
8100 if (!path || !*path)
8103 _gtk_tree_view_find_node (tree_view, *path, &tree, &node);
8108 while (node && row_is_separator (tree_view, NULL, *path))
8111 _gtk_rbtree_next_full (tree, node, &tree, &node);
8113 _gtk_rbtree_prev_full (tree, node, &tree, &node);
8116 gtk_tree_path_free (*path);
8119 *path = _gtk_tree_view_find_path (tree_view, tree, node);
8130 return (*path != NULL);
8134 gtk_tree_view_focus (GtkWidget *widget,
8135 GtkDirectionType direction)
8137 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
8138 GtkContainer *container = GTK_CONTAINER (widget);
8139 GtkWidget *focus_child;
8141 if (!gtk_widget_is_sensitive (widget) || !gtk_widget_get_can_focus (widget))
8144 focus_child = gtk_container_get_focus_child (container);
8146 gtk_tree_view_stop_editing (GTK_TREE_VIEW (widget), FALSE);
8147 /* Case 1. Headers currently have focus. */
8154 gtk_tree_view_header_focus (tree_view, direction, TRUE);
8156 case GTK_DIR_TAB_BACKWARD:
8159 case GTK_DIR_TAB_FORWARD:
8161 gtk_widget_grab_focus (widget);
8164 g_assert_not_reached ();
8169 /* Case 2. We don't have focus at all. */
8170 if (!gtk_widget_has_focus (widget))
8172 gtk_widget_grab_focus (widget);
8176 /* Case 3. We have focus already. */
8177 if (direction == GTK_DIR_TAB_BACKWARD)
8178 return (gtk_tree_view_header_focus (tree_view, direction, FALSE));
8179 else if (direction == GTK_DIR_TAB_FORWARD)
8182 /* Other directions caught by the keybindings */
8183 gtk_widget_grab_focus (widget);
8188 gtk_tree_view_grab_focus (GtkWidget *widget)
8190 GTK_WIDGET_CLASS (gtk_tree_view_parent_class)->grab_focus (widget);
8192 gtk_tree_view_focus_to_cursor (GTK_TREE_VIEW (widget));
8196 gtk_tree_view_style_set (GtkWidget *widget,
8197 GtkStyle *previous_style)
8199 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
8202 GtkTreeViewColumn *column;
8204 if (gtk_widget_get_realized (widget))
8206 style = gtk_widget_get_style (widget);
8207 gdk_window_set_background (tree_view->priv->bin_window,
8208 &style->base[gtk_widget_get_state (widget)]);
8209 gtk_style_set_background (style, tree_view->priv->header_window, GTK_STATE_NORMAL);
8211 gtk_tree_view_set_grid_lines (tree_view, tree_view->priv->grid_lines);
8212 gtk_tree_view_set_enable_tree_lines (tree_view, tree_view->priv->tree_lines_enabled);
8215 gtk_widget_style_get (widget,
8216 "expander-size", &tree_view->priv->expander_size,
8218 tree_view->priv->expander_size += EXPANDER_EXTRA_PADDING;
8220 for (list = tree_view->priv->columns; list; list = list->next)
8222 column = list->data;
8223 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
8226 tree_view->priv->fixed_height = -1;
8227 _gtk_rbtree_mark_invalid (tree_view->priv->tree);
8229 gtk_widget_queue_resize (widget);
8234 gtk_tree_view_set_focus_child (GtkContainer *container,
8237 GtkTreeView *tree_view = GTK_TREE_VIEW (container);
8240 for (list = tree_view->priv->columns; list; list = list->next)
8242 if (GTK_TREE_VIEW_COLUMN (list->data)->button == child)
8244 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (list->data);
8249 GTK_CONTAINER_CLASS (gtk_tree_view_parent_class)->set_focus_child (container, child);
8253 gtk_tree_view_real_move_cursor (GtkTreeView *tree_view,
8254 GtkMovementStep step,
8257 GdkModifierType state;
8259 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
8260 g_return_val_if_fail (step == GTK_MOVEMENT_LOGICAL_POSITIONS ||
8261 step == GTK_MOVEMENT_VISUAL_POSITIONS ||
8262 step == GTK_MOVEMENT_DISPLAY_LINES ||
8263 step == GTK_MOVEMENT_PAGES ||
8264 step == GTK_MOVEMENT_BUFFER_ENDS, FALSE);
8266 if (tree_view->priv->tree == NULL)
8268 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
8271 gtk_tree_view_stop_editing (tree_view, FALSE);
8272 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
8273 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
8275 if (gtk_get_current_event_state (&state))
8277 if ((state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
8278 tree_view->priv->ctrl_pressed = TRUE;
8279 if ((state & GDK_SHIFT_MASK) == GDK_SHIFT_MASK)
8280 tree_view->priv->shift_pressed = TRUE;
8282 /* else we assume not pressed */
8286 /* currently we make no distinction. When we go bi-di, we need to */
8287 case GTK_MOVEMENT_LOGICAL_POSITIONS:
8288 case GTK_MOVEMENT_VISUAL_POSITIONS:
8289 gtk_tree_view_move_cursor_left_right (tree_view, count);
8291 case GTK_MOVEMENT_DISPLAY_LINES:
8292 gtk_tree_view_move_cursor_up_down (tree_view, count);
8294 case GTK_MOVEMENT_PAGES:
8295 gtk_tree_view_move_cursor_page_up_down (tree_view, count);
8297 case GTK_MOVEMENT_BUFFER_ENDS:
8298 gtk_tree_view_move_cursor_start_end (tree_view, count);
8301 g_assert_not_reached ();
8304 tree_view->priv->ctrl_pressed = FALSE;
8305 tree_view->priv->shift_pressed = FALSE;
8311 gtk_tree_view_put (GtkTreeView *tree_view,
8312 GtkWidget *child_widget,
8313 /* in bin_window coordinates */
8319 GtkTreeViewChild *child;
8321 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8322 g_return_if_fail (GTK_IS_WIDGET (child_widget));
8324 child = g_slice_new (GtkTreeViewChild);
8326 child->widget = child_widget;
8329 child->width = width;
8330 child->height = height;
8332 tree_view->priv->children = g_list_append (tree_view->priv->children, child);
8334 if (gtk_widget_get_realized (GTK_WIDGET (tree_view)))
8335 gtk_widget_set_parent_window (child->widget, tree_view->priv->bin_window);
8337 gtk_widget_set_parent (child_widget, GTK_WIDGET (tree_view));
8341 _gtk_tree_view_child_move_resize (GtkTreeView *tree_view,
8343 /* in tree coordinates */
8349 GtkTreeViewChild *child = NULL;
8351 GdkRectangle allocation;
8353 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
8354 g_return_if_fail (GTK_IS_WIDGET (widget));
8356 for (list = tree_view->priv->children; list; list = list->next)
8358 if (((GtkTreeViewChild *)list->data)->widget == widget)
8367 allocation.x = child->x = x;
8368 allocation.y = child->y = y;
8369 allocation.width = child->width = width;
8370 allocation.height = child->height = height;
8372 if (gtk_widget_get_realized (widget))
8373 gtk_widget_size_allocate (widget, &allocation);
8377 /* TreeModel Callbacks
8381 gtk_tree_view_row_changed (GtkTreeModel *model,
8386 GtkTreeView *tree_view = (GtkTreeView *)data;
8389 gboolean free_path = FALSE;
8391 GtkTreePath *cursor_path;
8393 g_return_if_fail (path != NULL || iter != NULL);
8395 if (tree_view->priv->cursor != NULL)
8396 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
8400 if (tree_view->priv->edited_column &&
8401 (cursor_path == NULL || gtk_tree_path_compare (cursor_path, path) == 0))
8402 gtk_tree_view_stop_editing (tree_view, TRUE);
8404 if (cursor_path != NULL)
8405 gtk_tree_path_free (cursor_path);
8409 path = gtk_tree_model_get_path (model, iter);
8412 else if (iter == NULL)
8413 gtk_tree_model_get_iter (model, iter, path);
8415 if (_gtk_tree_view_find_node (tree_view,
8419 /* We aren't actually showing the node */
8425 if (tree_view->priv->fixed_height_mode
8426 && tree_view->priv->fixed_height >= 0)
8428 _gtk_rbtree_node_set_height (tree, node, tree_view->priv->fixed_height);
8429 if (gtk_widget_get_realized (GTK_WIDGET (tree_view)))
8430 gtk_tree_view_node_queue_redraw (tree_view, tree, node);
8434 _gtk_rbtree_node_mark_invalid (tree, node);
8435 for (list = tree_view->priv->columns; list; list = list->next)
8437 GtkTreeViewColumn *column;
8439 column = list->data;
8440 if (!gtk_tree_view_column_get_visible (column))
8443 if (gtk_tree_view_column_get_sizing (column) == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
8445 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
8451 if (!tree_view->priv->fixed_height_mode &&
8452 gtk_widget_get_realized (GTK_WIDGET (tree_view)))
8453 install_presize_handler (tree_view);
8455 gtk_tree_path_free (path);
8459 gtk_tree_view_row_inserted (GtkTreeModel *model,
8464 GtkTreeView *tree_view = (GtkTreeView *) data;
8466 GtkRBTree *tmptree, *tree;
8467 GtkRBNode *tmpnode = NULL;
8471 gboolean free_path = FALSE;
8472 gboolean node_visible = TRUE;
8474 g_return_if_fail (path != NULL || iter != NULL);
8476 if (tree_view->priv->fixed_height_mode
8477 && tree_view->priv->fixed_height >= 0)
8478 height = tree_view->priv->fixed_height;
8484 path = gtk_tree_model_get_path (model, iter);
8487 else if (iter == NULL)
8488 gtk_tree_model_get_iter (model, iter, path);
8490 if (tree_view->priv->tree == NULL)
8491 tree_view->priv->tree = _gtk_rbtree_new ();
8493 tmptree = tree = tree_view->priv->tree;
8495 /* Update all row-references */
8496 gtk_tree_row_reference_inserted (G_OBJECT (data), path);
8497 depth = gtk_tree_path_get_depth (path);
8498 indices = gtk_tree_path_get_indices (path);
8500 /* First, find the parent tree */
8501 while (i < depth - 1)
8503 if (tmptree == NULL)
8505 /* We aren't showing the node */
8506 node_visible = FALSE;
8510 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
8511 if (tmpnode == NULL)
8513 g_warning ("A node was inserted with a parent that's not in the tree.\n" \
8514 "This possibly means that a GtkTreeModel inserted a child node\n" \
8515 "before the parent was inserted.");
8518 else if (!GTK_RBNODE_FLAG_SET (tmpnode, GTK_RBNODE_IS_PARENT))
8520 /* FIXME enforce correct behavior on model, probably */
8521 /* In theory, the model should have emitted has_child_toggled here. We
8522 * try to catch it anyway, just to be safe, in case the model hasn't.
8524 GtkTreePath *tmppath = _gtk_tree_view_find_path (tree_view,
8527 gtk_tree_view_row_has_child_toggled (model, tmppath, NULL, data);
8528 gtk_tree_path_free (tmppath);
8532 tmptree = tmpnode->children;
8539 node_visible = FALSE;
8544 gtk_tree_model_ref_node (tree_view->priv->model, iter);
8545 if (indices[depth - 1] == 0)
8547 tmpnode = _gtk_rbtree_find_count (tree, 1);
8548 tmpnode = _gtk_rbtree_insert_before (tree, tmpnode, height, FALSE);
8552 tmpnode = _gtk_rbtree_find_count (tree, indices[depth - 1]);
8553 tmpnode = _gtk_rbtree_insert_after (tree, tmpnode, height, FALSE);
8560 _gtk_rbtree_node_mark_valid (tree, tmpnode);
8562 if (node_visible && node_is_visible (tree_view, tree, tmpnode))
8563 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8565 gtk_widget_queue_resize_no_redraw (GTK_WIDGET (tree_view));
8568 install_presize_handler (tree_view);
8570 gtk_tree_path_free (path);
8574 gtk_tree_view_row_has_child_toggled (GtkTreeModel *model,
8579 GtkTreeView *tree_view = (GtkTreeView *)data;
8580 GtkTreeIter real_iter;
8584 gboolean free_path = FALSE;
8586 g_return_if_fail (path != NULL || iter != NULL);
8593 path = gtk_tree_model_get_path (model, iter);
8596 else if (iter == NULL)
8597 gtk_tree_model_get_iter (model, &real_iter, path);
8599 if (_gtk_tree_view_find_node (tree_view,
8603 /* We aren't actually showing the node */
8609 has_child = gtk_tree_model_iter_has_child (model, &real_iter);
8612 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT) == has_child)
8616 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_PARENT);
8618 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_PARENT);
8620 if (has_child && GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST))
8622 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
8623 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS))
8627 for (list = tree_view->priv->columns; list; list = list->next)
8628 if (gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (list->data)))
8630 GTK_TREE_VIEW_COLUMN (list->data)->dirty = TRUE;
8631 _gtk_tree_view_column_cell_set_dirty (GTK_TREE_VIEW_COLUMN (list->data), TRUE);
8635 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8639 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
8644 gtk_tree_path_free (path);
8648 count_children_helper (GtkRBTree *tree,
8653 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, data);
8654 (*((gint *)data))++;
8658 check_selection_helper (GtkRBTree *tree,
8662 gint *value = (gint *)data;
8664 *value = GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED);
8666 if (node->children && !*value)
8667 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, check_selection_helper, data);
8671 gtk_tree_view_row_deleted (GtkTreeModel *model,
8675 GtkTreeView *tree_view = (GtkTreeView *)data;
8679 gint selection_changed = FALSE;
8681 g_return_if_fail (path != NULL);
8683 gtk_tree_row_reference_deleted (G_OBJECT (data), path);
8685 if (_gtk_tree_view_find_node (tree_view, path, &tree, &node))
8691 /* check if the selection has been changed */
8692 _gtk_rbtree_traverse (tree, node, G_POST_ORDER,
8693 check_selection_helper, &selection_changed);
8695 for (list = tree_view->priv->columns; list; list = list->next)
8696 if (gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (list->data)) &&
8697 gtk_tree_view_column_get_sizing (GTK_TREE_VIEW_COLUMN (list->data)) == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
8698 _gtk_tree_view_column_cell_set_dirty ((GtkTreeViewColumn *)list->data, TRUE);
8700 /* Ensure we don't have a dangling pointer to a dead node */
8701 ensure_unprelighted (tree_view);
8703 /* Cancel editting if we've started */
8704 gtk_tree_view_stop_editing (tree_view, TRUE);
8706 /* If we have a node expanded/collapsed timeout, remove it */
8707 remove_expand_collapse_timeout (tree_view);
8709 if (tree_view->priv->destroy_count_func)
8711 gint child_count = 0;
8713 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, &child_count);
8714 tree_view->priv->destroy_count_func (tree_view, path, child_count, tree_view->priv->destroy_count_data);
8717 if (tree->root->count == 1)
8719 if (tree_view->priv->tree == tree)
8720 tree_view->priv->tree = NULL;
8722 _gtk_rbtree_remove (tree);
8726 _gtk_rbtree_remove_node (tree, node);
8729 if (! gtk_tree_row_reference_valid (tree_view->priv->top_row))
8731 gtk_tree_row_reference_free (tree_view->priv->top_row);
8732 tree_view->priv->top_row = NULL;
8735 install_scroll_sync_handler (tree_view);
8737 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
8739 if (selection_changed)
8740 g_signal_emit_by_name (tree_view->priv->selection, "changed");
8744 gtk_tree_view_rows_reordered (GtkTreeModel *model,
8745 GtkTreePath *parent,
8750 GtkTreeView *tree_view = GTK_TREE_VIEW (data);
8755 len = gtk_tree_model_iter_n_children (model, iter);
8760 gtk_tree_row_reference_reordered (G_OBJECT (data),
8765 if (_gtk_tree_view_find_node (tree_view,
8771 /* We need to special case the parent path */
8773 tree = tree_view->priv->tree;
8775 tree = node->children;
8780 if (tree_view->priv->edited_column)
8781 gtk_tree_view_stop_editing (tree_view, TRUE);
8783 /* we need to be unprelighted */
8784 ensure_unprelighted (tree_view);
8786 /* clear the timeout */
8787 cancel_arrow_animation (tree_view);
8789 _gtk_rbtree_reorder (tree, new_order, len);
8791 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
8793 gtk_tree_view_dy_to_top_row (tree_view);
8797 /* Internal tree functions
8802 gtk_tree_view_get_background_xrange (GtkTreeView *tree_view,
8804 GtkTreeViewColumn *column,
8808 GtkTreeViewColumn *tmp_column = NULL;
8819 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
8822 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
8824 list = (rtl ? list->prev : list->next))
8826 tmp_column = list->data;
8828 if (tmp_column == column)
8831 if (gtk_tree_view_column_get_visible (tmp_column))
8832 total_width += gtk_tree_view_column_get_width (tmp_column);
8835 if (tmp_column != column)
8837 g_warning (G_STRLOC": passed-in column isn't in the tree");
8846 if (gtk_tree_view_column_get_visible (column))
8847 *x2 = total_width + gtk_tree_view_column_get_width (column);
8849 *x2 = total_width; /* width of 0 */
8853 gtk_tree_view_get_arrow_xrange (GtkTreeView *tree_view,
8860 GtkTreeViewColumn *tmp_column = NULL;
8862 gboolean indent_expanders;
8865 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
8868 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
8870 list = (rtl ? list->prev : list->next))
8872 tmp_column = list->data;
8874 if (gtk_tree_view_is_expander_column (tree_view, tmp_column))
8877 x_offset = total_width + gtk_tree_view_column_get_width (tmp_column) - tree_view->priv->expander_size;
8879 x_offset = total_width;
8883 if (gtk_tree_view_column_get_visible (tmp_column))
8884 total_width += gtk_tree_view_column_get_width (tmp_column);
8887 gtk_widget_style_get (GTK_WIDGET (tree_view),
8888 "indent-expanders", &indent_expanders,
8891 if (indent_expanders)
8894 x_offset -= tree_view->priv->expander_size * _gtk_rbtree_get_depth (tree);
8896 x_offset += tree_view->priv->expander_size * _gtk_rbtree_get_depth (tree);
8902 gtk_tree_view_column_get_visible (tmp_column))
8903 /* +1 because x2 isn't included in the range. */
8904 *x2 = *x1 + tree_view->priv->expander_size + 1;
8910 gtk_tree_view_build_tree (GtkTreeView *tree_view,
8916 GtkRBNode *temp = NULL;
8917 GtkTreePath *path = NULL;
8918 gboolean is_list = GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST);
8922 gtk_tree_model_ref_node (tree_view->priv->model, iter);
8923 temp = _gtk_rbtree_insert_after (tree, temp, 0, FALSE);
8925 if (tree_view->priv->fixed_height > 0)
8927 if (GTK_RBNODE_FLAG_SET (temp, GTK_RBNODE_INVALID))
8929 _gtk_rbtree_node_set_height (tree, temp, tree_view->priv->fixed_height);
8930 _gtk_rbtree_node_mark_valid (tree, temp);
8942 path = gtk_tree_model_get_path (tree_view->priv->model, iter);
8944 gtk_tree_path_next (path);
8946 if (gtk_tree_model_iter_children (tree_view->priv->model, &child, iter))
8950 g_signal_emit (tree_view, tree_view_signals[TEST_EXPAND_ROW], 0, iter, path, &expand);
8952 if (gtk_tree_model_iter_has_child (tree_view->priv->model, iter)
8955 temp->children = _gtk_rbtree_new ();
8956 temp->children->parent_tree = tree;
8957 temp->children->parent_node = temp;
8958 gtk_tree_view_build_tree (tree_view, temp->children, &child, depth + 1, recurse);
8963 if (gtk_tree_model_iter_has_child (tree_view->priv->model, iter))
8965 if ((temp->flags>K_RBNODE_IS_PARENT) != GTK_RBNODE_IS_PARENT)
8966 temp->flags ^= GTK_RBNODE_IS_PARENT;
8969 while (gtk_tree_model_iter_next (tree_view->priv->model, iter));
8972 gtk_tree_path_free (path);
8975 /* Make sure the node is visible vertically */
8977 gtk_tree_view_clamp_node_visible (GtkTreeView *tree_view,
8981 gint node_dy, height;
8982 GtkTreePath *path = NULL;
8984 if (!gtk_widget_get_realized (GTK_WIDGET (tree_view)))
8987 /* just return if the node is visible, avoiding a costly expose */
8988 node_dy = _gtk_rbtree_node_find_offset (tree, node);
8989 height = ROW_HEIGHT (tree_view, GTK_RBNODE_GET_HEIGHT (node));
8990 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID)
8991 && node_dy >= tree_view->priv->vadjustment->value
8992 && node_dy + height <= (tree_view->priv->vadjustment->value
8993 + tree_view->priv->vadjustment->page_size))
8996 path = _gtk_tree_view_find_path (tree_view, tree, node);
8999 /* We process updates because we want to clear old selected items when we scroll.
9000 * if this is removed, we get a "selection streak" at the bottom. */
9001 gtk_tree_view_bin_process_updates (tree_view);
9003 gtk_tree_view_scroll_to_cell (tree_view, path, NULL, FALSE, 0.0, 0.0);
9004 gtk_tree_path_free (path);
9009 gtk_tree_view_clamp_column_visible (GtkTreeView *tree_view,
9010 GtkTreeViewColumn *column,
9011 gboolean focus_to_cell)
9013 GtkAllocation allocation;
9019 gtk_widget_get_allocation (column->button, &allocation);
9021 width = allocation.width;
9023 if (width > tree_view->priv->hadjustment->page_size)
9025 /* The column is larger than the horizontal page size. If the
9026 * column has cells which can be focussed individually, then we make
9027 * sure the cell which gets focus is fully visible (if even the
9028 * focus cell is bigger than the page size, we make sure the
9029 * left-hand side of the cell is visible).
9031 * If the column does not have those so-called special cells, we
9032 * make sure the left-hand side of the column is visible.
9035 if (focus_to_cell && gtk_tree_view_has_special_cell (tree_view))
9037 GtkTreePath *cursor_path;
9038 GdkRectangle background_area, cell_area, focus_area;
9040 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9042 gtk_tree_view_get_cell_area (tree_view,
9043 cursor_path, column, &cell_area);
9044 gtk_tree_view_get_background_area (tree_view,
9045 cursor_path, column,
9048 gtk_tree_path_free (cursor_path);
9050 _gtk_tree_view_column_get_focus_area (column,
9056 width = focus_area.width;
9058 if (width < tree_view->priv->hadjustment->page_size)
9060 if ((tree_view->priv->hadjustment->value + tree_view->priv->hadjustment->page_size) < (x + width))
9061 gtk_adjustment_set_value (tree_view->priv->hadjustment,
9062 x + width - tree_view->priv->hadjustment->page_size);
9063 else if (tree_view->priv->hadjustment->value > x)
9064 gtk_adjustment_set_value (tree_view->priv->hadjustment, x);
9068 gtk_adjustment_set_value (tree_view->priv->hadjustment, x);
9072 if ((tree_view->priv->hadjustment->value + tree_view->priv->hadjustment->page_size) < (x + width))
9073 gtk_adjustment_set_value (tree_view->priv->hadjustment,
9074 x + width - tree_view->priv->hadjustment->page_size);
9075 else if (tree_view->priv->hadjustment->value > x)
9076 gtk_adjustment_set_value (tree_view->priv->hadjustment, x);
9080 /* This function could be more efficient. I'll optimize it if profiling seems
9081 * to imply that it is important */
9083 _gtk_tree_view_find_path (GtkTreeView *tree_view,
9088 GtkRBTree *tmp_tree;
9089 GtkRBNode *tmp_node, *last;
9092 path = gtk_tree_path_new ();
9094 g_return_val_if_fail (node != NULL, path);
9095 g_return_val_if_fail (node != tree->nil, path);
9097 count = 1 + node->left->count;
9100 tmp_node = node->parent;
9104 while (tmp_node != tmp_tree->nil)
9106 if (tmp_node->right == last)
9107 count += 1 + tmp_node->left->count;
9109 tmp_node = tmp_node->parent;
9111 gtk_tree_path_prepend_index (path, count - 1);
9112 last = tmp_tree->parent_node;
9113 tmp_tree = tmp_tree->parent_tree;
9116 count = 1 + last->left->count;
9117 tmp_node = last->parent;
9123 /* Returns TRUE if we ran out of tree before finding the path. If the path is
9124 * invalid (ie. points to a node that's not in the tree), *tree and *node are
9128 _gtk_tree_view_find_node (GtkTreeView *tree_view,
9133 GtkRBNode *tmpnode = NULL;
9134 GtkRBTree *tmptree = tree_view->priv->tree;
9135 gint *indices = gtk_tree_path_get_indices (path);
9136 gint depth = gtk_tree_path_get_depth (path);
9142 if (depth == 0 || tmptree == NULL)
9146 tmpnode = _gtk_rbtree_find_count (tmptree, indices[i] + 1);
9148 if (tmpnode == NULL)
9162 tmptree = tmpnode->children;
9163 if (tmptree == NULL)
9170 gtk_tree_view_is_expander_column (GtkTreeView *tree_view,
9171 GtkTreeViewColumn *column)
9175 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST))
9178 if (tree_view->priv->expander_column != NULL)
9180 if (tree_view->priv->expander_column == column)
9186 for (list = tree_view->priv->columns;
9189 if (gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (list->data)))
9191 if (list && list->data == column)
9198 gtk_tree_view_add_move_binding (GtkBindingSet *binding_set,
9201 gboolean add_shifted_binding,
9202 GtkMovementStep step,
9206 gtk_binding_entry_add_signal (binding_set, keyval, modmask,
9211 if (add_shifted_binding)
9212 gtk_binding_entry_add_signal (binding_set, keyval, GDK_SHIFT_MASK,
9217 if ((modmask & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
9220 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK | GDK_SHIFT_MASK,
9225 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK,
9232 gtk_tree_view_unref_tree_helper (GtkTreeModel *model,
9237 gint retval = FALSE;
9240 g_return_val_if_fail (node != NULL, FALSE);
9245 GtkRBTree *new_tree;
9246 GtkRBNode *new_node;
9248 new_tree = node->children;
9249 new_node = new_tree->root;
9251 while (new_node && new_node->left != new_tree->nil)
9252 new_node = new_node->left;
9254 if (!gtk_tree_model_iter_children (model, &child, iter))
9257 retval = retval || gtk_tree_view_unref_tree_helper (model, &child, new_tree, new_node);
9260 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
9262 gtk_tree_model_unref_node (model, iter);
9263 node = _gtk_rbtree_next (tree, node);
9265 while (gtk_tree_model_iter_next (model, iter));
9271 gtk_tree_view_unref_and_check_selection_tree (GtkTreeView *tree_view,
9283 while (node && node->left != tree->nil)
9286 g_return_val_if_fail (node != NULL, FALSE);
9287 path = _gtk_tree_view_find_path (tree_view, tree, node);
9288 gtk_tree_model_get_iter (GTK_TREE_MODEL (tree_view->priv->model),
9290 retval = gtk_tree_view_unref_tree_helper (GTK_TREE_MODEL (tree_view->priv->model), &iter, tree, node);
9291 gtk_tree_path_free (path);
9297 gtk_tree_view_set_column_drag_info (GtkTreeView *tree_view,
9298 GtkTreeViewColumn *column)
9300 GtkTreeViewColumn *left_column;
9301 GtkTreeViewColumn *cur_column = NULL;
9302 GtkTreeViewColumnReorder *reorder;
9307 /* We want to precalculate the motion list such that we know what column slots
9311 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
9313 /* First, identify all possible drop spots */
9315 tmp_list = g_list_last (tree_view->priv->columns);
9317 tmp_list = g_list_first (tree_view->priv->columns);
9321 cur_column = GTK_TREE_VIEW_COLUMN (tmp_list->data);
9322 tmp_list = rtl?g_list_previous (tmp_list):g_list_next (tmp_list);
9324 if (gtk_tree_view_column_get_visible (cur_column) == FALSE)
9327 /* If it's not the column moving and func tells us to skip over the column, we continue. */
9328 if (left_column != column && cur_column != column &&
9329 tree_view->priv->column_drop_func &&
9330 ! tree_view->priv->column_drop_func (tree_view, column, left_column, cur_column, tree_view->priv->column_drop_func_data))
9332 left_column = cur_column;
9335 reorder = g_slice_new0 (GtkTreeViewColumnReorder);
9336 reorder->left_column = left_column;
9337 left_column = reorder->right_column = cur_column;
9339 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
9342 /* Add the last one */
9343 if (tree_view->priv->column_drop_func == NULL ||
9344 ((left_column != column) &&
9345 tree_view->priv->column_drop_func (tree_view, column, left_column, NULL, tree_view->priv->column_drop_func_data)))
9347 reorder = g_slice_new0 (GtkTreeViewColumnReorder);
9348 reorder->left_column = left_column;
9349 reorder->right_column = NULL;
9350 tree_view->priv->column_drag_info = g_list_append (tree_view->priv->column_drag_info, reorder);
9353 /* We quickly check to see if it even makes sense to reorder columns. */
9354 /* If there is nothing that can be moved, then we return */
9356 if (tree_view->priv->column_drag_info == NULL)
9359 /* We know there are always 2 slots possbile, as you can always return column. */
9360 /* If that's all there is, return */
9361 if (tree_view->priv->column_drag_info->next == NULL ||
9362 (tree_view->priv->column_drag_info->next->next == NULL &&
9363 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->data)->right_column == column &&
9364 ((GtkTreeViewColumnReorder *)tree_view->priv->column_drag_info->next->data)->left_column == column))
9366 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
9367 g_slice_free (GtkTreeViewColumnReorder, tmp_list->data);
9368 g_list_free (tree_view->priv->column_drag_info);
9369 tree_view->priv->column_drag_info = NULL;
9372 /* We fill in the ranges for the columns, now that we've isolated them */
9373 left = - TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
9375 for (tmp_list = tree_view->priv->column_drag_info; tmp_list; tmp_list = tmp_list->next)
9377 reorder = (GtkTreeViewColumnReorder *) tmp_list->data;
9379 reorder->left_align = left;
9380 if (tmp_list->next != NULL)
9382 GtkAllocation right_allocation, left_allocation;
9384 g_assert (tmp_list->next->data);
9386 gtk_widget_get_allocation (reorder->right_column->button, &right_allocation);
9387 gtk_widget_get_allocation (((GtkTreeViewColumnReorder *)tmp_list->next->data)->left_column->button, &left_allocation);
9388 left = reorder->right_align = (right_allocation.x + right_allocation.width + left_allocation.x) / 2;
9392 reorder->right_align = gdk_window_get_width (tree_view->priv->header_window)
9393 + TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER (tree_view);
9399 _gtk_tree_view_column_start_drag (GtkTreeView *tree_view,
9400 GtkTreeViewColumn *column,
9403 GdkEvent *send_event;
9404 GtkAllocation allocation;
9405 GtkAllocation button_allocation;
9406 GdkScreen *screen = gtk_widget_get_screen (GTK_WIDGET (tree_view));
9407 GdkDisplay *display = gdk_screen_get_display (screen);
9409 g_return_if_fail (tree_view->priv->column_drag_info == NULL);
9410 g_return_if_fail (tree_view->priv->cur_reorder == NULL);
9412 gtk_tree_view_set_column_drag_info (tree_view, column);
9414 if (tree_view->priv->column_drag_info == NULL)
9417 if (tree_view->priv->drag_window == NULL)
9419 GdkWindowAttr attributes;
9420 guint attributes_mask;
9422 gtk_widget_get_allocation (column->button, &button_allocation);
9424 attributes.window_type = GDK_WINDOW_CHILD;
9425 attributes.wclass = GDK_INPUT_OUTPUT;
9426 attributes.x = button_allocation.x;
9428 attributes.width = button_allocation.width;
9429 attributes.height = button_allocation.height;
9430 attributes.visual = gtk_widget_get_visual (GTK_WIDGET (tree_view));
9431 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
9432 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
9434 tree_view->priv->drag_window = gdk_window_new (tree_view->priv->bin_window,
9437 gdk_window_set_user_data (tree_view->priv->drag_window, GTK_WIDGET (tree_view));
9440 gdk_display_pointer_ungrab (display, GDK_CURRENT_TIME);
9441 gdk_display_keyboard_ungrab (display, GDK_CURRENT_TIME);
9443 gtk_grab_remove (column->button);
9445 send_event = gdk_event_new (GDK_LEAVE_NOTIFY);
9446 send_event->crossing.send_event = TRUE;
9447 send_event->crossing.window = g_object_ref (gtk_button_get_event_window (GTK_BUTTON (column->button)));
9448 send_event->crossing.subwindow = NULL;
9449 send_event->crossing.detail = GDK_NOTIFY_ANCESTOR;
9450 send_event->crossing.time = GDK_CURRENT_TIME;
9451 gdk_event_set_device (send_event, device);
9453 gtk_propagate_event (column->button, send_event);
9454 gdk_event_free (send_event);
9456 send_event = gdk_event_new (GDK_BUTTON_RELEASE);
9457 send_event->button.window = g_object_ref (gdk_screen_get_root_window (screen));
9458 send_event->button.send_event = TRUE;
9459 send_event->button.time = GDK_CURRENT_TIME;
9460 send_event->button.x = -1;
9461 send_event->button.y = -1;
9462 send_event->button.axes = NULL;
9463 send_event->button.state = 0;
9464 send_event->button.button = 1;
9465 send_event->button.x_root = 0;
9466 send_event->button.y_root = 0;
9467 gdk_event_set_device (send_event, device);
9469 gtk_propagate_event (column->button, send_event);
9470 gdk_event_free (send_event);
9472 /* Kids, don't try this at home */
9473 g_object_ref (column->button);
9474 gtk_container_remove (GTK_CONTAINER (tree_view), column->button);
9475 gtk_widget_set_parent_window (column->button, tree_view->priv->drag_window);
9476 gtk_widget_set_parent (column->button, GTK_WIDGET (tree_view));
9477 g_object_unref (column->button);
9479 gtk_widget_get_allocation (column->button, &button_allocation);
9480 tree_view->priv->drag_column_x = button_allocation.x;
9481 allocation = button_allocation;
9483 gtk_widget_size_allocate (column->button, &allocation);
9484 gtk_widget_set_parent_window (column->button, tree_view->priv->drag_window);
9486 tree_view->priv->drag_column = column;
9487 gdk_window_show (tree_view->priv->drag_window);
9489 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
9490 while (gtk_events_pending ())
9491 gtk_main_iteration ();
9493 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IN_COLUMN_DRAG);
9494 gdk_pointer_grab (tree_view->priv->drag_window,
9496 GDK_POINTER_MOTION_MASK|GDK_BUTTON_RELEASE_MASK,
9497 NULL, NULL, GDK_CURRENT_TIME);
9498 gdk_keyboard_grab (tree_view->priv->drag_window,
9504 gtk_tree_view_queue_draw_arrow (GtkTreeView *tree_view,
9508 GtkAllocation allocation;
9511 if (!gtk_widget_get_realized (GTK_WIDGET (tree_view)))
9514 gtk_widget_get_allocation (GTK_WIDGET (tree_view), &allocation);
9516 rect.width = MAX (tree_view->priv->expander_size, MAX (tree_view->priv->width, allocation.width));
9518 rect.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
9519 rect.height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
9521 gdk_window_invalidate_rect (tree_view->priv->bin_window, &rect, TRUE);
9525 _gtk_tree_view_queue_draw_node (GtkTreeView *tree_view,
9528 const GdkRectangle *clip_rect)
9530 GtkAllocation allocation;
9533 if (!gtk_widget_get_realized (GTK_WIDGET (tree_view)))
9536 gtk_widget_get_allocation (GTK_WIDGET (tree_view), &allocation);
9538 rect.width = MAX (tree_view->priv->width, allocation.width);
9540 rect.y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
9541 rect.height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
9545 GdkRectangle new_rect;
9547 gdk_rectangle_intersect (clip_rect, &rect, &new_rect);
9549 gdk_window_invalidate_rect (tree_view->priv->bin_window, &new_rect, TRUE);
9553 gdk_window_invalidate_rect (tree_view->priv->bin_window, &rect, TRUE);
9558 gtk_tree_view_queue_draw_path (GtkTreeView *tree_view,
9560 const GdkRectangle *clip_rect)
9562 GtkRBTree *tree = NULL;
9563 GtkRBNode *node = NULL;
9565 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
9568 _gtk_tree_view_queue_draw_node (tree_view, tree, node, clip_rect);
9571 /* x and y are the mouse position
9574 gtk_tree_view_draw_arrow (GtkTreeView *tree_view,
9578 /* in bin_window coordinates */
9587 gint vertical_separator;
9589 GtkExpanderStyle expander_style;
9591 widget = GTK_WIDGET (tree_view);
9593 gtk_widget_style_get (widget,
9594 "vertical-separator", &vertical_separator,
9596 expander_size = tree_view->priv->expander_size - EXPANDER_EXTRA_PADDING;
9598 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
9601 gtk_tree_view_get_arrow_xrange (tree_view, tree, &x_offset, &x2);
9604 area.y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
9605 area.width = expander_size + 2;
9606 area.height = MAX (CELL_HEIGHT (node, vertical_separator), (expander_size - vertical_separator));
9608 if (gtk_widget_get_state (widget) == GTK_STATE_INSENSITIVE)
9610 state = GTK_STATE_INSENSITIVE;
9612 else if (node == tree_view->priv->button_pressed_node)
9614 if (x >= area.x && x <= (area.x + area.width) &&
9615 y >= area.y && y <= (area.y + area.height))
9616 state = GTK_STATE_ACTIVE;
9618 state = GTK_STATE_NORMAL;
9622 if (node == tree_view->priv->prelight_node &&
9623 GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_ARROW_PRELIT))
9624 state = GTK_STATE_PRELIGHT;
9626 state = GTK_STATE_NORMAL;
9629 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
9630 expander_style = GTK_EXPANDER_SEMI_EXPANDED;
9631 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
9632 expander_style = GTK_EXPANDER_SEMI_COLLAPSED;
9633 else if (node->children != NULL)
9634 expander_style = GTK_EXPANDER_EXPANDED;
9636 expander_style = GTK_EXPANDER_COLLAPSED;
9638 gtk_paint_expander (gtk_widget_get_style (widget),
9643 area.x + area.width / 2,
9644 area.y + area.height / 2,
9649 gtk_tree_view_focus_to_cursor (GtkTreeView *tree_view)
9652 GtkTreePath *cursor_path;
9654 if ((tree_view->priv->tree == NULL) ||
9655 (! gtk_widget_get_realized (GTK_WIDGET (tree_view))))
9659 if (tree_view->priv->cursor)
9660 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9662 if (cursor_path == NULL)
9664 /* Consult the selection before defaulting to the
9665 * first focusable element
9667 GList *selected_rows;
9668 GtkTreeModel *model;
9669 GtkTreeSelection *selection;
9671 selection = gtk_tree_view_get_selection (tree_view);
9672 selected_rows = gtk_tree_selection_get_selected_rows (selection, &model);
9676 cursor_path = gtk_tree_path_copy((const GtkTreePath *)(selected_rows->data));
9677 g_list_foreach (selected_rows, (GFunc)gtk_tree_path_free, NULL);
9678 g_list_free (selected_rows);
9682 cursor_path = gtk_tree_path_new_first ();
9683 search_first_focusable_path (tree_view, &cursor_path,
9687 gtk_tree_row_reference_free (tree_view->priv->cursor);
9688 tree_view->priv->cursor = NULL;
9692 if (tree_view->priv->selection->type == GTK_SELECTION_MULTIPLE)
9693 gtk_tree_view_real_set_cursor (tree_view, cursor_path, FALSE, FALSE);
9695 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, FALSE);
9701 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
9703 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
9704 gtk_tree_path_free (cursor_path);
9706 if (tree_view->priv->focus_column == NULL)
9709 for (list = tree_view->priv->columns; list; list = list->next)
9711 if (gtk_tree_view_column_get_visible (GTK_TREE_VIEW_COLUMN (list->data)))
9713 tree_view->priv->focus_column = GTK_TREE_VIEW_COLUMN (list->data);
9722 gtk_tree_view_move_cursor_up_down (GtkTreeView *tree_view,
9725 gint selection_count;
9726 GtkRBTree *cursor_tree = NULL;
9727 GtkRBNode *cursor_node = NULL;
9728 GtkRBTree *new_cursor_tree = NULL;
9729 GtkRBNode *new_cursor_node = NULL;
9730 GtkTreePath *cursor_path = NULL;
9731 gboolean grab_focus = TRUE;
9732 gboolean selectable;
9734 if (! gtk_widget_has_focus (GTK_WIDGET (tree_view)))
9738 if (!gtk_tree_row_reference_valid (tree_view->priv->cursor))
9739 /* FIXME: we lost the cursor; should we get the first? */
9742 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9743 _gtk_tree_view_find_node (tree_view, cursor_path,
9744 &cursor_tree, &cursor_node);
9746 if (cursor_tree == NULL)
9747 /* FIXME: we lost the cursor; should we get the first? */
9750 selection_count = gtk_tree_selection_count_selected_rows (tree_view->priv->selection);
9751 selectable = _gtk_tree_selection_row_is_selectable (tree_view->priv->selection,
9755 if (selection_count == 0
9756 && tree_view->priv->selection->type != GTK_SELECTION_NONE
9757 && !tree_view->priv->ctrl_pressed
9760 /* Don't move the cursor, but just select the current node */
9761 new_cursor_tree = cursor_tree;
9762 new_cursor_node = cursor_node;
9767 _gtk_rbtree_prev_full (cursor_tree, cursor_node,
9768 &new_cursor_tree, &new_cursor_node);
9770 _gtk_rbtree_next_full (cursor_tree, cursor_node,
9771 &new_cursor_tree, &new_cursor_node);
9774 gtk_tree_path_free (cursor_path);
9776 if (new_cursor_node)
9778 cursor_path = _gtk_tree_view_find_path (tree_view,
9779 new_cursor_tree, new_cursor_node);
9781 search_first_focusable_path (tree_view, &cursor_path,
9787 gtk_tree_path_free (cursor_path);
9791 * If the list has only one item and multi-selection is set then select
9792 * the row (if not yet selected).
9794 if (tree_view->priv->selection->type == GTK_SELECTION_MULTIPLE &&
9795 new_cursor_node == NULL)
9798 _gtk_rbtree_next_full (cursor_tree, cursor_node,
9799 &new_cursor_tree, &new_cursor_node);
9801 _gtk_rbtree_prev_full (cursor_tree, cursor_node,
9802 &new_cursor_tree, &new_cursor_node);
9804 if (new_cursor_node == NULL
9805 && !GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_SELECTED))
9807 new_cursor_node = cursor_node;
9808 new_cursor_tree = cursor_tree;
9812 new_cursor_node = NULL;
9816 if (new_cursor_node)
9818 cursor_path = _gtk_tree_view_find_path (tree_view, new_cursor_tree, new_cursor_node);
9819 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, TRUE);
9820 gtk_tree_path_free (cursor_path);
9824 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
9826 if (!tree_view->priv->shift_pressed)
9828 if (! gtk_widget_keynav_failed (GTK_WIDGET (tree_view),
9830 GTK_DIR_UP : GTK_DIR_DOWN))
9832 GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (tree_view));
9835 gtk_widget_child_focus (toplevel,
9837 GTK_DIR_TAB_BACKWARD :
9838 GTK_DIR_TAB_FORWARD);
9845 gtk_widget_error_bell (GTK_WIDGET (tree_view));
9850 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
9854 gtk_tree_view_move_cursor_page_up_down (GtkTreeView *tree_view,
9857 GtkRBTree *cursor_tree = NULL;
9858 GtkRBNode *cursor_node = NULL;
9859 GtkTreePath *old_cursor_path = NULL;
9860 GtkTreePath *cursor_path = NULL;
9861 GtkRBTree *start_cursor_tree = NULL;
9862 GtkRBNode *start_cursor_node = NULL;
9865 gint vertical_separator;
9867 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
9870 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
9871 old_cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9873 /* This is sorta weird. Focus in should give us a cursor */
9876 gtk_widget_style_get (GTK_WIDGET (tree_view), "vertical-separator", &vertical_separator, NULL);
9877 _gtk_tree_view_find_node (tree_view, old_cursor_path,
9878 &cursor_tree, &cursor_node);
9880 if (cursor_tree == NULL)
9882 /* FIXME: we lost the cursor. Should we try to get one? */
9883 gtk_tree_path_free (old_cursor_path);
9886 g_return_if_fail (cursor_node != NULL);
9888 y = _gtk_rbtree_node_find_offset (cursor_tree, cursor_node);
9889 window_y = RBTREE_Y_TO_TREE_WINDOW_Y (tree_view, y);
9890 y += tree_view->priv->cursor_offset;
9891 y += count * (int)tree_view->priv->vadjustment->page_increment;
9892 y = CLAMP (y, (gint)tree_view->priv->vadjustment->lower, (gint)tree_view->priv->vadjustment->upper - vertical_separator);
9894 if (y >= tree_view->priv->height)
9895 y = tree_view->priv->height - 1;
9897 tree_view->priv->cursor_offset =
9898 _gtk_rbtree_find_offset (tree_view->priv->tree, y,
9899 &cursor_tree, &cursor_node);
9901 if (cursor_tree == NULL)
9903 /* FIXME: we lost the cursor. Should we try to get one? */
9904 gtk_tree_path_free (old_cursor_path);
9908 if (tree_view->priv->cursor_offset > BACKGROUND_HEIGHT (cursor_node))
9910 _gtk_rbtree_next_full (cursor_tree, cursor_node,
9911 &cursor_tree, &cursor_node);
9912 tree_view->priv->cursor_offset -= BACKGROUND_HEIGHT (cursor_node);
9915 y -= tree_view->priv->cursor_offset;
9916 cursor_path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
9918 start_cursor_tree = cursor_tree;
9919 start_cursor_node = cursor_node;
9921 if (! search_first_focusable_path (tree_view, &cursor_path,
9923 &cursor_tree, &cursor_node))
9925 /* It looks like we reached the end of the view without finding
9926 * a focusable row. We will step backwards to find the last
9929 cursor_tree = start_cursor_tree;
9930 cursor_node = start_cursor_node;
9931 cursor_path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
9933 search_first_focusable_path (tree_view, &cursor_path,
9935 &cursor_tree, &cursor_node);
9942 y = _gtk_rbtree_node_find_offset (cursor_tree, cursor_node);
9944 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, FALSE);
9947 gtk_tree_view_scroll_to_point (tree_view, -1, y);
9948 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
9949 _gtk_tree_view_queue_draw_node (tree_view, cursor_tree, cursor_node, NULL);
9951 if (!gtk_tree_path_compare (old_cursor_path, cursor_path))
9952 gtk_widget_error_bell (GTK_WIDGET (tree_view));
9954 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
9957 gtk_tree_path_free (old_cursor_path);
9958 gtk_tree_path_free (cursor_path);
9962 gtk_tree_view_move_cursor_left_right (GtkTreeView *tree_view,
9965 GtkRBTree *cursor_tree = NULL;
9966 GtkRBNode *cursor_node = NULL;
9967 GtkTreePath *cursor_path = NULL;
9968 GtkTreeViewColumn *column;
9971 gboolean found_column = FALSE;
9974 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
9976 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
9979 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
9980 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
9984 _gtk_tree_view_find_node (tree_view, cursor_path, &cursor_tree, &cursor_node);
9985 if (cursor_tree == NULL)
9987 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, cursor_path) == FALSE)
9989 gtk_tree_path_free (cursor_path);
9992 gtk_tree_path_free (cursor_path);
9994 list = rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns);
9995 if (tree_view->priv->focus_column)
9997 for (; list; list = (rtl ? list->prev : list->next))
9999 if (list->data == tree_view->priv->focus_column)
10006 gboolean left, right;
10008 column = list->data;
10009 if (gtk_tree_view_column_get_visible (column) == FALSE)
10012 gtk_tree_view_column_cell_set_cell_data (column,
10013 tree_view->priv->model,
10015 GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_PARENT),
10016 cursor_node->children?TRUE:FALSE);
10020 right = list->prev ? TRUE : FALSE;
10021 left = list->next ? TRUE : FALSE;
10025 left = list->prev ? TRUE : FALSE;
10026 right = list->next ? TRUE : FALSE;
10029 if (_gtk_tree_view_column_cell_focus (column, count, left, right))
10031 tree_view->priv->focus_column = column;
10032 found_column = TRUE;
10037 list = rtl ? list->prev : list->next;
10039 list = rtl ? list->next : list->prev;
10044 if (!gtk_tree_view_has_special_cell (tree_view))
10045 _gtk_tree_view_queue_draw_node (tree_view,
10049 g_signal_emit (tree_view, tree_view_signals[CURSOR_CHANGED], 0);
10050 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
10054 gtk_widget_error_bell (GTK_WIDGET (tree_view));
10057 gtk_tree_view_clamp_column_visible (tree_view,
10058 tree_view->priv->focus_column, TRUE);
10062 gtk_tree_view_move_cursor_start_end (GtkTreeView *tree_view,
10065 GtkRBTree *cursor_tree;
10066 GtkRBNode *cursor_node;
10068 GtkTreePath *old_path;
10070 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
10073 g_return_if_fail (tree_view->priv->tree != NULL);
10075 gtk_tree_view_get_cursor (tree_view, &old_path, NULL);
10077 cursor_tree = tree_view->priv->tree;
10078 cursor_node = cursor_tree->root;
10082 while (cursor_node && cursor_node->left != cursor_tree->nil)
10083 cursor_node = cursor_node->left;
10085 /* Now go forward to find the first focusable row. */
10086 path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
10087 search_first_focusable_path (tree_view, &path,
10088 TRUE, &cursor_tree, &cursor_node);
10094 while (cursor_node && cursor_node->right != cursor_tree->nil)
10095 cursor_node = cursor_node->right;
10096 if (cursor_node->children == NULL)
10099 cursor_tree = cursor_node->children;
10100 cursor_node = cursor_tree->root;
10104 /* Now go backwards to find last focusable row. */
10105 path = _gtk_tree_view_find_path (tree_view, cursor_tree, cursor_node);
10106 search_first_focusable_path (tree_view, &path,
10107 FALSE, &cursor_tree, &cursor_node);
10113 if (gtk_tree_path_compare (old_path, path))
10115 gtk_tree_view_real_set_cursor (tree_view, path, TRUE, TRUE);
10116 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
10120 gtk_widget_error_bell (GTK_WIDGET (tree_view));
10124 gtk_tree_path_free (old_path);
10125 gtk_tree_path_free (path);
10129 gtk_tree_view_real_select_all (GtkTreeView *tree_view)
10131 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
10134 if (tree_view->priv->selection->type != GTK_SELECTION_MULTIPLE)
10137 gtk_tree_selection_select_all (tree_view->priv->selection);
10143 gtk_tree_view_real_unselect_all (GtkTreeView *tree_view)
10145 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
10148 if (tree_view->priv->selection->type != GTK_SELECTION_MULTIPLE)
10151 gtk_tree_selection_unselect_all (tree_view->priv->selection);
10157 gtk_tree_view_real_select_cursor_row (GtkTreeView *tree_view,
10158 gboolean start_editing)
10160 GtkRBTree *new_tree = NULL;
10161 GtkRBNode *new_node = NULL;
10162 GtkRBTree *cursor_tree = NULL;
10163 GtkRBNode *cursor_node = NULL;
10164 GtkTreePath *cursor_path = NULL;
10165 GtkTreeSelectMode mode = 0;
10167 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
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);
10179 if (cursor_tree == NULL)
10181 gtk_tree_path_free (cursor_path);
10185 if (!tree_view->priv->shift_pressed && start_editing &&
10186 tree_view->priv->focus_column)
10188 if (gtk_tree_view_start_editing (tree_view, cursor_path))
10190 gtk_tree_path_free (cursor_path);
10195 if (tree_view->priv->ctrl_pressed)
10196 mode |= GTK_TREE_SELECT_MODE_TOGGLE;
10197 if (tree_view->priv->shift_pressed)
10198 mode |= GTK_TREE_SELECT_MODE_EXTEND;
10200 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
10207 /* We bail out if the original (tree, node) don't exist anymore after
10208 * handling the selection-changed callback. We do return TRUE because
10209 * the key press has been handled at this point.
10211 _gtk_tree_view_find_node (tree_view, cursor_path, &new_tree, &new_node);
10213 if (cursor_tree != new_tree || cursor_node != new_node)
10216 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
10218 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
10219 _gtk_tree_view_queue_draw_node (tree_view, cursor_tree, cursor_node, NULL);
10221 if (!tree_view->priv->shift_pressed)
10222 gtk_tree_view_row_activated (tree_view, cursor_path,
10223 tree_view->priv->focus_column);
10225 gtk_tree_path_free (cursor_path);
10231 gtk_tree_view_real_toggle_cursor_row (GtkTreeView *tree_view)
10233 GtkRBTree *new_tree = NULL;
10234 GtkRBNode *new_node = NULL;
10235 GtkRBTree *cursor_tree = NULL;
10236 GtkRBNode *cursor_node = NULL;
10237 GtkTreePath *cursor_path = NULL;
10239 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
10242 cursor_path = NULL;
10243 if (tree_view->priv->cursor)
10244 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
10246 if (cursor_path == NULL)
10249 _gtk_tree_view_find_node (tree_view, cursor_path,
10250 &cursor_tree, &cursor_node);
10251 if (cursor_tree == NULL)
10253 gtk_tree_path_free (cursor_path);
10257 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
10261 GTK_TREE_SELECT_MODE_TOGGLE,
10264 /* We bail out if the original (tree, node) don't exist anymore after
10265 * handling the selection-changed callback. We do return TRUE because
10266 * the key press has been handled at this point.
10268 _gtk_tree_view_find_node (tree_view, cursor_path, &new_tree, &new_node);
10270 if (cursor_tree != new_tree || cursor_node != new_node)
10273 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
10275 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
10276 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
10277 gtk_tree_path_free (cursor_path);
10283 gtk_tree_view_real_expand_collapse_cursor_row (GtkTreeView *tree_view,
10288 GtkTreePath *cursor_path = NULL;
10292 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
10295 cursor_path = NULL;
10296 if (tree_view->priv->cursor)
10297 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
10299 if (cursor_path == NULL)
10302 if (_gtk_tree_view_find_node (tree_view, cursor_path, &tree, &node))
10305 /* Don't handle the event if we aren't an expander */
10306 if (!((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT))
10310 && gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL)
10314 gtk_tree_view_real_expand_row (tree_view, cursor_path, tree, node, open_all, TRUE);
10316 gtk_tree_view_real_collapse_row (tree_view, cursor_path, tree, node, TRUE);
10318 gtk_tree_path_free (cursor_path);
10324 gtk_tree_view_real_select_cursor_parent (GtkTreeView *tree_view)
10326 GtkRBTree *cursor_tree = NULL;
10327 GtkRBNode *cursor_node = NULL;
10328 GtkTreePath *cursor_path = NULL;
10329 GdkModifierType state;
10331 if (!gtk_widget_has_focus (GTK_WIDGET (tree_view)))
10334 cursor_path = NULL;
10335 if (tree_view->priv->cursor)
10336 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
10338 if (cursor_path == NULL)
10341 _gtk_tree_view_find_node (tree_view, cursor_path,
10342 &cursor_tree, &cursor_node);
10343 if (cursor_tree == NULL)
10345 gtk_tree_path_free (cursor_path);
10349 if (cursor_tree->parent_node)
10351 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
10352 cursor_node = cursor_tree->parent_node;
10353 cursor_tree = cursor_tree->parent_tree;
10355 gtk_tree_path_up (cursor_path);
10357 if (gtk_get_current_event_state (&state))
10359 if ((state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
10360 tree_view->priv->ctrl_pressed = TRUE;
10363 gtk_tree_view_real_set_cursor (tree_view, cursor_path, TRUE, FALSE);
10364 gtk_tree_view_clamp_node_visible (tree_view, cursor_tree, cursor_node);
10366 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
10367 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
10368 gtk_tree_path_free (cursor_path);
10370 tree_view->priv->ctrl_pressed = FALSE;
10377 tree_view->priv->search_entry_avoid_unhandled_binding = TRUE;
10382 gtk_tree_view_search_entry_flush_timeout (GtkTreeView *tree_view)
10384 gtk_tree_view_search_dialog_hide (tree_view->priv->search_window, tree_view, NULL);
10385 tree_view->priv->typeselect_flush_timeout = 0;
10390 /* Cut and paste from gtkwindow.c */
10392 send_focus_change (GtkWidget *widget,
10396 GdkDeviceManager *device_manager;
10397 GList *devices, *d;
10399 device_manager = gdk_display_get_device_manager (gtk_widget_get_display (widget));
10400 devices = gdk_device_manager_list_devices (device_manager, GDK_DEVICE_TYPE_MASTER);
10401 devices = g_list_concat (devices, gdk_device_manager_list_devices (device_manager, GDK_DEVICE_TYPE_SLAVE));
10402 devices = g_list_concat (devices, gdk_device_manager_list_devices (device_manager, GDK_DEVICE_TYPE_FLOATING));
10404 for (d = devices; d; d = d->next)
10406 GdkDevice *dev = d->data;
10410 if (gdk_device_get_source (dev) != GDK_SOURCE_KEYBOARD)
10413 window = gtk_widget_get_window (widget);
10415 /* Skip non-master keyboards that haven't
10416 * selected for events from this window
10418 if (gdk_device_get_device_type (dev) != GDK_DEVICE_TYPE_MASTER &&
10419 !gdk_window_get_device_events (window, dev))
10422 fevent = gdk_event_new (GDK_FOCUS_CHANGE);
10424 fevent->focus_change.type = GDK_FOCUS_CHANGE;
10425 fevent->focus_change.window = g_object_ref (window);
10426 fevent->focus_change.in = in;
10427 gdk_event_set_device (fevent, device);
10429 gtk_widget_send_focus_change (widget, fevent);
10431 gdk_event_free (fevent);
10436 gtk_tree_view_ensure_interactive_directory (GtkTreeView *tree_view)
10438 GtkWidget *frame, *vbox, *toplevel;
10441 if (tree_view->priv->search_custom_entry_set)
10444 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (tree_view));
10445 screen = gtk_widget_get_screen (GTK_WIDGET (tree_view));
10447 if (tree_view->priv->search_window != NULL)
10449 if (gtk_window_has_group (GTK_WINDOW (toplevel)))
10450 gtk_window_group_add_window (gtk_window_get_group (GTK_WINDOW (toplevel)),
10451 GTK_WINDOW (tree_view->priv->search_window));
10452 else if (gtk_window_has_group (GTK_WINDOW (tree_view->priv->search_window)))
10453 gtk_window_group_remove_window (gtk_window_get_group (GTK_WINDOW (tree_view->priv->search_window)),
10454 GTK_WINDOW (tree_view->priv->search_window));
10456 gtk_window_set_screen (GTK_WINDOW (tree_view->priv->search_window), screen);
10461 tree_view->priv->search_window = gtk_window_new (GTK_WINDOW_POPUP);
10462 gtk_window_set_screen (GTK_WINDOW (tree_view->priv->search_window), screen);
10464 if (gtk_window_has_group (GTK_WINDOW (toplevel)))
10465 gtk_window_group_add_window (gtk_window_get_group (GTK_WINDOW (toplevel)),
10466 GTK_WINDOW (tree_view->priv->search_window));
10468 gtk_window_set_type_hint (GTK_WINDOW (tree_view->priv->search_window),
10469 GDK_WINDOW_TYPE_HINT_UTILITY);
10470 gtk_window_set_modal (GTK_WINDOW (tree_view->priv->search_window), TRUE);
10471 g_signal_connect (tree_view->priv->search_window, "delete-event",
10472 G_CALLBACK (gtk_tree_view_search_delete_event),
10474 g_signal_connect (tree_view->priv->search_window, "key-press-event",
10475 G_CALLBACK (gtk_tree_view_search_key_press_event),
10477 g_signal_connect (tree_view->priv->search_window, "button-press-event",
10478 G_CALLBACK (gtk_tree_view_search_button_press_event),
10480 g_signal_connect (tree_view->priv->search_window, "scroll-event",
10481 G_CALLBACK (gtk_tree_view_search_scroll_event),
10484 frame = gtk_frame_new (NULL);
10485 gtk_frame_set_shadow_type (GTK_FRAME (frame), GTK_SHADOW_ETCHED_IN);
10486 gtk_widget_show (frame);
10487 gtk_container_add (GTK_CONTAINER (tree_view->priv->search_window), frame);
10489 vbox = gtk_box_new (GTK_ORIENTATION_VERTICAL, 0);
10490 gtk_widget_show (vbox);
10491 gtk_container_add (GTK_CONTAINER (frame), vbox);
10492 gtk_container_set_border_width (GTK_CONTAINER (vbox), 3);
10495 tree_view->priv->search_entry = gtk_entry_new ();
10496 gtk_widget_show (tree_view->priv->search_entry);
10497 g_signal_connect (tree_view->priv->search_entry, "populate-popup",
10498 G_CALLBACK (gtk_tree_view_search_disable_popdown),
10500 g_signal_connect (tree_view->priv->search_entry,
10501 "activate", G_CALLBACK (gtk_tree_view_search_activate),
10504 g_signal_connect (_gtk_entry_get_im_context (GTK_ENTRY (tree_view->priv->search_entry)),
10506 G_CALLBACK (gtk_tree_view_search_preedit_changed),
10509 gtk_container_add (GTK_CONTAINER (vbox),
10510 tree_view->priv->search_entry);
10512 gtk_widget_realize (tree_view->priv->search_entry);
10515 /* Pops up the interactive search entry. If keybinding is TRUE then the user
10516 * started this by typing the start_interactive_search keybinding. Otherwise, it came from
10519 gtk_tree_view_real_start_interactive_search (GtkTreeView *tree_view,
10521 gboolean keybinding)
10523 /* We only start interactive search if we have focus or the columns
10524 * have focus. If one of our children have focus, we don't want to
10525 * start the search.
10528 gboolean found_focus = FALSE;
10529 GtkWidgetClass *entry_parent_class;
10531 if (!tree_view->priv->enable_search && !keybinding)
10534 if (tree_view->priv->search_custom_entry_set)
10537 if (tree_view->priv->search_window != NULL &&
10538 gtk_widget_get_visible (tree_view->priv->search_window))
10541 for (list = tree_view->priv->columns; list; list = list->next)
10543 GtkTreeViewColumn *column;
10545 column = list->data;
10546 if (!gtk_tree_view_column_get_visible (column))
10549 if (gtk_widget_has_focus (column->button))
10551 found_focus = TRUE;
10556 if (gtk_widget_has_focus (GTK_WIDGET (tree_view)))
10557 found_focus = TRUE;
10562 if (tree_view->priv->search_column < 0)
10565 gtk_tree_view_ensure_interactive_directory (tree_view);
10568 gtk_entry_set_text (GTK_ENTRY (tree_view->priv->search_entry), "");
10570 /* done, show it */
10571 tree_view->priv->search_position_func (tree_view, tree_view->priv->search_window, tree_view->priv->search_position_user_data);
10572 gtk_widget_show (tree_view->priv->search_window);
10573 if (tree_view->priv->search_entry_changed_id == 0)
10575 tree_view->priv->search_entry_changed_id =
10576 g_signal_connect (tree_view->priv->search_entry, "changed",
10577 G_CALLBACK (gtk_tree_view_search_init),
10581 tree_view->priv->typeselect_flush_timeout =
10582 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
10583 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
10586 /* Grab focus will select all the text. We don't want that to happen, so we
10587 * call the parent instance and bypass the selection change. This is probably
10588 * really non-kosher. */
10589 entry_parent_class = g_type_class_peek_parent (GTK_ENTRY_GET_CLASS (tree_view->priv->search_entry));
10590 (entry_parent_class->grab_focus) (tree_view->priv->search_entry);
10592 /* send focus-in event */
10593 send_focus_change (tree_view->priv->search_entry, device, TRUE);
10595 /* search first matching iter */
10596 gtk_tree_view_search_init (tree_view->priv->search_entry, tree_view);
10602 gtk_tree_view_start_interactive_search (GtkTreeView *tree_view)
10604 return gtk_tree_view_real_start_interactive_search (tree_view,
10605 gtk_get_current_event_device (),
10609 /* this function returns the new width of the column being resized given
10610 * the column and x position of the cursor; the x cursor position is passed
10611 * in as a pointer and automagicly corrected if it's beyond min/max limits
10614 gtk_tree_view_new_column_width (GtkTreeView *tree_view,
10618 GtkAllocation allocation;
10619 GtkTreeViewColumn *column;
10620 GtkRequisition button_req;
10621 gint max_width, min_width;
10625 /* first translate the x position from widget->window
10626 * to clist->clist_window
10628 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
10629 column = g_list_nth (tree_view->priv->columns, i)->data;
10630 gtk_widget_get_allocation (column->button, &allocation);
10631 width = rtl ? (allocation.x + allocation.width - *x) : (*x - allocation.x);
10633 /* Clamp down the value */
10634 min_width = gtk_tree_view_column_get_min_width (column);
10635 if (min_width == -1)
10637 gtk_widget_get_preferred_size (column->button, &button_req, NULL);
10638 width = MAX (button_req.width, width);
10641 width = MAX (min_width, width);
10643 max_width = gtk_tree_view_column_get_max_width (column);
10644 if (max_width != -1)
10645 width = MIN (width, max_width);
10647 *x = rtl ? (allocation.x + allocation.width - width) : (allocation.x + width);
10653 /* FIXME this adjust_allocation is a big cut-and-paste from
10654 * GtkCList, needs to be some "official" way to do this
10664 /* The window to which widget->window is relative */
10665 #define ALLOCATION_WINDOW(widget) \
10666 (!gtk_widget_get_has_window (widget) ? \
10667 gtk_widget_get_window (widget) : \
10668 gdk_window_get_parent (gtk_widget_get_window (widget)))
10671 adjust_allocation_recurse (GtkWidget *widget,
10674 GtkAllocation allocation;
10675 ScrollData *scroll_data = data;
10677 /* Need to really size allocate instead of just poking
10678 * into widget->allocation if the widget is not realized.
10679 * FIXME someone figure out why this was.
10681 gtk_widget_get_allocation (widget, &allocation);
10682 if (!gtk_widget_get_realized (widget))
10684 if (gtk_widget_get_visible (widget))
10686 GdkRectangle tmp_rectangle = allocation;
10687 tmp_rectangle.x += scroll_data->dx;
10688 tmp_rectangle.y += scroll_data->dy;
10690 gtk_widget_size_allocate (widget, &tmp_rectangle);
10695 if (ALLOCATION_WINDOW (widget) == scroll_data->window)
10697 allocation.x += scroll_data->dx;
10698 allocation.y += scroll_data->dy;
10699 gtk_widget_set_allocation (widget, &allocation);
10701 if (GTK_IS_CONTAINER (widget))
10702 gtk_container_forall (GTK_CONTAINER (widget),
10703 adjust_allocation_recurse,
10710 adjust_allocation (GtkWidget *widget,
10714 ScrollData scroll_data;
10716 if (gtk_widget_get_realized (widget))
10717 scroll_data.window = ALLOCATION_WINDOW (widget);
10719 scroll_data.window = NULL;
10721 scroll_data.dx = dx;
10722 scroll_data.dy = dy;
10724 adjust_allocation_recurse (widget, &scroll_data);
10729 gtk_tree_view_adjustment_changed (GtkAdjustment *adjustment,
10730 GtkTreeView *tree_view)
10732 if (gtk_widget_get_realized (GTK_WIDGET (tree_view)))
10736 gdk_window_move (tree_view->priv->bin_window,
10737 - tree_view->priv->hadjustment->value,
10738 TREE_VIEW_HEADER_HEIGHT (tree_view));
10739 gdk_window_move (tree_view->priv->header_window,
10740 - tree_view->priv->hadjustment->value,
10742 dy = tree_view->priv->dy - (int) tree_view->priv->vadjustment->value;
10745 update_prelight (tree_view,
10746 tree_view->priv->event_last_x,
10747 tree_view->priv->event_last_y - dy);
10749 if (tree_view->priv->edited_column &&
10750 GTK_IS_WIDGET (tree_view->priv->edited_column->editable_widget))
10754 GtkTreeViewChild *child = NULL;
10756 widget = GTK_WIDGET (tree_view->priv->edited_column->editable_widget);
10757 adjust_allocation (widget, 0, dy);
10759 for (list = tree_view->priv->children; list; list = list->next)
10761 child = (GtkTreeViewChild *)list->data;
10762 if (child->widget == widget)
10770 gdk_window_scroll (tree_view->priv->bin_window, 0, dy);
10772 if (tree_view->priv->dy != (int) tree_view->priv->vadjustment->value)
10774 /* update our dy and top_row */
10775 tree_view->priv->dy = (int) tree_view->priv->vadjustment->value;
10777 if (!tree_view->priv->in_top_row_to_dy)
10778 gtk_tree_view_dy_to_top_row (tree_view);
10781 gdk_window_process_updates (tree_view->priv->header_window, TRUE);
10782 gtk_tree_view_bin_process_updates (tree_view);
10792 * gtk_tree_view_new:
10794 * Creates a new #GtkTreeView widget.
10796 * Return value: A newly created #GtkTreeView widget.
10799 gtk_tree_view_new (void)
10801 return g_object_new (GTK_TYPE_TREE_VIEW, NULL);
10805 * gtk_tree_view_new_with_model:
10806 * @model: the model.
10808 * Creates a new #GtkTreeView widget with the model initialized to @model.
10810 * Return value: A newly created #GtkTreeView widget.
10813 gtk_tree_view_new_with_model (GtkTreeModel *model)
10815 return g_object_new (GTK_TYPE_TREE_VIEW, "model", model, NULL);
10818 /* Public Accessors
10822 * gtk_tree_view_get_model:
10823 * @tree_view: a #GtkTreeView
10825 * Returns the model the #GtkTreeView is based on. Returns %NULL if the
10828 * Return value: (transfer none): A #GtkTreeModel, or %NULL if none is currently being used.
10831 gtk_tree_view_get_model (GtkTreeView *tree_view)
10833 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
10835 return tree_view->priv->model;
10839 * gtk_tree_view_set_model:
10840 * @tree_view: A #GtkTreeNode.
10841 * @model: (allow-none): The model.
10843 * Sets the model for a #GtkTreeView. If the @tree_view already has a model
10844 * set, it will remove it before setting the new model. If @model is %NULL,
10845 * then it will unset the old model.
10848 gtk_tree_view_set_model (GtkTreeView *tree_view,
10849 GtkTreeModel *model)
10851 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
10852 g_return_if_fail (model == NULL || GTK_IS_TREE_MODEL (model));
10854 if (model == tree_view->priv->model)
10857 if (tree_view->priv->scroll_to_path)
10859 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
10860 tree_view->priv->scroll_to_path = NULL;
10863 if (tree_view->priv->model)
10865 GList *tmplist = tree_view->priv->columns;
10867 gtk_tree_view_unref_and_check_selection_tree (tree_view, tree_view->priv->tree);
10868 gtk_tree_view_stop_editing (tree_view, TRUE);
10870 remove_expand_collapse_timeout (tree_view);
10872 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10873 gtk_tree_view_row_changed,
10875 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10876 gtk_tree_view_row_inserted,
10878 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10879 gtk_tree_view_row_has_child_toggled,
10881 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10882 gtk_tree_view_row_deleted,
10884 g_signal_handlers_disconnect_by_func (tree_view->priv->model,
10885 gtk_tree_view_rows_reordered,
10888 for (; tmplist; tmplist = tmplist->next)
10889 _gtk_tree_view_column_unset_model (tmplist->data,
10890 tree_view->priv->model);
10892 if (tree_view->priv->tree)
10893 gtk_tree_view_free_rbtree (tree_view);
10895 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
10896 tree_view->priv->drag_dest_row = NULL;
10897 gtk_tree_row_reference_free (tree_view->priv->cursor);
10898 tree_view->priv->cursor = NULL;
10899 gtk_tree_row_reference_free (tree_view->priv->anchor);
10900 tree_view->priv->anchor = NULL;
10901 gtk_tree_row_reference_free (tree_view->priv->top_row);
10902 tree_view->priv->top_row = NULL;
10903 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
10904 tree_view->priv->scroll_to_path = NULL;
10906 tree_view->priv->scroll_to_column = NULL;
10908 g_object_unref (tree_view->priv->model);
10910 tree_view->priv->search_column = -1;
10911 tree_view->priv->fixed_height_check = 0;
10912 tree_view->priv->fixed_height = -1;
10913 tree_view->priv->dy = tree_view->priv->top_row_dy = 0;
10914 tree_view->priv->last_button_x = -1;
10915 tree_view->priv->last_button_y = -1;
10918 tree_view->priv->model = model;
10920 if (tree_view->priv->model)
10925 GtkTreeModelFlags flags;
10927 if (tree_view->priv->search_column == -1)
10929 for (i = 0; i < gtk_tree_model_get_n_columns (model); i++)
10931 GType type = gtk_tree_model_get_column_type (model, i);
10933 if (g_value_type_transformable (type, G_TYPE_STRING))
10935 tree_view->priv->search_column = i;
10941 g_object_ref (tree_view->priv->model);
10942 g_signal_connect (tree_view->priv->model,
10944 G_CALLBACK (gtk_tree_view_row_changed),
10946 g_signal_connect (tree_view->priv->model,
10948 G_CALLBACK (gtk_tree_view_row_inserted),
10950 g_signal_connect (tree_view->priv->model,
10951 "row-has-child-toggled",
10952 G_CALLBACK (gtk_tree_view_row_has_child_toggled),
10954 g_signal_connect (tree_view->priv->model,
10956 G_CALLBACK (gtk_tree_view_row_deleted),
10958 g_signal_connect (tree_view->priv->model,
10960 G_CALLBACK (gtk_tree_view_rows_reordered),
10963 flags = gtk_tree_model_get_flags (tree_view->priv->model);
10964 if ((flags & GTK_TREE_MODEL_LIST_ONLY) == GTK_TREE_MODEL_LIST_ONLY)
10965 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
10967 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_IS_LIST);
10969 path = gtk_tree_path_new_first ();
10970 if (gtk_tree_model_get_iter (tree_view->priv->model, &iter, path))
10972 tree_view->priv->tree = _gtk_rbtree_new ();
10973 gtk_tree_view_build_tree (tree_view, tree_view->priv->tree, &iter, 1, FALSE);
10975 gtk_tree_path_free (path);
10977 /* FIXME: do I need to do this? gtk_tree_view_create_buttons (tree_view); */
10978 install_presize_handler (tree_view);
10981 g_object_notify (G_OBJECT (tree_view), "model");
10983 if (tree_view->priv->selection)
10984 _gtk_tree_selection_emit_changed (tree_view->priv->selection);
10986 if (gtk_widget_get_realized (GTK_WIDGET (tree_view)))
10987 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
10991 * gtk_tree_view_get_selection:
10992 * @tree_view: A #GtkTreeView.
10994 * Gets the #GtkTreeSelection associated with @tree_view.
10996 * Return value: (transfer none): A #GtkTreeSelection object.
10999 gtk_tree_view_get_selection (GtkTreeView *tree_view)
11001 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
11003 return tree_view->priv->selection;
11007 * gtk_tree_view_get_hadjustment:
11008 * @tree_view: A #GtkTreeView
11010 * Gets the #GtkAdjustment currently being used for the horizontal aspect.
11012 * Return value: (transfer none): A #GtkAdjustment object, or %NULL
11013 * if none is currently being used.
11015 * Deprecated: 3.0: Use gtk_scrollable_get_hadjustment()
11018 gtk_tree_view_get_hadjustment (GtkTreeView *tree_view)
11020 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
11022 return tree_view->priv->hadjustment;
11026 * gtk_tree_view_set_hadjustment:
11027 * @tree_view: A #GtkTreeView
11028 * @adjustment: (allow-none): The #GtkAdjustment to set, or %NULL
11030 * Sets the #GtkAdjustment for the current horizontal aspect.
11032 * Deprecated: 3.0: Use gtk_scrollable_set_hadjustment()
11035 gtk_tree_view_set_hadjustment (GtkTreeView *tree_view,
11036 GtkAdjustment *adjustment)
11038 GtkTreeViewPrivate *priv = tree_view->priv;
11040 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11041 g_return_if_fail (adjustment == NULL || GTK_IS_ADJUSTMENT (adjustment));
11043 if (adjustment && priv->hadjustment == adjustment)
11046 if (priv->hadjustment != NULL)
11048 g_signal_handlers_disconnect_by_func (priv->hadjustment,
11049 gtk_tree_view_adjustment_changed,
11051 g_object_unref (priv->hadjustment);
11054 if (adjustment == NULL)
11055 adjustment = gtk_adjustment_new (0.0, 0.0, 0.0,
11058 g_signal_connect (adjustment, "value-changed",
11059 G_CALLBACK (gtk_tree_view_adjustment_changed), tree_view);
11060 priv->hadjustment = g_object_ref_sink (adjustment);
11061 /* FIXME: Adjustment should probably be populated here with fresh values, but
11062 * internal details are too complicated for me to decipher right now.
11064 gtk_tree_view_adjustment_changed (NULL, tree_view);
11066 g_object_notify (G_OBJECT (tree_view), "hadjustment");
11070 * gtk_tree_view_get_vadjustment:
11071 * @tree_view: A #GtkTreeView
11073 * Gets the #GtkAdjustment currently being used for the vertical aspect.
11075 * Return value: (transfer none): A #GtkAdjustment object, or %NULL
11076 * if none is currently being used.
11078 * Deprecated: 3.0: Use gtk_scrollable_get_vadjustment()
11081 gtk_tree_view_get_vadjustment (GtkTreeView *tree_view)
11083 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
11085 return tree_view->priv->vadjustment;
11089 * gtk_tree_view_set_vadjustment:
11090 * @tree_view: A #GtkTreeView
11091 * @adjustment: (allow-none): The #GtkAdjustment to set, or %NULL
11093 * Sets the #GtkAdjustment for the current vertical aspect.
11095 * Deprecated: 3.0: Use gtk_scrollable_set_vadjustment()
11098 gtk_tree_view_set_vadjustment (GtkTreeView *tree_view,
11099 GtkAdjustment *adjustment)
11101 GtkTreeViewPrivate *priv = tree_view->priv;
11103 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11104 g_return_if_fail (adjustment == NULL || GTK_IS_ADJUSTMENT (adjustment));
11106 if (adjustment && priv->vadjustment == adjustment)
11109 if (priv->vadjustment != NULL)
11111 g_signal_handlers_disconnect_by_func (priv->vadjustment,
11112 gtk_tree_view_adjustment_changed,
11114 g_object_unref (priv->vadjustment);
11117 if (adjustment == NULL)
11118 adjustment = gtk_adjustment_new (0.0, 0.0, 0.0,
11121 g_signal_connect (adjustment, "value-changed",
11122 G_CALLBACK (gtk_tree_view_adjustment_changed), tree_view);
11123 priv->vadjustment = g_object_ref_sink (adjustment);
11124 /* FIXME: Adjustment should probably be populated here with fresh values, but
11125 * internal details are too complicated for me to decipher right now.
11127 gtk_tree_view_adjustment_changed (NULL, tree_view);
11128 g_object_notify (G_OBJECT (tree_view), "vadjustment");
11131 /* Column and header operations */
11134 * gtk_tree_view_get_headers_visible:
11135 * @tree_view: A #GtkTreeView.
11137 * Returns %TRUE if the headers on the @tree_view are visible.
11139 * Return value: Whether the headers are visible or not.
11142 gtk_tree_view_get_headers_visible (GtkTreeView *tree_view)
11144 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
11146 return GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
11150 * gtk_tree_view_set_headers_visible:
11151 * @tree_view: A #GtkTreeView.
11152 * @headers_visible: %TRUE if the headers are visible
11154 * Sets the visibility state of the headers.
11157 gtk_tree_view_set_headers_visible (GtkTreeView *tree_view,
11158 gboolean headers_visible)
11162 GtkTreeViewColumn *column;
11163 GtkAllocation allocation;
11165 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11167 headers_visible = !! headers_visible;
11169 if (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE) == headers_visible)
11172 if (headers_visible)
11173 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
11175 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE);
11177 if (gtk_widget_get_realized (GTK_WIDGET (tree_view)))
11179 gdk_window_get_position (tree_view->priv->bin_window, &x, &y);
11180 if (headers_visible)
11182 gtk_widget_get_allocation (GTK_WIDGET (tree_view), &allocation);
11183 gdk_window_move_resize (tree_view->priv->bin_window,
11184 x, y + TREE_VIEW_HEADER_HEIGHT (tree_view),
11185 tree_view->priv->width, allocation.height - + TREE_VIEW_HEADER_HEIGHT (tree_view));
11187 if (gtk_widget_get_mapped (GTK_WIDGET (tree_view)))
11188 gtk_tree_view_map_buttons (tree_view);
11192 gdk_window_move_resize (tree_view->priv->bin_window, x, y, tree_view->priv->width, tree_view->priv->height);
11194 for (list = tree_view->priv->columns; list; list = list->next)
11196 column = list->data;
11197 gtk_widget_unmap (column->button);
11199 gdk_window_hide (tree_view->priv->header_window);
11203 gtk_widget_get_allocation (GTK_WIDGET (tree_view), &allocation);
11204 tree_view->priv->vadjustment->page_size = allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
11205 tree_view->priv->vadjustment->page_increment = (allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view)) / 2;
11206 tree_view->priv->vadjustment->lower = 0;
11207 tree_view->priv->vadjustment->upper = tree_view->priv->height;
11208 gtk_adjustment_changed (tree_view->priv->vadjustment);
11210 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
11212 g_object_notify (G_OBJECT (tree_view), "headers-visible");
11216 * gtk_tree_view_columns_autosize:
11217 * @tree_view: A #GtkTreeView.
11219 * Resizes all columns to their optimal width. Only works after the
11220 * treeview has been realized.
11223 gtk_tree_view_columns_autosize (GtkTreeView *tree_view)
11225 gboolean dirty = FALSE;
11227 GtkTreeViewColumn *column;
11229 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11231 for (list = tree_view->priv->columns; list; list = list->next)
11233 column = list->data;
11234 if (gtk_tree_view_column_get_sizing (column) == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
11236 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
11241 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
11245 * gtk_tree_view_set_headers_clickable:
11246 * @tree_view: A #GtkTreeView.
11247 * @setting: %TRUE if the columns are clickable.
11249 * Allow the column title buttons to be clicked.
11252 gtk_tree_view_set_headers_clickable (GtkTreeView *tree_view,
11257 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11259 for (list = tree_view->priv->columns; list; list = list->next)
11260 gtk_tree_view_column_set_clickable (GTK_TREE_VIEW_COLUMN (list->data), setting);
11262 g_object_notify (G_OBJECT (tree_view), "headers-clickable");
11267 * gtk_tree_view_get_headers_clickable:
11268 * @tree_view: A #GtkTreeView.
11270 * Returns whether all header columns are clickable.
11272 * Return value: %TRUE if all header columns are clickable, otherwise %FALSE
11277 gtk_tree_view_get_headers_clickable (GtkTreeView *tree_view)
11281 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
11283 for (list = tree_view->priv->columns; list; list = list->next)
11284 if (!gtk_tree_view_column_get_clickable (GTK_TREE_VIEW_COLUMN (list->data)))
11291 * gtk_tree_view_set_rules_hint
11292 * @tree_view: a #GtkTreeView
11293 * @setting: %TRUE if the tree requires reading across rows
11295 * This function tells GTK+ that the user interface for your
11296 * application requires users to read across tree rows and associate
11297 * cells with one another. By default, GTK+ will then render the tree
11298 * with alternating row colors. Do <emphasis>not</emphasis> use it
11299 * just because you prefer the appearance of the ruled tree; that's a
11300 * question for the theme. Some themes will draw tree rows in
11301 * alternating colors even when rules are turned off, and users who
11302 * prefer that appearance all the time can choose those themes. You
11303 * should call this function only as a <emphasis>semantic</emphasis>
11304 * hint to the theme engine that your tree makes alternating colors
11305 * useful from a functional standpoint (since it has lots of columns,
11310 gtk_tree_view_set_rules_hint (GtkTreeView *tree_view,
11313 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11315 setting = setting != FALSE;
11317 if (tree_view->priv->has_rules != setting)
11319 tree_view->priv->has_rules = setting;
11320 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
11323 g_object_notify (G_OBJECT (tree_view), "rules-hint");
11327 * gtk_tree_view_get_rules_hint
11328 * @tree_view: a #GtkTreeView
11330 * Gets the setting set by gtk_tree_view_set_rules_hint().
11332 * Return value: %TRUE if rules are useful for the user of this tree
11335 gtk_tree_view_get_rules_hint (GtkTreeView *tree_view)
11337 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
11339 return tree_view->priv->has_rules;
11342 /* Public Column functions
11346 * gtk_tree_view_append_column:
11347 * @tree_view: A #GtkTreeView.
11348 * @column: The #GtkTreeViewColumn to add.
11350 * Appends @column to the list of columns. If @tree_view has "fixed_height"
11351 * mode enabled, then @column must have its "sizing" property set to be
11352 * GTK_TREE_VIEW_COLUMN_FIXED.
11354 * Return value: The number of columns in @tree_view after appending.
11357 gtk_tree_view_append_column (GtkTreeView *tree_view,
11358 GtkTreeViewColumn *column)
11360 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11361 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
11362 g_return_val_if_fail (column->tree_view == NULL, -1);
11364 return gtk_tree_view_insert_column (tree_view, column, -1);
11369 * gtk_tree_view_remove_column:
11370 * @tree_view: A #GtkTreeView.
11371 * @column: The #GtkTreeViewColumn to remove.
11373 * Removes @column from @tree_view.
11375 * Return value: The number of columns in @tree_view after removing.
11378 gtk_tree_view_remove_column (GtkTreeView *tree_view,
11379 GtkTreeViewColumn *column)
11381 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11382 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
11383 g_return_val_if_fail (column->tree_view == GTK_WIDGET (tree_view), -1);
11385 if (tree_view->priv->focus_column == column)
11386 tree_view->priv->focus_column = NULL;
11388 if (tree_view->priv->edited_column == column)
11390 gtk_tree_view_stop_editing (tree_view, TRUE);
11392 /* no need to, but just to be sure ... */
11393 tree_view->priv->edited_column = NULL;
11396 if (tree_view->priv->expander_column == column)
11397 tree_view->priv->expander_column = NULL;
11399 g_signal_handlers_disconnect_by_func (column,
11400 G_CALLBACK (column_sizing_notify),
11403 _gtk_tree_view_column_unset_tree_view (column);
11405 tree_view->priv->columns = g_list_remove (tree_view->priv->columns, column);
11406 tree_view->priv->n_columns--;
11408 if (gtk_widget_get_realized (GTK_WIDGET (tree_view)))
11412 _gtk_tree_view_column_unrealize_button (column);
11413 for (list = tree_view->priv->columns; list; list = list->next)
11415 GtkTreeViewColumn *tmp_column;
11417 tmp_column = GTK_TREE_VIEW_COLUMN (list->data);
11418 if (gtk_tree_view_column_get_visible (tmp_column))
11419 _gtk_tree_view_column_cell_set_dirty (tmp_column, TRUE);
11422 if (tree_view->priv->n_columns == 0 &&
11423 gtk_tree_view_get_headers_visible (tree_view))
11424 gdk_window_hide (tree_view->priv->header_window);
11426 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
11429 g_object_unref (column);
11430 g_signal_emit (tree_view, tree_view_signals[COLUMNS_CHANGED], 0);
11432 return tree_view->priv->n_columns;
11436 * gtk_tree_view_insert_column:
11437 * @tree_view: A #GtkTreeView.
11438 * @column: The #GtkTreeViewColumn to be inserted.
11439 * @position: The position to insert @column in.
11441 * This inserts the @column into the @tree_view at @position. If @position is
11442 * -1, then the column is inserted at the end. If @tree_view has
11443 * "fixed_height" mode enabled, then @column must have its "sizing" property
11444 * set to be GTK_TREE_VIEW_COLUMN_FIXED.
11446 * Return value: The number of columns in @tree_view after insertion.
11449 gtk_tree_view_insert_column (GtkTreeView *tree_view,
11450 GtkTreeViewColumn *column,
11453 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11454 g_return_val_if_fail (GTK_IS_TREE_VIEW_COLUMN (column), -1);
11455 g_return_val_if_fail (column->tree_view == NULL, -1);
11457 if (tree_view->priv->fixed_height_mode)
11458 g_return_val_if_fail (gtk_tree_view_column_get_sizing (column)
11459 == GTK_TREE_VIEW_COLUMN_FIXED, -1);
11461 g_object_ref_sink (column);
11463 if (tree_view->priv->n_columns == 0 &&
11464 gtk_widget_get_realized (GTK_WIDGET (tree_view)) &&
11465 gtk_tree_view_get_headers_visible (tree_view))
11467 gdk_window_show (tree_view->priv->header_window);
11470 g_signal_connect (column, "notify::sizing",
11471 G_CALLBACK (column_sizing_notify), tree_view);
11473 tree_view->priv->columns = g_list_insert (tree_view->priv->columns,
11475 tree_view->priv->n_columns++;
11477 _gtk_tree_view_column_set_tree_view (column, tree_view);
11479 if (gtk_widget_get_realized (GTK_WIDGET (tree_view)))
11483 _gtk_tree_view_column_realize_button (column);
11485 for (list = tree_view->priv->columns; list; list = list->next)
11487 column = GTK_TREE_VIEW_COLUMN (list->data);
11488 if (gtk_tree_view_column_get_visible (column))
11489 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
11491 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
11494 g_signal_emit (tree_view, tree_view_signals[COLUMNS_CHANGED], 0);
11496 return tree_view->priv->n_columns;
11500 * gtk_tree_view_insert_column_with_attributes:
11501 * @tree_view: A #GtkTreeView
11502 * @position: The position to insert the new column in.
11503 * @title: The title to set the header to.
11504 * @cell: The #GtkCellRenderer.
11505 * @Varargs: A %NULL-terminated list of attributes.
11507 * Creates a new #GtkTreeViewColumn and inserts it into the @tree_view at
11508 * @position. If @position is -1, then the newly created column is inserted at
11509 * the end. The column is initialized with the attributes given. If @tree_view
11510 * has "fixed_height" mode enabled, then the new column will have its sizing
11511 * property set to be GTK_TREE_VIEW_COLUMN_FIXED.
11513 * Return value: The number of columns in @tree_view after insertion.
11516 gtk_tree_view_insert_column_with_attributes (GtkTreeView *tree_view,
11518 const gchar *title,
11519 GtkCellRenderer *cell,
11522 GtkTreeViewColumn *column;
11527 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11529 column = gtk_tree_view_column_new ();
11530 if (tree_view->priv->fixed_height_mode)
11531 gtk_tree_view_column_set_sizing (column, GTK_TREE_VIEW_COLUMN_FIXED);
11533 gtk_tree_view_column_set_title (column, title);
11534 gtk_tree_view_column_pack_start (column, cell, TRUE);
11536 va_start (args, cell);
11538 attribute = va_arg (args, gchar *);
11540 while (attribute != NULL)
11542 column_id = va_arg (args, gint);
11543 gtk_tree_view_column_add_attribute (column, cell, attribute, column_id);
11544 attribute = va_arg (args, gchar *);
11549 gtk_tree_view_insert_column (tree_view, column, position);
11551 return tree_view->priv->n_columns;
11555 * gtk_tree_view_insert_column_with_data_func:
11556 * @tree_view: a #GtkTreeView
11557 * @position: Position to insert, -1 for append
11558 * @title: column title
11559 * @cell: cell renderer for column
11560 * @func: function to set attributes of cell renderer
11561 * @data: data for @func
11562 * @dnotify: destroy notifier for @data
11564 * Convenience function that inserts a new column into the #GtkTreeView
11565 * with the given cell renderer and a #GtkCellDataFunc to set cell renderer
11566 * attributes (normally using data from the model). See also
11567 * gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start().
11568 * If @tree_view has "fixed_height" mode enabled, then the new column will have its
11569 * "sizing" property set to be GTK_TREE_VIEW_COLUMN_FIXED.
11571 * Return value: number of columns in the tree view post-insert
11574 gtk_tree_view_insert_column_with_data_func (GtkTreeView *tree_view,
11576 const gchar *title,
11577 GtkCellRenderer *cell,
11578 GtkTreeCellDataFunc func,
11580 GDestroyNotify dnotify)
11582 GtkTreeViewColumn *column;
11584 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
11586 column = gtk_tree_view_column_new ();
11587 if (tree_view->priv->fixed_height_mode)
11588 gtk_tree_view_column_set_sizing (column, GTK_TREE_VIEW_COLUMN_FIXED);
11590 gtk_tree_view_column_set_title (column, title);
11591 gtk_tree_view_column_pack_start (column, cell, TRUE);
11592 gtk_tree_view_column_set_cell_data_func (column, cell, func, data, dnotify);
11594 gtk_tree_view_insert_column (tree_view, column, position);
11596 return tree_view->priv->n_columns;
11600 * gtk_tree_view_get_column:
11601 * @tree_view: A #GtkTreeView.
11602 * @n: The position of the column, counting from 0.
11604 * Gets the #GtkTreeViewColumn at the given position in the #tree_view.
11606 * Return value: (transfer none): The #GtkTreeViewColumn, or %NULL if the
11607 * position is outside the range of columns.
11609 GtkTreeViewColumn *
11610 gtk_tree_view_get_column (GtkTreeView *tree_view,
11613 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
11615 if (n < 0 || n >= tree_view->priv->n_columns)
11618 if (tree_view->priv->columns == NULL)
11621 return GTK_TREE_VIEW_COLUMN (g_list_nth (tree_view->priv->columns, n)->data);
11625 * gtk_tree_view_get_columns:
11626 * @tree_view: A #GtkTreeView
11628 * Returns a #GList of all the #GtkTreeViewColumn s currently in @tree_view.
11629 * The returned list must be freed with g_list_free ().
11631 * Return value: (element-type GtkTreeViewColumn) (transfer container): A list of #GtkTreeViewColumn s
11634 gtk_tree_view_get_columns (GtkTreeView *tree_view)
11636 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
11638 return g_list_copy (tree_view->priv->columns);
11642 * gtk_tree_view_move_column_after:
11643 * @tree_view: A #GtkTreeView
11644 * @column: The #GtkTreeViewColumn to be moved.
11645 * @base_column: (allow-none): The #GtkTreeViewColumn to be moved relative to, or %NULL.
11647 * Moves @column to be after to @base_column. If @base_column is %NULL, then
11648 * @column is placed in the first position.
11651 gtk_tree_view_move_column_after (GtkTreeView *tree_view,
11652 GtkTreeViewColumn *column,
11653 GtkTreeViewColumn *base_column)
11655 GList *column_list_el, *base_el = NULL;
11657 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11659 column_list_el = g_list_find (tree_view->priv->columns, column);
11660 g_return_if_fail (column_list_el != NULL);
11664 base_el = g_list_find (tree_view->priv->columns, base_column);
11665 g_return_if_fail (base_el != NULL);
11668 if (column_list_el->prev == base_el)
11671 tree_view->priv->columns = g_list_remove_link (tree_view->priv->columns, column_list_el);
11672 if (base_el == NULL)
11674 column_list_el->prev = NULL;
11675 column_list_el->next = tree_view->priv->columns;
11676 if (column_list_el->next)
11677 column_list_el->next->prev = column_list_el;
11678 tree_view->priv->columns = column_list_el;
11682 column_list_el->prev = base_el;
11683 column_list_el->next = base_el->next;
11684 if (column_list_el->next)
11685 column_list_el->next->prev = column_list_el;
11686 base_el->next = column_list_el;
11689 if (gtk_widget_get_realized (GTK_WIDGET (tree_view)))
11691 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
11692 gtk_tree_view_size_allocate_columns (GTK_WIDGET (tree_view), NULL);
11695 g_signal_emit (tree_view, tree_view_signals[COLUMNS_CHANGED], 0);
11699 * gtk_tree_view_set_expander_column:
11700 * @tree_view: A #GtkTreeView
11701 * @column: %NULL, or the column to draw the expander arrow at.
11703 * Sets the column to draw the expander arrow at. It must be in @tree_view.
11704 * If @column is %NULL, then the expander arrow is always at the first
11707 * If you do not want expander arrow to appear in your tree, set the
11708 * expander column to a hidden column.
11711 gtk_tree_view_set_expander_column (GtkTreeView *tree_view,
11712 GtkTreeViewColumn *column)
11714 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11715 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
11717 if (tree_view->priv->expander_column != column)
11723 /* Confirm that column is in tree_view */
11724 for (list = tree_view->priv->columns; list; list = list->next)
11725 if (list->data == column)
11727 g_return_if_fail (list != NULL);
11730 tree_view->priv->expander_column = column;
11731 g_object_notify (G_OBJECT (tree_view), "expander-column");
11736 * gtk_tree_view_get_expander_column:
11737 * @tree_view: A #GtkTreeView
11739 * Returns the column that is the current expander column.
11740 * This column has the expander arrow drawn next to it.
11742 * Return value: (transfer none): The expander column.
11744 GtkTreeViewColumn *
11745 gtk_tree_view_get_expander_column (GtkTreeView *tree_view)
11749 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
11751 for (list = tree_view->priv->columns; list; list = list->next)
11752 if (gtk_tree_view_is_expander_column (tree_view, GTK_TREE_VIEW_COLUMN (list->data)))
11753 return (GtkTreeViewColumn *) list->data;
11759 * gtk_tree_view_set_column_drag_function:
11760 * @tree_view: A #GtkTreeView.
11761 * @func: (allow-none): A function to determine which columns are reorderable, or %NULL.
11762 * @user_data: (allow-none): User data to be passed to @func, or %NULL
11763 * @destroy: (allow-none): Destroy notifier for @user_data, or %NULL
11765 * Sets a user function for determining where a column may be dropped when
11766 * dragged. This function is called on every column pair in turn at the
11767 * beginning of a column drag to determine where a drop can take place. The
11768 * arguments passed to @func are: the @tree_view, the #GtkTreeViewColumn being
11769 * dragged, the two #GtkTreeViewColumn s determining the drop spot, and
11770 * @user_data. If either of the #GtkTreeViewColumn arguments for the drop spot
11771 * are %NULL, then they indicate an edge. If @func is set to be %NULL, then
11772 * @tree_view reverts to the default behavior of allowing all columns to be
11773 * dropped everywhere.
11776 gtk_tree_view_set_column_drag_function (GtkTreeView *tree_view,
11777 GtkTreeViewColumnDropFunc func,
11778 gpointer user_data,
11779 GDestroyNotify destroy)
11781 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11783 if (tree_view->priv->column_drop_func_data_destroy)
11784 tree_view->priv->column_drop_func_data_destroy (tree_view->priv->column_drop_func_data);
11786 tree_view->priv->column_drop_func = func;
11787 tree_view->priv->column_drop_func_data = user_data;
11788 tree_view->priv->column_drop_func_data_destroy = destroy;
11792 * gtk_tree_view_scroll_to_point:
11793 * @tree_view: a #GtkTreeView
11794 * @tree_x: X coordinate of new top-left pixel of visible area, or -1
11795 * @tree_y: Y coordinate of new top-left pixel of visible area, or -1
11797 * Scrolls the tree view such that the top-left corner of the visible
11798 * area is @tree_x, @tree_y, where @tree_x and @tree_y are specified
11799 * in tree coordinates. The @tree_view must be realized before
11800 * this function is called. If it isn't, you probably want to be
11801 * using gtk_tree_view_scroll_to_cell().
11803 * If either @tree_x or @tree_y are -1, then that direction isn't scrolled.
11806 gtk_tree_view_scroll_to_point (GtkTreeView *tree_view,
11810 GtkAdjustment *hadj;
11811 GtkAdjustment *vadj;
11813 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11814 g_return_if_fail (gtk_widget_get_realized (GTK_WIDGET (tree_view)));
11816 hadj = tree_view->priv->hadjustment;
11817 vadj = tree_view->priv->vadjustment;
11820 gtk_adjustment_set_value (hadj, tree_x);
11822 gtk_adjustment_set_value (vadj, tree_y);
11826 * gtk_tree_view_scroll_to_cell:
11827 * @tree_view: A #GtkTreeView.
11828 * @path: (allow-none): The path of the row to move to, or %NULL.
11829 * @column: (allow-none): The #GtkTreeViewColumn to move horizontally to, or %NULL.
11830 * @use_align: whether to use alignment arguments, or %FALSE.
11831 * @row_align: The vertical alignment of the row specified by @path.
11832 * @col_align: The horizontal alignment of the column specified by @column.
11834 * Moves the alignments of @tree_view to the position specified by @column and
11835 * @path. If @column is %NULL, then no horizontal scrolling occurs. Likewise,
11836 * if @path is %NULL no vertical scrolling occurs. At a minimum, one of @column
11837 * or @path need to be non-%NULL. @row_align determines where the row is
11838 * placed, and @col_align determines where @column is placed. Both are expected
11839 * to be between 0.0 and 1.0. 0.0 means left/top alignment, 1.0 means
11840 * right/bottom alignment, 0.5 means center.
11842 * If @use_align is %FALSE, then the alignment arguments are ignored, and the
11843 * tree does the minimum amount of work to scroll the cell onto the screen.
11844 * This means that the cell will be scrolled to the edge closest to its current
11845 * position. If the cell is currently visible on the screen, nothing is done.
11847 * This function only works if the model is set, and @path is a valid row on the
11848 * model. If the model changes before the @tree_view is realized, the centered
11849 * path will be modified to reflect this change.
11852 gtk_tree_view_scroll_to_cell (GtkTreeView *tree_view,
11854 GtkTreeViewColumn *column,
11855 gboolean use_align,
11859 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11860 g_return_if_fail (tree_view->priv->model != NULL);
11861 g_return_if_fail (tree_view->priv->tree != NULL);
11862 g_return_if_fail (row_align >= 0.0 && row_align <= 1.0);
11863 g_return_if_fail (col_align >= 0.0 && col_align <= 1.0);
11864 g_return_if_fail (path != NULL || column != NULL);
11867 g_print ("gtk_tree_view_scroll_to_cell:\npath: %s\ncolumn: %s\nuse_align: %d\nrow_align: %f\ncol_align: %f\n",
11868 gtk_tree_path_to_string (path), column?"non-null":"null", use_align, row_align, col_align);
11870 row_align = CLAMP (row_align, 0.0, 1.0);
11871 col_align = CLAMP (col_align, 0.0, 1.0);
11874 /* Note: Despite the benefits that come from having one code path for the
11875 * scrolling code, we short-circuit validate_visible_area's immplementation as
11876 * it is much slower than just going to the point.
11878 if (!gtk_widget_get_visible (GTK_WIDGET (tree_view)) ||
11879 !gtk_widget_get_realized (GTK_WIDGET (tree_view)) ||
11880 _gtk_widget_get_alloc_needed (GTK_WIDGET (tree_view)) ||
11881 GTK_RBNODE_FLAG_SET (tree_view->priv->tree->root, GTK_RBNODE_DESCENDANTS_INVALID))
11883 if (tree_view->priv->scroll_to_path)
11884 gtk_tree_row_reference_free (tree_view->priv->scroll_to_path);
11886 tree_view->priv->scroll_to_path = NULL;
11887 tree_view->priv->scroll_to_column = NULL;
11890 tree_view->priv->scroll_to_path = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
11892 tree_view->priv->scroll_to_column = column;
11893 tree_view->priv->scroll_to_use_align = use_align;
11894 tree_view->priv->scroll_to_row_align = row_align;
11895 tree_view->priv->scroll_to_col_align = col_align;
11897 install_presize_handler (tree_view);
11901 GdkRectangle cell_rect;
11902 GdkRectangle vis_rect;
11903 gint dest_x, dest_y;
11905 gtk_tree_view_get_background_area (tree_view, path, column, &cell_rect);
11906 gtk_tree_view_get_visible_rect (tree_view, &vis_rect);
11908 cell_rect.y = TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, cell_rect.y);
11910 dest_x = vis_rect.x;
11911 dest_y = vis_rect.y;
11917 dest_x = cell_rect.x - ((vis_rect.width - cell_rect.width) * col_align);
11921 if (cell_rect.x < vis_rect.x)
11922 dest_x = cell_rect.x;
11923 if (cell_rect.x + cell_rect.width > vis_rect.x + vis_rect.width)
11924 dest_x = cell_rect.x + cell_rect.width - vis_rect.width;
11932 dest_y = cell_rect.y - ((vis_rect.height - cell_rect.height) * row_align);
11933 dest_y = MAX (dest_y, 0);
11937 if (cell_rect.y < vis_rect.y)
11938 dest_y = cell_rect.y;
11939 if (cell_rect.y + cell_rect.height > vis_rect.y + vis_rect.height)
11940 dest_y = cell_rect.y + cell_rect.height - vis_rect.height;
11944 gtk_tree_view_scroll_to_point (tree_view, dest_x, dest_y);
11949 * gtk_tree_view_row_activated:
11950 * @tree_view: A #GtkTreeView
11951 * @path: The #GtkTreePath to be activated.
11952 * @column: The #GtkTreeViewColumn to be activated.
11954 * Activates the cell determined by @path and @column.
11957 gtk_tree_view_row_activated (GtkTreeView *tree_view,
11959 GtkTreeViewColumn *column)
11961 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
11963 g_signal_emit (tree_view, tree_view_signals[ROW_ACTIVATED], 0, path, column);
11968 gtk_tree_view_expand_all_emission_helper (GtkRBTree *tree,
11972 GtkTreeView *tree_view = data;
11974 if ((node->flags & GTK_RBNODE_IS_PARENT) == GTK_RBNODE_IS_PARENT &&
11980 path = _gtk_tree_view_find_path (tree_view, tree, node);
11981 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
11983 g_signal_emit (tree_view, tree_view_signals[ROW_EXPANDED], 0, &iter, path);
11985 gtk_tree_path_free (path);
11988 if (node->children)
11989 _gtk_rbtree_traverse (node->children,
11990 node->children->root,
11992 gtk_tree_view_expand_all_emission_helper,
11997 * gtk_tree_view_expand_all:
11998 * @tree_view: A #GtkTreeView.
12000 * Recursively expands all nodes in the @tree_view.
12003 gtk_tree_view_expand_all (GtkTreeView *tree_view)
12009 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12011 if (tree_view->priv->tree == NULL)
12014 path = gtk_tree_path_new_first ();
12015 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
12019 gtk_tree_view_real_expand_row (tree_view, path, tree, node, TRUE, FALSE);
12020 node = _gtk_rbtree_next (tree, node);
12021 gtk_tree_path_next (path);
12024 gtk_tree_path_free (path);
12027 /* Timeout to animate the expander during expands and collapses */
12029 expand_collapse_timeout (gpointer data)
12031 return do_expand_collapse (data);
12035 add_expand_collapse_timeout (GtkTreeView *tree_view,
12040 if (tree_view->priv->expand_collapse_timeout != 0)
12043 tree_view->priv->expand_collapse_timeout =
12044 gdk_threads_add_timeout (50, expand_collapse_timeout, tree_view);
12045 tree_view->priv->expanded_collapsed_tree = tree;
12046 tree_view->priv->expanded_collapsed_node = node;
12049 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
12051 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
12055 remove_expand_collapse_timeout (GtkTreeView *tree_view)
12057 if (tree_view->priv->expand_collapse_timeout)
12059 g_source_remove (tree_view->priv->expand_collapse_timeout);
12060 tree_view->priv->expand_collapse_timeout = 0;
12063 if (tree_view->priv->expanded_collapsed_node != NULL)
12065 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_EXPANDED);
12066 GTK_RBNODE_UNSET_FLAG (tree_view->priv->expanded_collapsed_node, GTK_RBNODE_IS_SEMI_COLLAPSED);
12068 tree_view->priv->expanded_collapsed_node = NULL;
12073 cancel_arrow_animation (GtkTreeView *tree_view)
12075 if (tree_view->priv->expand_collapse_timeout)
12077 while (do_expand_collapse (tree_view));
12079 remove_expand_collapse_timeout (tree_view);
12084 do_expand_collapse (GtkTreeView *tree_view)
12088 gboolean expanding;
12094 node = tree_view->priv->expanded_collapsed_node;
12095 tree = tree_view->priv->expanded_collapsed_tree;
12097 if (node->children == NULL)
12102 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
12104 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
12105 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
12110 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
12112 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
12119 if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_EXPANDED))
12121 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_EXPANDED);
12122 GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
12126 else if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SEMI_COLLAPSED))
12128 GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_IS_SEMI_COLLAPSED);
12137 gtk_tree_view_queue_draw_arrow (tree_view, tree, node);
12146 * gtk_tree_view_collapse_all:
12147 * @tree_view: A #GtkTreeView.
12149 * Recursively collapses all visible, expanded nodes in @tree_view.
12152 gtk_tree_view_collapse_all (GtkTreeView *tree_view)
12159 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12161 if (tree_view->priv->tree == NULL)
12164 path = gtk_tree_path_new ();
12165 gtk_tree_path_down (path);
12166 indices = gtk_tree_path_get_indices (path);
12168 tree = tree_view->priv->tree;
12170 while (node && node->left != tree->nil)
12175 if (node->children)
12176 gtk_tree_view_real_collapse_row (tree_view, path, tree, node, FALSE);
12178 node = _gtk_rbtree_next (tree, node);
12181 gtk_tree_path_free (path);
12185 * gtk_tree_view_expand_to_path:
12186 * @tree_view: A #GtkTreeView.
12187 * @path: path to a row.
12189 * Expands the row at @path. This will also expand all parent rows of
12190 * @path as necessary.
12195 gtk_tree_view_expand_to_path (GtkTreeView *tree_view,
12202 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12203 g_return_if_fail (path != NULL);
12205 depth = gtk_tree_path_get_depth (path);
12206 indices = gtk_tree_path_get_indices (path);
12208 tmp = gtk_tree_path_new ();
12209 g_return_if_fail (tmp != NULL);
12211 for (i = 0; i < depth; i++)
12213 gtk_tree_path_append_index (tmp, indices[i]);
12214 gtk_tree_view_expand_row (tree_view, tmp, FALSE);
12217 gtk_tree_path_free (tmp);
12220 /* FIXME the bool return values for expand_row and collapse_row are
12221 * not analagous; they should be TRUE if the row had children and
12222 * was not already in the requested state.
12227 gtk_tree_view_real_expand_row (GtkTreeView *tree_view,
12239 g_object_get (gtk_widget_get_settings (GTK_WIDGET (tree_view)),
12240 "gtk-enable-animations", &animate,
12243 remove_auto_expand_timeout (tree_view);
12245 if (node->children && !open_all)
12248 if (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT))
12251 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
12252 if (! gtk_tree_model_iter_has_child (tree_view->priv->model, &iter))
12256 if (node->children && open_all)
12258 gboolean retval = FALSE;
12259 GtkTreePath *tmp_path = gtk_tree_path_copy (path);
12261 gtk_tree_path_append_index (tmp_path, 0);
12262 tree = node->children;
12264 while (node->left != tree->nil)
12266 /* try to expand the children */
12270 t = gtk_tree_view_real_expand_row (tree_view, tmp_path, tree, node,
12275 gtk_tree_path_next (tmp_path);
12276 node = _gtk_rbtree_next (tree, node);
12278 while (node != NULL);
12280 gtk_tree_path_free (tmp_path);
12285 g_signal_emit (tree_view, tree_view_signals[TEST_EXPAND_ROW], 0, &iter, path, &expand);
12287 if (!gtk_tree_model_iter_has_child (tree_view->priv->model, &iter))
12293 node->children = _gtk_rbtree_new ();
12294 node->children->parent_tree = tree;
12295 node->children->parent_node = node;
12297 gtk_tree_model_iter_children (tree_view->priv->model, &temp, &iter);
12299 gtk_tree_view_build_tree (tree_view,
12302 gtk_tree_path_get_depth (path) + 1,
12305 remove_expand_collapse_timeout (tree_view);
12308 add_expand_collapse_timeout (tree_view, tree, node, TRUE);
12310 install_presize_handler (tree_view);
12312 g_signal_emit (tree_view, tree_view_signals[ROW_EXPANDED], 0, &iter, path);
12313 if (open_all && node->children)
12315 _gtk_rbtree_traverse (node->children,
12316 node->children->root,
12318 gtk_tree_view_expand_all_emission_helper,
12326 * gtk_tree_view_expand_row:
12327 * @tree_view: a #GtkTreeView
12328 * @path: path to a row
12329 * @open_all: whether to recursively expand, or just expand immediate children
12331 * Opens the row so its children are visible.
12333 * Return value: %TRUE if the row existed and had children
12336 gtk_tree_view_expand_row (GtkTreeView *tree_view,
12343 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
12344 g_return_val_if_fail (tree_view->priv->model != NULL, FALSE);
12345 g_return_val_if_fail (path != NULL, FALSE);
12347 if (_gtk_tree_view_find_node (tree_view,
12354 return gtk_tree_view_real_expand_row (tree_view, path, tree, node, open_all, FALSE);
12360 gtk_tree_view_real_collapse_row (GtkTreeView *tree_view,
12367 GtkTreeIter children;
12371 GdkWindow *child, *parent;
12374 g_object_get (gtk_widget_get_settings (GTK_WIDGET (tree_view)),
12375 "gtk-enable-animations", &animate,
12378 remove_auto_expand_timeout (tree_view);
12380 if (node->children == NULL)
12383 gtk_tree_model_get_iter (tree_view->priv->model, &iter, path);
12385 g_signal_emit (tree_view, tree_view_signals[TEST_COLLAPSE_ROW], 0, &iter, path, &collapse);
12390 /* if the prelighted node is a child of us, we want to unprelight it. We have
12391 * a chance to prelight the correct node below */
12393 if (tree_view->priv->prelight_tree)
12395 GtkRBTree *parent_tree;
12396 GtkRBNode *parent_node;
12398 parent_tree = tree_view->priv->prelight_tree->parent_tree;
12399 parent_node = tree_view->priv->prelight_tree->parent_node;
12400 while (parent_tree)
12402 if (parent_tree == tree && parent_node == node)
12404 ensure_unprelighted (tree_view);
12407 parent_node = parent_tree->parent_node;
12408 parent_tree = parent_tree->parent_tree;
12412 TREE_VIEW_INTERNAL_ASSERT (gtk_tree_model_iter_children (tree_view->priv->model, &children, &iter), FALSE);
12414 for (list = tree_view->priv->columns; list; list = list->next)
12416 GtkTreeViewColumn *column = list->data;
12418 if (gtk_tree_view_column_get_visible (column) == FALSE)
12420 if (gtk_tree_view_column_get_sizing (column) == GTK_TREE_VIEW_COLUMN_AUTOSIZE)
12421 _gtk_tree_view_column_cell_set_dirty (column, TRUE);
12424 if (tree_view->priv->destroy_count_func)
12426 GtkTreePath *child_path;
12427 gint child_count = 0;
12428 child_path = gtk_tree_path_copy (path);
12429 gtk_tree_path_down (child_path);
12430 if (node->children)
12431 _gtk_rbtree_traverse (node->children, node->children->root, G_POST_ORDER, count_children_helper, &child_count);
12432 tree_view->priv->destroy_count_func (tree_view, child_path, child_count, tree_view->priv->destroy_count_data);
12433 gtk_tree_path_free (child_path);
12436 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
12438 GtkTreePath *cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
12440 if (gtk_tree_path_is_ancestor (path, cursor_path))
12442 gtk_tree_row_reference_free (tree_view->priv->cursor);
12443 tree_view->priv->cursor = gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
12444 tree_view->priv->model,
12447 gtk_tree_path_free (cursor_path);
12450 if (gtk_tree_row_reference_valid (tree_view->priv->anchor))
12452 GtkTreePath *anchor_path = gtk_tree_row_reference_get_path (tree_view->priv->anchor);
12453 if (gtk_tree_path_is_ancestor (path, anchor_path))
12455 gtk_tree_row_reference_free (tree_view->priv->anchor);
12456 tree_view->priv->anchor = NULL;
12458 gtk_tree_path_free (anchor_path);
12461 /* Stop a pending double click */
12462 tree_view->priv->last_button_x = -1;
12463 tree_view->priv->last_button_y = -1;
12465 remove_expand_collapse_timeout (tree_view);
12467 if (gtk_tree_view_unref_and_check_selection_tree (tree_view, node->children))
12469 _gtk_rbtree_remove (node->children);
12470 g_signal_emit_by_name (tree_view->priv->selection, "changed");
12473 _gtk_rbtree_remove (node->children);
12476 add_expand_collapse_timeout (tree_view, tree, node, FALSE);
12478 if (gtk_widget_get_mapped (GTK_WIDGET (tree_view)))
12480 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
12483 g_signal_emit (tree_view, tree_view_signals[ROW_COLLAPSED], 0, &iter, path);
12485 if (gtk_widget_get_mapped (GTK_WIDGET (tree_view)))
12487 /* now that we've collapsed all rows, we want to try to set the prelight
12488 * again. To do this, we fake a motion event and send it to ourselves. */
12490 child = tree_view->priv->bin_window;
12491 parent = gdk_window_get_parent (child);
12493 if (gdk_window_get_pointer (parent, &x, &y, NULL) == child)
12495 GdkEventMotion event;
12496 gint child_x, child_y;
12498 gdk_window_get_position (child, &child_x, &child_y);
12500 event.window = tree_view->priv->bin_window;
12501 event.x = x - child_x;
12502 event.y = y - child_y;
12504 /* despite the fact this isn't a real event, I'm almost positive it will
12505 * never trigger a drag event. maybe_drag is the only function that uses
12506 * more than just event.x and event.y. */
12507 gtk_tree_view_motion_bin_window (GTK_WIDGET (tree_view), &event);
12515 * gtk_tree_view_collapse_row:
12516 * @tree_view: a #GtkTreeView
12517 * @path: path to a row in the @tree_view
12519 * Collapses a row (hides its child rows, if they exist).
12521 * Return value: %TRUE if the row was collapsed.
12524 gtk_tree_view_collapse_row (GtkTreeView *tree_view,
12530 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
12531 g_return_val_if_fail (tree_view->priv->tree != NULL, FALSE);
12532 g_return_val_if_fail (path != NULL, FALSE);
12534 if (_gtk_tree_view_find_node (tree_view,
12540 if (tree == NULL || node->children == NULL)
12543 return gtk_tree_view_real_collapse_row (tree_view, path, tree, node, FALSE);
12547 gtk_tree_view_map_expanded_rows_helper (GtkTreeView *tree_view,
12550 GtkTreeViewMappingFunc func,
12551 gpointer user_data)
12555 if (tree == NULL || tree->root == NULL)
12560 while (node && node->left != tree->nil)
12565 if (node->children)
12567 (* func) (tree_view, path, user_data);
12568 gtk_tree_path_down (path);
12569 gtk_tree_view_map_expanded_rows_helper (tree_view, node->children, path, func, user_data);
12570 gtk_tree_path_up (path);
12572 gtk_tree_path_next (path);
12573 node = _gtk_rbtree_next (tree, node);
12578 * gtk_tree_view_map_expanded_rows:
12579 * @tree_view: A #GtkTreeView
12580 * @func: (scope call): A function to be called
12581 * @data: User data to be passed to the function.
12583 * Calls @func on all expanded rows.
12586 gtk_tree_view_map_expanded_rows (GtkTreeView *tree_view,
12587 GtkTreeViewMappingFunc func,
12588 gpointer user_data)
12592 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12593 g_return_if_fail (func != NULL);
12595 path = gtk_tree_path_new_first ();
12597 gtk_tree_view_map_expanded_rows_helper (tree_view,
12598 tree_view->priv->tree,
12599 path, func, user_data);
12601 gtk_tree_path_free (path);
12605 * gtk_tree_view_row_expanded:
12606 * @tree_view: A #GtkTreeView.
12607 * @path: A #GtkTreePath to test expansion state.
12609 * Returns %TRUE if the node pointed to by @path is expanded in @tree_view.
12611 * Return value: %TRUE if #path is expanded.
12614 gtk_tree_view_row_expanded (GtkTreeView *tree_view,
12620 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
12621 g_return_val_if_fail (path != NULL, FALSE);
12623 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
12628 return (node->children != NULL);
12632 * gtk_tree_view_get_reorderable:
12633 * @tree_view: a #GtkTreeView
12635 * Retrieves whether the user can reorder the tree via drag-and-drop. See
12636 * gtk_tree_view_set_reorderable().
12638 * Return value: %TRUE if the tree can be reordered.
12641 gtk_tree_view_get_reorderable (GtkTreeView *tree_view)
12643 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
12645 return tree_view->priv->reorderable;
12649 * gtk_tree_view_set_reorderable:
12650 * @tree_view: A #GtkTreeView.
12651 * @reorderable: %TRUE, if the tree can be reordered.
12653 * This function is a convenience function to allow you to reorder
12654 * models that support the #GtkDragSourceIface and the
12655 * #GtkDragDestIface. Both #GtkTreeStore and #GtkListStore support
12656 * these. If @reorderable is %TRUE, then the user can reorder the
12657 * model by dragging and dropping rows. The developer can listen to
12658 * these changes by connecting to the model's row_inserted and
12659 * row_deleted signals. The reordering is implemented by setting up
12660 * the tree view as a drag source and destination. Therefore, drag and
12661 * drop can not be used in a reorderable view for any other purpose.
12663 * This function does not give you any degree of control over the order -- any
12664 * reordering is allowed. If more control is needed, you should probably
12665 * handle drag and drop manually.
12668 gtk_tree_view_set_reorderable (GtkTreeView *tree_view,
12669 gboolean reorderable)
12671 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12673 reorderable = reorderable != FALSE;
12675 if (tree_view->priv->reorderable == reorderable)
12680 const GtkTargetEntry row_targets[] = {
12681 { "GTK_TREE_MODEL_ROW", GTK_TARGET_SAME_WIDGET, 0 }
12684 gtk_tree_view_enable_model_drag_source (tree_view,
12687 G_N_ELEMENTS (row_targets),
12689 gtk_tree_view_enable_model_drag_dest (tree_view,
12691 G_N_ELEMENTS (row_targets),
12696 gtk_tree_view_unset_rows_drag_source (tree_view);
12697 gtk_tree_view_unset_rows_drag_dest (tree_view);
12700 tree_view->priv->reorderable = reorderable;
12702 g_object_notify (G_OBJECT (tree_view), "reorderable");
12706 gtk_tree_view_real_set_cursor (GtkTreeView *tree_view,
12708 gboolean clear_and_select,
12709 gboolean clamp_node)
12711 GtkRBTree *tree = NULL;
12712 GtkRBNode *node = NULL;
12714 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
12716 GtkTreePath *cursor_path;
12717 cursor_path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
12718 gtk_tree_view_queue_draw_path (tree_view, cursor_path, NULL);
12719 gtk_tree_path_free (cursor_path);
12722 gtk_tree_row_reference_free (tree_view->priv->cursor);
12723 tree_view->priv->cursor = NULL;
12725 /* One cannot set the cursor on a separator. Also, if
12726 * _gtk_tree_view_find_node returns TRUE, it ran out of tree
12727 * before finding the tree and node belonging to path. The
12728 * path maps to a non-existing path and we will silently bail out.
12729 * We unset tree and node to avoid further processing.
12731 if (!row_is_separator (tree_view, NULL, path)
12732 && _gtk_tree_view_find_node (tree_view, path, &tree, &node) == FALSE)
12734 tree_view->priv->cursor =
12735 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view),
12736 tree_view->priv->model,
12747 GtkRBTree *new_tree = NULL;
12748 GtkRBNode *new_node = NULL;
12750 if (clear_and_select && !tree_view->priv->ctrl_pressed)
12752 GtkTreeSelectMode mode = 0;
12754 if (tree_view->priv->ctrl_pressed)
12755 mode |= GTK_TREE_SELECT_MODE_TOGGLE;
12756 if (tree_view->priv->shift_pressed)
12757 mode |= GTK_TREE_SELECT_MODE_EXTEND;
12759 _gtk_tree_selection_internal_select_node (tree_view->priv->selection,
12760 node, tree, path, mode,
12764 /* We have to re-find tree and node here again, somebody might have
12765 * cleared the node or the whole tree in the GtkTreeSelection::changed
12766 * callback. If the nodes differ we bail out here.
12768 _gtk_tree_view_find_node (tree_view, path, &new_tree, &new_node);
12770 if (tree != new_tree || node != new_node)
12775 gtk_tree_view_clamp_node_visible (tree_view, tree, node);
12776 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
12780 g_signal_emit (tree_view, tree_view_signals[CURSOR_CHANGED], 0);
12784 * gtk_tree_view_get_cursor:
12785 * @tree_view: A #GtkTreeView
12786 * @path: (out) (allow-none): A pointer to be filled with the current cursor path, or %NULL
12787 * @focus_column: (out) (allow-none): A pointer to be filled with the current focus column, or %NULL
12789 * Fills in @path and @focus_column with the current path and focus column. If
12790 * the cursor isn't currently set, then *@path will be %NULL. If no column
12791 * currently has focus, then *@focus_column will be %NULL.
12793 * The returned #GtkTreePath must be freed with gtk_tree_path_free() when
12794 * you are done with it.
12797 gtk_tree_view_get_cursor (GtkTreeView *tree_view,
12798 GtkTreePath **path,
12799 GtkTreeViewColumn **focus_column)
12801 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12805 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
12806 *path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
12813 *focus_column = tree_view->priv->focus_column;
12818 * gtk_tree_view_set_cursor:
12819 * @tree_view: A #GtkTreeView
12820 * @path: A #GtkTreePath
12821 * @focus_column: (allow-none): A #GtkTreeViewColumn, or %NULL
12822 * @start_editing: %TRUE if the specified cell should start being edited.
12824 * Sets the current keyboard focus to be at @path, and selects it. This is
12825 * useful when you want to focus the user's attention on a particular row. If
12826 * @focus_column is not %NULL, then focus is given to the column specified by
12827 * it. Additionally, if @focus_column is specified, and @start_editing is
12828 * %TRUE, then editing should be started in the specified cell.
12829 * This function is often followed by @gtk_widget_grab_focus (@tree_view)
12830 * in order to give keyboard focus to the widget. Please note that editing
12831 * can only happen when the widget is realized.
12833 * If @path is invalid for @model, the current cursor (if any) will be unset
12834 * and the function will return without failing.
12837 gtk_tree_view_set_cursor (GtkTreeView *tree_view,
12839 GtkTreeViewColumn *focus_column,
12840 gboolean start_editing)
12842 gtk_tree_view_set_cursor_on_cell (tree_view, path, focus_column,
12843 NULL, start_editing);
12847 * gtk_tree_view_set_cursor_on_cell:
12848 * @tree_view: A #GtkTreeView
12849 * @path: A #GtkTreePath
12850 * @focus_column: (allow-none): A #GtkTreeViewColumn, or %NULL
12851 * @focus_cell: (allow-none): A #GtkCellRenderer, or %NULL
12852 * @start_editing: %TRUE if the specified cell should start being edited.
12854 * Sets the current keyboard focus to be at @path, and selects it. This is
12855 * useful when you want to focus the user's attention on a particular row. If
12856 * @focus_column is not %NULL, then focus is given to the column specified by
12857 * it. If @focus_column and @focus_cell are not %NULL, and @focus_column
12858 * contains 2 or more editable or activatable cells, then focus is given to
12859 * the cell specified by @focus_cell. Additionally, if @focus_column is
12860 * specified, and @start_editing is %TRUE, then editing should be started in
12861 * the specified cell. This function is often followed by
12862 * @gtk_widget_grab_focus (@tree_view) in order to give keyboard focus to the
12863 * widget. Please note that editing can only happen when the widget is
12866 * If @path is invalid for @model, the current cursor (if any) will be unset
12867 * and the function will return without failing.
12872 gtk_tree_view_set_cursor_on_cell (GtkTreeView *tree_view,
12874 GtkTreeViewColumn *focus_column,
12875 GtkCellRenderer *focus_cell,
12876 gboolean start_editing)
12878 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
12879 g_return_if_fail (path != NULL);
12880 g_return_if_fail (focus_column == NULL || GTK_IS_TREE_VIEW_COLUMN (focus_column));
12882 if (!tree_view->priv->model)
12887 g_return_if_fail (focus_column);
12888 g_return_if_fail (GTK_IS_CELL_RENDERER (focus_cell));
12891 /* cancel the current editing, if it exists */
12892 if (tree_view->priv->edited_column &&
12893 tree_view->priv->edited_column->editable_widget)
12894 gtk_tree_view_stop_editing (tree_view, TRUE);
12896 gtk_tree_view_real_set_cursor (tree_view, path, TRUE, TRUE);
12898 if (focus_column &&
12899 gtk_tree_view_column_get_visible (focus_column))
12902 gboolean column_in_tree = FALSE;
12904 for (list = tree_view->priv->columns; list; list = list->next)
12905 if (list->data == focus_column)
12907 column_in_tree = TRUE;
12910 g_return_if_fail (column_in_tree);
12911 tree_view->priv->focus_column = focus_column;
12913 gtk_tree_view_column_focus_cell (focus_column, focus_cell);
12915 gtk_tree_view_start_editing (tree_view, path);
12920 * gtk_tree_view_get_bin_window:
12921 * @tree_view: A #GtkTreeView
12923 * Returns the window that @tree_view renders to.
12924 * This is used primarily to compare to <literal>event->window</literal>
12925 * to confirm that the event on @tree_view is on the right window.
12927 * Return value: (transfer none): A #GdkWindow, or %NULL when @tree_view
12928 * hasn't been realized yet
12931 gtk_tree_view_get_bin_window (GtkTreeView *tree_view)
12933 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
12935 return tree_view->priv->bin_window;
12939 * gtk_tree_view_get_path_at_pos:
12940 * @tree_view: A #GtkTreeView.
12941 * @x: The x position to be identified (relative to bin_window).
12942 * @y: The y position to be identified (relative to bin_window).
12943 * @path: (out) (allow-none): A pointer to a #GtkTreePath pointer to be filled in, or %NULL
12944 * @column: (out) (allow-none): A pointer to a #GtkTreeViewColumn pointer to be filled in, or %NULL
12945 * @cell_x: (out) (allow-none): A pointer where the X coordinate relative to the cell can be placed, or %NULL
12946 * @cell_y: (out) (allow-none): A pointer where the Y coordinate relative to the cell can be placed, or %NULL
12948 * Finds the path at the point (@x, @y), relative to bin_window coordinates
12949 * (please see gtk_tree_view_get_bin_window()).
12950 * That is, @x and @y are relative to an events coordinates. @x and @y must
12951 * come from an event on the @tree_view only where <literal>event->window ==
12952 * gtk_tree_view_get_bin_window (<!-- -->)</literal>. It is primarily for
12953 * things like popup menus. If @path is non-%NULL, then it will be filled
12954 * with the #GtkTreePath at that point. This path should be freed with
12955 * gtk_tree_path_free(). If @column is non-%NULL, then it will be filled
12956 * with the column at that point. @cell_x and @cell_y return the coordinates
12957 * relative to the cell background (i.e. the @background_area passed to
12958 * gtk_cell_renderer_render()). This function is only meaningful if
12959 * @tree_view is realized. Therefore this function will always return %FALSE
12960 * if @tree_view is not realized or does not have a model.
12962 * For converting widget coordinates (eg. the ones you get from
12963 * GtkWidget::query-tooltip), please see
12964 * gtk_tree_view_convert_widget_to_bin_window_coords().
12966 * Return value: %TRUE if a row exists at that coordinate.
12969 gtk_tree_view_get_path_at_pos (GtkTreeView *tree_view,
12972 GtkTreePath **path,
12973 GtkTreeViewColumn **column,
12981 g_return_val_if_fail (tree_view != NULL, FALSE);
12988 if (tree_view->priv->bin_window == NULL)
12991 if (tree_view->priv->tree == NULL)
12994 if (x > tree_view->priv->hadjustment->upper)
12997 if (x < 0 || y < 0)
13000 if (column || cell_x)
13002 GtkTreeViewColumn *tmp_column;
13003 GtkTreeViewColumn *last_column = NULL;
13005 gint remaining_x = x;
13006 gboolean found = FALSE;
13010 rtl = (gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL);
13011 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
13013 list = (rtl ? list->prev : list->next))
13015 tmp_column = list->data;
13017 if (gtk_tree_view_column_get_visible (tmp_column) == FALSE)
13020 last_column = tmp_column;
13021 width = gtk_tree_view_column_get_width (tmp_column);
13022 if (remaining_x <= width)
13027 *column = tmp_column;
13030 *cell_x = remaining_x;
13034 remaining_x -= width;
13037 /* If found is FALSE and there is a last_column, then it the remainder
13038 * space is in that area
13045 *column = last_column;
13048 *cell_x = gtk_tree_view_column_get_width (last_column) + remaining_x;
13057 y_offset = _gtk_rbtree_find_offset (tree_view->priv->tree,
13058 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, y),
13065 *cell_y = y_offset;
13068 *path = _gtk_tree_view_find_path (tree_view, tree, node);
13075 * gtk_tree_view_get_cell_area:
13076 * @tree_view: a #GtkTreeView
13077 * @path: (allow-none): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
13078 * @column: (allow-none): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
13079 * @rect: rectangle to fill with cell rect
13081 * Fills the bounding rectangle in bin_window coordinates for the cell at the
13082 * row specified by @path and the column specified by @column. If @path is
13083 * %NULL, or points to a path not currently displayed, the @y and @height fields
13084 * of the rectangle will be filled with 0. If @column is %NULL, the @x and @width
13085 * fields will be filled with 0. The sum of all cell rects does not cover the
13086 * entire tree; there are extra pixels in between rows, for example. The
13087 * returned rectangle is equivalent to the @cell_area passed to
13088 * gtk_cell_renderer_render(). This function is only valid if @tree_view is
13092 gtk_tree_view_get_cell_area (GtkTreeView *tree_view,
13094 GtkTreeViewColumn *column,
13095 GdkRectangle *rect)
13097 GtkAllocation allocation;
13098 GtkRBTree *tree = NULL;
13099 GtkRBNode *node = NULL;
13100 gint vertical_separator;
13101 gint horizontal_separator;
13103 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13104 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
13105 g_return_if_fail (rect != NULL);
13106 g_return_if_fail (!column || column->tree_view == (GtkWidget *) tree_view);
13107 g_return_if_fail (gtk_widget_get_realized (GTK_WIDGET (tree_view)));
13109 gtk_widget_style_get (GTK_WIDGET (tree_view),
13110 "vertical-separator", &vertical_separator,
13111 "horizontal-separator", &horizontal_separator,
13121 gtk_widget_get_allocation (column->button, &allocation);
13122 rect->x = allocation.x + horizontal_separator/2;
13123 rect->width = allocation.width - horizontal_separator;
13128 gboolean ret = _gtk_tree_view_find_node (tree_view, path, &tree, &node);
13130 /* Get vertical coords */
13131 if ((!ret && tree == NULL) || ret)
13134 rect->y = CELL_FIRST_PIXEL (tree_view, tree, node, vertical_separator);
13135 rect->height = MAX (CELL_HEIGHT (node, vertical_separator), tree_view->priv->expander_size - vertical_separator);
13138 gtk_tree_view_is_expander_column (tree_view, column))
13140 gint depth = gtk_tree_path_get_depth (path);
13143 rtl = gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL;
13146 rect->x += (depth - 1) * tree_view->priv->level_indentation;
13147 rect->width -= (depth - 1) * tree_view->priv->level_indentation;
13149 if (TREE_VIEW_DRAW_EXPANDERS (tree_view))
13152 rect->x += depth * tree_view->priv->expander_size;
13153 rect->width -= depth * tree_view->priv->expander_size;
13156 rect->width = MAX (rect->width, 0);
13162 * gtk_tree_view_get_background_area:
13163 * @tree_view: a #GtkTreeView
13164 * @path: (allow-none): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
13165 * @column: (allow-none): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
13166 * @rect: rectangle to fill with cell background rect
13168 * Fills the bounding rectangle in bin_window coordinates for the cell at the
13169 * row specified by @path and the column specified by @column. If @path is
13170 * %NULL, or points to a node not found in the tree, the @y and @height fields of
13171 * the rectangle will be filled with 0. If @column is %NULL, the @x and @width
13172 * fields will be filled with 0. The returned rectangle is equivalent to the
13173 * @background_area passed to gtk_cell_renderer_render(). These background
13174 * areas tile to cover the entire bin window. Contrast with the @cell_area,
13175 * returned by gtk_tree_view_get_cell_area(), which returns only the cell
13176 * itself, excluding surrounding borders and the tree expander area.
13180 gtk_tree_view_get_background_area (GtkTreeView *tree_view,
13182 GtkTreeViewColumn *column,
13183 GdkRectangle *rect)
13185 GtkRBTree *tree = NULL;
13186 GtkRBNode *node = NULL;
13188 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13189 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
13190 g_return_if_fail (rect != NULL);
13199 /* Get vertical coords */
13201 if (!_gtk_tree_view_find_node (tree_view, path, &tree, &node) &&
13205 rect->y = BACKGROUND_FIRST_PIXEL (tree_view, tree, node);
13207 rect->height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
13214 gtk_tree_view_get_background_xrange (tree_view, tree, column, &rect->x, &x2);
13215 rect->width = x2 - rect->x;
13220 * gtk_tree_view_get_visible_rect:
13221 * @tree_view: a #GtkTreeView
13222 * @visible_rect: rectangle to fill
13224 * Fills @visible_rect with the currently-visible region of the
13225 * buffer, in tree coordinates. Convert to bin_window coordinates with
13226 * gtk_tree_view_convert_tree_to_bin_window_coords().
13227 * Tree coordinates start at 0,0 for row 0 of the tree, and cover the entire
13228 * scrollable area of the tree.
13231 gtk_tree_view_get_visible_rect (GtkTreeView *tree_view,
13232 GdkRectangle *visible_rect)
13234 GtkAllocation allocation;
13237 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13239 widget = GTK_WIDGET (tree_view);
13243 gtk_widget_get_allocation (widget, &allocation);
13244 visible_rect->x = tree_view->priv->hadjustment->value;
13245 visible_rect->y = tree_view->priv->vadjustment->value;
13246 visible_rect->width = allocation.width;
13247 visible_rect->height = allocation.height - TREE_VIEW_HEADER_HEIGHT (tree_view);
13252 * gtk_tree_view_convert_widget_to_tree_coords:
13253 * @tree_view: a #GtkTreeView
13254 * @wx: X coordinate relative to the widget
13255 * @wy: Y coordinate relative to the widget
13256 * @tx: return location for tree X coordinate
13257 * @ty: return location for tree Y coordinate
13259 * Converts widget coordinates to coordinates for the
13260 * tree (the full scrollable area of the tree).
13265 gtk_tree_view_convert_widget_to_tree_coords (GtkTreeView *tree_view,
13273 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13275 gtk_tree_view_convert_widget_to_bin_window_coords (tree_view,
13278 gtk_tree_view_convert_bin_window_to_tree_coords (tree_view,
13284 * gtk_tree_view_convert_tree_to_widget_coords:
13285 * @tree_view: a #GtkTreeView
13286 * @tx: X coordinate relative to the tree
13287 * @ty: Y coordinate relative to the tree
13288 * @wx: return location for widget X coordinate
13289 * @wy: return location for widget Y coordinate
13291 * Converts tree coordinates (coordinates in full scrollable area of the tree)
13292 * to widget coordinates.
13297 gtk_tree_view_convert_tree_to_widget_coords (GtkTreeView *tree_view,
13305 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13307 gtk_tree_view_convert_tree_to_bin_window_coords (tree_view,
13310 gtk_tree_view_convert_bin_window_to_widget_coords (tree_view,
13316 * gtk_tree_view_convert_widget_to_bin_window_coords:
13317 * @tree_view: a #GtkTreeView
13318 * @wx: X coordinate relative to the widget
13319 * @wy: Y coordinate relative to the widget
13320 * @bx: return location for bin_window X coordinate
13321 * @by: return location for bin_window Y coordinate
13323 * Converts widget coordinates to coordinates for the bin_window
13324 * (see gtk_tree_view_get_bin_window()).
13329 gtk_tree_view_convert_widget_to_bin_window_coords (GtkTreeView *tree_view,
13335 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13338 *bx = wx + tree_view->priv->hadjustment->value;
13340 *by = wy - TREE_VIEW_HEADER_HEIGHT (tree_view);
13344 * gtk_tree_view_convert_bin_window_to_widget_coords:
13345 * @tree_view: a #GtkTreeView
13346 * @bx: bin_window X coordinate
13347 * @by: bin_window Y coordinate
13348 * @wx: return location for widget X coordinate
13349 * @wy: return location for widget Y coordinate
13351 * Converts bin_window coordinates (see gtk_tree_view_get_bin_window())
13352 * to widget relative coordinates.
13357 gtk_tree_view_convert_bin_window_to_widget_coords (GtkTreeView *tree_view,
13363 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13366 *wx = bx - tree_view->priv->hadjustment->value;
13368 *wy = by + TREE_VIEW_HEADER_HEIGHT (tree_view);
13372 * gtk_tree_view_convert_tree_to_bin_window_coords:
13373 * @tree_view: a #GtkTreeView
13374 * @tx: tree X coordinate
13375 * @ty: tree Y coordinate
13376 * @bx: return location for X coordinate relative to bin_window
13377 * @by: return location for Y coordinate relative to bin_window
13379 * Converts tree coordinates (coordinates in full scrollable area of the tree)
13380 * to bin_window coordinates.
13385 gtk_tree_view_convert_tree_to_bin_window_coords (GtkTreeView *tree_view,
13391 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13396 *by = ty - tree_view->priv->dy;
13400 * gtk_tree_view_convert_bin_window_to_tree_coords:
13401 * @tree_view: a #GtkTreeView
13402 * @bx: X coordinate relative to bin_window
13403 * @by: Y coordinate relative to bin_window
13404 * @tx: return location for tree X coordinate
13405 * @ty: return location for tree Y coordinate
13407 * Converts bin_window coordinates to coordinates for the
13408 * tree (the full scrollable area of the tree).
13413 gtk_tree_view_convert_bin_window_to_tree_coords (GtkTreeView *tree_view,
13419 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13424 *ty = by + tree_view->priv->dy;
13430 * gtk_tree_view_get_visible_range:
13431 * @tree_view: A #GtkTreeView
13432 * @start_path: (allow-none): Return location for start of region, or %NULL.
13433 * @end_path: (allow-none): Return location for end of region, or %NULL.
13435 * Sets @start_path and @end_path to be the first and last visible path.
13436 * Note that there may be invisible paths in between.
13438 * The paths should be freed with gtk_tree_path_free() after use.
13440 * Returns: %TRUE, if valid paths were placed in @start_path and @end_path.
13445 gtk_tree_view_get_visible_range (GtkTreeView *tree_view,
13446 GtkTreePath **start_path,
13447 GtkTreePath **end_path)
13453 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
13455 if (!tree_view->priv->tree)
13462 _gtk_rbtree_find_offset (tree_view->priv->tree,
13463 TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, 0),
13466 *start_path = _gtk_tree_view_find_path (tree_view, tree, node);
13475 if (tree_view->priv->height < tree_view->priv->vadjustment->page_size)
13476 y = tree_view->priv->height - 1;
13478 y = TREE_WINDOW_Y_TO_RBTREE_Y (tree_view, tree_view->priv->vadjustment->page_size) - 1;
13480 _gtk_rbtree_find_offset (tree_view->priv->tree, y, &tree, &node);
13482 *end_path = _gtk_tree_view_find_path (tree_view, tree, node);
13491 unset_reorderable (GtkTreeView *tree_view)
13493 if (tree_view->priv->reorderable)
13495 tree_view->priv->reorderable = FALSE;
13496 g_object_notify (G_OBJECT (tree_view), "reorderable");
13501 * gtk_tree_view_enable_model_drag_source:
13502 * @tree_view: a #GtkTreeView
13503 * @start_button_mask: Mask of allowed buttons to start drag
13504 * @targets: (array): the table of targets that the drag will support
13505 * @n_targets: the number of items in @targets
13506 * @actions: the bitmask of possible actions for a drag from this
13509 * Turns @tree_view into a drag source for automatic DND. Calling this
13510 * method sets #GtkTreeView:reorderable to %FALSE.
13513 gtk_tree_view_enable_model_drag_source (GtkTreeView *tree_view,
13514 GdkModifierType start_button_mask,
13515 const GtkTargetEntry *targets,
13517 GdkDragAction actions)
13519 TreeViewDragInfo *di;
13521 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13523 gtk_drag_source_set (GTK_WIDGET (tree_view),
13529 di = ensure_info (tree_view);
13531 di->start_button_mask = start_button_mask;
13532 di->source_actions = actions;
13533 di->source_set = TRUE;
13535 unset_reorderable (tree_view);
13539 * gtk_tree_view_enable_model_drag_dest:
13540 * @tree_view: a #GtkTreeView
13541 * @targets: (array): the table of targets that the drag will support
13542 * @n_targets: the number of items in @targets
13543 * @actions: the bitmask of possible actions for a drag from this
13546 * Turns @tree_view into a drop destination for automatic DND. Calling
13547 * this method sets #GtkTreeView:reorderable to %FALSE.
13550 gtk_tree_view_enable_model_drag_dest (GtkTreeView *tree_view,
13551 const GtkTargetEntry *targets,
13553 GdkDragAction actions)
13555 TreeViewDragInfo *di;
13557 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13559 gtk_drag_dest_set (GTK_WIDGET (tree_view),
13565 di = ensure_info (tree_view);
13566 di->dest_set = TRUE;
13568 unset_reorderable (tree_view);
13572 * gtk_tree_view_unset_rows_drag_source:
13573 * @tree_view: a #GtkTreeView
13575 * Undoes the effect of
13576 * gtk_tree_view_enable_model_drag_source(). Calling this method sets
13577 * #GtkTreeView:reorderable to %FALSE.
13580 gtk_tree_view_unset_rows_drag_source (GtkTreeView *tree_view)
13582 TreeViewDragInfo *di;
13584 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13586 di = get_info (tree_view);
13590 if (di->source_set)
13592 gtk_drag_source_unset (GTK_WIDGET (tree_view));
13593 di->source_set = FALSE;
13596 if (!di->dest_set && !di->source_set)
13597 remove_info (tree_view);
13600 unset_reorderable (tree_view);
13604 * gtk_tree_view_unset_rows_drag_dest:
13605 * @tree_view: a #GtkTreeView
13607 * Undoes the effect of
13608 * gtk_tree_view_enable_model_drag_dest(). Calling this method sets
13609 * #GtkTreeView:reorderable to %FALSE.
13612 gtk_tree_view_unset_rows_drag_dest (GtkTreeView *tree_view)
13614 TreeViewDragInfo *di;
13616 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13618 di = get_info (tree_view);
13624 gtk_drag_dest_unset (GTK_WIDGET (tree_view));
13625 di->dest_set = FALSE;
13628 if (!di->dest_set && !di->source_set)
13629 remove_info (tree_view);
13632 unset_reorderable (tree_view);
13636 * gtk_tree_view_set_drag_dest_row:
13637 * @tree_view: a #GtkTreeView
13638 * @path: (allow-none): The path of the row to highlight, or %NULL.
13639 * @pos: Specifies whether to drop before, after or into the row
13641 * Sets the row that is highlighted for feedback.
13644 gtk_tree_view_set_drag_dest_row (GtkTreeView *tree_view,
13646 GtkTreeViewDropPosition pos)
13648 GtkTreePath *current_dest;
13650 /* Note; this function is exported to allow a custom DND
13651 * implementation, so it can't touch TreeViewDragInfo
13654 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13656 current_dest = NULL;
13658 if (tree_view->priv->drag_dest_row)
13660 current_dest = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
13661 gtk_tree_row_reference_free (tree_view->priv->drag_dest_row);
13664 /* special case a drop on an empty model */
13665 tree_view->priv->empty_view_drop = 0;
13667 if (pos == GTK_TREE_VIEW_DROP_BEFORE && path
13668 && gtk_tree_path_get_depth (path) == 1
13669 && gtk_tree_path_get_indices (path)[0] == 0)
13673 n_children = gtk_tree_model_iter_n_children (tree_view->priv->model,
13677 tree_view->priv->empty_view_drop = 1;
13680 tree_view->priv->drag_dest_pos = pos;
13684 tree_view->priv->drag_dest_row =
13685 gtk_tree_row_reference_new_proxy (G_OBJECT (tree_view), tree_view->priv->model, path);
13686 gtk_tree_view_queue_draw_path (tree_view, path, NULL);
13689 tree_view->priv->drag_dest_row = NULL;
13693 GtkRBTree *tree, *new_tree;
13694 GtkRBNode *node, *new_node;
13696 _gtk_tree_view_find_node (tree_view, current_dest, &tree, &node);
13697 _gtk_tree_view_queue_draw_node (tree_view, tree, node, NULL);
13701 _gtk_rbtree_next_full (tree, node, &new_tree, &new_node);
13702 if (new_tree && new_node)
13703 _gtk_tree_view_queue_draw_node (tree_view, new_tree, new_node, NULL);
13705 _gtk_rbtree_prev_full (tree, node, &new_tree, &new_node);
13706 if (new_tree && new_node)
13707 _gtk_tree_view_queue_draw_node (tree_view, new_tree, new_node, NULL);
13709 gtk_tree_path_free (current_dest);
13714 * gtk_tree_view_get_drag_dest_row:
13715 * @tree_view: a #GtkTreeView
13716 * @path: (out) (allow-none): Return location for the path of the highlighted row, or %NULL.
13717 * @pos: (out) (allow-none): Return location for the drop position, or %NULL
13719 * Gets information about the row that is highlighted for feedback.
13722 gtk_tree_view_get_drag_dest_row (GtkTreeView *tree_view,
13723 GtkTreePath **path,
13724 GtkTreeViewDropPosition *pos)
13726 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
13730 if (tree_view->priv->drag_dest_row)
13731 *path = gtk_tree_row_reference_get_path (tree_view->priv->drag_dest_row);
13734 if (tree_view->priv->empty_view_drop)
13735 *path = gtk_tree_path_new_from_indices (0, -1);
13742 *pos = tree_view->priv->drag_dest_pos;
13746 * gtk_tree_view_get_dest_row_at_pos:
13747 * @tree_view: a #GtkTreeView
13748 * @drag_x: the position to determine the destination row for
13749 * @drag_y: the position to determine the destination row for
13750 * @path: (out) (allow-none): Return location for the path of the highlighted row, or %NULL.
13751 * @pos: (out) (allow-none): Return location for the drop position, or %NULL
13753 * Determines the destination row for a given position. @drag_x and
13754 * @drag_y are expected to be in widget coordinates. This function is only
13755 * meaningful if @tree_view is realized. Therefore this function will always
13756 * return %FALSE if @tree_view is not realized or does not have a model.
13758 * Return value: whether there is a row at the given position, %TRUE if this
13759 * is indeed the case.
13762 gtk_tree_view_get_dest_row_at_pos (GtkTreeView *tree_view,
13765 GtkTreePath **path,
13766 GtkTreeViewDropPosition *pos)
13770 gdouble offset_into_row;
13773 GtkTreeViewColumn *column = NULL;
13774 GtkTreePath *tmp_path = NULL;
13776 /* Note; this function is exported to allow a custom DND
13777 * implementation, so it can't touch TreeViewDragInfo
13780 g_return_val_if_fail (tree_view != NULL, FALSE);
13781 g_return_val_if_fail (drag_x >= 0, FALSE);
13782 g_return_val_if_fail (drag_y >= 0, FALSE);
13787 if (tree_view->priv->bin_window == NULL)
13790 if (tree_view->priv->tree == NULL)
13793 /* If in the top third of a row, we drop before that row; if
13794 * in the bottom third, drop after that row; if in the middle,
13795 * and the row has children, drop into the row.
13797 gtk_tree_view_convert_widget_to_bin_window_coords (tree_view, drag_x, drag_y,
13800 if (!gtk_tree_view_get_path_at_pos (tree_view,
13809 gtk_tree_view_get_background_area (tree_view, tmp_path, column,
13812 offset_into_row = cell_y;
13817 gtk_tree_path_free (tmp_path);
13821 third = cell.height / 3.0;
13825 if (offset_into_row < third)
13827 *pos = GTK_TREE_VIEW_DROP_BEFORE;
13829 else if (offset_into_row < (cell.height / 2.0))
13831 *pos = GTK_TREE_VIEW_DROP_INTO_OR_BEFORE;
13833 else if (offset_into_row < third * 2.0)
13835 *pos = GTK_TREE_VIEW_DROP_INTO_OR_AFTER;
13839 *pos = GTK_TREE_VIEW_DROP_AFTER;
13848 /* KEEP IN SYNC WITH GTK_TREE_VIEW_BIN_EXPOSE */
13850 * gtk_tree_view_create_row_drag_icon:
13851 * @tree_view: a #GtkTreeView
13852 * @path: a #GtkTreePath in @tree_view
13854 * Creates a #cairo_surface_t representation of the row at @path.
13855 * This image is used for a drag icon.
13857 * Return value: (transfer full): a newly-allocated surface of the drag icon.
13860 gtk_tree_view_create_row_drag_icon (GtkTreeView *tree_view,
13869 GdkRectangle background_area;
13872 /* start drawing inside the black outline */
13874 cairo_surface_t *surface;
13875 gint bin_window_width;
13876 gboolean is_separator = FALSE;
13880 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
13881 g_return_val_if_fail (path != NULL, NULL);
13883 widget = GTK_WIDGET (tree_view);
13885 if (!gtk_widget_get_realized (widget))
13888 depth = gtk_tree_path_get_depth (path);
13890 _gtk_tree_view_find_node (tree_view,
13898 if (!gtk_tree_model_get_iter (tree_view->priv->model,
13903 style = gtk_widget_get_style (widget);
13905 is_separator = row_is_separator (tree_view, &iter, NULL);
13909 background_area.y = y;
13910 background_area.height = ROW_HEIGHT (tree_view, BACKGROUND_HEIGHT (node));
13912 bin_window_width = gdk_window_get_width (tree_view->priv->bin_window);
13914 surface = gdk_window_create_similar_surface (tree_view->priv->bin_window,
13915 CAIRO_CONTENT_COLOR,
13916 bin_window_width + 2,
13917 background_area.height + 2);
13919 cr = cairo_create (surface);
13920 gdk_cairo_set_source_color (cr, &style->base [gtk_widget_get_state (widget)]);
13923 rtl = gtk_widget_get_direction (GTK_WIDGET (tree_view)) == GTK_TEXT_DIR_RTL;
13925 for (list = (rtl ? g_list_last (tree_view->priv->columns) : g_list_first (tree_view->priv->columns));
13927 list = (rtl ? list->prev : list->next))
13929 GtkTreeViewColumn *column = list->data;
13930 GdkRectangle cell_area;
13931 gint vertical_separator;
13933 if (!gtk_tree_view_column_get_visible (column))
13936 gtk_tree_view_column_cell_set_cell_data (column, tree_view->priv->model, &iter,
13937 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_PARENT),
13938 node->children?TRUE:FALSE);
13940 background_area.x = cell_offset;
13941 background_area.width = gtk_tree_view_column_get_width (column);
13943 gtk_widget_style_get (widget,
13944 "vertical-separator", &vertical_separator,
13947 cell_area = background_area;
13949 cell_area.y += vertical_separator / 2;
13950 cell_area.height -= vertical_separator;
13952 if (gtk_tree_view_is_expander_column (tree_view, column))
13955 cell_area.x += (depth - 1) * tree_view->priv->level_indentation;
13956 cell_area.width -= (depth - 1) * tree_view->priv->level_indentation;
13958 if (TREE_VIEW_DRAW_EXPANDERS(tree_view))
13961 cell_area.x += depth * tree_view->priv->expander_size;
13962 cell_area.width -= depth * tree_view->priv->expander_size;
13966 if (gtk_tree_view_column_cell_is_visible (column))
13969 gtk_paint_hline (style,
13975 cell_area.x + cell_area.width,
13976 cell_area.y + cell_area.height / 2);
13978 _gtk_tree_view_column_cell_render (column,
13984 cell_offset += gtk_tree_view_column_get_width (column);
13987 cairo_set_source_rgb (cr, 0, 0, 0);
13988 cairo_rectangle (cr,
13990 bin_window_width + 1,
13991 background_area.height + 1);
13992 cairo_set_line_width (cr, 1.0);
13995 cairo_destroy (cr);
13997 cairo_surface_set_device_offset (surface, 2, 2);
14004 * gtk_tree_view_set_destroy_count_func:
14005 * @tree_view: A #GtkTreeView
14006 * @func: (allow-none): Function to be called when a view row is destroyed, or %NULL
14007 * @data: (allow-none): User data to be passed to @func, or %NULL
14008 * @destroy: (allow-none): Destroy notifier for @data, or %NULL
14010 * This function should almost never be used. It is meant for private use by
14011 * ATK for determining the number of visible children that are removed when the
14012 * user collapses a row, or a row is deleted.
14015 gtk_tree_view_set_destroy_count_func (GtkTreeView *tree_view,
14016 GtkTreeDestroyCountFunc func,
14018 GDestroyNotify destroy)
14020 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14022 if (tree_view->priv->destroy_count_destroy)
14023 tree_view->priv->destroy_count_destroy (tree_view->priv->destroy_count_data);
14025 tree_view->priv->destroy_count_func = func;
14026 tree_view->priv->destroy_count_data = data;
14027 tree_view->priv->destroy_count_destroy = destroy;
14032 * Interactive search
14036 * gtk_tree_view_set_enable_search:
14037 * @tree_view: A #GtkTreeView
14038 * @enable_search: %TRUE, if the user can search interactively
14040 * If @enable_search is set, then the user can type in text to search through
14041 * the tree interactively (this is sometimes called "typeahead find").
14043 * Note that even if this is %FALSE, the user can still initiate a search
14044 * using the "start-interactive-search" key binding.
14047 gtk_tree_view_set_enable_search (GtkTreeView *tree_view,
14048 gboolean enable_search)
14050 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14052 enable_search = !!enable_search;
14054 if (tree_view->priv->enable_search != enable_search)
14056 tree_view->priv->enable_search = enable_search;
14057 g_object_notify (G_OBJECT (tree_view), "enable-search");
14062 * gtk_tree_view_get_enable_search:
14063 * @tree_view: A #GtkTreeView
14065 * Returns whether or not the tree allows to start interactive searching
14066 * by typing in text.
14068 * Return value: whether or not to let the user search interactively
14071 gtk_tree_view_get_enable_search (GtkTreeView *tree_view)
14073 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
14075 return tree_view->priv->enable_search;
14080 * gtk_tree_view_get_search_column:
14081 * @tree_view: A #GtkTreeView
14083 * Gets the column searched on by the interactive search code.
14085 * Return value: the column the interactive search code searches in.
14088 gtk_tree_view_get_search_column (GtkTreeView *tree_view)
14090 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), -1);
14092 return (tree_view->priv->search_column);
14096 * gtk_tree_view_set_search_column:
14097 * @tree_view: A #GtkTreeView
14098 * @column: the column of the model to search in, or -1 to disable searching
14100 * Sets @column as the column where the interactive search code should
14101 * search in for the current model.
14103 * If the search column is set, users can use the "start-interactive-search"
14104 * key binding to bring up search popup. The enable-search property controls
14105 * whether simply typing text will also start an interactive search.
14107 * Note that @column refers to a column of the current model. The search
14108 * column is reset to -1 when the model is changed.
14111 gtk_tree_view_set_search_column (GtkTreeView *tree_view,
14114 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14115 g_return_if_fail (column >= -1);
14117 if (tree_view->priv->search_column == column)
14120 tree_view->priv->search_column = column;
14121 g_object_notify (G_OBJECT (tree_view), "search-column");
14125 * gtk_tree_view_get_search_equal_func:
14126 * @tree_view: A #GtkTreeView
14128 * Returns the compare function currently in use.
14130 * Return value: the currently used compare function for the search code.
14133 GtkTreeViewSearchEqualFunc
14134 gtk_tree_view_get_search_equal_func (GtkTreeView *tree_view)
14136 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
14138 return tree_view->priv->search_equal_func;
14142 * gtk_tree_view_set_search_equal_func:
14143 * @tree_view: A #GtkTreeView
14144 * @search_equal_func: the compare function to use during the search
14145 * @search_user_data: (allow-none): user data to pass to @search_equal_func, or %NULL
14146 * @search_destroy: (allow-none): Destroy notifier for @search_user_data, or %NULL
14148 * Sets the compare function for the interactive search capabilities; note
14149 * that somewhat like strcmp() returning 0 for equality
14150 * #GtkTreeViewSearchEqualFunc returns %FALSE on matches.
14153 gtk_tree_view_set_search_equal_func (GtkTreeView *tree_view,
14154 GtkTreeViewSearchEqualFunc search_equal_func,
14155 gpointer search_user_data,
14156 GDestroyNotify search_destroy)
14158 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14159 g_return_if_fail (search_equal_func != NULL);
14161 if (tree_view->priv->search_destroy)
14162 tree_view->priv->search_destroy (tree_view->priv->search_user_data);
14164 tree_view->priv->search_equal_func = search_equal_func;
14165 tree_view->priv->search_user_data = search_user_data;
14166 tree_view->priv->search_destroy = search_destroy;
14167 if (tree_view->priv->search_equal_func == NULL)
14168 tree_view->priv->search_equal_func = gtk_tree_view_search_equal_func;
14172 * gtk_tree_view_get_search_entry:
14173 * @tree_view: A #GtkTreeView
14175 * Returns the #GtkEntry which is currently in use as interactive search
14176 * entry for @tree_view. In case the built-in entry is being used, %NULL
14177 * will be returned.
14179 * Return value: (transfer none): the entry currently in use as search entry.
14184 gtk_tree_view_get_search_entry (GtkTreeView *tree_view)
14186 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
14188 if (tree_view->priv->search_custom_entry_set)
14189 return GTK_ENTRY (tree_view->priv->search_entry);
14195 * gtk_tree_view_set_search_entry:
14196 * @tree_view: A #GtkTreeView
14197 * @entry: (allow-none): the entry the interactive search code of @tree_view should use or %NULL
14199 * Sets the entry which the interactive search code will use for this
14200 * @tree_view. This is useful when you want to provide a search entry
14201 * in our interface at all time at a fixed position. Passing %NULL for
14202 * @entry will make the interactive search code use the built-in popup
14208 gtk_tree_view_set_search_entry (GtkTreeView *tree_view,
14211 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14212 g_return_if_fail (entry == NULL || GTK_IS_ENTRY (entry));
14214 if (tree_view->priv->search_custom_entry_set)
14216 if (tree_view->priv->search_entry_changed_id)
14218 g_signal_handler_disconnect (tree_view->priv->search_entry,
14219 tree_view->priv->search_entry_changed_id);
14220 tree_view->priv->search_entry_changed_id = 0;
14222 g_signal_handlers_disconnect_by_func (tree_view->priv->search_entry,
14223 G_CALLBACK (gtk_tree_view_search_key_press_event),
14226 g_object_unref (tree_view->priv->search_entry);
14228 else if (tree_view->priv->search_window)
14230 gtk_widget_destroy (tree_view->priv->search_window);
14232 tree_view->priv->search_window = NULL;
14237 tree_view->priv->search_entry = g_object_ref (entry);
14238 tree_view->priv->search_custom_entry_set = TRUE;
14240 if (tree_view->priv->search_entry_changed_id == 0)
14242 tree_view->priv->search_entry_changed_id =
14243 g_signal_connect (tree_view->priv->search_entry, "changed",
14244 G_CALLBACK (gtk_tree_view_search_init),
14248 g_signal_connect (tree_view->priv->search_entry, "key-press-event",
14249 G_CALLBACK (gtk_tree_view_search_key_press_event),
14252 gtk_tree_view_search_init (tree_view->priv->search_entry, tree_view);
14256 tree_view->priv->search_entry = NULL;
14257 tree_view->priv->search_custom_entry_set = FALSE;
14262 * gtk_tree_view_set_search_position_func:
14263 * @tree_view: A #GtkTreeView
14264 * @func: (allow-none): the function to use to position the search dialog, or %NULL
14265 * to use the default search position function
14266 * @data: (allow-none): user data to pass to @func, or %NULL
14267 * @destroy: (allow-none): Destroy notifier for @data, or %NULL
14269 * Sets the function to use when positioning the search dialog.
14274 gtk_tree_view_set_search_position_func (GtkTreeView *tree_view,
14275 GtkTreeViewSearchPositionFunc func,
14276 gpointer user_data,
14277 GDestroyNotify destroy)
14279 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14281 if (tree_view->priv->search_position_destroy)
14282 tree_view->priv->search_position_destroy (tree_view->priv->search_position_user_data);
14284 tree_view->priv->search_position_func = func;
14285 tree_view->priv->search_position_user_data = user_data;
14286 tree_view->priv->search_position_destroy = destroy;
14287 if (tree_view->priv->search_position_func == NULL)
14288 tree_view->priv->search_position_func = gtk_tree_view_search_position_func;
14292 * gtk_tree_view_get_search_position_func:
14293 * @tree_view: A #GtkTreeView
14295 * Returns the positioning function currently in use.
14297 * Return value: the currently used function for positioning the search dialog.
14301 GtkTreeViewSearchPositionFunc
14302 gtk_tree_view_get_search_position_func (GtkTreeView *tree_view)
14304 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
14306 return tree_view->priv->search_position_func;
14311 gtk_tree_view_search_dialog_hide (GtkWidget *search_dialog,
14312 GtkTreeView *tree_view,
14315 if (tree_view->priv->disable_popdown)
14318 if (tree_view->priv->search_entry_changed_id)
14320 g_signal_handler_disconnect (tree_view->priv->search_entry,
14321 tree_view->priv->search_entry_changed_id);
14322 tree_view->priv->search_entry_changed_id = 0;
14324 if (tree_view->priv->typeselect_flush_timeout)
14326 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14327 tree_view->priv->typeselect_flush_timeout = 0;
14330 if (gtk_widget_get_visible (search_dialog))
14332 /* send focus-in event */
14333 send_focus_change (GTK_WIDGET (tree_view->priv->search_entry), device, FALSE);
14334 gtk_widget_hide (search_dialog);
14335 gtk_entry_set_text (GTK_ENTRY (tree_view->priv->search_entry), "");
14336 send_focus_change (GTK_WIDGET (tree_view), device, TRUE);
14341 gtk_tree_view_search_position_func (GtkTreeView *tree_view,
14342 GtkWidget *search_dialog,
14343 gpointer user_data)
14346 gint tree_x, tree_y;
14347 gint tree_width, tree_height;
14348 GdkWindow *tree_window = gtk_widget_get_window (GTK_WIDGET (tree_view));
14349 GdkScreen *screen = gdk_window_get_screen (tree_window);
14350 GtkRequisition requisition;
14352 GdkRectangle monitor;
14354 monitor_num = gdk_screen_get_monitor_at_window (screen, tree_window);
14355 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
14357 gtk_widget_realize (search_dialog);
14359 gdk_window_get_origin (tree_window, &tree_x, &tree_y);
14360 tree_width = gdk_window_get_width (tree_window);
14361 tree_height = gdk_window_get_height (tree_window);
14362 gtk_widget_get_preferred_size (search_dialog, &requisition, NULL);
14364 if (tree_x + tree_width > gdk_screen_get_width (screen))
14365 x = gdk_screen_get_width (screen) - requisition.width;
14366 else if (tree_x + tree_width - requisition.width < 0)
14369 x = tree_x + tree_width - requisition.width;
14371 if (tree_y + tree_height + requisition.height > gdk_screen_get_height (screen))
14372 y = gdk_screen_get_height (screen) - requisition.height;
14373 else if (tree_y + tree_height < 0) /* isn't really possible ... */
14376 y = tree_y + tree_height;
14378 gtk_window_move (GTK_WINDOW (search_dialog), x, y);
14382 gtk_tree_view_search_disable_popdown (GtkEntry *entry,
14386 GtkTreeView *tree_view = (GtkTreeView *)data;
14388 tree_view->priv->disable_popdown = 1;
14389 g_signal_connect (menu, "hide",
14390 G_CALLBACK (gtk_tree_view_search_enable_popdown), data);
14393 /* Because we're visible but offscreen, we just set a flag in the preedit
14397 gtk_tree_view_search_preedit_changed (GtkIMContext *im_context,
14398 GtkTreeView *tree_view)
14400 tree_view->priv->imcontext_changed = 1;
14401 if (tree_view->priv->typeselect_flush_timeout)
14403 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14404 tree_view->priv->typeselect_flush_timeout =
14405 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
14406 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
14413 gtk_tree_view_search_activate (GtkEntry *entry,
14414 GtkTreeView *tree_view)
14420 gtk_tree_view_search_dialog_hide (tree_view->priv->search_window,
14422 gtk_get_current_event_device ());
14424 /* If we have a row selected and it's the cursor row, we activate
14426 if (gtk_tree_row_reference_valid (tree_view->priv->cursor))
14428 path = gtk_tree_row_reference_get_path (tree_view->priv->cursor);
14430 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
14432 if (node && GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_IS_SELECTED))
14433 gtk_tree_view_row_activated (tree_view, path, tree_view->priv->focus_column);
14435 gtk_tree_path_free (path);
14440 gtk_tree_view_real_search_enable_popdown (gpointer data)
14442 GtkTreeView *tree_view = (GtkTreeView *)data;
14444 tree_view->priv->disable_popdown = 0;
14450 gtk_tree_view_search_enable_popdown (GtkWidget *widget,
14453 gdk_threads_add_timeout_full (G_PRIORITY_HIGH, 200, gtk_tree_view_real_search_enable_popdown, g_object_ref (data), g_object_unref);
14457 gtk_tree_view_search_delete_event (GtkWidget *widget,
14458 GdkEventAny *event,
14459 GtkTreeView *tree_view)
14461 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
14463 gtk_tree_view_search_dialog_hide (widget, tree_view, NULL);
14469 gtk_tree_view_search_button_press_event (GtkWidget *widget,
14470 GdkEventButton *event,
14471 GtkTreeView *tree_view)
14473 GdkDevice *keyb_device;
14475 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
14477 keyb_device = gdk_device_get_associated_device (event->device);
14478 gtk_tree_view_search_dialog_hide (widget, tree_view, keyb_device);
14480 if (event->window == tree_view->priv->bin_window)
14481 gtk_tree_view_button_press (GTK_WIDGET (tree_view), event);
14487 gtk_tree_view_search_scroll_event (GtkWidget *widget,
14488 GdkEventScroll *event,
14489 GtkTreeView *tree_view)
14491 gboolean retval = FALSE;
14493 if (event->direction == GDK_SCROLL_UP)
14495 gtk_tree_view_search_move (widget, tree_view, TRUE);
14498 else if (event->direction == GDK_SCROLL_DOWN)
14500 gtk_tree_view_search_move (widget, tree_view, FALSE);
14504 /* renew the flush timeout */
14505 if (retval && tree_view->priv->typeselect_flush_timeout
14506 && !tree_view->priv->search_custom_entry_set)
14508 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14509 tree_view->priv->typeselect_flush_timeout =
14510 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
14511 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
14519 gtk_tree_view_search_key_press_event (GtkWidget *widget,
14520 GdkEventKey *event,
14521 GtkTreeView *tree_view)
14523 gboolean retval = FALSE;
14525 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
14526 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
14528 /* close window and cancel the search */
14529 if (!tree_view->priv->search_custom_entry_set
14530 && (event->keyval == GDK_KEY_Escape ||
14531 event->keyval == GDK_KEY_Tab ||
14532 event->keyval == GDK_KEY_KP_Tab ||
14533 event->keyval == GDK_KEY_ISO_Left_Tab))
14535 gtk_tree_view_search_dialog_hide (widget, tree_view,
14536 gdk_event_get_device ((GdkEvent *) event));
14540 /* select previous matching iter */
14541 if (event->keyval == GDK_KEY_Up || event->keyval == GDK_KEY_KP_Up)
14543 if (!gtk_tree_view_search_move (widget, tree_view, TRUE))
14544 gtk_widget_error_bell (widget);
14549 if (((event->state & (GTK_DEFAULT_ACCEL_MOD_MASK | GDK_SHIFT_MASK)) == (GTK_DEFAULT_ACCEL_MOD_MASK | GDK_SHIFT_MASK))
14550 && (event->keyval == GDK_KEY_g || event->keyval == GDK_KEY_G))
14552 if (!gtk_tree_view_search_move (widget, tree_view, TRUE))
14553 gtk_widget_error_bell (widget);
14558 /* select next matching iter */
14559 if (event->keyval == GDK_KEY_Down || event->keyval == GDK_KEY_KP_Down)
14561 if (!gtk_tree_view_search_move (widget, tree_view, FALSE))
14562 gtk_widget_error_bell (widget);
14567 if (((event->state & (GTK_DEFAULT_ACCEL_MOD_MASK | GDK_SHIFT_MASK)) == GTK_DEFAULT_ACCEL_MOD_MASK)
14568 && (event->keyval == GDK_KEY_g || event->keyval == GDK_KEY_G))
14570 if (!gtk_tree_view_search_move (widget, tree_view, FALSE))
14571 gtk_widget_error_bell (widget);
14576 /* renew the flush timeout */
14577 if (retval && tree_view->priv->typeselect_flush_timeout
14578 && !tree_view->priv->search_custom_entry_set)
14580 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14581 tree_view->priv->typeselect_flush_timeout =
14582 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
14583 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
14590 /* this function returns FALSE if there is a search string but
14591 * nothing was found, and TRUE otherwise.
14594 gtk_tree_view_search_move (GtkWidget *window,
14595 GtkTreeView *tree_view,
14603 GtkTreeModel *model;
14604 GtkTreeSelection *selection;
14606 text = gtk_entry_get_text (GTK_ENTRY (tree_view->priv->search_entry));
14608 g_return_val_if_fail (text != NULL, FALSE);
14610 len = strlen (text);
14612 if (up && tree_view->priv->selected_iter == 1)
14613 return strlen (text) < 1;
14615 len = strlen (text);
14620 model = gtk_tree_view_get_model (tree_view);
14621 selection = gtk_tree_view_get_selection (tree_view);
14624 gtk_tree_selection_unselect_all (selection);
14625 if (!gtk_tree_model_get_iter_first (model, &iter))
14628 ret = gtk_tree_view_search_iter (model, selection, &iter, text,
14629 &count, up?((tree_view->priv->selected_iter) - 1):((tree_view->priv->selected_iter + 1)));
14634 tree_view->priv->selected_iter += up?(-1):(1);
14639 /* return to old iter */
14641 gtk_tree_model_get_iter_first (model, &iter);
14642 gtk_tree_view_search_iter (model, selection,
14644 &count, tree_view->priv->selected_iter);
14650 gtk_tree_view_search_equal_func (GtkTreeModel *model,
14654 gpointer search_data)
14656 gboolean retval = TRUE;
14658 gchar *normalized_string;
14659 gchar *normalized_key;
14660 gchar *case_normalized_string = NULL;
14661 gchar *case_normalized_key = NULL;
14662 GValue value = {0,};
14663 GValue transformed = {0,};
14665 gtk_tree_model_get_value (model, iter, column, &value);
14667 g_value_init (&transformed, G_TYPE_STRING);
14669 if (!g_value_transform (&value, &transformed))
14671 g_value_unset (&value);
14675 g_value_unset (&value);
14677 str = g_value_get_string (&transformed);
14680 g_value_unset (&transformed);
14684 normalized_string = g_utf8_normalize (str, -1, G_NORMALIZE_ALL);
14685 normalized_key = g_utf8_normalize (key, -1, G_NORMALIZE_ALL);
14687 if (normalized_string && normalized_key)
14689 case_normalized_string = g_utf8_casefold (normalized_string, -1);
14690 case_normalized_key = g_utf8_casefold (normalized_key, -1);
14692 if (strncmp (case_normalized_key, case_normalized_string, strlen (case_normalized_key)) == 0)
14696 g_value_unset (&transformed);
14697 g_free (normalized_key);
14698 g_free (normalized_string);
14699 g_free (case_normalized_key);
14700 g_free (case_normalized_string);
14706 gtk_tree_view_search_iter (GtkTreeModel *model,
14707 GtkTreeSelection *selection,
14713 GtkRBTree *tree = NULL;
14714 GtkRBNode *node = NULL;
14717 GtkTreeView *tree_view = gtk_tree_selection_get_tree_view (selection);
14719 path = gtk_tree_model_get_path (model, iter);
14720 _gtk_tree_view_find_node (tree_view, path, &tree, &node);
14724 if (! tree_view->priv->search_equal_func (model, tree_view->priv->search_column, text, iter, tree_view->priv->search_user_data))
14729 gtk_tree_view_scroll_to_cell (tree_view, path, NULL,
14731 gtk_tree_selection_select_iter (selection, iter);
14732 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
14735 gtk_tree_path_free (path);
14741 if (node->children)
14743 gboolean has_child;
14746 tree = node->children;
14749 while (node->left != tree->nil)
14753 has_child = gtk_tree_model_iter_children (model, iter, &tmp);
14754 gtk_tree_path_down (path);
14757 TREE_VIEW_INTERNAL_ASSERT (has_child, FALSE);
14761 gboolean done = FALSE;
14765 node = _gtk_rbtree_next (tree, node);
14771 has_next = gtk_tree_model_iter_next (model, iter);
14774 gtk_tree_path_next (path);
14777 TREE_VIEW_INTERNAL_ASSERT (has_next, FALSE);
14781 gboolean has_parent;
14782 GtkTreeIter tmp_iter = *iter;
14784 node = tree->parent_node;
14785 tree = tree->parent_tree;
14790 gtk_tree_path_free (path);
14792 /* we've run out of tree, done with this func */
14796 has_parent = gtk_tree_model_iter_parent (model,
14799 gtk_tree_path_up (path);
14802 TREE_VIEW_INTERNAL_ASSERT (has_parent, FALSE);
14814 gtk_tree_view_search_init (GtkWidget *entry,
14815 GtkTreeView *tree_view)
14821 GtkTreeModel *model;
14822 GtkTreeSelection *selection;
14824 g_return_if_fail (GTK_IS_ENTRY (entry));
14825 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
14827 text = gtk_entry_get_text (GTK_ENTRY (entry));
14829 model = gtk_tree_view_get_model (tree_view);
14830 selection = gtk_tree_view_get_selection (tree_view);
14833 gtk_tree_selection_unselect_all (selection);
14834 if (tree_view->priv->typeselect_flush_timeout
14835 && !tree_view->priv->search_custom_entry_set)
14837 g_source_remove (tree_view->priv->typeselect_flush_timeout);
14838 tree_view->priv->typeselect_flush_timeout =
14839 gdk_threads_add_timeout (GTK_TREE_VIEW_SEARCH_DIALOG_TIMEOUT,
14840 (GSourceFunc) gtk_tree_view_search_entry_flush_timeout,
14847 if (!gtk_tree_model_get_iter_first (model, &iter))
14850 ret = gtk_tree_view_search_iter (model, selection,
14855 tree_view->priv->selected_iter = 1;
14859 gtk_tree_view_remove_widget (GtkCellEditable *cell_editable,
14860 GtkTreeView *tree_view)
14862 if (tree_view->priv->edited_column == NULL)
14865 _gtk_tree_view_column_stop_editing (tree_view->priv->edited_column);
14866 tree_view->priv->edited_column = NULL;
14868 if (gtk_widget_has_focus (GTK_WIDGET (cell_editable)))
14869 gtk_widget_grab_focus (GTK_WIDGET (tree_view));
14871 g_signal_handlers_disconnect_by_func (cell_editable,
14872 gtk_tree_view_remove_widget,
14875 gtk_container_remove (GTK_CONTAINER (tree_view),
14876 GTK_WIDGET (cell_editable));
14878 /* FIXME should only redraw a single node */
14879 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
14883 gtk_tree_view_start_editing (GtkTreeView *tree_view,
14884 GtkTreePath *cursor_path)
14887 GdkRectangle background_area;
14888 GdkRectangle cell_area;
14889 GtkCellEditable *editable_widget = NULL;
14890 gchar *path_string;
14891 guint flags = 0; /* can be 0, as the flags are primarily for rendering */
14892 gint retval = FALSE;
14893 GtkRBTree *cursor_tree;
14894 GtkRBNode *cursor_node;
14896 g_assert (tree_view->priv->focus_column);
14898 if (!gtk_widget_get_realized (GTK_WIDGET (tree_view)))
14901 if (_gtk_tree_view_find_node (tree_view, cursor_path, &cursor_tree, &cursor_node) ||
14902 cursor_node == NULL)
14905 path_string = gtk_tree_path_to_string (cursor_path);
14906 gtk_tree_model_get_iter (tree_view->priv->model, &iter, cursor_path);
14908 validate_row (tree_view, cursor_tree, cursor_node, &iter, cursor_path);
14910 gtk_tree_view_column_cell_set_cell_data (tree_view->priv->focus_column,
14911 tree_view->priv->model,
14913 GTK_RBNODE_FLAG_SET (cursor_node, GTK_RBNODE_IS_PARENT),
14914 cursor_node->children?TRUE:FALSE);
14915 gtk_tree_view_get_background_area (tree_view,
14917 tree_view->priv->focus_column,
14919 gtk_tree_view_get_cell_area (tree_view,
14921 tree_view->priv->focus_column,
14924 if (_gtk_tree_view_column_cell_event (tree_view->priv->focus_column,
14933 if (editable_widget != NULL)
14937 GtkCellRenderer *cell;
14940 cell = _gtk_tree_view_column_get_edited_cell (tree_view->priv->focus_column);
14942 _gtk_tree_view_column_get_neighbor_sizes (tree_view->priv->focus_column, cell, &left, &right);
14945 area.width -= right + left;
14947 gtk_tree_view_real_start_editing (tree_view,
14948 tree_view->priv->focus_column,
14957 g_free (path_string);
14962 gtk_tree_view_real_start_editing (GtkTreeView *tree_view,
14963 GtkTreeViewColumn *column,
14965 GtkCellEditable *cell_editable,
14966 GdkRectangle *cell_area,
14970 gint pre_val = tree_view->priv->vadjustment->value;
14971 GtkRequisition requisition;
14973 tree_view->priv->edited_column = column;
14974 _gtk_tree_view_column_start_editing (column, GTK_CELL_EDITABLE (cell_editable));
14976 gtk_tree_view_real_set_cursor (tree_view, path, FALSE, TRUE);
14977 cell_area->y += pre_val - (int)tree_view->priv->vadjustment->value;
14979 gtk_widget_get_preferred_size (GTK_WIDGET (cell_editable),
14980 &requisition, NULL);
14982 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_DRAW_KEYFOCUS);
14984 if (requisition.height < cell_area->height)
14986 gint diff = cell_area->height - requisition.height;
14987 gtk_tree_view_put (tree_view,
14988 GTK_WIDGET (cell_editable),
14989 cell_area->x, cell_area->y + diff/2,
14990 cell_area->width, requisition.height);
14994 gtk_tree_view_put (tree_view,
14995 GTK_WIDGET (cell_editable),
14996 cell_area->x, cell_area->y,
14997 cell_area->width, cell_area->height);
15000 gtk_cell_editable_start_editing (GTK_CELL_EDITABLE (cell_editable),
15001 (GdkEvent *)event);
15003 gtk_widget_grab_focus (GTK_WIDGET (cell_editable));
15004 g_signal_connect (cell_editable, "remove-widget",
15005 G_CALLBACK (gtk_tree_view_remove_widget), tree_view);
15009 gtk_tree_view_stop_editing (GtkTreeView *tree_view,
15010 gboolean cancel_editing)
15012 GtkTreeViewColumn *column;
15013 GtkCellRenderer *cell;
15015 if (tree_view->priv->edited_column == NULL)
15019 * This is very evil. We need to do this, because
15020 * gtk_cell_editable_editing_done may trigger gtk_tree_view_row_changed
15021 * later on. If gtk_tree_view_row_changed notices
15022 * tree_view->priv->edited_column != NULL, it'll call
15023 * gtk_tree_view_stop_editing again. Bad things will happen then.
15025 * Please read that again if you intend to modify anything here.
15028 column = tree_view->priv->edited_column;
15029 tree_view->priv->edited_column = NULL;
15031 cell = _gtk_tree_view_column_get_edited_cell (column);
15032 gtk_cell_renderer_stop_editing (cell, cancel_editing);
15034 if (!cancel_editing)
15035 gtk_cell_editable_editing_done (column->editable_widget);
15037 tree_view->priv->edited_column = column;
15039 gtk_cell_editable_remove_widget (column->editable_widget);
15044 * gtk_tree_view_set_hover_selection:
15045 * @tree_view: a #GtkTreeView
15046 * @hover: %TRUE to enable hover selection mode
15048 * Enables of disables the hover selection mode of @tree_view.
15049 * Hover selection makes the selected row follow the pointer.
15050 * Currently, this works only for the selection modes
15051 * %GTK_SELECTION_SINGLE and %GTK_SELECTION_BROWSE.
15056 gtk_tree_view_set_hover_selection (GtkTreeView *tree_view,
15059 hover = hover != FALSE;
15061 if (hover != tree_view->priv->hover_selection)
15063 tree_view->priv->hover_selection = hover;
15065 g_object_notify (G_OBJECT (tree_view), "hover-selection");
15070 * gtk_tree_view_get_hover_selection:
15071 * @tree_view: a #GtkTreeView
15073 * Returns whether hover selection mode is turned on for @tree_view.
15075 * Return value: %TRUE if @tree_view is in hover selection mode
15080 gtk_tree_view_get_hover_selection (GtkTreeView *tree_view)
15082 return tree_view->priv->hover_selection;
15086 * gtk_tree_view_set_hover_expand:
15087 * @tree_view: a #GtkTreeView
15088 * @expand: %TRUE to enable hover selection mode
15090 * Enables of disables the hover expansion mode of @tree_view.
15091 * Hover expansion makes rows expand or collapse if the pointer
15097 gtk_tree_view_set_hover_expand (GtkTreeView *tree_view,
15100 expand = expand != FALSE;
15102 if (expand != tree_view->priv->hover_expand)
15104 tree_view->priv->hover_expand = expand;
15106 g_object_notify (G_OBJECT (tree_view), "hover-expand");
15111 * gtk_tree_view_get_hover_expand:
15112 * @tree_view: a #GtkTreeView
15114 * Returns whether hover expansion mode is turned on for @tree_view.
15116 * Return value: %TRUE if @tree_view is in hover expansion mode
15121 gtk_tree_view_get_hover_expand (GtkTreeView *tree_view)
15123 return tree_view->priv->hover_expand;
15127 * gtk_tree_view_set_rubber_banding:
15128 * @tree_view: a #GtkTreeView
15129 * @enable: %TRUE to enable rubber banding
15131 * Enables or disables rubber banding in @tree_view. If the selection mode
15132 * is #GTK_SELECTION_MULTIPLE, rubber banding will allow the user to select
15133 * multiple rows by dragging the mouse.
15138 gtk_tree_view_set_rubber_banding (GtkTreeView *tree_view,
15141 enable = enable != FALSE;
15143 if (enable != tree_view->priv->rubber_banding_enable)
15145 tree_view->priv->rubber_banding_enable = enable;
15147 g_object_notify (G_OBJECT (tree_view), "rubber-banding");
15152 * gtk_tree_view_get_rubber_banding:
15153 * @tree_view: a #GtkTreeView
15155 * Returns whether rubber banding is turned on for @tree_view. If the
15156 * selection mode is #GTK_SELECTION_MULTIPLE, rubber banding will allow the
15157 * user to select multiple rows by dragging the mouse.
15159 * Return value: %TRUE if rubber banding in @tree_view is enabled.
15164 gtk_tree_view_get_rubber_banding (GtkTreeView *tree_view)
15166 return tree_view->priv->rubber_banding_enable;
15170 * gtk_tree_view_is_rubber_banding_active:
15171 * @tree_view: a #GtkTreeView
15173 * Returns whether a rubber banding operation is currently being done
15176 * Return value: %TRUE if a rubber banding operation is currently being
15177 * done in @tree_view.
15182 gtk_tree_view_is_rubber_banding_active (GtkTreeView *tree_view)
15184 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
15186 if (tree_view->priv->rubber_banding_enable
15187 && tree_view->priv->rubber_band_status == RUBBER_BAND_ACTIVE)
15194 * gtk_tree_view_get_row_separator_func:
15195 * @tree_view: a #GtkTreeView
15197 * Returns the current row separator function.
15199 * Return value: the current row separator function.
15203 GtkTreeViewRowSeparatorFunc
15204 gtk_tree_view_get_row_separator_func (GtkTreeView *tree_view)
15206 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), NULL);
15208 return tree_view->priv->row_separator_func;
15212 * gtk_tree_view_set_row_separator_func:
15213 * @tree_view: a #GtkTreeView
15214 * @func: (allow-none): a #GtkTreeViewRowSeparatorFunc
15215 * @data: (allow-none): user data to pass to @func, or %NULL
15216 * @destroy: (allow-none): destroy notifier for @data, or %NULL
15218 * Sets the row separator function, which is used to determine
15219 * whether a row should be drawn as a separator. If the row separator
15220 * function is %NULL, no separators are drawn. This is the default value.
15225 gtk_tree_view_set_row_separator_func (GtkTreeView *tree_view,
15226 GtkTreeViewRowSeparatorFunc func,
15228 GDestroyNotify destroy)
15230 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15232 if (tree_view->priv->row_separator_destroy)
15233 tree_view->priv->row_separator_destroy (tree_view->priv->row_separator_data);
15235 tree_view->priv->row_separator_func = func;
15236 tree_view->priv->row_separator_data = data;
15237 tree_view->priv->row_separator_destroy = destroy;
15239 /* Have the tree recalculate heights */
15240 _gtk_rbtree_mark_invalid (tree_view->priv->tree);
15241 gtk_widget_queue_resize (GTK_WIDGET (tree_view));
15246 gtk_tree_view_grab_notify (GtkWidget *widget,
15247 gboolean was_grabbed)
15249 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
15251 tree_view->priv->in_grab = !was_grabbed;
15255 tree_view->priv->pressed_button = -1;
15257 if (tree_view->priv->rubber_band_status)
15258 gtk_tree_view_stop_rubber_band (tree_view);
15263 gtk_tree_view_state_changed (GtkWidget *widget,
15264 GtkStateType previous_state)
15266 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
15268 if (gtk_widget_get_realized (widget))
15270 gdk_window_set_background (tree_view->priv->bin_window,
15271 >k_widget_get_style (widget)->base[gtk_widget_get_state (widget)]);
15274 gtk_widget_queue_draw (widget);
15278 * gtk_tree_view_get_grid_lines:
15279 * @tree_view: a #GtkTreeView
15281 * Returns which grid lines are enabled in @tree_view.
15283 * Return value: a #GtkTreeViewGridLines value indicating which grid lines
15288 GtkTreeViewGridLines
15289 gtk_tree_view_get_grid_lines (GtkTreeView *tree_view)
15291 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), 0);
15293 return tree_view->priv->grid_lines;
15297 * gtk_tree_view_set_grid_lines:
15298 * @tree_view: a #GtkTreeView
15299 * @grid_lines: a #GtkTreeViewGridLines value indicating which grid lines to
15302 * Sets which grid lines to draw in @tree_view.
15307 gtk_tree_view_set_grid_lines (GtkTreeView *tree_view,
15308 GtkTreeViewGridLines grid_lines)
15310 GtkTreeViewPrivate *priv;
15312 GtkTreeViewGridLines old_grid_lines;
15314 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15316 priv = tree_view->priv;
15317 widget = GTK_WIDGET (tree_view);
15319 old_grid_lines = priv->grid_lines;
15320 priv->grid_lines = grid_lines;
15322 if (gtk_widget_get_realized (widget))
15324 if (grid_lines == GTK_TREE_VIEW_GRID_LINES_NONE &&
15325 priv->grid_line_width)
15327 priv->grid_line_width = 0;
15330 if (grid_lines != GTK_TREE_VIEW_GRID_LINES_NONE &&
15331 !priv->grid_line_width)
15335 gtk_widget_style_get (widget,
15336 "grid-line-width", &priv->grid_line_width,
15337 "grid-line-pattern", (gchar *)&dash_list,
15342 priv->grid_line_dashes[0] = dash_list[0];
15344 priv->grid_line_dashes[1] = dash_list[1];
15346 g_free (dash_list);
15350 priv->grid_line_dashes[0] = 1;
15351 priv->grid_line_dashes[1] = 1;
15356 if (old_grid_lines != grid_lines)
15358 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
15360 g_object_notify (G_OBJECT (tree_view), "enable-grid-lines");
15365 * gtk_tree_view_get_enable_tree_lines:
15366 * @tree_view: a #GtkTreeView.
15368 * Returns whether or not tree lines are drawn in @tree_view.
15370 * Return value: %TRUE if tree lines are drawn in @tree_view, %FALSE
15376 gtk_tree_view_get_enable_tree_lines (GtkTreeView *tree_view)
15378 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
15380 return tree_view->priv->tree_lines_enabled;
15384 * gtk_tree_view_set_enable_tree_lines:
15385 * @tree_view: a #GtkTreeView
15386 * @enabled: %TRUE to enable tree line drawing, %FALSE otherwise.
15388 * Sets whether to draw lines interconnecting the expanders in @tree_view.
15389 * This does not have any visible effects for lists.
15394 gtk_tree_view_set_enable_tree_lines (GtkTreeView *tree_view,
15397 GtkTreeViewPrivate *priv;
15399 gboolean was_enabled;
15401 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15403 enabled = enabled != FALSE;
15405 priv = tree_view->priv;
15406 widget = GTK_WIDGET (tree_view);
15408 was_enabled = priv->tree_lines_enabled;
15410 priv->tree_lines_enabled = enabled;
15412 if (gtk_widget_get_realized (widget))
15414 if (!enabled && priv->tree_line_width)
15416 priv->tree_line_width = 0;
15419 if (enabled && !priv->tree_line_width)
15422 gtk_widget_style_get (widget,
15423 "tree-line-width", &priv->tree_line_width,
15424 "tree-line-pattern", (gchar *)&dash_list,
15429 priv->tree_line_dashes[0] = dash_list[0];
15431 priv->tree_line_dashes[1] = dash_list[1];
15433 g_free (dash_list);
15437 priv->tree_line_dashes[0] = 1;
15438 priv->tree_line_dashes[1] = 1;
15443 if (was_enabled != enabled)
15445 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
15447 g_object_notify (G_OBJECT (tree_view), "enable-tree-lines");
15453 * gtk_tree_view_set_show_expanders:
15454 * @tree_view: a #GtkTreeView
15455 * @enabled: %TRUE to enable expander drawing, %FALSE otherwise.
15457 * Sets whether to draw and enable expanders and indent child rows in
15458 * @tree_view. When disabled there will be no expanders visible in trees
15459 * and there will be no way to expand and collapse rows by default. Also
15460 * note that hiding the expanders will disable the default indentation. You
15461 * can set a custom indentation in this case using
15462 * gtk_tree_view_set_level_indentation().
15463 * This does not have any visible effects for lists.
15468 gtk_tree_view_set_show_expanders (GtkTreeView *tree_view,
15471 gboolean was_enabled;
15473 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15475 enabled = enabled != FALSE;
15476 was_enabled = GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS);
15479 GTK_TREE_VIEW_SET_FLAG (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS);
15481 GTK_TREE_VIEW_UNSET_FLAG (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS);
15483 if (enabled != was_enabled)
15484 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
15488 * gtk_tree_view_get_show_expanders:
15489 * @tree_view: a #GtkTreeView.
15491 * Returns whether or not expanders are drawn in @tree_view.
15493 * Return value: %TRUE if expanders are drawn in @tree_view, %FALSE
15499 gtk_tree_view_get_show_expanders (GtkTreeView *tree_view)
15501 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
15503 return GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS);
15507 * gtk_tree_view_set_level_indentation:
15508 * @tree_view: a #GtkTreeView
15509 * @indentation: the amount, in pixels, of extra indentation in @tree_view.
15511 * Sets the amount of extra indentation for child levels to use in @tree_view
15512 * in addition to the default indentation. The value should be specified in
15513 * pixels, a value of 0 disables this feature and in this case only the default
15514 * indentation will be used.
15515 * This does not have any visible effects for lists.
15520 gtk_tree_view_set_level_indentation (GtkTreeView *tree_view,
15523 tree_view->priv->level_indentation = indentation;
15525 gtk_widget_queue_draw (GTK_WIDGET (tree_view));
15529 * gtk_tree_view_get_level_indentation:
15530 * @tree_view: a #GtkTreeView.
15532 * Returns the amount, in pixels, of extra indentation for child levels
15535 * Return value: the amount of extra indentation for child levels in
15536 * @tree_view. A return value of 0 means that this feature is disabled.
15541 gtk_tree_view_get_level_indentation (GtkTreeView *tree_view)
15543 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), 0);
15545 return tree_view->priv->level_indentation;
15549 * gtk_tree_view_set_tooltip_row:
15550 * @tree_view: a #GtkTreeView
15551 * @tooltip: a #GtkTooltip
15552 * @path: a #GtkTreePath
15554 * Sets the tip area of @tooltip to be the area covered by the row at @path.
15555 * See also gtk_tree_view_set_tooltip_column() for a simpler alternative.
15556 * See also gtk_tooltip_set_tip_area().
15561 gtk_tree_view_set_tooltip_row (GtkTreeView *tree_view,
15562 GtkTooltip *tooltip,
15565 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15566 g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
15568 gtk_tree_view_set_tooltip_cell (tree_view, tooltip, path, NULL, NULL);
15572 * gtk_tree_view_set_tooltip_cell:
15573 * @tree_view: a #GtkTreeView
15574 * @tooltip: a #GtkTooltip
15575 * @path: (allow-none): a #GtkTreePath or %NULL
15576 * @column: (allow-none): a #GtkTreeViewColumn or %NULL
15577 * @cell: (allow-none): a #GtkCellRenderer or %NULL
15579 * Sets the tip area of @tooltip to the area @path, @column and @cell have
15580 * in common. For example if @path is %NULL and @column is set, the tip
15581 * area will be set to the full area covered by @column. See also
15582 * gtk_tooltip_set_tip_area().
15584 * Note that if @path is not specified and @cell is set and part of a column
15585 * containing the expander, the tooltip might not show and hide at the correct
15586 * position. In such cases @path must be set to the current node under the
15587 * mouse cursor for this function to operate correctly.
15589 * See also gtk_tree_view_set_tooltip_column() for a simpler alternative.
15594 gtk_tree_view_set_tooltip_cell (GtkTreeView *tree_view,
15595 GtkTooltip *tooltip,
15597 GtkTreeViewColumn *column,
15598 GtkCellRenderer *cell)
15600 GtkAllocation allocation;
15603 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15604 g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
15605 g_return_if_fail (column == NULL || GTK_IS_TREE_VIEW_COLUMN (column));
15606 g_return_if_fail (cell == NULL || GTK_IS_CELL_RENDERER (cell));
15608 /* Determine x values. */
15609 if (column && cell)
15614 /* We always pass in path here, whether it is NULL or not.
15615 * For cells in expander columns path must be specified so that
15616 * we can correctly account for the indentation. This also means
15617 * that the tooltip is constrained vertically by the "Determine y
15618 * values" code below; this is not a real problem since cells actually
15619 * don't stretch vertically in constrast to columns.
15621 gtk_tree_view_get_cell_area (tree_view, path, column, &tmp);
15622 gtk_tree_view_column_cell_get_position (column, cell, &start, &width);
15624 gtk_tree_view_convert_bin_window_to_widget_coords (tree_view,
15627 rect.width = width;
15633 gtk_tree_view_get_background_area (tree_view, NULL, column, &tmp);
15634 gtk_tree_view_convert_bin_window_to_widget_coords (tree_view,
15637 rect.width = tmp.width;
15641 gtk_widget_get_allocation (GTK_WIDGET (tree_view), &allocation);
15643 rect.width = allocation.width;
15646 /* Determine y values. */
15651 gtk_tree_view_get_background_area (tree_view, path, NULL, &tmp);
15652 gtk_tree_view_convert_bin_window_to_widget_coords (tree_view,
15655 rect.height = tmp.height;
15660 rect.height = tree_view->priv->vadjustment->page_size;
15663 gtk_tooltip_set_tip_area (tooltip, &rect);
15667 * gtk_tree_view_get_tooltip_context:
15668 * @tree_view: a #GtkTreeView
15669 * @x: the x coordinate (relative to widget coordinates)
15670 * @y: the y coordinate (relative to widget coordinates)
15671 * @keyboard_tip: whether this is a keyboard tooltip or not
15672 * @model: (out) (allow-none): a pointer to receive a #GtkTreeModel or %NULL
15673 * @path: (out) (allow-none): a pointer to receive a #GtkTreePath or %NULL
15674 * @iter: (out) (allow-none): a pointer to receive a #GtkTreeIter or %NULL
15676 * This function is supposed to be used in a #GtkWidget::query-tooltip
15677 * signal handler for #GtkTreeView. The @x, @y and @keyboard_tip values
15678 * which are received in the signal handler, should be passed to this
15679 * function without modification.
15681 * The return value indicates whether there is a tree view row at the given
15682 * coordinates (%TRUE) or not (%FALSE) for mouse tooltips. For keyboard
15683 * tooltips the row returned will be the cursor row. When %TRUE, then any of
15684 * @model, @path and @iter which have been provided will be set to point to
15685 * that row and the corresponding model. @x and @y will always be converted
15686 * to be relative to @tree_view's bin_window if @keyboard_tooltip is %FALSE.
15688 * Return value: whether or not the given tooltip context points to a row.
15693 gtk_tree_view_get_tooltip_context (GtkTreeView *tree_view,
15696 gboolean keyboard_tip,
15697 GtkTreeModel **model,
15698 GtkTreePath **path,
15701 GtkTreePath *tmppath = NULL;
15703 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), FALSE);
15704 g_return_val_if_fail (x != NULL, FALSE);
15705 g_return_val_if_fail (y != NULL, FALSE);
15709 gtk_tree_view_get_cursor (tree_view, &tmppath, NULL);
15716 gtk_tree_view_convert_widget_to_bin_window_coords (tree_view, *x, *y,
15719 if (!gtk_tree_view_get_path_at_pos (tree_view, *x, *y,
15720 &tmppath, NULL, NULL, NULL))
15725 *model = gtk_tree_view_get_model (tree_view);
15728 gtk_tree_model_get_iter (gtk_tree_view_get_model (tree_view),
15734 gtk_tree_path_free (tmppath);
15740 gtk_tree_view_set_tooltip_query_cb (GtkWidget *widget,
15743 gboolean keyboard_tip,
15744 GtkTooltip *tooltip,
15747 GValue value = { 0, };
15748 GValue transformed = { 0, };
15751 GtkTreeModel *model;
15752 GtkTreeView *tree_view = GTK_TREE_VIEW (widget);
15754 if (!gtk_tree_view_get_tooltip_context (GTK_TREE_VIEW (widget),
15757 &model, &path, &iter))
15760 gtk_tree_model_get_value (model, &iter,
15761 tree_view->priv->tooltip_column, &value);
15763 g_value_init (&transformed, G_TYPE_STRING);
15765 if (!g_value_transform (&value, &transformed))
15767 g_value_unset (&value);
15768 gtk_tree_path_free (path);
15773 g_value_unset (&value);
15775 if (!g_value_get_string (&transformed))
15777 g_value_unset (&transformed);
15778 gtk_tree_path_free (path);
15783 gtk_tooltip_set_markup (tooltip, g_value_get_string (&transformed));
15784 gtk_tree_view_set_tooltip_row (tree_view, tooltip, path);
15786 gtk_tree_path_free (path);
15787 g_value_unset (&transformed);
15793 * gtk_tree_view_set_tooltip_column:
15794 * @tree_view: a #GtkTreeView
15795 * @column: an integer, which is a valid column number for @tree_view's model
15797 * If you only plan to have simple (text-only) tooltips on full rows, you
15798 * can use this function to have #GtkTreeView handle these automatically
15799 * for you. @column should be set to the column in @tree_view's model
15800 * containing the tooltip texts, or -1 to disable this feature.
15802 * When enabled, #GtkWidget::has-tooltip will be set to %TRUE and
15803 * @tree_view will connect a #GtkWidget::query-tooltip signal handler.
15805 * Note that the signal handler sets the text with gtk_tooltip_set_markup(),
15806 * so &, <, etc have to be escaped in the text.
15811 gtk_tree_view_set_tooltip_column (GtkTreeView *tree_view,
15814 g_return_if_fail (GTK_IS_TREE_VIEW (tree_view));
15816 if (column == tree_view->priv->tooltip_column)
15821 g_signal_handlers_disconnect_by_func (tree_view,
15822 gtk_tree_view_set_tooltip_query_cb,
15824 gtk_widget_set_has_tooltip (GTK_WIDGET (tree_view), FALSE);
15828 if (tree_view->priv->tooltip_column == -1)
15830 g_signal_connect (tree_view, "query-tooltip",
15831 G_CALLBACK (gtk_tree_view_set_tooltip_query_cb), NULL);
15832 gtk_widget_set_has_tooltip (GTK_WIDGET (tree_view), TRUE);
15836 tree_view->priv->tooltip_column = column;
15837 g_object_notify (G_OBJECT (tree_view), "tooltip-column");
15841 * gtk_tree_view_get_tooltip_column:
15842 * @tree_view: a #GtkTreeView
15844 * Returns the column of @tree_view's model which is being used for
15845 * displaying tooltips on @tree_view's rows.
15847 * Return value: the index of the tooltip column that is currently being
15848 * used, or -1 if this is disabled.
15853 gtk_tree_view_get_tooltip_column (GtkTreeView *tree_view)
15855 g_return_val_if_fail (GTK_IS_TREE_VIEW (tree_view), 0);
15857 return tree_view->priv->tooltip_column;