2 * Copyright (C) 2002, 2004 Anders Carlsson <andersca@gnu.org>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
23 #include <gdk/gdkkeysyms.h>
25 #include "gtkiconview.h"
26 #include "gtkmarshalers.h"
27 #include "gtkbindings.h"
30 #include "gtksignal.h"
33 #define MINIMUM_ICON_ITEM_WIDTH 100
34 #define ICON_TEXT_PADDING 3
36 #define ICON_VIEW_TOP_MARGIN 6
37 #define ICON_VIEW_BOTTOM_MARGIN 6
38 #define ICON_VIEW_LEFT_MARGIN 6
39 #define ICON_VIEW_RIGHT_MARGIN 6
40 #define ICON_VIEW_ICON_PADDING 6
42 #define GTK_ICON_VIEW_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_ICON_VIEW, GtkIconViewPrivate))
43 #define VALID_MODEL_AND_COLUMNS(obj) ((obj)->priv->model != NULL && \
44 ((obj)->priv->pixbuf_column != -1 || \
45 (obj)->priv->text_column != -1 || \
46 (obj)->priv->markup_column != -1))
59 gint pixbuf_x, pixbuf_y;
60 gint pixbuf_height, pixbuf_width;
62 gint layout_x, layout_y;
63 gint layout_width, layout_height;
66 guint selected_before_rubberbanding : 1;
69 struct _GtkIconViewPrivate
77 GtkSelectionMode selection_mode;
79 GdkWindow *bin_window;
85 GtkAdjustment *hadjustment;
86 GtkAdjustment *vadjustment;
90 gboolean doing_rubberband;
91 gint rubberband_x1, rubberband_y1;
92 gint rubberband_x2, rubberband_y2;
94 guint scroll_timeout_id;
95 gint scroll_value_diff;
96 gint event_last_x, event_last_y;
98 GtkIconViewItem *anchor_item;
99 GtkIconViewItem *cursor_item;
101 guint ctrl_pressed : 1;
102 guint shift_pressed : 1;
104 GtkIconViewItem *last_single_clicked;
113 /* Layout used to draw icon text */
116 GtkOrientation orientation;
129 ACTIVATE_CURSOR_ITEM,
145 /* GObject signals */
146 static void gtk_icon_view_finalize (GObject *object);
147 static void gtk_icon_view_set_property (GObject *object,
151 static void gtk_icon_view_get_property (GObject *object,
157 /* GtkObject signals */
158 static void gtk_icon_view_destroy (GtkObject *object);
160 /* GtkWidget signals */
161 static void gtk_icon_view_realize (GtkWidget *widget);
162 static void gtk_icon_view_unrealize (GtkWidget *widget);
163 static void gtk_icon_view_map (GtkWidget *widget);
164 static void gtk_icon_view_size_request (GtkWidget *widget,
165 GtkRequisition *requisition);
166 static void gtk_icon_view_size_allocate (GtkWidget *widget,
167 GtkAllocation *allocation);
168 static gboolean gtk_icon_view_expose (GtkWidget *widget,
169 GdkEventExpose *expose);
170 static gboolean gtk_icon_view_motion (GtkWidget *widget,
171 GdkEventMotion *event);
172 static gboolean gtk_icon_view_button_press (GtkWidget *widget,
173 GdkEventButton *event);
174 static gboolean gtk_icon_view_button_release (GtkWidget *widget,
175 GdkEventButton *event);
176 /* GtkIconView signals */
177 static void gtk_icon_view_set_adjustments (GtkIconView *icon_view,
179 GtkAdjustment *vadj);
180 static void gtk_icon_view_real_select_all (GtkIconView *icon_view);
181 static void gtk_icon_view_real_unselect_all (GtkIconView *icon_view);
182 static void gtk_icon_view_real_select_cursor_item (GtkIconView *icon_view);
183 static void gtk_icon_view_real_toggle_cursor_item (GtkIconView *icon_view);
184 static gboolean gtk_icon_view_real_activate_cursor_item (GtkIconView *icon_view);
186 /* Internal functions */
187 static void gtk_icon_view_adjustment_changed (GtkAdjustment *adjustment,
188 GtkIconView *icon_view);
189 static void gtk_icon_view_layout (GtkIconView *icon_view);
190 static void gtk_icon_view_paint_item (GtkIconView *icon_view,
191 GtkIconViewItem *item,
193 static void gtk_icon_view_paint_rubberband (GtkIconView *icon_view,
195 static void gtk_icon_view_queue_draw_item (GtkIconView *icon_view,
196 GtkIconViewItem *item);
197 static void gtk_icon_view_queue_layout (GtkIconView *icon_view);
198 static void gtk_icon_view_set_cursor_item (GtkIconView *icon_view,
199 GtkIconViewItem *item);
200 static void gtk_icon_view_start_rubberbanding (GtkIconView *icon_view,
203 static void gtk_icon_view_stop_rubberbanding (GtkIconView *icon_view);
204 static void gtk_icon_view_update_rubberband_selection (GtkIconView *icon_view);
205 static gboolean gtk_icon_view_item_hit_test (GtkIconViewItem *item,
211 static gboolean gtk_icon_view_maybe_begin_dragging_items (GtkIconView *icon_view,
212 GdkEventMotion *event);
214 static gboolean gtk_icon_view_unselect_all_internal (GtkIconView *icon_view);
215 static void gtk_icon_view_calculate_item_size (GtkIconView *icon_view,
216 GtkIconViewItem *item);
217 static void gtk_icon_view_update_rubberband (gpointer data);
218 static void gtk_icon_view_item_invalidate_size (GtkIconViewItem *item);
219 static void gtk_icon_view_invalidate_sizes (GtkIconView *icon_view);
220 static void gtk_icon_view_add_move_binding (GtkBindingSet *binding_set,
223 GtkMovementStep step,
225 static gboolean gtk_icon_view_real_move_cursor (GtkIconView *icon_view,
226 GtkMovementStep step,
228 static void gtk_icon_view_move_cursor_up_down (GtkIconView *icon_view,
230 static void gtk_icon_view_move_cursor_page_up_down (GtkIconView *icon_view,
232 static void gtk_icon_view_move_cursor_left_right (GtkIconView *icon_view,
234 static void gtk_icon_view_move_cursor_start_end (GtkIconView *icon_view,
236 static void gtk_icon_view_scroll_to_item (GtkIconView *icon_view,
237 GtkIconViewItem *item);
238 static GdkPixbuf *gtk_icon_view_get_item_icon (GtkIconView *icon_view,
239 GtkIconViewItem *item);
240 static void gtk_icon_view_update_item_text (GtkIconView *icon_view,
241 GtkIconViewItem *item);
242 static void gtk_icon_view_select_item (GtkIconView *icon_view,
243 GtkIconViewItem *item);
244 static void gtk_icon_view_unselect_item (GtkIconView *icon_view,
245 GtkIconViewItem *item);
246 static gboolean gtk_icon_view_select_all_between (GtkIconView *icon_view,
247 GtkIconViewItem *anchor,
248 GtkIconViewItem *cursor);
250 static GtkIconViewItem *gtk_icon_view_get_item_at_pos (GtkIconView *icon_view,
258 static GtkContainerClass *parent_class = NULL;
259 static guint icon_view_signals[LAST_SIGNAL] = { 0 };
261 G_DEFINE_TYPE (GtkIconView, gtk_icon_view, GTK_TYPE_CONTAINER);
264 gtk_icon_view_class_init (GtkIconViewClass *klass)
266 GObjectClass *gobject_class;
267 GtkObjectClass *object_class;
268 GtkWidgetClass *widget_class;
269 GtkBindingSet *binding_set;
271 parent_class = g_type_class_peek_parent (klass);
272 binding_set = gtk_binding_set_by_class (klass);
274 g_type_class_add_private (klass, sizeof (GtkIconViewPrivate));
276 gobject_class = (GObjectClass *) klass;
277 object_class = (GtkObjectClass *) klass;
278 widget_class = (GtkWidgetClass *) klass;
280 gobject_class->finalize = gtk_icon_view_finalize;
281 gobject_class->set_property = gtk_icon_view_set_property;
282 gobject_class->get_property = gtk_icon_view_get_property;
284 object_class->destroy = gtk_icon_view_destroy;
286 widget_class->realize = gtk_icon_view_realize;
287 widget_class->unrealize = gtk_icon_view_unrealize;
288 widget_class->map = gtk_icon_view_map;
289 widget_class->size_request = gtk_icon_view_size_request;
290 widget_class->size_allocate = gtk_icon_view_size_allocate;
291 widget_class->expose_event = gtk_icon_view_expose;
292 widget_class->motion_notify_event = gtk_icon_view_motion;
293 widget_class->button_press_event = gtk_icon_view_button_press;
294 widget_class->button_release_event = gtk_icon_view_button_release;
296 klass->set_scroll_adjustments = gtk_icon_view_set_adjustments;
297 klass->select_all = gtk_icon_view_real_select_all;
298 klass->unselect_all = gtk_icon_view_real_unselect_all;
299 klass->select_cursor_item = gtk_icon_view_real_select_cursor_item;
300 klass->toggle_cursor_item = gtk_icon_view_real_toggle_cursor_item;
301 klass->activate_cursor_item = gtk_icon_view_real_activate_cursor_item;
302 klass->move_cursor = gtk_icon_view_real_move_cursor;
306 * GtkIconView:selection-mode:
308 * The ::selection-mode property specifies the selection mode of
309 * icon view. If the mode is #GTK_SELECTION_MULTIPLE, rubberband selection
310 * is enabled, for the other modes, only keyboard selection is possible.
314 g_object_class_install_property (gobject_class,
316 g_param_spec_enum ("selection_mode",
317 P_("Selection mode"),
318 P_("The selection mode"),
319 GTK_TYPE_SELECTION_MODE,
320 GTK_SELECTION_SINGLE,
324 * GtkIconView:pixbuf-column:
326 * The ::pixbuf-column property contains the number of the model column
327 * containing the pixbufs which are displayed. The pixbuf column must be
328 * of type #GDK_TYPE_PIXBUF. Setting this property to -1 turns off the
329 * display of pixbufs.
333 g_object_class_install_property (gobject_class,
335 g_param_spec_int ("pixbuf_column",
337 P_("Model column used to retrieve the icon pixbuf from"),
342 * GtkIconView:text-column:
344 * The ::text-column property contains the number of the model column
345 * containing the texts which are displayed. The text column must be
346 * of type #G_TYPE_STRING. If this property and the :markup-column
347 * property are both set to -1, no texts are displayed.
351 g_object_class_install_property (gobject_class,
353 g_param_spec_int ("text_column",
355 P_("Model column used to retrieve the text from"),
361 * GtkIconView:markup-column:
363 * The ::markup-column property contains the number of the model column
364 * containing markup information to be displayed. The markup column must be
365 * of type #G_TYPE_STRING. If this property and the :text-column property
366 * are both set to column numbers, it overrides the text column.
367 * If both are set to -1, no texts are displayed.
371 g_object_class_install_property (gobject_class,
373 g_param_spec_int ("markup_column",
375 P_("Model column used to retrieve the text if using Pango markup"),
379 g_object_class_install_property (gobject_class,
381 g_param_spec_object ("model",
382 P_("Icon View Model"),
383 P_("The model for the icon view"),
387 g_object_class_install_property (gobject_class,
389 g_param_spec_enum ("orientation",
391 P_("How the text and icon of each item are positioned relative to each other"),
392 GTK_TYPE_ORIENTATION,
393 GTK_ORIENTATION_VERTICAL,
396 /* Style properties */
397 gtk_widget_class_install_style_property (widget_class,
398 g_param_spec_boxed ("selection_box_color",
399 P_("Selection Box Color"),
400 P_("Color of the selection box"),
404 gtk_widget_class_install_style_property (widget_class,
405 g_param_spec_uchar ("selection_box_alpha",
406 P_("Selection Box Alpha"),
407 P_("Opacity of the selection box"),
413 widget_class->set_scroll_adjustments_signal =
414 g_signal_new ("set_scroll_adjustments",
415 G_TYPE_FROM_CLASS (gobject_class),
417 G_STRUCT_OFFSET (GtkIconViewClass, set_scroll_adjustments),
419 _gtk_marshal_VOID__OBJECT_OBJECT,
421 GTK_TYPE_ADJUSTMENT, GTK_TYPE_ADJUSTMENT);
423 icon_view_signals[ITEM_ACTIVATED] =
424 g_signal_new ("item_activated",
425 G_TYPE_FROM_CLASS (gobject_class),
427 G_STRUCT_OFFSET (GtkIconViewClass, item_activated),
429 g_cclosure_marshal_VOID__BOXED,
433 icon_view_signals[SELECTION_CHANGED] =
434 g_signal_new ("selection_changed",
435 G_TYPE_FROM_CLASS (gobject_class),
437 G_STRUCT_OFFSET (GtkIconViewClass, selection_changed),
439 g_cclosure_marshal_VOID__VOID,
442 icon_view_signals[SELECT_ALL] =
443 g_signal_new ("select_all",
444 G_TYPE_FROM_CLASS (gobject_class),
445 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
446 G_STRUCT_OFFSET (GtkIconViewClass, select_all),
448 g_cclosure_marshal_VOID__VOID,
451 icon_view_signals[UNSELECT_ALL] =
452 g_signal_new ("unselect_all",
453 G_TYPE_FROM_CLASS (gobject_class),
454 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
455 G_STRUCT_OFFSET (GtkIconViewClass, unselect_all),
457 g_cclosure_marshal_VOID__VOID,
460 icon_view_signals[SELECT_CURSOR_ITEM] =
461 g_signal_new ("select_cursor_item",
462 G_TYPE_FROM_CLASS (gobject_class),
463 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
464 G_STRUCT_OFFSET (GtkIconViewClass, select_cursor_item),
466 g_cclosure_marshal_VOID__VOID,
469 icon_view_signals[TOGGLE_CURSOR_ITEM] =
470 g_signal_new ("toggle_cursor_item",
471 G_TYPE_FROM_CLASS (gobject_class),
472 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
473 G_STRUCT_OFFSET (GtkIconViewClass, toggle_cursor_item),
475 g_cclosure_marshal_VOID__VOID,
478 icon_view_signals[ACTIVATE_CURSOR_ITEM] =
479 g_signal_new ("activate_cursor_item",
480 G_TYPE_FROM_CLASS (gobject_class),
481 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
482 G_STRUCT_OFFSET (GtkIconViewClass, activate_cursor_item),
484 _gtk_marshal_BOOLEAN__VOID,
487 icon_view_signals[MOVE_CURSOR] =
488 g_signal_new ("move_cursor",
489 G_TYPE_FROM_CLASS (gobject_class),
490 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
491 G_STRUCT_OFFSET (GtkIconViewClass, move_cursor),
493 _gtk_marshal_BOOLEAN__ENUM_INT,
495 GTK_TYPE_MOVEMENT_STEP,
499 gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_CONTROL_MASK, "select_all", 0);
500 gtk_binding_entry_add_signal (binding_set, GDK_a, GDK_CONTROL_MASK | GDK_SHIFT_MASK, "unselect_all", 0);
501 gtk_binding_entry_add_signal (binding_set, GDK_space, 0, "select_cursor_item", 0);
502 gtk_binding_entry_add_signal (binding_set, GDK_space, GDK_CONTROL_MASK, "toggle_cursor_item", 0);
504 gtk_binding_entry_add_signal (binding_set, GDK_Return, 0, "activate_cursor_item", 0);
505 gtk_binding_entry_add_signal (binding_set, GDK_ISO_Enter, 0, "activate_cursor_item", 0);
506 gtk_binding_entry_add_signal (binding_set, GDK_KP_Enter, 0, "activate_cursor_item", 0);
508 gtk_icon_view_add_move_binding (binding_set, GDK_Up, 0,
509 GTK_MOVEMENT_DISPLAY_LINES, -1);
510 gtk_icon_view_add_move_binding (binding_set, GDK_KP_Up, 0,
511 GTK_MOVEMENT_DISPLAY_LINES, -1);
513 gtk_icon_view_add_move_binding (binding_set, GDK_Down, 0,
514 GTK_MOVEMENT_DISPLAY_LINES, 1);
515 gtk_icon_view_add_move_binding (binding_set, GDK_KP_Down, 0,
516 GTK_MOVEMENT_DISPLAY_LINES, 1);
518 gtk_icon_view_add_move_binding (binding_set, GDK_p, GDK_CONTROL_MASK,
519 GTK_MOVEMENT_DISPLAY_LINES, -1);
521 gtk_icon_view_add_move_binding (binding_set, GDK_n, GDK_CONTROL_MASK,
522 GTK_MOVEMENT_DISPLAY_LINES, 1);
524 gtk_icon_view_add_move_binding (binding_set, GDK_Home, 0,
525 GTK_MOVEMENT_BUFFER_ENDS, -1);
526 gtk_icon_view_add_move_binding (binding_set, GDK_KP_Home, 0,
527 GTK_MOVEMENT_BUFFER_ENDS, -1);
529 gtk_icon_view_add_move_binding (binding_set, GDK_End, 0,
530 GTK_MOVEMENT_BUFFER_ENDS, 1);
531 gtk_icon_view_add_move_binding (binding_set, GDK_KP_End, 0,
532 GTK_MOVEMENT_BUFFER_ENDS, 1);
534 gtk_icon_view_add_move_binding (binding_set, GDK_Page_Up, 0,
535 GTK_MOVEMENT_PAGES, -1);
536 gtk_icon_view_add_move_binding (binding_set, GDK_KP_Page_Up, 0,
537 GTK_MOVEMENT_PAGES, -1);
539 gtk_icon_view_add_move_binding (binding_set, GDK_Page_Down, 0,
540 GTK_MOVEMENT_PAGES, 1);
541 gtk_icon_view_add_move_binding (binding_set, GDK_KP_Page_Down, 0,
542 GTK_MOVEMENT_PAGES, 1);
544 gtk_icon_view_add_move_binding (binding_set, GDK_Right, 0,
545 GTK_MOVEMENT_VISUAL_POSITIONS, 1);
546 gtk_icon_view_add_move_binding (binding_set, GDK_Left, 0,
547 GTK_MOVEMENT_VISUAL_POSITIONS, -1);
549 gtk_icon_view_add_move_binding (binding_set, GDK_KP_Right, 0,
550 GTK_MOVEMENT_VISUAL_POSITIONS, 1);
551 gtk_icon_view_add_move_binding (binding_set, GDK_KP_Left, 0,
552 GTK_MOVEMENT_VISUAL_POSITIONS, -1);
556 gtk_icon_view_init (GtkIconView *icon_view)
558 icon_view->priv = GTK_ICON_VIEW_GET_PRIVATE (icon_view);
560 icon_view->priv->width = 0;
561 icon_view->priv->height = 0;
562 icon_view->priv->selection_mode = GTK_SELECTION_SINGLE;
564 icon_view->priv->pressed_button = -1;
565 icon_view->priv->press_start_x = -1;
566 icon_view->priv->press_start_y = -1;
568 icon_view->priv->text_column = -1;
569 icon_view->priv->markup_column = -1;
570 icon_view->priv->pixbuf_column = -1;
572 icon_view->priv->layout = gtk_widget_create_pango_layout (GTK_WIDGET (icon_view), NULL);
574 pango_layout_set_wrap (icon_view->priv->layout, PANGO_WRAP_WORD_CHAR);
576 GTK_WIDGET_SET_FLAGS (icon_view, GTK_CAN_FOCUS);
578 gtk_icon_view_set_adjustments (icon_view, NULL, NULL);
580 icon_view->priv->orientation = GTK_ORIENTATION_VERTICAL;
584 gtk_icon_view_destroy (GtkObject *object)
586 GtkIconView *icon_view;
588 icon_view = GTK_ICON_VIEW (object);
590 gtk_icon_view_set_model (icon_view, NULL);
592 if (icon_view->priv->layout_idle_id != 0)
593 g_source_remove (icon_view->priv->layout_idle_id);
595 if (icon_view->priv->scroll_timeout_id != 0)
596 g_source_remove (icon_view->priv->scroll_timeout_id);
598 (GTK_OBJECT_CLASS (parent_class)->destroy) (object);
601 /* GObject methods */
603 gtk_icon_view_finalize (GObject *object)
605 GtkIconView *icon_view;
607 icon_view = GTK_ICON_VIEW (object);
609 g_object_unref (icon_view->priv->layout);
611 (G_OBJECT_CLASS (parent_class)->finalize) (object);
616 gtk_icon_view_set_property (GObject *object,
621 GtkIconView *icon_view;
623 icon_view = GTK_ICON_VIEW (object);
627 case PROP_SELECTION_MODE:
628 gtk_icon_view_set_selection_mode (icon_view, g_value_get_enum (value));
630 case PROP_PIXBUF_COLUMN:
631 gtk_icon_view_set_pixbuf_column (icon_view, g_value_get_int (value));
633 case PROP_TEXT_COLUMN:
634 gtk_icon_view_set_text_column (icon_view, g_value_get_int (value));
636 case PROP_MARKUP_COLUMN:
637 gtk_icon_view_set_markup_column (icon_view, g_value_get_int (value));
640 gtk_icon_view_set_model (icon_view, g_value_get_object (value));
642 case PROP_ORIENTATION:
643 gtk_icon_view_set_orientation (icon_view, g_value_get_enum (value));
647 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
653 gtk_icon_view_get_property (GObject *object,
658 GtkIconView *icon_view;
660 icon_view = GTK_ICON_VIEW (object);
664 case PROP_SELECTION_MODE:
665 g_value_set_enum (value, icon_view->priv->selection_mode);
667 case PROP_PIXBUF_COLUMN:
668 g_value_set_int (value, icon_view->priv->pixbuf_column);
670 case PROP_TEXT_COLUMN:
671 g_value_set_int (value, icon_view->priv->text_column);
673 case PROP_MARKUP_COLUMN:
674 g_value_set_int (value, icon_view->priv->markup_column);
677 g_value_set_object (value, icon_view->priv->model);
679 case PROP_ORIENTATION:
680 g_value_set_enum (value, icon_view->priv->orientation);
683 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
688 /* GtkWidget signals */
690 gtk_icon_view_realize (GtkWidget *widget)
692 GtkIconView *icon_view;
693 GdkWindowAttr attributes;
694 gint attributes_mask;
696 icon_view = GTK_ICON_VIEW (widget);
698 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
700 /* Make the main, clipping window */
701 attributes.window_type = GDK_WINDOW_CHILD;
702 attributes.x = widget->allocation.x;
703 attributes.y = widget->allocation.y;
704 attributes.width = widget->allocation.width;
705 attributes.height = widget->allocation.height;
706 attributes.wclass = GDK_INPUT_OUTPUT;
707 attributes.visual = gtk_widget_get_visual (widget);
708 attributes.colormap = gtk_widget_get_colormap (widget);
709 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK;
711 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
713 widget->window = gdk_window_new (gtk_widget_get_parent_window (widget),
714 &attributes, attributes_mask);
715 gdk_window_set_user_data (widget->window, widget);
717 /* Make the window for the icon view */
720 attributes.width = MAX (icon_view->priv->width, widget->allocation.width);
721 attributes.height = MAX (icon_view->priv->height, widget->allocation.height);
722 attributes.event_mask = (GDK_EXPOSURE_MASK |
724 GDK_POINTER_MOTION_MASK |
725 GDK_BUTTON_PRESS_MASK |
726 GDK_BUTTON_RELEASE_MASK |
728 GDK_KEY_RELEASE_MASK) |
729 gtk_widget_get_events (widget);
731 icon_view->priv->bin_window = gdk_window_new (widget->window,
732 &attributes, attributes_mask);
733 gdk_window_set_user_data (icon_view->priv->bin_window, widget);
735 widget->style = gtk_style_attach (widget->style, widget->window);
736 gdk_window_set_background (icon_view->priv->bin_window, &widget->style->base[widget->state]);
737 gdk_window_set_background (widget->window, &widget->style->base[widget->state]);
741 gtk_icon_view_unrealize (GtkWidget *widget)
743 GtkIconView *icon_view;
745 icon_view = GTK_ICON_VIEW (widget);
747 gdk_window_set_user_data (icon_view->priv->bin_window, NULL);
748 gdk_window_destroy (icon_view->priv->bin_window);
749 icon_view->priv->bin_window = NULL;
751 /* GtkWidget::unrealize destroys children and widget->window */
752 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
753 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
757 gtk_icon_view_map (GtkWidget *widget)
759 GtkIconView *icon_view;
761 icon_view = GTK_ICON_VIEW (widget);
763 GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
765 gdk_window_show (icon_view->priv->bin_window);
766 gdk_window_show (widget->window);
770 gtk_icon_view_size_request (GtkWidget *widget,
771 GtkRequisition *requisition)
773 GtkIconView *icon_view;
775 icon_view = GTK_ICON_VIEW (widget);
777 requisition->width = icon_view->priv->width;
778 requisition->height = icon_view->priv->height;
782 gtk_icon_view_size_allocate (GtkWidget *widget,
783 GtkAllocation *allocation)
785 GtkIconView *icon_view;
787 widget->allocation = *allocation;
789 icon_view = GTK_ICON_VIEW (widget);
791 if (GTK_WIDGET_REALIZED (widget))
793 gdk_window_move_resize (widget->window,
794 allocation->x, allocation->y,
795 allocation->width, allocation->height);
796 gdk_window_resize (icon_view->priv->bin_window,
797 MAX (icon_view->priv->width, allocation->width),
798 MAX (icon_view->priv->height, allocation->height));
801 icon_view->priv->hadjustment->page_size = allocation->width;
802 icon_view->priv->hadjustment->page_increment = allocation->width * 0.9;
803 icon_view->priv->hadjustment->step_increment = allocation->width * 0.1;
804 icon_view->priv->hadjustment->lower = 0;
805 icon_view->priv->hadjustment->upper = MAX (allocation->width, icon_view->priv->width);
806 gtk_adjustment_changed (icon_view->priv->hadjustment);
808 icon_view->priv->vadjustment->page_size = allocation->height;
809 icon_view->priv->vadjustment->page_increment = allocation->height * 0.9;
810 icon_view->priv->vadjustment->step_increment = allocation->width * 0.1;
811 icon_view->priv->vadjustment->lower = 0;
812 icon_view->priv->vadjustment->upper = MAX (allocation->height, icon_view->priv->height);
813 gtk_adjustment_changed (icon_view->priv->vadjustment);
815 gtk_icon_view_layout (icon_view);
819 gtk_icon_view_expose (GtkWidget *widget,
820 GdkEventExpose *expose)
822 GtkIconView *icon_view;
825 icon_view = GTK_ICON_VIEW (widget);
827 if (expose->window != icon_view->priv->bin_window)
830 for (icons = icon_view->priv->items; icons; icons = icons->next) {
831 GtkIconViewItem *item = icons->data;
832 GdkRectangle item_rectangle;
834 item_rectangle.x = item->x;
835 item_rectangle.y = item->y;
836 item_rectangle.width = item->width;
837 item_rectangle.height = item->height;
839 if (gdk_region_rect_in (expose->region, &item_rectangle) == GDK_OVERLAP_RECTANGLE_OUT)
842 gtk_icon_view_paint_item (icon_view, item, &expose->area);
845 if (icon_view->priv->doing_rubberband)
847 GdkRectangle *rectangles;
850 gdk_region_get_rectangles (expose->region,
854 while (n_rectangles--)
855 gtk_icon_view_paint_rubberband (icon_view, &rectangles[n_rectangles]);
864 scroll_timeout (gpointer data)
866 GtkIconView *icon_view;
871 value = MIN (icon_view->priv->vadjustment->value +
872 icon_view->priv->scroll_value_diff,
873 icon_view->priv->vadjustment->upper -
874 icon_view->priv->vadjustment->page_size);
876 gtk_adjustment_set_value (icon_view->priv->vadjustment,
879 gtk_icon_view_update_rubberband (icon_view);
885 gtk_icon_view_motion (GtkWidget *widget,
886 GdkEventMotion *event)
888 GtkIconView *icon_view;
891 icon_view = GTK_ICON_VIEW (widget);
893 gtk_icon_view_maybe_begin_dragging_items (icon_view, event);
895 if (icon_view->priv->doing_rubberband)
897 gtk_icon_view_update_rubberband (widget);
899 abs_y = event->y - icon_view->priv->height *
900 (icon_view->priv->vadjustment->value /
901 (icon_view->priv->vadjustment->upper -
902 icon_view->priv->vadjustment->lower));
904 if (abs_y < 0 || abs_y > widget->allocation.height)
906 if (icon_view->priv->scroll_timeout_id == 0)
907 icon_view->priv->scroll_timeout_id = g_timeout_add (30, scroll_timeout, icon_view);
910 icon_view->priv->scroll_value_diff = abs_y;
912 icon_view->priv->scroll_value_diff = abs_y - widget->allocation.height;
914 icon_view->priv->event_last_x = event->x;
915 icon_view->priv->event_last_y = event->y;
917 else if (icon_view->priv->scroll_timeout_id != 0)
919 g_source_remove (icon_view->priv->scroll_timeout_id);
921 icon_view->priv->scroll_timeout_id = 0;
929 gtk_icon_view_button_press (GtkWidget *widget,
930 GdkEventButton *event)
932 GtkIconView *icon_view;
933 GtkIconViewItem *item;
934 gboolean dirty = FALSE;
936 icon_view = GTK_ICON_VIEW (widget);
938 if (event->window != icon_view->priv->bin_window)
941 if (!GTK_WIDGET_HAS_FOCUS (widget))
942 gtk_widget_grab_focus (widget);
944 if (event->button == 1 && event->type == GDK_BUTTON_PRESS)
947 item = gtk_icon_view_get_item_at_pos (icon_view,
952 gtk_icon_view_scroll_to_item (icon_view, item);
954 if (icon_view->priv->selection_mode == GTK_SELECTION_NONE)
956 gtk_icon_view_set_cursor_item (icon_view, item);
958 else if (icon_view->priv->selection_mode == GTK_SELECTION_MULTIPLE &&
959 (event->state & GDK_SHIFT_MASK))
961 gtk_icon_view_unselect_all_internal (icon_view);
963 gtk_icon_view_set_cursor_item (icon_view, item);
964 if (!icon_view->priv->anchor_item)
965 icon_view->priv->anchor_item = item;
967 gtk_icon_view_select_all_between (icon_view,
968 icon_view->priv->anchor_item,
974 if (icon_view->priv->selection_mode == GTK_SELECTION_MULTIPLE &&
975 (event->state & GDK_CONTROL_MASK))
977 item->selected = !item->selected;
978 gtk_icon_view_queue_draw_item (icon_view, item);
985 gtk_icon_view_unselect_all_internal (icon_view);
987 item->selected = TRUE;
988 gtk_icon_view_queue_draw_item (icon_view, item);
992 gtk_icon_view_set_cursor_item (icon_view, item);
993 icon_view->priv->anchor_item = item;
996 /* Save press to possibly begin a drag */
997 if (icon_view->priv->pressed_button < 0)
999 icon_view->priv->pressed_button = event->button;
1000 icon_view->priv->press_start_x = event->x;
1001 icon_view->priv->press_start_y = event->y;
1004 if (!icon_view->priv->last_single_clicked)
1005 icon_view->priv->last_single_clicked = item;
1009 if (icon_view->priv->selection_mode != GTK_SELECTION_BROWSE &&
1010 !(event->state & GDK_CONTROL_MASK))
1012 dirty = gtk_icon_view_unselect_all_internal (icon_view);
1015 if (icon_view->priv->selection_mode == GTK_SELECTION_MULTIPLE)
1016 gtk_icon_view_start_rubberbanding (icon_view, event->x, event->y);
1021 if (event->button == 1 && event->type == GDK_2BUTTON_PRESS)
1023 item = gtk_icon_view_get_item_at_pos (icon_view,
1024 event->x, event->y);
1026 if (item && item == icon_view->priv->last_single_clicked)
1030 path = gtk_tree_path_new_from_indices (item->index, -1);
1031 gtk_icon_view_item_activated (icon_view, path);
1032 gtk_tree_path_free (path);
1035 icon_view->priv->last_single_clicked = NULL;
1039 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
1045 gtk_icon_view_button_release (GtkWidget *widget,
1046 GdkEventButton *event)
1048 GtkIconView *icon_view;
1050 icon_view = GTK_ICON_VIEW (widget);
1053 if (icon_view->priv->pressed_button == event->button)
1054 icon_view->priv->pressed_button = -1;
1056 gtk_icon_view_stop_rubberbanding (icon_view);
1058 if (icon_view->priv->scroll_timeout_id != 0)
1060 g_source_remove (icon_view->priv->scroll_timeout_id);
1061 icon_view->priv->scroll_timeout_id = 0;
1068 gtk_icon_view_update_rubberband (gpointer data)
1070 GtkIconView *icon_view;
1072 GdkRectangle old_area;
1073 GdkRectangle new_area;
1074 GdkRectangle common;
1075 GdkRegion *invalid_region;
1077 icon_view = GTK_ICON_VIEW (data);
1079 gdk_window_get_pointer (icon_view->priv->bin_window, &x, &y, NULL);
1084 old_area.x = MIN (icon_view->priv->rubberband_x1,
1085 icon_view->priv->rubberband_x2);
1086 old_area.y = MIN (icon_view->priv->rubberband_y1,
1087 icon_view->priv->rubberband_y2);
1088 old_area.width = ABS (icon_view->priv->rubberband_x2 -
1089 icon_view->priv->rubberband_x1) + 1;
1090 old_area.height = ABS (icon_view->priv->rubberband_y2 -
1091 icon_view->priv->rubberband_y1) + 1;
1093 new_area.x = MIN (icon_view->priv->rubberband_x1, x);
1094 new_area.y = MIN (icon_view->priv->rubberband_y1, y);
1095 new_area.width = ABS (x - icon_view->priv->rubberband_x1) + 1;
1096 new_area.height = ABS (y - icon_view->priv->rubberband_y1) + 1;
1098 invalid_region = gdk_region_rectangle (&old_area);
1099 gdk_region_union_with_rect (invalid_region, &new_area);
1101 gdk_rectangle_intersect (&old_area, &new_area, &common);
1102 if (common.width > 2 && common.height > 2)
1104 GdkRegion *common_region;
1106 /* make sure the border is invalidated */
1112 common_region = gdk_region_rectangle (&common);
1114 gdk_region_subtract (invalid_region, common_region);
1115 gdk_region_destroy (common_region);
1118 gdk_window_invalidate_region (icon_view->priv->bin_window, invalid_region, TRUE);
1120 gdk_region_destroy (invalid_region);
1122 icon_view->priv->rubberband_x2 = x;
1123 icon_view->priv->rubberband_y2 = y;
1125 gtk_icon_view_update_rubberband_selection (icon_view);
1129 gtk_icon_view_start_rubberbanding (GtkIconView *icon_view,
1135 g_assert (!icon_view->priv->doing_rubberband);
1137 for (items = icon_view->priv->items; items; items = items->next)
1139 GtkIconViewItem *item = items->data;
1141 item->selected_before_rubberbanding = item->selected;
1144 icon_view->priv->rubberband_x1 = x;
1145 icon_view->priv->rubberband_y1 = y;
1146 icon_view->priv->rubberband_x2 = x;
1147 icon_view->priv->rubberband_y2 = y;
1149 icon_view->priv->doing_rubberband = TRUE;
1151 gtk_grab_add (GTK_WIDGET (icon_view));
1155 gtk_icon_view_stop_rubberbanding (GtkIconView *icon_view)
1157 if (!icon_view->priv->doing_rubberband)
1160 icon_view->priv->doing_rubberband = FALSE;
1162 gtk_grab_remove (GTK_WIDGET (icon_view));
1164 gtk_widget_queue_draw (GTK_WIDGET (icon_view));
1168 gtk_icon_view_update_rubberband_selection (GtkIconView *icon_view)
1171 gint x, y, width, height;
1172 gboolean dirty = FALSE;
1174 x = MIN (icon_view->priv->rubberband_x1,
1175 icon_view->priv->rubberband_x2);
1176 y = MIN (icon_view->priv->rubberband_y1,
1177 icon_view->priv->rubberband_y2);
1178 width = ABS (icon_view->priv->rubberband_x1 -
1179 icon_view->priv->rubberband_x2);
1180 height = ABS (icon_view->priv->rubberband_y1 -
1181 icon_view->priv->rubberband_y2);
1183 for (items = icon_view->priv->items; items; items = items->next)
1185 GtkIconViewItem *item = items->data;
1189 is_in = gtk_icon_view_item_hit_test (item, x, y, width, height);
1191 selected = is_in ^ item->selected_before_rubberbanding;
1193 if (item->selected != selected)
1195 item->selected = selected;
1197 gtk_icon_view_queue_draw_item (icon_view, item);
1202 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
1206 gtk_icon_view_item_hit_test (GtkIconViewItem *item,
1212 /* First try the pixbuf */
1213 if (MIN (x + width, item->pixbuf_x + item->pixbuf_width) - MAX (x, item->pixbuf_x) > 0 &&
1214 MIN (y + height, item->pixbuf_y + item->pixbuf_height) - MAX (y, item->pixbuf_y) > 0)
1217 /* Then try the text */
1218 if (MIN (x + width, item->layout_x + item->layout_width) - MAX (x, item->layout_x) > 0 &&
1219 MIN (y + height, item->layout_y + item->layout_height) - MAX (y, item->layout_y) > 0)
1227 gtk_icon_view_maybe_begin_dragging_items (GtkIconView *icon_view,
1228 GdkEventMotion *event)
1230 gboolean retval = FALSE;
1232 if (icon_view->priv->pressed_button < 0)
1235 if (!gtk_drag_check_threshold (GTK_WIDGET (icon_view),
1236 icon_view->priv->press_start_x,
1237 icon_view->priv->press_start_y,
1238 event->x, event->y))
1241 button = icon_view->priv->pressed_button;
1242 icon_view->priv->pressed_button = -1;
1245 static GtkTargetEntry row_targets[] = {
1246 { "GTK_ICON_VIEW_ITEMS", GTK_TARGET_SAME_APP, 0 }
1248 GtkTargetList *target_list;
1249 GdkDragContext *context;
1250 GtkIconViewItem *item;
1254 target_list = gtk_target_list_new (row_targets, G_N_ELEMENTS (row_targets));
1256 context = gtk_drag_begin (GTK_WIDGET (icon_view),
1257 target_list, GDK_ACTION_MOVE,
1261 item = gtk_icon_view_get_item_at_pos (icon_view,
1262 icon_view->priv->press_start_x,
1263 icon_view->priv->press_start_y);
1264 g_assert (item != NULL);
1265 gtk_drag_set_icon_pixbuf (context, gtk_icon_view_get_item_icon (icon_view, item),
1267 event->y - item->y);
1275 gtk_icon_view_unselect_all_internal (GtkIconView *icon_view)
1277 gboolean dirty = FALSE;
1280 if (icon_view->priv->selection_mode == GTK_SELECTION_NONE ||
1281 icon_view->priv->selection_mode == GTK_SELECTION_BROWSE)
1284 for (items = icon_view->priv->items; items; items = items->next)
1286 GtkIconViewItem *item = items->data;
1290 item->selected = FALSE;
1292 gtk_icon_view_queue_draw_item (icon_view, item);
1300 /* GtkIconView signals */
1302 gtk_icon_view_set_adjustments (GtkIconView *icon_view,
1303 GtkAdjustment *hadj,
1304 GtkAdjustment *vadj)
1306 gboolean need_adjust = FALSE;
1309 g_return_if_fail (GTK_IS_ADJUSTMENT (hadj));
1311 hadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
1313 g_return_if_fail (GTK_IS_ADJUSTMENT (vadj));
1315 vadj = GTK_ADJUSTMENT (gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0));
1317 if (icon_view->priv->hadjustment && (icon_view->priv->hadjustment != hadj))
1319 g_signal_handlers_disconnect_matched (icon_view->priv->hadjustment, G_SIGNAL_MATCH_DATA,
1320 0, 0, NULL, NULL, icon_view);
1321 g_object_unref (icon_view->priv->hadjustment);
1324 if (icon_view->priv->vadjustment && (icon_view->priv->vadjustment != vadj))
1326 g_signal_handlers_disconnect_matched (icon_view->priv->vadjustment, G_SIGNAL_MATCH_DATA,
1327 0, 0, NULL, NULL, icon_view);
1328 g_object_unref (icon_view->priv->vadjustment);
1331 if (icon_view->priv->hadjustment != hadj)
1333 icon_view->priv->hadjustment = hadj;
1334 g_object_ref (icon_view->priv->hadjustment);
1335 gtk_object_sink (GTK_OBJECT (icon_view->priv->hadjustment));
1337 g_signal_connect (icon_view->priv->hadjustment, "value_changed",
1338 G_CALLBACK (gtk_icon_view_adjustment_changed),
1343 if (icon_view->priv->vadjustment != vadj)
1345 icon_view->priv->vadjustment = vadj;
1346 g_object_ref (icon_view->priv->vadjustment);
1347 gtk_object_sink (GTK_OBJECT (icon_view->priv->vadjustment));
1349 g_signal_connect (icon_view->priv->vadjustment, "value_changed",
1350 G_CALLBACK (gtk_icon_view_adjustment_changed),
1356 gtk_icon_view_adjustment_changed (NULL, icon_view);
1360 gtk_icon_view_real_select_all (GtkIconView *icon_view)
1362 gtk_icon_view_select_all (icon_view);
1366 gtk_icon_view_real_unselect_all (GtkIconView *icon_view)
1368 if (icon_view->priv->selection_mode == GTK_SELECTION_BROWSE)
1371 gtk_icon_view_unselect_all (icon_view);
1375 gtk_icon_view_real_select_cursor_item (GtkIconView *icon_view)
1377 gtk_icon_view_unselect_all (icon_view);
1379 if (icon_view->priv->cursor_item != NULL)
1380 gtk_icon_view_select_item (icon_view, icon_view->priv->cursor_item);
1384 gtk_icon_view_real_activate_cursor_item (GtkIconView *icon_view)
1388 if (!icon_view->priv->cursor_item)
1391 path = gtk_tree_path_new_from_indices (icon_view->priv->cursor_item->index, -1);
1393 gtk_icon_view_item_activated (icon_view, path);
1395 gtk_tree_path_free (path);
1401 gtk_icon_view_real_toggle_cursor_item (GtkIconView *icon_view)
1403 if (!icon_view->priv->cursor_item)
1406 switch (icon_view->priv->selection_mode)
1408 case GTK_SELECTION_NONE:
1410 case GTK_SELECTION_BROWSE:
1411 gtk_icon_view_select_item (icon_view, icon_view->priv->cursor_item);
1413 case GTK_SELECTION_SINGLE:
1414 if (icon_view->priv->cursor_item->selected)
1415 gtk_icon_view_unselect_item (icon_view, icon_view->priv->cursor_item);
1417 gtk_icon_view_select_item (icon_view, icon_view->priv->cursor_item);
1419 case GTK_SELECTION_MULTIPLE:
1420 icon_view->priv->cursor_item->selected = !icon_view->priv->cursor_item->selected;
1421 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
1423 gtk_icon_view_queue_draw_item (icon_view, icon_view->priv->cursor_item);
1428 /* Internal functions */
1430 gtk_icon_view_adjustment_changed (GtkAdjustment *adjustment,
1431 GtkIconView *icon_view)
1433 if (GTK_WIDGET_REALIZED (icon_view))
1435 gdk_window_move (icon_view->priv->bin_window,
1436 - icon_view->priv->hadjustment->value,
1437 - icon_view->priv->vadjustment->value);
1439 if (icon_view->priv->doing_rubberband)
1440 gtk_icon_view_update_rubberband (GTK_WIDGET (icon_view));
1442 gdk_window_process_updates (icon_view->priv->bin_window, TRUE);
1447 gtk_icon_view_layout_single_row (GtkIconView *icon_view, GList *first_item, gint *y, gint *maximum_width, gint row)
1449 gint focus_width, focus_pad;
1450 gint x, current_width, max_height, max_pixbuf_height;
1451 GList *items, *last_item;
1452 gint maximum_layout_width;
1454 gboolean rtl = gtk_widget_get_direction (GTK_WIDGET (icon_view)) == GTK_TEXT_DIR_RTL;
1459 max_pixbuf_height = 0;
1463 gtk_widget_style_get (GTK_WIDGET (icon_view),
1464 "focus-line-width", &focus_width,
1465 "focus-padding", &focus_pad,
1468 x += ICON_VIEW_LEFT_MARGIN;
1469 current_width += ICON_VIEW_LEFT_MARGIN + ICON_VIEW_RIGHT_MARGIN;
1474 GtkIconViewItem *item = items->data;
1476 gtk_icon_view_calculate_item_size (icon_view, item);
1478 current_width += MAX (item->width, MINIMUM_ICON_ITEM_WIDTH);
1480 /* Don't add padding to the first or last icon */
1482 if (current_width > GTK_WIDGET (icon_view)->allocation.width &&
1483 items != first_item)
1486 maximum_layout_width = MAX (item->pixbuf_width, MINIMUM_ICON_ITEM_WIDTH);
1489 item->x = rtl ? GTK_WIDGET (icon_view)->allocation.width - item->width - x : x;
1490 if (item->width < MINIMUM_ICON_ITEM_WIDTH) {
1492 item->x -= (MINIMUM_ICON_ITEM_WIDTH - item->width) / 2;
1494 item->x += (MINIMUM_ICON_ITEM_WIDTH - item->width) / 2;
1495 x += (MINIMUM_ICON_ITEM_WIDTH - item->width);
1498 if (icon_view->priv->orientation == GTK_ORIENTATION_HORIZONTAL)
1500 if (gtk_widget_get_direction (GTK_WIDGET (icon_view)) == GTK_TEXT_DIR_RTL)
1502 item->layout_x = item->x + ICON_TEXT_PADDING + focus_width + focus_pad;
1503 item->pixbuf_x = item->x + 2 * (ICON_TEXT_PADDING + focus_width + focus_pad) + item->layout_width;
1507 item->pixbuf_x = item->x;
1508 item->layout_x = item->x + item->pixbuf_width + ICON_TEXT_PADDING + focus_width + focus_pad;
1513 item->pixbuf_x = item->x + (item->width - item->pixbuf_width) / 2;
1514 item->layout_x = item->x + (item->width - item->layout_width) / 2;
1519 max_height = MAX (max_height, item->height);
1520 max_pixbuf_height = MAX (max_pixbuf_height, item->pixbuf_height);
1522 if (current_width > *maximum_width)
1523 *maximum_width = current_width;
1529 items = items->next;
1534 *y += max_height + ICON_VIEW_ICON_PADDING;
1536 /* Now go through the row again and align the icons */
1537 for (items = first_item; items != last_item; items = items->next)
1539 GtkIconViewItem *item = items->data;
1541 if (icon_view->priv->orientation == GTK_ORIENTATION_HORIZONTAL)
1543 item->pixbuf_y = item->y;
1544 item->layout_y = item->y + ICON_TEXT_PADDING + focus_width + focus_pad;
1548 item->pixbuf_y = item->y + (max_pixbuf_height - item->pixbuf_height);
1549 item->layout_y = item->pixbuf_y + item->pixbuf_height + ICON_TEXT_PADDING + focus_width + focus_pad;
1551 /* Update the bounding box */
1552 item->y = item->pixbuf_y;
1554 /* We may want to readjust the new y coordinate. */
1555 if (item->y + item->height > *y)
1556 *y = item->y + item->height;
1559 item->col = col - 1 - item->col;
1566 gtk_icon_view_set_adjustment_upper (GtkAdjustment *adj,
1569 if (upper != adj->upper)
1571 gdouble min = MAX (0.0, upper - adj->page_size);
1572 gboolean value_changed = FALSE;
1576 if (adj->value > min)
1579 value_changed = TRUE;
1582 gtk_adjustment_changed (adj);
1585 gtk_adjustment_value_changed (adj);
1590 gtk_icon_view_layout (GtkIconView *icon_view)
1592 gint y = 0, maximum_width = 0;
1597 if (!VALID_MODEL_AND_COLUMNS (icon_view))
1600 widget = GTK_WIDGET (icon_view);
1601 icons = icon_view->priv->items;
1603 y += ICON_VIEW_TOP_MARGIN;
1608 icons = gtk_icon_view_layout_single_row (icon_view, icons, &y, &maximum_width, row);
1611 while (icons != NULL);
1613 if (maximum_width != icon_view->priv->width)
1615 icon_view->priv->width = maximum_width;
1617 y += ICON_VIEW_BOTTOM_MARGIN;
1619 if (y != icon_view->priv->height)
1621 icon_view->priv->height = y;
1624 gtk_icon_view_set_adjustment_upper (icon_view->priv->hadjustment, icon_view->priv->width);
1625 gtk_icon_view_set_adjustment_upper (icon_view->priv->vadjustment, icon_view->priv->height);
1627 if (GTK_WIDGET_REALIZED (icon_view))
1629 gdk_window_resize (icon_view->priv->bin_window,
1630 MAX (icon_view->priv->width, widget->allocation.width),
1631 MAX (icon_view->priv->height, widget->allocation.height));
1634 if (icon_view->priv->layout_idle_id != 0)
1636 g_source_remove (icon_view->priv->layout_idle_id);
1637 icon_view->priv->layout_idle_id = 0;
1640 gtk_widget_queue_draw (GTK_WIDGET (icon_view));
1643 /* Updates the pango layout and calculates the size */
1645 gtk_icon_view_calculate_item_size (GtkIconView *icon_view,
1646 GtkIconViewItem *item)
1648 gint focus_width, focus_pad;
1649 gint layout_width, layout_height;
1650 gint maximum_layout_width;
1653 if (item->width != -1 && item->width != -1)
1656 gtk_widget_style_get (GTK_WIDGET (icon_view),
1657 "focus-line-width", &focus_width,
1658 "focus-padding", &focus_pad,
1661 if (icon_view->priv->pixbuf_column != -1)
1663 pixbuf = gtk_icon_view_get_item_icon (icon_view, item);
1664 item->pixbuf_width = gdk_pixbuf_get_width (pixbuf);
1665 item->pixbuf_height = gdk_pixbuf_get_height (pixbuf);
1666 g_object_unref (pixbuf);
1670 item->pixbuf_width = 0;
1671 item->pixbuf_height = 0;
1674 maximum_layout_width = MAX (item->pixbuf_width, MINIMUM_ICON_ITEM_WIDTH);
1676 if (icon_view->priv->markup_column != 1 ||
1677 icon_view->priv->text_column != -1)
1679 gtk_icon_view_update_item_text (icon_view, item);
1681 pango_layout_set_alignment (icon_view->priv->layout, PANGO_ALIGN_CENTER);
1682 pango_layout_set_width (icon_view->priv->layout, maximum_layout_width * PANGO_SCALE);
1684 pango_layout_get_pixel_size (icon_view->priv->layout, &layout_width, &layout_height);
1686 item->layout_width = layout_width;
1687 item->layout_height = layout_height;
1691 item->layout_width = 0;
1692 item->layout_height = 0;
1695 if (icon_view->priv->orientation == GTK_ORIENTATION_HORIZONTAL)
1697 item->width = layout_width + 2 * (ICON_TEXT_PADDING + focus_width + focus_pad) + item->pixbuf_width;
1698 item->height = MAX (layout_height + 2 * (ICON_TEXT_PADDING + focus_width + focus_pad), item->pixbuf_height);
1702 item->width = MAX (layout_width + 2 * (ICON_TEXT_PADDING + focus_width + focus_pad), item->pixbuf_width);
1703 item->height = layout_height + 2 * (ICON_TEXT_PADDING + focus_width + focus_pad) + item->pixbuf_height;
1708 gtk_icon_view_invalidate_sizes (GtkIconView *icon_view)
1710 g_list_foreach (icon_view->priv->items,
1711 (GFunc)gtk_icon_view_item_invalidate_size, NULL);
1715 gtk_icon_view_item_invalidate_size (GtkIconViewItem *item)
1722 create_colorized_pixbuf (GdkPixbuf *src, GdkColor *new_color)
1725 gint width, height, has_alpha, src_row_stride, dst_row_stride;
1726 gint red_value, green_value, blue_value;
1727 guchar *target_pixels;
1728 guchar *original_pixels;
1733 red_value = new_color->red / 255.0;
1734 green_value = new_color->green / 255.0;
1735 blue_value = new_color->blue / 255.0;
1737 dest = gdk_pixbuf_new (gdk_pixbuf_get_colorspace (src),
1738 gdk_pixbuf_get_has_alpha (src),
1739 gdk_pixbuf_get_bits_per_sample (src),
1740 gdk_pixbuf_get_width (src),
1741 gdk_pixbuf_get_height (src));
1743 has_alpha = gdk_pixbuf_get_has_alpha (src);
1744 width = gdk_pixbuf_get_width (src);
1745 height = gdk_pixbuf_get_height (src);
1746 src_row_stride = gdk_pixbuf_get_rowstride (src);
1747 dst_row_stride = gdk_pixbuf_get_rowstride (dest);
1748 target_pixels = gdk_pixbuf_get_pixels (dest);
1749 original_pixels = gdk_pixbuf_get_pixels (src);
1751 for (i = 0; i < height; i++) {
1752 pixdest = target_pixels + i*dst_row_stride;
1753 pixsrc = original_pixels + i*src_row_stride;
1754 for (j = 0; j < width; j++) {
1755 *pixdest++ = (*pixsrc++ * red_value) >> 8;
1756 *pixdest++ = (*pixsrc++ * green_value) >> 8;
1757 *pixdest++ = (*pixsrc++ * blue_value) >> 8;
1759 *pixdest++ = *pixsrc++;
1767 gtk_icon_view_paint_item (GtkIconView *icon_view,
1768 GtkIconViewItem *item,
1771 gint focus_width, focus_pad;
1772 GdkPixbuf *pixbuf, *tmp;
1775 if (!VALID_MODEL_AND_COLUMNS (icon_view))
1778 gtk_widget_style_get (GTK_WIDGET (icon_view),
1779 "focus-line-width", &focus_width,
1780 "focus-padding", &focus_pad,
1783 if (GTK_WIDGET_HAS_FOCUS (icon_view))
1784 state = GTK_STATE_SELECTED;
1786 state = GTK_STATE_ACTIVE;
1788 if (icon_view->priv->pixbuf_column != -1)
1790 tmp = gtk_icon_view_get_item_icon (icon_view, item);
1793 pixbuf = create_colorized_pixbuf (tmp,
1794 >K_WIDGET (icon_view)->style->base[state]);
1795 g_object_unref (tmp);
1800 gdk_draw_pixbuf (icon_view->priv->bin_window, NULL, pixbuf,
1802 item->pixbuf_x, item->pixbuf_y,
1803 item->pixbuf_width, item->pixbuf_height,
1804 GDK_RGB_DITHER_NORMAL,
1805 item->pixbuf_width, item->pixbuf_height);
1806 g_object_unref (pixbuf);
1809 if (icon_view->priv->text_column != -1)
1813 gdk_draw_rectangle (icon_view->priv->bin_window,
1814 GTK_WIDGET (icon_view)->style->base_gc[state],
1816 item->layout_x - ICON_TEXT_PADDING,
1817 item->layout_y - ICON_TEXT_PADDING,
1818 item->layout_width + 2 * ICON_TEXT_PADDING,
1819 item->layout_height + 2 * ICON_TEXT_PADDING);
1822 gtk_icon_view_update_item_text (icon_view, item);
1823 gtk_paint_layout (GTK_WIDGET (icon_view)->style,
1824 icon_view->priv->bin_window,
1825 item->selected ? state : GTK_STATE_NORMAL,
1826 TRUE, area, GTK_WIDGET (icon_view), "icon_view",
1827 item->layout_x - ((item->width - item->layout_width) / 2) - (MAX (item->pixbuf_width, MINIMUM_ICON_ITEM_WIDTH) - item->width) / 2,
1829 icon_view->priv->layout);
1831 if (GTK_WIDGET_HAS_FOCUS (icon_view) &&
1832 item == icon_view->priv->cursor_item)
1833 gtk_paint_focus (GTK_WIDGET (icon_view)->style,
1834 icon_view->priv->bin_window,
1837 GTK_WIDGET (icon_view),
1839 item->layout_x - ICON_TEXT_PADDING - focus_width - focus_pad,
1840 item->layout_y - ICON_TEXT_PADDING - focus_width - focus_pad,
1841 item->layout_width + 2 * (ICON_TEXT_PADDING + focus_width + focus_pad),
1842 item->layout_height + 2 * (ICON_TEXT_PADDING + focus_width + focus_pad));
1847 gtk_gdk_color_to_rgb (const GdkColor *color)
1850 result = (0xff0000 | (color->red & 0xff00));
1852 result |= ((color->green & 0xff00) | (color->blue >> 8));
1857 gtk_icon_view_paint_rubberband (GtkIconView *icon_view,
1863 GdkRectangle rubber_rect;
1864 GdkColor *fill_color_gdk;
1866 guchar fill_color_alpha;
1868 rubber_rect.x = MIN (icon_view->priv->rubberband_x1, icon_view->priv->rubberband_x2);
1869 rubber_rect.y = MIN (icon_view->priv->rubberband_y1, icon_view->priv->rubberband_y2);
1870 rubber_rect.width = ABS (icon_view->priv->rubberband_x1 - icon_view->priv->rubberband_x2) + 1;
1871 rubber_rect.height = ABS (icon_view->priv->rubberband_y1 - icon_view->priv->rubberband_y2) + 1;
1873 if (!gdk_rectangle_intersect (&rubber_rect, area, &rect))
1876 gtk_widget_style_get (GTK_WIDGET (icon_view),
1877 "selection_box_color", &fill_color_gdk,
1878 "selection_box_alpha", &fill_color_alpha,
1881 if (!fill_color_gdk) {
1882 fill_color_gdk = gdk_color_copy (>K_WIDGET (icon_view)->style->base[GTK_STATE_SELECTED]);
1885 fill_color = gtk_gdk_color_to_rgb (fill_color_gdk) << 8 | fill_color_alpha;
1887 if (!gdk_draw_rectangle_alpha_libgtk_only (icon_view->priv->bin_window,
1888 rect.x, rect.y, rect.width, rect.height,
1890 fill_color_alpha << 8 | fill_color_alpha))
1892 pixbuf = gdk_pixbuf_new (GDK_COLORSPACE_RGB, TRUE, 8, rect.width, rect.height);
1893 gdk_pixbuf_fill (pixbuf, fill_color);
1895 gdk_draw_pixbuf (icon_view->priv->bin_window, NULL, pixbuf,
1898 rect.width, rect.height,
1899 GDK_RGB_DITHER_NONE,
1901 g_object_unref (pixbuf);
1904 gc = gdk_gc_new (icon_view->priv->bin_window);
1905 gdk_gc_set_rgb_fg_color (gc, fill_color_gdk);
1906 gdk_gc_set_clip_rectangle (gc, &rect);
1907 gdk_draw_rectangle (icon_view->priv->bin_window,
1909 rubber_rect.x, rubber_rect.y,
1910 rubber_rect.width - 1, rubber_rect.height - 1);
1911 gdk_color_free (fill_color_gdk);
1912 g_object_unref (gc);
1916 gtk_icon_view_queue_draw_item (GtkIconView *icon_view,
1917 GtkIconViewItem *item)
1923 rect.width = item->width;
1924 rect.height = item->height;
1926 if (icon_view->priv->bin_window)
1927 gdk_window_invalidate_rect (icon_view->priv->bin_window, &rect, TRUE);
1931 layout_callback (gpointer user_data)
1933 GtkIconView *icon_view;
1935 icon_view = GTK_ICON_VIEW (user_data);
1937 icon_view->priv->layout_idle_id = 0;
1939 gtk_icon_view_layout (icon_view);
1945 gtk_icon_view_queue_layout (GtkIconView *icon_view)
1947 if (icon_view->priv->layout_idle_id != 0)
1950 icon_view->priv->layout_idle_id = g_idle_add (layout_callback, icon_view);
1954 gtk_icon_view_set_cursor_item (GtkIconView *icon_view,
1955 GtkIconViewItem *item)
1957 if (icon_view->priv->cursor_item == item)
1960 if (icon_view->priv->cursor_item != NULL)
1961 gtk_icon_view_queue_draw_item (icon_view, icon_view->priv->cursor_item);
1963 icon_view->priv->cursor_item = item;
1964 gtk_icon_view_queue_draw_item (icon_view, item);
1968 static GtkIconViewItem *
1969 gtk_icon_view_item_new (void)
1971 GtkIconViewItem *item;
1973 item = g_new0 (GtkIconViewItem, 1);
1982 gtk_icon_view_item_free (GtkIconViewItem *item)
1984 g_return_if_fail (item != NULL);
1990 gtk_icon_view_update_item_text (GtkIconView *icon_view,
1991 GtkIconViewItem *item)
1993 gboolean iters_persist;
1998 iters_persist = gtk_tree_model_get_flags (icon_view->priv->model) & GTK_TREE_MODEL_ITERS_PERSIST;
2002 path = gtk_tree_path_new_from_indices (item->index, -1);
2003 gtk_tree_model_get_iter (icon_view->priv->model, &iter, path);
2004 gtk_tree_path_free (path);
2009 if (icon_view->priv->markup_column != -1)
2011 gtk_tree_model_get (icon_view->priv->model, &iter,
2012 icon_view->priv->markup_column, &text,
2014 pango_layout_set_markup (icon_view->priv->layout, text, -1);
2018 gtk_tree_model_get (icon_view->priv->model, &iter,
2019 icon_view->priv->text_column, &text,
2021 pango_layout_set_text (icon_view->priv->layout, text, -1);
2028 gtk_icon_view_get_item_icon (GtkIconView *icon_view,
2029 GtkIconViewItem *item)
2031 gboolean iters_persist;
2036 g_return_val_if_fail (item != NULL, NULL);
2038 iters_persist = gtk_tree_model_get_flags (icon_view->priv->model) & GTK_TREE_MODEL_ITERS_PERSIST;
2042 path = gtk_tree_path_new_from_indices (item->index, -1);
2043 gtk_tree_model_get_iter (icon_view->priv->model, &iter, path);
2044 gtk_tree_path_free (path);
2049 gtk_tree_model_get (icon_view->priv->model, &iter,
2050 icon_view->priv->pixbuf_column, &pixbuf,
2057 static GtkIconViewItem *
2058 gtk_icon_view_get_item_at_pos (GtkIconView *icon_view,
2064 for (items = icon_view->priv->items; items; items = items->next)
2066 GtkIconViewItem *item = items->data;
2068 if (x > item->x && x < item->x + item->width &&
2069 y > item->y && y < item->y + item->height)
2071 gint layout_x = item->x + (item->width - item->layout_width) / 2;
2072 /* Check if the mouse is inside the icon or the label */
2073 if ((x > item->pixbuf_x && x < item->pixbuf_x + item->pixbuf_width &&
2074 y > item->pixbuf_y && y < item->pixbuf_y + item->pixbuf_height) ||
2075 (x > layout_x - ICON_TEXT_PADDING &&
2076 x < layout_x + item->layout_width + ICON_TEXT_PADDING * 2 &&
2077 y > item->layout_y - ICON_TEXT_PADDING
2078 && y < item->layout_y + item->layout_height + ICON_TEXT_PADDING * 2))
2087 gtk_icon_view_select_item (GtkIconView *icon_view,
2088 GtkIconViewItem *item)
2090 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
2091 g_return_if_fail (item != NULL);
2096 if (icon_view->priv->selection_mode == GTK_SELECTION_NONE)
2098 else if (icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE)
2099 gtk_icon_view_unselect_all_internal (icon_view);
2101 item->selected = TRUE;
2103 gtk_icon_view_queue_draw_item (icon_view, item);
2105 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
2110 gtk_icon_view_unselect_item (GtkIconView *icon_view,
2111 GtkIconViewItem *item)
2113 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
2114 g_return_if_fail (item != NULL);
2116 if (!item->selected)
2119 if (icon_view->priv->selection_mode == GTK_SELECTION_NONE ||
2120 icon_view->priv->selection_mode == GTK_SELECTION_BROWSE)
2123 item->selected = FALSE;
2125 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
2127 gtk_icon_view_queue_draw_item (icon_view, item);
2131 verify_items (GtkIconView *icon_view)
2136 for (items = icon_view->priv->items; items; items = items->next)
2138 GtkIconViewItem *item = items->data;
2140 if (item->index != i)
2141 g_error ("List item does not match its index: item index %d and list index %d\n", item->index, i);
2148 gtk_icon_view_row_changed (GtkTreeModel *model,
2153 GtkIconViewItem *item;
2155 GtkIconView *icon_view;
2157 icon_view = GTK_ICON_VIEW (data);
2159 index = gtk_tree_path_get_indices(path)[0];
2160 item = g_list_nth (icon_view->priv->items, index)->data;
2162 gtk_icon_view_item_invalidate_size (item);
2163 gtk_icon_view_queue_layout (icon_view);
2165 verify_items (icon_view);
2169 gtk_icon_view_row_inserted (GtkTreeModel *model,
2175 GtkIconViewItem *item;
2176 gboolean iters_persist;
2177 GtkIconView *icon_view;
2180 icon_view = GTK_ICON_VIEW (data);
2181 iters_persist = gtk_tree_model_get_flags (icon_view->priv->model) & GTK_TREE_MODEL_ITERS_PERSIST;
2183 length = gtk_tree_model_iter_n_children (model, NULL);
2184 index = gtk_tree_path_get_indices(path)[0];
2186 item = gtk_icon_view_item_new ();
2191 item->index = index;
2193 /* FIXME: We can be more efficient here,
2194 we can store a tail pointer and use that when
2195 appending (which is a rather common operation)
2197 icon_view->priv->items = g_list_insert (icon_view->priv->items,
2200 list = g_list_nth (icon_view->priv->items, index + 1);
2201 for (; list; list = list->next)
2208 verify_items (icon_view);
2212 gtk_icon_view_row_deleted (GtkTreeModel *model,
2217 GtkIconView *icon_view;
2218 GtkIconViewItem *item;
2220 gboolean emit = FALSE;
2222 icon_view = GTK_ICON_VIEW (data);
2224 index = gtk_tree_path_get_indices(path)[0];
2226 list = g_list_nth (icon_view->priv->items, index);
2229 if (item == icon_view->priv->anchor_item)
2230 icon_view->priv->anchor_item = NULL;
2232 if (item == icon_view->priv->cursor_item)
2233 icon_view->priv->cursor_item = NULL;
2238 gtk_icon_view_item_free (item);
2240 for (next = list->next; next; next = next->next)
2247 icon_view->priv->items = g_list_delete_link (icon_view->priv->items, list);
2249 gtk_icon_view_queue_layout (icon_view);
2251 verify_items (icon_view);
2254 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
2258 gtk_icon_view_rows_reordered (GtkTreeModel *model,
2259 GtkTreePath *parent,
2266 GtkIconView *icon_view;
2267 GList *items = NULL, *list;
2268 gint *inverted_order;
2269 GtkIconViewItem **item_array;
2271 icon_view = GTK_ICON_VIEW (data);
2273 length = gtk_tree_model_iter_n_children (model, NULL);
2274 inverted_order = g_new (gint, length);
2276 /* Invert the array */
2277 for (i = 0; i < length; i++)
2278 inverted_order[new_order[i]] = i;
2280 item_array = g_new (GtkIconViewItem *, length);
2281 for (i = 0, list = icon_view->priv->items; list != NULL; list = list->next, i++)
2282 item_array[inverted_order[i]] = list->data;
2284 g_free (inverted_order);
2285 for (i = 0; i < length; i++)
2287 item_array[i]->index = i;
2288 items = g_list_prepend (items, item_array[i]);
2291 g_free (item_array);
2292 g_list_free (icon_view->priv->items);
2293 icon_view->priv->items = g_list_reverse (items);
2295 verify_items (icon_view);
2299 gtk_icon_view_build_items (GtkIconView *icon_view)
2303 gboolean iters_persist;
2304 GList *items = NULL;
2306 iters_persist = gtk_tree_model_get_flags (icon_view->priv->model) & GTK_TREE_MODEL_ITERS_PERSIST;
2308 if (!gtk_tree_model_get_iter_first (icon_view->priv->model,
2316 GtkIconViewItem *item = gtk_icon_view_item_new ();
2325 items = g_list_prepend (items, item);
2327 } while (gtk_tree_model_iter_next (icon_view->priv->model, &iter));
2329 icon_view->priv->items = g_list_reverse (items);
2333 gtk_icon_view_add_move_binding (GtkBindingSet *binding_set,
2336 GtkMovementStep step,
2340 gtk_binding_entry_add_signal (binding_set, keyval, modmask,
2345 gtk_binding_entry_add_signal (binding_set, keyval, GDK_SHIFT_MASK,
2350 if ((modmask & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
2353 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK | GDK_SHIFT_MASK,
2358 gtk_binding_entry_add_signal (binding_set, keyval, GDK_CONTROL_MASK,
2365 gtk_icon_view_real_move_cursor (GtkIconView *icon_view,
2366 GtkMovementStep step,
2369 GdkModifierType state;
2371 g_return_val_if_fail (GTK_ICON_VIEW (icon_view), FALSE);
2372 g_return_val_if_fail (step == GTK_MOVEMENT_LOGICAL_POSITIONS ||
2373 step == GTK_MOVEMENT_VISUAL_POSITIONS ||
2374 step == GTK_MOVEMENT_DISPLAY_LINES ||
2375 step == GTK_MOVEMENT_PAGES ||
2376 step == GTK_MOVEMENT_BUFFER_ENDS, FALSE);
2378 if (!GTK_WIDGET_HAS_FOCUS (GTK_WIDGET (icon_view)))
2381 gtk_widget_grab_focus (GTK_WIDGET (icon_view));
2383 if (gtk_get_current_event_state (&state))
2385 if ((state & GDK_CONTROL_MASK) == GDK_CONTROL_MASK)
2386 icon_view->priv->ctrl_pressed = TRUE;
2387 if ((state & GDK_SHIFT_MASK) == GDK_SHIFT_MASK)
2388 icon_view->priv->shift_pressed = TRUE;
2390 /* else we assume not pressed */
2394 case GTK_MOVEMENT_LOGICAL_POSITIONS:
2395 case GTK_MOVEMENT_VISUAL_POSITIONS:
2396 gtk_icon_view_move_cursor_left_right (icon_view, count);
2398 case GTK_MOVEMENT_DISPLAY_LINES:
2399 gtk_icon_view_move_cursor_up_down (icon_view, count);
2401 case GTK_MOVEMENT_PAGES:
2402 gtk_icon_view_move_cursor_page_up_down (icon_view, count);
2404 case GTK_MOVEMENT_BUFFER_ENDS:
2405 gtk_icon_view_move_cursor_start_end (icon_view, count);
2408 g_assert_not_reached ();
2411 icon_view->priv->ctrl_pressed = FALSE;
2412 icon_view->priv->shift_pressed = FALSE;
2417 static GtkIconViewItem *
2418 find_item (GtkIconView *icon_view,
2419 GtkIconViewItem *current,
2425 GtkIconViewItem *item;
2427 /* FIXME: this could be more efficient
2429 row = current->row + row_ofs;
2430 col = current->col + col_ofs;
2432 for (items = icon_view->priv->items; items; items = items->next)
2435 if (item->row == row && item->col == col)
2443 static GtkIconViewItem *
2444 find_item_page_up_down (GtkIconView *icon_view,
2445 GtkIconViewItem *current,
2452 y = current->y + count * icon_view->priv->vadjustment->page_size;
2454 item = g_list_find (icon_view->priv->items, current);
2459 for (next = item->next; next; next = next->next)
2461 if (((GtkIconViewItem *)next->data)->col == col)
2464 if (!next || ((GtkIconViewItem *)next->data)->y > y)
2474 for (next = item->prev; next; next = next->prev)
2476 if (((GtkIconViewItem *)next->data)->col == col)
2479 if (!next || ((GtkIconViewItem *)next->data)->y < y)
2493 gtk_icon_view_select_all_between (GtkIconView *icon_view,
2494 GtkIconViewItem *anchor,
2495 GtkIconViewItem *cursor)
2498 GtkIconViewItem *item;
2499 gint row1, row2, col1, col2;
2500 gboolean dirty = FALSE;
2502 if (anchor->row < cursor->row)
2513 if (anchor->col < cursor->col)
2524 for (items = icon_view->priv->items; items; items = items->next)
2528 if (row1 <= item->row && item->row <= row2 &&
2529 col1 <= item->col && item->col <= col2)
2531 if (!item->selected)
2534 item->selected = TRUE;
2536 gtk_icon_view_queue_draw_item (icon_view, item);
2544 gtk_icon_view_move_cursor_up_down (GtkIconView *icon_view,
2547 GtkIconViewItem *item;
2548 gboolean dirty = FALSE;
2550 if (!GTK_WIDGET_HAS_FOCUS (icon_view))
2553 if (!icon_view->priv->cursor_item)
2558 list = icon_view->priv->items;
2560 list = g_list_last (icon_view->priv->items);
2565 item = find_item (icon_view,
2566 icon_view->priv->cursor_item,
2572 if (icon_view->priv->ctrl_pressed ||
2573 !icon_view->priv->shift_pressed ||
2574 !icon_view->priv->anchor_item ||
2575 icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE)
2576 icon_view->priv->anchor_item = item;
2578 gtk_icon_view_set_cursor_item (icon_view, item);
2580 if (!icon_view->priv->ctrl_pressed &&
2581 icon_view->priv->selection_mode != GTK_SELECTION_NONE)
2583 gtk_icon_view_unselect_all_internal (icon_view);
2584 dirty = gtk_icon_view_select_all_between (icon_view,
2585 icon_view->priv->anchor_item,
2589 gtk_icon_view_scroll_to_item (icon_view, item);
2592 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
2596 gtk_icon_view_move_cursor_page_up_down (GtkIconView *icon_view,
2599 GtkIconViewItem *item;
2600 gboolean dirty = FALSE;
2602 if (!GTK_WIDGET_HAS_FOCUS (icon_view))
2605 if (!icon_view->priv->cursor_item)
2610 list = icon_view->priv->items;
2612 list = g_list_last (icon_view->priv->items);
2617 item = find_item_page_up_down (icon_view,
2618 icon_view->priv->cursor_item,
2624 if (icon_view->priv->ctrl_pressed ||
2625 !icon_view->priv->shift_pressed ||
2626 !icon_view->priv->anchor_item ||
2627 icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE)
2628 icon_view->priv->anchor_item = item;
2630 gtk_icon_view_set_cursor_item (icon_view, item);
2632 if (!icon_view->priv->ctrl_pressed &&
2633 icon_view->priv->selection_mode != GTK_SELECTION_NONE)
2635 gtk_icon_view_unselect_all_internal (icon_view);
2636 dirty = gtk_icon_view_select_all_between (icon_view,
2637 icon_view->priv->anchor_item,
2641 gtk_icon_view_scroll_to_item (icon_view, item);
2644 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
2648 gtk_icon_view_move_cursor_left_right (GtkIconView *icon_view,
2651 GtkIconViewItem *item;
2652 gboolean dirty = FALSE;
2654 if (!GTK_WIDGET_HAS_FOCUS (icon_view))
2657 if (!icon_view->priv->cursor_item)
2662 list = icon_view->priv->items;
2664 list = g_list_last (icon_view->priv->items);
2669 item = find_item (icon_view,
2670 icon_view->priv->cursor_item,
2676 if (icon_view->priv->ctrl_pressed ||
2677 !icon_view->priv->shift_pressed ||
2678 !icon_view->priv->anchor_item ||
2679 icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE)
2680 icon_view->priv->anchor_item = item;
2682 gtk_icon_view_set_cursor_item (icon_view, item);
2684 if (!icon_view->priv->ctrl_pressed &&
2685 icon_view->priv->selection_mode != GTK_SELECTION_NONE)
2687 gtk_icon_view_unselect_all_internal (icon_view);
2688 dirty = gtk_icon_view_select_all_between (icon_view,
2689 icon_view->priv->anchor_item,
2693 gtk_icon_view_scroll_to_item (icon_view, item);
2696 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
2700 gtk_icon_view_move_cursor_start_end (GtkIconView *icon_view,
2703 GtkIconViewItem *item;
2705 gboolean dirty = FALSE;
2707 if (!GTK_WIDGET_HAS_FOCUS (icon_view))
2711 list = icon_view->priv->items;
2713 list = g_list_last (icon_view->priv->items);
2720 if (icon_view->priv->ctrl_pressed ||
2721 !icon_view->priv->shift_pressed ||
2722 !icon_view->priv->anchor_item ||
2723 icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE)
2724 icon_view->priv->anchor_item = item;
2726 gtk_icon_view_set_cursor_item (icon_view, item);
2728 if (!icon_view->priv->ctrl_pressed &&
2729 icon_view->priv->selection_mode != GTK_SELECTION_NONE)
2731 gtk_icon_view_unselect_all (icon_view);
2732 dirty = gtk_icon_view_select_all_between (icon_view,
2733 icon_view->priv->anchor_item,
2737 gtk_icon_view_scroll_to_item (icon_view, item);
2740 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
2744 gtk_icon_view_scroll_to_item (GtkIconView *icon_view,
2745 GtkIconViewItem *item)
2750 gdk_window_get_geometry (icon_view->priv->bin_window, NULL, &y, NULL, &height, NULL);
2752 if (y + item->y < 0)
2754 value = icon_view->priv->vadjustment->value + y + item->y;
2755 gtk_adjustment_set_value (icon_view->priv->vadjustment, value);
2757 else if (y + item->y + item->height > GTK_WIDGET (icon_view)->allocation.height)
2759 value = icon_view->priv->vadjustment->value + y + item->y + item->height
2760 - GTK_WIDGET (icon_view)->allocation.height;
2761 gtk_adjustment_set_value (icon_view->priv->vadjustment, value);
2769 * gtk_icon_view_new:
2771 * Creates a new #GtkIconView widget
2773 * Return value: A newly created #GtkIconView widget
2778 gtk_icon_view_new (void)
2780 return g_object_new (GTK_TYPE_ICON_VIEW, NULL);
2784 * gtk_icon_view_new_with_model:
2785 * @model: The model.
2787 * Creates a new #GtkIconView widget with the model @model.
2789 * Return value: A newly created #GtkIconView widget.
2794 gtk_icon_view_new_with_model (GtkTreeModel *model)
2796 return g_object_new (GTK_TYPE_ICON_VIEW, "model", model, NULL);
2801 * gtk_icon_view_get_path_at_pos:
2802 * @icon_view: A #GtkIconView.
2803 * @x: The x position to be identified
2804 * @y: The y position to be identified
2806 * Finds the path at the point (@x, @y), relative to widget coordinates.
2808 * Return value: The #GtkTreePath corresponding to the icon or %NULL
2809 * if no icon exists at that position.
2814 gtk_icon_view_get_path_at_pos (GtkIconView *icon_view,
2818 GtkIconViewItem *item;
2821 g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), NULL);
2823 item = gtk_icon_view_get_item_at_pos (icon_view, x, y);
2828 path = gtk_tree_path_new_from_indices (item->index, -1);
2834 * gtk_icon_view_selected_foreach:
2835 * @icon_view: A #GtkIconView.
2836 * @func: The funcion to call for each selected icon.
2837 * @data: User data to pass to the function.
2839 * Calls a function for each selected icon. Note that the model or
2840 * selection cannot be modified from within this function.
2845 gtk_icon_view_selected_foreach (GtkIconView *icon_view,
2846 GtkIconViewForeachFunc func,
2851 for (list = icon_view->priv->items; list; list = list->next)
2853 GtkIconViewItem *item = list->data;
2854 GtkTreePath *path = gtk_tree_path_new_from_indices (item->index, -1);
2857 (* func) (icon_view, path, data);
2859 gtk_tree_path_free (path);
2864 * gtk_icon_view_set_selection_mode:
2865 * @icon_view: A #GtkIconView.
2866 * @mode: The selection mode
2868 * Sets the selection mode of the @icon_view.
2873 gtk_icon_view_set_selection_mode (GtkIconView *icon_view,
2874 GtkSelectionMode mode)
2876 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
2878 if (mode == icon_view->priv->selection_mode)
2881 if (mode == GTK_SELECTION_NONE ||
2882 icon_view->priv->selection_mode == GTK_SELECTION_MULTIPLE)
2883 gtk_icon_view_unselect_all (icon_view);
2885 icon_view->priv->selection_mode = mode;
2887 g_object_notify (G_OBJECT (icon_view), "selection_mode");
2891 * gtk_icon_view_get_selection_mode:
2892 * @icon_view: A #GtkIconView.
2894 * Gets the selection mode of the @icon_view.
2896 * Return value: the current selection mode
2901 gtk_icon_view_get_selection_mode (GtkIconView *icon_view)
2903 g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), GTK_SELECTION_SINGLE);
2905 return icon_view->priv->selection_mode;
2909 * gtk_icon_view_set_model:
2910 * @icon_view: A #GtkIconView.
2911 * @model: The model.
2913 * Sets the model for a #GtkIconView.
2914 * If the @icon_view already has a model set, it will remove
2915 * it before setting the new model. If @model is %NULL, then
2916 * it will unset the old model.
2921 gtk_icon_view_set_model (GtkIconView *icon_view,
2922 GtkTreeModel *model)
2924 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
2927 g_return_if_fail (GTK_IS_TREE_MODEL (model));
2929 if (icon_view->priv->model == model)
2934 GType pixbuf_column_type, text_column_type;
2936 g_return_if_fail (gtk_tree_model_get_flags (model) & GTK_TREE_MODEL_LIST_ONLY);
2938 if (icon_view->priv->pixbuf_column != -1)
2940 pixbuf_column_type = gtk_tree_model_get_column_type (icon_view->priv->model,
2941 icon_view->priv->pixbuf_column);
2943 g_return_if_fail (pixbuf_column_type == GDK_TYPE_PIXBUF);
2946 if (icon_view->priv->text_column != -1)
2948 text_column_type = gtk_tree_model_get_column_type (icon_view->priv->model,
2949 icon_view->priv->pixbuf_column);
2951 g_return_if_fail (text_column_type == G_TYPE_STRING);
2956 if (icon_view->priv->model)
2958 g_signal_handlers_disconnect_by_func (icon_view->priv->model,
2959 gtk_icon_view_row_changed,
2961 g_signal_handlers_disconnect_by_func (icon_view->priv->model,
2962 gtk_icon_view_row_inserted,
2964 g_signal_handlers_disconnect_by_func (icon_view->priv->model,
2965 gtk_icon_view_row_deleted,
2967 g_signal_handlers_disconnect_by_func (icon_view->priv->model,
2968 gtk_icon_view_rows_reordered,
2971 g_object_unref (icon_view->priv->model);
2973 g_list_foreach (icon_view->priv->items, (GFunc)gtk_icon_view_item_free, NULL);
2974 g_list_free (icon_view->priv->items);
2975 icon_view->priv->items = NULL;
2978 icon_view->priv->model = model;
2980 if (icon_view->priv->model)
2982 g_object_ref (icon_view->priv->model);
2983 g_signal_connect (icon_view->priv->model,
2985 G_CALLBACK (gtk_icon_view_row_changed),
2987 g_signal_connect (icon_view->priv->model,
2989 G_CALLBACK (gtk_icon_view_row_inserted),
2991 g_signal_connect (icon_view->priv->model,
2993 G_CALLBACK (gtk_icon_view_row_deleted),
2995 g_signal_connect (icon_view->priv->model,
2997 G_CALLBACK (gtk_icon_view_rows_reordered),
3000 gtk_icon_view_build_items (icon_view);
3003 g_object_notify (G_OBJECT (icon_view), "model");
3007 * gtk_icon_view_get_model:
3008 * @icon_view: a #GtkIconView
3010 * Returns the model the #GtkIconView is based on. Returns %NULL if the
3013 * Return value: A #GtkTreeModel, or %NULL if none is currently being used.
3018 gtk_icon_view_get_model (GtkIconView *icon_view)
3020 g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), NULL);
3022 return icon_view->priv->model;
3026 * gtk_icon_view_set_text_column:
3027 * @icon_view: A #GtkIconView.
3028 * @column: A column in the currently used model.
3030 * Sets the column with text for @icon_view to be @column. The text
3031 * column must be of type #G_TYPE_STRING.
3036 gtk_icon_view_set_text_column (GtkIconView *icon_view,
3039 if (column == icon_view->priv->text_column)
3043 icon_view->priv->text_column = -1;
3046 if (icon_view->priv->model != NULL)
3050 column_type = gtk_tree_model_get_column_type (icon_view->priv->model, column);
3052 g_return_if_fail (column_type == G_TYPE_STRING);
3055 icon_view->priv->text_column = column;
3058 gtk_icon_view_invalidate_sizes (icon_view);
3059 gtk_icon_view_queue_layout (icon_view);
3061 g_object_notify (G_OBJECT (icon_view), "text_column");
3065 * gtk_icon_view_get_text_column:
3066 * @icon_view: A #GtkIconView.
3068 * Returns the column with text for @icon_view.
3070 * Returns: the text column, or -1 if it's unset.
3075 gtk_icon_view_get_text_column (GtkIconView *icon_view)
3077 g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1);
3079 return icon_view->priv->text_column;
3083 * gtk_icon_view_set_markup_column:
3084 * @icon_view: A #GtkIconView.
3085 * @column: A column in the currently used model.
3087 * Sets the column with markup information for @icon_view to be
3088 * @column. The markup column must be of type #G_TYPE_STRING.
3089 * If the markup column is set to something, it overrides
3090 * the text column set by gtk_icon_view_set_text_column().
3095 gtk_icon_view_set_markup_column (GtkIconView *icon_view,
3098 if (column == icon_view->priv->markup_column)
3102 icon_view->priv->markup_column = -1;
3105 if (icon_view->priv->model != NULL)
3109 column_type = gtk_tree_model_get_column_type (icon_view->priv->model, column);
3111 g_return_if_fail (column_type == G_TYPE_STRING);
3114 icon_view->priv->markup_column = column;
3117 gtk_icon_view_invalidate_sizes (icon_view);
3118 gtk_icon_view_queue_layout (icon_view);
3120 g_object_notify (G_OBJECT (icon_view), "markup_column");
3124 * gtk_icon_view_get_markup_column:
3125 * @icon_view: A #GtkIconView.
3127 * Returns the column with markup text for @icon_view.
3129 * Returns: the markup column, or -1 if it's unset.
3134 gtk_icon_view_get_markup_column (GtkIconView *icon_view)
3136 g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1);
3138 return icon_view->priv->markup_column;
3142 * gtk_icon_view_set_pixbuf_column:
3143 * @icon_view: A #GtkIconView.
3144 * @column: A column in the currently used model.
3146 * Sets the column with pixbufs for @icon_view to be @column. The pixbuf
3147 * column must be of type #GDK_TYPE_PIXBUF
3152 gtk_icon_view_set_pixbuf_column (GtkIconView *icon_view,
3155 if (column == icon_view->priv->pixbuf_column)
3159 icon_view->priv->pixbuf_column = -1;
3162 if (icon_view->priv->model != NULL)
3166 column_type = gtk_tree_model_get_column_type (icon_view->priv->model, column);
3168 g_return_if_fail (column_type == GDK_TYPE_PIXBUF);
3171 icon_view->priv->pixbuf_column = column;
3174 gtk_icon_view_invalidate_sizes (icon_view);
3175 gtk_icon_view_queue_layout (icon_view);
3177 g_object_notify (G_OBJECT (icon_view), "pixbuf_column");
3182 * gtk_icon_view_get_pixbuf_column:
3183 * @icon_view: A #GtkIconView.
3185 * Returns the column with pixbufs for @icon_view.
3187 * Returns: the pixbuf column, or -1 if it's unset.
3192 gtk_icon_view_get_pixbuf_column (GtkIconView *icon_view)
3194 g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), -1);
3196 return icon_view->priv->pixbuf_column;
3200 * gtk_icon_view_select_path:
3201 * @icon_view: A #GtkIconView.
3202 * @path: The #GtkTreePath to be selected.
3204 * Selects the row at @path.
3209 gtk_icon_view_select_path (GtkIconView *icon_view,
3212 GtkIconViewItem *item;
3214 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
3215 g_return_if_fail (icon_view->priv->model != NULL);
3216 g_return_if_fail (path != NULL);
3218 item = g_list_nth (icon_view->priv->items,
3219 gtk_tree_path_get_indices(path)[0])->data;
3224 gtk_icon_view_select_item (icon_view, item);
3228 * gtk_icon_view_unselect_path:
3229 * @icon_view: A #GtkIconView.
3230 * @path: The #GtkTreePath to be unselected.
3232 * Unselects the row at @path.
3237 gtk_icon_view_unselect_path (GtkIconView *icon_view,
3240 GtkIconViewItem *item;
3242 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
3243 g_return_if_fail (icon_view->priv->model != NULL);
3244 g_return_if_fail (path != NULL);
3246 item = g_list_nth (icon_view->priv->items,
3247 gtk_tree_path_get_indices(path)[0])->data;
3252 gtk_icon_view_unselect_item (icon_view, item);
3256 * gtk_icon_view_get_selected_items:
3257 * @icon_view: A #GtkIconView.
3259 * Creates a list of path of all selected items. Additionally, if you are
3260 * planning on modifying the model after calling this function, you may
3261 * want to convert the returned list into a list of #GtkTreeRowReference<!-- -->s.
3262 * To do this, you can use gtk_tree_row_reference_new().
3264 * To free the return value, use:
3265 * <informalexample><programlisting>
3266 * g_list_foreach (list, gtk_tree_path_free, NULL);
3267 * g_list_free (list);
3268 * </programlisting></informalexample>
3270 * Return value: A #GList containing a #GtkTreePath for each selected row.
3275 gtk_icon_view_get_selected_items (GtkIconView *icon_view)
3278 GList *selected = NULL;
3280 g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), NULL);
3282 for (list = icon_view->priv->items; list != NULL; list = list->next)
3284 GtkIconViewItem *item = list->data;
3288 GtkTreePath *path = gtk_tree_path_new_from_indices (item->index, -1);
3290 selected = g_list_prepend (selected, path);
3298 * gtk_icon_view_select_all:
3299 * @icon_view: A #GtkIconView.
3301 * Selects all the icons. @icon_view must has its selection mode set
3302 * to #GTK_SELECTION_MULTIPLE.
3307 gtk_icon_view_select_all (GtkIconView *icon_view)
3310 gboolean dirty = FALSE;
3312 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
3314 if (icon_view->priv->selection_mode != GTK_SELECTION_MULTIPLE)
3317 for (items = icon_view->priv->items; items; items = items->next)
3319 GtkIconViewItem *item = items->data;
3321 if (!item->selected)
3324 item->selected = TRUE;
3325 gtk_icon_view_queue_draw_item (icon_view, item);
3330 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
3334 * gtk_icon_view_unselect_all:
3335 * @icon_view: A #GtkIconView.
3337 * Unselects all the icons.
3342 gtk_icon_view_unselect_all (GtkIconView *icon_view)
3344 gboolean dirty = FALSE;
3346 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
3348 dirty = gtk_icon_view_unselect_all_internal (icon_view);
3351 g_signal_emit (icon_view, icon_view_signals[SELECTION_CHANGED], 0);
3355 * gtk_icon_view_path_is_selected:
3356 * @icon_view: A #GtkIconView.
3357 * @path: A #GtkTreePath to check selection on.
3359 * Returns %TRUE if the icon pointed to by @path is currently
3360 * selected. If @icon does not point to a valid location, %FALSE is returned.
3362 * Return value: %TRUE if @path is selected.
3367 gtk_icon_view_path_is_selected (GtkIconView *icon_view,
3370 GtkIconViewItem *item;
3372 g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view), FALSE);
3373 g_return_val_if_fail (icon_view->priv->model != NULL, FALSE);
3374 g_return_val_if_fail (path != NULL, FALSE);
3376 item = g_list_nth (icon_view->priv->items,
3377 gtk_tree_path_get_indices(path)[0])->data;
3382 return item->selected;
3386 * gtk_icon_view_item_activated:
3387 * @icon_view: A #GtkIconView
3388 * @path: The #GtkTreePath to be activated
3390 * Activates the item determined by @path.
3395 gtk_icon_view_item_activated (GtkIconView *icon_view,
3398 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
3399 g_return_if_fail (path != NULL);
3401 g_signal_emit (G_OBJECT (icon_view), icon_view_signals[ITEM_ACTIVATED], 0, path);
3405 * gtk_icon_view_set_orientation:
3406 * @icon_view: a #GtkIconView
3407 * @orientation: the relative position of texts and icons
3409 * Sets the ::orientation property which determines whether the labels
3410 * are drawn beside the icons instead of below.
3415 gtk_icon_view_set_orientation (GtkIconView *icon_view,
3416 GtkOrientation orientation)
3418 g_return_if_fail (GTK_IS_ICON_VIEW (icon_view));
3420 if (icon_view->priv->orientation != orientation)
3422 icon_view->priv->orientation = orientation;
3424 gtk_icon_view_invalidate_sizes (icon_view);
3425 gtk_icon_view_queue_layout (icon_view);
3427 g_object_notify (G_OBJECT (icon_view), "orientation");
3432 * gtk_icon_view_get_orientation:
3433 * @icon_view: a #GtkIconView
3435 * Returns the value of the ::orientation property which determines
3436 * whether the labels are drawn beside the icons instead of below.
3438 * Return value: the relative position of texts and icons
3443 gtk_icon_view_get_orientation (GtkIconView *icon_view)
3445 g_return_val_if_fail (GTK_IS_ICON_VIEW (icon_view),
3446 GTK_ORIENTATION_VERTICAL);
3448 return icon_view->priv->orientation;