/* gtkiconview.c * Copyright (C) 2002, 2004 Anders Carlsson * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library. If not, see . */ #include "config.h" #include "gtkiconviewprivate.h" #include "gtkadjustmentprivate.h" #include "gtkcellareabox.h" #include "gtkcellareacontext.h" #include "gtkcelllayout.h" #include "gtkcellrenderer.h" #include "gtkcellrendererpixbuf.h" #include "gtkcellrenderertext.h" #include "gtkcssnodeprivate.h" #include "gtkdragsource.h" #include "gtkentry.h" #include "gtkintl.h" #include "gtkmain.h" #include "gtkmarshalers.h" #include "gtkorientable.h" #include "gtkprivate.h" #include "gtkscrollable.h" #include "gtksizerequest.h" #include "gtksnapshot.h" #include "gtkstylecontextprivate.h" #include "gtktreednd.h" #include "gtktypebuiltins.h" #include "gtkwidgetprivate.h" #include "gtkwindow.h" #include "gtkeventcontrollerkey.h" #include "gtkdragsource.h" #include "gtkdragicon.h" #include "gtknative.h" #include /** * SECTION:gtkiconview * @title: GtkIconView * @short_description: A widget which displays a list of icons in a grid * * #GtkIconView provides an alternative view on a #GtkTreeModel. * It displays the model as a grid of icons with labels. Like * #GtkTreeView, it allows to select one or multiple items * (depending on the selection mode, see gtk_icon_view_set_selection_mode()). * In addition to selection with the arrow keys, #GtkIconView supports * rubberband selection, which is controlled by dragging the pointer. * * Note that if the tree model is backed by an actual tree store (as * opposed to a flat list where the mapping to icons is obvious), * #GtkIconView will only display the first level of the tree and * ignore the tree’s branches. * * # CSS nodes * * |[ * iconview.view * ╰── [rubberband] * ]| * * GtkIconView has a single CSS node with name iconview and style class .view. * For rubberband selection, a subnode with name rubberband is used. */ #define SCROLL_EDGE_SIZE 15 typedef struct _GtkIconViewChild GtkIconViewChild; struct _GtkIconViewChild { GtkWidget *widget; GdkRectangle area; }; /* Signals */ enum { ITEM_ACTIVATED, SELECTION_CHANGED, SELECT_ALL, UNSELECT_ALL, SELECT_CURSOR_ITEM, TOGGLE_CURSOR_ITEM, MOVE_CURSOR, ACTIVATE_CURSOR_ITEM, LAST_SIGNAL }; /* Properties */ enum { PROP_0, PROP_PIXBUF_COLUMN, PROP_TEXT_COLUMN, PROP_MARKUP_COLUMN, PROP_SELECTION_MODE, PROP_ITEM_ORIENTATION, PROP_MODEL, PROP_COLUMNS, PROP_ITEM_WIDTH, PROP_SPACING, PROP_ROW_SPACING, PROP_COLUMN_SPACING, PROP_MARGIN, PROP_REORDERABLE, PROP_TOOLTIP_COLUMN, PROP_ITEM_PADDING, PROP_CELL_AREA, PROP_HADJUSTMENT, PROP_VADJUSTMENT, PROP_HSCROLL_POLICY, PROP_VSCROLL_POLICY, PROP_ACTIVATE_ON_SINGLE_CLICK }; /* GObject vfuncs */ static void gtk_icon_view_cell_layout_init (GtkCellLayoutIface *iface); static void gtk_icon_view_dispose (GObject *object); static void gtk_icon_view_constructed (GObject *object); static void gtk_icon_view_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec); static void gtk_icon_view_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec); /* GtkWidget vfuncs */ static GtkSizeRequestMode gtk_icon_view_get_request_mode (GtkWidget *widget); static void gtk_icon_view_measure (GtkWidget *widget, GtkOrientation orientation, int for_size, int *minimum, int *natural, int *minimum_baseline, int *natural_baseline); static void gtk_icon_view_size_allocate (GtkWidget *widget, int width, int height, int baseline); static void gtk_icon_view_snapshot (GtkWidget *widget, GtkSnapshot *snapshot); static void gtk_icon_view_motion (GtkEventController *controller, double x, double y, gpointer user_data); static void gtk_icon_view_leave (GtkEventController *controller, gpointer user_data); static void gtk_icon_view_button_press (GtkGestureClick *gesture, int n_press, double x, double y, gpointer user_data); static void gtk_icon_view_button_release (GtkGestureClick *gesture, int n_press, double x, double y, gpointer user_data); static gboolean gtk_icon_view_key_pressed (GtkEventControllerKey *controller, guint keyval, guint keycode, GdkModifierType state, GtkWidget *widget); static void gtk_icon_view_remove (GtkIconView *icon_view, GtkWidget *widget); /* GtkIconView vfuncs */ static void gtk_icon_view_real_select_all (GtkIconView *icon_view); static void gtk_icon_view_real_unselect_all (GtkIconView *icon_view); static void gtk_icon_view_real_select_cursor_item (GtkIconView *icon_view); static void gtk_icon_view_real_toggle_cursor_item (GtkIconView *icon_view); static gboolean gtk_icon_view_real_activate_cursor_item (GtkIconView *icon_view); /* Internal functions */ static void gtk_icon_view_set_hadjustment_values (GtkIconView *icon_view); static void gtk_icon_view_set_vadjustment_values (GtkIconView *icon_view); static void gtk_icon_view_set_hadjustment (GtkIconView *icon_view, GtkAdjustment *adjustment); static void gtk_icon_view_set_vadjustment (GtkIconView *icon_view, GtkAdjustment *adjustment); static void gtk_icon_view_adjustment_changed (GtkAdjustment *adjustment, GtkIconView *icon_view); static void gtk_icon_view_layout (GtkIconView *icon_view); static void gtk_icon_view_snapshot_item (GtkIconView *icon_view, GtkSnapshot *snapshot, GtkIconViewItem *item, int x, int y, gboolean draw_focus); static void gtk_icon_view_snapshot_rubberband (GtkIconView *icon_view, GtkSnapshot *snapshot); static void gtk_icon_view_queue_draw_path (GtkIconView *icon_view, GtkTreePath *path); static void gtk_icon_view_queue_draw_item (GtkIconView *icon_view, GtkIconViewItem *item); static void gtk_icon_view_start_rubberbanding (GtkIconView *icon_view, GdkDevice *device, int x, int y); static void gtk_icon_view_stop_rubberbanding (GtkIconView *icon_view); static void gtk_icon_view_update_rubberband_selection (GtkIconView *icon_view); static gboolean gtk_icon_view_item_hit_test (GtkIconView *icon_view, GtkIconViewItem *item, int x, int y, int width, int height); static gboolean gtk_icon_view_unselect_all_internal (GtkIconView *icon_view); static void gtk_icon_view_update_rubberband (GtkIconView *icon_view); static void gtk_icon_view_item_invalidate_size (GtkIconViewItem *item); static void gtk_icon_view_invalidate_sizes (GtkIconView *icon_view); static void gtk_icon_view_add_move_binding (GtkWidgetClass *widget_class, guint keyval, guint modmask, GtkMovementStep step, int count); static gboolean gtk_icon_view_real_move_cursor (GtkIconView *icon_view, GtkMovementStep step, int count, gboolean extend, gboolean modify); static void gtk_icon_view_move_cursor_up_down (GtkIconView *icon_view, int count); static void gtk_icon_view_move_cursor_page_up_down (GtkIconView *icon_view, int count); static void gtk_icon_view_move_cursor_left_right (GtkIconView *icon_view, int count); static void gtk_icon_view_move_cursor_start_end (GtkIconView *icon_view, int count); static void gtk_icon_view_scroll_to_item (GtkIconView *icon_view, GtkIconViewItem *item); static gboolean gtk_icon_view_select_all_between (GtkIconView *icon_view, GtkIconViewItem *anchor, GtkIconViewItem *cursor); static void gtk_icon_view_ensure_cell_area (GtkIconView *icon_view, GtkCellArea *cell_area); static GtkCellArea *gtk_icon_view_cell_layout_get_area (GtkCellLayout *layout); static void gtk_icon_view_add_editable (GtkCellArea *area, GtkCellRenderer *renderer, GtkCellEditable *editable, GdkRectangle *cell_area, const char *path, GtkIconView *icon_view); static void gtk_icon_view_remove_editable (GtkCellArea *area, GtkCellRenderer *renderer, GtkCellEditable *editable, GtkIconView *icon_view); static void update_text_cell (GtkIconView *icon_view); static void update_pixbuf_cell (GtkIconView *icon_view); /* Source side drag signals */ static void gtk_icon_view_dnd_finished_cb (GdkDrag *drag, GtkWidget *widget); static GdkContentProvider * gtk_icon_view_drag_data_get (GtkIconView *icon_view, GtkTreePath *source_row); /* Target side drag signals */ static void gtk_icon_view_drag_leave (GtkDropTargetAsync *dest, GdkDrop *drop, GtkIconView *icon_view); static GdkDragAction gtk_icon_view_drag_motion (GtkDropTargetAsync *dest, GdkDrop *drop, double x, double y, GtkIconView *icon_view); static gboolean gtk_icon_view_drag_drop (GtkDropTargetAsync *dest, GdkDrop *drop, double x, double y, GtkIconView *icon_view); static void gtk_icon_view_drag_data_received (GObject *source, GAsyncResult *result, gpointer data); static gboolean gtk_icon_view_maybe_begin_drag (GtkIconView *icon_view, double x, double y, GdkDevice *device); static void remove_scroll_timeout (GtkIconView *icon_view); /* GtkBuildable */ static GtkBuildableIface *parent_buildable_iface; static void gtk_icon_view_buildable_init (GtkBuildableIface *iface); static gboolean gtk_icon_view_buildable_custom_tag_start (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const char *tagname, GtkBuildableParser *parser, gpointer *data); static void gtk_icon_view_buildable_custom_tag_end (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const char *tagname, gpointer data); static guint icon_view_signals[LAST_SIGNAL] = { 0 }; G_DEFINE_TYPE_WITH_CODE (GtkIconView, gtk_icon_view, GTK_TYPE_WIDGET, G_ADD_PRIVATE (GtkIconView) G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT, gtk_icon_view_cell_layout_init) G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE, gtk_icon_view_buildable_init) G_IMPLEMENT_INTERFACE (GTK_TYPE_SCROLLABLE, NULL)) static void gtk_icon_view_class_init (GtkIconViewClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass); gobject_class->constructed = gtk_icon_view_constructed; gobject_class->dispose = gtk_icon_view_dispose; gobject_class->set_property = gtk_icon_view_set_property; gobject_class->get_property = gtk_icon_view_get_property; widget_class->get_request_mode = gtk_icon_view_get_request_mode; widget_class->measure = gtk_icon_view_measure; widget_class->size_allocate = gtk_icon_view_size_allocate; widget_class->snapshot = gtk_icon_view_snapshot; widget_class->focus = gtk_widget_focus_self; widget_class->grab_focus = gtk_widget_grab_focus_self; klass->select_all = gtk_icon_view_real_select_all; klass->unselect_all = gtk_icon_view_real_unselect_all; klass->select_cursor_item = gtk_icon_view_real_select_cursor_item; klass->toggle_cursor_item = gtk_icon_view_real_toggle_cursor_item; klass->activate_cursor_item = gtk_icon_view_real_activate_cursor_item; klass->move_cursor = gtk_icon_view_real_move_cursor; /* Properties */ /** * GtkIconView:selection-mode: * * The ::selection-mode property specifies the selection mode of * icon view. If the mode is #GTK_SELECTION_MULTIPLE, rubberband selection * is enabled, for the other modes, only keyboard selection is possible. */ g_object_class_install_property (gobject_class, PROP_SELECTION_MODE, g_param_spec_enum ("selection-mode", P_("Selection mode"), P_("The selection mode"), GTK_TYPE_SELECTION_MODE, GTK_SELECTION_SINGLE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:pixbuf-column: * * The ::pixbuf-column property contains the number of the model column * containing the pixbufs which are displayed. The pixbuf column must be * of type #GDK_TYPE_PIXBUF. Setting this property to -1 turns off the * display of pixbufs. */ g_object_class_install_property (gobject_class, PROP_PIXBUF_COLUMN, g_param_spec_int ("pixbuf-column", P_("Pixbuf column"), P_("Model column used to retrieve the icon pixbuf from"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:text-column: * * The ::text-column property contains the number of the model column * containing the texts which are displayed. The text column must be * of type #G_TYPE_STRING. If this property and the :markup-column * property are both set to -1, no texts are displayed. */ g_object_class_install_property (gobject_class, PROP_TEXT_COLUMN, g_param_spec_int ("text-column", P_("Text column"), P_("Model column used to retrieve the text from"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:markup-column: * * The ::markup-column property contains the number of the model column * containing markup information to be displayed. The markup column must be * of type #G_TYPE_STRING. If this property and the :text-column property * are both set to column numbers, it overrides the text column. * If both are set to -1, no texts are displayed. */ g_object_class_install_property (gobject_class, PROP_MARKUP_COLUMN, g_param_spec_int ("markup-column", P_("Markup column"), P_("Model column used to retrieve the text if using Pango markup"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_MODEL, g_param_spec_object ("model", P_("Icon View Model"), P_("The model for the icon view"), GTK_TYPE_TREE_MODEL, GTK_PARAM_READWRITE)); /** * GtkIconView:columns: * * The columns property contains the number of the columns in which the * items should be displayed. If it is -1, the number of columns will * be chosen automatically to fill the available area. */ g_object_class_install_property (gobject_class, PROP_COLUMNS, g_param_spec_int ("columns", P_("Number of columns"), P_("Number of columns to display"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:item-width: * * The item-width property specifies the width to use for each item. * If it is set to -1, the icon view will automatically determine a * suitable item size. */ g_object_class_install_property (gobject_class, PROP_ITEM_WIDTH, g_param_spec_int ("item-width", P_("Width for each item"), P_("The width used for each item"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:spacing: * * The spacing property specifies the space which is inserted between * the cells (i.e. the icon and the text) of an item. */ g_object_class_install_property (gobject_class, PROP_SPACING, g_param_spec_int ("spacing", P_("Spacing"), P_("Space which is inserted between cells of an item"), 0, G_MAXINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:row-spacing: * * The row-spacing property specifies the space which is inserted between * the rows of the icon view. */ g_object_class_install_property (gobject_class, PROP_ROW_SPACING, g_param_spec_int ("row-spacing", P_("Row Spacing"), P_("Space which is inserted between grid rows"), 0, G_MAXINT, 6, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:column-spacing: * * The column-spacing property specifies the space which is inserted between * the columns of the icon view. */ g_object_class_install_property (gobject_class, PROP_COLUMN_SPACING, g_param_spec_int ("column-spacing", P_("Column Spacing"), P_("Space which is inserted between grid columns"), 0, G_MAXINT, 6, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:margin: * * The margin property specifies the space which is inserted * at the edges of the icon view. */ g_object_class_install_property (gobject_class, PROP_MARGIN, g_param_spec_int ("margin", P_("Margin"), P_("Space which is inserted at the edges of the icon view"), 0, G_MAXINT, 6, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:item-orientation: * * The item-orientation property specifies how the cells (i.e. the icon and * the text) of the item are positioned relative to each other. */ g_object_class_install_property (gobject_class, PROP_ITEM_ORIENTATION, g_param_spec_enum ("item-orientation", P_("Item Orientation"), P_("How the text and icon of each item are positioned relative to each other"), GTK_TYPE_ORIENTATION, GTK_ORIENTATION_VERTICAL, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:reorderable: * * The reorderable property specifies if the items can be reordered * by DND. */ g_object_class_install_property (gobject_class, PROP_REORDERABLE, g_param_spec_boolean ("reorderable", P_("Reorderable"), P_("View is reorderable"), FALSE, G_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (gobject_class, PROP_TOOLTIP_COLUMN, g_param_spec_int ("tooltip-column", P_("Tooltip Column"), P_("The column in the model containing the tooltip texts for the items"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:item-padding: * * The item-padding property specifies the padding around each * of the icon view's item. */ g_object_class_install_property (gobject_class, PROP_ITEM_PADDING, g_param_spec_int ("item-padding", P_("Item Padding"), P_("Padding around icon view items"), 0, G_MAXINT, 6, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkIconView:cell-area: * * The #GtkCellArea used to layout cell renderers for this view. * * If no area is specified when creating the icon view with gtk_icon_view_new_with_area() * a #GtkCellAreaBox will be used. */ g_object_class_install_property (gobject_class, PROP_CELL_AREA, g_param_spec_object ("cell-area", P_("Cell Area"), P_("The GtkCellArea used to layout cells"), GTK_TYPE_CELL_AREA, GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY)); /** * GtkIconView:activate-on-single-click: * * The activate-on-single-click property specifies whether the "item-activated" signal * will be emitted after a single click. */ g_object_class_install_property (gobject_class, PROP_ACTIVATE_ON_SINGLE_CLICK, g_param_spec_boolean ("activate-on-single-click", P_("Activate on Single Click"), P_("Activate row on a single click"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /* Scrollable interface properties */ g_object_class_override_property (gobject_class, PROP_HADJUSTMENT, "hadjustment"); g_object_class_override_property (gobject_class, PROP_VADJUSTMENT, "vadjustment"); g_object_class_override_property (gobject_class, PROP_HSCROLL_POLICY, "hscroll-policy"); g_object_class_override_property (gobject_class, PROP_VSCROLL_POLICY, "vscroll-policy"); /* Signals */ /** * GtkIconView::item-activated: * @iconview: the object on which the signal is emitted * @path: the #GtkTreePath for the activated item * * The ::item-activated signal is emitted when the method * gtk_icon_view_item_activated() is called, when the user double * clicks an item with the "activate-on-single-click" property set * to %FALSE, or when the user single clicks an item when the * "activate-on-single-click" property set to %TRUE. It is also * emitted when a non-editable item is selected and one of the keys: * Space, Return or Enter is pressed. */ icon_view_signals[ITEM_ACTIVATED] = g_signal_new (I_("item-activated"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GtkIconViewClass, item_activated), NULL, NULL, NULL, G_TYPE_NONE, 1, GTK_TYPE_TREE_PATH); /** * GtkIconView::selection-changed: * @iconview: the object on which the signal is emitted * * The ::selection-changed signal is emitted when the selection * (i.e. the set of selected items) changes. */ icon_view_signals[SELECTION_CHANGED] = g_signal_new (I_("selection-changed"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GtkIconViewClass, selection_changed), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkIconView::select-all: * @iconview: the object on which the signal is emitted * * A [keybinding signal][GtkBindingSignal] * which gets emitted when the user selects all items. * * Applications should not connect to it, but may emit it with * g_signal_emit_by_name() if they need to control selection * programmatically. * * The default binding for this signal is Ctrl-a. */ icon_view_signals[SELECT_ALL] = g_signal_new (I_("select-all"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkIconViewClass, select_all), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkIconView::unselect-all: * @iconview: the object on which the signal is emitted * * A [keybinding signal][GtkBindingSignal] * which gets emitted when the user unselects all items. * * Applications should not connect to it, but may emit it with * g_signal_emit_by_name() if they need to control selection * programmatically. * * The default binding for this signal is Ctrl-Shift-a. */ icon_view_signals[UNSELECT_ALL] = g_signal_new (I_("unselect-all"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkIconViewClass, unselect_all), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkIconView::select-cursor-item: * @iconview: the object on which the signal is emitted * * A [keybinding signal][GtkBindingSignal] * which gets emitted when the user selects the item that is currently * focused. * * Applications should not connect to it, but may emit it with * g_signal_emit_by_name() if they need to control selection * programmatically. * * There is no default binding for this signal. */ icon_view_signals[SELECT_CURSOR_ITEM] = g_signal_new (I_("select-cursor-item"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkIconViewClass, select_cursor_item), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkIconView::toggle-cursor-item: * @iconview: the object on which the signal is emitted * * A [keybinding signal][GtkBindingSignal] * which gets emitted when the user toggles whether the currently * focused item is selected or not. The exact effect of this * depend on the selection mode. * * Applications should not connect to it, but may emit it with * g_signal_emit_by_name() if they need to control selection * programmatically. * * There is no default binding for this signal is Ctrl-Space. */ icon_view_signals[TOGGLE_CURSOR_ITEM] = g_signal_new (I_("toggle-cursor-item"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkIconViewClass, toggle_cursor_item), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkIconView::activate-cursor-item: * @iconview: the object on which the signal is emitted * * A [keybinding signal][GtkBindingSignal] * which gets emitted when the user activates the currently * focused item. * * Applications should not connect to it, but may emit it with * g_signal_emit_by_name() if they need to control activation * programmatically. * * The default bindings for this signal are Space, Return and Enter. */ icon_view_signals[ACTIVATE_CURSOR_ITEM] = g_signal_new (I_("activate-cursor-item"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkIconViewClass, activate_cursor_item), NULL, NULL, _gtk_marshal_BOOLEAN__VOID, G_TYPE_BOOLEAN, 0); g_signal_set_va_marshaller (icon_view_signals[ACTIVATE_CURSOR_ITEM], G_TYPE_FROM_CLASS (klass), _gtk_marshal_BOOLEAN__VOIDv); /** * GtkIconView::move-cursor: * @iconview: the object which received the signal * @step: the granularity of the move, as a #GtkMovementStep * @count: the number of @step units to move * @extend: whether to extend the selection * @modify: whether to modify the selection * * The ::move-cursor signal is a * [keybinding signal][GtkBindingSignal] * which gets emitted when the user initiates a cursor movement. * * Applications should not connect to it, but may emit it with * g_signal_emit_by_name() if they need to control the cursor * programmatically. * * The default bindings for this signal include * - Arrow keys which move by individual steps * - Home/End keys which move to the first/last item * - PageUp/PageDown which move by "pages" * All of these will extend the selection when combined with * the Shift modifier. */ icon_view_signals[MOVE_CURSOR] = g_signal_new (I_("move-cursor"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkIconViewClass, move_cursor), NULL, NULL, _gtk_marshal_BOOLEAN__ENUM_INT_BOOLEAN_BOOLEAN, G_TYPE_BOOLEAN, 4, GTK_TYPE_MOVEMENT_STEP, G_TYPE_INT, G_TYPE_BOOLEAN, G_TYPE_BOOLEAN); g_signal_set_va_marshaller (icon_view_signals[MOVE_CURSOR], G_TYPE_FROM_CLASS (klass), _gtk_marshal_BOOLEAN__ENUM_INT_BOOLEAN_BOOLEANv); /* Key bindings */ gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_a, GDK_CONTROL_MASK, "select-all", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_a, GDK_CONTROL_MASK | GDK_SHIFT_MASK, "unselect-all", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_space, GDK_CONTROL_MASK, "toggle-cursor-item", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Space, GDK_CONTROL_MASK, "toggle-cursor-item", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_space, 0, "activate-cursor-item", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Space, 0, "activate-cursor-item", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_Return, 0, "activate-cursor-item", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_ISO_Enter, 0, "activate-cursor-item", NULL); gtk_widget_class_add_binding_signal (widget_class, GDK_KEY_KP_Enter, 0, "activate-cursor-item", NULL); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_Up, 0, GTK_MOVEMENT_DISPLAY_LINES, -1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_KP_Up, 0, GTK_MOVEMENT_DISPLAY_LINES, -1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_Down, 0, GTK_MOVEMENT_DISPLAY_LINES, 1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_KP_Down, 0, GTK_MOVEMENT_DISPLAY_LINES, 1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_p, GDK_CONTROL_MASK, GTK_MOVEMENT_DISPLAY_LINES, -1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_n, GDK_CONTROL_MASK, GTK_MOVEMENT_DISPLAY_LINES, 1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_Home, 0, GTK_MOVEMENT_BUFFER_ENDS, -1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_KP_Home, 0, GTK_MOVEMENT_BUFFER_ENDS, -1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_End, 0, GTK_MOVEMENT_BUFFER_ENDS, 1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_KP_End, 0, GTK_MOVEMENT_BUFFER_ENDS, 1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_Page_Up, 0, GTK_MOVEMENT_PAGES, -1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_KP_Page_Up, 0, GTK_MOVEMENT_PAGES, -1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_Page_Down, 0, GTK_MOVEMENT_PAGES, 1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_KP_Page_Down, 0, GTK_MOVEMENT_PAGES, 1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_Right, 0, GTK_MOVEMENT_VISUAL_POSITIONS, 1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_Left, 0, GTK_MOVEMENT_VISUAL_POSITIONS, -1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_KP_Right, 0, GTK_MOVEMENT_VISUAL_POSITIONS, 1); gtk_icon_view_add_move_binding (widget_class, GDK_KEY_KP_Left, 0, GTK_MOVEMENT_VISUAL_POSITIONS, -1); gtk_widget_class_set_css_name (widget_class, I_("iconview")); } static void gtk_icon_view_buildable_add_child (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const char *type) { if (GTK_IS_CELL_RENDERER (child)) _gtk_cell_layout_buildable_add_child (buildable, builder, child, type); else parent_buildable_iface->add_child (buildable, builder, child, type); } static void gtk_icon_view_buildable_init (GtkBuildableIface *iface) { parent_buildable_iface = g_type_interface_peek_parent (iface); iface->add_child = gtk_icon_view_buildable_add_child; iface->custom_tag_start = gtk_icon_view_buildable_custom_tag_start; iface->custom_tag_end = gtk_icon_view_buildable_custom_tag_end; } static void gtk_icon_view_cell_layout_init (GtkCellLayoutIface *iface) { iface->get_area = gtk_icon_view_cell_layout_get_area; } static void gtk_icon_view_init (GtkIconView *icon_view) { GtkEventController *controller; GtkGesture *gesture; icon_view->priv = gtk_icon_view_get_instance_private (icon_view); icon_view->priv->width = 0; icon_view->priv->height = 0; icon_view->priv->selection_mode = GTK_SELECTION_SINGLE; icon_view->priv->pressed_button = -1; icon_view->priv->press_start_x = -1; icon_view->priv->press_start_y = -1; icon_view->priv->text_column = -1; icon_view->priv->markup_column = -1; icon_view->priv->pixbuf_column = -1; icon_view->priv->text_cell = NULL; icon_view->priv->pixbuf_cell = NULL; icon_view->priv->tooltip_column = -1; icon_view->priv->mouse_x = -1; icon_view->priv->mouse_y = -1; gtk_widget_set_overflow (GTK_WIDGET (icon_view), GTK_OVERFLOW_HIDDEN); gtk_widget_set_focusable (GTK_WIDGET (icon_view), TRUE); icon_view->priv->item_orientation = GTK_ORIENTATION_VERTICAL; icon_view->priv->columns = -1; icon_view->priv->item_width = -1; icon_view->priv->spacing = 0; icon_view->priv->row_spacing = 6; icon_view->priv->column_spacing = 6; icon_view->priv->margin = 6; icon_view->priv->item_padding = 6; icon_view->priv->activate_on_single_click = FALSE; icon_view->priv->draw_focus = TRUE; icon_view->priv->row_contexts = g_ptr_array_new_with_free_func ((GDestroyNotify)g_object_unref); gtk_widget_add_css_class (GTK_WIDGET (icon_view), GTK_STYLE_CLASS_VIEW); gesture = gtk_gesture_click_new (); g_signal_connect (gesture, "pressed", G_CALLBACK (gtk_icon_view_button_press), icon_view); g_signal_connect (gesture, "released", G_CALLBACK (gtk_icon_view_button_release), icon_view); gtk_widget_add_controller (GTK_WIDGET (icon_view), GTK_EVENT_CONTROLLER (gesture)); controller = gtk_event_controller_motion_new (); g_signal_connect (controller, "leave", G_CALLBACK (gtk_icon_view_leave), icon_view); g_signal_connect (controller, "motion", G_CALLBACK (gtk_icon_view_motion), icon_view); gtk_widget_add_controller (GTK_WIDGET (icon_view), controller); controller = gtk_event_controller_key_new (); g_signal_connect (controller, "key-pressed", G_CALLBACK (gtk_icon_view_key_pressed), icon_view); gtk_widget_add_controller (GTK_WIDGET (icon_view), controller); } /* GObject methods */ static void gtk_icon_view_constructed (GObject *object) { GtkIconView *icon_view = GTK_ICON_VIEW (object); G_OBJECT_CLASS (gtk_icon_view_parent_class)->constructed (object); gtk_icon_view_ensure_cell_area (icon_view, NULL); } static void gtk_icon_view_dispose (GObject *object) { GtkIconView *icon_view; GtkIconViewPrivate *priv; icon_view = GTK_ICON_VIEW (object); priv = icon_view->priv; gtk_icon_view_set_model (icon_view, NULL); if (icon_view->priv->scroll_to_path != NULL) { gtk_tree_row_reference_free (icon_view->priv->scroll_to_path); icon_view->priv->scroll_to_path = NULL; } remove_scroll_timeout (icon_view); if (icon_view->priv->hadjustment != NULL) { g_object_unref (icon_view->priv->hadjustment); icon_view->priv->hadjustment = NULL; } if (icon_view->priv->vadjustment != NULL) { g_object_unref (icon_view->priv->vadjustment); icon_view->priv->vadjustment = NULL; } if (priv->cell_area_context) { g_object_unref (priv->cell_area_context); priv->cell_area_context = NULL; } if (priv->row_contexts) { g_ptr_array_free (priv->row_contexts, TRUE); priv->row_contexts = NULL; } if (priv->cell_area) { gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); g_signal_handler_disconnect (priv->cell_area, priv->add_editable_id); g_signal_handler_disconnect (priv->cell_area, priv->remove_editable_id); priv->add_editable_id = 0; priv->remove_editable_id = 0; g_object_unref (priv->cell_area); priv->cell_area = NULL; } g_clear_object (&priv->key_controller); g_clear_pointer (&priv->source_formats, gdk_content_formats_unref); G_OBJECT_CLASS (gtk_icon_view_parent_class)->dispose (object); } static void gtk_icon_view_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkIconView *icon_view; GtkCellArea *area; icon_view = GTK_ICON_VIEW (object); switch (prop_id) { case PROP_SELECTION_MODE: gtk_icon_view_set_selection_mode (icon_view, g_value_get_enum (value)); break; case PROP_PIXBUF_COLUMN: gtk_icon_view_set_pixbuf_column (icon_view, g_value_get_int (value)); break; case PROP_TEXT_COLUMN: gtk_icon_view_set_text_column (icon_view, g_value_get_int (value)); break; case PROP_MARKUP_COLUMN: gtk_icon_view_set_markup_column (icon_view, g_value_get_int (value)); break; case PROP_MODEL: gtk_icon_view_set_model (icon_view, g_value_get_object (value)); break; case PROP_ITEM_ORIENTATION: gtk_icon_view_set_item_orientation (icon_view, g_value_get_enum (value)); break; case PROP_COLUMNS: gtk_icon_view_set_columns (icon_view, g_value_get_int (value)); break; case PROP_ITEM_WIDTH: gtk_icon_view_set_item_width (icon_view, g_value_get_int (value)); break; case PROP_SPACING: gtk_icon_view_set_spacing (icon_view, g_value_get_int (value)); break; case PROP_ROW_SPACING: gtk_icon_view_set_row_spacing (icon_view, g_value_get_int (value)); break; case PROP_COLUMN_SPACING: gtk_icon_view_set_column_spacing (icon_view, g_value_get_int (value)); break; case PROP_MARGIN: gtk_icon_view_set_margin (icon_view, g_value_get_int (value)); break; case PROP_REORDERABLE: gtk_icon_view_set_reorderable (icon_view, g_value_get_boolean (value)); break; case PROP_TOOLTIP_COLUMN: gtk_icon_view_set_tooltip_column (icon_view, g_value_get_int (value)); break; case PROP_ITEM_PADDING: gtk_icon_view_set_item_padding (icon_view, g_value_get_int (value)); break; case PROP_ACTIVATE_ON_SINGLE_CLICK: gtk_icon_view_set_activate_on_single_click (icon_view, g_value_get_boolean (value)); break; case PROP_CELL_AREA: /* Construct-only, can only be assigned once */ area = g_value_get_object (value); if (area) { if (icon_view->priv->cell_area != NULL) { g_warning ("cell-area has already been set, ignoring construct property"); g_object_ref_sink (area); g_object_unref (area); } else gtk_icon_view_ensure_cell_area (icon_view, area); } break; case PROP_HADJUSTMENT: gtk_icon_view_set_hadjustment (icon_view, g_value_get_object (value)); break; case PROP_VADJUSTMENT: gtk_icon_view_set_vadjustment (icon_view, g_value_get_object (value)); break; case PROP_HSCROLL_POLICY: if (icon_view->priv->hscroll_policy != g_value_get_enum (value)) { icon_view->priv->hscroll_policy = g_value_get_enum (value); gtk_widget_queue_resize (GTK_WIDGET (icon_view)); g_object_notify_by_pspec (object, pspec); } break; case PROP_VSCROLL_POLICY: if (icon_view->priv->vscroll_policy != g_value_get_enum (value)) { icon_view->priv->vscroll_policy = g_value_get_enum (value); gtk_widget_queue_resize (GTK_WIDGET (icon_view)); g_object_notify_by_pspec (object, pspec); } break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_icon_view_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { GtkIconView *icon_view; icon_view = GTK_ICON_VIEW (object); switch (prop_id) { case PROP_SELECTION_MODE: g_value_set_enum (value, icon_view->priv->selection_mode); break; case PROP_PIXBUF_COLUMN: g_value_set_int (value, icon_view->priv->pixbuf_column); break; case PROP_TEXT_COLUMN: g_value_set_int (value, icon_view->priv->text_column); break; case PROP_MARKUP_COLUMN: g_value_set_int (value, icon_view->priv->markup_column); break; case PROP_MODEL: g_value_set_object (value, icon_view->priv->model); break; case PROP_ITEM_ORIENTATION: g_value_set_enum (value, icon_view->priv->item_orientation); break; case PROP_COLUMNS: g_value_set_int (value, icon_view->priv->columns); break; case PROP_ITEM_WIDTH: g_value_set_int (value, icon_view->priv->item_width); break; case PROP_SPACING: g_value_set_int (value, icon_view->priv->spacing); break; case PROP_ROW_SPACING: g_value_set_int (value, icon_view->priv->row_spacing); break; case PROP_COLUMN_SPACING: g_value_set_int (value, icon_view->priv->column_spacing); break; case PROP_MARGIN: g_value_set_int (value, icon_view->priv->margin); break; case PROP_REORDERABLE: g_value_set_boolean (value, icon_view->priv->reorderable); break; case PROP_TOOLTIP_COLUMN: g_value_set_int (value, icon_view->priv->tooltip_column); break; case PROP_ITEM_PADDING: g_value_set_int (value, icon_view->priv->item_padding); break; case PROP_ACTIVATE_ON_SINGLE_CLICK: g_value_set_boolean (value, icon_view->priv->activate_on_single_click); break; case PROP_CELL_AREA: g_value_set_object (value, icon_view->priv->cell_area); break; case PROP_HADJUSTMENT: g_value_set_object (value, icon_view->priv->hadjustment); break; case PROP_VADJUSTMENT: g_value_set_object (value, icon_view->priv->vadjustment); break; case PROP_HSCROLL_POLICY: g_value_set_enum (value, icon_view->priv->hscroll_policy); break; case PROP_VSCROLL_POLICY: g_value_set_enum (value, icon_view->priv->vscroll_policy); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } /* GtkWidget methods */ static int gtk_icon_view_get_n_items (GtkIconView *icon_view) { GtkIconViewPrivate *priv = icon_view->priv; if (priv->model == NULL) return 0; return gtk_tree_model_iter_n_children (priv->model, NULL); } static void adjust_wrap_width (GtkIconView *icon_view) { if (icon_view->priv->text_cell) { int pixbuf_width, wrap_width; if (icon_view->priv->items && icon_view->priv->pixbuf_cell) { gtk_cell_renderer_get_preferred_width (icon_view->priv->pixbuf_cell, GTK_WIDGET (icon_view), &pixbuf_width, NULL); } else { pixbuf_width = 0; } if (icon_view->priv->item_width >= 0) { if (icon_view->priv->item_orientation == GTK_ORIENTATION_VERTICAL) { wrap_width = icon_view->priv->item_width; } else { wrap_width = icon_view->priv->item_width - pixbuf_width; } wrap_width -= 2 * icon_view->priv->item_padding * 2; } else { wrap_width = MAX (pixbuf_width * 2, 50); } if (icon_view->priv->items && icon_view->priv->pixbuf_cell) { /* Here we go with the same old guess, try the icon size and set double * the size of the first icon found in the list, naive but works much * of the time */ wrap_width = MAX (wrap_width * 2, 50); } g_object_set (icon_view->priv->text_cell, "wrap-width", wrap_width, NULL); g_object_set (icon_view->priv->text_cell, "width", wrap_width, NULL); } } /* General notes about layout * * The icon view is layouted like this: * * +----------+ s +----------+ * | padding | p | padding | * | +------+ | a | +------+ | * | | cell | | c | | cell | | * | +------+ | i | +------+ | * | | n | | * +----------+ g +----------+ * * In size request and allocation code, there are 3 sizes that are used: * * cell size * This is the size returned by gtk_cell_area_get_preferred_foo(). In places * where code is interacting with the cell area and renderers this is useful. * * padded size * This is the cell size plus the item padding on each side. * * spaced size * This is the padded size plus the spacing. This is what’s used for most * calculations because it can (ab)use the following formula: * iconview_size = 2 * margin + n_items * spaced_size - spacing * So when reading this code and fixing my bugs where I confuse these two, be * aware of this distinction. */ static void cell_area_get_preferred_size (GtkIconView *icon_view, GtkCellAreaContext *context, GtkOrientation orientation, int for_size, int *minimum, int *natural) { if (orientation == GTK_ORIENTATION_HORIZONTAL) { if (for_size > 0) gtk_cell_area_get_preferred_width_for_height (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), for_size, minimum, natural); else gtk_cell_area_get_preferred_width (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), minimum, natural); } else { if (for_size > 0) gtk_cell_area_get_preferred_height_for_width (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), for_size, minimum, natural); else gtk_cell_area_get_preferred_height (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), minimum, natural); } } static gboolean gtk_icon_view_is_empty (GtkIconView *icon_view) { return icon_view->priv->items == NULL; } static void gtk_icon_view_get_preferred_item_size (GtkIconView *icon_view, GtkOrientation orientation, int for_size, int *minimum, int *natural) { GtkIconViewPrivate *priv = icon_view->priv; GtkCellAreaContext *context; GList *items; g_assert (!gtk_icon_view_is_empty (icon_view)); context = gtk_cell_area_create_context (priv->cell_area); for_size -= 2 * priv->item_padding; if (for_size > 0) { /* This is necessary for the context to work properly */ for (items = priv->items; items; items = items->next) { GtkIconViewItem *item = items->data; _gtk_icon_view_set_cell_data (icon_view, item); cell_area_get_preferred_size (icon_view, context, 1 - orientation, -1, NULL, NULL); } } for (items = priv->items; items; items = items->next) { GtkIconViewItem *item = items->data; _gtk_icon_view_set_cell_data (icon_view, item); if (items == priv->items) adjust_wrap_width (icon_view); cell_area_get_preferred_size (icon_view, context, orientation, for_size, NULL, NULL); } if (orientation == GTK_ORIENTATION_HORIZONTAL) { if (for_size > 0) gtk_cell_area_context_get_preferred_width_for_height (context, for_size, minimum, natural); else gtk_cell_area_context_get_preferred_width (context, minimum, natural); } else { if (for_size > 0) gtk_cell_area_context_get_preferred_height_for_width (context, for_size, minimum, natural); else gtk_cell_area_context_get_preferred_height (context, minimum, natural); } if (orientation == GTK_ORIENTATION_HORIZONTAL && priv->item_width >= 0) { if (minimum) *minimum = MAX (*minimum, priv->item_width); if (natural) *natural = *minimum; } if (minimum) *minimum = MAX (1, *minimum + 2 * priv->item_padding); if (natural) *natural = MAX (1, *natural + 2 * priv->item_padding); g_object_unref (context); } static void gtk_icon_view_compute_n_items_for_size (GtkIconView *icon_view, GtkOrientation orientation, int size, int *min_items, int *min_item_size, int *max_items, int *max_item_size) { GtkIconViewPrivate *priv = icon_view->priv; int minimum, natural, spacing; g_return_if_fail (min_item_size == NULL || min_items != NULL); g_return_if_fail (max_item_size == NULL || max_items != NULL); g_return_if_fail (!gtk_icon_view_is_empty (icon_view)); gtk_icon_view_get_preferred_item_size (icon_view, orientation, -1, &minimum, &natural); if (orientation == GTK_ORIENTATION_HORIZONTAL) spacing = priv->column_spacing; else spacing = priv->row_spacing; size -= 2 * priv->margin; size += spacing; minimum += spacing; natural += spacing; if (priv->columns > 0) { if (orientation == GTK_ORIENTATION_HORIZONTAL) { if (min_items) *min_items = priv->columns; if (max_items) *max_items = priv->columns; } else { int n_items = gtk_icon_view_get_n_items (icon_view); if (min_items) *min_items = (n_items + priv->columns - 1) / priv->columns; if (max_items) *max_items = (n_items + priv->columns - 1) / priv->columns; } } else { if (max_items) { if (size <= minimum) *max_items = 1; else *max_items = size / minimum; } if (min_items) { if (size <= natural) *min_items = 1; else *min_items = size / natural; } } if (min_item_size) { *min_item_size = size / *min_items; *min_item_size = CLAMP (*min_item_size, minimum, natural); *min_item_size -= spacing; *min_item_size -= 2 * priv->item_padding; } if (max_item_size) { *max_item_size = size / *max_items; *max_item_size = CLAMP (*max_item_size, minimum, natural); *max_item_size -= spacing; *max_item_size -= 2 * priv->item_padding; } } static GtkSizeRequestMode gtk_icon_view_get_request_mode (GtkWidget *widget) { return GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH; } static void gtk_icon_view_measure (GtkWidget *widget, GtkOrientation orientation, int for_size, int *minimum, int *natural, int *minimum_baseline, int *natural_baseline) { GtkIconView *icon_view = GTK_ICON_VIEW (widget); GtkIconViewPrivate *priv = icon_view->priv; GtkOrientation other_orientation = orientation == GTK_ORIENTATION_HORIZONTAL ? GTK_ORIENTATION_VERTICAL : GTK_ORIENTATION_HORIZONTAL; int item_min, item_nat, items = 0, item_size = 0, n_items; if (gtk_icon_view_is_empty (icon_view)) { *minimum = *natural = 2 * priv->margin; return; } n_items = gtk_icon_view_get_n_items (icon_view); if (for_size < 0) { gtk_icon_view_get_preferred_item_size (icon_view, orientation, -1, &item_min, &item_nat); if (priv->columns > 0) { int n_rows = (n_items + priv->columns - 1) / priv->columns; *minimum = item_min * n_rows + priv->row_spacing * (n_rows - 1); *natural = item_nat * n_rows + priv->row_spacing * (n_rows - 1); } else { *minimum = item_min; *natural = item_nat * n_items + priv->row_spacing * (n_items - 1); } } else { gtk_icon_view_compute_n_items_for_size (icon_view, orientation, for_size, NULL, NULL, &items, &item_size); gtk_icon_view_get_preferred_item_size (icon_view, other_orientation, item_size, &item_min, &item_nat); *minimum = (item_min + priv->row_spacing) * ((n_items + items - 1) / items) - priv->row_spacing; *natural = (item_nat + priv->row_spacing) * ((n_items + items - 1) / items) - priv->row_spacing; } *minimum += 2 * priv->margin; *natural += 2 * priv->margin; } static void gtk_icon_view_allocate_children (GtkIconView *icon_view) { GList *list; for (list = icon_view->priv->children; list; list = list->next) { GtkIconViewChild *child = list->data; /* totally ignore our child's requisition */ gtk_widget_size_allocate (child->widget, &child->area, -1); } } static void gtk_icon_view_size_allocate (GtkWidget *widget, int width, int height, int baseline) { GtkIconView *icon_view = GTK_ICON_VIEW (widget); gtk_icon_view_layout (icon_view); gtk_icon_view_allocate_children (icon_view); /* Delay signal emission */ g_object_freeze_notify (G_OBJECT (icon_view->priv->hadjustment)); g_object_freeze_notify (G_OBJECT (icon_view->priv->vadjustment)); gtk_icon_view_set_hadjustment_values (icon_view); gtk_icon_view_set_vadjustment_values (icon_view); if (gtk_widget_get_realized (widget) && icon_view->priv->scroll_to_path) { GtkTreePath *path; path = gtk_tree_row_reference_get_path (icon_view->priv->scroll_to_path); gtk_tree_row_reference_free (icon_view->priv->scroll_to_path); icon_view->priv->scroll_to_path = NULL; gtk_icon_view_scroll_to_path (icon_view, path, icon_view->priv->scroll_to_use_align, icon_view->priv->scroll_to_row_align, icon_view->priv->scroll_to_col_align); gtk_tree_path_free (path); } /* Emit any pending signals now */ g_object_thaw_notify (G_OBJECT (icon_view->priv->hadjustment)); g_object_thaw_notify (G_OBJECT (icon_view->priv->vadjustment)); } static void gtk_icon_view_snapshot (GtkWidget *widget, GtkSnapshot *snapshot) { GtkIconView *icon_view; GList *icons; GtkTreePath *path; int dest_index; GtkIconViewDropPosition dest_pos; GtkIconViewItem *dest_item = NULL; GtkStyleContext *context; int width, height; double offset_x, offset_y; icon_view = GTK_ICON_VIEW (widget); context = gtk_widget_get_style_context (widget); width = gtk_widget_get_width (widget); height = gtk_widget_get_height (widget); offset_x = gtk_adjustment_get_value (icon_view->priv->hadjustment); offset_y = gtk_adjustment_get_value (icon_view->priv->vadjustment); gtk_snapshot_save (snapshot); gtk_snapshot_translate (snapshot, &GRAPHENE_POINT_INIT (- offset_x, - offset_y)); gtk_icon_view_get_drag_dest_item (icon_view, &path, &dest_pos); if (path) { dest_index = gtk_tree_path_get_indices (path)[0]; gtk_tree_path_free (path); } else dest_index = -1; for (icons = icon_view->priv->items; icons; icons = icons->next) { GtkIconViewItem *item = icons->data; graphene_rect_t area; graphene_rect_init (&area, item->cell_area.x - icon_view->priv->item_padding, item->cell_area.y - icon_view->priv->item_padding, item->cell_area.width + icon_view->priv->item_padding * 2, item->cell_area.height + icon_view->priv->item_padding * 2); if (gdk_rectangle_intersect (&item->cell_area, &(GdkRectangle) { offset_x, offset_y, width, height }, NULL)) { gtk_icon_view_snapshot_item (icon_view, snapshot, item, item->cell_area.x, item->cell_area.y, icon_view->priv->draw_focus); if (dest_index == item->index) dest_item = item; } } if (dest_item && dest_pos != GTK_ICON_VIEW_NO_DROP) { GdkRectangle rect = { 0 }; switch (dest_pos) { case GTK_ICON_VIEW_DROP_INTO: rect = dest_item->cell_area; break; case GTK_ICON_VIEW_DROP_ABOVE: rect.x = dest_item->cell_area.x; rect.y = dest_item->cell_area.y - 1; rect.width = dest_item->cell_area.width; rect.height = 2; break; case GTK_ICON_VIEW_DROP_LEFT: rect.x = dest_item->cell_area.x - 1; rect.y = dest_item->cell_area.y; rect.width = 2; rect.height = dest_item->cell_area.height; break; case GTK_ICON_VIEW_DROP_BELOW: rect.x = dest_item->cell_area.x; rect.y = dest_item->cell_area.y + dest_item->cell_area.height - 1; rect.width = dest_item->cell_area.width; rect.height = 2; break; case GTK_ICON_VIEW_DROP_RIGHT: rect.x = dest_item->cell_area.x + dest_item->cell_area.width - 1; rect.y = dest_item->cell_area.y; rect.width = 2; rect.height = dest_item->cell_area.height; break; case GTK_ICON_VIEW_NO_DROP: default: break; } gtk_style_context_save_to_node (context, icon_view->priv->dndnode); gtk_style_context_set_state (context, gtk_style_context_get_state (context) | GTK_STATE_FLAG_DROP_ACTIVE); gtk_snapshot_render_frame (snapshot, context, rect.x, rect.y, rect.width, rect.height); gtk_style_context_restore (context); } if (icon_view->priv->doing_rubberband) gtk_icon_view_snapshot_rubberband (icon_view, snapshot); gtk_snapshot_restore (snapshot); GTK_WIDGET_CLASS (gtk_icon_view_parent_class)->snapshot (widget, snapshot); } static gboolean rubberband_scroll_timeout (gpointer data) { GtkIconView *icon_view = data; gtk_adjustment_set_value (icon_view->priv->vadjustment, gtk_adjustment_get_value (icon_view->priv->vadjustment) + icon_view->priv->scroll_value_diff); gtk_icon_view_update_rubberband (icon_view); return TRUE; } static GtkIconViewItem * _gtk_icon_view_get_item_at_widget_coords (GtkIconView *icon_view, int x, int y, gboolean only_in_cell, GtkCellRenderer **cell_at_pos) { x += gtk_adjustment_get_value (icon_view->priv->hadjustment); y += gtk_adjustment_get_value (icon_view->priv->vadjustment); return _gtk_icon_view_get_item_at_coords (icon_view, x, y, only_in_cell, cell_at_pos); } static void gtk_icon_view_motion (GtkEventController *controller, double x, double y, gpointer user_data) { GtkIconView *icon_view; int abs_y; GdkDevice *device; icon_view = GTK_ICON_VIEW (user_data); icon_view->priv->mouse_x = x; icon_view->priv->mouse_y = y; device = gtk_event_controller_get_current_event_device (controller); gtk_icon_view_maybe_begin_drag (icon_view, x, y, device); if (icon_view->priv->doing_rubberband) { int height; gtk_icon_view_update_rubberband (icon_view); abs_y = icon_view->priv->mouse_y - icon_view->priv->height * (gtk_adjustment_get_value (icon_view->priv->vadjustment) / (gtk_adjustment_get_upper (icon_view->priv->vadjustment) - gtk_adjustment_get_lower (icon_view->priv->vadjustment))); height = gtk_widget_get_height (GTK_WIDGET (icon_view)); if (abs_y < 0 || abs_y > height) { if (abs_y < 0) icon_view->priv->scroll_value_diff = abs_y; else icon_view->priv->scroll_value_diff = abs_y - height; icon_view->priv->event_last_x = icon_view->priv->mouse_x; icon_view->priv->event_last_y = icon_view->priv->mouse_x; if (icon_view->priv->scroll_timeout_id == 0) { icon_view->priv->scroll_timeout_id = g_timeout_add (30, rubberband_scroll_timeout, icon_view); g_source_set_name_by_id (icon_view->priv->scroll_timeout_id, "[gtk] rubberband_scroll_timeout"); } } else remove_scroll_timeout (icon_view); } else { GtkIconViewItem *item, *last_prelight_item; GtkCellRenderer *cell = NULL; last_prelight_item = icon_view->priv->last_prelight; item = _gtk_icon_view_get_item_at_widget_coords (icon_view, icon_view->priv->mouse_x, icon_view->priv->mouse_y, FALSE, &cell); if (item != last_prelight_item) { if (item != NULL) { gtk_icon_view_queue_draw_item (icon_view, item); } if (last_prelight_item != NULL) { gtk_icon_view_queue_draw_item (icon_view, icon_view->priv->last_prelight); } icon_view->priv->last_prelight = item; } } } static void gtk_icon_view_leave (GtkEventController *controller, gpointer user_data) { GtkIconView *icon_view; GtkIconViewPrivate *priv; icon_view = GTK_ICON_VIEW (user_data); priv = icon_view->priv; if (priv->last_prelight) { gtk_icon_view_queue_draw_item (icon_view, priv->last_prelight); priv->last_prelight = NULL; } } static void gtk_icon_view_remove (GtkIconView *icon_view, GtkWidget *widget) { GtkIconViewChild *child = NULL; GList *tmp_list; tmp_list = icon_view->priv->children; while (tmp_list) { child = tmp_list->data; if (child->widget == widget) { gtk_widget_unparent (widget); icon_view->priv->children = g_list_remove_link (icon_view->priv->children, tmp_list); g_list_free_1 (tmp_list); g_free (child); return; } tmp_list = tmp_list->next; } } static void gtk_icon_view_add_editable (GtkCellArea *area, GtkCellRenderer *renderer, GtkCellEditable *editable, GdkRectangle *cell_area, const char *path, GtkIconView *icon_view) { GtkIconViewChild *child; GtkWidget *widget = GTK_WIDGET (editable); child = g_new (GtkIconViewChild, 1); child->widget = widget; child->area.x = cell_area->x; child->area.y = cell_area->y; child->area.width = cell_area->width; child->area.height = cell_area->height; icon_view->priv->children = g_list_append (icon_view->priv->children, child); gtk_widget_set_parent (widget, GTK_WIDGET (icon_view)); } static void gtk_icon_view_remove_editable (GtkCellArea *area, GtkCellRenderer *renderer, GtkCellEditable *editable, GtkIconView *icon_view) { GtkTreePath *path; if (gtk_widget_has_focus (GTK_WIDGET (editable))) gtk_widget_grab_focus (GTK_WIDGET (icon_view)); gtk_icon_view_remove (icon_view, GTK_WIDGET (editable)); path = gtk_tree_path_new_from_string (gtk_cell_area_get_current_path_string (area)); gtk_icon_view_queue_draw_path (icon_view, path); gtk_tree_path_free (path); } /** * gtk_icon_view_set_cursor: * @icon_view: A #GtkIconView * @path: A #GtkTreePath * @cell: (allow-none): One of the cell renderers of @icon_view, or %NULL * @start_editing: %TRUE if the specified cell should start being edited. * * Sets the current keyboard focus to be at @path, and selects it. This is * useful when you want to focus the user’s attention on a particular item. * If @cell is not %NULL, then focus is given to the cell specified by * it. Additionally, if @start_editing is %TRUE, then editing should be * started in the specified cell. * * This function is often followed by `gtk_widget_grab_focus * (icon_view)` in order to give keyboard focus to the widget. * Please note that editing can only happen when the widget is realized. **/ void gtk_icon_view_set_cursor (GtkIconView *icon_view, GtkTreePath *path, GtkCellRenderer *cell, gboolean start_editing) { GtkIconViewItem *item = NULL; g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (path != NULL); g_return_if_fail (cell == NULL || GTK_IS_CELL_RENDERER (cell)); if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); if (gtk_tree_path_get_depth (path) == 1) item = g_list_nth_data (icon_view->priv->items, gtk_tree_path_get_indices(path)[0]); if (!item) return; _gtk_icon_view_set_cursor_item (icon_view, item, cell); gtk_icon_view_scroll_to_path (icon_view, path, FALSE, 0.0, 0.0); if (start_editing && icon_view->priv->cell_area) { GtkCellAreaContext *context; context = g_ptr_array_index (icon_view->priv->row_contexts, item->row); _gtk_icon_view_set_cell_data (icon_view, item); gtk_cell_area_activate (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), &item->cell_area, 0 /* XXX flags */, TRUE); } } /** * gtk_icon_view_get_cursor: * @icon_view: A #GtkIconView * @path: (out) (allow-none) (transfer full): Return location for the current * cursor path, or %NULL * @cell: (out) (allow-none) (transfer none): Return location the current * focus cell, or %NULL * * Fills in @path and @cell with the current cursor path and cell. * If the cursor isn’t currently set, then *@path will be %NULL. * If no cell currently has focus, then *@cell will be %NULL. * * The returned #GtkTreePath must be freed with gtk_tree_path_free(). * * Returns: %TRUE if the cursor is set. **/ gboolean gtk_icon_view_get_cursor (GtkIconView *icon_view, GtkTreePath **path, GtkCellRenderer **cell) { GtkIconViewItem *item; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE); item = icon_view->priv->cursor_item; if (path != NULL) { if (item != NULL) *path = gtk_tree_path_new_from_indices (item->index, -1); else *path = NULL; } if (cell != NULL && item != NULL && icon_view->priv->cell_area != NULL) *cell = gtk_cell_area_get_focus_cell (icon_view->priv->cell_area); return (item != NULL); } static void gtk_icon_view_button_press (GtkGestureClick *gesture, int n_press, double x, double y, gpointer user_data) { GtkIconView *icon_view = user_data; GtkWidget *widget = GTK_WIDGET (icon_view); GtkIconViewItem *item; gboolean dirty = FALSE; GtkCellRenderer *cell = NULL, *cursor_cell = NULL; int button = gtk_gesture_single_get_current_button (GTK_GESTURE_SINGLE (gesture)); GdkEventSequence *sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); GdkEvent *event = gtk_gesture_get_last_event (GTK_GESTURE (gesture), sequence); GdkModifierType state; if (!gtk_widget_has_focus (widget)) gtk_widget_grab_focus (widget); if (button == GDK_BUTTON_PRIMARY) { GdkModifierType extend_mod_mask = GDK_SHIFT_MASK; GdkModifierType modify_mod_mask = GDK_CONTROL_MASK; state = gdk_event_get_modifier_state (event); item = _gtk_icon_view_get_item_at_widget_coords (icon_view, x, y, FALSE, &cell); /* * We consider only the cells' area as the item area if the * item is not selected, but if it *is* selected, the complete * selection rectangle is considered to be part of the item. */ if (item != NULL && (cell != NULL || item->selected)) { if (cell != NULL) { if (gtk_cell_renderer_is_activatable (cell)) cursor_cell = cell; } gtk_icon_view_scroll_to_item (icon_view, item); if (icon_view->priv->selection_mode == GTK_SELECTION_NONE) { _gtk_icon_view_set_cursor_item (icon_view, item, cursor_cell); } else if (icon_view->priv->selection_mode == GTK_SELECTION_MULTIPLE && (state & extend_mod_mask)) { gtk_icon_view_unselect_all_internal (icon_view); _gtk_icon_view_set_cursor_item (icon_view, item, cursor_cell); if (!icon_view->priv->anchor_item) icon_view->priv->anchor_item = item; else gtk_icon_view_select_all_between (icon_view, icon_view->priv->anchor_item, item); dirty = TRUE; } else { if ((icon_view->priv->selection_mode == GTK_SELECTION_MULTIPLE || ((icon_view->priv->selection_mode == GTK_SELECTION_SINGLE) && item->selected)) && (state & modify_mod_mask)) { item->selected = !item->selected; gtk_icon_view_queue_draw_item (icon_view, item); dirty = TRUE; } else { gtk_icon_view_unselect_all_internal (icon_view); item->selected = TRUE; gtk_icon_view_queue_draw_item (icon_view, item); dirty = TRUE; } _gtk_icon_view_set_cursor_item (icon_view, item, cursor_cell); icon_view->priv->anchor_item = item; } /* Save press to possibly begin a drag */ if (icon_view->priv->pressed_button < 0) { icon_view->priv->pressed_button = button; icon_view->priv->press_start_x = x; icon_view->priv->press_start_y = y; } icon_view->priv->last_single_clicked = item; /* cancel the current editing, if it exists */ gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); if (cell != NULL && gtk_cell_renderer_is_activatable (cell)) { GtkCellAreaContext *context; context = g_ptr_array_index (icon_view->priv->row_contexts, item->row); _gtk_icon_view_set_cell_data (icon_view, item); gtk_cell_area_activate (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), &item->cell_area, 0/* XXX flags */, FALSE); } } else { if (icon_view->priv->selection_mode != GTK_SELECTION_BROWSE && !(state & modify_mod_mask)) { dirty = gtk_icon_view_unselect_all_internal (icon_view); } if (icon_view->priv->selection_mode == GTK_SELECTION_MULTIPLE) gtk_icon_view_start_rubberbanding (icon_view, gtk_gesture_get_device (GTK_GESTURE (gesture)), x, y); } /* don't draw keyboard focus around a clicked-on item */ icon_view->priv->draw_focus = FALSE; } if (!icon_view->priv->activate_on_single_click && button == GDK_BUTTON_PRIMARY && n_press == 2) { item = _gtk_icon_view_get_item_at_widget_coords (icon_view, x, y, FALSE, NULL); if (item && item == icon_view->priv->last_single_clicked) { GtkTreePath *path; path = gtk_tree_path_new_from_indices (item->index, -1); gtk_icon_view_item_activated (icon_view, path); gtk_tree_path_free (path); } icon_view->priv->last_single_clicked = NULL; icon_view->priv->pressed_button = -1; } if (dirty) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); } static gboolean button_event_modifies_selection (GdkEvent *event) { guint state = gdk_event_get_modifier_state (event); return (state & (GDK_CONTROL_MASK | GDK_SHIFT_MASK)) != 0; } static void gtk_icon_view_button_release (GtkGestureClick *gesture, int n_press, double x, double y, gpointer user_data) { GtkIconView *icon_view = user_data; int button = gtk_gesture_single_get_current_button (GTK_GESTURE_SINGLE (gesture)); GdkEventSequence *sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); GdkEvent *event = gtk_gesture_get_last_event (GTK_GESTURE (gesture), sequence); if (icon_view->priv->pressed_button == button) icon_view->priv->pressed_button = -1; gtk_icon_view_stop_rubberbanding (icon_view); remove_scroll_timeout (icon_view); if (button == GDK_BUTTON_PRIMARY && icon_view->priv->activate_on_single_click && !button_event_modifies_selection (event) && icon_view->priv->last_single_clicked != NULL) { GtkIconViewItem *item; item = _gtk_icon_view_get_item_at_widget_coords (icon_view, x, y, FALSE, NULL); if (item == icon_view->priv->last_single_clicked) { GtkTreePath *path; path = gtk_tree_path_new_from_indices (item->index, -1); gtk_icon_view_item_activated (icon_view, path); gtk_tree_path_free (path); } icon_view->priv->last_single_clicked = NULL; } } static gboolean gtk_icon_view_key_pressed (GtkEventControllerKey *controller, guint keyval, guint keycode, GdkModifierType state, GtkWidget *widget) { GtkIconView *icon_view = GTK_ICON_VIEW (widget); if (icon_view->priv->doing_rubberband) { if (keyval == GDK_KEY_Escape) gtk_icon_view_stop_rubberbanding (icon_view); return TRUE; } return FALSE; } static void gtk_icon_view_update_rubberband (GtkIconView *icon_view) { int x, y; x = MAX (icon_view->priv->mouse_x, 0); y = MAX (icon_view->priv->mouse_y, 0); icon_view->priv->rubberband_x2 = x + gtk_adjustment_get_value (icon_view->priv->hadjustment); icon_view->priv->rubberband_y2 = y + gtk_adjustment_get_value (icon_view->priv->vadjustment); gtk_icon_view_update_rubberband_selection (icon_view); gtk_widget_queue_draw (GTK_WIDGET (icon_view)); } static void gtk_icon_view_start_rubberbanding (GtkIconView *icon_view, GdkDevice *device, int x, int y) { GtkIconViewPrivate *priv = icon_view->priv; GList *items; GtkCssNode *widget_node; if (priv->rubberband_device) return; for (items = priv->items; items; items = items->next) { GtkIconViewItem *item = items->data; item->selected_before_rubberbanding = item->selected; } priv->rubberband_x1 = x + gtk_adjustment_get_value (priv->hadjustment); priv->rubberband_y1 = y + gtk_adjustment_get_value (priv->vadjustment); priv->rubberband_x2 = priv->rubberband_x1; priv->rubberband_y2 = priv->rubberband_y1; priv->doing_rubberband = TRUE; priv->rubberband_device = device; widget_node = gtk_widget_get_css_node (GTK_WIDGET (icon_view)); priv->rubberband_node = gtk_css_node_new (); gtk_css_node_set_name (priv->rubberband_node, g_quark_from_static_string ("rubberband")); gtk_css_node_set_parent (priv->rubberband_node, widget_node); gtk_css_node_set_state (priv->rubberband_node, gtk_css_node_get_state (widget_node)); g_object_unref (priv->rubberband_node); } static void gtk_icon_view_stop_rubberbanding (GtkIconView *icon_view) { GtkIconViewPrivate *priv = icon_view->priv; if (!priv->doing_rubberband) return; priv->doing_rubberband = FALSE; priv->rubberband_device = NULL; gtk_css_node_set_parent (priv->rubberband_node, NULL); priv->rubberband_node = NULL; gtk_widget_queue_draw (GTK_WIDGET (icon_view)); } static void gtk_icon_view_update_rubberband_selection (GtkIconView *icon_view) { GList *items; int x, y, width, height; gboolean dirty = FALSE; x = MIN (icon_view->priv->rubberband_x1, icon_view->priv->rubberband_x2); y = MIN (icon_view->priv->rubberband_y1, icon_view->priv->rubberband_y2); width = ABS (icon_view->priv->rubberband_x1 - icon_view->priv->rubberband_x2); height = ABS (icon_view->priv->rubberband_y1 - icon_view->priv->rubberband_y2); for (items = icon_view->priv->items; items; items = items->next) { GtkIconViewItem *item = items->data; gboolean is_in; gboolean selected; is_in = gtk_icon_view_item_hit_test (icon_view, item, x, y, width, height); selected = is_in ^ item->selected_before_rubberbanding; if (item->selected != selected) { item->selected = selected; dirty = TRUE; gtk_icon_view_queue_draw_item (icon_view, item); } } if (dirty) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); } typedef struct { GdkRectangle hit_rect; gboolean hit; } HitTestData; static gboolean hit_test (GtkCellRenderer *renderer, const GdkRectangle *cell_area, const GdkRectangle *cell_background, HitTestData *data) { if (MIN (data->hit_rect.x + data->hit_rect.width, cell_area->x + cell_area->width) - MAX (data->hit_rect.x, cell_area->x) > 0 && MIN (data->hit_rect.y + data->hit_rect.height, cell_area->y + cell_area->height) - MAX (data->hit_rect.y, cell_area->y) > 0) data->hit = TRUE; return (data->hit != FALSE); } static gboolean gtk_icon_view_item_hit_test (GtkIconView *icon_view, GtkIconViewItem *item, int x, int y, int width, int height) { HitTestData data = { { x, y, width, height }, FALSE }; GtkCellAreaContext *context; GdkRectangle *item_area = &item->cell_area; if (MIN (x + width, item_area->x + item_area->width) - MAX (x, item_area->x) <= 0 || MIN (y + height, item_area->y + item_area->height) - MAX (y, item_area->y) <= 0) return FALSE; context = g_ptr_array_index (icon_view->priv->row_contexts, item->row); _gtk_icon_view_set_cell_data (icon_view, item); gtk_cell_area_foreach_alloc (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), item_area, item_area, (GtkCellAllocCallback)hit_test, &data); return data.hit; } static gboolean gtk_icon_view_unselect_all_internal (GtkIconView *icon_view) { gboolean dirty = FALSE; GList *items; if (icon_view->priv->selection_mode == GTK_SELECTION_NONE) return FALSE; for (items = icon_view->priv->items; items; items = items->next) { GtkIconViewItem *item = items->data; if (item->selected) { item->selected = FALSE; dirty = TRUE; gtk_icon_view_queue_draw_item (icon_view, item); } } return dirty; } /* GtkIconView signals */ static void gtk_icon_view_real_select_all (GtkIconView *icon_view) { gtk_icon_view_select_all (icon_view); } static void gtk_icon_view_real_unselect_all (GtkIconView *icon_view) { gtk_icon_view_unselect_all (icon_view); } static void gtk_icon_view_real_select_cursor_item (GtkIconView *icon_view) { gtk_icon_view_unselect_all (icon_view); if (icon_view->priv->cursor_item != NULL) _gtk_icon_view_select_item (icon_view, icon_view->priv->cursor_item); } static gboolean gtk_icon_view_real_activate_cursor_item (GtkIconView *icon_view) { GtkTreePath *path; GtkCellAreaContext *context; if (!icon_view->priv->cursor_item) return FALSE; context = g_ptr_array_index (icon_view->priv->row_contexts, icon_view->priv->cursor_item->row); _gtk_icon_view_set_cell_data (icon_view, icon_view->priv->cursor_item); gtk_cell_area_activate (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), &icon_view->priv->cursor_item->cell_area, 0 /* XXX flags */, FALSE); path = gtk_tree_path_new_from_indices (icon_view->priv->cursor_item->index, -1); gtk_icon_view_item_activated (icon_view, path); gtk_tree_path_free (path); return TRUE; } static void gtk_icon_view_real_toggle_cursor_item (GtkIconView *icon_view) { if (!icon_view->priv->cursor_item) return; switch (icon_view->priv->selection_mode) { case GTK_SELECTION_NONE: default: break; case GTK_SELECTION_BROWSE: _gtk_icon_view_select_item (icon_view, icon_view->priv->cursor_item); break; case GTK_SELECTION_SINGLE: if (icon_view->priv->cursor_item->selected) _gtk_icon_view_unselect_item (icon_view, icon_view->priv->cursor_item); else _gtk_icon_view_select_item (icon_view, icon_view->priv->cursor_item); break; case GTK_SELECTION_MULTIPLE: icon_view->priv->cursor_item->selected = !icon_view->priv->cursor_item->selected; g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); gtk_icon_view_queue_draw_item (icon_view, icon_view->priv->cursor_item); break; } } static void gtk_icon_view_set_hadjustment_values (GtkIconView *icon_view) { int width; GtkAdjustment *adj = icon_view->priv->hadjustment; double old_page_size; double old_upper; double old_value; double new_value; double new_upper; width = gtk_widget_get_width (GTK_WIDGET (icon_view)); old_value = gtk_adjustment_get_value (adj); old_upper = gtk_adjustment_get_upper (adj); old_page_size = gtk_adjustment_get_page_size (adj); new_upper = MAX (width, icon_view->priv->width); if (gtk_widget_get_direction (GTK_WIDGET (icon_view)) == GTK_TEXT_DIR_RTL) { /* Make sure no scrolling occurs for RTL locales also (if possible) */ /* Quick explanation: * In LTR locales, leftmost portion of visible rectangle should stay * fixed, which means left edge of scrollbar thumb should remain fixed * and thus adjustment's value should stay the same. * * In RTL locales, we want to keep rightmost portion of visible * rectangle fixed. This means right edge of thumb should remain fixed. * In this case, upper - value - page_size should remain constant. */ new_value = (new_upper - width) - (old_upper - old_value - old_page_size); new_value = CLAMP (new_value, 0, new_upper - width); } else new_value = CLAMP (old_value, 0, new_upper - width); gtk_adjustment_configure (adj, new_value, 0.0, new_upper, width * 0.1, width * 0.9, width); } static void gtk_icon_view_set_vadjustment_values (GtkIconView *icon_view) { int height; GtkAdjustment *adj = icon_view->priv->vadjustment; height = gtk_widget_get_height (GTK_WIDGET (icon_view)); gtk_adjustment_configure (adj, gtk_adjustment_get_value (adj), 0.0, MAX (height, icon_view->priv->height), height * 0.1, height * 0.9, height); } static void gtk_icon_view_set_hadjustment (GtkIconView *icon_view, GtkAdjustment *adjustment) { GtkIconViewPrivate *priv = icon_view->priv; if (adjustment && priv->hadjustment == adjustment) return; if (priv->hadjustment != NULL) { g_signal_handlers_disconnect_matched (priv->hadjustment, G_SIGNAL_MATCH_DATA, 0, 0, NULL, NULL, icon_view); g_object_unref (priv->hadjustment); } if (!adjustment) adjustment = gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0); g_signal_connect (adjustment, "value-changed", G_CALLBACK (gtk_icon_view_adjustment_changed), icon_view); priv->hadjustment = g_object_ref_sink (adjustment); gtk_icon_view_set_hadjustment_values (icon_view); g_object_notify (G_OBJECT (icon_view), "hadjustment"); } static void gtk_icon_view_set_vadjustment (GtkIconView *icon_view, GtkAdjustment *adjustment) { GtkIconViewPrivate *priv = icon_view->priv; if (adjustment && priv->vadjustment == adjustment) return; if (priv->vadjustment != NULL) { g_signal_handlers_disconnect_matched (priv->vadjustment, G_SIGNAL_MATCH_DATA, 0, 0, NULL, NULL, icon_view); g_object_unref (priv->vadjustment); } if (!adjustment) adjustment = gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0); g_signal_connect (adjustment, "value-changed", G_CALLBACK (gtk_icon_view_adjustment_changed), icon_view); priv->vadjustment = g_object_ref_sink (adjustment); gtk_icon_view_set_vadjustment_values (icon_view); g_object_notify (G_OBJECT (icon_view), "vadjustment"); } static void gtk_icon_view_adjustment_changed (GtkAdjustment *adjustment, GtkIconView *icon_view) { GtkWidget *widget = GTK_WIDGET (icon_view); if (gtk_widget_get_realized (widget)) { if (icon_view->priv->doing_rubberband) gtk_icon_view_update_rubberband (icon_view); } gtk_widget_queue_draw (GTK_WIDGET (icon_view)); } static int compare_sizes (gconstpointer p1, gconstpointer p2, gpointer unused) { return GPOINTER_TO_INT (((const GtkRequestedSize *) p1)->data) - GPOINTER_TO_INT (((const GtkRequestedSize *) p2)->data); } static void gtk_icon_view_layout (GtkIconView *icon_view) { GtkIconViewPrivate *priv = icon_view->priv; GtkWidget *widget = GTK_WIDGET (icon_view); GList *items; int item_width = 0; /* this doesn't include item_padding */ int n_columns, n_rows, n_items; int col, row; GtkRequestedSize *sizes; gboolean rtl; int width, height; if (gtk_icon_view_is_empty (icon_view)) return; rtl = gtk_widget_get_direction (GTK_WIDGET (icon_view)) == GTK_TEXT_DIR_RTL; n_items = gtk_icon_view_get_n_items (icon_view); width = gtk_widget_get_width (widget); height = gtk_widget_get_height (widget); gtk_icon_view_compute_n_items_for_size (icon_view, GTK_ORIENTATION_HORIZONTAL, width, NULL, NULL, &n_columns, &item_width); n_rows = (n_items + n_columns - 1) / n_columns; priv->width = n_columns * (item_width + 2 * priv->item_padding + priv->column_spacing) - priv->column_spacing; priv->width += 2 * priv->margin; priv->width = MAX (priv->width, width); /* Clear the per row contexts */ g_ptr_array_set_size (icon_view->priv->row_contexts, 0); gtk_cell_area_context_reset (priv->cell_area_context); /* because layouting is complicated. We designed an API * that is O(N²) and nonsensical. * And we're proud of it. */ for (items = priv->items; items; items = items->next) { _gtk_icon_view_set_cell_data (icon_view, items->data); gtk_cell_area_get_preferred_width (priv->cell_area, priv->cell_area_context, widget, NULL, NULL); } sizes = g_newa (GtkRequestedSize, n_rows); items = priv->items; priv->height = priv->margin; /* Collect the heights for all rows */ for (row = 0; row < n_rows; row++) { GtkCellAreaContext *context = gtk_cell_area_copy_context (priv->cell_area, priv->cell_area_context); g_ptr_array_add (priv->row_contexts, context); for (col = 0; col < n_columns && items; col++, items = items->next) { GtkIconViewItem *item = items->data; _gtk_icon_view_set_cell_data (icon_view, item); gtk_cell_area_get_preferred_height_for_width (priv->cell_area, context, widget, item_width, NULL, NULL); } sizes[row].data = GINT_TO_POINTER (row); gtk_cell_area_context_get_preferred_height_for_width (context, item_width, &sizes[row].minimum_size, &sizes[row].natural_size); priv->height += sizes[row].minimum_size + 2 * priv->item_padding + priv->row_spacing; } priv->height -= priv->row_spacing; priv->height += priv->margin; priv->height = MIN (priv->height, height); gtk_distribute_natural_allocation (height - priv->height, n_rows, sizes); /* Actually allocate the rows */ g_qsort_with_data (sizes, n_rows, sizeof (GtkRequestedSize), compare_sizes, NULL); items = priv->items; priv->height = priv->margin; for (row = 0; row < n_rows; row++) { GtkCellAreaContext *context = g_ptr_array_index (priv->row_contexts, row); gtk_cell_area_context_allocate (context, item_width, sizes[row].minimum_size); priv->height += priv->item_padding; for (col = 0; col < n_columns && items; col++, items = items->next) { GtkIconViewItem *item = items->data; item->cell_area.x = priv->margin + (col * 2 + 1) * priv->item_padding + col * (priv->column_spacing + item_width); item->cell_area.width = item_width; item->cell_area.y = priv->height; item->cell_area.height = sizes[row].minimum_size; item->row = row; item->col = col; if (rtl) { item->cell_area.x = priv->width - item_width - item->cell_area.x; item->col = n_columns - 1 - col; } } priv->height += sizes[row].minimum_size + priv->item_padding + priv->row_spacing; } priv->height -= priv->row_spacing; priv->height += priv->margin; priv->height = MAX (priv->height, height); } static void gtk_icon_view_invalidate_sizes (GtkIconView *icon_view) { /* Clear all item sizes */ g_list_foreach (icon_view->priv->items, (GFunc)gtk_icon_view_item_invalidate_size, NULL); /* Re-layout the items */ gtk_widget_queue_resize (GTK_WIDGET (icon_view)); } static void gtk_icon_view_item_invalidate_size (GtkIconViewItem *item) { item->cell_area.width = -1; item->cell_area.height = -1; } static void gtk_icon_view_snapshot_item (GtkIconView *icon_view, GtkSnapshot *snapshot, GtkIconViewItem *item, int x, int y, gboolean draw_focus) { GdkRectangle cell_area; GtkStateFlags state = 0; GtkCellRendererState flags = 0; GtkStyleContext *style_context; GtkWidget *widget = GTK_WIDGET (icon_view); GtkIconViewPrivate *priv = icon_view->priv; GtkCellAreaContext *context; if (priv->model == NULL || item->cell_area.width <= 0 || item->cell_area.height <= 0) return; _gtk_icon_view_set_cell_data (icon_view, item); style_context = gtk_widget_get_style_context (widget); state = gtk_widget_get_state_flags (widget); gtk_style_context_save (style_context); gtk_style_context_add_class (style_context, GTK_STYLE_CLASS_CELL); state &= ~(GTK_STATE_FLAG_SELECTED | GTK_STATE_FLAG_PRELIGHT); if ((state & GTK_STATE_FLAG_FOCUSED) && item == icon_view->priv->cursor_item) flags |= GTK_CELL_RENDERER_FOCUSED; if (item->selected) { state |= GTK_STATE_FLAG_SELECTED; flags |= GTK_CELL_RENDERER_SELECTED; } if (item == priv->last_prelight) { state |= GTK_STATE_FLAG_PRELIGHT; flags |= GTK_CELL_RENDERER_PRELIT; } gtk_style_context_set_state (style_context, state); gtk_snapshot_render_background (snapshot, style_context, x - priv->item_padding, y - priv->item_padding, item->cell_area.width + priv->item_padding * 2, item->cell_area.height + priv->item_padding * 2); gtk_snapshot_render_frame (snapshot, style_context, x - priv->item_padding, y - priv->item_padding, item->cell_area.width + priv->item_padding * 2, item->cell_area.height + priv->item_padding * 2); cell_area.x = x; cell_area.y = y; cell_area.width = item->cell_area.width; cell_area.height = item->cell_area.height; context = g_ptr_array_index (priv->row_contexts, item->row); gtk_cell_area_snapshot (priv->cell_area, context, widget, snapshot, &cell_area, &cell_area, flags, draw_focus); gtk_style_context_restore (style_context); } static void gtk_icon_view_snapshot_rubberband (GtkIconView *icon_view, GtkSnapshot *snapshot) { GtkIconViewPrivate *priv = icon_view->priv; GtkStyleContext *context; GdkRectangle rect; rect.x = MIN (priv->rubberband_x1, priv->rubberband_x2); rect.y = MIN (priv->rubberband_y1, priv->rubberband_y2); rect.width = ABS (priv->rubberband_x1 - priv->rubberband_x2) + 1; rect.height = ABS (priv->rubberband_y1 - priv->rubberband_y2) + 1; context = gtk_widget_get_style_context (GTK_WIDGET (icon_view)); gtk_style_context_save_to_node (context, priv->rubberband_node); gtk_snapshot_render_background (snapshot, context, rect.x, rect.y, rect.width, rect.height); gtk_snapshot_render_frame (snapshot, context, rect.x, rect.y, rect.width, rect.height); gtk_style_context_restore (context); } static void gtk_icon_view_queue_draw_path (GtkIconView *icon_view, GtkTreePath *path) { GList *l; int index; index = gtk_tree_path_get_indices (path)[0]; for (l = icon_view->priv->items; l; l = l->next) { GtkIconViewItem *item = l->data; if (item->index == index) { gtk_icon_view_queue_draw_item (icon_view, item); break; } } } static void gtk_icon_view_queue_draw_item (GtkIconView *icon_view, GtkIconViewItem *item) { gtk_widget_queue_draw (GTK_WIDGET (icon_view)); } void _gtk_icon_view_set_cursor_item (GtkIconView *icon_view, GtkIconViewItem *item, GtkCellRenderer *cursor_cell) { /* When hitting this path from keynav, the focus cell is already set, * but we still need to queue the draw here (in the case that the focus * cell changes but not the cursor item). */ gtk_icon_view_queue_draw_item (icon_view, item); if (icon_view->priv->cursor_item == item && (cursor_cell == NULL || cursor_cell == gtk_cell_area_get_focus_cell (icon_view->priv->cell_area))) return; if (icon_view->priv->cursor_item != NULL) gtk_icon_view_queue_draw_item (icon_view, icon_view->priv->cursor_item); icon_view->priv->cursor_item = item; if (cursor_cell) gtk_cell_area_set_focus_cell (icon_view->priv->cell_area, cursor_cell); else { /* Make sure there is a cell in focus initially */ if (!gtk_cell_area_get_focus_cell (icon_view->priv->cell_area)) gtk_cell_area_focus (icon_view->priv->cell_area, GTK_DIR_TAB_FORWARD); } } static GtkIconViewItem * gtk_icon_view_item_new (void) { GtkIconViewItem *item; item = g_slice_new0 (GtkIconViewItem); item->cell_area.width = -1; item->cell_area.height = -1; return item; } static void gtk_icon_view_item_free (GtkIconViewItem *item) { g_return_if_fail (item != NULL); g_slice_free (GtkIconViewItem, item); } GtkIconViewItem * _gtk_icon_view_get_item_at_coords (GtkIconView *icon_view, int x, int y, gboolean only_in_cell, GtkCellRenderer **cell_at_pos) { GList *items; if (cell_at_pos) *cell_at_pos = NULL; for (items = icon_view->priv->items; items; items = items->next) { GtkIconViewItem *item = items->data; GdkRectangle *item_area = &item->cell_area; if (x >= item_area->x - icon_view->priv->column_spacing/2 && x <= item_area->x + item_area->width + icon_view->priv->column_spacing/2 && y >= item_area->y - icon_view->priv->row_spacing/2 && y <= item_area->y + item_area->height + icon_view->priv->row_spacing/2) { if (only_in_cell || cell_at_pos) { GtkCellRenderer *cell = NULL; GtkCellAreaContext *context; context = g_ptr_array_index (icon_view->priv->row_contexts, item->row); _gtk_icon_view_set_cell_data (icon_view, item); if (x >= item_area->x && x <= item_area->x + item_area->width && y >= item_area->y && y <= item_area->y + item_area->height) cell = gtk_cell_area_get_cell_at_position (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), item_area, x, y, NULL); if (cell_at_pos) *cell_at_pos = cell; if (only_in_cell) return cell != NULL ? item : NULL; else return item; } return item; } } return NULL; } void _gtk_icon_view_select_item (GtkIconView *icon_view, GtkIconViewItem *item) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (item != NULL); if (item->selected) return; if (icon_view->priv->selection_mode == GTK_SELECTION_NONE) return; else if (icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE) gtk_icon_view_unselect_all_internal (icon_view); item->selected = TRUE; g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); gtk_icon_view_queue_draw_item (icon_view, item); } void _gtk_icon_view_unselect_item (GtkIconView *icon_view, GtkIconViewItem *item) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (item != NULL); if (!item->selected) return; if (icon_view->priv->selection_mode == GTK_SELECTION_NONE || icon_view->priv->selection_mode == GTK_SELECTION_BROWSE) return; item->selected = FALSE; g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); gtk_icon_view_queue_draw_item (icon_view, item); } static void verify_items (GtkIconView *icon_view) { GList *items; int i = 0; for (items = icon_view->priv->items; items; items = items->next) { GtkIconViewItem *item = items->data; if (item->index != i) g_error ("List item does not match its index: " "item index %d and list index %d\n", item->index, i); i++; } } static void gtk_icon_view_row_changed (GtkTreeModel *model, GtkTreePath *path, GtkTreeIter *iter, gpointer data) { GtkIconView *icon_view = GTK_ICON_VIEW (data); /* ignore changes in branches */ if (gtk_tree_path_get_depth (path) > 1) return; /* An icon view subclass might add it's own model and populate * things at init() time instead of waiting for the constructor() * to be called */ if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); /* Here we can use a "grow-only" strategy for optimization * and only invalidate a single item and queue a relayout * instead of invalidating the whole thing. * * For now GtkIconView still cant deal with huge models * so just invalidate the whole thing when the model * changes. */ gtk_icon_view_invalidate_sizes (icon_view); verify_items (icon_view); } static void gtk_icon_view_row_inserted (GtkTreeModel *model, GtkTreePath *path, GtkTreeIter *iter, gpointer data) { GtkIconView *icon_view = GTK_ICON_VIEW (data); int index; GtkIconViewItem *item; GList *list; /* ignore changes in branches */ if (gtk_tree_path_get_depth (path) > 1) return; gtk_tree_model_ref_node (model, iter); index = gtk_tree_path_get_indices(path)[0]; item = gtk_icon_view_item_new (); item->index = index; /* FIXME: We can be more efficient here, we can store a tail pointer and use that when appending (which is a rather common operation) */ icon_view->priv->items = g_list_insert (icon_view->priv->items, item, index); list = g_list_nth (icon_view->priv->items, index + 1); for (; list; list = list->next) { item = list->data; item->index++; } verify_items (icon_view); gtk_widget_queue_resize (GTK_WIDGET (icon_view)); } static void gtk_icon_view_row_deleted (GtkTreeModel *model, GtkTreePath *path, gpointer data) { GtkIconView *icon_view = GTK_ICON_VIEW (data); int index; GtkIconViewItem *item; GList *list, *next; gboolean emit = FALSE; GtkTreeIter iter; /* ignore changes in branches */ if (gtk_tree_path_get_depth (path) > 1) return; if (gtk_tree_model_get_iter (model, &iter, path)) gtk_tree_model_unref_node (model, &iter); index = gtk_tree_path_get_indices(path)[0]; list = g_list_nth (icon_view->priv->items, index); item = list->data; if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); if (item == icon_view->priv->anchor_item) icon_view->priv->anchor_item = NULL; if (item == icon_view->priv->cursor_item) icon_view->priv->cursor_item = NULL; if (item == icon_view->priv->last_prelight) icon_view->priv->last_prelight = NULL; if (item->selected) emit = TRUE; gtk_icon_view_item_free (item); for (next = list->next; next; next = next->next) { item = next->data; item->index--; } icon_view->priv->items = g_list_delete_link (icon_view->priv->items, list); verify_items (icon_view); gtk_widget_queue_resize (GTK_WIDGET (icon_view)); if (emit) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); } static void gtk_icon_view_rows_reordered (GtkTreeModel *model, GtkTreePath *parent, GtkTreeIter *iter, int *new_order, gpointer data) { GtkIconView *icon_view = GTK_ICON_VIEW (data); int i; int length; GList *items = NULL, *list; GtkIconViewItem **item_array; int *order; /* ignore changes in branches */ if (iter != NULL) return; if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); length = gtk_tree_model_iter_n_children (model, NULL); order = g_new (int, length); for (i = 0; i < length; i++) order [new_order[i]] = i; item_array = g_new (GtkIconViewItem *, length); for (i = 0, list = icon_view->priv->items; list != NULL; list = list->next, i++) item_array[order[i]] = list->data; g_free (order); for (i = length - 1; i >= 0; i--) { item_array[i]->index = i; items = g_list_prepend (items, item_array[i]); } g_free (item_array); g_list_free (icon_view->priv->items); icon_view->priv->items = items; gtk_widget_queue_resize (GTK_WIDGET (icon_view)); verify_items (icon_view); } static void gtk_icon_view_build_items (GtkIconView *icon_view) { GtkTreeIter iter; int i; GList *items = NULL; if (!gtk_tree_model_get_iter_first (icon_view->priv->model, &iter)) return; i = 0; do { GtkIconViewItem *item = gtk_icon_view_item_new (); item->index = i; i++; items = g_list_prepend (items, item); } while (gtk_tree_model_iter_next (icon_view->priv->model, &iter)); icon_view->priv->items = g_list_reverse (items); } static void gtk_icon_view_add_move_binding (GtkWidgetClass *widget_class, guint keyval, guint modmask, GtkMovementStep step, int count) { gtk_widget_class_add_binding_signal (widget_class, keyval, modmask, I_("move-cursor"), "(iibb)", step, count, FALSE, FALSE); gtk_widget_class_add_binding_signal (widget_class, keyval, GDK_SHIFT_MASK, "move-cursor", "(iibb)", step, count, TRUE, FALSE); if ((modmask & GDK_CONTROL_MASK) == GDK_CONTROL_MASK) return; gtk_widget_class_add_binding_signal (widget_class, keyval, GDK_CONTROL_MASK | GDK_SHIFT_MASK, "move-cursor", "(iibb)", step, count, TRUE, TRUE); gtk_widget_class_add_binding_signal (widget_class, keyval, GDK_CONTROL_MASK, "move-cursor", "(iibb)", step, count, FALSE, TRUE); } static gboolean gtk_icon_view_real_move_cursor (GtkIconView *icon_view, GtkMovementStep step, int count, gboolean extend, gboolean modify) { g_return_val_if_fail (GTK_ICON_VIEW (icon_view), FALSE); g_return_val_if_fail (step == GTK_MOVEMENT_LOGICAL_POSITIONS || step == GTK_MOVEMENT_VISUAL_POSITIONS || step == GTK_MOVEMENT_DISPLAY_LINES || step == GTK_MOVEMENT_PAGES || step == GTK_MOVEMENT_BUFFER_ENDS, FALSE); if (!gtk_widget_has_focus (GTK_WIDGET (icon_view))) return FALSE; gtk_cell_area_stop_editing (icon_view->priv->cell_area, FALSE); gtk_widget_grab_focus (GTK_WIDGET (icon_view)); icon_view->priv->extend_selection_pressed = extend; icon_view->priv->modify_selection_pressed = modify; switch (step) { case GTK_MOVEMENT_LOGICAL_POSITIONS: case GTK_MOVEMENT_VISUAL_POSITIONS: gtk_icon_view_move_cursor_left_right (icon_view, count); break; case GTK_MOVEMENT_DISPLAY_LINES: gtk_icon_view_move_cursor_up_down (icon_view, count); break; case GTK_MOVEMENT_PAGES: gtk_icon_view_move_cursor_page_up_down (icon_view, count); break; case GTK_MOVEMENT_BUFFER_ENDS: gtk_icon_view_move_cursor_start_end (icon_view, count); break; case GTK_MOVEMENT_WORDS: case GTK_MOVEMENT_DISPLAY_LINE_ENDS: case GTK_MOVEMENT_PARAGRAPHS: case GTK_MOVEMENT_PARAGRAPH_ENDS: case GTK_MOVEMENT_HORIZONTAL_PAGES: default: g_assert_not_reached (); break; } icon_view->priv->modify_selection_pressed = FALSE; icon_view->priv->extend_selection_pressed = FALSE; icon_view->priv->draw_focus = TRUE; return TRUE; } static GtkIconViewItem * find_item (GtkIconView *icon_view, GtkIconViewItem *current, int row_ofs, int col_ofs) { int row, col; GList *items; GtkIconViewItem *item; /* FIXME: this could be more efficient */ row = current->row + row_ofs; col = current->col + col_ofs; for (items = icon_view->priv->items; items; items = items->next) { item = items->data; if (item->row == row && item->col == col) return item; } return NULL; } static GtkIconViewItem * find_item_page_up_down (GtkIconView *icon_view, GtkIconViewItem *current, int count) { GList *item, *next; int y, col; col = current->col; y = current->cell_area.y + count * gtk_adjustment_get_page_size (icon_view->priv->vadjustment); item = g_list_find (icon_view->priv->items, current); if (count > 0) { while (item) { for (next = item->next; next; next = next->next) { if (((GtkIconViewItem *)next->data)->col == col) break; } if (!next || ((GtkIconViewItem *)next->data)->cell_area.y > y) break; item = next; } } else { while (item) { for (next = item->prev; next; next = next->prev) { if (((GtkIconViewItem *)next->data)->col == col) break; } if (!next || ((GtkIconViewItem *)next->data)->cell_area.y < y) break; item = next; } } if (item) return item->data; return NULL; } static gboolean gtk_icon_view_select_all_between (GtkIconView *icon_view, GtkIconViewItem *anchor, GtkIconViewItem *cursor) { GList *items; GtkIconViewItem *item; int row1, row2, col1, col2; gboolean dirty = FALSE; if (anchor->row < cursor->row) { row1 = anchor->row; row2 = cursor->row; } else { row1 = cursor->row; row2 = anchor->row; } if (anchor->col < cursor->col) { col1 = anchor->col; col2 = cursor->col; } else { col1 = cursor->col; col2 = anchor->col; } for (items = icon_view->priv->items; items; items = items->next) { item = items->data; if (row1 <= item->row && item->row <= row2 && col1 <= item->col && item->col <= col2) { if (!item->selected) { dirty = TRUE; item->selected = TRUE; } gtk_icon_view_queue_draw_item (icon_view, item); } } return dirty; } static void gtk_icon_view_move_cursor_up_down (GtkIconView *icon_view, int count) { GtkIconViewItem *item; GtkCellRenderer *cell = NULL; gboolean dirty = FALSE; int step; GtkDirectionType direction; if (!gtk_widget_has_focus (GTK_WIDGET (icon_view))) return; direction = count < 0 ? GTK_DIR_UP : GTK_DIR_DOWN; if (!icon_view->priv->cursor_item) { GList *list; if (count > 0) list = icon_view->priv->items; else list = g_list_last (icon_view->priv->items); if (list) { item = list->data; /* Give focus to the first cell initially */ _gtk_icon_view_set_cell_data (icon_view, item); gtk_cell_area_focus (icon_view->priv->cell_area, direction); } else { item = NULL; } } else { item = icon_view->priv->cursor_item; step = count > 0 ? 1 : -1; /* Save the current focus cell in case we hit the edge */ cell = gtk_cell_area_get_focus_cell (icon_view->priv->cell_area); while (item) { _gtk_icon_view_set_cell_data (icon_view, item); if (gtk_cell_area_focus (icon_view->priv->cell_area, direction)) break; item = find_item (icon_view, item, step, 0); } } if (!item) { if (!gtk_widget_keynav_failed (GTK_WIDGET (icon_view), direction)) { GtkWidget *toplevel = GTK_WIDGET (gtk_widget_get_root (GTK_WIDGET (icon_view))); if (toplevel) gtk_widget_child_focus (toplevel, direction == GTK_DIR_UP ? GTK_DIR_TAB_BACKWARD : GTK_DIR_TAB_FORWARD); } gtk_cell_area_set_focus_cell (icon_view->priv->cell_area, cell); return; } if (icon_view->priv->modify_selection_pressed || !icon_view->priv->extend_selection_pressed || !icon_view->priv->anchor_item || icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE) icon_view->priv->anchor_item = item; cell = gtk_cell_area_get_focus_cell (icon_view->priv->cell_area); _gtk_icon_view_set_cursor_item (icon_view, item, cell); if (!icon_view->priv->modify_selection_pressed && icon_view->priv->selection_mode != GTK_SELECTION_NONE) { dirty = gtk_icon_view_unselect_all_internal (icon_view); dirty = gtk_icon_view_select_all_between (icon_view, icon_view->priv->anchor_item, item) || dirty; } gtk_icon_view_scroll_to_item (icon_view, item); if (dirty) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); } static void gtk_icon_view_move_cursor_page_up_down (GtkIconView *icon_view, int count) { GtkIconViewItem *item; gboolean dirty = FALSE; if (!gtk_widget_has_focus (GTK_WIDGET (icon_view))) return; if (!icon_view->priv->cursor_item) { GList *list; if (count > 0) list = icon_view->priv->items; else list = g_list_last (icon_view->priv->items); item = list ? list->data : NULL; } else item = find_item_page_up_down (icon_view, icon_view->priv->cursor_item, count); if (item == icon_view->priv->cursor_item) gtk_widget_error_bell (GTK_WIDGET (icon_view)); if (!item) return; if (icon_view->priv->modify_selection_pressed || !icon_view->priv->extend_selection_pressed || !icon_view->priv->anchor_item || icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE) icon_view->priv->anchor_item = item; _gtk_icon_view_set_cursor_item (icon_view, item, NULL); if (!icon_view->priv->modify_selection_pressed && icon_view->priv->selection_mode != GTK_SELECTION_NONE) { dirty = gtk_icon_view_unselect_all_internal (icon_view); dirty = gtk_icon_view_select_all_between (icon_view, icon_view->priv->anchor_item, item) || dirty; } gtk_icon_view_scroll_to_item (icon_view, item); if (dirty) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); } static void gtk_icon_view_move_cursor_left_right (GtkIconView *icon_view, int count) { GtkIconViewItem *item; GtkCellRenderer *cell = NULL; gboolean dirty = FALSE; int step; GtkDirectionType direction; if (!gtk_widget_has_focus (GTK_WIDGET (icon_view))) return; direction = count < 0 ? GTK_DIR_LEFT : GTK_DIR_RIGHT; if (!icon_view->priv->cursor_item) { GList *list; if (count > 0) list = icon_view->priv->items; else list = g_list_last (icon_view->priv->items); if (list) { item = list->data; /* Give focus to the first cell initially */ _gtk_icon_view_set_cell_data (icon_view, item); gtk_cell_area_focus (icon_view->priv->cell_area, direction); } else { item = NULL; } } else { item = icon_view->priv->cursor_item; step = count > 0 ? 1 : -1; /* Save the current focus cell in case we hit the edge */ cell = gtk_cell_area_get_focus_cell (icon_view->priv->cell_area); while (item) { _gtk_icon_view_set_cell_data (icon_view, item); if (gtk_cell_area_focus (icon_view->priv->cell_area, direction)) break; item = find_item (icon_view, item, 0, step); } } if (!item) { if (!gtk_widget_keynav_failed (GTK_WIDGET (icon_view), direction)) { GtkWidget *toplevel = GTK_WIDGET (gtk_widget_get_root (GTK_WIDGET (icon_view))); if (toplevel) gtk_widget_child_focus (toplevel, direction == GTK_DIR_LEFT ? GTK_DIR_TAB_BACKWARD : GTK_DIR_TAB_FORWARD); } gtk_cell_area_set_focus_cell (icon_view->priv->cell_area, cell); return; } if (icon_view->priv->modify_selection_pressed || !icon_view->priv->extend_selection_pressed || !icon_view->priv->anchor_item || icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE) icon_view->priv->anchor_item = item; cell = gtk_cell_area_get_focus_cell (icon_view->priv->cell_area); _gtk_icon_view_set_cursor_item (icon_view, item, cell); if (!icon_view->priv->modify_selection_pressed && icon_view->priv->selection_mode != GTK_SELECTION_NONE) { dirty = gtk_icon_view_unselect_all_internal (icon_view); dirty = gtk_icon_view_select_all_between (icon_view, icon_view->priv->anchor_item, item) || dirty; } gtk_icon_view_scroll_to_item (icon_view, item); if (dirty) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); } static void gtk_icon_view_move_cursor_start_end (GtkIconView *icon_view, int count) { GtkIconViewItem *item; GList *list; gboolean dirty = FALSE; if (!gtk_widget_has_focus (GTK_WIDGET (icon_view))) return; if (count < 0) list = icon_view->priv->items; else list = g_list_last (icon_view->priv->items); item = list ? list->data : NULL; if (item == icon_view->priv->cursor_item) gtk_widget_error_bell (GTK_WIDGET (icon_view)); if (!item) return; if (icon_view->priv->modify_selection_pressed || !icon_view->priv->extend_selection_pressed || !icon_view->priv->anchor_item || icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE) icon_view->priv->anchor_item = item; _gtk_icon_view_set_cursor_item (icon_view, item, NULL); if (!icon_view->priv->modify_selection_pressed && icon_view->priv->selection_mode != GTK_SELECTION_NONE) { dirty = gtk_icon_view_unselect_all_internal (icon_view); dirty = gtk_icon_view_select_all_between (icon_view, icon_view->priv->anchor_item, item) || dirty; } gtk_icon_view_scroll_to_item (icon_view, item); if (dirty) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); } /** * gtk_icon_view_scroll_to_path: * @icon_view: A #GtkIconView. * @path: The path of the item to move to. * @use_align: whether to use alignment arguments, or %FALSE. * @row_align: The vertical alignment of the item specified by @path. * @col_align: The horizontal alignment of the item specified by @path. * * Moves the alignments of @icon_view to the position specified by @path. * @row_align determines where the row is placed, and @col_align determines * where @column is placed. Both are expected to be between 0.0 and 1.0. * 0.0 means left/top alignment, 1.0 means right/bottom alignment, 0.5 means * center. * * If @use_align is %FALSE, then the alignment arguments are ignored, and the * tree does the minimum amount of work to scroll the item onto the screen. * This means that the item will be scrolled to the edge closest to its current * position. If the item is currently visible on the screen, nothing is done. * * This function only works if the model is set, and @path is a valid row on * the model. If the model changes before the @icon_view is realized, the * centered path will be modified to reflect this change. **/ void gtk_icon_view_scroll_to_path (GtkIconView *icon_view, GtkTreePath *path, gboolean use_align, float row_align, float col_align) { GtkIconViewItem *item = NULL; GtkWidget *widget; g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (path != NULL); g_return_if_fail (row_align >= 0.0 && row_align <= 1.0); g_return_if_fail (col_align >= 0.0 && col_align <= 1.0); widget = GTK_WIDGET (icon_view); if (gtk_tree_path_get_depth (path) > 0) item = g_list_nth_data (icon_view->priv->items, gtk_tree_path_get_indices(path)[0]); if (!item || item->cell_area.width < 0 || !gtk_widget_get_realized (widget)) { if (icon_view->priv->scroll_to_path) gtk_tree_row_reference_free (icon_view->priv->scroll_to_path); icon_view->priv->scroll_to_path = NULL; if (path) icon_view->priv->scroll_to_path = gtk_tree_row_reference_new_proxy (G_OBJECT (icon_view), icon_view->priv->model, path); icon_view->priv->scroll_to_use_align = use_align; icon_view->priv->scroll_to_row_align = row_align; icon_view->priv->scroll_to_col_align = col_align; return; } if (use_align) { int width, height; int x, y; float offset; GdkRectangle item_area = { item->cell_area.x - icon_view->priv->item_padding, item->cell_area.y - icon_view->priv->item_padding, item->cell_area.width + icon_view->priv->item_padding * 2, item->cell_area.height + icon_view->priv->item_padding * 2 }; x =0; y =0; width = gtk_widget_get_width (widget); height = gtk_widget_get_height (widget); offset = y + item_area.y - row_align * (height - item_area.height); gtk_adjustment_set_value (icon_view->priv->vadjustment, gtk_adjustment_get_value (icon_view->priv->vadjustment) + offset); offset = x + item_area.x - col_align * (width - item_area.width); gtk_adjustment_set_value (icon_view->priv->hadjustment, gtk_adjustment_get_value (icon_view->priv->hadjustment) + offset); } else gtk_icon_view_scroll_to_item (icon_view, item); } static void gtk_icon_view_scroll_to_item (GtkIconView *icon_view, GtkIconViewItem *item) { GtkIconViewPrivate *priv = icon_view->priv; GtkWidget *widget = GTK_WIDGET (icon_view); GtkAdjustment *hadj, *vadj; int widget_width, widget_height; int x, y; GdkRectangle item_area; item_area.x = item->cell_area.x - priv->item_padding; item_area.y = item->cell_area.y - priv->item_padding; item_area.width = item->cell_area.width + priv->item_padding * 2; item_area.height = item->cell_area.height + priv->item_padding * 2; widget_width = gtk_widget_get_width (widget); widget_height = gtk_widget_get_height (widget); hadj = icon_view->priv->hadjustment; vadj = icon_view->priv->vadjustment; x = - gtk_adjustment_get_value (hadj); y = - gtk_adjustment_get_value (vadj); if (y + item_area.y < 0) gtk_adjustment_animate_to_value (vadj, gtk_adjustment_get_value (vadj) + y + item_area.y); else if (y + item_area.y + item_area.height > widget_height) gtk_adjustment_animate_to_value (vadj, gtk_adjustment_get_value (vadj) + y + item_area.y + item_area.height - widget_height); if (x + item_area.x < 0) gtk_adjustment_animate_to_value (hadj, gtk_adjustment_get_value (hadj) + x + item_area.x); else if (x + item_area.x + item_area.width > widget_width) gtk_adjustment_animate_to_value (hadj, gtk_adjustment_get_value (hadj) + x + item_area.x + item_area.width - widget_width); } /* GtkCellLayout implementation */ static void gtk_icon_view_ensure_cell_area (GtkIconView *icon_view, GtkCellArea *cell_area) { GtkIconViewPrivate *priv = icon_view->priv; if (priv->cell_area) return; if (cell_area) priv->cell_area = cell_area; else priv->cell_area = gtk_cell_area_box_new (); g_object_ref_sink (priv->cell_area); if (GTK_IS_ORIENTABLE (priv->cell_area)) gtk_orientable_set_orientation (GTK_ORIENTABLE (priv->cell_area), priv->item_orientation); priv->cell_area_context = gtk_cell_area_create_context (priv->cell_area); priv->add_editable_id = g_signal_connect (priv->cell_area, "add-editable", G_CALLBACK (gtk_icon_view_add_editable), icon_view); priv->remove_editable_id = g_signal_connect (priv->cell_area, "remove-editable", G_CALLBACK (gtk_icon_view_remove_editable), icon_view); update_text_cell (icon_view); update_pixbuf_cell (icon_view); } static GtkCellArea * gtk_icon_view_cell_layout_get_area (GtkCellLayout *cell_layout) { GtkIconView *icon_view = GTK_ICON_VIEW (cell_layout); GtkIconViewPrivate *priv = icon_view->priv; if (G_UNLIKELY (!priv->cell_area)) gtk_icon_view_ensure_cell_area (icon_view, NULL); return icon_view->priv->cell_area; } void _gtk_icon_view_set_cell_data (GtkIconView *icon_view, GtkIconViewItem *item) { GtkTreeIter iter; GtkTreePath *path; path = gtk_tree_path_new_from_indices (item->index, -1); if (!gtk_tree_model_get_iter (icon_view->priv->model, &iter, path)) return; gtk_tree_path_free (path); gtk_cell_area_apply_attributes (icon_view->priv->cell_area, icon_view->priv->model, &iter, FALSE, FALSE); } /* Public API */ /** * gtk_icon_view_new: * * Creates a new #GtkIconView widget * * Returns: A newly created #GtkIconView widget **/ GtkWidget * gtk_icon_view_new (void) { return g_object_new (GTK_TYPE_ICON_VIEW, NULL); } /** * gtk_icon_view_new_with_area: * @area: the #GtkCellArea to use to layout cells * * Creates a new #GtkIconView widget using the * specified @area to layout cells inside the icons. * * Returns: A newly created #GtkIconView widget **/ GtkWidget * gtk_icon_view_new_with_area (GtkCellArea *area) { return g_object_new (GTK_TYPE_ICON_VIEW, "cell-area", area, NULL); } /** * gtk_icon_view_new_with_model: * @model: The model. * * Creates a new #GtkIconView widget with the model @model. * * Returns: A newly created #GtkIconView widget. **/ GtkWidget * gtk_icon_view_new_with_model (GtkTreeModel *model) { return g_object_new (GTK_TYPE_ICON_VIEW, "model", model, NULL); } /** * gtk_icon_view_get_path_at_pos: * @icon_view: A #GtkIconView. * @x: The x position to be identified * @y: The y position to be identified * * Returns: (nullable) (transfer full): The #GtkTreePath corresponding * to the icon or %NULL if no icon exists at that position. **/ GtkTreePath * gtk_icon_view_get_path_at_pos (GtkIconView *icon_view, int x, int y) { GtkIconViewItem *item; GtkTreePath *path; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), NULL); item = _gtk_icon_view_get_item_at_coords (icon_view, x, y, TRUE, NULL); if (!item) return NULL; path = gtk_tree_path_new_from_indices (item->index, -1); return path; } /** * gtk_icon_view_get_item_at_pos: * @icon_view: A #GtkIconView. * @x: The x position to be identified * @y: The y position to be identified * @path: (out) (allow-none): Return location for the path, or %NULL * @cell: (out) (allow-none) (transfer none): Return location for the renderer * responsible for the cell at (@x, @y), or %NULL * * Returns: %TRUE if an item exists at the specified position **/ gboolean gtk_icon_view_get_item_at_pos (GtkIconView *icon_view, int x, int y, GtkTreePath **path, GtkCellRenderer **cell) { GtkIconViewItem *item; GtkCellRenderer *renderer = NULL; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE); item = _gtk_icon_view_get_item_at_coords (icon_view, x, y, TRUE, &renderer); if (path != NULL) { if (item != NULL) *path = gtk_tree_path_new_from_indices (item->index, -1); else *path = NULL; } if (cell != NULL) *cell = renderer; return (item != NULL); } /** * gtk_icon_view_get_cell_rect: * @icon_view: a #GtkIconView * @path: a #GtkTreePath * @cell: (allow-none): a #GtkCellRenderer or %NULL * @rect: (out): rectangle to fill with cell rect * * Fills the bounding rectangle in widget coordinates for the cell specified by * @path and @cell. If @cell is %NULL the main cell area is used. * * This function is only valid if @icon_view is realized. * * Returns: %FALSE if there is no such item, %TRUE otherwise */ gboolean gtk_icon_view_get_cell_rect (GtkIconView *icon_view, GtkTreePath *path, GtkCellRenderer *cell, GdkRectangle *rect) { GtkIconViewItem *item = NULL; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE); g_return_val_if_fail (cell == NULL || GTK_IS_CELL_RENDERER (cell), FALSE); if (gtk_tree_path_get_depth (path) > 0) item = g_list_nth_data (icon_view->priv->items, gtk_tree_path_get_indices(path)[0]); if (!item) return FALSE; if (cell) { GtkCellAreaContext *context; context = g_ptr_array_index (icon_view->priv->row_contexts, item->row); _gtk_icon_view_set_cell_data (icon_view, item); gtk_cell_area_get_cell_allocation (icon_view->priv->cell_area, context, GTK_WIDGET (icon_view), cell, &item->cell_area, rect); } else { rect->x = item->cell_area.x - icon_view->priv->item_padding; rect->y = item->cell_area.y - icon_view->priv->item_padding; rect->width = item->cell_area.width + icon_view->priv->item_padding * 2; rect->height = item->cell_area.height + icon_view->priv->item_padding * 2; } return TRUE; } /** * gtk_icon_view_set_tooltip_item: * @icon_view: a #GtkIconView * @tooltip: a #GtkTooltip * @path: a #GtkTreePath * * Sets the tip area of @tooltip to be the area covered by the item at @path. * See also gtk_icon_view_set_tooltip_column() for a simpler alternative. * See also gtk_tooltip_set_tip_area(). */ void gtk_icon_view_set_tooltip_item (GtkIconView *icon_view, GtkTooltip *tooltip, GtkTreePath *path) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (GTK_IS_TOOLTIP (tooltip)); gtk_icon_view_set_tooltip_cell (icon_view, tooltip, path, NULL); } /** * gtk_icon_view_set_tooltip_cell: * @icon_view: a #GtkIconView * @tooltip: a #GtkTooltip * @path: a #GtkTreePath * @cell: (allow-none): a #GtkCellRenderer or %NULL * * Sets the tip area of @tooltip to the area which @cell occupies in * the item pointed to by @path. See also gtk_tooltip_set_tip_area(). * * See also gtk_icon_view_set_tooltip_column() for a simpler alternative. */ void gtk_icon_view_set_tooltip_cell (GtkIconView *icon_view, GtkTooltip *tooltip, GtkTreePath *path, GtkCellRenderer *cell) { GdkRectangle rect; g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (GTK_IS_TOOLTIP (tooltip)); g_return_if_fail (cell == NULL || GTK_IS_CELL_RENDERER (cell)); if (!gtk_icon_view_get_cell_rect (icon_view, path, cell, &rect)) return; gtk_tooltip_set_tip_area (tooltip, &rect); } /** * gtk_icon_view_get_tooltip_context: * @icon_view: an #GtkIconView * @x: (inout): the x coordinate (relative to widget coordinates) * @y: (inout): the y coordinate (relative to widget coordinates) * @keyboard_tip: whether this is a keyboard tooltip or not * @model: (out) (allow-none) (transfer none): a pointer to receive a * #GtkTreeModel or %NULL * @path: (out) (allow-none): a pointer to receive a #GtkTreePath or %NULL * @iter: (out) (allow-none): a pointer to receive a #GtkTreeIter or %NULL * * This function is supposed to be used in a #GtkWidget::query-tooltip * signal handler for #GtkIconView. The @x, @y and @keyboard_tip values * which are received in the signal handler, should be passed to this * function without modification. * * The return value indicates whether there is an icon view item at the given * coordinates (%TRUE) or not (%FALSE) for mouse tooltips. For keyboard * tooltips the item returned will be the cursor item. When %TRUE, then any of * @model, @path and @iter which have been provided will be set to point to * that row and the corresponding model. * * Returns: whether or not the given tooltip context points to an item */ gboolean gtk_icon_view_get_tooltip_context (GtkIconView *icon_view, int *x, int *y, gboolean keyboard_tip, GtkTreeModel **model, GtkTreePath **path, GtkTreeIter *iter) { GtkTreePath *tmppath = NULL; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE); g_return_val_if_fail (x != NULL, FALSE); g_return_val_if_fail (y != NULL, FALSE); if (keyboard_tip) { gtk_icon_view_get_cursor (icon_view, &tmppath, NULL); if (!tmppath) return FALSE; } else { if (!gtk_icon_view_get_item_at_pos (icon_view, *x, *y, &tmppath, NULL)) return FALSE; } if (model) *model = gtk_icon_view_get_model (icon_view); if (iter) gtk_tree_model_get_iter (gtk_icon_view_get_model (icon_view), iter, tmppath); if (path) *path = tmppath; else gtk_tree_path_free (tmppath); return TRUE; } static gboolean gtk_icon_view_set_tooltip_query_cb (GtkWidget *widget, int x, int y, gboolean keyboard_tip, GtkTooltip *tooltip, gpointer data) { char *str; GtkTreeIter iter; GtkTreePath *path; GtkTreeModel *model; GtkIconView *icon_view = GTK_ICON_VIEW (widget); if (!gtk_icon_view_get_tooltip_context (GTK_ICON_VIEW (widget), &x, &y, keyboard_tip, &model, &path, &iter)) return FALSE; gtk_tree_model_get (model, &iter, icon_view->priv->tooltip_column, &str, -1); if (!str) { gtk_tree_path_free (path); return FALSE; } gtk_tooltip_set_markup (tooltip, str); gtk_icon_view_set_tooltip_item (icon_view, tooltip, path); gtk_tree_path_free (path); g_free (str); return TRUE; } /** * gtk_icon_view_set_tooltip_column: * @icon_view: a #GtkIconView * @column: an integer, which is a valid column number for @icon_view’s model * * If you only plan to have simple (text-only) tooltips on full items, you * can use this function to have #GtkIconView handle these automatically * for you. @column should be set to the column in @icon_view’s model * containing the tooltip texts, or -1 to disable this feature. * * When enabled, #GtkWidget:has-tooltip will be set to %TRUE and * @icon_view will connect a #GtkWidget::query-tooltip signal handler. * * Note that the signal handler sets the text with gtk_tooltip_set_markup(), * so &, <, etc have to be escaped in the text. */ void gtk_icon_view_set_tooltip_column (GtkIconView *icon_view, int column) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (column == icon_view->priv->tooltip_column) return; if (column == -1) { g_signal_handlers_disconnect_by_func (icon_view, gtk_icon_view_set_tooltip_query_cb, NULL); gtk_widget_set_has_tooltip (GTK_WIDGET (icon_view), FALSE); } else { if (icon_view->priv->tooltip_column == -1) { g_signal_connect (icon_view, "query-tooltip", G_CALLBACK (gtk_icon_view_set_tooltip_query_cb), NULL); gtk_widget_set_has_tooltip (GTK_WIDGET (icon_view), TRUE); } } icon_view->priv->tooltip_column = column; g_object_notify (G_OBJECT (icon_view), "tooltip-column"); } /** * gtk_icon_view_get_tooltip_column: * @icon_view: a #GtkIconView * * Returns the column of @icon_view’s model which is being used for * displaying tooltips on @icon_view’s rows. * * Returns: the index of the tooltip column that is currently being * used, or -1 if this is disabled. */ int gtk_icon_view_get_tooltip_column (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), 0); return icon_view->priv->tooltip_column; } /** * gtk_icon_view_get_visible_range: * @icon_view: A #GtkIconView * @start_path: (out) (allow-none): Return location for start of region, * or %NULL * @end_path: (out) (allow-none): Return location for end of region, or %NULL * * Sets @start_path and @end_path to be the first and last visible path. * Note that there may be invisible paths in between. * * Both paths should be freed with gtk_tree_path_free() after use. * * Returns: %TRUE, if valid paths were placed in @start_path and @end_path **/ gboolean gtk_icon_view_get_visible_range (GtkIconView *icon_view, GtkTreePath **start_path, GtkTreePath **end_path) { int start_index = -1; int end_index = -1; GList *icons; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE); if (icon_view->priv->hadjustment == NULL || icon_view->priv->vadjustment == NULL) return FALSE; if (start_path == NULL && end_path == NULL) return FALSE; for (icons = icon_view->priv->items; icons; icons = icons->next) { GtkIconViewItem *item = icons->data; GdkRectangle *item_area = &item->cell_area; if ((item_area->x + item_area->width >= (int)gtk_adjustment_get_value (icon_view->priv->hadjustment)) && (item_area->y + item_area->height >= (int)gtk_adjustment_get_value (icon_view->priv->vadjustment)) && (item_area->x <= (int) (gtk_adjustment_get_value (icon_view->priv->hadjustment) + gtk_adjustment_get_page_size (icon_view->priv->hadjustment))) && (item_area->y <= (int) (gtk_adjustment_get_value (icon_view->priv->vadjustment) + gtk_adjustment_get_page_size (icon_view->priv->vadjustment)))) { if (start_index == -1) start_index = item->index; end_index = item->index; } } if (start_path && start_index != -1) *start_path = gtk_tree_path_new_from_indices (start_index, -1); if (end_path && end_index != -1) *end_path = gtk_tree_path_new_from_indices (end_index, -1); return start_index != -1; } /** * gtk_icon_view_selected_foreach: * @icon_view: A #GtkIconView. * @func: (scope call): The function to call for each selected icon. * @data: User data to pass to the function. * * Calls a function for each selected icon. Note that the model or * selection cannot be modified from within this function. **/ void gtk_icon_view_selected_foreach (GtkIconView *icon_view, GtkIconViewForeachFunc func, gpointer data) { GList *list; for (list = icon_view->priv->items; list; list = list->next) { GtkIconViewItem *item = list->data; GtkTreePath *path = gtk_tree_path_new_from_indices (item->index, -1); if (item->selected) (* func) (icon_view, path, data); gtk_tree_path_free (path); } } /** * gtk_icon_view_set_selection_mode: * @icon_view: A #GtkIconView. * @mode: The selection mode * * Sets the selection mode of the @icon_view. **/ void gtk_icon_view_set_selection_mode (GtkIconView *icon_view, GtkSelectionMode mode) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (mode == icon_view->priv->selection_mode) return; if (mode == GTK_SELECTION_NONE || icon_view->priv->selection_mode == GTK_SELECTION_MULTIPLE) gtk_icon_view_unselect_all (icon_view); icon_view->priv->selection_mode = mode; g_object_notify (G_OBJECT (icon_view), "selection-mode"); } /** * gtk_icon_view_get_selection_mode: * @icon_view: A #GtkIconView. * * Gets the selection mode of the @icon_view. * * Returns: the current selection mode **/ GtkSelectionMode gtk_icon_view_get_selection_mode (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), GTK_SELECTION_SINGLE); return icon_view->priv->selection_mode; } /** * gtk_icon_view_set_model: * @icon_view: A #GtkIconView. * @model: (allow-none): The model. * * Sets the model for a #GtkIconView. * If the @icon_view already has a model set, it will remove * it before setting the new model. If @model is %NULL, then * it will unset the old model. **/ void gtk_icon_view_set_model (GtkIconView *icon_view, GtkTreeModel *model) { gboolean dirty; g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (model == NULL || GTK_IS_TREE_MODEL (model)); if (icon_view->priv->model == model) return; if (icon_view->priv->scroll_to_path) { gtk_tree_row_reference_free (icon_view->priv->scroll_to_path); icon_view->priv->scroll_to_path = NULL; } /* The area can be NULL while disposing */ if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); dirty = gtk_icon_view_unselect_all_internal (icon_view); if (model) { if (icon_view->priv->pixbuf_column != -1) { g_return_if_fail (gtk_tree_model_get_column_type (model, icon_view->priv->pixbuf_column) == GDK_TYPE_PIXBUF); } if (icon_view->priv->text_column != -1) { g_return_if_fail (gtk_tree_model_get_column_type (model, icon_view->priv->text_column) == G_TYPE_STRING); } if (icon_view->priv->markup_column != -1) { g_return_if_fail (gtk_tree_model_get_column_type (model, icon_view->priv->markup_column) == G_TYPE_STRING); } } if (icon_view->priv->model) { g_signal_handlers_disconnect_by_func (icon_view->priv->model, gtk_icon_view_row_changed, icon_view); g_signal_handlers_disconnect_by_func (icon_view->priv->model, gtk_icon_view_row_inserted, icon_view); g_signal_handlers_disconnect_by_func (icon_view->priv->model, gtk_icon_view_row_deleted, icon_view); g_signal_handlers_disconnect_by_func (icon_view->priv->model, gtk_icon_view_rows_reordered, icon_view); g_object_unref (icon_view->priv->model); g_list_free_full (icon_view->priv->items, (GDestroyNotify) gtk_icon_view_item_free); icon_view->priv->items = NULL; icon_view->priv->anchor_item = NULL; icon_view->priv->cursor_item = NULL; icon_view->priv->last_single_clicked = NULL; icon_view->priv->last_prelight = NULL; icon_view->priv->width = 0; icon_view->priv->height = 0; } icon_view->priv->model = model; if (icon_view->priv->model) { g_object_ref (icon_view->priv->model); g_signal_connect (icon_view->priv->model, "row-changed", G_CALLBACK (gtk_icon_view_row_changed), icon_view); g_signal_connect (icon_view->priv->model, "row-inserted", G_CALLBACK (gtk_icon_view_row_inserted), icon_view); g_signal_connect (icon_view->priv->model, "row-deleted", G_CALLBACK (gtk_icon_view_row_deleted), icon_view); g_signal_connect (icon_view->priv->model, "rows-reordered", G_CALLBACK (gtk_icon_view_rows_reordered), icon_view); gtk_icon_view_build_items (icon_view); } g_object_notify (G_OBJECT (icon_view), "model"); if (dirty) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); gtk_widget_queue_resize (GTK_WIDGET (icon_view)); } /** * gtk_icon_view_get_model: * @icon_view: a #GtkIconView * * Returns the model the #GtkIconView is based on. Returns %NULL if the * model is unset. * * Returns: (nullable) (transfer none): A #GtkTreeModel, or %NULL if none is * currently being used. **/ GtkTreeModel * gtk_icon_view_get_model (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), NULL); return icon_view->priv->model; } static void update_text_cell (GtkIconView *icon_view) { if (!icon_view->priv->cell_area) return; if (icon_view->priv->text_column == -1 && icon_view->priv->markup_column == -1) { if (icon_view->priv->text_cell != NULL) { gtk_cell_area_remove (icon_view->priv->cell_area, icon_view->priv->text_cell); icon_view->priv->text_cell = NULL; } } else { if (icon_view->priv->text_cell == NULL) { icon_view->priv->text_cell = gtk_cell_renderer_text_new (); gtk_cell_layout_pack_end (GTK_CELL_LAYOUT (icon_view), icon_view->priv->text_cell, FALSE); } if (icon_view->priv->markup_column != -1) gtk_cell_layout_set_attributes (GTK_CELL_LAYOUT (icon_view), icon_view->priv->text_cell, "markup", icon_view->priv->markup_column, NULL); else gtk_cell_layout_set_attributes (GTK_CELL_LAYOUT (icon_view), icon_view->priv->text_cell, "text", icon_view->priv->text_column, NULL); if (icon_view->priv->item_orientation == GTK_ORIENTATION_VERTICAL) g_object_set (icon_view->priv->text_cell, "alignment", PANGO_ALIGN_CENTER, "wrap-mode", PANGO_WRAP_WORD_CHAR, "xalign", 0.5, "yalign", 0.0, NULL); else g_object_set (icon_view->priv->text_cell, "alignment", PANGO_ALIGN_LEFT, "wrap-mode", PANGO_WRAP_WORD_CHAR, "xalign", 0.0, "yalign", 0.5, NULL); } } static void update_pixbuf_cell (GtkIconView *icon_view) { if (!icon_view->priv->cell_area) return; if (icon_view->priv->pixbuf_column == -1) { if (icon_view->priv->pixbuf_cell != NULL) { gtk_cell_area_remove (icon_view->priv->cell_area, icon_view->priv->pixbuf_cell); icon_view->priv->pixbuf_cell = NULL; } } else { if (icon_view->priv->pixbuf_cell == NULL) { icon_view->priv->pixbuf_cell = gtk_cell_renderer_pixbuf_new (); gtk_cell_layout_pack_start (GTK_CELL_LAYOUT (icon_view), icon_view->priv->pixbuf_cell, FALSE); } gtk_cell_layout_set_attributes (GTK_CELL_LAYOUT (icon_view), icon_view->priv->pixbuf_cell, "pixbuf", icon_view->priv->pixbuf_column, NULL); if (icon_view->priv->item_orientation == GTK_ORIENTATION_VERTICAL) g_object_set (icon_view->priv->pixbuf_cell, "xalign", 0.5, "yalign", 1.0, NULL); else g_object_set (icon_view->priv->pixbuf_cell, "xalign", 0.0, "yalign", 0.0, NULL); } } /** * gtk_icon_view_set_text_column: * @icon_view: A #GtkIconView. * @column: A column in the currently used model, or -1 to display no text * * Sets the column with text for @icon_view to be @column. The text * column must be of type #G_TYPE_STRING. **/ void gtk_icon_view_set_text_column (GtkIconView *icon_view, int column) { if (column == icon_view->priv->text_column) return; if (column == -1) icon_view->priv->text_column = -1; else { if (icon_view->priv->model != NULL) { g_return_if_fail (gtk_tree_model_get_column_type (icon_view->priv->model, column) == G_TYPE_STRING); } icon_view->priv->text_column = column; } if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); update_text_cell (icon_view); gtk_icon_view_invalidate_sizes (icon_view); g_object_notify (G_OBJECT (icon_view), "text-column"); } /** * gtk_icon_view_get_text_column: * @icon_view: A #GtkIconView. * * Returns the column with text for @icon_view. * * Returns: the text column, or -1 if it’s unset. */ int gtk_icon_view_get_text_column (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->text_column; } /** * gtk_icon_view_set_markup_column: * @icon_view: A #GtkIconView. * @column: A column in the currently used model, or -1 to display no text * * Sets the column with markup information for @icon_view to be * @column. The markup column must be of type #G_TYPE_STRING. * If the markup column is set to something, it overrides * the text column set by gtk_icon_view_set_text_column(). **/ void gtk_icon_view_set_markup_column (GtkIconView *icon_view, int column) { if (column == icon_view->priv->markup_column) return; if (column == -1) icon_view->priv->markup_column = -1; else { if (icon_view->priv->model != NULL) { g_return_if_fail (gtk_tree_model_get_column_type (icon_view->priv->model, column) == G_TYPE_STRING); } icon_view->priv->markup_column = column; } if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); update_text_cell (icon_view); gtk_icon_view_invalidate_sizes (icon_view); g_object_notify (G_OBJECT (icon_view), "markup-column"); } /** * gtk_icon_view_get_markup_column: * @icon_view: A #GtkIconView. * * Returns the column with markup text for @icon_view. * * Returns: the markup column, or -1 if it’s unset. */ int gtk_icon_view_get_markup_column (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->markup_column; } /** * gtk_icon_view_set_pixbuf_column: * @icon_view: A #GtkIconView. * @column: A column in the currently used model, or -1 to disable * * Sets the column with pixbufs for @icon_view to be @column. The pixbuf * column must be of type #GDK_TYPE_PIXBUF **/ void gtk_icon_view_set_pixbuf_column (GtkIconView *icon_view, int column) { if (column == icon_view->priv->pixbuf_column) return; if (column == -1) icon_view->priv->pixbuf_column = -1; else { if (icon_view->priv->model != NULL) { g_return_if_fail (gtk_tree_model_get_column_type (icon_view->priv->model, column) == GDK_TYPE_PIXBUF); } icon_view->priv->pixbuf_column = column; } if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); update_pixbuf_cell (icon_view); gtk_icon_view_invalidate_sizes (icon_view); g_object_notify (G_OBJECT (icon_view), "pixbuf-column"); } /** * gtk_icon_view_get_pixbuf_column: * @icon_view: A #GtkIconView. * * Returns the column with pixbufs for @icon_view. * * Returns: the pixbuf column, or -1 if it’s unset. */ int gtk_icon_view_get_pixbuf_column (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->pixbuf_column; } /** * gtk_icon_view_select_path: * @icon_view: A #GtkIconView. * @path: The #GtkTreePath to be selected. * * Selects the row at @path. **/ void gtk_icon_view_select_path (GtkIconView *icon_view, GtkTreePath *path) { GtkIconViewItem *item = NULL; g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (icon_view->priv->model != NULL); g_return_if_fail (path != NULL); if (gtk_tree_path_get_depth (path) > 0) item = g_list_nth_data (icon_view->priv->items, gtk_tree_path_get_indices(path)[0]); if (item) _gtk_icon_view_select_item (icon_view, item); } /** * gtk_icon_view_unselect_path: * @icon_view: A #GtkIconView. * @path: The #GtkTreePath to be unselected. * * Unselects the row at @path. **/ void gtk_icon_view_unselect_path (GtkIconView *icon_view, GtkTreePath *path) { GtkIconViewItem *item; g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (icon_view->priv->model != NULL); g_return_if_fail (path != NULL); item = g_list_nth_data (icon_view->priv->items, gtk_tree_path_get_indices(path)[0]); if (!item) return; _gtk_icon_view_unselect_item (icon_view, item); } /** * gtk_icon_view_get_selected_items: * @icon_view: A #GtkIconView. * * Creates a list of paths of all selected items. Additionally, if you are * planning on modifying the model after calling this function, you may * want to convert the returned list into a list of #GtkTreeRowReferences. * To do this, you can use gtk_tree_row_reference_new(). * * To free the return value, use: * |[ * g_list_free_full (list, (GDestroyNotify) gtk_tree_path_free); * ]| * * Returns: (element-type GtkTreePath) (transfer full): A #GList containing a #GtkTreePath for each selected row. **/ GList * gtk_icon_view_get_selected_items (GtkIconView *icon_view) { GList *list; GList *selected = NULL; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), NULL); for (list = icon_view->priv->items; list != NULL; list = list->next) { GtkIconViewItem *item = list->data; if (item->selected) { GtkTreePath *path = gtk_tree_path_new_from_indices (item->index, -1); selected = g_list_prepend (selected, path); } } return selected; } /** * gtk_icon_view_select_all: * @icon_view: A #GtkIconView. * * Selects all the icons. @icon_view must has its selection mode set * to #GTK_SELECTION_MULTIPLE. **/ void gtk_icon_view_select_all (GtkIconView *icon_view) { GList *items; gboolean dirty = FALSE; g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE) return; for (items = icon_view->priv->items; items; items = items->next) { GtkIconViewItem *item = items->data; if (!item->selected) { dirty = TRUE; item->selected = TRUE; gtk_icon_view_queue_draw_item (icon_view, item); } } if (dirty) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); } /** * gtk_icon_view_unselect_all: * @icon_view: A #GtkIconView. * * Unselects all the icons. **/ void gtk_icon_view_unselect_all (GtkIconView *icon_view) { gboolean dirty = FALSE; g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->selection_mode == GTK_SELECTION_BROWSE) return; dirty = gtk_icon_view_unselect_all_internal (icon_view); if (dirty) g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0); } /** * gtk_icon_view_path_is_selected: * @icon_view: A #GtkIconView. * @path: A #GtkTreePath to check selection on. * * Returns %TRUE if the icon pointed to by @path is currently * selected. If @path does not point to a valid location, %FALSE is returned. * * Returns: %TRUE if @path is selected. **/ gboolean gtk_icon_view_path_is_selected (GtkIconView *icon_view, GtkTreePath *path) { GtkIconViewItem *item; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE); g_return_val_if_fail (icon_view->priv->model != NULL, FALSE); g_return_val_if_fail (path != NULL, FALSE); item = g_list_nth_data (icon_view->priv->items, gtk_tree_path_get_indices(path)[0]); if (!item) return FALSE; return item->selected; } /** * gtk_icon_view_get_item_row: * @icon_view: a #GtkIconView * @path: the #GtkTreePath of the item * * Gets the row in which the item @path is currently * displayed. Row numbers start at 0. * * Returns: The row in which the item is displayed */ int gtk_icon_view_get_item_row (GtkIconView *icon_view, GtkTreePath *path) { GtkIconViewItem *item; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); g_return_val_if_fail (icon_view->priv->model != NULL, -1); g_return_val_if_fail (path != NULL, -1); item = g_list_nth_data (icon_view->priv->items, gtk_tree_path_get_indices(path)[0]); if (!item) return -1; return item->row; } /** * gtk_icon_view_get_item_column: * @icon_view: a #GtkIconView * @path: the #GtkTreePath of the item * * Gets the column in which the item @path is currently * displayed. Column numbers start at 0. * * Returns: The column in which the item is displayed */ int gtk_icon_view_get_item_column (GtkIconView *icon_view, GtkTreePath *path) { GtkIconViewItem *item; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); g_return_val_if_fail (icon_view->priv->model != NULL, -1); g_return_val_if_fail (path != NULL, -1); item = g_list_nth_data (icon_view->priv->items, gtk_tree_path_get_indices(path)[0]); if (!item) return -1; return item->col; } /** * gtk_icon_view_item_activated: * @icon_view: A #GtkIconView * @path: The #GtkTreePath to be activated * * Activates the item determined by @path. **/ void gtk_icon_view_item_activated (GtkIconView *icon_view, GtkTreePath *path) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); g_return_if_fail (path != NULL); g_signal_emit (icon_view, icon_view_signals[ITEM_ACTIVATED], 0, path); } /** * gtk_icon_view_set_item_orientation: * @icon_view: a #GtkIconView * @orientation: the relative position of texts and icons * * Sets the ::item-orientation property which determines whether the labels * are drawn beside the icons instead of below. **/ void gtk_icon_view_set_item_orientation (GtkIconView *icon_view, GtkOrientation orientation) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->item_orientation != orientation) { icon_view->priv->item_orientation = orientation; if (icon_view->priv->cell_area) { if (GTK_IS_ORIENTABLE (icon_view->priv->cell_area)) gtk_orientable_set_orientation (GTK_ORIENTABLE (icon_view->priv->cell_area), icon_view->priv->item_orientation); gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); } gtk_icon_view_invalidate_sizes (icon_view); update_text_cell (icon_view); update_pixbuf_cell (icon_view); g_object_notify (G_OBJECT (icon_view), "item-orientation"); } } /** * gtk_icon_view_get_item_orientation: * @icon_view: a #GtkIconView * * Returns the value of the ::item-orientation property which determines * whether the labels are drawn beside the icons instead of below. * * Returns: the relative position of texts and icons **/ GtkOrientation gtk_icon_view_get_item_orientation (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), GTK_ORIENTATION_VERTICAL); return icon_view->priv->item_orientation; } /** * gtk_icon_view_set_columns: * @icon_view: a #GtkIconView * @columns: the number of columns * * Sets the ::columns property which determines in how * many columns the icons are arranged. If @columns is * -1, the number of columns will be chosen automatically * to fill the available area. */ void gtk_icon_view_set_columns (GtkIconView *icon_view, int columns) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->columns != columns) { icon_view->priv->columns = columns; if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); gtk_widget_queue_resize (GTK_WIDGET (icon_view)); g_object_notify (G_OBJECT (icon_view), "columns"); } } /** * gtk_icon_view_get_columns: * @icon_view: a #GtkIconView * * Returns the value of the ::columns property. * * Returns: the number of columns, or -1 */ int gtk_icon_view_get_columns (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->columns; } /** * gtk_icon_view_set_item_width: * @icon_view: a #GtkIconView * @item_width: the width for each item * * Sets the ::item-width property which specifies the width * to use for each item. If it is set to -1, the icon view will * automatically determine a suitable item size. */ void gtk_icon_view_set_item_width (GtkIconView *icon_view, int item_width) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->item_width != item_width) { icon_view->priv->item_width = item_width; if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); gtk_icon_view_invalidate_sizes (icon_view); update_text_cell (icon_view); g_object_notify (G_OBJECT (icon_view), "item-width"); } } /** * gtk_icon_view_get_item_width: * @icon_view: a #GtkIconView * * Returns the value of the ::item-width property. * * Returns: the width of a single item, or -1 */ int gtk_icon_view_get_item_width (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->item_width; } /** * gtk_icon_view_set_spacing: * @icon_view: a #GtkIconView * @spacing: the spacing * * Sets the ::spacing property which specifies the space * which is inserted between the cells (i.e. the icon and * the text) of an item. */ void gtk_icon_view_set_spacing (GtkIconView *icon_view, int spacing) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->spacing != spacing) { icon_view->priv->spacing = spacing; if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); gtk_icon_view_invalidate_sizes (icon_view); g_object_notify (G_OBJECT (icon_view), "spacing"); } } /** * gtk_icon_view_get_spacing: * @icon_view: a #GtkIconView * * Returns the value of the ::spacing property. * * Returns: the space between cells */ int gtk_icon_view_get_spacing (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->spacing; } /** * gtk_icon_view_set_row_spacing: * @icon_view: a #GtkIconView * @row_spacing: the row spacing * * Sets the ::row-spacing property which specifies the space * which is inserted between the rows of the icon view. */ void gtk_icon_view_set_row_spacing (GtkIconView *icon_view, int row_spacing) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->row_spacing != row_spacing) { icon_view->priv->row_spacing = row_spacing; if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); gtk_icon_view_invalidate_sizes (icon_view); g_object_notify (G_OBJECT (icon_view), "row-spacing"); } } /** * gtk_icon_view_get_row_spacing: * @icon_view: a #GtkIconView * * Returns the value of the ::row-spacing property. * * Returns: the space between rows */ int gtk_icon_view_get_row_spacing (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->row_spacing; } /** * gtk_icon_view_set_column_spacing: * @icon_view: a #GtkIconView * @column_spacing: the column spacing * * Sets the ::column-spacing property which specifies the space * which is inserted between the columns of the icon view. */ void gtk_icon_view_set_column_spacing (GtkIconView *icon_view, int column_spacing) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->column_spacing != column_spacing) { icon_view->priv->column_spacing = column_spacing; if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); gtk_icon_view_invalidate_sizes (icon_view); g_object_notify (G_OBJECT (icon_view), "column-spacing"); } } /** * gtk_icon_view_get_column_spacing: * @icon_view: a #GtkIconView * * Returns the value of the ::column-spacing property. * * Returns: the space between columns */ int gtk_icon_view_get_column_spacing (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->column_spacing; } /** * gtk_icon_view_set_margin: * @icon_view: a #GtkIconView * @margin: the margin * * Sets the ::margin property which specifies the space * which is inserted at the top, bottom, left and right * of the icon view. */ void gtk_icon_view_set_margin (GtkIconView *icon_view, int margin) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->margin != margin) { icon_view->priv->margin = margin; if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); gtk_icon_view_invalidate_sizes (icon_view); g_object_notify (G_OBJECT (icon_view), "margin"); } } /** * gtk_icon_view_get_margin: * @icon_view: a #GtkIconView * * Returns the value of the ::margin property. * * Returns: the space at the borders */ int gtk_icon_view_get_margin (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->margin; } /** * gtk_icon_view_set_item_padding: * @icon_view: a #GtkIconView * @item_padding: the item padding * * Sets the #GtkIconView:item-padding property which specifies the padding * around each of the icon view’s items. */ void gtk_icon_view_set_item_padding (GtkIconView *icon_view, int item_padding) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->item_padding != item_padding) { icon_view->priv->item_padding = item_padding; if (icon_view->priv->cell_area) gtk_cell_area_stop_editing (icon_view->priv->cell_area, TRUE); gtk_icon_view_invalidate_sizes (icon_view); g_object_notify (G_OBJECT (icon_view), "item-padding"); } } /** * gtk_icon_view_get_item_padding: * @icon_view: a #GtkIconView * * Returns the value of the ::item-padding property. * * Returns: the padding around items */ int gtk_icon_view_get_item_padding (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1); return icon_view->priv->item_padding; } /* Get/set whether drag_motion requested the drag data and * drag_data_received should thus not actually insert the data, * since the data doesn’t result from a drop. */ static void set_status_pending (GdkDrop *drop, GdkDragAction suggested_action) { g_object_set_data (G_OBJECT (drop), I_("gtk-icon-view-status-pending"), GINT_TO_POINTER (suggested_action)); } static GdkDragAction get_status_pending (GdkDrop *drop) { return GPOINTER_TO_INT (g_object_get_data (G_OBJECT (drop), "gtk-icon-view-status-pending")); } static void unset_reorderable (GtkIconView *icon_view) { if (icon_view->priv->reorderable) { icon_view->priv->reorderable = FALSE; g_object_notify (G_OBJECT (icon_view), "reorderable"); } } typedef struct { GtkTreeRowReference *dest_row; gboolean empty_view_drop; gboolean drop_append_mode; } DestRow; static void dest_row_free (gpointer data) { DestRow *dr = (DestRow *)data; gtk_tree_row_reference_free (dr->dest_row); g_free (dr); } static void set_dest_row (GdkDrop *drop, GtkTreeModel *model, GtkTreePath *dest_row, gboolean empty_view_drop, gboolean drop_append_mode) { DestRow *dr; if (!dest_row) { g_object_set_data_full (G_OBJECT (drop), I_("gtk-icon-view-dest-row"), NULL, NULL); return; } dr = g_new0 (DestRow, 1); dr->dest_row = gtk_tree_row_reference_new (model, dest_row); dr->empty_view_drop = empty_view_drop; dr->drop_append_mode = drop_append_mode; g_object_set_data_full (G_OBJECT (drop), I_("gtk-icon-view-dest-row"), dr, (GDestroyNotify) dest_row_free); } static GtkTreePath* get_dest_row (GdkDrop *drop) { DestRow *dr; dr = g_object_get_data (G_OBJECT (drop), "gtk-icon-view-dest-row"); if (dr) { GtkTreePath *path = NULL; if (dr->dest_row) path = gtk_tree_row_reference_get_path (dr->dest_row); else if (dr->empty_view_drop) path = gtk_tree_path_new_from_indices (0, -1); else path = NULL; if (path && dr->drop_append_mode) gtk_tree_path_next (path); return path; } else return NULL; } static gboolean check_model_dnd (GtkTreeModel *model, GType required_iface, const char *signal) { if (model == NULL || !G_TYPE_CHECK_INSTANCE_TYPE ((model), required_iface)) { g_warning ("You must override the default '%s' handler " "on GtkIconView when using models that don't support " "the %s interface and enabling drag-and-drop. The simplest way to do this " "is to connect to '%s' and call " "g_signal_stop_emission_by_name() in your signal handler to prevent " "the default handler from running. Look at the source code " "for the default handler in gtkiconview.c to get an idea what " "your handler should do. (gtkiconview.c is in the GTK+ source " "code.) If you're using GTK+ from a language other than C, " "there may be a more natural way to override default handlers, e.g. via derivation.", signal, g_type_name (required_iface), signal); return FALSE; } else return TRUE; } static void remove_scroll_timeout (GtkIconView *icon_view) { if (icon_view->priv->scroll_timeout_id != 0) { g_source_remove (icon_view->priv->scroll_timeout_id); icon_view->priv->scroll_timeout_id = 0; } } static void gtk_icon_view_autoscroll (GtkIconView *icon_view) { int px, py, width, height; int hoffset, voffset; px = icon_view->priv->event_last_x; py = icon_view->priv->event_last_y; width = gtk_widget_get_width (GTK_WIDGET (icon_view)); height = gtk_widget_get_height (GTK_WIDGET (icon_view)); /* see if we are near the edge. */ voffset = py - 2 * SCROLL_EDGE_SIZE; if (voffset > 0) voffset = MAX (py - (height - 2 * SCROLL_EDGE_SIZE), 0); hoffset = px - 2 * SCROLL_EDGE_SIZE; if (hoffset > 0) hoffset = MAX (px - (width - 2 * SCROLL_EDGE_SIZE), 0); if (voffset != 0) gtk_adjustment_set_value (icon_view->priv->vadjustment, gtk_adjustment_get_value (icon_view->priv->vadjustment) + voffset); if (hoffset != 0) gtk_adjustment_set_value (icon_view->priv->hadjustment, gtk_adjustment_get_value (icon_view->priv->hadjustment) + hoffset); } static gboolean drag_scroll_timeout (gpointer data) { gtk_icon_view_autoscroll (data); return TRUE; } static gboolean set_destination (GtkIconView *icon_view, GtkDropTargetAsync *dest, int x, int y, GdkDragAction *suggested_action, GType *target) { GtkWidget *widget; GtkTreePath *path = NULL; GtkIconViewDropPosition pos; GtkIconViewDropPosition old_pos; GtkTreePath *old_dest_path = NULL; GdkContentFormats *formats; gboolean can_drop = FALSE; widget = GTK_WIDGET (icon_view); *suggested_action = 0; *target = G_TYPE_INVALID; if (!icon_view->priv->dest_set) { /* someone unset us as a drag dest, note that if * we return FALSE drag_leave isn't called */ gtk_icon_view_set_drag_dest_item (icon_view, NULL, GTK_ICON_VIEW_DROP_LEFT); remove_scroll_timeout (GTK_ICON_VIEW (widget)); return FALSE; /* no longer a drop site */ } formats = gtk_drop_target_async_get_formats (dest); *target = gdk_content_formats_match_gtype (formats, formats); if (*target == G_TYPE_INVALID) return FALSE; if (!gtk_icon_view_get_dest_item_at_pos (icon_view, x, y, &path, &pos)) { int n_children; GtkTreeModel *model; /* the row got dropped on empty space, let's setup a special case */ if (path) gtk_tree_path_free (path); model = gtk_icon_view_get_model (icon_view); n_children = gtk_tree_model_iter_n_children (model, NULL); if (n_children) { pos = GTK_ICON_VIEW_DROP_BELOW; path = gtk_tree_path_new_from_indices (n_children - 1, -1); } else { pos = GTK_ICON_VIEW_DROP_ABOVE; path = gtk_tree_path_new_from_indices (0, -1); } can_drop = TRUE; goto out; } g_assert (path); gtk_icon_view_get_drag_dest_item (icon_view, &old_dest_path, &old_pos); if (old_dest_path) gtk_tree_path_free (old_dest_path); if (TRUE /* FIXME if the location droppable predicate */) { can_drop = TRUE; } out: if (can_drop) { *suggested_action = GDK_ACTION_ALL; gtk_icon_view_set_drag_dest_item (GTK_ICON_VIEW (widget), path, pos); } else { /* can't drop here */ gtk_icon_view_set_drag_dest_item (GTK_ICON_VIEW (widget), NULL, GTK_ICON_VIEW_DROP_LEFT); } if (path) gtk_tree_path_free (path); return TRUE; } static GtkTreePath* get_logical_destination (GtkIconView *icon_view, gboolean *drop_append_mode) { /* adjust path to point to the row the drop goes in front of */ GtkTreePath *path = NULL; GtkIconViewDropPosition pos; *drop_append_mode = FALSE; gtk_icon_view_get_drag_dest_item (icon_view, &path, &pos); if (path == NULL) return NULL; if (pos == GTK_ICON_VIEW_DROP_RIGHT || pos == GTK_ICON_VIEW_DROP_BELOW) { GtkTreeIter iter; GtkTreeModel *model = icon_view->priv->model; if (!gtk_tree_model_get_iter (model, &iter, path) || !gtk_tree_model_iter_next (model, &iter)) *drop_append_mode = TRUE; else { *drop_append_mode = FALSE; gtk_tree_path_next (path); } } return path; } static gboolean gtk_icon_view_maybe_begin_drag (GtkIconView *icon_view, double x, double y, GdkDevice *device) { GtkTreePath *path = NULL; GtkTreeModel *model; gboolean retval = FALSE; GdkContentProvider *content; GdkPaintable *icon; GtkIconViewItem *item; GdkSurface *surface; GdkDrag *drag; if (!icon_view->priv->source_set) goto out; if (icon_view->priv->pressed_button < 0) goto out; if (!gtk_drag_check_threshold (GTK_WIDGET (icon_view), icon_view->priv->press_start_x, icon_view->priv->press_start_y, x, y)) goto out; model = gtk_icon_view_get_model (icon_view); if (model == NULL) goto out; icon_view->priv->pressed_button = -1; item = _gtk_icon_view_get_item_at_coords (icon_view, icon_view->priv->press_start_x, icon_view->priv->press_start_y, TRUE, NULL); if (item == NULL) goto out; path = gtk_tree_path_new_from_indices (item->index, -1); if (!GTK_IS_TREE_DRAG_SOURCE (model) || !gtk_tree_drag_source_row_draggable (GTK_TREE_DRAG_SOURCE (model), path)) goto out; /* FIXME Check whether we're a start button, if not return FALSE and * free path */ /* Now we can begin the drag */ retval = TRUE; surface = gtk_native_get_surface (gtk_widget_get_native (GTK_WIDGET (icon_view))); content = gtk_icon_view_drag_data_get (icon_view, path); if (content == NULL) goto out; drag = gdk_drag_begin (surface, device, content, icon_view->priv->source_actions, icon_view->priv->press_start_x, icon_view->priv->press_start_y); g_object_unref (content); g_signal_connect (drag, "dnd-finished", G_CALLBACK (gtk_icon_view_dnd_finished_cb), icon_view); icon_view->priv->source_item = gtk_tree_row_reference_new (model, path); x = icon_view->priv->press_start_x - item->cell_area.x + icon_view->priv->item_padding; y = icon_view->priv->press_start_y - item->cell_area.y + icon_view->priv->item_padding; icon = gtk_icon_view_create_drag_icon (icon_view, path); gtk_drag_icon_set_from_paintable (drag, icon, x, y); g_object_unref (icon); icon_view->priv->drag = drag; g_object_unref (drag); out: if (path) gtk_tree_path_free (path); return retval; } /* Source side drag signals */ static GdkContentProvider * gtk_icon_view_drag_data_get (GtkIconView *icon_view, GtkTreePath *source_row) { GdkContentProvider *content; GtkTreeModel *model; model = gtk_icon_view_get_model (icon_view); if (model == NULL) return NULL; if (!icon_view->priv->source_set) return NULL; /* We can implement the GTK_TREE_MODEL_ROW target generically for * any model; for DragSource models there are some other formats * we also support. */ if (GTK_IS_TREE_DRAG_SOURCE (model)) content = gtk_tree_drag_source_drag_data_get (GTK_TREE_DRAG_SOURCE (model), source_row); else content = NULL; /* If drag_data_get does nothing, try providing row data. */ if (content == NULL) content = gtk_tree_create_row_drag_content (model, source_row); return content; } static void gtk_icon_view_dnd_finished_cb (GdkDrag *drag, GtkWidget *widget) { GtkTreeModel *model; GtkIconView *icon_view; GtkTreePath *source_row; if (gdk_drag_get_selected_action (drag) != GDK_ACTION_MOVE) return; icon_view = GTK_ICON_VIEW (widget); model = gtk_icon_view_get_model (icon_view); if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_SOURCE, "drag-data-delete")) return; if (!icon_view->priv->source_set) return; source_row = gtk_tree_row_reference_get_path (icon_view->priv->source_item); if (source_row == NULL) return; gtk_tree_drag_source_drag_data_delete (GTK_TREE_DRAG_SOURCE (model), source_row); gtk_tree_path_free (source_row); g_clear_pointer (&icon_view->priv->source_item, gtk_tree_row_reference_free); icon_view->priv->drag = NULL; } /* Target side drag signals */ static void gtk_icon_view_drag_leave (GtkDropTargetAsync *dest, GdkDrop *drop, GtkIconView *icon_view) { /* unset any highlight row */ gtk_icon_view_set_drag_dest_item (icon_view, NULL, GTK_ICON_VIEW_DROP_LEFT); remove_scroll_timeout (icon_view); } static GdkDragAction gtk_icon_view_drag_motion (GtkDropTargetAsync *dest, GdkDrop *drop, double x, double y, GtkIconView *icon_view) { GtkTreePath *path = NULL; GtkIconViewDropPosition pos; GdkDragAction suggested_action = 0; GType target; gboolean empty; GdkDragAction result; if (!set_destination (icon_view, dest, x, y, &suggested_action, &target)) return 0; gtk_icon_view_get_drag_dest_item (icon_view, &path, &pos); /* we only know this *after* set_desination_row */ empty = icon_view->priv->empty_view_drop; if (path == NULL && !empty) { /* Can't drop here. */ result = 0; } else { if (icon_view->priv->scroll_timeout_id == 0) { icon_view->priv->scroll_timeout_id = g_timeout_add (50, drag_scroll_timeout, icon_view); g_source_set_name_by_id (icon_view->priv->scroll_timeout_id, "[gtk] drag_scroll_timeout"); } if (target == GTK_TYPE_TREE_ROW_DATA) { /* Request data so we can use the source row when * determining whether to accept the drop */ set_status_pending (drop, suggested_action); gdk_drop_read_value_async (drop, target, G_PRIORITY_DEFAULT, NULL, gtk_icon_view_drag_data_received, icon_view); } else { set_status_pending (drop, 0); } result = suggested_action; } if (path) gtk_tree_path_free (path); return result; } static gboolean gtk_icon_view_drag_drop (GtkDropTargetAsync *dest, GdkDrop *drop, double x, double y, GtkIconView *icon_view) { GtkTreePath *path; GdkDragAction suggested_action = 0; GType target = G_TYPE_INVALID; GtkTreeModel *model; gboolean drop_append_mode; model = gtk_icon_view_get_model (icon_view); remove_scroll_timeout (icon_view); if (!icon_view->priv->dest_set) return FALSE; if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drop")) return FALSE; if (!set_destination (icon_view, dest, x, y, &suggested_action, &target)) return FALSE; path = get_logical_destination (icon_view, &drop_append_mode); if (target != G_TYPE_INVALID && path != NULL) { /* in case a motion had requested drag data, change things so we * treat drag data receives as a drop. */ set_status_pending (drop, 0); set_dest_row (drop, model, path, icon_view->priv->empty_view_drop, drop_append_mode); } if (path) gtk_tree_path_free (path); /* Unset this thing */ gtk_icon_view_set_drag_dest_item (icon_view, NULL, GTK_ICON_VIEW_DROP_LEFT); if (target != G_TYPE_INVALID) { gdk_drop_read_value_async (drop, target, G_PRIORITY_DEFAULT, NULL, gtk_icon_view_drag_data_received, icon_view); return TRUE; } else return FALSE; } static GdkDragAction gtk_icon_view_get_action (GtkWidget *widget, GdkDrop *drop) { GtkIconView *iconview = GTK_ICON_VIEW (widget); GdkDrag *drag = gdk_drop_get_drag (drop); GdkDragAction actions; actions = gdk_drop_get_actions (drop); if (drag == iconview->priv->drag && actions & GDK_ACTION_MOVE) return GDK_ACTION_MOVE; if (actions & GDK_ACTION_COPY) return GDK_ACTION_COPY; if (actions & GDK_ACTION_MOVE) return GDK_ACTION_MOVE; if (actions & GDK_ACTION_LINK) return GDK_ACTION_LINK; return 0; } static void gtk_icon_view_drag_data_received (GObject *source, GAsyncResult *result, gpointer data) { GtkIconView *icon_view = data; GdkDrop *drop = GDK_DROP (source); GtkTreePath *path; GtkTreeModel *model; GtkTreePath *dest_row; GdkDragAction suggested_action; gboolean drop_append_mode; const GValue *value; value = gdk_drop_read_value_finish (drop, result, NULL); if (!value) return; model = gtk_icon_view_get_model (icon_view); if (!check_model_dnd (model, GTK_TYPE_TREE_DRAG_DEST, "drag-data-received")) return; if (!icon_view->priv->dest_set) return; suggested_action = get_status_pending (drop); if (suggested_action) { /* We are getting this data due to a request in drag_motion, * rather than due to a request in drag_drop, so we are just * supposed to call drag_status, not actually paste in the * data. */ path = get_logical_destination (icon_view, &drop_append_mode); if (path == NULL) suggested_action = 0; if (suggested_action) { if (!gtk_tree_drag_dest_row_drop_possible (GTK_TREE_DRAG_DEST (model), path, value)) suggested_action = 0; } if (path) gtk_tree_path_free (path); /* If you can't drop, remove user drop indicator until the next motion */ if (suggested_action == 0) gtk_icon_view_set_drag_dest_item (icon_view, NULL, GTK_ICON_VIEW_DROP_LEFT); return; } dest_row = get_dest_row (drop); if (dest_row == NULL) return; suggested_action = gtk_icon_view_get_action (GTK_WIDGET (icon_view), drop); if (suggested_action && !gtk_tree_drag_dest_drag_data_received (GTK_TREE_DRAG_DEST (model), dest_row, value)) suggested_action = 0; gdk_drop_finish (drop, suggested_action); gtk_tree_path_free (dest_row); /* drop dest_row */ set_dest_row (drop, NULL, NULL, FALSE, FALSE); } /* Drag-and-Drop support */ /** * gtk_icon_view_enable_model_drag_source: * @icon_view: a #GtkIconView * @start_button_mask: Mask of allowed buttons to start drag * @formats: the formats that the drag will support * @actions: the bitmask of possible actions for a drag from this * widget * * Turns @icon_view into a drag source for automatic DND. Calling this * method sets #GtkIconView:reorderable to %FALSE. **/ void gtk_icon_view_enable_model_drag_source (GtkIconView *icon_view, GdkModifierType start_button_mask, GdkContentFormats *formats, GdkDragAction actions) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); icon_view->priv->source_formats = gdk_content_formats_ref (formats); icon_view->priv->source_actions = actions; icon_view->priv->source_set = TRUE; unset_reorderable (icon_view); } /** * gtk_icon_view_enable_model_drag_dest: * @icon_view: a #GtkIconView * @formats: the formats that the drag will support * @actions: the bitmask of possible actions for a drag to this * widget * * Turns @icon_view into a drop destination for automatic DND. Calling this * method sets #GtkIconView:reorderable to %FALSE. **/ void gtk_icon_view_enable_model_drag_dest (GtkIconView *icon_view, GdkContentFormats *formats, GdkDragAction actions) { GtkCssNode *widget_node; g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); icon_view->priv->dest = gtk_drop_target_async_new (gdk_content_formats_ref (formats), actions); g_signal_connect (icon_view->priv->dest, "drag-leave", G_CALLBACK (gtk_icon_view_drag_leave), icon_view); g_signal_connect (icon_view->priv->dest, "drag-enter", G_CALLBACK (gtk_icon_view_drag_motion), icon_view); g_signal_connect (icon_view->priv->dest, "drag-motion", G_CALLBACK (gtk_icon_view_drag_motion), icon_view); g_signal_connect (icon_view->priv->dest, "drop", G_CALLBACK (gtk_icon_view_drag_drop), icon_view); gtk_widget_add_controller (GTK_WIDGET (icon_view), GTK_EVENT_CONTROLLER (icon_view->priv->dest)); icon_view->priv->dest_actions = actions; icon_view->priv->dest_set = TRUE; unset_reorderable (icon_view); widget_node = gtk_widget_get_css_node (GTK_WIDGET (icon_view)); icon_view->priv->dndnode = gtk_css_node_new (); gtk_css_node_set_name (icon_view->priv->dndnode, g_quark_from_static_string ("dndtarget")); gtk_css_node_set_parent (icon_view->priv->dndnode, widget_node); gtk_css_node_set_state (icon_view->priv->dndnode, gtk_css_node_get_state (widget_node)); g_object_unref (icon_view->priv->dndnode); } /** * gtk_icon_view_unset_model_drag_source: * @icon_view: a #GtkIconView * * Undoes the effect of gtk_icon_view_enable_model_drag_source(). Calling this * method sets #GtkIconView:reorderable to %FALSE. **/ void gtk_icon_view_unset_model_drag_source (GtkIconView *icon_view) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->source_set) { g_clear_pointer (&icon_view->priv->source_formats, gdk_content_formats_unref); icon_view->priv->source_set = FALSE; } unset_reorderable (icon_view); } /** * gtk_icon_view_unset_model_drag_dest: * @icon_view: a #GtkIconView * * Undoes the effect of gtk_icon_view_enable_model_drag_dest(). Calling this * method sets #GtkIconView:reorderable to %FALSE. **/ void gtk_icon_view_unset_model_drag_dest (GtkIconView *icon_view) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->dest_set) { gtk_widget_remove_controller (GTK_WIDGET (icon_view), GTK_EVENT_CONTROLLER (icon_view->priv->dest)); icon_view->priv->dest = NULL; icon_view->priv->dest_set = FALSE; gtk_css_node_set_parent (icon_view->priv->dndnode, NULL); icon_view->priv->dndnode = NULL; } unset_reorderable (icon_view); } /* These are useful to implement your own custom stuff. */ /** * gtk_icon_view_set_drag_dest_item: * @icon_view: a #GtkIconView * @path: (allow-none): The path of the item to highlight, or %NULL. * @pos: Specifies where to drop, relative to the item * * Sets the item that is highlighted for feedback. */ void gtk_icon_view_set_drag_dest_item (GtkIconView *icon_view, GtkTreePath *path, GtkIconViewDropPosition pos) { /* Note; this function is exported to allow a custom DND * implementation, so it can't touch TreeViewDragInfo */ g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (icon_view->priv->dest_item) { GtkTreePath *current_path; current_path = gtk_tree_row_reference_get_path (icon_view->priv->dest_item); gtk_tree_row_reference_free (icon_view->priv->dest_item); icon_view->priv->dest_item = NULL; gtk_icon_view_queue_draw_path (icon_view, current_path); gtk_tree_path_free (current_path); } /* special case a drop on an empty model */ icon_view->priv->empty_view_drop = FALSE; if (pos == GTK_ICON_VIEW_DROP_ABOVE && path && gtk_tree_path_get_depth (path) == 1 && gtk_tree_path_get_indices (path)[0] == 0) { int n_children; n_children = gtk_tree_model_iter_n_children (icon_view->priv->model, NULL); if (n_children == 0) icon_view->priv->empty_view_drop = TRUE; } icon_view->priv->dest_pos = pos; if (path) { icon_view->priv->dest_item = gtk_tree_row_reference_new_proxy (G_OBJECT (icon_view), icon_view->priv->model, path); gtk_icon_view_queue_draw_path (icon_view, path); } } /** * gtk_icon_view_get_drag_dest_item: * @icon_view: a #GtkIconView * @path: (out) (allow-none): Return location for the path of * the highlighted item, or %NULL. * @pos: (out) (allow-none): Return location for the drop position, or %NULL * * Gets information about the item that is highlighted for feedback. **/ void gtk_icon_view_get_drag_dest_item (GtkIconView *icon_view, GtkTreePath **path, GtkIconViewDropPosition *pos) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); if (path) { if (icon_view->priv->dest_item) *path = gtk_tree_row_reference_get_path (icon_view->priv->dest_item); else *path = NULL; } if (pos) *pos = icon_view->priv->dest_pos; } /** * gtk_icon_view_get_dest_item_at_pos: * @icon_view: a #GtkIconView * @drag_x: the position to determine the destination item for * @drag_y: the position to determine the destination item for * @path: (out) (allow-none): Return location for the path of the item, * or %NULL. * @pos: (out) (allow-none): Return location for the drop position, or %NULL * * Determines the destination item for a given position. * * Returns: whether there is an item at the given position. **/ gboolean gtk_icon_view_get_dest_item_at_pos (GtkIconView *icon_view, int drag_x, int drag_y, GtkTreePath **path, GtkIconViewDropPosition *pos) { GtkIconViewItem *item; /* Note; this function is exported to allow a custom DND * implementation, so it can't touch TreeViewDragInfo */ g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE); g_return_val_if_fail (drag_x >= 0, FALSE); g_return_val_if_fail (drag_y >= 0, FALSE); if (path) *path = NULL; item = _gtk_icon_view_get_item_at_coords (icon_view, drag_x + gtk_adjustment_get_value (icon_view->priv->hadjustment), drag_y + gtk_adjustment_get_value (icon_view->priv->vadjustment), FALSE, NULL); if (item == NULL) return FALSE; if (path) *path = gtk_tree_path_new_from_indices (item->index, -1); if (pos) { if (drag_x < item->cell_area.x + item->cell_area.width / 4) *pos = GTK_ICON_VIEW_DROP_LEFT; else if (drag_x > item->cell_area.x + item->cell_area.width * 3 / 4) *pos = GTK_ICON_VIEW_DROP_RIGHT; else if (drag_y < item->cell_area.y + item->cell_area.height / 4) *pos = GTK_ICON_VIEW_DROP_ABOVE; else if (drag_y > item->cell_area.y + item->cell_area.height * 3 / 4) *pos = GTK_ICON_VIEW_DROP_BELOW; else *pos = GTK_ICON_VIEW_DROP_INTO; } return TRUE; } /** * gtk_icon_view_create_drag_icon: * @icon_view: a #GtkIconView * @path: a #GtkTreePath in @icon_view * * Creates a #cairo_surface_t representation of the item at @path. * This image is used for a drag icon. * * Returns: (transfer full): a newly-allocated surface of the drag icon. **/ GdkPaintable * gtk_icon_view_create_drag_icon (GtkIconView *icon_view, GtkTreePath *path) { GtkWidget *widget; GtkSnapshot *snapshot; GdkPaintable *paintable; GList *l; int index; g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), NULL); g_return_val_if_fail (path != NULL, NULL); widget = GTK_WIDGET (icon_view); if (!gtk_widget_get_realized (widget)) return NULL; index = gtk_tree_path_get_indices (path)[0]; for (l = icon_view->priv->items; l; l = l->next) { GtkIconViewItem *item = l->data; if (index == item->index) { snapshot = gtk_snapshot_new (); gtk_icon_view_snapshot_item (icon_view, snapshot, item, icon_view->priv->item_padding, icon_view->priv->item_padding, FALSE); paintable = gtk_snapshot_free_to_paintable (snapshot, NULL); return paintable; } } return NULL; } /** * gtk_icon_view_get_reorderable: * @icon_view: a #GtkIconView * * Retrieves whether the user can reorder the list via drag-and-drop. * See gtk_icon_view_set_reorderable(). * * Returns: %TRUE if the list can be reordered. **/ gboolean gtk_icon_view_get_reorderable (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE); return icon_view->priv->reorderable; } /** * gtk_icon_view_set_reorderable: * @icon_view: A #GtkIconView. * @reorderable: %TRUE, if the list of items can be reordered. * * This function is a convenience function to allow you to reorder models that * support the #GtkTreeDragSourceIface and the #GtkTreeDragDestIface. Both * #GtkTreeStore and #GtkListStore support these. If @reorderable is %TRUE, then * the user can reorder the model by dragging and dropping rows. The * developer can listen to these changes by connecting to the model's * row_inserted and row_deleted signals. The reordering is implemented by setting up * the icon view as a drag source and destination. Therefore, drag and * drop can not be used in a reorderable view for any other purpose. * * This function does not give you any degree of control over the order -- any * reordering is allowed. If more control is needed, you should probably * handle drag and drop manually. **/ void gtk_icon_view_set_reorderable (GtkIconView *icon_view, gboolean reorderable) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); reorderable = reorderable != FALSE; if (icon_view->priv->reorderable == reorderable) return; if (reorderable) { GdkContentFormats *formats = gdk_content_formats_new_for_gtype (GTK_TYPE_TREE_ROW_DATA); gtk_icon_view_enable_model_drag_source (icon_view, GDK_BUTTON1_MASK, formats, GDK_ACTION_MOVE); gtk_icon_view_enable_model_drag_dest (icon_view, formats, GDK_ACTION_MOVE); gdk_content_formats_unref (formats); } else { gtk_icon_view_unset_model_drag_source (icon_view); gtk_icon_view_unset_model_drag_dest (icon_view); } icon_view->priv->reorderable = reorderable; g_object_notify (G_OBJECT (icon_view), "reorderable"); } /** * gtk_icon_view_set_activate_on_single_click: * @icon_view: a #GtkIconView * @single: %TRUE to emit item-activated on a single click * * Causes the #GtkIconView::item-activated signal to be emitted on * a single click instead of a double click. **/ void gtk_icon_view_set_activate_on_single_click (GtkIconView *icon_view, gboolean single) { g_return_if_fail (GTK_IS_ICON_VIEW (icon_view)); single = single != FALSE; if (icon_view->priv->activate_on_single_click == single) return; icon_view->priv->activate_on_single_click = single; g_object_notify (G_OBJECT (icon_view), "activate-on-single-click"); } /** * gtk_icon_view_get_activate_on_single_click: * @icon_view: a #GtkIconView * * Gets the setting set by gtk_icon_view_set_activate_on_single_click(). * * Returns: %TRUE if item-activated will be emitted on a single click **/ gboolean gtk_icon_view_get_activate_on_single_click (GtkIconView *icon_view) { g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE); return icon_view->priv->activate_on_single_click; } static gboolean gtk_icon_view_buildable_custom_tag_start (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const char *tagname, GtkBuildableParser *parser, gpointer *data) { if (parent_buildable_iface->custom_tag_start (buildable, builder, child, tagname, parser, data)) return TRUE; return _gtk_cell_layout_buildable_custom_tag_start (buildable, builder, child, tagname, parser, data); } static void gtk_icon_view_buildable_custom_tag_end (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const char *tagname, gpointer data) { if (!_gtk_cell_layout_buildable_custom_tag_end (buildable, builder, child, tagname, data)) parent_buildable_iface->custom_tag_end (buildable, builder, child, tagname, data); }