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/.
28 #include <string.h> /* memset */
29 #include "gdk/gdkkeysyms.h"
30 #include "gtkaccelmap.h"
31 #include "gtkbindings.h"
35 #include "gtkmenuitem.h"
36 #include "gtksignal.h"
37 #include "gtkwindow.h"
39 #include "gtkvscrollbar.h"
40 #include "gtksettings.h"
44 #define MENU_ITEM_CLASS(w) GTK_MENU_ITEM_GET_CLASS (w)
45 #define MENU_NEEDS_RESIZE(m) GTK_MENU_SHELL (m)->menu_flag
47 #define SUBMENU_NAV_REGION_PADDING 2
48 #define SUBMENU_NAV_HYSTERESIS_TIMEOUT 333
50 #define MENU_SCROLL_STEP 10
51 #define MENU_SCROLL_ARROW_HEIGHT 16
52 #define MENU_SCROLL_FAST_ZONE 4
53 #define MENU_SCROLL_TIMEOUT1 150
54 #define MENU_SCROLL_TIMEOUT2 50
56 typedef struct _GtkMenuAttachData GtkMenuAttachData;
58 struct _GtkMenuAttachData
60 GtkWidget *attach_widget;
61 GtkMenuDetachFunc detacher;
69 static void gtk_menu_class_init (GtkMenuClass *klass);
70 static void gtk_menu_init (GtkMenu *menu);
71 static void gtk_menu_set_property (GObject *object,
75 static void gtk_menu_get_property (GObject *object,
79 static void gtk_menu_destroy (GtkObject *object);
80 static void gtk_menu_finalize (GObject *object);
81 static void gtk_menu_realize (GtkWidget *widget);
82 static void gtk_menu_unrealize (GtkWidget *widget);
83 static void gtk_menu_size_request (GtkWidget *widget,
84 GtkRequisition *requisition);
85 static void gtk_menu_size_allocate (GtkWidget *widget,
86 GtkAllocation *allocation);
87 static void gtk_menu_paint (GtkWidget *widget,
88 GdkEventExpose *expose);
89 static void gtk_menu_show (GtkWidget *widget);
90 static gboolean gtk_menu_expose (GtkWidget *widget,
91 GdkEventExpose *event);
92 static gboolean gtk_menu_key_press (GtkWidget *widget,
94 static gboolean gtk_menu_motion_notify (GtkWidget *widget,
95 GdkEventMotion *event);
96 static gboolean gtk_menu_enter_notify (GtkWidget *widget,
97 GdkEventCrossing *event);
98 static gboolean gtk_menu_leave_notify (GtkWidget *widget,
99 GdkEventCrossing *event);
100 static void gtk_menu_scroll_to (GtkMenu *menu,
102 static void gtk_menu_stop_scrolling (GtkMenu *menu);
103 static gboolean gtk_menu_scroll_timeout (gpointer data);
104 static void gtk_menu_scroll_item_visible (GtkMenuShell *menu_shell,
105 GtkWidget *menu_item);
106 static void gtk_menu_select_item (GtkMenuShell *menu_shell,
107 GtkWidget *menu_item);
108 static void gtk_menu_real_insert (GtkMenuShell *menu_shell,
111 static void gtk_menu_scrollbar_changed (GtkAdjustment *adjustment,
113 static void gtk_menu_handle_scrolling (GtkMenu *menu,
115 static void gtk_menu_set_tearoff_hints (GtkMenu *menu,
118 static void gtk_menu_stop_navigating_submenu (GtkMenu *menu);
119 static gboolean gtk_menu_stop_navigating_submenu_cb (gpointer user_data);
120 static gboolean gtk_menu_navigating_submenu (GtkMenu *menu,
123 static void gtk_menu_set_submenu_navigation_region (GtkMenu *menu,
124 GtkMenuItem *menu_item,
125 GdkEventCrossing *event);
127 static void gtk_menu_deactivate (GtkMenuShell *menu_shell);
128 static void gtk_menu_show_all (GtkWidget *widget);
129 static void gtk_menu_hide_all (GtkWidget *widget);
130 static void gtk_menu_position (GtkMenu *menu);
131 static void gtk_menu_reparent (GtkMenu *menu,
132 GtkWidget *new_parent,
134 static void gtk_menu_remove (GtkContainer *menu,
137 static void gtk_menu_update_title (GtkMenu *menu);
139 static void _gtk_menu_refresh_accel_paths (GtkMenu *menu,
140 gboolean group_changed);
142 static GtkMenuShellClass *parent_class = NULL;
143 static const gchar *attach_data_key = "gtk-menu-attach-data";
146 gtk_menu_get_type (void)
148 static GtkType menu_type = 0;
152 static const GtkTypeInfo menu_info =
156 sizeof (GtkMenuClass),
157 (GtkClassInitFunc) gtk_menu_class_init,
158 (GtkObjectInitFunc) gtk_menu_init,
159 /* reserved_1 */ NULL,
160 /* reserved_2 */ NULL,
161 (GtkClassInitFunc) NULL,
164 menu_type = gtk_type_unique (gtk_menu_shell_get_type (), &menu_info);
171 gtk_menu_class_init (GtkMenuClass *class)
173 GObjectClass *gobject_class = G_OBJECT_CLASS (class);
174 GtkObjectClass *object_class = GTK_OBJECT_CLASS (class);
175 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (class);
176 GtkContainerClass *container_class = GTK_CONTAINER_CLASS (class);
177 GtkMenuShellClass *menu_shell_class = GTK_MENU_SHELL_CLASS (class);
178 GtkBindingSet *binding_set;
180 parent_class = g_type_class_peek_parent (class);
182 gobject_class->finalize = gtk_menu_finalize;
183 gobject_class->set_property = gtk_menu_set_property;
184 gobject_class->get_property = gtk_menu_get_property;
186 g_object_class_install_property (gobject_class,
188 g_param_spec_string ("tearoff-title",
190 _("A title that may be displayed by the window manager when this menu is torn-off."),
192 G_PARAM_READABLE | G_PARAM_WRITABLE));
193 object_class->destroy = gtk_menu_destroy;
195 widget_class->realize = gtk_menu_realize;
196 widget_class->unrealize = gtk_menu_unrealize;
197 widget_class->size_request = gtk_menu_size_request;
198 widget_class->size_allocate = gtk_menu_size_allocate;
199 widget_class->show = gtk_menu_show;
200 widget_class->expose_event = gtk_menu_expose;
201 widget_class->key_press_event = gtk_menu_key_press;
202 widget_class->motion_notify_event = gtk_menu_motion_notify;
203 widget_class->show_all = gtk_menu_show_all;
204 widget_class->hide_all = gtk_menu_hide_all;
205 widget_class->enter_notify_event = gtk_menu_enter_notify;
206 widget_class->leave_notify_event = gtk_menu_leave_notify;
208 container_class->remove = gtk_menu_remove;
210 menu_shell_class->submenu_placement = GTK_LEFT_RIGHT;
211 menu_shell_class->deactivate = gtk_menu_deactivate;
212 menu_shell_class->select_item = gtk_menu_select_item;
213 menu_shell_class->insert = gtk_menu_real_insert;
215 binding_set = gtk_binding_set_by_class (class);
216 gtk_binding_entry_add_signal (binding_set,
219 GTK_TYPE_MENU_DIRECTION_TYPE,
221 gtk_binding_entry_add_signal (binding_set,
224 GTK_TYPE_MENU_DIRECTION_TYPE,
226 gtk_binding_entry_add_signal (binding_set,
229 GTK_TYPE_MENU_DIRECTION_TYPE,
231 gtk_binding_entry_add_signal (binding_set,
234 GTK_TYPE_MENU_DIRECTION_TYPE,
236 gtk_binding_entry_add_signal (binding_set,
239 GTK_TYPE_MENU_DIRECTION_TYPE,
240 GTK_MENU_DIR_PARENT);
241 gtk_binding_entry_add_signal (binding_set,
244 GTK_TYPE_MENU_DIRECTION_TYPE,
245 GTK_MENU_DIR_PARENT);
246 gtk_binding_entry_add_signal (binding_set,
249 GTK_TYPE_MENU_DIRECTION_TYPE,
251 gtk_binding_entry_add_signal (binding_set,
254 GTK_TYPE_MENU_DIRECTION_TYPE,
260 gtk_menu_set_property (GObject *object,
267 menu = GTK_MENU (object);
271 case PROP_TEAROFF_TITLE:
272 gtk_menu_set_title (menu, g_value_get_string (value));
275 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
281 gtk_menu_get_property (GObject *object,
288 menu = GTK_MENU (object);
292 case PROP_TEAROFF_TITLE:
293 g_value_set_string (value, gtk_menu_get_title (menu));
296 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
302 gtk_menu_window_event (GtkWidget *window,
306 gboolean handled = FALSE;
308 gtk_widget_ref (window);
309 gtk_widget_ref (menu);
314 case GDK_KEY_RELEASE:
315 handled = gtk_widget_event (menu, event);
321 gtk_widget_unref (window);
322 gtk_widget_unref (menu);
328 gtk_menu_init (GtkMenu *menu)
330 menu->parent_menu_item = NULL;
331 menu->old_active_menu_item = NULL;
332 menu->accel_group = NULL;
333 menu->position_func = NULL;
334 menu->position_func_data = NULL;
335 menu->toggle_size = 0;
337 menu->toplevel = g_object_connect (gtk_widget_new (GTK_TYPE_WINDOW,
338 "type", GTK_WINDOW_POPUP,
341 "signal::event", gtk_menu_window_event, menu,
342 "signal::destroy", gtk_widget_destroyed, &menu->toplevel,
344 gtk_window_set_policy (GTK_WINDOW (menu->toplevel),
346 gtk_window_set_mnemonic_modifier (GTK_WINDOW (menu->toplevel), 0);
348 /* Refloat the menu, so that reference counting for the menu isn't
349 * affected by it being a child of the toplevel
351 GTK_WIDGET_SET_FLAGS (menu, GTK_FLOATING);
352 menu->needs_destruction_ref_count = TRUE;
354 menu->view_window = NULL;
355 menu->bin_window = NULL;
357 menu->scroll_offset = 0;
358 menu->scroll_step = 0;
359 menu->timeout_id = 0;
360 menu->scroll_fast = FALSE;
362 menu->tearoff_window = NULL;
363 menu->tearoff_hbox = NULL;
364 menu->torn_off = FALSE;
365 menu->tearoff_active = FALSE;
366 menu->tearoff_adjustment = NULL;
367 menu->tearoff_scrollbar = NULL;
369 menu->upper_arrow_visible = FALSE;
370 menu->lower_arrow_visible = FALSE;
371 menu->upper_arrow_prelight = FALSE;
372 menu->lower_arrow_prelight = FALSE;
374 MENU_NEEDS_RESIZE (menu) = TRUE;
378 gtk_menu_destroy (GtkObject *object)
381 GtkMenuAttachData *data;
383 g_return_if_fail (GTK_IS_MENU (object));
385 menu = GTK_MENU (object);
387 gtk_menu_stop_scrolling (menu);
389 data = gtk_object_get_data (object, attach_data_key);
391 gtk_menu_detach (menu);
393 gtk_menu_stop_navigating_submenu (menu);
395 if (menu->old_active_menu_item)
397 gtk_widget_unref (menu->old_active_menu_item);
398 menu->old_active_menu_item = NULL;
401 /* Add back the reference count for being a child */
402 if (menu->needs_destruction_ref_count)
404 menu->needs_destruction_ref_count = FALSE;
405 gtk_object_ref (object);
408 if (menu->accel_group)
410 g_object_unref (menu->accel_group);
411 menu->accel_group = NULL;
415 gtk_widget_destroy (menu->toplevel);
416 if (menu->tearoff_window)
417 gtk_widget_destroy (menu->tearoff_window);
419 GTK_OBJECT_CLASS (parent_class)->destroy (object);
423 gtk_menu_finalize (GObject *object)
425 GtkMenu *menu = GTK_MENU (object);
427 g_free (menu->accel_path);
429 G_OBJECT_CLASS (parent_class)->finalize (object);
433 gtk_menu_attach_to_widget (GtkMenu *menu,
434 GtkWidget *attach_widget,
435 GtkMenuDetachFunc detacher)
437 GtkMenuAttachData *data;
439 g_return_if_fail (GTK_IS_MENU (menu));
440 g_return_if_fail (GTK_IS_WIDGET (attach_widget));
441 g_return_if_fail (detacher != NULL);
443 /* keep this function in sync with gtk_widget_set_parent()
446 data = gtk_object_get_data (GTK_OBJECT (menu), attach_data_key);
449 g_warning ("gtk_menu_attach_to_widget(): menu already attached to %s",
450 gtk_type_name (GTK_OBJECT_TYPE (data->attach_widget)));
454 gtk_object_ref (GTK_OBJECT (menu));
455 gtk_object_sink (GTK_OBJECT (menu));
457 data = g_new (GtkMenuAttachData, 1);
458 data->attach_widget = attach_widget;
459 data->detacher = detacher;
460 gtk_object_set_data (GTK_OBJECT (menu), attach_data_key, data);
462 if (GTK_WIDGET_STATE (menu) != GTK_STATE_NORMAL)
463 gtk_widget_set_state (GTK_WIDGET (menu), GTK_STATE_NORMAL);
465 /* we don't need to set the style here, since
466 * we are a toplevel widget.
469 /* Fallback title for menu comes from attach widget */
470 gtk_menu_update_title (menu);
474 gtk_menu_get_attach_widget (GtkMenu *menu)
476 GtkMenuAttachData *data;
478 g_return_val_if_fail (GTK_IS_MENU (menu), NULL);
480 data = gtk_object_get_data (GTK_OBJECT (menu), attach_data_key);
482 return data->attach_widget;
487 gtk_menu_detach (GtkMenu *menu)
489 GtkMenuAttachData *data;
491 g_return_if_fail (GTK_IS_MENU (menu));
493 /* keep this function in sync with gtk_widget_unparent()
495 data = gtk_object_get_data (GTK_OBJECT (menu), attach_data_key);
498 g_warning ("gtk_menu_detach(): menu is not attached");
501 gtk_object_remove_data (GTK_OBJECT (menu), attach_data_key);
503 data->detacher (data->attach_widget, menu);
505 if (GTK_WIDGET_REALIZED (menu))
506 gtk_widget_unrealize (GTK_WIDGET (menu));
510 /* Fallback title for menu comes from attach widget */
511 gtk_menu_update_title (menu);
513 gtk_widget_unref (GTK_WIDGET (menu));
517 gtk_menu_remove (GtkContainer *container,
521 g_return_if_fail (GTK_IS_MENU (container));
522 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
524 menu = GTK_MENU (container);
526 /* Clear out old_active_menu_item if it matches the item we are removing
528 if (menu->old_active_menu_item == widget)
530 gtk_widget_unref (menu->old_active_menu_item);
531 menu->old_active_menu_item = NULL;
534 GTK_CONTAINER_CLASS (parent_class)->remove (container, widget);
541 return GTK_WIDGET (gtk_type_new (gtk_menu_get_type ()));
545 gtk_menu_real_insert (GtkMenuShell *menu_shell,
549 if (GTK_WIDGET_REALIZED (menu_shell))
550 gtk_widget_set_parent_window (child, GTK_MENU (menu_shell)->bin_window);
552 GTK_MENU_SHELL_CLASS (parent_class)->insert (menu_shell, child, position);
556 gtk_menu_tearoff_bg_copy (GtkMenu *menu)
561 widget = GTK_WIDGET (menu);
567 GdkGCValues gc_values;
569 menu->tearoff_active = FALSE;
570 menu->saved_scroll_offset = menu->scroll_offset;
572 gc_values.subwindow_mode = GDK_INCLUDE_INFERIORS;
573 gc = gdk_gc_new_with_values (widget->window,
574 &gc_values, GDK_GC_SUBWINDOW);
576 gdk_window_get_size (menu->tearoff_window->window, &width, &height);
578 pixmap = gdk_pixmap_new (menu->tearoff_window->window,
583 gdk_draw_pixmap (pixmap, gc,
584 menu->tearoff_window->window,
588 gtk_widget_set_usize (menu->tearoff_window,
592 gdk_window_set_back_pixmap (menu->tearoff_window->window, pixmap, FALSE);
593 gdk_pixmap_unref (pixmap);
598 gtk_menu_popup (GtkMenu *menu,
599 GtkWidget *parent_menu_shell,
600 GtkWidget *parent_menu_item,
601 GtkMenuPositionFunc func,
604 guint32 activate_time)
607 GtkWidget *xgrab_shell;
609 GdkEvent *current_event;
610 GtkMenuShell *menu_shell;
612 g_return_if_fail (GTK_IS_MENU (menu));
614 widget = GTK_WIDGET (menu);
615 menu_shell = GTK_MENU_SHELL (menu);
617 menu_shell->parent_menu_shell = parent_menu_shell;
618 menu_shell->active = TRUE;
619 menu_shell->button = button;
621 /* If we are popping up the menu from something other than, a button
622 * press then, as a heuristic, we ignore enter events for the menu
623 * until we get a MOTION_NOTIFY.
626 current_event = gtk_get_current_event ();
629 if ((current_event->type != GDK_BUTTON_PRESS) &&
630 (current_event->type != GDK_ENTER_NOTIFY))
631 menu_shell->ignore_enter = TRUE;
636 gtk_menu_tearoff_bg_copy (menu);
638 gtk_menu_reparent (menu, menu->toplevel, FALSE);
641 menu->parent_menu_item = parent_menu_item;
642 menu->position_func = func;
643 menu->position_func_data = data;
644 menu_shell->activate_time = activate_time;
646 gtk_menu_position (menu);
648 /* We need to show the menu _here_ because code expects to be
649 * able to tell if the menu is onscreen by looking at the
650 * GTK_WIDGET_VISIBLE (menu)
652 gtk_widget_show (GTK_WIDGET (menu));
653 gtk_widget_show (menu->toplevel);
657 /* Also, if we're popping up from a key event, select the first
658 * item in the menu. Bad hack, but no better way to do it
659 * in current menu framework.
661 if (current_event->type == GDK_KEY_PRESS &&
662 GTK_MENU_SHELL (menu)->children)
664 gtk_menu_shell_select_item (GTK_MENU_SHELL (menu),
665 GTK_MENU_SHELL (menu)->children->data);
668 gdk_event_free (current_event);
671 gtk_menu_scroll_to (menu, menu->scroll_offset);
673 /* Find the last viewable ancestor, and make an X grab on it
675 parent = GTK_WIDGET (menu);
679 gboolean viewable = TRUE;
680 GtkWidget *tmp = parent;
684 if (!GTK_WIDGET_MAPPED (tmp))
693 xgrab_shell = parent;
695 parent = GTK_MENU_SHELL (parent)->parent_menu_shell;
698 if (xgrab_shell && (!GTK_MENU_SHELL (xgrab_shell)->have_xgrab))
700 if ((gdk_pointer_grab (xgrab_shell->window, TRUE,
701 GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK |
702 GDK_ENTER_NOTIFY_MASK | GDK_LEAVE_NOTIFY_MASK |
703 GDK_POINTER_MOTION_MASK,
704 NULL, NULL, activate_time) == 0))
706 if (gdk_keyboard_grab (xgrab_shell->window, TRUE,
708 GTK_MENU_SHELL (xgrab_shell)->have_xgrab = TRUE;
710 gdk_pointer_ungrab (activate_time);
714 gtk_grab_add (GTK_WIDGET (menu));
718 gtk_menu_popdown (GtkMenu *menu)
720 GtkMenuShell *menu_shell;
722 g_return_if_fail (GTK_IS_MENU (menu));
724 menu_shell = GTK_MENU_SHELL (menu);
726 menu_shell->parent_menu_shell = NULL;
727 menu_shell->active = FALSE;
728 menu_shell->ignore_enter = FALSE;
730 gtk_menu_stop_scrolling (menu);
732 gtk_menu_stop_navigating_submenu (menu);
734 if (menu_shell->active_menu_item)
736 if (menu->old_active_menu_item)
737 gtk_widget_unref (menu->old_active_menu_item);
738 menu->old_active_menu_item = menu_shell->active_menu_item;
739 gtk_widget_ref (menu->old_active_menu_item);
742 gtk_menu_shell_deselect (menu_shell);
744 /* The X Grab, if present, will automatically be removed when we hide
746 gtk_widget_hide (menu->toplevel);
751 gdk_window_get_size (menu->tearoff_window->window, &width, &height);
752 gtk_widget_set_usize (menu->tearoff_window,
756 if (GTK_BIN (menu->toplevel)->child)
758 gtk_menu_reparent (menu, menu->tearoff_hbox, TRUE);
762 /* We popped up the menu from the tearoff, so we need to
763 * release the grab - we aren't actually hiding the menu.
765 if (menu_shell->have_xgrab)
767 gdk_pointer_ungrab (GDK_CURRENT_TIME);
768 gdk_keyboard_ungrab (GDK_CURRENT_TIME);
772 /* gtk_menu_popdown is called each time a menu item is selected from
773 * a torn off menu. Only scroll back to the saved position if the
774 * non-tearoff menu was popped down.
776 if (!menu->tearoff_active)
777 gtk_menu_scroll_to (menu, menu->saved_scroll_offset);
778 menu->tearoff_active = TRUE;
781 gtk_widget_hide (GTK_WIDGET (menu));
783 menu_shell->have_xgrab = FALSE;
784 gtk_grab_remove (GTK_WIDGET (menu));
788 gtk_menu_get_active (GtkMenu *menu)
793 g_return_val_if_fail (GTK_IS_MENU (menu), NULL);
795 if (!menu->old_active_menu_item)
798 children = GTK_MENU_SHELL (menu)->children;
802 child = children->data;
803 children = children->next;
805 if (GTK_BIN (child)->child)
810 menu->old_active_menu_item = child;
811 if (menu->old_active_menu_item)
812 gtk_widget_ref (menu->old_active_menu_item);
815 return menu->old_active_menu_item;
819 gtk_menu_set_active (GtkMenu *menu,
825 g_return_if_fail (GTK_IS_MENU (menu));
827 tmp_list = g_list_nth (GTK_MENU_SHELL (menu)->children, index);
830 child = tmp_list->data;
831 if (GTK_BIN (child)->child)
833 if (menu->old_active_menu_item)
834 gtk_widget_unref (menu->old_active_menu_item);
835 menu->old_active_menu_item = child;
836 gtk_widget_ref (menu->old_active_menu_item);
842 gtk_menu_set_accel_group (GtkMenu *menu,
843 GtkAccelGroup *accel_group)
845 g_return_if_fail (GTK_IS_MENU (menu));
847 if (menu->accel_group != accel_group)
849 if (menu->accel_group)
850 gtk_accel_group_unref (menu->accel_group);
851 menu->accel_group = accel_group;
852 if (menu->accel_group)
853 gtk_accel_group_ref (menu->accel_group);
854 _gtk_menu_refresh_accel_paths (menu, TRUE);
859 gtk_menu_get_accel_group (GtkMenu *menu)
861 g_return_val_if_fail (GTK_IS_MENU (menu), NULL);
863 return menu->accel_group;
867 * gtk_menu_set_accel_path
868 * @menu: a valid #GtkMenu
869 * @accel_path: a valid accelerator path
871 * Sets an accelerator path for this menu from which accelerator paths
872 * for its immediate children, its menu items, can be constructed.
873 * The main purpose of this function is to spare the programmer the
874 * inconvenience of having to call gtk_menu_item_set_accel_path() on
875 * each menu item that should support runtime user changable accelerators.
876 * Instead, by just calling gtk_menu_set_accel_path() on their parent,
877 * each menu item of this menu, that contains a label describing its purpose,
878 * automatically gets an accel path assigned. For example, a menu containing
879 * menu items "New" and "Exit", will, after
880 * <literal>gtk_menu_set_accel_path (menu, "<Gnumeric-Sheet>/File");</literal>
881 * has been called, assign its items the accel paths:
882 * <literal>"<Gnumeric-Sheet>/File/New"</literal> and <literal>"<Gnumeric-Sheet>/File/Exit"</literal>.
883 * Assigning accel paths to menu items then enables the user to change
884 * their accelerators at runtime. More details about accelerator paths
885 * and their default setups can be found at gtk_accel_map_add_entry().
888 gtk_menu_set_accel_path (GtkMenu *menu,
889 const gchar *accel_path)
891 g_return_if_fail (GTK_IS_MENU (menu));
893 g_return_if_fail (accel_path[0] == '<' && strchr (accel_path, '/')); /* simplistic check */
895 g_free (menu->accel_path);
896 menu->accel_path = g_strdup (accel_path);
897 if (menu->accel_path)
898 _gtk_menu_refresh_accel_paths (menu, FALSE);
903 gboolean group_changed;
907 refresh_accel_paths_foreach (GtkWidget *widget,
910 AccelPropagation *prop = data;
912 if (GTK_IS_MENU_ITEM (widget)) /* should always be true */
913 _gtk_menu_item_refresh_accel_path (GTK_MENU_ITEM (widget),
914 prop->menu->accel_path,
915 prop->menu->accel_group,
916 prop->group_changed);
920 _gtk_menu_refresh_accel_paths (GtkMenu *menu,
921 gboolean group_changed)
923 g_return_if_fail (GTK_IS_MENU (menu));
925 if (menu->accel_path && menu->accel_group)
927 AccelPropagation prop;
930 prop.group_changed = group_changed;
931 gtk_container_foreach (GTK_CONTAINER (menu),
932 refresh_accel_paths_foreach,
938 gtk_menu_reposition (GtkMenu *menu)
940 g_return_if_fail (GTK_IS_MENU (menu));
942 if (GTK_WIDGET_DRAWABLE (menu) && !menu->torn_off)
943 gtk_menu_position (menu);
947 gtk_menu_scrollbar_changed (GtkAdjustment *adjustment,
950 g_return_if_fail (GTK_IS_MENU (menu));
952 if (adjustment->value != menu->scroll_offset)
953 gtk_menu_scroll_to (menu, adjustment->value);
957 gtk_menu_set_tearoff_hints (GtkMenu *menu,
960 GdkGeometry geometry_hints;
962 if (!menu->tearoff_window)
965 if (GTK_WIDGET_VISIBLE (menu->tearoff_scrollbar))
967 gtk_widget_size_request (menu->tearoff_scrollbar, NULL);
968 width += menu->tearoff_scrollbar->requisition.width;
971 geometry_hints.min_width = width;
972 geometry_hints.max_width = width;
974 geometry_hints.min_height = 0;
975 geometry_hints.max_height = GTK_WIDGET (menu)->requisition.height;
976 gtk_window_set_geometry_hints (GTK_WINDOW (menu->tearoff_window),
979 GDK_HINT_MAX_SIZE|GDK_HINT_MIN_SIZE);
983 gtk_menu_update_title (GtkMenu *menu)
985 if (menu->tearoff_window)
988 GtkWidget *attach_widget;
990 title = gtk_menu_get_title (menu);
993 attach_widget = gtk_menu_get_attach_widget (menu);
994 if (GTK_IS_MENU_ITEM (attach_widget))
996 GtkWidget *child = GTK_BIN (attach_widget)->child;
997 if (GTK_IS_LABEL (child))
998 title = gtk_label_get_text (GTK_LABEL (child));
1003 gtk_window_set_title (GTK_WINDOW (menu->tearoff_window), title);
1008 gtk_menu_set_tearoff_state (GtkMenu *menu,
1013 g_return_if_fail (GTK_IS_MENU (menu));
1015 if (menu->torn_off != torn_off)
1017 menu->torn_off = torn_off;
1018 menu->tearoff_active = torn_off;
1022 if (GTK_WIDGET_VISIBLE (menu))
1023 gtk_menu_popdown (menu);
1025 if (!menu->tearoff_window)
1027 menu->tearoff_window = g_object_connect (gtk_widget_new (GTK_TYPE_WINDOW,
1028 "type", GTK_WINDOW_TOPLEVEL,
1030 "signal::destroy", gtk_widget_destroyed, &menu->tearoff_window,
1032 gtk_window_set_type_hint (GTK_WINDOW (menu->tearoff_window),
1033 GDK_WINDOW_TYPE_HINT_MENU);
1034 gtk_window_set_mnemonic_modifier (GTK_WINDOW (menu->tearoff_window), 0);
1035 gtk_widget_set_app_paintable (menu->tearoff_window, TRUE);
1036 gtk_signal_connect (GTK_OBJECT (menu->tearoff_window),
1038 GTK_SIGNAL_FUNC (gtk_menu_window_event),
1041 gtk_menu_update_title (menu);
1043 gtk_widget_realize (menu->tearoff_window);
1045 gdk_window_set_decorations (menu->tearoff_window->window,
1048 GDK_DECOR_MINIMIZE |
1049 GDK_DECOR_MAXIMIZE);
1050 gtk_window_set_resizable (GTK_WINDOW (menu->tearoff_window), FALSE);
1052 menu->tearoff_hbox = gtk_hbox_new (FALSE, FALSE);
1053 gtk_container_add (GTK_CONTAINER (menu->tearoff_window), menu->tearoff_hbox);
1055 gdk_window_get_size (GTK_WIDGET (menu)->window, &width, &height);
1056 menu->tearoff_adjustment =
1057 GTK_ADJUSTMENT (gtk_adjustment_new (0,
1059 GTK_WIDGET (menu)->requisition.height,
1063 g_object_connect (GTK_OBJECT (menu->tearoff_adjustment),
1064 "signal::value_changed", gtk_menu_scrollbar_changed, menu,
1066 menu->tearoff_scrollbar = gtk_vscrollbar_new (menu->tearoff_adjustment);
1068 gtk_box_pack_end (GTK_BOX (menu->tearoff_hbox),
1069 menu->tearoff_scrollbar,
1072 if (menu->tearoff_adjustment->upper > height)
1073 gtk_widget_show (menu->tearoff_scrollbar);
1075 gtk_widget_show (menu->tearoff_hbox);
1078 gtk_menu_reparent (menu, menu->tearoff_hbox, FALSE);
1080 gdk_window_get_size (GTK_WIDGET (menu)->window, &width, NULL);
1082 /* Update menu->requisition
1084 gtk_widget_size_request (GTK_WIDGET (menu), NULL);
1086 gtk_menu_set_tearoff_hints (menu, width);
1088 gtk_widget_realize (menu->tearoff_window);
1089 gtk_menu_position (menu);
1091 gtk_widget_show (GTK_WIDGET (menu));
1092 gtk_widget_show (menu->tearoff_window);
1094 gtk_menu_scroll_to (menu, 0);
1099 gtk_widget_hide (menu->tearoff_window);
1100 gtk_menu_reparent (menu, menu->toplevel, FALSE);
1106 * gtk_menu_get_tearoff_state:
1109 * Returns whether the menu is torn off. See
1110 * gtk_menu_set_tearoff_state ().
1112 * Return value: %TRUE if the menu is currently torn off.
1115 gtk_menu_get_tearoff_state (GtkMenu *menu)
1117 g_return_val_if_fail (GTK_IS_MENU (menu), FALSE);
1119 return menu->torn_off;
1123 * gtk_menu_set_title:
1125 * @title: a string containing the title for the menu.
1127 * Sets the title string for the menu. The title is displayed when the menu
1128 * is shown as a tearoff menu.
1131 gtk_menu_set_title (GtkMenu *menu,
1134 g_return_if_fail (GTK_IS_MENU (menu));
1137 g_object_set_data_full (G_OBJECT (menu), "gtk-menu-title",
1138 g_strdup (title), (GtkDestroyNotify) g_free);
1140 g_object_set_data (G_OBJECT (menu), "gtk-menu-title", NULL);
1142 gtk_menu_update_title (menu);
1143 g_object_notify (G_OBJECT (menu), "tearoff_title");
1147 * gtk_menu_get_title:
1150 * Returns the title of the menu. See gtk_menu_set_title().
1152 * Return value: the title of the menu, or %NULL if the menu has no
1155 G_CONST_RETURN gchar *
1156 gtk_menu_get_title (GtkMenu *menu)
1158 g_return_val_if_fail (GTK_IS_MENU (menu), NULL);
1160 return gtk_object_get_data (GTK_OBJECT (menu), "gtk-menu-title");
1164 gtk_menu_reorder_child (GtkMenu *menu,
1168 GtkMenuShell *menu_shell;
1169 g_return_if_fail (GTK_IS_MENU (menu));
1170 g_return_if_fail (GTK_IS_MENU_ITEM (child));
1171 menu_shell = GTK_MENU_SHELL (menu);
1172 if (g_list_find (menu_shell->children, child))
1174 menu_shell->children = g_list_remove (menu_shell->children, child);
1175 menu_shell->children = g_list_insert (menu_shell->children, child, position);
1176 if (GTK_WIDGET_VISIBLE (menu_shell))
1177 gtk_widget_queue_resize (GTK_WIDGET (menu_shell));
1182 gtk_menu_realize (GtkWidget *widget)
1184 GdkWindowAttr attributes;
1185 gint attributes_mask;
1191 g_return_if_fail (GTK_IS_MENU (widget));
1193 menu = GTK_MENU (widget);
1195 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
1197 attributes.window_type = GDK_WINDOW_CHILD;
1198 attributes.x = widget->allocation.x;
1199 attributes.y = widget->allocation.y;
1200 attributes.width = widget->allocation.width;
1201 attributes.height = widget->allocation.height;
1202 attributes.wclass = GDK_INPUT_OUTPUT;
1203 attributes.visual = gtk_widget_get_visual (widget);
1204 attributes.colormap = gtk_widget_get_colormap (widget);
1206 attributes.event_mask = gtk_widget_get_events (widget);
1207 attributes.event_mask |= (GDK_EXPOSURE_MASK | GDK_KEY_PRESS_MASK |
1208 GDK_ENTER_NOTIFY_MASK | GDK_LEAVE_NOTIFY_MASK );
1210 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
1211 widget->window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, attributes_mask);
1212 gdk_window_set_user_data (widget->window, widget);
1214 border_width = GTK_CONTAINER (widget)->border_width;
1216 attributes.x = border_width + widget->style->xthickness;
1217 attributes.y = border_width + widget->style->ythickness;
1218 attributes.width = MAX (1, widget->allocation.width - attributes.x * 2);
1219 attributes.height = MAX (1, widget->allocation.height - attributes.y * 2);
1221 if (menu->upper_arrow_visible)
1223 attributes.y += MENU_SCROLL_ARROW_HEIGHT;
1224 attributes.height -= MENU_SCROLL_ARROW_HEIGHT;
1226 if (menu->lower_arrow_visible)
1227 attributes.height -= MENU_SCROLL_ARROW_HEIGHT;
1229 menu->view_window = gdk_window_new (widget->window, &attributes, attributes_mask);
1230 gdk_window_set_user_data (menu->view_window, menu);
1234 attributes.height = MAX (1, widget->requisition.height - (border_width + widget->style->ythickness) * 2);
1236 menu->bin_window = gdk_window_new (menu->view_window, &attributes, attributes_mask);
1237 gdk_window_set_user_data (menu->bin_window, menu);
1239 children = GTK_MENU_SHELL (menu)->children;
1242 child = children->data;
1243 children = children->next;
1245 gtk_widget_set_parent_window (child, menu->bin_window);
1248 widget->style = gtk_style_attach (widget->style, widget->window);
1249 gtk_style_set_background (widget->style, menu->bin_window, GTK_STATE_NORMAL);
1250 gtk_style_set_background (widget->style, menu->view_window, GTK_STATE_NORMAL);
1251 gtk_style_set_background (widget->style, widget->window, GTK_STATE_NORMAL);
1253 gtk_menu_scroll_item_visible (GTK_MENU_SHELL (widget),
1254 GTK_MENU_SHELL (widget)->active_menu_item);
1256 gdk_window_show (menu->bin_window);
1257 gdk_window_show (menu->view_window);
1261 gtk_menu_unrealize (GtkWidget *widget)
1265 g_return_if_fail (GTK_IS_MENU (widget));
1267 menu = GTK_MENU (widget);
1269 gdk_window_set_user_data (menu->view_window, NULL);
1270 gdk_window_destroy (menu->view_window);
1271 menu->view_window = NULL;
1273 gdk_window_set_user_data (menu->bin_window, NULL);
1274 gdk_window_destroy (menu->bin_window);
1275 menu->bin_window = NULL;
1277 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
1281 gtk_menu_size_request (GtkWidget *widget,
1282 GtkRequisition *requisition)
1285 GtkMenuShell *menu_shell;
1288 guint max_toggle_size;
1289 guint max_accel_width;
1290 GtkRequisition child_requisition;
1292 g_return_if_fail (GTK_IS_MENU (widget));
1293 g_return_if_fail (requisition != NULL);
1295 menu = GTK_MENU (widget);
1296 menu_shell = GTK_MENU_SHELL (widget);
1298 requisition->width = 0;
1299 requisition->height = 0;
1301 max_toggle_size = 0;
1302 max_accel_width = 0;
1304 children = menu_shell->children;
1307 child = children->data;
1308 children = children->next;
1310 if (GTK_WIDGET_VISIBLE (child))
1314 /* It's important to size_request the child
1315 * before doing the toggle size request, in
1316 * case the toggle size request depends on the size
1317 * request of a child of the child (e.g. for ImageMenuItem)
1320 GTK_MENU_ITEM (child)->show_submenu_indicator = TRUE;
1321 gtk_widget_size_request (child, &child_requisition);
1323 requisition->width = MAX (requisition->width, child_requisition.width);
1324 requisition->height += child_requisition.height;
1326 gtk_menu_item_toggle_size_request (GTK_MENU_ITEM (child), &toggle_size);
1327 max_toggle_size = MAX (max_toggle_size, toggle_size);
1328 max_accel_width = MAX (max_accel_width, GTK_MENU_ITEM (child)->accelerator_width);
1332 requisition->width += max_toggle_size + max_accel_width;
1333 requisition->width += (GTK_CONTAINER (menu)->border_width +
1334 widget->style->xthickness) * 2;
1335 requisition->height += (GTK_CONTAINER (menu)->border_width +
1336 widget->style->ythickness) * 2;
1338 menu->toggle_size = max_toggle_size;
1340 /* If the requested width was different than the allocated width, we need to change
1341 * the geometry hints for the tear off window so that the window can actually be resized.
1342 * Don't resize the tearoff if it is not active, because it won't redraw (it is only a background pixmap).
1344 if ((requisition->width != GTK_WIDGET (menu)->allocation.width) && menu->tearoff_active)
1345 gtk_menu_set_tearoff_hints (menu, requisition->width);
1349 gtk_menu_size_allocate (GtkWidget *widget,
1350 GtkAllocation *allocation)
1353 GtkMenuShell *menu_shell;
1355 GtkAllocation child_allocation;
1360 g_return_if_fail (GTK_IS_MENU (widget));
1361 g_return_if_fail (allocation != NULL);
1363 menu = GTK_MENU (widget);
1364 menu_shell = GTK_MENU_SHELL (widget);
1366 widget->allocation = *allocation;
1368 x = GTK_CONTAINER (menu)->border_width + widget->style->xthickness;
1369 y = GTK_CONTAINER (menu)->border_width + widget->style->ythickness;
1371 width = MAX (1, allocation->width - x * 2);
1372 height = MAX (1, allocation->height - y * 2);
1374 if (menu->upper_arrow_visible && !menu->tearoff_active)
1376 y += MENU_SCROLL_ARROW_HEIGHT;
1377 height -= MENU_SCROLL_ARROW_HEIGHT;
1380 if (menu->lower_arrow_visible && !menu->tearoff_active)
1381 height -= MENU_SCROLL_ARROW_HEIGHT;
1383 if (GTK_WIDGET_REALIZED (widget))
1385 gdk_window_move_resize (widget->window,
1386 allocation->x, allocation->y,
1387 allocation->width, allocation->height);
1389 gdk_window_move_resize (menu->view_window,
1396 if (menu_shell->children)
1398 child_allocation.x = 0;
1399 child_allocation.y = 0;
1400 child_allocation.width = width;
1402 children = menu_shell->children;
1405 child = children->data;
1406 children = children->next;
1408 if (GTK_WIDGET_VISIBLE (child))
1410 GtkRequisition child_requisition;
1411 gtk_widget_get_child_requisition (child, &child_requisition);
1413 child_allocation.height = child_requisition.height;
1415 gtk_menu_item_toggle_size_allocate (GTK_MENU_ITEM (child),
1417 gtk_widget_size_allocate (child, &child_allocation);
1418 gtk_widget_queue_draw (child);
1420 child_allocation.y += child_allocation.height;
1424 /* Resize the item window */
1425 if (GTK_WIDGET_REALIZED (widget))
1427 gdk_window_resize (menu->bin_window,
1428 child_allocation.width,
1429 child_allocation.y);
1433 if (menu->tearoff_active)
1435 if (allocation->height >= widget->requisition.height)
1437 if (GTK_WIDGET_VISIBLE (menu->tearoff_scrollbar))
1439 gtk_widget_hide (menu->tearoff_scrollbar);
1440 gtk_menu_set_tearoff_hints (menu, allocation->width);
1441 gtk_widget_set_usize (menu->tearoff_window, -1, allocation->height);
1443 gtk_menu_scroll_to (menu, 0);
1448 menu->tearoff_adjustment->upper = widget->requisition.height;
1449 menu->tearoff_adjustment->page_size = allocation->height;
1451 if (menu->tearoff_adjustment->value + menu->tearoff_adjustment->page_size >
1452 menu->tearoff_adjustment->upper)
1455 value = menu->tearoff_adjustment->upper - menu->tearoff_adjustment->page_size;
1458 gtk_menu_scroll_to (menu, value);
1461 gtk_adjustment_changed (menu->tearoff_adjustment);
1463 if (!GTK_WIDGET_VISIBLE (menu->tearoff_scrollbar))
1465 gtk_widget_show (menu->tearoff_scrollbar);
1466 gtk_menu_set_tearoff_hints (menu, allocation->width);
1467 gtk_widget_set_usize (menu->tearoff_window, -1, allocation->height);
1475 gtk_menu_paint (GtkWidget *widget,
1476 GdkEventExpose *event)
1480 gint border_x, border_y;
1482 g_return_if_fail (GTK_IS_MENU (widget));
1484 menu = GTK_MENU (widget);
1486 border_x = GTK_CONTAINER (widget)->border_width + widget->style->xthickness;
1487 border_y = GTK_CONTAINER (widget)->border_width + widget->style->ythickness;
1488 gdk_window_get_size (widget->window, &width, &height);
1490 if (event->window == widget->window)
1492 gtk_paint_box (widget->style,
1496 NULL, widget, "menu",
1498 if (menu->upper_arrow_visible && !menu->tearoff_active)
1500 gtk_paint_box (widget->style,
1502 menu->upper_arrow_prelight ?
1503 GTK_STATE_PRELIGHT : GTK_STATE_NORMAL,
1505 NULL, widget, "menu",
1509 MENU_SCROLL_ARROW_HEIGHT);
1511 gtk_paint_arrow (widget->style,
1513 menu->upper_arrow_prelight ?
1514 GTK_STATE_PRELIGHT : GTK_STATE_NORMAL,
1516 NULL, widget, "menu",
1519 width / 2 - MENU_SCROLL_ARROW_HEIGHT / 2 + 1,
1521 MENU_SCROLL_ARROW_HEIGHT - 2 * border_y - 2,
1522 MENU_SCROLL_ARROW_HEIGHT - 2 * border_y - 2);
1525 if (menu->lower_arrow_visible && !menu->tearoff_active)
1527 gtk_paint_box (widget->style,
1529 menu->lower_arrow_prelight ?
1530 GTK_STATE_PRELIGHT : GTK_STATE_NORMAL,
1532 NULL, widget, "menu",
1534 height - border_y - MENU_SCROLL_ARROW_HEIGHT + 1,
1536 MENU_SCROLL_ARROW_HEIGHT);
1538 gtk_paint_arrow (widget->style,
1540 menu->lower_arrow_prelight ?
1541 GTK_STATE_PRELIGHT : GTK_STATE_NORMAL,
1543 NULL, widget, "menu",
1546 width / 2 - MENU_SCROLL_ARROW_HEIGHT / 2 + 1,
1547 height - MENU_SCROLL_ARROW_HEIGHT + 1,
1548 MENU_SCROLL_ARROW_HEIGHT - 2 * border_y - 2,
1549 MENU_SCROLL_ARROW_HEIGHT - 2 * border_y - 2);
1552 else if (event->window == menu->view_window)
1557 if (menu->scroll_offset < 0)
1558 gtk_paint_box (widget->style,
1562 NULL, widget, "menu",
1565 -menu->scroll_offset);
1567 menu_height = widget->requisition.height - 2*border_y;
1568 top_pos = height - 2*border_y - (menu->upper_arrow_visible ? MENU_SCROLL_ARROW_HEIGHT : 0);
1570 if (menu_height - menu->scroll_offset < top_pos)
1571 gtk_paint_box (widget->style,
1575 NULL, widget, "menu",
1577 menu_height - menu->scroll_offset,
1579 top_pos - (menu_height - menu->scroll_offset));
1584 gtk_menu_expose (GtkWidget *widget,
1585 GdkEventExpose *event)
1587 g_return_val_if_fail (GTK_IS_MENU (widget), FALSE);
1588 g_return_val_if_fail (event != NULL, FALSE);
1590 if (GTK_WIDGET_DRAWABLE (widget))
1592 gtk_menu_paint (widget, event);
1594 (* GTK_WIDGET_CLASS (parent_class)->expose_event) (widget, event);
1601 gtk_menu_show (GtkWidget *widget)
1603 GtkMenu *menu = GTK_MENU (widget);
1605 _gtk_menu_refresh_accel_paths (menu, FALSE);
1607 GTK_WIDGET_CLASS (parent_class)->show (widget);
1611 gtk_menu_key_press (GtkWidget *widget,
1614 GtkMenuShell *menu_shell;
1616 GtkAccelGroup *accel_group;
1617 gboolean delete = FALSE;
1618 gchar *accel = NULL;
1619 guint accel_key, accel_mods;
1621 g_return_val_if_fail (GTK_IS_MENU (widget), FALSE);
1622 g_return_val_if_fail (event != NULL, FALSE);
1624 menu_shell = GTK_MENU_SHELL (widget);
1625 menu = GTK_MENU (widget);
1626 accel_group = gtk_menu_get_accel_group (menu);
1628 gtk_menu_stop_navigating_submenu (menu);
1630 if (GTK_WIDGET_CLASS (parent_class)->key_press_event (widget, event))
1633 g_object_get (G_OBJECT (gtk_settings_get_default ()),
1634 "gtk-menu-bar-accel",
1641 GdkModifierType mods = 0;
1642 gboolean handled = FALSE;
1644 gtk_accelerator_parse (accel, &keyval, &mods);
1647 g_warning ("Failed to parse menu bar accelerator '%s'\n", accel);
1649 /* FIXME this is wrong, needs to be in the global accel resolution
1650 * thing, to properly consider i18n etc., but that probably requires
1651 * AccelGroup changes etc.
1653 if (event->keyval == keyval &&
1654 (mods & event->state) == mods)
1656 gtk_signal_emit_by_name (GTK_OBJECT (menu), "cancel");
1665 switch (event->keyval)
1676 accel_key = event->keyval;
1677 accel_mods = event->state & gtk_accelerator_get_default_mod_mask ();
1679 /* Modify the accelerators */
1680 if (menu_shell->active_menu_item &&
1681 GTK_BIN (menu_shell->active_menu_item)->child && /* no seperators */
1682 GTK_MENU_ITEM (menu_shell->active_menu_item)->submenu == NULL && /* no submenus */
1684 (gtk_accelerator_valid (event->keyval, event->state) &&
1686 (accel_key >= GDK_F1 && accel_key <= GDK_F35)))))
1688 GtkWidget *menu_item = menu_shell->active_menu_item;
1689 gboolean replace_accels = TRUE;
1692 path = GTK_MENU_ITEM (menu_item)->accel_path;
1694 path = _gtk_widget_get_accel_path (menu_item);
1697 /* can't change accelerators on menu_items without paths
1698 * (basically, those items are accelerator-locked).
1700 /* g_print("item has no path, menu prefix: %s\n", menu->accel_path); */
1712 changed = gtk_accel_map_change_entry (path, accel_key, accel_mods, replace_accels);
1716 /* we failed, probably because this key is in use and
1719 /* g_print("failed to change\n"); */
1729 gtk_menu_motion_notify (GtkWidget *widget,
1730 GdkEventMotion *event)
1732 GtkWidget *menu_item;
1734 GtkMenuShell *menu_shell;
1736 gboolean need_enter;
1739 if (GTK_IS_MENU (widget))
1740 gtk_menu_handle_scrolling (GTK_MENU (widget), TRUE);
1742 /* We received the event for one of two reasons:
1744 * a) We are the active menu, and did gtk_grab_add()
1745 * b) The widget is a child of ours, and the event was propagated
1747 * Since for computation of navigation regions, we want the menu which
1748 * is the parent of the menu item, for a), we need to find that menu,
1749 * which may be different from 'widget'.
1751 menu_item = gtk_get_event_widget ((GdkEvent*) event);
1752 if (!menu_item || !GTK_IS_MENU_ITEM (menu_item) ||
1753 !_gtk_menu_item_is_selectable (menu_item) ||
1754 !GTK_IS_MENU (menu_item->parent))
1757 menu_shell = GTK_MENU_SHELL (menu_item->parent);
1758 menu = GTK_MENU (menu_shell);
1760 need_enter = (menu->navigation_region != NULL || menu_shell->ignore_enter);
1762 /* Check to see if we are within an active submenu's navigation region
1764 if (gtk_menu_navigating_submenu (menu, event->x_root, event->y_root))
1769 /* The menu is now sensitive to enter events on its items, but
1770 * was previously sensitive. So we fake an enter event.
1774 menu_shell->ignore_enter = FALSE;
1776 gdk_window_get_size (event->window, &width, &height);
1777 if (event->x >= 0 && event->x < width &&
1778 event->y >= 0 && event->y < height)
1780 GdkEvent send_event;
1782 memset (&send_event, 0, sizeof (send_event));
1783 send_event.crossing.type = GDK_ENTER_NOTIFY;
1784 send_event.crossing.window = event->window;
1785 send_event.crossing.time = event->time;
1786 send_event.crossing.send_event = TRUE;
1787 send_event.crossing.x_root = event->x_root;
1788 send_event.crossing.y_root = event->y_root;
1789 send_event.crossing.x = event->x;
1790 send_event.crossing.y = event->y;
1792 /* We send the event to 'widget', the currently active menu,
1793 * instead of 'menu', the menu that the pointer is in. This
1794 * will ensure that the event will be ignored unless the
1795 * menuitem is a child of the active menu or some parent
1796 * menu of the active menu.
1798 return gtk_widget_event (widget, &send_event);
1806 gtk_menu_scroll_timeout (gpointer data)
1811 gint view_width, view_height;
1813 GDK_THREADS_ENTER ();
1815 menu = GTK_MENU (data);
1816 widget = GTK_WIDGET (menu);
1818 offset = menu->scroll_offset + menu->scroll_step;
1820 /* If we scroll upward and the non-visible top part
1821 * is smaller than the scroll arrow it would be
1822 * pretty stupid to show the arrow and taking more
1823 * screen space than just scrolling to the top.
1825 if ((menu->scroll_step < 0) && (offset < MENU_SCROLL_ARROW_HEIGHT))
1828 /* Don't scroll over the top if we weren't before: */
1829 if ((menu->scroll_offset >= 0) && (offset < 0))
1832 gdk_window_get_size (widget->window, &view_width, &view_height);
1834 /* Don't scroll past the bottom if we weren't before: */
1835 if (menu->scroll_offset > 0)
1836 view_height -= MENU_SCROLL_ARROW_HEIGHT;
1838 if ((menu->scroll_offset + view_height <= widget->requisition.height) &&
1839 (offset + view_height > widget->requisition.height))
1840 offset = widget->requisition.height - view_height;
1842 gtk_menu_scroll_to (menu, offset);
1844 GDK_THREADS_LEAVE ();
1850 gtk_menu_handle_scrolling (GtkMenu *menu, gboolean enter)
1852 GtkMenuShell *menu_shell;
1858 gboolean scroll_fast = FALSE;
1860 menu_shell = GTK_MENU_SHELL (menu);
1862 gdk_window_get_pointer (GTK_WIDGET (menu)->window, &x, &y, NULL);
1863 gdk_window_get_size (GTK_WIDGET (menu)->window, &width, &height);
1865 border = GTK_CONTAINER (menu)->border_width + GTK_WIDGET (menu)->style->ythickness;
1867 if (menu->upper_arrow_visible && !menu->tearoff_active)
1872 rect.height = MENU_SCROLL_ARROW_HEIGHT + border;
1875 if ((x >= rect.x) && (x < rect.x + rect.width) &&
1876 (y >= rect.y) && (y < rect.y + rect.height))
1879 scroll_fast = (y < rect.y + MENU_SCROLL_FAST_ZONE);
1882 if (enter && in_arrow &&
1883 (!menu->upper_arrow_prelight || menu->scroll_fast != scroll_fast))
1885 menu->upper_arrow_prelight = TRUE;
1886 menu->scroll_fast = scroll_fast;
1887 gdk_window_invalidate_rect (GTK_WIDGET (menu)->window, &rect, FALSE);
1889 /* Deselect the active item so that any submenus are poped down */
1890 gtk_menu_shell_deselect (menu_shell);
1892 gtk_menu_stop_scrolling (menu);
1893 menu->scroll_step = -MENU_SCROLL_STEP;
1894 menu->timeout_id = g_timeout_add ((scroll_fast) ? MENU_SCROLL_TIMEOUT2 : MENU_SCROLL_TIMEOUT1,
1895 gtk_menu_scroll_timeout,
1898 else if (!enter && !in_arrow && menu->upper_arrow_prelight)
1900 menu->upper_arrow_prelight = FALSE;
1901 gdk_window_invalidate_rect (GTK_WIDGET (menu)->window, &rect, FALSE);
1903 gtk_menu_stop_scrolling (menu);
1907 if (menu->lower_arrow_visible && !menu->tearoff_active)
1910 rect.y = height - border - MENU_SCROLL_ARROW_HEIGHT;
1912 rect.height = MENU_SCROLL_ARROW_HEIGHT + border;
1915 if ((x >= rect.x) && (x < rect.x + rect.width) &&
1916 (y >= rect.y) && (y < rect.y + rect.height))
1919 scroll_fast = (y > rect.y + rect.height - MENU_SCROLL_FAST_ZONE);
1922 if (enter && in_arrow &&
1923 (!menu->lower_arrow_prelight || menu->scroll_fast != scroll_fast))
1925 menu->lower_arrow_prelight = TRUE;
1926 menu->scroll_fast = scroll_fast;
1927 gdk_window_invalidate_rect (GTK_WIDGET (menu)->window, &rect, FALSE);
1929 /* Deselect the active item so that any submenus are poped down */
1930 gtk_menu_shell_deselect (menu_shell);
1932 gtk_menu_stop_scrolling (menu);
1933 menu->scroll_step = MENU_SCROLL_STEP;
1934 menu->timeout_id = g_timeout_add ((scroll_fast) ? MENU_SCROLL_TIMEOUT2 : MENU_SCROLL_TIMEOUT1,
1935 gtk_menu_scroll_timeout,
1938 else if (!enter && !in_arrow && menu->lower_arrow_prelight)
1940 menu->lower_arrow_prelight = FALSE;
1941 gdk_window_invalidate_rect (GTK_WIDGET (menu)->window, &rect, FALSE);
1943 gtk_menu_stop_scrolling (menu);
1949 gtk_menu_enter_notify (GtkWidget *widget,
1950 GdkEventCrossing *event)
1952 GtkWidget *menu_item;
1954 if (widget && GTK_IS_MENU (widget))
1955 gtk_menu_handle_scrolling (GTK_MENU (widget), TRUE);
1957 /* If this is a faked enter (see gtk_menu_motion_notify), 'widget'
1958 * will not correspond to the event widget's parent. Check to see
1959 * if we are in the parent's navigation region.
1961 menu_item = gtk_get_event_widget ((GdkEvent*) event);
1962 if (menu_item && GTK_IS_MENU_ITEM (menu_item) && GTK_IS_MENU (menu_item->parent) &&
1963 gtk_menu_navigating_submenu (GTK_MENU (menu_item->parent), event->x_root, event->y_root))
1966 return GTK_WIDGET_CLASS (parent_class)->enter_notify_event (widget, event);
1970 gtk_menu_leave_notify (GtkWidget *widget,
1971 GdkEventCrossing *event)
1973 GtkMenuShell *menu_shell;
1975 GtkMenuItem *menu_item;
1976 GtkWidget *event_widget;
1978 menu = GTK_MENU (widget);
1979 menu_shell = GTK_MENU_SHELL (widget);
1981 if (gtk_menu_navigating_submenu (menu, event->x_root, event->y_root))
1984 gtk_menu_handle_scrolling (menu, FALSE);
1986 event_widget = gtk_get_event_widget ((GdkEvent*) event);
1988 if (!event_widget || !GTK_IS_MENU_ITEM (event_widget))
1991 menu_item = GTK_MENU_ITEM (event_widget);
1993 /* Here we check to see if we're leaving an active menu item with a submenu,
1994 * in which case we enter submenu navigation mode.
1996 if (menu_shell->active_menu_item != NULL
1997 && menu_item->submenu != NULL
1998 && menu_item->submenu_placement == GTK_LEFT_RIGHT)
2000 if (menu_item->submenu->window != NULL)
2002 gtk_menu_set_submenu_navigation_region (menu, menu_item, event);
2007 return GTK_WIDGET_CLASS (parent_class)->leave_notify_event (widget, event);
2011 gtk_menu_stop_navigating_submenu (GtkMenu *menu)
2013 if (menu->navigation_region)
2015 gdk_region_destroy (menu->navigation_region);
2016 menu->navigation_region = NULL;
2019 if (menu->navigation_timeout)
2021 gtk_timeout_remove (menu->navigation_timeout);
2022 menu->navigation_timeout = 0;
2026 /* When the timeout is elapsed, the navigation region is destroyed
2027 * and the menuitem under the pointer (if any) is selected.
2030 gtk_menu_stop_navigating_submenu_cb (gpointer user_data)
2032 GtkMenu *menu = user_data;
2033 GdkWindow *child_window;
2035 GDK_THREADS_ENTER ();
2037 gtk_menu_stop_navigating_submenu (menu);
2039 if (GTK_WIDGET_REALIZED (menu))
2041 child_window = gdk_window_get_pointer (menu->bin_window, NULL, NULL, NULL);
2045 GdkEventCrossing send_event;
2047 memset (&send_event, 0, sizeof (send_event));
2048 send_event.window = child_window;
2049 send_event.type = GDK_ENTER_NOTIFY;
2050 send_event.time = GDK_CURRENT_TIME; /* Bogus */
2051 send_event.send_event = TRUE;
2053 GTK_WIDGET_CLASS (parent_class)->enter_notify_event (GTK_WIDGET (menu), &send_event);
2057 GDK_THREADS_LEAVE ();
2063 gtk_menu_navigating_submenu (GtkMenu *menu,
2067 if (menu->navigation_region)
2069 if (gdk_region_point_in (menu->navigation_region, event_x, event_y))
2073 gtk_menu_stop_navigating_submenu (menu);
2081 gtk_menu_set_submenu_navigation_region (GtkMenu *menu,
2082 GtkMenuItem *menu_item,
2083 GdkEventCrossing *event)
2085 gint submenu_left = 0;
2086 gint submenu_right = 0;
2087 gint submenu_top = 0;
2088 gint submenu_bottom = 0;
2092 GtkWidget *event_widget;
2094 g_return_if_fail (menu_item->submenu != NULL);
2095 g_return_if_fail (event != NULL);
2097 event_widget = gtk_get_event_widget ((GdkEvent*) event);
2099 gdk_window_get_origin (menu_item->submenu->window, &submenu_left, &submenu_top);
2100 gdk_window_get_size (menu_item->submenu->window, &width, &height);
2101 submenu_right = submenu_left + width;
2102 submenu_bottom = submenu_top + height;
2104 gdk_window_get_size (event_widget->window, &width, &height);
2106 if (event->x >= 0 && event->x < width)
2108 /* Set navigation region */
2109 /* We fudge/give a little padding in case the user
2110 * ``misses the vertex'' of the triangle/is off by a pixel or two.
2112 if (menu_item->submenu_direction == GTK_DIRECTION_RIGHT)
2113 point[0].x = event->x_root - SUBMENU_NAV_REGION_PADDING;
2115 point[0].x = event->x_root + SUBMENU_NAV_REGION_PADDING;
2117 /* Exiting the top or bottom? */
2120 point[0].y = event->y_root + SUBMENU_NAV_REGION_PADDING;
2121 point[1].y = submenu_top;
2123 if (point[0].y <= point[1].y)
2128 point[0].y = event->y_root - SUBMENU_NAV_REGION_PADDING;
2129 point[1].y = submenu_bottom;
2131 if (point[0].y >= point[1].y)
2135 /* Submenu is to the left or right? */
2136 if (menu_item->submenu_direction == GTK_DIRECTION_RIGHT)
2137 point[1].x = submenu_left; /* right */
2139 point[1].x = submenu_right; /* left */
2141 point[2].x = point[1].x;
2142 point[2].y = point[0].y;
2144 gtk_menu_stop_navigating_submenu (menu);
2146 menu->navigation_region = gdk_region_polygon (point, 3, GDK_WINDING_RULE);
2148 menu->navigation_timeout = gtk_timeout_add (SUBMENU_NAV_HYSTERESIS_TIMEOUT,
2149 gtk_menu_stop_navigating_submenu_cb, menu);
2154 gtk_menu_deactivate (GtkMenuShell *menu_shell)
2158 g_return_if_fail (GTK_IS_MENU (menu_shell));
2160 parent = menu_shell->parent_menu_shell;
2162 menu_shell->activate_time = 0;
2163 gtk_menu_popdown (GTK_MENU (menu_shell));
2166 gtk_menu_shell_deactivate (GTK_MENU_SHELL (parent));
2170 gtk_menu_position (GtkMenu *menu)
2173 GtkRequisition requisition;
2181 g_return_if_fail (GTK_IS_MENU (menu));
2183 widget = GTK_WIDGET (menu);
2185 screen_width = gdk_screen_width ();
2186 screen_height = gdk_screen_height ();
2188 gdk_window_get_pointer (NULL, &x, &y, NULL);
2190 /* We need the requisition to figure out the right place to
2191 * popup the menu. In fact, we always need to ask here, since
2192 * if a size_request was queued while we weren't popped up,
2193 * the requisition won't have been recomputed yet.
2195 gtk_widget_size_request (widget, &requisition);
2199 if (menu->position_func)
2200 (* menu->position_func) (menu, &x, &y, &push_in, menu->position_func_data);
2203 x = CLAMP (x - 2, 0, MAX (0, screen_width - requisition.width));
2204 y = CLAMP (y - 2, 0, MAX (0, screen_height - requisition.height));
2211 menu_height = GTK_WIDGET (menu)->requisition.height;
2213 if (y + menu_height > screen_height)
2215 scroll_offset -= y + menu_height - screen_height;
2216 y = screen_height - menu_height;
2226 if (y + requisition.height > screen_height)
2227 requisition.height = screen_height - y;
2232 requisition.height -= -y;
2236 if (scroll_offset > 0)
2237 scroll_offset += MENU_SCROLL_ARROW_HEIGHT;
2239 gtk_window_move (GTK_WINDOW (GTK_MENU_SHELL (menu)->active ? menu->toplevel : menu->tearoff_window),
2241 gtk_widget_set_usize (GTK_MENU_SHELL (menu)->active ?
2242 menu->toplevel : menu->tearoff_hbox,
2243 -1, requisition.height);
2244 menu->scroll_offset = scroll_offset;
2248 gtk_menu_stop_scrolling (GtkMenu *menu)
2250 if (menu->timeout_id)
2252 g_source_remove (menu->timeout_id);
2253 menu->timeout_id = 0;
2259 gtk_menu_scroll_to (GtkMenu *menu,
2264 gint view_width, view_height;
2266 gboolean last_visible;
2269 widget = GTK_WIDGET (menu);
2271 if (menu->tearoff_active &&
2272 menu->tearoff_adjustment &&
2273 (menu->tearoff_adjustment->value != offset))
2275 menu->tearoff_adjustment->value = offset;
2276 gtk_adjustment_value_changed (menu->tearoff_adjustment);
2279 /* Scroll the menu: */
2280 gdk_window_move (menu->bin_window, 0, -offset);
2282 /* Move/resize the viewport according to arrows: */
2283 gdk_window_get_size (widget->window, &view_width, &view_height);
2285 border_width = GTK_CONTAINER (menu)->border_width;
2286 view_width -= (border_width + widget->style->xthickness) * 2;
2287 view_height -= (border_width + widget->style->ythickness) * 2;
2288 menu_height = widget->requisition.height - (border_width + widget->style->ythickness) * 2;
2290 x = border_width + widget->style->xthickness;
2291 y = border_width + widget->style->ythickness;
2293 if (!menu->tearoff_active)
2295 last_visible = menu->upper_arrow_visible;
2296 menu->upper_arrow_visible = (offset > 0);
2298 if (menu->upper_arrow_visible)
2299 view_height -= MENU_SCROLL_ARROW_HEIGHT;
2301 if ( (last_visible != menu->upper_arrow_visible) &&
2302 !menu->upper_arrow_visible)
2304 menu->upper_arrow_prelight = FALSE;
2306 /* If we hid the upper arrow, possibly remove timeout */
2307 if (menu->scroll_step < 0)
2308 gtk_menu_stop_scrolling (menu);
2311 last_visible = menu->lower_arrow_visible;
2312 menu->lower_arrow_visible = (view_height + offset < menu_height);
2314 if (menu->lower_arrow_visible)
2315 view_height -= MENU_SCROLL_ARROW_HEIGHT;
2317 if ( (last_visible != menu->lower_arrow_visible) &&
2318 !menu->lower_arrow_visible)
2320 menu->lower_arrow_prelight = FALSE;
2322 /* If we hid the lower arrow, possibly remove timeout */
2323 if (menu->scroll_step > 0)
2324 gtk_menu_stop_scrolling (menu);
2327 if (menu->upper_arrow_visible)
2328 y += MENU_SCROLL_ARROW_HEIGHT;
2331 gdk_window_move_resize (menu->view_window,
2337 menu->scroll_offset = offset;
2341 gtk_menu_scroll_item_visible (GtkMenuShell *menu_shell,
2342 GtkWidget *menu_item)
2347 GtkRequisition child_requisition;
2348 gint child_offset, child_height;
2352 gboolean last_child = 0;
2354 menu = GTK_MENU (menu_shell);
2356 /* We need to check if the selected item fully visible.
2357 * If not we need to scroll the menu so that it becomes fully
2364 children = menu_shell->children;
2367 child = children->data;
2368 children = children->next;
2370 if (GTK_WIDGET_VISIBLE (child))
2372 gtk_widget_size_request (child, &child_requisition);
2373 child_offset += child_height;
2374 child_height = child_requisition.height;
2377 if (child == menu_item)
2379 last_child = (children == NULL);
2384 if (child == menu_item)
2386 y = menu->scroll_offset;
2387 gdk_window_get_size (GTK_WIDGET (menu)->window, &width, &height);
2389 height -= 2*GTK_CONTAINER (menu)->border_width + 2*GTK_WIDGET (menu)->style->ythickness;
2391 if (child_offset + child_height <= y)
2393 /* Ignore the enter event we might get if the pointer is on the menu
2395 menu_shell->ignore_enter = TRUE;
2396 gtk_menu_scroll_to (menu, child_offset);
2401 if (menu->upper_arrow_visible && !menu->tearoff_active)
2402 arrow_height += MENU_SCROLL_ARROW_HEIGHT;
2403 if (menu->lower_arrow_visible && !menu->tearoff_active)
2404 arrow_height += MENU_SCROLL_ARROW_HEIGHT;
2406 if (child_offset >= y + height - arrow_height)
2409 if (!last_child && !menu->tearoff_active)
2410 arrow_height += MENU_SCROLL_ARROW_HEIGHT;
2412 y = child_offset + child_height - height + arrow_height;
2413 if ((y > 0) && !menu->tearoff_active)
2415 /* Need upper arrow */
2416 arrow_height += MENU_SCROLL_ARROW_HEIGHT;
2417 y = child_offset + child_height - height + arrow_height;
2419 /* Ignore the enter event we might get if the pointer is on the menu
2421 menu_shell->ignore_enter = TRUE;
2422 gtk_menu_scroll_to (menu, y);
2430 gtk_menu_select_item (GtkMenuShell *menu_shell,
2431 GtkWidget *menu_item)
2433 GtkMenu *menu = GTK_MENU (menu_shell);
2435 if (GTK_WIDGET_REALIZED (GTK_WIDGET (menu)))
2436 gtk_menu_scroll_item_visible (menu_shell, menu_item);
2438 GTK_MENU_SHELL_CLASS (parent_class)->select_item (menu_shell, menu_item);
2442 /* Reparent the menu, taking care of the refcounting
2444 * If unrealize is true we force a unrealize while reparenting the parent.
2445 * This can help eliminate flicker in some cases.
2447 * What happens is that when the menu is unrealized and then re-realized,
2448 * the allocations are as follows:
2450 * parent - 1x1 at (0,0)
2451 * child1 - 100x20 at (0,0)
2452 * child2 - 100x20 at (0,20)
2453 * child3 - 100x20 at (0,40)
2455 * That is, the parent is small but the children are full sized. Then,
2456 * when the queued_resize gets processed, the parent gets resized to
2459 * But in order to eliminate flicker when scrolling, gdkgeometry-x11.c
2460 * contains the following logic:
2462 * - if a move or resize operation on a window would change the clip
2463 * region on the children, then before the window is resized
2464 * the background for children is temporarily set to None, the
2465 * move/resize done, and the background for the children restored.
2467 * So, at the point where the parent is resized to final size, the
2468 * background for the children is temporarily None, and thus they
2469 * are not cleared to the background color and the previous background
2470 * (the image of the menu) is left in place.
2473 gtk_menu_reparent (GtkMenu *menu,
2474 GtkWidget *new_parent,
2477 GtkObject *object = GTK_OBJECT (menu);
2478 GtkWidget *widget = GTK_WIDGET (menu);
2479 gboolean was_floating = GTK_OBJECT_FLOATING (object);
2481 gtk_object_ref (object);
2482 gtk_object_sink (object);
2486 gtk_object_ref (object);
2487 gtk_container_remove (GTK_CONTAINER (widget->parent), widget);
2488 gtk_container_add (GTK_CONTAINER (new_parent), widget);
2489 gtk_object_unref (object);
2492 gtk_widget_reparent (GTK_WIDGET (menu), new_parent);
2495 GTK_OBJECT_SET_FLAGS (object, GTK_FLOATING);
2497 gtk_object_unref (object);
2501 gtk_menu_show_all (GtkWidget *widget)
2503 g_return_if_fail (GTK_IS_MENU (widget));
2505 /* Show children, but not self. */
2506 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_show_all, NULL);
2511 gtk_menu_hide_all (GtkWidget *widget)
2513 g_return_if_fail (GTK_IS_MENU (widget));
2515 /* Hide children, but not self. */
2516 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_hide_all, NULL);