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 Lesser 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 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser 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.
21 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GTK+ Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
29 #include "gtkbindings.h"
30 #include "gtksignal.h"
31 #include "gdk/gdkkeysyms.h"
32 #include "gtkwindow.h"
34 #include "gtkmarshalers.h"
52 static void gtk_paned_class_init (GtkPanedClass *klass);
53 static void gtk_paned_init (GtkPaned *paned);
54 static void gtk_paned_set_property (GObject *object,
58 static void gtk_paned_get_property (GObject *object,
62 static void gtk_paned_realize (GtkWidget *widget);
63 static void gtk_paned_unrealize (GtkWidget *widget);
64 static void gtk_paned_map (GtkWidget *widget);
65 static void gtk_paned_unmap (GtkWidget *widget);
66 static gint gtk_paned_expose (GtkWidget *widget,
67 GdkEventExpose *event);
68 static gboolean gtk_paned_focus (GtkWidget *widget,
69 GtkDirectionType direction);
70 static void gtk_paned_add (GtkContainer *container,
72 static void gtk_paned_remove (GtkContainer *container,
74 static void gtk_paned_forall (GtkContainer *container,
75 gboolean include_internals,
77 gpointer callback_data);
78 static void gtk_paned_set_focus_child (GtkContainer *container,
80 static void gtk_paned_set_saved_focus (GtkPaned *paned,
82 static void gtk_paned_set_last_child1_focus (GtkPaned *paned,
84 static void gtk_paned_set_last_child2_focus (GtkPaned *paned,
86 static gboolean gtk_paned_cycle_child_focus (GtkPaned *paned,
88 static gboolean gtk_paned_cycle_handle_focus (GtkPaned *paned,
90 static gboolean gtk_paned_move_handle (GtkPaned *paned,
91 GtkScrollType scroll);
92 static gboolean gtk_paned_accept_position (GtkPaned *paned);
93 static gboolean gtk_paned_cancel_position (GtkPaned *paned);
94 static gboolean gtk_paned_toggle_handle_focus (GtkPaned *paned);
95 static GtkType gtk_paned_child_type (GtkContainer *container);
97 static GtkContainerClass *parent_class = NULL;
101 gtk_paned_get_type (void)
103 static GtkType paned_type = 0;
107 static const GtkTypeInfo paned_info =
111 sizeof (GtkPanedClass),
112 (GtkClassInitFunc) gtk_paned_class_init,
113 (GtkObjectInitFunc) gtk_paned_init,
114 /* reserved_1 */ NULL,
115 /* reserved_2 */ NULL,
116 (GtkClassInitFunc) NULL,
119 paned_type = gtk_type_unique (GTK_TYPE_CONTAINER, &paned_info);
125 static guint signals[LAST_SIGNAL] = { 0 };
128 add_tab_bindings (GtkBindingSet *binding_set,
129 GdkModifierType modifiers,
132 gtk_binding_entry_add_signal (binding_set, GDK_Tab, modifiers,
133 "cycle_handle_focus", 1,
134 G_TYPE_BOOLEAN, reverse);
135 gtk_binding_entry_add_signal (binding_set, GDK_KP_Tab, modifiers,
136 "cycle_handle_focus", 1,
137 G_TYPE_BOOLEAN, reverse);
138 gtk_binding_entry_add_signal (binding_set, GDK_ISO_Left_Tab, modifiers,
139 "cycle_handle_focus", 1,
140 G_TYPE_BOOLEAN, reverse);
144 add_move_binding (GtkBindingSet *binding_set,
146 GdkModifierType mask,
147 GtkScrollType scroll)
149 gtk_binding_entry_add_signal (binding_set, keyval, mask,
151 GTK_TYPE_SCROLL_TYPE, scroll);
155 gtk_paned_class_init (GtkPanedClass *class)
157 GObjectClass *object_class;
158 GtkWidgetClass *widget_class;
159 GtkContainerClass *container_class;
160 GtkPanedClass *paned_class;
161 GtkBindingSet *binding_set;
163 object_class = (GObjectClass *) class;
164 widget_class = (GtkWidgetClass *) class;
165 container_class = (GtkContainerClass *) class;
166 paned_class = (GtkPanedClass *) class;
168 parent_class = gtk_type_class (GTK_TYPE_CONTAINER);
170 object_class->set_property = gtk_paned_set_property;
171 object_class->get_property = gtk_paned_get_property;
173 widget_class->realize = gtk_paned_realize;
174 widget_class->unrealize = gtk_paned_unrealize;
175 widget_class->map = gtk_paned_map;
176 widget_class->unmap = gtk_paned_unmap;
177 widget_class->expose_event = gtk_paned_expose;
178 widget_class->focus = gtk_paned_focus;
180 container_class->add = gtk_paned_add;
181 container_class->remove = gtk_paned_remove;
182 container_class->forall = gtk_paned_forall;
183 container_class->child_type = gtk_paned_child_type;
184 container_class->set_focus_child = gtk_paned_set_focus_child;
186 paned_class->cycle_child_focus = gtk_paned_cycle_child_focus;
187 paned_class->toggle_handle_focus = gtk_paned_toggle_handle_focus;
188 paned_class->move_handle = gtk_paned_move_handle;
189 paned_class->cycle_handle_focus = gtk_paned_cycle_handle_focus;
190 paned_class->accept_position = gtk_paned_accept_position;
191 paned_class->cancel_position = gtk_paned_cancel_position;
193 g_object_class_install_property (object_class,
195 g_param_spec_int ("position",
197 _("Position of paned separator in pixels (0 means all the way to the left/top)"),
201 G_PARAM_READABLE | G_PARAM_WRITABLE));
202 g_object_class_install_property (object_class,
204 g_param_spec_boolean ("position_set",
206 _("TRUE if the Position property should be used"),
208 G_PARAM_READABLE | G_PARAM_WRITABLE));
210 gtk_widget_class_install_style_property (widget_class,
211 g_param_spec_int ("handle_size",
213 _("Width of handle"),
219 signals [CYCLE_HANDLE_FOCUS] =
220 g_signal_new ("cycle_child_focus",
221 G_TYPE_FROM_CLASS (object_class),
222 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
223 G_STRUCT_OFFSET (GtkPanedClass, cycle_child_focus),
225 _gtk_marshal_BOOLEAN__BOOLEAN,
229 signals [TOGGLE_HANDLE_FOCUS] =
230 g_signal_new ("toggle_handle_focus",
231 G_TYPE_FROM_CLASS (object_class),
232 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
233 G_STRUCT_OFFSET (GtkPanedClass, toggle_handle_focus),
235 _gtk_marshal_BOOLEAN__VOID,
238 signals[MOVE_HANDLE] =
239 g_signal_new ("move_handle",
240 G_TYPE_FROM_CLASS (object_class),
241 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
242 G_STRUCT_OFFSET (GtkPanedClass, move_handle),
244 _gtk_marshal_BOOLEAN__ENUM,
246 GTK_TYPE_SCROLL_TYPE);
248 signals [CYCLE_HANDLE_FOCUS] =
249 g_signal_new ("cycle_handle_focus",
250 G_TYPE_FROM_CLASS (object_class),
251 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
252 G_STRUCT_OFFSET (GtkPanedClass, cycle_handle_focus),
254 _gtk_marshal_BOOLEAN__BOOLEAN,
258 signals [ACCEPT_POSITION] =
259 g_signal_new ("accept_position",
260 G_TYPE_FROM_CLASS (object_class),
261 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
262 G_STRUCT_OFFSET (GtkPanedClass, accept_position),
264 _gtk_marshal_BOOLEAN__VOID,
267 signals [CANCEL_POSITION] =
268 g_signal_new ("cancel_position",
269 G_TYPE_FROM_CLASS (object_class),
270 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
271 G_STRUCT_OFFSET (GtkPanedClass, cancel_position),
273 _gtk_marshal_BOOLEAN__VOID,
276 binding_set = gtk_binding_set_by_class (object_class);
279 gtk_binding_entry_add_signal (binding_set,
281 "cycle_child_focus", 1,
282 G_TYPE_BOOLEAN, FALSE);
283 gtk_binding_entry_add_signal (binding_set,
284 GDK_F6, GDK_SHIFT_MASK,
285 "cycle_child_focus", 1,
286 G_TYPE_BOOLEAN, TRUE);
289 gtk_binding_entry_add_signal (binding_set,
291 "toggle_handle_focus", 0);
293 add_tab_bindings (binding_set, 0, GTK_DIR_TAB_FORWARD);
294 add_tab_bindings (binding_set, GDK_CONTROL_MASK, GTK_DIR_TAB_FORWARD);
295 add_tab_bindings (binding_set, GDK_SHIFT_MASK, GTK_DIR_TAB_BACKWARD);
296 add_tab_bindings (binding_set, GDK_CONTROL_MASK | GDK_SHIFT_MASK, GTK_DIR_TAB_BACKWARD);
298 /* accept and cancel positions */
299 gtk_binding_entry_add_signal (binding_set,
301 "cancel_position", 0);
303 gtk_binding_entry_add_signal (binding_set,
305 "accept_position", 0);
306 gtk_binding_entry_add_signal (binding_set,
308 "accept_position", 0);
309 gtk_binding_entry_add_signal (binding_set,
311 "accept_position", 0);
312 gtk_binding_entry_add_signal (binding_set,
314 "accept_position", 0);
317 add_move_binding (binding_set, GDK_Left, 0, GTK_SCROLL_STEP_LEFT);
318 add_move_binding (binding_set, GDK_KP_Left, 0, GTK_SCROLL_STEP_LEFT);
319 add_move_binding (binding_set, GDK_Left, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_LEFT);
320 add_move_binding (binding_set, GDK_KP_Left, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_LEFT);
322 add_move_binding (binding_set, GDK_Right, 0, GTK_SCROLL_STEP_RIGHT);
323 add_move_binding (binding_set, GDK_Right, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_RIGHT);
324 add_move_binding (binding_set, GDK_KP_Right, 0, GTK_SCROLL_STEP_RIGHT);
325 add_move_binding (binding_set, GDK_KP_Right, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_RIGHT);
327 add_move_binding (binding_set, GDK_Up, 0, GTK_SCROLL_STEP_UP);
328 add_move_binding (binding_set, GDK_Up, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_UP);
329 add_move_binding (binding_set, GDK_KP_Up, 0, GTK_SCROLL_STEP_UP);
330 add_move_binding (binding_set, GDK_KP_Up, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_UP);
331 add_move_binding (binding_set, GDK_Page_Up, 0, GTK_SCROLL_PAGE_UP);
332 add_move_binding (binding_set, GDK_KP_Page_Up, 0, GTK_SCROLL_PAGE_UP);
334 add_move_binding (binding_set, GDK_Down, 0, GTK_SCROLL_STEP_DOWN);
335 add_move_binding (binding_set, GDK_Down, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_DOWN);
336 add_move_binding (binding_set, GDK_KP_Down, 0, GTK_SCROLL_STEP_DOWN);
337 add_move_binding (binding_set, GDK_KP_Down, GDK_CONTROL_MASK, GTK_SCROLL_PAGE_DOWN);
338 add_move_binding (binding_set, GDK_Page_Down, 0, GTK_SCROLL_PAGE_RIGHT);
339 add_move_binding (binding_set, GDK_KP_Page_Down, 0, GTK_SCROLL_PAGE_RIGHT);
341 add_move_binding (binding_set, GDK_Home, 0, GTK_SCROLL_START);
342 add_move_binding (binding_set, GDK_KP_Home, 0, GTK_SCROLL_START);
343 add_move_binding (binding_set, GDK_End, 0, GTK_SCROLL_END);
344 add_move_binding (binding_set, GDK_KP_End, 0, GTK_SCROLL_END);
348 gtk_paned_child_type (GtkContainer *container)
350 if (!GTK_PANED (container)->child1 || !GTK_PANED (container)->child2)
351 return GTK_TYPE_WIDGET;
353 return GTK_TYPE_NONE;
357 gtk_paned_init (GtkPaned *paned)
359 GTK_WIDGET_SET_FLAGS (paned, GTK_NO_WINDOW | GTK_CAN_FOCUS);
361 paned->child1 = NULL;
362 paned->child2 = NULL;
363 paned->handle = NULL;
364 paned->xor_gc = NULL;
365 paned->cursor_type = GDK_CROSS;
367 paned->handle_pos.width = 5;
368 paned->handle_pos.height = 5;
369 paned->position_set = FALSE;
370 paned->last_allocation = -1;
371 paned->in_drag = FALSE;
373 paned->saved_focus = NULL;
374 paned->last_child1_focus = NULL;
375 paned->last_child2_focus = NULL;
376 paned->in_recursion = FALSE;
377 paned->original_position = -1;
379 paned->handle_pos.x = -1;
380 paned->handle_pos.y = -1;
384 gtk_paned_set_property (GObject *object,
389 GtkPaned *paned = GTK_PANED (object);
394 gtk_paned_set_position (paned, g_value_get_int (value));
396 case PROP_POSITION_SET:
397 paned->position_set = g_value_get_boolean (value);
398 gtk_widget_queue_resize (GTK_WIDGET (paned));
401 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
407 gtk_paned_get_property (GObject *object,
412 GtkPaned *paned = GTK_PANED (object);
417 g_value_set_int (value, paned->child1_size);
419 case PROP_POSITION_SET:
420 g_value_set_boolean (value, paned->position_set);
423 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
429 gtk_paned_realize (GtkWidget *widget)
432 GdkWindowAttr attributes;
433 gint attributes_mask;
435 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
436 paned = GTK_PANED (widget);
438 widget->window = gtk_widget_get_parent_window (widget);
439 gdk_window_ref (widget->window);
441 attributes.window_type = GDK_WINDOW_CHILD;
442 attributes.wclass = GDK_INPUT_ONLY;
443 attributes.x = paned->handle_pos.x;
444 attributes.y = paned->handle_pos.y;
445 attributes.width = paned->handle_pos.width;
446 attributes.height = paned->handle_pos.height;
447 attributes.cursor = gdk_cursor_new (paned->cursor_type);
448 attributes.event_mask |= (GDK_BUTTON_PRESS_MASK |
449 GDK_BUTTON_RELEASE_MASK |
450 GDK_POINTER_MOTION_MASK |
451 GDK_POINTER_MOTION_HINT_MASK);
452 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_CURSOR;
454 paned->handle = gdk_window_new (widget->window,
455 &attributes, attributes_mask);
456 gdk_window_set_user_data (paned->handle, paned);
457 gdk_cursor_destroy (attributes.cursor);
459 widget->style = gtk_style_attach (widget->style, widget->window);
461 if (paned->child1 && GTK_WIDGET_VISIBLE (paned->child1) &&
462 paned->child2 && GTK_WIDGET_VISIBLE (paned->child2))
463 gdk_window_show (paned->handle);
467 gtk_paned_unrealize (GtkWidget *widget)
469 GtkPaned *paned = GTK_PANED (widget);
473 gdk_gc_destroy (paned->xor_gc);
474 paned->xor_gc = NULL;
479 gdk_window_set_user_data (paned->handle, NULL);
480 gdk_window_destroy (paned->handle);
481 paned->handle = NULL;
484 gtk_paned_set_last_child1_focus (paned, NULL);
485 gtk_paned_set_last_child2_focus (paned, NULL);
486 gtk_paned_set_saved_focus (paned, NULL);
488 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
489 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
493 gtk_paned_map (GtkWidget *widget)
495 GtkPaned *paned = GTK_PANED (widget);
497 gdk_window_show (paned->handle);
499 GTK_WIDGET_CLASS (parent_class)->map (widget);
503 gtk_paned_unmap (GtkWidget *widget)
505 GtkPaned *paned = GTK_PANED (widget);
507 gdk_window_hide (paned->handle);
509 GTK_WIDGET_CLASS (parent_class)->unmap (widget);
513 gtk_paned_expose (GtkWidget *widget,
514 GdkEventExpose *event)
516 GtkPaned *paned = GTK_PANED (widget);
518 if (GTK_WIDGET_VISIBLE (widget) && GTK_WIDGET_MAPPED (widget) &&
519 paned->child1 && GTK_WIDGET_VISIBLE (paned->child1) &&
520 paned->child2 && GTK_WIDGET_VISIBLE (paned->child2))
524 region = gdk_region_rectangle (&paned->handle_pos);
525 gdk_region_intersect (region, event->region);
527 if (!gdk_region_empty (region))
532 gdk_region_get_clipbox (region, &clip);
534 state = GTK_WIDGET_STATE (widget);
535 if (gtk_widget_is_focus (widget))
536 state = GTK_STATE_SELECTED;
538 gtk_paint_handle (widget->style, widget->window,
539 state, GTK_SHADOW_NONE,
540 &clip, widget, "paned",
541 paned->handle_pos.x, paned->handle_pos.y,
542 paned->handle_pos.width, paned->handle_pos.height,
546 gdk_region_destroy (region);
549 /* Chain up to draw children */
550 GTK_WIDGET_CLASS (parent_class)->expose_event (widget, event);
556 gtk_paned_focus (GtkWidget *widget,
557 GtkDirectionType direction)
562 /* This is a hack, but how can this be done without
563 * excessive cut-and-paste from gtkcontainer.c?
566 GTK_WIDGET_UNSET_FLAGS (widget, GTK_CAN_FOCUS);
567 retval = (* GTK_WIDGET_CLASS (parent_class)->focus) (widget, direction);
568 GTK_WIDGET_SET_FLAGS (widget, GTK_CAN_FOCUS);
574 gtk_paned_add1 (GtkPaned *paned,
577 gtk_paned_pack1 (paned, widget, FALSE, TRUE);
581 gtk_paned_add2 (GtkPaned *paned,
584 gtk_paned_pack2 (paned, widget, TRUE, TRUE);
588 gtk_paned_pack1 (GtkPaned *paned,
593 g_return_if_fail (GTK_IS_PANED (paned));
594 g_return_if_fail (GTK_IS_WIDGET (child));
598 paned->child1 = child;
599 paned->child1_resize = resize;
600 paned->child1_shrink = shrink;
602 gtk_widget_set_parent (child, GTK_WIDGET (paned));
607 gtk_paned_pack2 (GtkPaned *paned,
612 g_return_if_fail (GTK_IS_PANED (paned));
613 g_return_if_fail (GTK_IS_WIDGET (child));
617 paned->child2 = child;
618 paned->child2_resize = resize;
619 paned->child2_shrink = shrink;
621 gtk_widget_set_parent (child, GTK_WIDGET (paned));
627 gtk_paned_add (GtkContainer *container,
632 g_return_if_fail (GTK_IS_PANED (container));
634 paned = GTK_PANED (container);
637 gtk_paned_add1 (paned, widget);
638 else if (!paned->child2)
639 gtk_paned_add2 (paned, widget);
643 gtk_paned_remove (GtkContainer *container,
647 gboolean was_visible;
649 paned = GTK_PANED (container);
650 was_visible = GTK_WIDGET_VISIBLE (widget);
652 if (paned->child1 == widget)
654 gtk_widget_unparent (widget);
656 paned->child1 = NULL;
658 if (was_visible && GTK_WIDGET_VISIBLE (container))
659 gtk_widget_queue_resize (GTK_WIDGET (container));
661 else if (paned->child2 == widget)
663 gtk_widget_unparent (widget);
665 paned->child2 = NULL;
667 if (was_visible && GTK_WIDGET_VISIBLE (container))
668 gtk_widget_queue_resize (GTK_WIDGET (container));
673 gtk_paned_forall (GtkContainer *container,
674 gboolean include_internals,
675 GtkCallback callback,
676 gpointer callback_data)
680 g_return_if_fail (callback != NULL);
682 paned = GTK_PANED (container);
685 (*callback) (paned->child1, callback_data);
687 (*callback) (paned->child2, callback_data);
691 * gtk_paned_get_position:
692 * @paned: a #GtkPaned widget
694 * Obtains the position of the divider between the two panes.
696 * Return value: position of the divider
699 gtk_paned_get_position (GtkPaned *paned)
701 g_return_val_if_fail (GTK_IS_PANED (paned), 0);
703 return paned->child1_size;
707 * gtk_paned_set_position:
708 * @paned: a #GtkPaned widget
709 * @position: pixel position of divider, a negative value means that the position
712 * Sets the position of the divider between the two panes.
715 gtk_paned_set_position (GtkPaned *paned,
720 g_return_if_fail (GTK_IS_PANED (paned));
722 object = G_OBJECT (paned);
726 /* We don't clamp here - the assumption is that
727 * if the total allocation changes at the same time
728 * as the position, the position set is with reference
729 * to the new total size. If only the position changes,
730 * then clamping will occur in gtk_paned_compute_position()
733 paned->child1_size = position;
734 paned->position_set = TRUE;
738 paned->position_set = FALSE;
741 g_object_freeze_notify (object);
742 g_object_notify (object, "position");
743 g_object_notify (object, "position_set");
744 g_object_thaw_notify (object);
746 gtk_widget_queue_resize (GTK_WIDGET (paned));
750 gtk_paned_compute_position (GtkPaned *paned,
757 g_return_if_fail (GTK_IS_PANED (paned));
759 old_position = paned->child1_size;
761 paned->min_position = paned->child1_shrink ? 0 : child1_req;
763 paned->max_position = allocation;
764 if (!paned->child2_shrink)
765 paned->max_position = MAX (1, paned->max_position - child2_req);
767 if (!paned->position_set)
769 if (paned->child1_resize && !paned->child2_resize)
770 paned->child1_size = MAX (1, allocation - child2_req);
771 else if (!paned->child1_resize && paned->child2_resize)
772 paned->child1_size = child1_req;
773 else if (child1_req + child2_req != 0)
774 paned->child1_size = allocation * ((gdouble)child1_req / (child1_req + child2_req));
776 paned->child1_size = allocation * 0.5;
780 /* If the position was set before the initial allocation.
781 * (paned->last_allocation <= 0) just clamp it and leave it.
783 if (paned->last_allocation > 0)
785 if (paned->child1_resize && !paned->child2_resize)
786 paned->child1_size += allocation - paned->last_allocation;
787 else if (!(!paned->child1_resize && paned->child2_resize))
788 paned->child1_size = allocation * ((gdouble) paned->child1_size / (paned->last_allocation));
792 paned->child1_size = CLAMP (paned->child1_size,
794 paned->max_position);
796 if (paned->child1_size != old_position)
797 g_object_notify (G_OBJECT (paned), "position");
799 paned->last_allocation = allocation;
803 gtk_paned_set_saved_focus (GtkPaned *paned, GtkWidget *widget)
805 if (paned->saved_focus)
806 g_object_remove_weak_pointer (G_OBJECT (paned->saved_focus),
807 (gpointer *)&(paned->saved_focus));
809 paned->saved_focus = widget;
811 if (paned->saved_focus)
812 g_object_add_weak_pointer (G_OBJECT (paned->saved_focus),
813 (gpointer *)&(paned->saved_focus));
817 gtk_paned_set_last_child1_focus (GtkPaned *paned, GtkWidget *widget)
819 if (paned->last_child1_focus)
820 g_object_remove_weak_pointer (G_OBJECT (paned->last_child1_focus),
821 (gpointer *)&(paned->last_child1_focus));
823 paned->last_child1_focus = widget;
825 if (paned->last_child1_focus)
826 g_object_add_weak_pointer (G_OBJECT (paned->last_child1_focus),
827 (gpointer *)&(paned->last_child1_focus));
831 gtk_paned_set_last_child2_focus (GtkPaned *paned, GtkWidget *widget)
833 if (paned->last_child2_focus)
834 g_object_remove_weak_pointer (G_OBJECT (paned->last_child2_focus),
835 (gpointer *)&(paned->last_child2_focus));
837 paned->last_child2_focus = widget;
839 if (paned->last_child2_focus)
840 g_object_add_weak_pointer (G_OBJECT (paned->last_child2_focus),
841 (gpointer *)&(paned->last_child2_focus));
845 paned_get_focus_widget (GtkPaned *paned)
849 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (paned));
850 if (GTK_WIDGET_TOPLEVEL (toplevel))
851 return GTK_WINDOW (toplevel)->focus_widget;
857 gtk_paned_set_focus_child (GtkContainer *container,
858 GtkWidget *focus_child)
862 g_return_if_fail (GTK_IS_PANED (container));
864 paned = GTK_PANED (container);
866 if (focus_child == NULL)
868 GtkWidget *last_focus;
871 last_focus = paned_get_focus_widget (paned);
875 /* If there is one or more paned widgets between us and the
876 * focus widget, we want the topmost of those as last_focus
878 for (w = last_focus; w != GTK_WIDGET (paned); w = w->parent)
879 if (GTK_IS_PANED (w))
882 if (container->focus_child == paned->child1)
883 gtk_paned_set_last_child1_focus (paned, last_focus);
884 else if (container->focus_child == paned->child2)
885 gtk_paned_set_last_child2_focus (paned, last_focus);
889 if (parent_class->set_focus_child)
890 (* parent_class->set_focus_child) (container, focus_child);
894 gtk_paned_get_cycle_chain (GtkPaned *paned,
895 GtkDirectionType direction,
898 GtkContainer *container = GTK_CONTAINER (paned);
899 GtkWidget *ancestor = NULL;
900 GList *temp_list = NULL;
903 if (paned->in_recursion)
906 g_assert (widgets != NULL);
908 if (paned->last_child1_focus &&
909 !gtk_widget_is_ancestor (paned->last_child1_focus, GTK_WIDGET (paned)))
911 gtk_paned_set_last_child1_focus (paned, NULL);
914 if (paned->last_child2_focus &&
915 !gtk_widget_is_ancestor (paned->last_child2_focus, GTK_WIDGET (paned)))
917 gtk_paned_set_last_child2_focus (paned, NULL);
920 if (GTK_WIDGET (paned)->parent)
921 ancestor = gtk_widget_get_ancestor (GTK_WIDGET (paned)->parent, GTK_TYPE_PANED);
923 /* The idea here is that temp_list is a list of widgets we want to cycle
924 * to. The list is prioritized so that the first element is our first
925 * choice, the next our second, and so on.
927 * We can't just use g_list_reverse(), because we want to try
928 * paned->last_child?_focus before paned->child?, both when we
929 * are going forward and backward.
931 if (direction == GTK_DIR_TAB_FORWARD)
933 if (container->focus_child == paned->child1)
935 temp_list = g_list_append (temp_list, paned->last_child2_focus);
936 temp_list = g_list_append (temp_list, paned->child2);
937 temp_list = g_list_append (temp_list, ancestor);
939 else if (container->focus_child == paned->child2)
941 temp_list = g_list_append (temp_list, ancestor);
942 temp_list = g_list_append (temp_list, paned->last_child1_focus);
943 temp_list = g_list_append (temp_list, paned->child1);
947 temp_list = g_list_append (temp_list, paned->last_child1_focus);
948 temp_list = g_list_append (temp_list, paned->child1);
949 temp_list = g_list_append (temp_list, paned->last_child2_focus);
950 temp_list = g_list_append (temp_list, paned->child2);
951 temp_list = g_list_append (temp_list, ancestor);
956 if (container->focus_child == paned->child1)
958 temp_list = g_list_append (temp_list, ancestor);
959 temp_list = g_list_append (temp_list, paned->last_child2_focus);
960 temp_list = g_list_append (temp_list, paned->child2);
962 else if (container->focus_child == paned->child2)
964 temp_list = g_list_append (temp_list, paned->last_child1_focus);
965 temp_list = g_list_append (temp_list, paned->child1);
966 temp_list = g_list_append (temp_list, ancestor);
970 temp_list = g_list_append (temp_list, paned->last_child2_focus);
971 temp_list = g_list_append (temp_list, paned->child2);
972 temp_list = g_list_append (temp_list, paned->last_child1_focus);
973 temp_list = g_list_append (temp_list, paned->child1);
974 temp_list = g_list_append (temp_list, ancestor);
978 /* Walk through the list and expand all the paned widgets. */
979 for (list = temp_list; list != NULL; list = list->next)
981 GtkWidget *widget = list->data;
985 if (GTK_IS_PANED (widget))
987 paned->in_recursion = TRUE;
988 gtk_paned_get_cycle_chain (GTK_PANED (widget), direction, widgets);
989 paned->in_recursion = FALSE;
993 *widgets = g_list_append (*widgets, widget);
998 g_list_free (temp_list);
1002 gtk_paned_cycle_child_focus (GtkPaned *paned,
1005 GList *cycle_chain = NULL;
1008 GtkDirectionType direction = reversed? GTK_DIR_TAB_BACKWARD : GTK_DIR_TAB_FORWARD;
1010 /* ignore f6 if the handle is focused */
1011 if (gtk_widget_is_focus (GTK_WIDGET (paned)))
1014 /* we can't just let the event propagate up the hierarchy,
1015 * because the paned will want to cycle focus _unless_ an
1016 * ancestor paned handles the event
1018 gtk_paned_get_cycle_chain (paned, direction, &cycle_chain);
1020 for (list = cycle_chain; list != NULL; list = list->next)
1021 if (gtk_widget_child_focus (GTK_WIDGET (list->data), direction))
1024 g_list_free (cycle_chain);
1030 get_child_panes (GtkWidget *widget,
1033 if (GTK_IS_PANED (widget))
1035 GtkPaned *paned = GTK_PANED (widget);
1037 get_child_panes (paned->child1, panes);
1038 *panes = g_list_prepend (*panes, widget);
1039 get_child_panes (paned->child2, panes);
1041 else if (GTK_IS_CONTAINER (widget))
1043 gtk_container_foreach (GTK_CONTAINER (widget),
1044 (GtkCallback)get_child_panes, panes);
1049 get_all_panes (GtkPaned *paned)
1051 GtkPaned *topmost = NULL;
1052 GList *result = NULL;
1055 for (w = GTK_WIDGET (paned); w != NULL; w = w->parent)
1057 if (GTK_IS_PANED (w))
1058 topmost = GTK_PANED (w);
1063 get_child_panes (GTK_WIDGET (topmost), &result);
1065 return g_list_reverse (result);
1069 gtk_paned_find_neighbours (GtkPaned *paned,
1073 GList *all_panes = get_all_panes (paned);
1076 g_assert (all_panes);
1078 this_link = g_list_find (all_panes, paned);
1080 g_assert (this_link);
1082 if (this_link->next)
1083 *next = this_link->next->data;
1085 *next = all_panes->data;
1087 if (this_link->prev)
1088 *prev = this_link->prev->data;
1090 *prev = g_list_last (all_panes)->data;
1098 g_list_free (all_panes);
1102 gtk_paned_move_handle (GtkPaned *paned,
1103 GtkScrollType scroll)
1105 if (gtk_widget_is_focus (GTK_WIDGET (paned)))
1111 SINGLE_STEP_SIZE = 1,
1112 PAGE_STEP_SIZE = 75,
1115 old_position = gtk_paned_get_position (paned);
1119 case GTK_SCROLL_STEP_LEFT:
1120 case GTK_SCROLL_STEP_UP:
1121 case GTK_SCROLL_STEP_BACKWARD:
1122 new_position = old_position - SINGLE_STEP_SIZE;
1125 case GTK_SCROLL_STEP_RIGHT:
1126 case GTK_SCROLL_STEP_DOWN:
1127 case GTK_SCROLL_STEP_FORWARD:
1128 new_position = old_position + SINGLE_STEP_SIZE;
1131 case GTK_SCROLL_PAGE_LEFT:
1132 case GTK_SCROLL_PAGE_UP:
1133 case GTK_SCROLL_PAGE_BACKWARD:
1134 new_position = old_position - PAGE_STEP_SIZE;
1137 case GTK_SCROLL_PAGE_RIGHT:
1138 case GTK_SCROLL_PAGE_DOWN:
1139 case GTK_SCROLL_PAGE_FORWARD:
1140 new_position = old_position + PAGE_STEP_SIZE;
1143 case GTK_SCROLL_START:
1144 new_position = paned->min_position;
1147 case GTK_SCROLL_END:
1148 new_position = paned->max_position;
1152 new_position = old_position;
1156 new_position = CLAMP (new_position, paned->min_position, paned->max_position);
1158 if (old_position != new_position)
1159 gtk_paned_set_position (paned, new_position);
1168 gtk_paned_restore_focus (GtkPaned *paned)
1170 if (gtk_widget_is_focus (GTK_WIDGET (paned)))
1172 if (paned->saved_focus && GTK_WIDGET_SENSITIVE (paned->saved_focus))
1174 gtk_widget_grab_focus (paned->saved_focus);
1178 /* the saved focus is somehow not available for focusing,
1180 * 1) tabbing into the paned widget
1181 * if that didn't work,
1182 * 2) unset focus for the window if there is one
1185 if (!gtk_widget_child_focus (GTK_WIDGET (paned), GTK_DIR_TAB_FORWARD))
1187 GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (paned));
1189 if (GTK_IS_WINDOW (toplevel))
1190 gtk_window_set_focus (GTK_WINDOW (toplevel), NULL);
1194 gtk_paned_set_saved_focus (paned, NULL);
1199 gtk_paned_accept_position (GtkPaned *paned)
1201 if (gtk_widget_is_focus (GTK_WIDGET (paned)))
1203 paned->original_position = -1;
1204 gtk_paned_restore_focus (paned);
1214 gtk_paned_cancel_position (GtkPaned *paned)
1216 if (gtk_widget_is_focus (GTK_WIDGET (paned)))
1218 if (paned->original_position != -1)
1220 gtk_paned_set_position (paned, paned->original_position);
1221 paned->original_position = -1;
1224 gtk_paned_restore_focus (paned);
1232 gtk_paned_cycle_handle_focus (GtkPaned *paned,
1235 if (gtk_widget_is_focus (GTK_WIDGET (paned)))
1237 GtkPaned *next, *prev;
1238 GtkPaned *focus = NULL;
1240 gtk_paned_find_neighbours (paned, &next, &prev);
1242 if (reversed && prev)
1244 else if (!reversed && next)
1249 gtk_paned_set_saved_focus (focus, paned->saved_focus);
1250 gtk_paned_set_saved_focus (paned, NULL);
1251 gtk_widget_grab_focus (GTK_WIDGET (focus));
1253 if (!gtk_widget_is_focus (GTK_WIDGET (paned)))
1255 paned->original_position = -1;
1256 focus->original_position = gtk_paned_get_position (focus);
1267 gtk_paned_toggle_handle_focus (GtkPaned *paned)
1269 if (gtk_widget_is_focus (GTK_WIDGET (paned)))
1271 gtk_paned_accept_position (paned);
1275 GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (paned));
1277 if (GTK_IS_WINDOW (toplevel))
1278 gtk_paned_set_saved_focus (paned, GTK_WINDOW (toplevel)->focus_widget);
1280 gtk_widget_grab_focus (GTK_WIDGET (paned));
1281 paned->original_position = gtk_paned_get_position (paned);