1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
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.
20 #include "gtklistitem.h"
22 #include "gtksignal.h"
32 #define SCROLL_TIME 100
34 /** GtkList Methods **/
35 static void gtk_list_class_init (GtkListClass *klass);
36 static void gtk_list_init (GtkList *list);
38 /** GtkObject Methods **/
39 static void gtk_list_shutdown (GtkObject *object);
41 /** GtkWidget Methods **/
42 static void gtk_list_size_request (GtkWidget *widget,
43 GtkRequisition *requisition);
44 static void gtk_list_size_allocate (GtkWidget *widget,
45 GtkAllocation *allocation);
46 static void gtk_list_realize (GtkWidget *widget);
47 static void gtk_list_map (GtkWidget *widget);
48 static void gtk_list_unmap (GtkWidget *widget);
49 static void gtk_list_draw (GtkWidget *widget,
51 static gint gtk_list_expose (GtkWidget *widget,
52 GdkEventExpose *event);
53 static gint gtk_list_motion_notify (GtkWidget *widget,
54 GdkEventMotion *event);
55 static gint gtk_list_button_press (GtkWidget *widget,
56 GdkEventButton *event);
57 static gint gtk_list_button_release (GtkWidget *widget,
58 GdkEventButton *event);
60 /** GtkContainer Methods **/
61 static void gtk_list_add (GtkContainer *container,
63 static void gtk_list_remove (GtkContainer *container,
65 static void gtk_list_forall (GtkContainer *container,
66 gboolean include_internals,
68 gpointer callback_data);
69 static GtkType gtk_list_child_type (GtkContainer *container);
70 static void gtk_list_set_focus_child (GtkContainer *container,
72 static gint gtk_list_focus (GtkContainer *container,
73 GtkDirectionType direction);
75 /** GtkList Private Functions **/
76 static void gtk_list_move_focus_child (GtkList *list,
77 GtkScrollType scroll_type,
79 static gint gtk_list_horizontal_timeout (GtkWidget *list);
80 static gint gtk_list_vertical_timeout (GtkWidget *list);
81 static void gtk_list_remove_items_internal (GtkList *list,
85 /** GtkList Selection Methods **/
86 static void gtk_real_list_select_child (GtkList *list,
88 static void gtk_real_list_unselect_child (GtkList *list,
91 /** GtkList Selection Functions **/
92 static void gtk_list_set_anchor (GtkList *list,
95 GtkWidget *undo_focus_child);
96 static void gtk_list_fake_unselect_all (GtkList *list,
98 static void gtk_list_fake_toggle_row (GtkList *list,
100 static void gtk_list_update_extended_selection (GtkList *list,
103 /** GtkListItem Signal Functions **/
104 static void gtk_list_signal_focus_lost (GtkWidget *item,
107 static void gtk_list_signal_toggle_focus_row (GtkListItem *list_item,
109 static void gtk_list_signal_select_all (GtkListItem *list_item,
111 static void gtk_list_signal_unselect_all (GtkListItem *list_item,
113 static void gtk_list_signal_undo_selection (GtkListItem *list_item,
115 static void gtk_list_signal_start_selection (GtkListItem *list_item,
117 static void gtk_list_signal_end_selection (GtkListItem *list_item,
119 static void gtk_list_signal_extend_selection (GtkListItem *list_item,
120 GtkScrollType scroll_type,
122 gboolean auto_start_selection,
124 static void gtk_list_signal_scroll_horizontal (GtkListItem *list_item,
125 GtkScrollType scroll_type,
128 static void gtk_list_signal_scroll_vertical (GtkListItem *list_item,
129 GtkScrollType scroll_type,
132 static void gtk_list_signal_toggle_add_mode (GtkListItem *list_item,
134 static void gtk_list_signal_item_select (GtkListItem *list_item,
136 static void gtk_list_signal_item_deselect (GtkListItem *list_item,
138 static void gtk_list_signal_item_toggle (GtkListItem *list_item,
142 static GtkContainerClass *parent_class = NULL;
143 static guint list_signals[LAST_SIGNAL] = { 0 };
145 static const gchar *vadjustment_key = "gtk-vadjustment";
146 static guint vadjustment_key_id = 0;
147 static const gchar *hadjustment_key = "gtk-hadjustment";
148 static guint hadjustment_key_id = 0;
151 gtk_list_get_type (void)
153 static GtkType list_type = 0;
157 GtkTypeInfo list_info =
161 sizeof (GtkListClass),
162 (GtkClassInitFunc) gtk_list_class_init,
163 (GtkObjectInitFunc) gtk_list_init,
164 /* reserved_1 */ NULL,
165 /* reserved_2 */ NULL,
166 (GtkClassInitFunc) NULL,
169 list_type = gtk_type_unique (GTK_TYPE_CONTAINER, &list_info);
176 gtk_list_class_init (GtkListClass *class)
178 GtkObjectClass *object_class;
179 GtkWidgetClass *widget_class;
180 GtkContainerClass *container_class;
182 object_class = (GtkObjectClass*) class;
183 widget_class = (GtkWidgetClass*) class;
184 container_class = (GtkContainerClass*) class;
186 parent_class = gtk_type_class (GTK_TYPE_CONTAINER);
188 vadjustment_key_id = g_quark_from_static_string (vadjustment_key);
189 hadjustment_key_id = g_quark_from_static_string (hadjustment_key);
191 list_signals[SELECTION_CHANGED] =
192 gtk_signal_new ("selection_changed",
195 GTK_SIGNAL_OFFSET (GtkListClass, selection_changed),
196 gtk_marshal_NONE__NONE,
198 list_signals[SELECT_CHILD] =
199 gtk_signal_new ("select_child",
202 GTK_SIGNAL_OFFSET (GtkListClass, select_child),
203 gtk_marshal_NONE__POINTER,
206 list_signals[UNSELECT_CHILD] =
207 gtk_signal_new ("unselect_child",
210 GTK_SIGNAL_OFFSET (GtkListClass, unselect_child),
211 gtk_marshal_NONE__POINTER,
215 gtk_object_class_add_signals (object_class, list_signals, LAST_SIGNAL);
217 object_class->shutdown = gtk_list_shutdown;
219 widget_class->map = gtk_list_map;
220 widget_class->unmap = gtk_list_unmap;
221 widget_class->realize = gtk_list_realize;
222 widget_class->draw = gtk_list_draw;
223 widget_class->expose_event = gtk_list_expose;
224 widget_class->button_press_event = gtk_list_button_press;
225 widget_class->button_release_event = gtk_list_button_release;
226 widget_class->motion_notify_event = gtk_list_motion_notify;
227 widget_class->size_request = gtk_list_size_request;
228 widget_class->size_allocate = gtk_list_size_allocate;
230 container_class->add = gtk_list_add;
231 container_class->remove = gtk_list_remove;
232 container_class->forall = gtk_list_forall;
233 container_class->child_type = gtk_list_child_type;
234 container_class->set_focus_child = gtk_list_set_focus_child;
235 container_class->focus = gtk_list_focus;
237 class->selection_changed = NULL;
238 class->select_child = gtk_real_list_select_child;
239 class->unselect_child = gtk_real_list_unselect_child;
243 gtk_list_init (GtkList *list)
245 list->children = NULL;
246 list->selection = NULL;
248 list->undo_selection = NULL;
249 list->undo_unselection = NULL;
251 list->last_focus_child = NULL;
252 list->undo_focus_child = NULL;
259 list->anchor_state = GTK_STATE_SELECTED;
261 list->selection_mode = GTK_SELECTION_SINGLE;
262 list->drag_selection = FALSE;
263 list->add_mode = FALSE;
269 return GTK_WIDGET (gtk_type_new (GTK_TYPE_LIST));
273 /* Private GtkObject Methods :
278 gtk_list_shutdown (GtkObject *object)
280 gtk_list_clear_items (GTK_LIST (object), 0, -1);
281 GTK_OBJECT_CLASS (parent_class)->shutdown (object);
285 /* Private GtkWidget Methods :
287 * gtk_list_size_request
288 * gtk_list_size_allocate
292 * gtk_list_motion_notify
293 * gtk_list_button_press
294 * gtk_list_button_release
297 gtk_list_size_request (GtkWidget *widget,
298 GtkRequisition *requisition)
304 g_return_if_fail (widget != NULL);
305 g_return_if_fail (GTK_IS_LIST (widget));
306 g_return_if_fail (requisition != NULL);
308 list = GTK_LIST (widget);
309 requisition->width = 0;
310 requisition->height = 0;
312 children = list->children;
315 child = children->data;
316 children = children->next;
318 if (GTK_WIDGET_VISIBLE (child))
320 gtk_widget_size_request (child, &child->requisition);
322 requisition->width = MAX (requisition->width,
323 child->requisition.width);
324 requisition->height += child->requisition.height;
328 requisition->width += GTK_CONTAINER (list)->border_width * 2;
329 requisition->height += GTK_CONTAINER (list)->border_width * 2;
331 requisition->width = MAX (requisition->width, 1);
332 requisition->height = MAX (requisition->height, 1);
336 gtk_list_size_allocate (GtkWidget *widget,
337 GtkAllocation *allocation)
341 GtkAllocation child_allocation;
344 g_return_if_fail (widget != NULL);
345 g_return_if_fail (GTK_IS_LIST (widget));
346 g_return_if_fail (allocation != NULL);
348 list = GTK_LIST (widget);
350 widget->allocation = *allocation;
351 if (GTK_WIDGET_REALIZED (widget))
352 gdk_window_move_resize (widget->window,
353 allocation->x, allocation->y,
354 allocation->width, allocation->height);
358 child_allocation.x = GTK_CONTAINER (list)->border_width;
359 child_allocation.y = GTK_CONTAINER (list)->border_width;
360 child_allocation.width = MAX (1, allocation->width -
361 child_allocation.x * 2);
363 children = list->children;
367 child = children->data;
368 children = children->next;
370 if (GTK_WIDGET_VISIBLE (child))
372 child_allocation.height = child->requisition.height;
374 gtk_widget_size_allocate (child, &child_allocation);
376 child_allocation.y += child_allocation.height;
383 gtk_list_realize (GtkWidget *widget)
385 GdkWindowAttr attributes;
386 gint attributes_mask;
388 g_return_if_fail (widget != NULL);
389 g_return_if_fail (GTK_IS_LIST (widget));
391 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
393 attributes.window_type = GDK_WINDOW_CHILD;
394 attributes.x = widget->allocation.x;
395 attributes.y = widget->allocation.y;
396 attributes.width = widget->allocation.width;
397 attributes.height = widget->allocation.height;
398 attributes.wclass = GDK_INPUT_OUTPUT;
399 attributes.visual = gtk_widget_get_visual (widget);
400 attributes.colormap = gtk_widget_get_colormap (widget);
401 attributes.event_mask = gtk_widget_get_events (widget) | GDK_EXPOSURE_MASK;
403 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
405 widget->window = gdk_window_new (gtk_widget_get_parent_window (widget),
406 &attributes, attributes_mask);
407 gdk_window_set_user_data (widget->window, widget);
409 widget->style = gtk_style_attach (widget->style, widget->window);
410 gdk_window_set_background (widget->window,
411 &widget->style->base[GTK_STATE_NORMAL]);
415 gtk_list_map (GtkWidget *widget)
421 g_return_if_fail (widget != NULL);
422 g_return_if_fail (GTK_IS_LIST (widget));
424 GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
425 list = GTK_LIST (widget);
427 gdk_window_show (widget->window);
429 children = list->children;
432 child = children->data;
433 children = children->next;
435 if (GTK_WIDGET_VISIBLE (child) &&
436 !GTK_WIDGET_MAPPED (child))
437 gtk_widget_map (child);
442 gtk_list_unmap (GtkWidget *widget)
444 g_return_if_fail (widget != NULL);
445 g_return_if_fail (GTK_IS_LIST (widget));
447 GTK_WIDGET_UNSET_FLAGS (widget, GTK_MAPPED);
448 gdk_window_hide (widget->window);
452 gtk_list_motion_notify (GtkWidget *widget,
453 GdkEventMotion *event)
456 GtkWidget *item = NULL;
458 GtkContainer *container;
466 g_return_val_if_fail (widget != NULL, FALSE);
467 g_return_val_if_fail (GTK_IS_LIST (widget), FALSE);
468 g_return_val_if_fail (event != NULL, FALSE);
470 list = GTK_LIST (widget);
472 if (!list->drag_selection || !list->children)
475 container = GTK_CONTAINER (widget);
477 if (event->is_hint || event->window != widget->window)
478 gdk_window_get_pointer (widget->window, &x, &y, NULL);
480 adj = gtk_object_get_data_by_id (GTK_OBJECT (list), hadjustment_key_id);
482 /* horizontal autoscrolling */
483 if (adj && widget->allocation.width > adj->page_size &&
484 (x < adj->value || x >= adj->value + adj->page_size))
486 if (list->htimer == 0)
488 list->htimer = gtk_timeout_add
489 (SCROLL_TIME, (GtkFunction) gtk_list_horizontal_timeout, widget);
491 if (!((x < adj->value && adj->value <= 0) ||
492 (x > adj->value + adj->page_size &&
493 adj->value >= adj->upper - adj->page_size)))
498 value = adj->value + (x - adj->value) / 2 - 1;
500 value = adj->value + 1 + (x - adj->value - adj->page_size) / 2;
502 gtk_adjustment_set_value (adj,
504 adj->upper - adj->page_size));
512 /* vertical autoscrolling */
513 for (work = list->children; work; length++, work = work->next)
517 item = GTK_WIDGET (work->data);
518 if (item->allocation.y > y ||
519 (item->allocation.y <= y &&
520 item->allocation.y + item->allocation.height > y))
524 if (work->data == container->focus_child)
531 if (list->vtimer != 0)
534 if (!((y < 0 && focus_row == 0) ||
535 (y > widget->allocation.height && focus_row >= length - 1)))
536 list->vtimer = gtk_timeout_add (SCROLL_TIME,
537 (GtkFunction) gtk_list_vertical_timeout,
540 if (row != focus_row)
541 gtk_widget_grab_focus (item);
543 switch (list->selection_mode)
545 case GTK_SELECTION_BROWSE:
546 gtk_list_select_child (list, item);
549 case GTK_SELECTION_EXTENDED:
550 gtk_list_update_extended_selection (list, row);
561 gtk_list_button_press (GtkWidget *widget,
562 GdkEventButton *event)
567 g_return_val_if_fail (widget != NULL, FALSE);
568 g_return_val_if_fail (GTK_IS_LIST (widget), FALSE);
569 g_return_val_if_fail (event != NULL, FALSE);
571 if (event->button != 1)
574 list = GTK_LIST (widget);
575 item = gtk_get_event_widget ((GdkEvent*) event);
577 while (item && !GTK_IS_LIST_ITEM (item))
580 if (item && (item->parent == widget))
585 if (event->type == GDK_BUTTON_PRESS)
587 list->drag_selection = TRUE;
588 gdk_pointer_grab (widget->window, TRUE,
589 GDK_POINTER_MOTION_HINT_MASK |
590 GDK_BUTTON1_MOTION_MASK |
591 GDK_BUTTON_RELEASE_MASK,
592 NULL, NULL, event->time);
593 gtk_grab_add (widget);
595 else if (gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list))
596 gtk_list_end_drag_selection (list);
598 if (!GTK_WIDGET_HAS_FOCUS(item))
599 gtk_widget_grab_focus (item);
603 list->add_mode = FALSE;
604 gtk_widget_queue_draw (item);
607 switch (list->selection_mode)
609 case GTK_SELECTION_SINGLE:
610 case GTK_SELECTION_MULTIPLE:
611 if (event->type != GDK_BUTTON_PRESS)
612 gtk_list_select_child (list, item);
614 list->undo_focus_child = item;
617 case GTK_SELECTION_BROWSE:
620 case GTK_SELECTION_EXTENDED:
621 focus_row = g_list_index (list->children, item);
623 if (list->last_focus_child)
624 last_focus_row = g_list_index (list->children,
625 list->last_focus_child);
628 last_focus_row = focus_row;
629 list->last_focus_child = item;
632 if (event->type != GDK_BUTTON_PRESS)
634 if (list->anchor >= 0)
636 gtk_list_update_extended_selection (list, focus_row);
637 gtk_list_end_selection (list);
639 gtk_list_select_child (list, item);
643 if (event->state & GDK_CONTROL_MASK)
645 if (event->state & GDK_SHIFT_MASK)
647 if (list->anchor < 0)
649 g_list_free (list->undo_selection);
650 g_list_free (list->undo_unselection);
651 list->undo_selection = NULL;
652 list->undo_unselection = NULL;
654 list->anchor = last_focus_row;
655 list->drag_pos = last_focus_row;
656 list->undo_focus_child = list->last_focus_child;
658 gtk_list_update_extended_selection (list, focus_row);
662 if (list->anchor < 0)
663 gtk_list_set_anchor (list, TRUE,
664 focus_row, list->last_focus_child);
666 gtk_list_update_extended_selection (list, focus_row);
671 if (event->state & GDK_SHIFT_MASK)
673 gtk_list_set_anchor (list, FALSE,
674 last_focus_row, list->last_focus_child);
675 gtk_list_update_extended_selection (list, focus_row);
679 if (list->anchor < 0)
680 gtk_list_set_anchor (list, FALSE, focus_row,
681 list->last_focus_child);
683 gtk_list_update_extended_selection (list, focus_row);
695 gtk_list_button_release (GtkWidget *widget,
696 GdkEventButton *event)
701 g_return_val_if_fail (widget != NULL, FALSE);
702 g_return_val_if_fail (GTK_IS_LIST (widget), FALSE);
703 g_return_val_if_fail (event != NULL, FALSE);
705 list = GTK_LIST (widget);
707 /* we don't handle button 2 and 3 */
708 if (event->button != 1)
711 if (list->drag_selection)
713 gtk_list_end_drag_selection (list);
715 switch (list->selection_mode)
717 case GTK_SELECTION_EXTENDED:
718 if (!(event->state & GDK_SHIFT_MASK))
719 gtk_list_end_selection (list);
722 case GTK_SELECTION_SINGLE:
723 case GTK_SELECTION_MULTIPLE:
725 item = gtk_get_event_widget ((GdkEvent*) event);
727 while (item && !GTK_IS_LIST_ITEM (item))
730 if (item && item->parent == widget)
732 if (list->undo_focus_child == item)
733 gtk_list_toggle_row (list, item);
735 list->undo_focus_child = NULL;
747 gtk_list_draw (GtkWidget *widget,
752 GdkRectangle child_area;
755 g_return_if_fail (widget != NULL);
756 g_return_if_fail (GTK_IS_LIST (widget));
757 g_return_if_fail (area != NULL);
759 if (GTK_WIDGET_DRAWABLE (widget))
761 list = GTK_LIST (widget);
763 children = list->children;
766 child = children->data;
767 children = children->next;
769 if (gtk_widget_intersect (child, area, &child_area))
770 gtk_widget_draw (child, &child_area);
776 gtk_list_expose (GtkWidget *widget,
777 GdkEventExpose *event)
781 GdkEventExpose child_event;
784 g_return_val_if_fail (widget != NULL, FALSE);
785 g_return_val_if_fail (GTK_IS_LIST (widget), FALSE);
786 g_return_val_if_fail (event != NULL, FALSE);
788 if (GTK_WIDGET_DRAWABLE (widget))
790 list = GTK_LIST (widget);
792 child_event = *event;
794 children = list->children;
797 child = children->data;
798 children = children->next;
800 if (GTK_WIDGET_NO_WINDOW (child) &&
801 gtk_widget_intersect (child, &event->area, &child_event.area))
802 gtk_widget_event (child, (GdkEvent*) &child_event);
810 /* GtkContainer Methods :
814 * gtk_list_child_type
815 * gtk_list_set_focus_child
819 gtk_list_add (GtkContainer *container,
824 g_return_if_fail (container != NULL);
825 g_return_if_fail (GTK_IS_LIST (container));
826 g_return_if_fail (widget != NULL);
827 g_return_if_fail (GTK_IS_LIST_ITEM (widget));
829 item_list = g_list_alloc ();
830 item_list->data = widget;
832 gtk_list_append_items (GTK_LIST (container), item_list);
836 gtk_list_remove (GtkContainer *container,
841 g_return_if_fail (container != NULL);
842 g_return_if_fail (GTK_IS_LIST (container));
843 g_return_if_fail (widget != NULL);
844 g_return_if_fail (container == GTK_CONTAINER (widget->parent));
846 item_list = g_list_alloc ();
847 item_list->data = widget;
849 gtk_list_remove_items (GTK_LIST (container), item_list);
851 g_list_free (item_list);
855 gtk_list_forall (GtkContainer *container,
856 gboolean include_internals,
857 GtkCallback callback,
858 gpointer callback_data)
864 g_return_if_fail (container != NULL);
865 g_return_if_fail (GTK_IS_LIST (container));
866 g_return_if_fail (callback != NULL);
868 list = GTK_LIST (container);
869 children = list->children;
873 child = children->data;
874 children = children->next;
876 (* callback) (child, callback_data);
881 gtk_list_child_type (GtkContainer *container)
883 return GTK_TYPE_LIST_ITEM;
887 gtk_list_set_focus_child (GtkContainer *container,
892 g_return_if_fail (container != NULL);
893 g_return_if_fail (GTK_IS_LIST (container));
896 g_return_if_fail (GTK_IS_WIDGET (child));
898 list = GTK_LIST (container);
899 list->last_focus_child = container->focus_child;
901 if (child != container->focus_child)
903 if (container->focus_child)
904 gtk_widget_unref (container->focus_child);
905 container->focus_child = child;
906 if (container->focus_child)
907 gtk_widget_ref (container->focus_child);
910 /* check for v adjustment */
911 if (container->focus_child)
913 GtkAdjustment *adjustment;
915 adjustment = gtk_object_get_data_by_id (GTK_OBJECT (container),
918 gtk_adjustment_clamp_page (adjustment,
919 container->focus_child->allocation.y,
920 (container->focus_child->allocation.y +
921 container->focus_child->allocation.height));
924 switch (list->selection_mode)
926 case GTK_SELECTION_BROWSE:
928 gtk_list_select_child (list, child);
936 gtk_list_focus (GtkContainer *container,
937 GtkDirectionType direction)
939 gint return_val = FALSE;
941 g_return_val_if_fail (container != NULL, FALSE);
942 g_return_val_if_fail (GTK_IS_LIST (container), FALSE);
944 if (!GTK_WIDGET_SENSITIVE (container))
946 else if (container->focus_child == NULL ||
947 !GTK_WIDGET_HAS_FOCUS (container->focus_child))
949 if (*GTK_CONTAINER_CLASS (parent_class)->focus)
950 return_val = GTK_CONTAINER_CLASS (parent_class)->focus
951 (container, direction);
958 list = GTK_LIST (container);
959 if (list->selection_mode == GTK_SELECTION_EXTENDED && list->anchor >= 0)
960 gtk_list_end_selection (list);
967 /* Public GtkList Methods :
969 * gtk_list_insert_items
970 * gtk_list_append_items
971 * gtk_list_prepend_items
972 * gtk_list_remove_items
973 * gtk_list_remove_items_no_unref
974 * gtk_list_clear_items
976 * gtk_list_child_position
979 gtk_list_insert_items (GtkList *list,
988 g_return_if_fail (list != NULL);
989 g_return_if_fail (GTK_IS_LIST (list));
994 gtk_list_end_drag_selection (list);
995 if (list->selection_mode == GTK_SELECTION_EXTENDED && list->anchor >= 0)
996 gtk_list_end_selection (list);
1001 widget = tmp_list->data;
1002 tmp_list = tmp_list->next;
1004 gtk_widget_set_parent (widget, GTK_WIDGET (list));
1005 gtk_signal_connect (GTK_OBJECT (widget), "focus_out_event",
1006 GTK_SIGNAL_FUNC (gtk_list_signal_focus_lost),
1008 gtk_signal_connect (GTK_OBJECT (widget), "toggle_focus_row",
1009 GTK_SIGNAL_FUNC (gtk_list_signal_toggle_focus_row),
1011 gtk_signal_connect (GTK_OBJECT (widget), "select_all",
1012 GTK_SIGNAL_FUNC (gtk_list_signal_select_all),
1014 gtk_signal_connect (GTK_OBJECT (widget), "unselect_all",
1015 GTK_SIGNAL_FUNC (gtk_list_signal_unselect_all),
1017 gtk_signal_connect (GTK_OBJECT (widget), "undo_selection",
1018 GTK_SIGNAL_FUNC (gtk_list_signal_undo_selection),
1020 gtk_signal_connect (GTK_OBJECT (widget), "start_selection",
1021 GTK_SIGNAL_FUNC (gtk_list_signal_start_selection),
1023 gtk_signal_connect (GTK_OBJECT (widget), "end_selection",
1024 GTK_SIGNAL_FUNC (gtk_list_signal_end_selection),
1026 gtk_signal_connect (GTK_OBJECT (widget), "extend_selection",
1027 GTK_SIGNAL_FUNC (gtk_list_signal_extend_selection),
1029 gtk_signal_connect (GTK_OBJECT (widget), "scroll_horizontal",
1030 GTK_SIGNAL_FUNC (gtk_list_signal_scroll_horizontal),
1032 gtk_signal_connect (GTK_OBJECT (widget), "scroll_vertical",
1033 GTK_SIGNAL_FUNC (gtk_list_signal_scroll_vertical),
1035 gtk_signal_connect (GTK_OBJECT (widget), "toggle_add_mode",
1036 GTK_SIGNAL_FUNC (gtk_list_signal_toggle_add_mode),
1038 gtk_signal_connect (GTK_OBJECT (widget), "select",
1039 GTK_SIGNAL_FUNC (gtk_list_signal_item_select),
1041 gtk_signal_connect (GTK_OBJECT (widget), "deselect",
1042 GTK_SIGNAL_FUNC (gtk_list_signal_item_deselect),
1044 gtk_signal_connect (GTK_OBJECT (widget), "toggle",
1045 GTK_SIGNAL_FUNC (gtk_list_signal_item_toggle),
1048 if (GTK_WIDGET_VISIBLE (widget->parent))
1050 if (GTK_WIDGET_REALIZED (widget->parent) &&
1051 !GTK_WIDGET_REALIZED (widget))
1052 gtk_widget_realize (widget);
1054 if (GTK_WIDGET_MAPPED (widget->parent) &&
1055 !GTK_WIDGET_MAPPED (widget))
1056 gtk_widget_map (widget);
1060 nchildren = g_list_length (list->children);
1061 if ((position < 0) || (position > nchildren))
1062 position = nchildren;
1064 if (position == nchildren)
1068 tmp_list = g_list_last (list->children);
1069 tmp_list->next = items;
1070 items->prev = tmp_list;
1074 list->children = items;
1079 tmp_list = g_list_nth (list->children, position);
1080 last = g_list_last (items);
1083 tmp_list->prev->next = items;
1084 last->next = tmp_list;
1085 items->prev = tmp_list->prev;
1086 tmp_list->prev = last;
1088 if (tmp_list == list->children)
1089 list->children = items;
1092 if (list->children && !list->selection &&
1093 (list->selection_mode == GTK_SELECTION_BROWSE))
1095 widget = list->children->data;
1096 gtk_list_select_child (list, widget);
1099 if (GTK_WIDGET_VISIBLE (list))
1100 gtk_widget_queue_resize (GTK_WIDGET (list));
1104 gtk_list_append_items (GtkList *list,
1107 g_return_if_fail (list != NULL);
1108 g_return_if_fail (GTK_IS_LIST (list));
1110 gtk_list_insert_items (list, items, -1);
1114 gtk_list_prepend_items (GtkList *list,
1117 g_return_if_fail (list != NULL);
1118 g_return_if_fail (GTK_IS_LIST (list));
1120 gtk_list_insert_items (list, items, 0);
1124 gtk_list_remove_items (GtkList *list,
1127 gtk_list_remove_items_internal (list, items, FALSE);
1131 gtk_list_remove_items_no_unref (GtkList *list,
1134 gtk_list_remove_items_internal (list, items, TRUE);
1138 gtk_list_clear_items (GtkList *list,
1148 g_return_if_fail (list != NULL);
1149 g_return_if_fail (GTK_IS_LIST (list));
1151 nchildren = g_list_length (list->children);
1155 gboolean selection_changed;
1157 if ((end < 0) || (end > nchildren))
1163 start_list = g_list_nth (list->children, start);
1164 end_list = g_list_nth (list->children, end);
1166 gtk_list_end_drag_selection (list);
1167 if (list->selection_mode == GTK_SELECTION_EXTENDED && list->anchor >= 0)
1168 gtk_list_end_selection (list);
1170 if (start_list->prev)
1171 start_list->prev->next = end_list;
1172 if (end_list && end_list->prev)
1173 end_list->prev->next = NULL;
1175 end_list->prev = start_list->prev;
1176 if (start_list == list->children)
1177 list->children = end_list;
1179 selection_changed = FALSE;
1181 tmp_list = start_list;
1185 widget = tmp_list->data;
1186 tmp_list = tmp_list->next;
1188 if (widget->state == GTK_STATE_SELECTED)
1190 gtk_list_unselect_child (list, widget);
1191 selection_changed = TRUE;
1194 gtk_widget_unparent (widget);
1197 g_list_free (start_list);
1199 if (list->children && !list->selection &&
1200 (list->selection_mode == GTK_SELECTION_BROWSE))
1202 widget = list->children->data;
1203 gtk_list_select_child (list, widget);
1205 else if (selection_changed)
1206 gtk_signal_emit (GTK_OBJECT (list), list_signals[SELECTION_CHANGED]);
1208 gtk_widget_queue_resize (GTK_WIDGET (list));
1213 gtk_list_child_position (GtkList *list,
1219 g_return_val_if_fail (list != NULL, -1);
1220 g_return_val_if_fail (GTK_IS_LIST (list), -1);
1221 g_return_val_if_fail (child != NULL, -1);
1224 children = list->children;
1228 if (child == GTK_WIDGET (children->data))
1232 children = children->next;
1239 /* Private GtkList Insert/Remove Item Functions:
1241 * gtk_list_remove_items_internal
1244 gtk_list_remove_items_internal (GtkList *list,
1249 GtkWidget *new_focus_child;
1250 GtkWidget *old_focus_child;
1251 GtkContainer *container;
1254 gboolean grab_focus = FALSE;
1256 g_return_if_fail (list != NULL);
1257 g_return_if_fail (GTK_IS_LIST (list));
1262 container = GTK_CONTAINER (list);
1264 gtk_list_end_drag_selection (list);
1265 if (list->selection_mode == GTK_SELECTION_EXTENDED)
1267 if (list->anchor >= 0)
1268 gtk_list_end_selection (list);
1270 if (list->undo_selection || list->undo_unselection)
1272 g_list_free (list->undo_selection);
1273 g_list_free (list->undo_unselection);
1274 list->undo_selection = NULL;
1275 list->undo_unselection = NULL;
1278 list->drag_pos = -1;
1279 list->undo_focus_child = container->focus_child;
1286 widget = tmp_list->data;
1287 tmp_list = tmp_list->next;
1289 if (widget->state == GTK_STATE_SELECTED)
1290 gtk_list_unselect_child (list, widget);
1295 old_focus_child = new_focus_child = container->focus_child;
1299 widget = tmp_list->data;
1300 tmp_list = tmp_list->next;
1303 gtk_widget_ref (widget);
1306 if (widget == new_focus_child)
1308 work = g_list_find (list->children, widget);
1313 new_focus_child = work->next->data;
1314 else if (list->children != work && work->prev)
1315 new_focus_child = work->prev->data;
1317 new_focus_child = NULL;
1319 if (GTK_WIDGET_HAS_FOCUS (widget))
1324 gtk_signal_disconnect_by_data (GTK_OBJECT (widget), (gpointer) list);
1325 list->children = g_list_remove (list->children, widget);
1326 gtk_widget_unparent (widget);
1329 if (new_focus_child && new_focus_child != old_focus_child)
1332 gtk_widget_grab_focus (new_focus_child);
1334 gtk_container_set_focus_child (container, new_focus_child);
1337 if (GTK_WIDGET_VISIBLE (list))
1338 gtk_widget_queue_resize (GTK_WIDGET (list));
1342 /* Public GtkList Selection Methods :
1344 * gtk_list_set_selection_mode
1345 * gtk_list_select_item
1346 * gtk_list_unselect_item
1347 * gtk_list_select_child
1348 * gtk_list_unselect_child
1349 * gtk_list_select_all
1350 * gtk_list_unselect_all
1351 * gtk_list_extend_selection
1352 * gtk_list_end_drag_selection
1353 * gtk_list_start_selection
1354 * gtk_list_end_selection
1355 * gtk_list_toggle_row
1356 * gtk_list_toggle_focus_row
1357 * gtk_list_toggle_add_mode
1358 * gtk_list_undo_selection
1361 gtk_list_set_selection_mode (GtkList *list,
1362 GtkSelectionMode mode)
1364 g_return_if_fail (list != NULL);
1365 g_return_if_fail (GTK_IS_LIST (list));
1367 if (list->selection_mode == mode)
1370 list->selection_mode = mode;
1374 case GTK_SELECTION_SINGLE:
1375 case GTK_SELECTION_BROWSE:
1376 gtk_list_unselect_all (list);
1385 gtk_list_select_item (GtkList *list,
1390 g_return_if_fail (list != NULL);
1391 g_return_if_fail (GTK_IS_LIST (list));
1393 tmp_list = g_list_nth (list->children, item);
1395 gtk_list_select_child (list, GTK_WIDGET (tmp_list->data));
1399 gtk_list_unselect_item (GtkList *list,
1404 g_return_if_fail (list != NULL);
1405 g_return_if_fail (GTK_IS_LIST (list));
1407 tmp_list = g_list_nth (list->children, item);
1409 gtk_list_unselect_child (list, GTK_WIDGET (tmp_list->data));
1413 gtk_list_select_child (GtkList *list,
1416 gtk_signal_emit (GTK_OBJECT (list), list_signals[SELECT_CHILD], child);
1420 gtk_list_unselect_child (GtkList *list,
1423 gtk_signal_emit (GTK_OBJECT (list), list_signals[UNSELECT_CHILD], child);
1427 gtk_list_select_all (GtkList *list)
1429 GtkContainer *container;
1432 g_return_if_fail (list != NULL);
1433 g_return_if_fail (GTK_IS_LIST (list));
1435 if (!list->children)
1438 if (gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list))
1439 gtk_list_end_drag_selection (list);
1441 if (list->selection_mode == GTK_SELECTION_EXTENDED && list->anchor >= 0)
1442 gtk_list_end_selection (list);
1444 container = GTK_CONTAINER (list);
1446 switch (list->selection_mode)
1448 case GTK_SELECTION_BROWSE:
1449 if (container->focus_child)
1451 gtk_list_select_child (list, container->focus_child);
1456 case GTK_SELECTION_EXTENDED:
1457 g_list_free (list->undo_selection);
1458 g_list_free (list->undo_unselection);
1459 list->undo_selection = NULL;
1460 list->undo_unselection = NULL;
1462 if (list->children &&
1463 GTK_WIDGET_STATE (list->children->data) != GTK_STATE_SELECTED)
1464 gtk_list_fake_toggle_row (list, GTK_WIDGET (list->children->data));
1466 list->anchor_state = GTK_STATE_SELECTED;
1469 list->undo_focus_child = container->focus_child;
1470 gtk_list_update_extended_selection (list, g_list_length(list->children));
1471 gtk_list_end_selection (list);
1474 case GTK_SELECTION_MULTIPLE:
1475 for (work = list->children; work; work = work->next)
1477 if (GTK_WIDGET_STATE (work->data) == GTK_STATE_NORMAL)
1478 gtk_list_select_child (list, GTK_WIDGET (work->data));
1488 gtk_list_unselect_all (GtkList *list)
1490 GtkContainer *container;
1494 g_return_if_fail (list != NULL);
1495 g_return_if_fail (GTK_IS_LIST (list));
1497 if (!list->children)
1500 if (gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list))
1501 gtk_list_end_drag_selection (list);
1503 if (list->selection_mode == GTK_SELECTION_EXTENDED && list->anchor >= 0)
1504 gtk_list_end_selection (list);
1506 container = GTK_CONTAINER (list);
1508 switch (list->selection_mode)
1510 case GTK_SELECTION_BROWSE:
1511 if (container->focus_child)
1513 gtk_list_select_child (list, container->focus_child);
1518 case GTK_SELECTION_EXTENDED:
1519 g_list_free (list->undo_selection);
1520 g_list_free (list->undo_unselection);
1521 list->undo_selection = NULL;
1522 list->undo_unselection = NULL;
1525 list->drag_pos = -1;
1526 list->undo_focus_child = container->focus_child;
1533 work = list->selection;
1539 gtk_list_unselect_child (list, item);
1544 gtk_list_extend_selection (GtkList *list,
1545 GtkScrollType scroll_type,
1547 gboolean auto_start_selection)
1549 GtkContainer *container;
1551 g_return_if_fail (list != NULL);
1552 g_return_if_fail (GTK_IS_LIST (list));
1554 if ((gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list)) ||
1555 list->selection_mode != GTK_SELECTION_EXTENDED)
1558 container = GTK_CONTAINER (list);
1560 if (auto_start_selection)
1564 focus_row = g_list_index (list->children, container->focus_child);
1565 gtk_list_set_anchor (list, list->add_mode, focus_row,
1566 container->focus_child);
1568 else if (list->anchor < 0)
1571 gtk_list_move_focus_child (list, scroll_type, position);
1572 gtk_list_update_extended_selection
1573 (list, g_list_index (list->children, container->focus_child));
1577 gtk_list_end_drag_selection (GtkList *list)
1579 g_return_if_fail (list != NULL);
1580 g_return_if_fail (GTK_IS_LIST (list));
1582 list->drag_selection = FALSE;
1583 if (GTK_WIDGET_HAS_GRAB (list))
1585 gtk_grab_remove (GTK_WIDGET (list));
1586 gdk_pointer_ungrab (GDK_CURRENT_TIME);
1590 gtk_timeout_remove (list->htimer);
1595 gtk_timeout_remove (list->vtimer);
1601 gtk_list_start_selection (GtkList *list)
1603 GtkContainer *container;
1606 g_return_if_fail (list != NULL);
1607 g_return_if_fail (GTK_IS_LIST (list));
1609 if (gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list))
1612 container = GTK_CONTAINER (list);
1614 if ((focus_row = g_list_index (list->selection, container->focus_child))
1616 gtk_list_set_anchor (list, list->add_mode,
1617 focus_row, container->focus_child);
1621 gtk_list_end_selection (GtkList *list)
1629 g_return_if_fail (list != NULL);
1630 g_return_if_fail (GTK_IS_LIST (list));
1632 if ((gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list)) ||
1636 i = MIN (list->anchor, list->drag_pos);
1637 e = MAX (list->anchor, list->drag_pos);
1640 list->drag_pos = -1;
1642 if (list->undo_selection)
1644 work = list->selection;
1645 list->selection = list->undo_selection;
1646 list->undo_selection = work;
1647 work = list->selection;
1652 item_index = g_list_index (list->children, item);
1653 if (item_index < i || item_index > e)
1655 gtk_widget_set_state (item, GTK_STATE_SELECTED);
1656 gtk_list_unselect_child (list, item);
1657 list->undo_selection = g_list_prepend (list->undo_selection,
1663 for (work = g_list_nth (list->children, i); i <= e; i++, work = work->next)
1666 if (g_list_find (list->selection, item))
1668 if (item->state == GTK_STATE_NORMAL)
1670 gtk_widget_set_state (item, GTK_STATE_SELECTED);
1671 gtk_list_unselect_child (list, item);
1672 list->undo_selection = g_list_prepend (list->undo_selection,
1676 else if (item->state == GTK_STATE_SELECTED)
1678 gtk_widget_set_state (item, GTK_STATE_NORMAL);
1679 list->undo_unselection = g_list_prepend (list->undo_unselection,
1684 for (work = list->undo_unselection; work; work = work->next)
1685 gtk_list_select_child (list, GTK_WIDGET (work->data));
1690 gtk_list_toggle_row (GtkList *list,
1693 g_return_if_fail (list != NULL);
1694 g_return_if_fail (GTK_IS_LIST (list));
1695 g_return_if_fail (item != NULL);
1696 g_return_if_fail (GTK_IS_LIST_ITEM (item));
1698 switch (list->selection_mode)
1700 case GTK_SELECTION_EXTENDED:
1701 case GTK_SELECTION_MULTIPLE:
1702 case GTK_SELECTION_SINGLE:
1704 if (item->state == GTK_STATE_SELECTED)
1706 gtk_list_unselect_child (list, item);
1710 case GTK_SELECTION_BROWSE:
1711 gtk_list_select_child (list, item);
1717 gtk_list_toggle_focus_row (GtkList *list)
1719 GtkContainer *container;
1722 g_return_if_fail (list != 0);
1723 g_return_if_fail (GTK_IS_LIST (list));
1725 container = GTK_CONTAINER (list);
1727 if ((gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list)) ||
1728 !container->focus_child)
1731 switch (list->selection_mode)
1733 case GTK_SELECTION_SINGLE:
1734 case GTK_SELECTION_MULTIPLE:
1736 gtk_list_toggle_row (list, container->focus_child);
1739 case GTK_SELECTION_EXTENDED:
1741 if ((focus_row = g_list_index (list->children, container->focus_child))
1745 g_list_free (list->undo_selection);
1746 g_list_free (list->undo_unselection);
1747 list->undo_selection = NULL;
1748 list->undo_unselection = NULL;
1750 list->anchor = focus_row;
1751 list->drag_pos = focus_row;
1752 list->undo_focus_child = container->focus_child;
1755 gtk_list_fake_toggle_row (list, container->focus_child);
1757 gtk_list_fake_unselect_all (list, container->focus_child);
1759 gtk_list_end_selection (list);
1768 gtk_list_toggle_add_mode (GtkList *list)
1770 GtkContainer *container;
1772 g_return_if_fail (list != 0);
1773 g_return_if_fail (GTK_IS_LIST (list));
1775 if ((gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list)) ||
1776 list->selection_mode != GTK_SELECTION_EXTENDED)
1779 container = GTK_CONTAINER (list);
1783 list->add_mode = FALSE;
1784 list->anchor_state = GTK_STATE_SELECTED;
1787 list->add_mode = TRUE;
1789 if (container->focus_child)
1790 gtk_widget_queue_draw (container->focus_child);
1794 gtk_list_undo_selection (GtkList *list)
1798 g_return_if_fail (list != NULL);
1799 g_return_if_fail (GTK_IS_LIST (list));
1801 if (list->selection_mode != GTK_SELECTION_EXTENDED ||
1802 (gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list)))
1805 if (list->anchor >= 0)
1806 gtk_list_end_selection (list);
1808 if (!(list->undo_selection || list->undo_unselection))
1810 gtk_list_unselect_all (list);
1814 for (work = list->undo_selection; work; work = work->next)
1815 gtk_list_select_child (list, GTK_WIDGET (work->data));
1817 for (work = list->undo_unselection; work; work = work->next)
1818 gtk_list_unselect_child (list, GTK_WIDGET (work->data));
1820 if (list->undo_focus_child)
1822 GtkContainer *container;
1824 container = GTK_CONTAINER (list);
1826 if (container->focus_child &&
1827 GTK_WIDGET_HAS_FOCUS (container->focus_child))
1828 gtk_widget_grab_focus (list->undo_focus_child);
1830 gtk_container_set_focus_child (container, list->undo_focus_child);
1833 list->undo_focus_child = NULL;
1835 g_list_free (list->undo_selection);
1836 g_list_free (list->undo_unselection);
1837 list->undo_selection = NULL;
1838 list->undo_unselection = NULL;
1842 /* Private GtkList Selection Methods :
1844 * gtk_real_list_select_child
1845 * gtk_real_list_unselect_child
1848 gtk_real_list_select_child (GtkList *list,
1851 g_return_if_fail (list != NULL);
1852 g_return_if_fail (GTK_IS_LIST (list));
1853 g_return_if_fail (child != NULL);
1854 g_return_if_fail (GTK_IS_LIST_ITEM (child));
1856 switch (child->state)
1858 case GTK_STATE_SELECTED:
1859 case GTK_STATE_INSENSITIVE:
1862 gtk_list_item_select (GTK_LIST_ITEM (child));
1868 gtk_real_list_unselect_child (GtkList *list,
1871 g_return_if_fail (list != NULL);
1872 g_return_if_fail (GTK_IS_LIST (list));
1873 g_return_if_fail (child != NULL);
1874 g_return_if_fail (GTK_IS_LIST_ITEM (child));
1876 if (child->state == GTK_STATE_SELECTED)
1877 gtk_list_item_deselect (GTK_LIST_ITEM (child));
1881 /* Private GtkList Selection Functions :
1883 * gtk_list_set_anchor
1884 * gtk_list_fake_unselect_all
1885 * gtk_list_fake_toggle_row
1886 * gtk_list_update_extended_selection
1889 gtk_list_set_anchor (GtkList *list,
1892 GtkWidget *undo_focus_child)
1896 g_return_if_fail (list != NULL);
1897 g_return_if_fail (GTK_IS_LIST (list));
1899 if (list->selection_mode != GTK_SELECTION_EXTENDED || list->anchor >= 0)
1902 g_list_free (list->undo_selection);
1903 g_list_free (list->undo_unselection);
1904 list->undo_selection = NULL;
1905 list->undo_unselection = NULL;
1907 if ((work = g_list_nth (list->children, anchor)))
1910 gtk_list_fake_toggle_row (list, GTK_WIDGET (work->data));
1913 gtk_list_fake_unselect_all (list, GTK_WIDGET (work->data));
1914 list->anchor_state = GTK_STATE_SELECTED;
1918 list->anchor = anchor;
1919 list->drag_pos = anchor;
1920 list->undo_focus_child = undo_focus_child;
1924 gtk_list_fake_unselect_all (GtkList *list,
1929 if (item && item->state == GTK_STATE_NORMAL)
1930 gtk_widget_set_state (item, GTK_STATE_SELECTED);
1932 list->undo_selection = list->selection;
1933 list->selection = NULL;
1935 for (work = list->undo_selection; work; work = work->next)
1936 if (work->data != item)
1937 gtk_widget_set_state (GTK_WIDGET (work->data), GTK_STATE_NORMAL);
1941 gtk_list_fake_toggle_row (GtkList *list,
1947 if (item->state == GTK_STATE_NORMAL)
1949 list->anchor_state = GTK_STATE_SELECTED;
1950 gtk_widget_set_state (item, GTK_STATE_SELECTED);
1954 list->anchor_state = GTK_STATE_NORMAL;
1955 gtk_widget_set_state (item, GTK_STATE_NORMAL);
1960 gtk_list_update_extended_selection (GtkList *list,
1974 length = g_list_length (list->children);
1978 if (list->selection_mode != GTK_SELECTION_EXTENDED || !list->anchor < 0)
1981 /* extending downwards */
1982 if (row > list->drag_pos && list->anchor <= list->drag_pos)
1984 s2 = list->drag_pos + 1;
1987 /* extending upwards */
1988 else if (row < list->drag_pos && list->anchor >= list->drag_pos)
1991 e2 = list->drag_pos - 1;
1993 else if (row < list->drag_pos && list->anchor < list->drag_pos)
1995 e1 = list->drag_pos;
1996 /* row and drag_pos on different sides of anchor :
1997 take back the selection between anchor and drag_pos,
1998 select between anchor and row */
1999 if (row < list->anchor)
2001 s1 = list->anchor + 1;
2003 e2 = list->anchor - 1;
2005 /* take back the selection between anchor and drag_pos */
2009 else if (row > list->drag_pos && list->anchor > list->drag_pos)
2011 s1 = list->drag_pos;
2012 /* row and drag_pos on different sides of anchor :
2013 take back the selection between anchor and drag_pos,
2014 select between anchor and row */
2015 if (row > list->anchor)
2017 e1 = list->anchor - 1;
2018 s2 = list->anchor + 1;
2021 /* take back the selection between anchor and drag_pos */
2026 list->drag_pos = row;
2028 /* restore the elements between s1 and e1 */
2031 for (i = s1, work = g_list_nth (list->children, i); i <= e1;
2032 i++, work = work->next)
2034 if (g_list_find (list->selection, work->data))
2035 gtk_widget_set_state (GTK_WIDGET (work->data), GTK_STATE_SELECTED);
2037 gtk_widget_set_state (GTK_WIDGET (work->data), GTK_STATE_NORMAL);
2041 /* extend the selection between s2 and e2 */
2044 for (i = s2, work = g_list_nth (list->children, i); i <= e2;
2045 i++, work = work->next)
2046 if (GTK_WIDGET (work->data)->state != list->anchor_state)
2047 gtk_widget_set_state (GTK_WIDGET (work->data), list->anchor_state);
2052 /* Public GtkList Scroll Methods :
2054 * gtk_list_scroll_horizontal
2055 * gtk_list_scroll_vertical
2058 gtk_list_scroll_horizontal (GtkList *list,
2059 GtkScrollType scroll_type,
2064 g_return_if_fail (list != 0);
2065 g_return_if_fail (GTK_IS_LIST (list));
2067 if (gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list))
2071 gtk_object_get_data_by_id (GTK_OBJECT (list), hadjustment_key_id)))
2074 switch (scroll_type)
2076 case GTK_SCROLL_STEP_BACKWARD:
2077 adj->value = CLAMP (adj->value - adj->step_increment, adj->lower,
2078 adj->upper - adj->page_size);
2080 case GTK_SCROLL_STEP_FORWARD:
2081 adj->value = CLAMP (adj->value + adj->step_increment, adj->lower,
2082 adj->upper - adj->page_size);
2084 case GTK_SCROLL_PAGE_BACKWARD:
2085 adj->value = CLAMP (adj->value - adj->page_increment, adj->lower,
2086 adj->upper - adj->page_size);
2088 case GTK_SCROLL_PAGE_FORWARD:
2089 adj->value = CLAMP (adj->value + adj->page_increment, adj->lower,
2090 adj->upper - adj->page_size);
2092 case GTK_SCROLL_JUMP:
2093 adj->value = CLAMP (adj->lower + (adj->upper - adj->lower) * position,
2094 adj->lower, adj->upper - adj->page_size);
2099 gtk_adjustment_value_changed (adj);
2103 gtk_list_scroll_vertical (GtkList *list,
2104 GtkScrollType scroll_type,
2107 g_return_if_fail (list != NULL);
2108 g_return_if_fail (GTK_IS_LIST (list));
2110 if (gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (list))
2113 if (list->selection_mode == GTK_SELECTION_EXTENDED)
2115 GtkContainer *container;
2117 if (list->anchor >= 0)
2120 container = GTK_CONTAINER (list);
2121 list->undo_focus_child = container->focus_child;
2122 gtk_list_move_focus_child (list, scroll_type, position);
2123 if (container->focus_child != list->undo_focus_child && !list->add_mode)
2125 gtk_list_unselect_all (list);
2126 gtk_list_select_child (list, container->focus_child);
2130 gtk_list_move_focus_child (list, scroll_type, position);
2134 /* Private GtkList Scroll/Focus Functions :
2136 * gtk_list_move_focus_child
2137 * gtk_list_horizontal_timeout
2138 * gtk_list_vertical_timeout
2141 gtk_list_move_focus_child (GtkList *list,
2142 GtkScrollType scroll_type,
2145 GtkContainer *container;
2151 g_return_if_fail (list != 0);
2152 g_return_if_fail (GTK_IS_LIST (list));
2154 container = GTK_CONTAINER (list);
2156 if (container->focus_child)
2157 work = g_list_find (list->children, container->focus_child);
2159 work = list->children;
2164 switch (scroll_type)
2166 case GTK_SCROLL_STEP_BACKWARD:
2169 gtk_widget_grab_focus (GTK_WIDGET (work->data));
2172 case GTK_SCROLL_STEP_FORWARD:
2175 gtk_widget_grab_focus (GTK_WIDGET (work->data));
2178 case GTK_SCROLL_PAGE_BACKWARD:
2183 adj = gtk_object_get_data_by_id (GTK_OBJECT (list), vadjustment_key_id);
2187 gboolean correct = FALSE;
2189 new_value = adj->value;
2191 if (item->allocation.y <= adj->value)
2193 new_value = MAX (item->allocation.y + item->allocation.height
2194 - adj->page_size, adj->lower);
2198 if (item->allocation.y > new_value)
2199 for (; work; work = work->prev)
2201 item = GTK_WIDGET (work->data);
2202 if (item->allocation.y <= new_value &&
2203 item->allocation.y + item->allocation.height > new_value)
2207 for (; work; work = work->next)
2209 item = GTK_WIDGET (work->data);
2210 if (item->allocation.y <= new_value &&
2211 item->allocation.y + item->allocation.height > new_value)
2215 if (correct && work && work->next && item->allocation.y < new_value)
2216 item = work->next->data;
2219 item = list->children->data;
2221 gtk_widget_grab_focus (item);
2224 case GTK_SCROLL_PAGE_FORWARD:
2229 adj = gtk_object_get_data_by_id (GTK_OBJECT (list), vadjustment_key_id);
2233 gboolean correct = FALSE;
2235 new_value = adj->value;
2237 if (item->allocation.y + item->allocation.height >=
2238 adj->value + adj->page_size)
2240 new_value = item->allocation.y;
2244 new_value = MIN (new_value + adj->page_size, adj->upper);
2246 if (item->allocation.y > new_value)
2247 for (; work; work = work->prev)
2249 item = GTK_WIDGET (work->data);
2250 if (item->allocation.y <= new_value &&
2251 item->allocation.y + item->allocation.height > new_value)
2255 for (; work; work = work->next)
2257 item = GTK_WIDGET (work->data);
2258 if (item->allocation.y <= new_value &&
2259 item->allocation.y + item->allocation.height > new_value)
2263 if (correct && work && work->prev &&
2264 item->allocation.y + item->allocation.height - 1 > new_value)
2265 item = work->prev->data;
2268 item = g_list_last (work)->data;
2270 gtk_widget_grab_focus (item);
2273 case GTK_SCROLL_JUMP:
2274 new_value = GTK_WIDGET(list)->allocation.height * CLAMP (position, 0, 1);
2276 for (item = NULL, work = list->children; work; work =work->next)
2278 item = GTK_WIDGET (work->data);
2279 if (item->allocation.y <= new_value &&
2280 item->allocation.y + item->allocation.height > new_value)
2284 gtk_widget_grab_focus (item);
2293 gtk_list_horizontal_timeout (GtkWidget *list)
2296 GdkEventMotion event;
2297 GdkModifierType mask;
2299 g_return_val_if_fail (GTK_IS_LIST (list), FALSE);
2301 GTK_LIST (list)->htimer = 0;
2302 gdk_window_get_pointer (list->window, &x, &y, &mask);
2309 gtk_list_motion_notify (list, &event);
2315 gtk_list_vertical_timeout (GtkWidget *list)
2319 GdkEventMotion event;
2320 GdkModifierType mask;
2322 g_return_val_if_fail (GTK_IS_LIST (list), FALSE);
2324 GTK_LIST (list)->vtimer = 0;
2325 gdk_window_get_pointer (list->window, &x, &y, &mask);
2332 gtk_list_motion_notify (list, &event);
2338 /* Private GtkListItem Signal Functions :
2340 * gtk_list_signal_focus_lost
2341 * gtk_list_signal_toggle_focus_row
2342 * gtk_list_signal_select_all
2343 * gtk_list_signal_unselect_all
2344 * gtk_list_signal_undo_selection
2345 * gtk_list_signal_start_selection
2346 * gtk_list_signal_end_selection
2347 * gtk_list_signal_extend_selection
2348 * gtk_list_signal_scroll_horizontal
2349 * gtk_list_signal_scroll_vertical
2350 * gtk_list_signal_toggle_add_mode
2351 * gtk_list_signal_item_select
2352 * gtk_list_signal_item_deselect
2353 * gtk_list_signal_item_toggle
2356 gtk_list_signal_focus_lost (GtkWidget *item,
2360 g_return_if_fail (list != NULL);
2361 g_return_if_fail (GTK_IS_LIST (list));
2362 g_return_if_fail (item != NULL);
2363 g_return_if_fail (GTK_IS_LIST_ITEM (item));
2365 if (list->selection_mode == GTK_SELECTION_EXTENDED &&
2366 list->anchor >= 0 &&
2367 item == GTK_CONTAINER (list)->focus_child)
2368 gtk_list_end_selection (list);
2372 gtk_list_signal_toggle_focus_row (GtkListItem *list_item,
2375 g_return_if_fail (list_item != 0);
2376 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2377 g_return_if_fail (list != NULL);
2378 g_return_if_fail (GTK_IS_LIST (list));
2380 gtk_list_toggle_focus_row (list);
2384 gtk_list_signal_select_all (GtkListItem *list_item,
2387 g_return_if_fail (list_item != 0);
2388 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2389 g_return_if_fail (list != NULL);
2390 g_return_if_fail (GTK_IS_LIST (list));
2392 gtk_list_select_all (list);
2396 gtk_list_signal_unselect_all (GtkListItem *list_item,
2399 g_return_if_fail (list_item != 0);
2400 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2401 g_return_if_fail (list != NULL);
2402 g_return_if_fail (GTK_IS_LIST (list));
2404 gtk_list_unselect_all (list);
2408 gtk_list_signal_undo_selection (GtkListItem *list_item,
2411 g_return_if_fail (list_item != 0);
2412 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2413 g_return_if_fail (list != NULL);
2414 g_return_if_fail (GTK_IS_LIST (list));
2416 gtk_list_undo_selection (list);
2420 gtk_list_signal_start_selection (GtkListItem *list_item,
2423 g_return_if_fail (list_item != 0);
2424 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2425 g_return_if_fail (list != NULL);
2426 g_return_if_fail (GTK_IS_LIST (list));
2428 gtk_list_start_selection (list);
2432 gtk_list_signal_end_selection (GtkListItem *list_item,
2435 g_return_if_fail (list_item != 0);
2436 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2437 g_return_if_fail (list != NULL);
2438 g_return_if_fail (GTK_IS_LIST (list));
2440 gtk_list_end_selection (list);
2444 gtk_list_signal_extend_selection (GtkListItem *list_item,
2445 GtkScrollType scroll_type,
2447 gboolean auto_start_selection,
2450 g_return_if_fail (list_item != 0);
2451 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2452 g_return_if_fail (list != NULL);
2453 g_return_if_fail (GTK_IS_LIST (list));
2455 gtk_list_extend_selection (list, scroll_type, position,
2456 auto_start_selection);
2460 gtk_list_signal_scroll_horizontal (GtkListItem *list_item,
2461 GtkScrollType scroll_type,
2465 g_return_if_fail (list_item != 0);
2466 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2467 g_return_if_fail (list != NULL);
2468 g_return_if_fail (GTK_IS_LIST (list));
2470 gtk_list_scroll_horizontal (list, scroll_type, position);
2474 gtk_list_signal_scroll_vertical (GtkListItem *list_item,
2475 GtkScrollType scroll_type,
2479 g_return_if_fail (list_item != 0);
2480 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2481 g_return_if_fail (list != NULL);
2482 g_return_if_fail (GTK_IS_LIST (list));
2484 gtk_list_scroll_vertical (list, scroll_type, position);
2488 gtk_list_signal_toggle_add_mode (GtkListItem *list_item,
2491 g_return_if_fail (list_item != 0);
2492 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2493 g_return_if_fail (list != NULL);
2494 g_return_if_fail (GTK_IS_LIST (list));
2496 gtk_list_toggle_add_mode (list);
2500 gtk_list_signal_item_select (GtkListItem *list_item,
2507 g_return_if_fail (list_item != 0);
2508 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2509 g_return_if_fail (list != NULL);
2510 g_return_if_fail (GTK_IS_LIST (list));
2512 if (GTK_WIDGET (list_item)->state != GTK_STATE_SELECTED)
2515 switch (list->selection_mode)
2517 case GTK_SELECTION_SINGLE:
2518 case GTK_SELECTION_BROWSE:
2520 selection = list->selection;
2524 tmp_list = selection;
2525 selection = selection->next;
2527 if (tmp_list->data == list_item)
2528 sel_list = tmp_list;
2530 gtk_list_item_deselect (GTK_LIST_ITEM (tmp_list->data));
2535 list->selection = g_list_prepend (list->selection, list_item);
2536 gtk_widget_ref (GTK_WIDGET (list_item));
2538 gtk_signal_emit (GTK_OBJECT (list), list_signals[SELECTION_CHANGED]);
2540 case GTK_SELECTION_EXTENDED:
2541 if (list->anchor >= 0)
2543 case GTK_SELECTION_MULTIPLE:
2544 if (!g_list_find (list->selection, list_item))
2546 list->selection = g_list_prepend (list->selection, list_item);
2547 gtk_widget_ref (GTK_WIDGET (list_item));
2548 gtk_signal_emit (GTK_OBJECT (list), list_signals[SELECTION_CHANGED]);
2555 gtk_list_signal_item_deselect (GtkListItem *list_item,
2560 g_return_if_fail (list_item != 0);
2561 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2562 g_return_if_fail (list != NULL);
2563 g_return_if_fail (GTK_IS_LIST (list));
2565 if (GTK_WIDGET (list_item)->state != GTK_STATE_NORMAL)
2568 node = g_list_find (list->selection, list_item);
2572 list->selection = g_list_remove_link (list->selection, node);
2573 g_list_free_1 (node);
2574 gtk_widget_unref (GTK_WIDGET (list_item));
2575 gtk_signal_emit (GTK_OBJECT (list), list_signals[SELECTION_CHANGED]);
2580 gtk_list_signal_item_toggle (GtkListItem *list_item,
2583 g_return_if_fail (list_item != 0);
2584 g_return_if_fail (GTK_IS_LIST_ITEM (list_item));
2585 g_return_if_fail (list != NULL);
2586 g_return_if_fail (GTK_IS_LIST (list));
2588 switch (GTK_WIDGET (list_item)->state)
2590 case GTK_STATE_SELECTED:
2591 gtk_list_signal_item_select (list_item, list);
2593 case GTK_STATE_NORMAL:
2594 gtk_list_signal_item_deselect (list_item, list);