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/.
27 #define GTK_MENU_INTERNALS
32 #include "gtkaccellabel.h"
34 #include "gtkmarshalers.h"
36 #include "gtkmenubar.h"
37 #include "gtkseparatormenuitem.h"
38 #include "gtkprivate.h"
58 static void gtk_menu_item_set_property (GObject *object,
62 static void gtk_menu_item_get_property (GObject *object,
66 static void gtk_menu_item_destroy (GtkObject *object);
67 static void gtk_menu_item_size_request (GtkWidget *widget,
68 GtkRequisition *requisition);
69 static void gtk_menu_item_size_allocate (GtkWidget *widget,
70 GtkAllocation *allocation);
71 static void gtk_menu_item_realize (GtkWidget *widget);
72 static void gtk_menu_item_unrealize (GtkWidget *widget);
73 static void gtk_menu_item_map (GtkWidget *widget);
74 static void gtk_menu_item_unmap (GtkWidget *widget);
75 static void gtk_menu_item_paint (GtkWidget *widget,
77 static gint gtk_menu_item_expose (GtkWidget *widget,
78 GdkEventExpose *event);
79 static void gtk_menu_item_parent_set (GtkWidget *widget,
80 GtkWidget *previous_parent);
83 static void gtk_real_menu_item_select (GtkItem *item);
84 static void gtk_real_menu_item_deselect (GtkItem *item);
85 static void gtk_real_menu_item_activate_item (GtkMenuItem *item);
86 static void gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
88 static void gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
90 static gboolean gtk_menu_item_mnemonic_activate (GtkWidget *widget,
91 gboolean group_cycling);
93 static gint gtk_menu_item_popup_timeout (gpointer data);
94 static void gtk_menu_item_position_menu (GtkMenu *menu,
99 static void gtk_menu_item_show_all (GtkWidget *widget);
100 static void gtk_menu_item_hide_all (GtkWidget *widget);
101 static void gtk_menu_item_forall (GtkContainer *container,
102 gboolean include_internals,
103 GtkCallback callback,
104 gpointer callback_data);
105 static gboolean gtk_menu_item_can_activate_accel (GtkWidget *widget,
109 static guint menu_item_signals[LAST_SIGNAL] = { 0 };
111 G_DEFINE_TYPE (GtkMenuItem, gtk_menu_item, GTK_TYPE_ITEM)
114 gtk_menu_item_class_init (GtkMenuItemClass *klass)
116 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
117 GtkObjectClass *object_class = GTK_OBJECT_CLASS (klass);
118 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
119 GtkContainerClass *container_class = GTK_CONTAINER_CLASS (klass);
120 GtkItemClass *item_class = GTK_ITEM_CLASS (klass);
122 gobject_class->set_property = gtk_menu_item_set_property;
123 gobject_class->get_property = gtk_menu_item_get_property;
125 object_class->destroy = gtk_menu_item_destroy;
127 widget_class->size_request = gtk_menu_item_size_request;
128 widget_class->size_allocate = gtk_menu_item_size_allocate;
129 widget_class->expose_event = gtk_menu_item_expose;
130 widget_class->realize = gtk_menu_item_realize;
131 widget_class->unrealize = gtk_menu_item_unrealize;
132 widget_class->map = gtk_menu_item_map;
133 widget_class->unmap = gtk_menu_item_unmap;
134 widget_class->show_all = gtk_menu_item_show_all;
135 widget_class->hide_all = gtk_menu_item_hide_all;
136 widget_class->mnemonic_activate = gtk_menu_item_mnemonic_activate;
137 widget_class->parent_set = gtk_menu_item_parent_set;
138 widget_class->can_activate_accel = gtk_menu_item_can_activate_accel;
140 container_class->forall = gtk_menu_item_forall;
142 item_class->select = gtk_real_menu_item_select;
143 item_class->deselect = gtk_real_menu_item_deselect;
145 klass->activate = NULL;
146 klass->activate_item = gtk_real_menu_item_activate_item;
147 klass->toggle_size_request = gtk_real_menu_item_toggle_size_request;
148 klass->toggle_size_allocate = gtk_real_menu_item_toggle_size_allocate;
150 klass->hide_on_activate = TRUE;
152 menu_item_signals[ACTIVATE] =
153 g_signal_new (I_("activate"),
154 G_OBJECT_CLASS_TYPE (gobject_class),
155 G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
156 G_STRUCT_OFFSET (GtkMenuItemClass, activate),
158 _gtk_marshal_VOID__VOID,
160 widget_class->activate_signal = menu_item_signals[ACTIVATE];
162 menu_item_signals[ACTIVATE_ITEM] =
163 g_signal_new (I_("activate-item"),
164 G_OBJECT_CLASS_TYPE (gobject_class),
166 G_STRUCT_OFFSET (GtkMenuItemClass, activate_item),
168 _gtk_marshal_VOID__VOID,
171 menu_item_signals[TOGGLE_SIZE_REQUEST] =
172 g_signal_new (I_("toggle-size-request"),
173 G_OBJECT_CLASS_TYPE (gobject_class),
175 G_STRUCT_OFFSET (GtkMenuItemClass, toggle_size_request),
177 _gtk_marshal_VOID__POINTER,
181 menu_item_signals[TOGGLE_SIZE_ALLOCATE] =
182 g_signal_new (I_("toggle-size-allocate"),
183 G_OBJECT_CLASS_TYPE (gobject_class),
185 G_STRUCT_OFFSET (GtkMenuItemClass, toggle_size_allocate),
187 _gtk_marshal_VOID__INT,
192 * GtkMenuItem:right-justified:
194 * Sets whether the menu item appears justified at the right side of a menu bar.
198 g_object_class_install_property (gobject_class,
199 PROP_RIGHT_JUSTIFIED,
200 g_param_spec_boolean ("right-justified",
201 P_("Right Justified"),
202 P_("Sets whether the menu item appears justified at the right side of a menu bar"),
204 GTK_PARAM_READWRITE));
207 * GtkMenuItem:submenu:
209 * The submenu attached to the menu item, or NULL if it has none.
213 g_object_class_install_property (gobject_class,
215 g_param_spec_object ("submenu",
217 P_("The submenu attached to the menu item, or NULL if it has none"),
219 GTK_PARAM_READWRITE));
222 * GtkMenuItem:accel-path:
224 * Sets the accelerator path of the menu item, through which runtime
225 * changes of the menu item's accelerator caused by the user can be
226 * identified and saved to persistant storage.
230 g_object_class_install_property (gobject_class,
232 g_param_spec_string ("accel-path",
234 P_("Sets the accelerator path of the menu item"),
236 GTK_PARAM_READWRITE));
238 gtk_widget_class_install_style_property_parser (widget_class,
239 g_param_spec_enum ("selected-shadow-type",
240 "Selected Shadow Type",
241 "Shadow type when item is selected",
242 GTK_TYPE_SHADOW_TYPE,
245 gtk_rc_property_parse_enum);
247 gtk_widget_class_install_style_property (widget_class,
248 g_param_spec_int ("horizontal-padding",
249 "Horizontal Padding",
250 "Padding to left and right of the menu item",
254 GTK_PARAM_READABLE));
256 gtk_widget_class_install_style_property (widget_class,
257 g_param_spec_int ("toggle-spacing",
259 "Space between icon and label",
263 GTK_PARAM_READABLE));
265 gtk_widget_class_install_style_property (widget_class,
266 g_param_spec_int ("arrow-spacing",
268 "Space between label and arrow",
272 GTK_PARAM_READABLE));
274 gtk_widget_class_install_style_property (widget_class,
275 g_param_spec_float ("arrow-scaling",
277 P_("Amount of space used up by arrow, relative to the menu item's font size"),
279 GTK_PARAM_READABLE));
282 * GtkMenuItem:width-chars:
284 * The minimum desired width of the menu item in characters.
288 gtk_widget_class_install_style_property (widget_class,
289 g_param_spec_int ("width-chars",
290 P_("Width in Characters"),
291 P_("The minimum desired width of the menu item in characters"),
293 GTK_PARAM_READABLE));
297 gtk_menu_item_init (GtkMenuItem *menu_item)
299 GTK_WIDGET_SET_FLAGS (menu_item, GTK_NO_WINDOW);
301 menu_item->submenu = NULL;
302 menu_item->toggle_size = 0;
303 menu_item->accelerator_width = 0;
304 menu_item->show_submenu_indicator = FALSE;
305 if (gtk_widget_get_direction (GTK_WIDGET (menu_item)) == GTK_TEXT_DIR_RTL)
306 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
308 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
309 menu_item->submenu_placement = GTK_TOP_BOTTOM;
310 menu_item->right_justify = FALSE;
312 menu_item->timer = 0;
316 gtk_menu_item_new (void)
318 return g_object_new (GTK_TYPE_MENU_ITEM, NULL);
322 gtk_menu_item_new_with_label (const gchar *label)
324 GtkWidget *menu_item;
325 GtkWidget *accel_label;
327 menu_item = gtk_menu_item_new ();
328 accel_label = gtk_accel_label_new (label);
329 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
331 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
332 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
333 gtk_widget_show (accel_label);
340 * gtk_menu_item_new_with_mnemonic:
341 * @label: The text of the button, with an underscore in front of the
343 * @returns: a new #GtkMenuItem
345 * Creates a new #GtkMenuItem containing a label. The label
346 * will be created using gtk_label_new_with_mnemonic(), so underscores
347 * in @label indicate the mnemonic for the menu item.
350 gtk_menu_item_new_with_mnemonic (const gchar *label)
352 GtkWidget *menu_item;
353 GtkWidget *accel_label;
355 menu_item = gtk_menu_item_new ();
356 accel_label = g_object_new (GTK_TYPE_ACCEL_LABEL, NULL);
357 gtk_label_set_text_with_mnemonic (GTK_LABEL (accel_label), label);
358 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
360 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
361 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
362 gtk_widget_show (accel_label);
368 gtk_menu_item_set_property (GObject *object,
373 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
377 case PROP_RIGHT_JUSTIFIED:
378 gtk_menu_item_set_right_justified (menu_item, g_value_get_boolean (value));
381 gtk_menu_item_set_submenu (menu_item, g_value_get_object (value));
383 case PROP_ACCEL_PATH:
384 gtk_menu_item_set_accel_path (menu_item, g_value_get_string (value));
388 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
394 gtk_menu_item_get_property (GObject *object,
399 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
403 case PROP_RIGHT_JUSTIFIED:
404 g_value_set_boolean (value, gtk_menu_item_get_right_justified (menu_item));
407 g_value_set_object (value, gtk_menu_item_get_submenu (menu_item));
409 case PROP_ACCEL_PATH:
410 g_value_set_string (value, gtk_menu_item_get_accel_path (menu_item));
414 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
420 gtk_menu_item_destroy (GtkObject *object)
422 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
424 if (menu_item->submenu)
425 gtk_widget_destroy (menu_item->submenu);
427 GTK_OBJECT_CLASS (gtk_menu_item_parent_class)->destroy (object);
431 gtk_menu_item_detacher (GtkWidget *widget,
434 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
436 g_return_if_fail (menu_item->submenu == (GtkWidget*) menu);
438 menu_item->submenu = NULL;
442 * gtk_menu_item_set_submenu:
443 * @menu_item: a #GtkMenuItem
444 * @submenu: the submenu, or %NULL
446 * Sets or replaces the menu item's submenu, or removes it when a %NULL
450 gtk_menu_item_set_submenu (GtkMenuItem *menu_item,
453 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
454 g_return_if_fail (submenu == NULL || GTK_IS_MENU (submenu));
456 if (menu_item->submenu != submenu)
458 if (menu_item->submenu)
459 gtk_menu_detach (GTK_MENU (menu_item->submenu));
463 menu_item->submenu = submenu;
464 gtk_menu_attach_to_widget (GTK_MENU (submenu),
465 GTK_WIDGET (menu_item),
466 gtk_menu_item_detacher);
469 if (GTK_WIDGET (menu_item)->parent)
470 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
472 g_object_notify (G_OBJECT (menu_item), "submenu");
477 * gtk_menu_item_get_submenu:
478 * @menu_item: a #GtkMenuItem
480 * Gets the submenu underneath this menu item, if any. See
481 * gtk_menu_item_set_submenu().
483 * Return value: submenu for this menu item, or %NULL if none.
486 gtk_menu_item_get_submenu (GtkMenuItem *menu_item)
488 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);
490 return menu_item->submenu;
494 * gtk_menu_item_remove_submenu:
495 * @menu_item: a #GtkMenuItem
497 * Removes the widget's submenu.
499 * Deprecated: 2.12: gtk_menu_item_remove_submenu() is deprecated and
500 * should not be used in newly written code. Use
501 * gtk_menu_item_set_submenu() instead.
504 gtk_menu_item_remove_submenu (GtkMenuItem *menu_item)
506 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
508 gtk_menu_item_set_submenu (menu_item, NULL);
511 void _gtk_menu_item_set_placement (GtkMenuItem *menu_item,
512 GtkSubmenuPlacement placement);
515 _gtk_menu_item_set_placement (GtkMenuItem *menu_item,
516 GtkSubmenuPlacement placement)
518 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
520 menu_item->submenu_placement = placement;
524 gtk_menu_item_select (GtkMenuItem *menu_item)
526 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
528 gtk_item_select (GTK_ITEM (menu_item));
530 /* Enable themeing of the parent menu item depending on whether
531 * something is selected in its submenu
533 if (GTK_IS_MENU (GTK_WIDGET (menu_item)->parent))
535 GtkMenu *menu = GTK_MENU (GTK_WIDGET (menu_item)->parent);
537 if (menu->parent_menu_item)
538 gtk_widget_queue_draw (GTK_WIDGET (menu->parent_menu_item));
543 gtk_menu_item_deselect (GtkMenuItem *menu_item)
545 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
547 gtk_item_deselect (GTK_ITEM (menu_item));
549 /* Enable themeing of the parent menu item depending on whether
550 * something is selected in its submenu
552 if (GTK_IS_MENU (GTK_WIDGET (menu_item)->parent))
554 GtkMenu *menu = GTK_MENU (GTK_WIDGET (menu_item)->parent);
556 if (menu->parent_menu_item)
557 gtk_widget_queue_draw (GTK_WIDGET (menu->parent_menu_item));
562 gtk_menu_item_activate (GtkMenuItem *menu_item)
564 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
566 g_signal_emit (menu_item, menu_item_signals[ACTIVATE], 0);
570 gtk_menu_item_toggle_size_request (GtkMenuItem *menu_item,
573 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
575 g_signal_emit (menu_item, menu_item_signals[TOGGLE_SIZE_REQUEST], 0, requisition);
579 gtk_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
582 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
584 g_signal_emit (menu_item, menu_item_signals[TOGGLE_SIZE_ALLOCATE], 0, allocation);
588 gtk_menu_item_accel_width_foreach (GtkWidget *widget,
593 if (GTK_IS_ACCEL_LABEL (widget))
597 w = gtk_accel_label_get_accel_width (GTK_ACCEL_LABEL (widget));
598 *width = MAX (*width, w);
600 else if (GTK_IS_CONTAINER (widget))
601 gtk_container_foreach (GTK_CONTAINER (widget),
602 gtk_menu_item_accel_width_foreach,
607 get_minimum_width (GtkWidget *widget)
609 PangoContext *context;
610 PangoFontMetrics *metrics;
614 context = gtk_widget_get_pango_context (widget);
615 metrics = pango_context_get_metrics (context,
616 widget->style->font_desc,
617 pango_context_get_language (context));
619 width = pango_font_metrics_get_approximate_char_width (metrics);
621 pango_font_metrics_unref (metrics);
623 gtk_widget_style_get (widget, "width-chars", &width_chars, NULL);
625 return PANGO_PIXELS (width_chars * width);
629 gtk_menu_item_size_request (GtkWidget *widget,
630 GtkRequisition *requisition)
632 GtkMenuItem *menu_item;
635 guint horizontal_padding;
636 GtkPackDirection pack_dir;
637 GtkPackDirection child_pack_dir;
639 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
640 g_return_if_fail (requisition != NULL);
642 gtk_widget_style_get (widget,
643 "horizontal-padding", &horizontal_padding,
646 bin = GTK_BIN (widget);
647 menu_item = GTK_MENU_ITEM (widget);
649 if (GTK_IS_MENU_BAR (widget->parent))
651 pack_dir = gtk_menu_bar_get_pack_direction (GTK_MENU_BAR (widget->parent));
652 child_pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (widget->parent));
656 pack_dir = GTK_PACK_DIRECTION_LTR;
657 child_pack_dir = GTK_PACK_DIRECTION_LTR;
660 requisition->width = (GTK_CONTAINER (widget)->border_width +
661 widget->style->xthickness) * 2;
662 requisition->height = (GTK_CONTAINER (widget)->border_width +
663 widget->style->ythickness) * 2;
665 if ((pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL) &&
666 (child_pack_dir == GTK_PACK_DIRECTION_LTR || child_pack_dir == GTK_PACK_DIRECTION_RTL))
667 requisition->width += 2 * horizontal_padding;
668 else if ((pack_dir == GTK_PACK_DIRECTION_TTB || pack_dir == GTK_PACK_DIRECTION_BTT) &&
669 (child_pack_dir == GTK_PACK_DIRECTION_TTB || child_pack_dir == GTK_PACK_DIRECTION_BTT))
670 requisition->height += 2 * horizontal_padding;
672 if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
674 GtkRequisition child_requisition;
676 gtk_widget_size_request (bin->child, &child_requisition);
678 requisition->width += child_requisition.width;
679 requisition->height += child_requisition.height;
681 if (menu_item->submenu && menu_item->show_submenu_indicator)
685 gtk_widget_style_get (widget,
686 "arrow-spacing", &arrow_spacing,
689 requisition->width += child_requisition.height;
690 requisition->width += arrow_spacing;
692 requisition->width = MAX (requisition->width, get_minimum_width (widget));
695 else /* separator item */
697 gboolean wide_separators;
698 gint separator_height;
700 gtk_widget_style_get (widget,
701 "wide-separators", &wide_separators,
702 "separator-height", &separator_height,
706 requisition->height += separator_height + widget->style->ythickness;
708 requisition->height += widget->style->ythickness * 2;
712 gtk_container_foreach (GTK_CONTAINER (menu_item),
713 gtk_menu_item_accel_width_foreach,
715 menu_item->accelerator_width = accel_width;
719 gtk_menu_item_size_allocate (GtkWidget *widget,
720 GtkAllocation *allocation)
722 GtkMenuItem *menu_item;
724 GtkAllocation child_allocation;
725 GtkTextDirection direction;
726 GtkPackDirection pack_dir;
727 GtkPackDirection child_pack_dir;
729 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
730 g_return_if_fail (allocation != NULL);
732 menu_item = GTK_MENU_ITEM (widget);
733 bin = GTK_BIN (widget);
735 direction = gtk_widget_get_direction (widget);
737 if (GTK_IS_MENU_BAR (widget->parent))
739 pack_dir = gtk_menu_bar_get_pack_direction (GTK_MENU_BAR (widget->parent));
740 child_pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (widget->parent));
744 pack_dir = GTK_PACK_DIRECTION_LTR;
745 child_pack_dir = GTK_PACK_DIRECTION_LTR;
748 widget->allocation = *allocation;
752 GtkRequisition child_requisition;
753 guint horizontal_padding;
755 gtk_widget_style_get (widget,
756 "horizontal-padding", &horizontal_padding,
759 child_allocation.x = GTK_CONTAINER (widget)->border_width + widget->style->xthickness;
760 child_allocation.y = GTK_CONTAINER (widget)->border_width + widget->style->ythickness;
762 if ((pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL) &&
763 (child_pack_dir == GTK_PACK_DIRECTION_LTR || child_pack_dir == GTK_PACK_DIRECTION_RTL))
764 child_allocation.x += horizontal_padding;
765 else if ((pack_dir == GTK_PACK_DIRECTION_TTB || pack_dir == GTK_PACK_DIRECTION_BTT) &&
766 (child_pack_dir == GTK_PACK_DIRECTION_TTB || child_pack_dir == GTK_PACK_DIRECTION_BTT))
767 child_allocation.y += horizontal_padding;
769 child_allocation.width = MAX (1, (gint)allocation->width - child_allocation.x * 2);
770 child_allocation.height = MAX (1, (gint)allocation->height - child_allocation.y * 2);
772 if (child_pack_dir == GTK_PACK_DIRECTION_LTR ||
773 child_pack_dir == GTK_PACK_DIRECTION_RTL)
775 if ((direction == GTK_TEXT_DIR_LTR) == (child_pack_dir != GTK_PACK_DIRECTION_RTL))
776 child_allocation.x += GTK_MENU_ITEM (widget)->toggle_size;
777 child_allocation.width -= GTK_MENU_ITEM (widget)->toggle_size;
781 if ((direction == GTK_TEXT_DIR_LTR) == (child_pack_dir != GTK_PACK_DIRECTION_BTT))
782 child_allocation.y += GTK_MENU_ITEM (widget)->toggle_size;
783 child_allocation.height -= GTK_MENU_ITEM (widget)->toggle_size;
786 child_allocation.x += widget->allocation.x;
787 child_allocation.y += widget->allocation.y;
789 gtk_widget_get_child_requisition (bin->child, &child_requisition);
790 if (menu_item->submenu && menu_item->show_submenu_indicator)
792 if (direction == GTK_TEXT_DIR_RTL)
793 child_allocation.x += child_requisition.height;
794 child_allocation.width -= child_requisition.height;
797 if (child_allocation.width < 1)
798 child_allocation.width = 1;
800 gtk_widget_size_allocate (bin->child, &child_allocation);
803 if (GTK_WIDGET_REALIZED (widget))
804 gdk_window_move_resize (menu_item->event_window,
805 allocation->x, allocation->y,
806 allocation->width, allocation->height);
808 if (menu_item->submenu)
809 gtk_menu_reposition (GTK_MENU (menu_item->submenu));
813 gtk_menu_item_realize (GtkWidget *widget)
815 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
816 GdkWindowAttr attributes;
817 gint attributes_mask;
819 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
821 widget->window = gtk_widget_get_parent_window (widget);
822 g_object_ref (widget->window);
824 attributes.x = widget->allocation.x;
825 attributes.y = widget->allocation.y;
826 attributes.width = widget->allocation.width;
827 attributes.height = widget->allocation.height;
828 attributes.window_type = GDK_WINDOW_CHILD;
829 attributes.wclass = GDK_INPUT_ONLY;
830 attributes.event_mask = (gtk_widget_get_events (widget) |
831 GDK_BUTTON_PRESS_MASK |
832 GDK_BUTTON_RELEASE_MASK |
833 GDK_ENTER_NOTIFY_MASK |
834 GDK_LEAVE_NOTIFY_MASK |
835 GDK_POINTER_MOTION_MASK);
837 attributes_mask = GDK_WA_X | GDK_WA_Y;
838 menu_item->event_window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, attributes_mask);
839 gdk_window_set_user_data (menu_item->event_window, widget);
841 widget->style = gtk_style_attach (widget->style, widget->window);
845 gtk_menu_item_unrealize (GtkWidget *widget)
847 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
849 gdk_window_set_user_data (menu_item->event_window, NULL);
850 gdk_window_destroy (menu_item->event_window);
851 menu_item->event_window = NULL;
853 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->unrealize (widget);
857 gtk_menu_item_map (GtkWidget *widget)
859 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
861 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->map (widget);
863 gdk_window_show (menu_item->event_window);
867 gtk_menu_item_unmap (GtkWidget *widget)
869 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
871 gdk_window_hide (menu_item->event_window);
873 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->unmap (widget);
877 gtk_menu_item_paint (GtkWidget *widget,
880 GtkMenuItem *menu_item;
881 GtkStateType state_type;
882 GtkShadowType shadow_type, selected_shadow_type;
885 gint border_width = GTK_CONTAINER (widget)->border_width;
887 if (GTK_WIDGET_DRAWABLE (widget))
889 menu_item = GTK_MENU_ITEM (widget);
891 state_type = widget->state;
893 x = widget->allocation.x + border_width;
894 y = widget->allocation.y + border_width;
895 width = widget->allocation.width - border_width * 2;
896 height = widget->allocation.height - border_width * 2;
898 if ((state_type == GTK_STATE_PRELIGHT) &&
899 (GTK_BIN (menu_item)->child))
901 gtk_widget_style_get (widget,
902 "selected-shadow-type", &selected_shadow_type,
904 gtk_paint_box (widget->style,
907 selected_shadow_type,
908 area, widget, "menuitem",
909 x, y, width, height);
912 if (menu_item->submenu && menu_item->show_submenu_indicator)
914 gint arrow_x, arrow_y;
917 guint horizontal_padding;
918 gfloat arrow_scaling;
919 GtkTextDirection direction;
920 GtkArrowType arrow_type;
921 PangoContext *context;
922 PangoFontMetrics *metrics;
924 direction = gtk_widget_get_direction (widget);
926 gtk_widget_style_get (widget,
927 "horizontal-padding", &horizontal_padding,
928 "arrow-scaling", &arrow_scaling,
931 context = gtk_widget_get_pango_context (GTK_BIN (menu_item)->child);
932 metrics = pango_context_get_metrics (context,
933 GTK_WIDGET (GTK_BIN (menu_item)->child)->style->font_desc,
934 pango_context_get_language (context));
936 arrow_size = (PANGO_PIXELS (pango_font_metrics_get_ascent (metrics) +
937 pango_font_metrics_get_descent (metrics)));
939 pango_font_metrics_unref (metrics);
941 arrow_extent = arrow_size * arrow_scaling;
943 shadow_type = GTK_SHADOW_OUT;
944 if (state_type == GTK_STATE_PRELIGHT)
945 shadow_type = GTK_SHADOW_IN;
947 if (direction == GTK_TEXT_DIR_LTR)
949 arrow_x = x + width - horizontal_padding - arrow_extent;
950 arrow_type = GTK_ARROW_RIGHT;
954 arrow_x = x + horizontal_padding;
955 arrow_type = GTK_ARROW_LEFT;
958 arrow_y = y + (height - arrow_extent) / 2;
960 gtk_paint_arrow (widget->style, widget->window,
961 state_type, shadow_type,
962 area, widget, "menuitem",
965 arrow_extent, arrow_extent);
967 else if (!GTK_BIN (menu_item)->child)
969 gboolean wide_separators;
970 gint separator_height;
971 guint horizontal_padding;
973 gtk_widget_style_get (widget,
974 "wide-separators", &wide_separators,
975 "separator-height", &separator_height,
976 "horizontal-padding", &horizontal_padding,
980 gtk_paint_box (widget->style, widget->window,
981 GTK_STATE_NORMAL, GTK_SHADOW_ETCHED_OUT,
982 area, widget, "hseparator",
983 widget->allocation.x + horizontal_padding + widget->style->xthickness,
984 widget->allocation.y + (widget->allocation.height -
986 widget->style->ythickness) / 2,
987 widget->allocation.width -
988 2 * (horizontal_padding + widget->style->xthickness),
991 gtk_paint_hline (widget->style, widget->window,
992 GTK_STATE_NORMAL, area, widget, "menuitem",
993 widget->allocation.x + horizontal_padding + widget->style->xthickness,
994 widget->allocation.x + widget->allocation.width - horizontal_padding - widget->style->xthickness - 1,
995 widget->allocation.y + (widget->allocation.height -
996 widget->style->ythickness) / 2);
1002 gtk_menu_item_expose (GtkWidget *widget,
1003 GdkEventExpose *event)
1005 g_return_val_if_fail (GTK_IS_MENU_ITEM (widget), FALSE);
1006 g_return_val_if_fail (event != NULL, FALSE);
1008 if (GTK_WIDGET_DRAWABLE (widget))
1010 gtk_menu_item_paint (widget, &event->area);
1012 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->expose_event (widget, event);
1019 gtk_real_menu_item_select (GtkItem *item)
1021 GtkMenuItem *menu_item;
1022 gboolean touchscreen_mode;
1024 g_return_if_fail (GTK_IS_MENU_ITEM (item));
1026 menu_item = GTK_MENU_ITEM (item);
1028 g_object_get (gtk_widget_get_settings (GTK_WIDGET (item)),
1029 "gtk-touchscreen-mode", &touchscreen_mode,
1032 if (!touchscreen_mode &&
1033 menu_item->submenu &&
1034 (!GTK_WIDGET_MAPPED (menu_item->submenu) ||
1035 GTK_MENU (menu_item->submenu)->tearoff_active))
1037 _gtk_menu_item_popup_submenu (GTK_WIDGET (menu_item), TRUE);
1040 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_PRELIGHT);
1041 gtk_widget_queue_draw (GTK_WIDGET (menu_item));
1045 gtk_real_menu_item_deselect (GtkItem *item)
1047 GtkMenuItem *menu_item;
1049 g_return_if_fail (GTK_IS_MENU_ITEM (item));
1051 menu_item = GTK_MENU_ITEM (item);
1053 if (menu_item->submenu)
1054 _gtk_menu_item_popdown_submenu (GTK_WIDGET (menu_item));
1056 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_NORMAL);
1057 gtk_widget_queue_draw (GTK_WIDGET (menu_item));
1061 gtk_menu_item_mnemonic_activate (GtkWidget *widget,
1062 gboolean group_cycling)
1064 if (group_cycling &&
1066 GTK_IS_MENU_SHELL (widget->parent) &&
1067 GTK_MENU_SHELL (widget->parent)->active)
1069 gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent),
1073 g_signal_emit (widget, menu_item_signals[ACTIVATE_ITEM], 0);
1079 gtk_real_menu_item_activate_item (GtkMenuItem *menu_item)
1083 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1085 widget = GTK_WIDGET (menu_item);
1087 if (widget->parent &&
1088 GTK_IS_MENU_SHELL (widget->parent))
1090 if (menu_item->submenu == NULL)
1091 gtk_menu_shell_activate_item (GTK_MENU_SHELL (widget->parent),
1095 GtkMenuShell *menu_shell = GTK_MENU_SHELL (widget->parent);
1097 _gtk_menu_shell_activate (menu_shell);
1099 gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent), widget);
1100 _gtk_menu_item_popup_submenu (widget, FALSE);
1102 gtk_menu_shell_select_first (GTK_MENU_SHELL (menu_item->submenu), TRUE);
1108 gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
1111 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1117 gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
1120 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1122 menu_item->toggle_size = allocation;
1126 free_timeval (GTimeVal *val)
1128 g_slice_free (GTimeVal, val);
1132 gtk_menu_item_real_popup_submenu (GtkWidget *widget,
1133 gboolean remember_exact_time)
1135 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1137 if (GTK_WIDGET_IS_SENSITIVE (menu_item->submenu) && widget->parent)
1139 gboolean take_focus;
1140 GtkMenuPositionFunc menu_position_func;
1142 take_focus = gtk_menu_shell_get_take_focus (GTK_MENU_SHELL (widget->parent));
1143 gtk_menu_shell_set_take_focus (GTK_MENU_SHELL (menu_item->submenu),
1146 if (remember_exact_time)
1148 GTimeVal *popup_time = g_slice_new0 (GTimeVal);
1150 g_get_current_time (popup_time);
1152 g_object_set_data_full (G_OBJECT (menu_item->submenu),
1153 "gtk-menu-exact-popup-time", popup_time,
1154 (GDestroyNotify) free_timeval);
1158 g_object_set_data (G_OBJECT (menu_item->submenu),
1159 "gtk-menu-exact-popup-time", NULL);
1162 /* gtk_menu_item_position_menu positions the submenu from the
1163 * menuitems position. If the menuitem doesn't have a window,
1164 * that doesn't work. In that case we use the default
1165 * positioning function instead which places the submenu at the
1169 menu_position_func = gtk_menu_item_position_menu;
1171 menu_position_func = NULL;
1173 gtk_menu_popup (GTK_MENU (menu_item->submenu),
1178 GTK_MENU_SHELL (widget->parent)->button,
1182 /* Enable themeing of the parent menu item depending on whether
1183 * its submenu is shown or not.
1185 gtk_widget_queue_draw (widget);
1189 gtk_menu_item_popup_timeout (gpointer data)
1191 GtkMenuItem *menu_item;
1194 menu_item = GTK_MENU_ITEM (data);
1196 parent = GTK_WIDGET (menu_item)->parent;
1198 if ((GTK_IS_MENU_SHELL (parent) && GTK_MENU_SHELL (parent)->active) ||
1199 (GTK_IS_MENU (parent) && GTK_MENU (parent)->torn_off))
1201 gtk_menu_item_real_popup_submenu (GTK_WIDGET (menu_item), TRUE);
1202 if (menu_item->timer_from_keypress && menu_item->submenu)
1203 GTK_MENU_SHELL (menu_item->submenu)->ignore_enter = TRUE;
1206 menu_item->timer = 0;
1212 get_popup_delay (GtkWidget *widget)
1214 if (GTK_IS_MENU_SHELL (widget->parent))
1216 return _gtk_menu_shell_get_popup_delay (GTK_MENU_SHELL (widget->parent));
1222 g_object_get (gtk_widget_get_settings (widget),
1223 "gtk-menu-popup-delay", &popup_delay,
1231 _gtk_menu_item_popup_submenu (GtkWidget *widget,
1232 gboolean with_delay)
1234 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1236 if (menu_item->timer)
1238 g_source_remove (menu_item->timer);
1239 menu_item->timer = 0;
1245 gint popup_delay = get_popup_delay (widget);
1247 if (popup_delay > 0)
1249 GdkEvent *event = gtk_get_current_event ();
1251 menu_item->timer = gdk_threads_add_timeout (popup_delay,
1252 gtk_menu_item_popup_timeout,
1256 event->type != GDK_BUTTON_PRESS &&
1257 event->type != GDK_ENTER_NOTIFY)
1258 menu_item->timer_from_keypress = TRUE;
1260 menu_item->timer_from_keypress = FALSE;
1263 gdk_event_free (event);
1269 gtk_menu_item_real_popup_submenu (widget, FALSE);
1273 _gtk_menu_item_popdown_submenu (GtkWidget *widget)
1275 GtkMenuItem *menu_item;
1277 menu_item = GTK_MENU_ITEM (widget);
1279 if (menu_item->submenu)
1281 g_object_set_data (G_OBJECT (menu_item->submenu),
1282 "gtk-menu-exact-popup-time", NULL);
1284 if (menu_item->timer)
1286 g_source_remove (menu_item->timer);
1287 menu_item->timer = 0;
1290 gtk_menu_popdown (GTK_MENU (menu_item->submenu));
1292 gtk_widget_queue_draw (widget);
1297 get_offsets (GtkMenu *menu,
1298 gint *horizontal_offset,
1299 gint *vertical_offset)
1301 gint vertical_padding;
1302 gint horizontal_padding;
1304 gtk_widget_style_get (GTK_WIDGET (menu),
1305 "horizontal-offset", horizontal_offset,
1306 "vertical-offset", vertical_offset,
1307 "horizontal-padding", &horizontal_padding,
1308 "vertical-padding", &vertical_padding,
1311 *vertical_offset -= GTK_WIDGET (menu)->style->ythickness;
1312 *vertical_offset -= vertical_padding;
1313 *horizontal_offset += horizontal_padding;
1317 gtk_menu_item_position_menu (GtkMenu *menu,
1323 GtkMenuItem *menu_item;
1325 GtkMenuItem *parent_menu_item;
1327 gint twidth, theight;
1329 GtkTextDirection direction;
1330 GdkRectangle monitor;
1332 gint horizontal_offset;
1333 gint vertical_offset;
1334 gint parent_xthickness;
1335 gint available_left, available_right;
1337 g_return_if_fail (menu != NULL);
1338 g_return_if_fail (x != NULL);
1339 g_return_if_fail (y != NULL);
1341 menu_item = GTK_MENU_ITEM (user_data);
1342 widget = GTK_WIDGET (user_data);
1347 direction = gtk_widget_get_direction (widget);
1349 twidth = GTK_WIDGET (menu)->requisition.width;
1350 theight = GTK_WIDGET (menu)->requisition.height;
1352 screen = gtk_widget_get_screen (GTK_WIDGET (menu));
1353 monitor_num = gdk_screen_get_monitor_at_window (screen, menu_item->event_window);
1354 if (monitor_num < 0)
1356 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
1358 if (!gdk_window_get_origin (widget->window, &tx, &ty))
1360 g_warning ("Menu not on screen");
1364 tx += widget->allocation.x;
1365 ty += widget->allocation.y;
1367 get_offsets (menu, &horizontal_offset, &vertical_offset);
1369 available_left = tx - monitor.x;
1370 available_right = monitor.x + monitor.width - (tx + widget->allocation.width);
1372 if (GTK_IS_MENU_BAR (widget->parent))
1374 menu_item->from_menubar = TRUE;
1376 else if (GTK_IS_MENU (widget->parent))
1378 if (GTK_MENU (widget->parent)->parent_menu_item)
1379 menu_item->from_menubar = GTK_MENU_ITEM (GTK_MENU (widget->parent)->parent_menu_item)->from_menubar;
1381 menu_item->from_menubar = FALSE;
1385 menu_item->from_menubar = FALSE;
1388 switch (menu_item->submenu_placement)
1390 case GTK_TOP_BOTTOM:
1391 if (direction == GTK_TEXT_DIR_LTR)
1392 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
1395 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
1396 tx += widget->allocation.width - twidth;
1398 if ((ty + widget->allocation.height + theight) <= monitor.y + monitor.height)
1399 ty += widget->allocation.height;
1400 else if ((ty - theight) >= monitor.y)
1402 else if (monitor.y + monitor.height - (ty + widget->allocation.height) > ty)
1403 ty += widget->allocation.height;
1408 case GTK_LEFT_RIGHT:
1409 if (GTK_IS_MENU (widget->parent))
1410 parent_menu_item = GTK_MENU_ITEM (GTK_MENU (widget->parent)->parent_menu_item);
1412 parent_menu_item = NULL;
1414 parent_xthickness = widget->parent->style->xthickness;
1416 if (parent_menu_item && !GTK_MENU (widget->parent)->torn_off)
1418 menu_item->submenu_direction = parent_menu_item->submenu_direction;
1422 if (direction == GTK_TEXT_DIR_LTR)
1423 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
1425 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
1428 switch (menu_item->submenu_direction)
1430 case GTK_DIRECTION_LEFT:
1431 if (tx - twidth - parent_xthickness - horizontal_offset >= monitor.x ||
1432 available_left >= available_right)
1433 tx -= twidth + parent_xthickness + horizontal_offset;
1436 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
1437 tx += widget->allocation.width + parent_xthickness + horizontal_offset;
1441 case GTK_DIRECTION_RIGHT:
1442 if (tx + widget->allocation.width + parent_xthickness + horizontal_offset + twidth <= monitor.x + monitor.width ||
1443 available_right >= available_left)
1444 tx += widget->allocation.width + parent_xthickness + horizontal_offset;
1447 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
1448 tx -= twidth + parent_xthickness + horizontal_offset;
1453 ty += vertical_offset;
1455 /* If the height of the menu doesn't fit we move it upward. */
1456 ty = CLAMP (ty, monitor.y, MAX (monitor.y, monitor.y + monitor.height - theight));
1460 /* If we have negative, tx, here it is because we can't get
1461 * the menu all the way on screen. Favor the left portion.
1463 *x = CLAMP (tx, monitor.x, MAX (monitor.x, monitor.x + monitor.width - twidth));
1466 gtk_menu_set_monitor (menu, monitor_num);
1468 if (!GTK_WIDGET_VISIBLE (menu->toplevel))
1470 gtk_window_set_type_hint (GTK_WINDOW (menu->toplevel), menu_item->from_menubar?
1471 GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU : GDK_WINDOW_TYPE_HINT_POPUP_MENU);
1476 * gtk_menu_item_set_right_justified:
1477 * @menu_item: a #GtkMenuItem.
1478 * @right_justified: if %TRUE the menu item will appear at the
1479 * far right if added to a menu bar.
1481 * Sets whether the menu item appears justified at the right
1482 * side of a menu bar. This was traditionally done for "Help" menu
1483 * items, but is now considered a bad idea. (If the widget
1484 * layout is reversed for a right-to-left language like Hebrew
1485 * or Arabic, right-justified-menu-items appear at the left.)
1488 gtk_menu_item_set_right_justified (GtkMenuItem *menu_item,
1489 gboolean right_justified)
1491 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1493 right_justified = right_justified != FALSE;
1495 if (right_justified != menu_item->right_justify)
1497 menu_item->right_justify = right_justified;
1498 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
1503 * gtk_menu_item_get_right_justified:
1504 * @menu_item: a #GtkMenuItem
1506 * Gets whether the menu item appears justified at the right
1507 * side of the menu bar.
1509 * Return value: %TRUE if the menu item will appear at the
1510 * far right if added to a menu bar.
1513 gtk_menu_item_get_right_justified (GtkMenuItem *menu_item)
1515 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), FALSE);
1517 return menu_item->right_justify;
1522 gtk_menu_item_show_all (GtkWidget *widget)
1524 GtkMenuItem *menu_item;
1526 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
1528 menu_item = GTK_MENU_ITEM (widget);
1530 /* show children including submenu */
1531 if (menu_item->submenu)
1532 gtk_widget_show_all (menu_item->submenu);
1533 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_show_all, NULL);
1535 gtk_widget_show (widget);
1539 gtk_menu_item_hide_all (GtkWidget *widget)
1541 GtkMenuItem *menu_item;
1543 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
1545 gtk_widget_hide (widget);
1547 menu_item = GTK_MENU_ITEM (widget);
1549 /* hide children including submenu */
1550 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_hide_all, NULL);
1551 if (menu_item->submenu)
1552 gtk_widget_hide_all (menu_item->submenu);
1556 gtk_menu_item_can_activate_accel (GtkWidget *widget,
1559 /* Chain to the parent GtkMenu for further checks */
1560 return (GTK_WIDGET_IS_SENSITIVE (widget) && GTK_WIDGET_VISIBLE (widget) &&
1561 widget->parent && gtk_widget_can_activate_accel (widget->parent, signal_id));
1565 gtk_menu_item_accel_name_foreach (GtkWidget *widget,
1568 const gchar **path_p = data;
1572 if (GTK_IS_LABEL (widget))
1574 *path_p = gtk_label_get_text (GTK_LABEL (widget));
1575 if (*path_p && (*path_p)[0] == 0)
1578 else if (GTK_IS_CONTAINER (widget))
1579 gtk_container_foreach (GTK_CONTAINER (widget),
1580 gtk_menu_item_accel_name_foreach,
1586 gtk_menu_item_parent_set (GtkWidget *widget,
1587 GtkWidget *previous_parent)
1589 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1590 GtkMenu *menu = GTK_IS_MENU (widget->parent) ? GTK_MENU (widget->parent) : NULL;
1593 _gtk_menu_item_refresh_accel_path (menu_item,
1598 if (GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->parent_set)
1599 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->parent_set (widget, previous_parent);
1603 _gtk_menu_item_refresh_accel_path (GtkMenuItem *menu_item,
1604 const gchar *prefix,
1605 GtkAccelGroup *accel_group,
1606 gboolean group_changed)
1611 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1612 g_return_if_fail (!accel_group || GTK_IS_ACCEL_GROUP (accel_group));
1614 widget = GTK_WIDGET (menu_item);
1618 gtk_widget_set_accel_path (widget, NULL, NULL);
1622 path = _gtk_widget_get_accel_path (widget, NULL);
1623 if (!path) /* no active accel_path yet */
1625 path = menu_item->accel_path;
1626 if (!path && prefix)
1628 const gchar *postfix = NULL;
1631 /* try to construct one from label text */
1632 gtk_container_foreach (GTK_CONTAINER (menu_item),
1633 gtk_menu_item_accel_name_foreach,
1637 new_path = g_strconcat (prefix, "/", postfix, NULL);
1638 path = menu_item->accel_path = (char*)g_intern_string (new_path);
1643 gtk_widget_set_accel_path (widget, path, accel_group);
1645 else if (group_changed) /* reinstall accelerators */
1646 gtk_widget_set_accel_path (widget, path, accel_group);
1650 * gtk_menu_item_set_accel_path
1651 * @menu_item: a valid #GtkMenuItem
1652 * @accel_path: accelerator path, corresponding to this menu item's
1653 * functionality, or %NULL to unset the current path.
1655 * Set the accelerator path on @menu_item, through which runtime changes of the
1656 * menu item's accelerator caused by the user can be identified and saved to
1657 * persistant storage (see gtk_accel_map_save() on this).
1658 * To setup a default accelerator for this menu item, call
1659 * gtk_accel_map_add_entry() with the same @accel_path.
1660 * See also gtk_accel_map_add_entry() on the specifics of accelerator paths,
1661 * and gtk_menu_set_accel_path() for a more convenient variant of this function.
1663 * This function is basically a convenience wrapper that handles calling
1664 * gtk_widget_set_accel_path() with the appropriate accelerator group for
1667 * Note that you do need to set an accelerator on the parent menu with
1668 * gtk_menu_set_accel_group() for this to work.
1670 * Note that @accel_path string will be stored in a #GQuark. Therefore, if you
1671 * pass a static string, you can save some memory by interning it first with
1672 * g_intern_static_string().
1675 gtk_menu_item_set_accel_path (GtkMenuItem *menu_item,
1676 const gchar *accel_path)
1680 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1681 g_return_if_fail (accel_path == NULL ||
1682 (accel_path[0] == '<' && strchr (accel_path, '/')));
1684 widget = GTK_WIDGET (menu_item);
1686 /* store new path */
1687 menu_item->accel_path = (char*)g_intern_string (accel_path);
1689 /* forget accelerators associated with old path */
1690 gtk_widget_set_accel_path (widget, NULL, NULL);
1692 /* install accelerators associated with new path */
1693 if (GTK_IS_MENU (widget->parent))
1695 GtkMenu *menu = GTK_MENU (widget->parent);
1697 if (menu->accel_group)
1698 _gtk_menu_item_refresh_accel_path (GTK_MENU_ITEM (widget),
1706 * gtk_menu_item_get_accel_path
1707 * @menu_item: a valid #GtkMenuItem
1709 * Retrieve the accelerator path that was previously set on @menu_item.
1711 * See gtk_menu_item_set_accel_path() for details.
1713 * Returns: the accelerator path corresponding to this menu item's
1714 * functionality, or %NULL if not set
1718 G_CONST_RETURN gchar *
1719 gtk_menu_item_get_accel_path (GtkMenuItem *menu_item)
1721 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);
1723 return menu_item->accel_path;
1727 gtk_menu_item_forall (GtkContainer *container,
1728 gboolean include_internals,
1729 GtkCallback callback,
1730 gpointer callback_data)
1734 g_return_if_fail (GTK_IS_MENU_ITEM (container));
1735 g_return_if_fail (callback != NULL);
1737 bin = GTK_BIN (container);
1740 callback (bin->child, callback_data);
1744 _gtk_menu_item_is_selectable (GtkWidget *menu_item)
1746 if ((!GTK_BIN (menu_item)->child &&
1747 G_OBJECT_TYPE (menu_item) == GTK_TYPE_MENU_ITEM) ||
1748 GTK_IS_SEPARATOR_MENU_ITEM (menu_item) ||
1749 !GTK_WIDGET_IS_SENSITIVE (menu_item) ||
1750 !GTK_WIDGET_VISIBLE (menu_item))
1756 #define __GTK_MENU_ITEM_C__
1757 #include "gtkaliasdef.c"