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 "gtkmenuitem.h"
38 #include "gtkseparatormenuitem.h"
39 #include "gtkprivate.h"
43 #define MENU_ITEM_CLASS(w) GTK_MENU_ITEM_CLASS (GTK_OBJECT (w)->klass)
61 static void gtk_menu_item_set_property (GObject *object,
65 static void gtk_menu_item_get_property (GObject *object,
69 static void gtk_menu_item_destroy (GtkObject *object);
70 static void gtk_menu_item_size_request (GtkWidget *widget,
71 GtkRequisition *requisition);
72 static void gtk_menu_item_size_allocate (GtkWidget *widget,
73 GtkAllocation *allocation);
74 static void gtk_menu_item_realize (GtkWidget *widget);
75 static void gtk_menu_item_unrealize (GtkWidget *widget);
76 static void gtk_menu_item_map (GtkWidget *widget);
77 static void gtk_menu_item_unmap (GtkWidget *widget);
78 static void gtk_menu_item_paint (GtkWidget *widget,
80 static gint gtk_menu_item_expose (GtkWidget *widget,
81 GdkEventExpose *event);
82 static void gtk_menu_item_parent_set (GtkWidget *widget,
83 GtkWidget *previous_parent);
86 static void gtk_real_menu_item_select (GtkItem *item);
87 static void gtk_real_menu_item_deselect (GtkItem *item);
88 static void gtk_real_menu_item_activate_item (GtkMenuItem *item);
89 static void gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
91 static void gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
93 static gboolean gtk_menu_item_mnemonic_activate (GtkWidget *widget,
94 gboolean group_cycling);
96 static gint gtk_menu_item_popup_timeout (gpointer data);
97 static void gtk_menu_item_position_menu (GtkMenu *menu,
102 static void gtk_menu_item_show_all (GtkWidget *widget);
103 static void gtk_menu_item_hide_all (GtkWidget *widget);
104 static void gtk_menu_item_forall (GtkContainer *container,
105 gboolean include_internals,
106 GtkCallback callback,
107 gpointer callback_data);
108 static gboolean gtk_menu_item_can_activate_accel (GtkWidget *widget,
112 static guint menu_item_signals[LAST_SIGNAL] = { 0 };
114 G_DEFINE_TYPE (GtkMenuItem, gtk_menu_item, GTK_TYPE_ITEM)
117 gtk_menu_item_class_init (GtkMenuItemClass *klass)
119 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
120 GtkObjectClass *object_class = GTK_OBJECT_CLASS (klass);
121 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
122 GtkContainerClass *container_class = GTK_CONTAINER_CLASS (klass);
123 GtkItemClass *item_class = GTK_ITEM_CLASS (klass);
125 gobject_class->set_property = gtk_menu_item_set_property;
126 gobject_class->get_property = gtk_menu_item_get_property;
128 object_class->destroy = gtk_menu_item_destroy;
130 widget_class->size_request = gtk_menu_item_size_request;
131 widget_class->size_allocate = gtk_menu_item_size_allocate;
132 widget_class->expose_event = gtk_menu_item_expose;
133 widget_class->realize = gtk_menu_item_realize;
134 widget_class->unrealize = gtk_menu_item_unrealize;
135 widget_class->map = gtk_menu_item_map;
136 widget_class->unmap = gtk_menu_item_unmap;
137 widget_class->show_all = gtk_menu_item_show_all;
138 widget_class->hide_all = gtk_menu_item_hide_all;
139 widget_class->mnemonic_activate = gtk_menu_item_mnemonic_activate;
140 widget_class->parent_set = gtk_menu_item_parent_set;
141 widget_class->can_activate_accel = gtk_menu_item_can_activate_accel;
143 container_class->forall = gtk_menu_item_forall;
145 item_class->select = gtk_real_menu_item_select;
146 item_class->deselect = gtk_real_menu_item_deselect;
148 klass->activate = NULL;
149 klass->activate_item = gtk_real_menu_item_activate_item;
150 klass->toggle_size_request = gtk_real_menu_item_toggle_size_request;
151 klass->toggle_size_allocate = gtk_real_menu_item_toggle_size_allocate;
153 klass->hide_on_activate = TRUE;
155 menu_item_signals[ACTIVATE] =
156 g_signal_new (I_("activate"),
157 G_OBJECT_CLASS_TYPE (gobject_class),
158 G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
159 G_STRUCT_OFFSET (GtkMenuItemClass, activate),
161 _gtk_marshal_VOID__VOID,
163 widget_class->activate_signal = menu_item_signals[ACTIVATE];
165 menu_item_signals[ACTIVATE_ITEM] =
166 g_signal_new (I_("activate-item"),
167 G_OBJECT_CLASS_TYPE (gobject_class),
169 G_STRUCT_OFFSET (GtkMenuItemClass, activate_item),
171 _gtk_marshal_VOID__VOID,
174 menu_item_signals[TOGGLE_SIZE_REQUEST] =
175 g_signal_new (I_("toggle-size-request"),
176 G_OBJECT_CLASS_TYPE (gobject_class),
178 G_STRUCT_OFFSET (GtkMenuItemClass, toggle_size_request),
180 _gtk_marshal_VOID__POINTER,
184 menu_item_signals[TOGGLE_SIZE_ALLOCATE] =
185 g_signal_new (I_("toggle-size-allocate"),
186 G_OBJECT_CLASS_TYPE (gobject_class),
188 G_STRUCT_OFFSET (GtkMenuItemClass, toggle_size_allocate),
190 _gtk_marshal_VOID__INT,
195 * GtkMenuItem:right-justified:
197 * Sets whether the menu item appears justified at the right side of a menu bar.
201 g_object_class_install_property (gobject_class,
202 PROP_RIGHT_JUSTIFIED,
203 g_param_spec_boolean ("right-justified",
204 P_("Right Justified"),
205 P_("Sets whether the menu item appears justified at the right side of a menu bar"),
207 GTK_PARAM_READWRITE));
210 * GtkMenuItem:submenu:
212 * The submenu attached to the menu item, or NULL if it has none.
216 g_object_class_install_property (gobject_class,
218 g_param_spec_object ("submenu",
220 P_("The submenu attached to the menu item, or NULL if it has none"),
222 GTK_PARAM_READWRITE));
225 * GtkMenuItem:accel-path:
227 * Sets the accelerator path of the menu item, through which runtime
228 * changes of the menu item's accelerator caused by the user can be
229 * identified and saved to persistant storage.
233 g_object_class_install_property (gobject_class,
235 g_param_spec_string ("accel-path",
237 P_("Sets the accelerator path of the menu item"),
239 GTK_PARAM_READWRITE));
241 gtk_widget_class_install_style_property_parser (widget_class,
242 g_param_spec_enum ("selected-shadow-type",
243 "Selected Shadow Type",
244 "Shadow type when item is selected",
245 GTK_TYPE_SHADOW_TYPE,
248 gtk_rc_property_parse_enum);
250 gtk_widget_class_install_style_property (widget_class,
251 g_param_spec_int ("horizontal-padding",
252 "Horizontal Padding",
253 "Padding to left and right of the menu item",
257 GTK_PARAM_READABLE));
259 gtk_widget_class_install_style_property (widget_class,
260 g_param_spec_int ("toggle-spacing",
262 "Space between icon and label",
266 GTK_PARAM_READABLE));
268 gtk_widget_class_install_style_property (widget_class,
269 g_param_spec_int ("arrow-spacing",
271 "Space between label and arrow",
275 GTK_PARAM_READABLE));
277 gtk_widget_class_install_style_property (widget_class,
278 g_param_spec_float ("arrow-scaling",
280 P_("Amount of space used up by arrow, relative to the menu item's font size"),
282 GTK_PARAM_READABLE));
285 * GtkMenuItem:width-chars:
287 * The minimum desired width of the menu item in characters.
291 gtk_widget_class_install_style_property (widget_class,
292 g_param_spec_int ("width-chars",
293 P_("Width in Characters"),
294 P_("The minimum desired width of the menu item in characters"),
296 GTK_PARAM_READABLE));
300 gtk_menu_item_init (GtkMenuItem *menu_item)
302 GTK_WIDGET_SET_FLAGS (menu_item, GTK_NO_WINDOW);
304 menu_item->submenu = NULL;
305 menu_item->toggle_size = 0;
306 menu_item->accelerator_width = 0;
307 menu_item->show_submenu_indicator = FALSE;
308 if (gtk_widget_get_direction (GTK_WIDGET (menu_item)) == GTK_TEXT_DIR_RTL)
309 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
311 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
312 menu_item->submenu_placement = GTK_TOP_BOTTOM;
313 menu_item->right_justify = FALSE;
315 menu_item->timer = 0;
319 gtk_menu_item_new (void)
321 return g_object_new (GTK_TYPE_MENU_ITEM, NULL);
325 gtk_menu_item_new_with_label (const gchar *label)
327 GtkWidget *menu_item;
328 GtkWidget *accel_label;
330 menu_item = gtk_menu_item_new ();
331 accel_label = gtk_accel_label_new (label);
332 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
334 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
335 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
336 gtk_widget_show (accel_label);
343 * gtk_menu_item_new_with_mnemonic:
344 * @label: The text of the button, with an underscore in front of the
346 * @returns: a new #GtkMenuItem
348 * Creates a new #GtkMenuItem containing a label. The label
349 * will be created using gtk_label_new_with_mnemonic(), so underscores
350 * in @label indicate the mnemonic for the menu item.
353 gtk_menu_item_new_with_mnemonic (const gchar *label)
355 GtkWidget *menu_item;
356 GtkWidget *accel_label;
358 menu_item = gtk_menu_item_new ();
359 accel_label = g_object_new (GTK_TYPE_ACCEL_LABEL, NULL);
360 gtk_label_set_text_with_mnemonic (GTK_LABEL (accel_label), label);
361 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
363 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
364 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
365 gtk_widget_show (accel_label);
371 gtk_menu_item_set_property (GObject *object,
376 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
380 case PROP_RIGHT_JUSTIFIED:
381 gtk_menu_item_set_right_justified (menu_item, g_value_get_boolean (value));
384 gtk_menu_item_set_submenu (menu_item, g_value_get_object (value));
386 case PROP_ACCEL_PATH:
387 gtk_menu_item_set_accel_path (menu_item, g_value_get_string (value));
391 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
397 gtk_menu_item_get_property (GObject *object,
402 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
406 case PROP_RIGHT_JUSTIFIED:
407 g_value_set_boolean (value, gtk_menu_item_get_right_justified (menu_item));
410 g_value_set_object (value, gtk_menu_item_get_submenu (menu_item));
412 case PROP_ACCEL_PATH:
413 g_value_set_string (value, gtk_menu_item_get_accel_path (menu_item));
417 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
423 gtk_menu_item_destroy (GtkObject *object)
425 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
427 if (menu_item->submenu)
428 gtk_widget_destroy (menu_item->submenu);
430 GTK_OBJECT_CLASS (gtk_menu_item_parent_class)->destroy (object);
434 gtk_menu_item_detacher (GtkWidget *widget,
437 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
439 g_return_if_fail (menu_item->submenu == (GtkWidget*) menu);
441 menu_item->submenu = NULL;
445 * gtk_menu_item_set_submenu:
446 * @menu_item: a #GtkMenuItem
447 * @submenu: the submenu, or %NULL
449 * Sets or replaces the menu item's submenu, or removes it when a %NULL
453 gtk_menu_item_set_submenu (GtkMenuItem *menu_item,
456 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
457 g_return_if_fail (submenu == NULL || GTK_IS_MENU (submenu));
459 if (menu_item->submenu != submenu)
461 if (menu_item->submenu)
462 gtk_menu_detach (GTK_MENU (menu_item->submenu));
466 menu_item->submenu = submenu;
467 gtk_menu_attach_to_widget (GTK_MENU (submenu),
468 GTK_WIDGET (menu_item),
469 gtk_menu_item_detacher);
472 if (GTK_WIDGET (menu_item)->parent)
473 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
475 g_object_notify (G_OBJECT (menu_item), "submenu");
480 * gtk_menu_item_get_submenu:
481 * @menu_item: a #GtkMenuItem
483 * Gets the submenu underneath this menu item, if any. See
484 * gtk_menu_item_set_submenu().
486 * Return value: submenu for this menu item, or %NULL if none.
489 gtk_menu_item_get_submenu (GtkMenuItem *menu_item)
491 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);
493 return menu_item->submenu;
497 * gtk_menu_item_remove_submenu:
498 * @menu_item: a #GtkMenuItem
500 * Removes the widget's submenu.
502 * Deprecated: 2.12: gtk_menu_item_remove_submenu() is deprecated and
503 * should not be used in newly written code. Use
504 * gtk_menu_item_set_submenu() instead.
507 gtk_menu_item_remove_submenu (GtkMenuItem *menu_item)
509 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
511 gtk_menu_item_set_submenu (menu_item, NULL);
514 void _gtk_menu_item_set_placement (GtkMenuItem *menu_item,
515 GtkSubmenuPlacement placement);
518 _gtk_menu_item_set_placement (GtkMenuItem *menu_item,
519 GtkSubmenuPlacement placement)
521 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
523 menu_item->submenu_placement = placement;
527 gtk_menu_item_select (GtkMenuItem *menu_item)
529 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
531 gtk_item_select (GTK_ITEM (menu_item));
533 /* Enable themeing of the parent menu item depending on whether
534 * something is selected in its submenu
536 if (GTK_IS_MENU (GTK_WIDGET (menu_item)->parent))
538 GtkMenu *menu = GTK_MENU (GTK_WIDGET (menu_item)->parent);
540 if (menu->parent_menu_item)
541 gtk_widget_queue_draw (GTK_WIDGET (menu->parent_menu_item));
546 gtk_menu_item_deselect (GtkMenuItem *menu_item)
548 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
550 gtk_item_deselect (GTK_ITEM (menu_item));
552 /* Enable themeing of the parent menu item depending on whether
553 * something is selected in its submenu
555 if (GTK_IS_MENU (GTK_WIDGET (menu_item)->parent))
557 GtkMenu *menu = GTK_MENU (GTK_WIDGET (menu_item)->parent);
559 if (menu->parent_menu_item)
560 gtk_widget_queue_draw (GTK_WIDGET (menu->parent_menu_item));
565 gtk_menu_item_activate (GtkMenuItem *menu_item)
567 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
569 g_signal_emit (menu_item, menu_item_signals[ACTIVATE], 0);
573 gtk_menu_item_toggle_size_request (GtkMenuItem *menu_item,
576 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
578 g_signal_emit (menu_item, menu_item_signals[TOGGLE_SIZE_REQUEST], 0, requisition);
582 gtk_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
585 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
587 g_signal_emit (menu_item, menu_item_signals[TOGGLE_SIZE_ALLOCATE], 0, allocation);
591 gtk_menu_item_accel_width_foreach (GtkWidget *widget,
596 if (GTK_IS_ACCEL_LABEL (widget))
600 w = gtk_accel_label_get_accel_width (GTK_ACCEL_LABEL (widget));
601 *width = MAX (*width, w);
603 else if (GTK_IS_CONTAINER (widget))
604 gtk_container_foreach (GTK_CONTAINER (widget),
605 gtk_menu_item_accel_width_foreach,
610 get_minimum_width (GtkWidget *widget)
612 PangoContext *context;
613 PangoFontMetrics *metrics;
617 context = gtk_widget_get_pango_context (widget);
618 metrics = pango_context_get_metrics (context,
619 widget->style->font_desc,
620 pango_context_get_language (context));
622 width = pango_font_metrics_get_approximate_char_width (metrics);
624 pango_font_metrics_unref (metrics);
626 gtk_widget_style_get (widget, "width-chars", &width_chars, NULL);
628 return PANGO_PIXELS (width_chars * width);
632 gtk_menu_item_size_request (GtkWidget *widget,
633 GtkRequisition *requisition)
635 GtkMenuItem *menu_item;
638 guint horizontal_padding;
639 GtkPackDirection pack_dir;
640 GtkPackDirection child_pack_dir;
642 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
643 g_return_if_fail (requisition != NULL);
645 gtk_widget_style_get (widget,
646 "horizontal-padding", &horizontal_padding,
649 bin = GTK_BIN (widget);
650 menu_item = GTK_MENU_ITEM (widget);
652 if (GTK_IS_MENU_BAR (widget->parent))
654 pack_dir = gtk_menu_bar_get_pack_direction (GTK_MENU_BAR (widget->parent));
655 child_pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (widget->parent));
659 pack_dir = GTK_PACK_DIRECTION_LTR;
660 child_pack_dir = GTK_PACK_DIRECTION_LTR;
663 requisition->width = (GTK_CONTAINER (widget)->border_width +
664 widget->style->xthickness) * 2;
665 requisition->height = (GTK_CONTAINER (widget)->border_width +
666 widget->style->ythickness) * 2;
668 if ((pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL) &&
669 (child_pack_dir == GTK_PACK_DIRECTION_LTR || child_pack_dir == GTK_PACK_DIRECTION_RTL))
670 requisition->width += 2 * horizontal_padding;
671 else if ((pack_dir == GTK_PACK_DIRECTION_TTB || pack_dir == GTK_PACK_DIRECTION_BTT) &&
672 (child_pack_dir == GTK_PACK_DIRECTION_TTB || child_pack_dir == GTK_PACK_DIRECTION_BTT))
673 requisition->height += 2 * horizontal_padding;
675 if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
677 GtkRequisition child_requisition;
679 gtk_widget_size_request (bin->child, &child_requisition);
681 requisition->width += child_requisition.width;
682 requisition->height += child_requisition.height;
684 if (menu_item->submenu && menu_item->show_submenu_indicator)
688 gtk_widget_style_get (widget,
689 "arrow-spacing", &arrow_spacing,
692 requisition->width += child_requisition.height;
693 requisition->width += arrow_spacing;
695 requisition->width = MAX (requisition->width, get_minimum_width (widget));
698 else /* separator item */
700 gboolean wide_separators;
701 gint separator_height;
703 gtk_widget_style_get (widget,
704 "wide-separators", &wide_separators,
705 "separator-height", &separator_height,
709 requisition->height += separator_height + widget->style->ythickness;
711 requisition->height += widget->style->ythickness * 2;
715 gtk_container_foreach (GTK_CONTAINER (menu_item),
716 gtk_menu_item_accel_width_foreach,
718 menu_item->accelerator_width = accel_width;
722 gtk_menu_item_size_allocate (GtkWidget *widget,
723 GtkAllocation *allocation)
725 GtkMenuItem *menu_item;
727 GtkAllocation child_allocation;
728 GtkTextDirection direction;
729 GtkPackDirection pack_dir;
730 GtkPackDirection child_pack_dir;
732 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
733 g_return_if_fail (allocation != NULL);
735 menu_item = GTK_MENU_ITEM (widget);
736 bin = GTK_BIN (widget);
738 direction = gtk_widget_get_direction (widget);
740 if (GTK_IS_MENU_BAR (widget->parent))
742 pack_dir = gtk_menu_bar_get_pack_direction (GTK_MENU_BAR (widget->parent));
743 child_pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (widget->parent));
747 pack_dir = GTK_PACK_DIRECTION_LTR;
748 child_pack_dir = GTK_PACK_DIRECTION_LTR;
751 widget->allocation = *allocation;
755 GtkRequisition child_requisition;
756 guint horizontal_padding;
758 gtk_widget_style_get (widget,
759 "horizontal-padding", &horizontal_padding,
762 child_allocation.x = GTK_CONTAINER (widget)->border_width + widget->style->xthickness;
763 child_allocation.y = GTK_CONTAINER (widget)->border_width + widget->style->ythickness;
765 if ((pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL) &&
766 (child_pack_dir == GTK_PACK_DIRECTION_LTR || child_pack_dir == GTK_PACK_DIRECTION_RTL))
767 child_allocation.x += horizontal_padding;
768 else if ((pack_dir == GTK_PACK_DIRECTION_TTB || pack_dir == GTK_PACK_DIRECTION_BTT) &&
769 (child_pack_dir == GTK_PACK_DIRECTION_TTB || child_pack_dir == GTK_PACK_DIRECTION_BTT))
770 child_allocation.y += horizontal_padding;
772 child_allocation.width = MAX (1, (gint)allocation->width - child_allocation.x * 2);
773 child_allocation.height = MAX (1, (gint)allocation->height - child_allocation.y * 2);
775 if (child_pack_dir == GTK_PACK_DIRECTION_LTR ||
776 child_pack_dir == GTK_PACK_DIRECTION_RTL)
778 if ((direction == GTK_TEXT_DIR_LTR) == (child_pack_dir != GTK_PACK_DIRECTION_RTL))
779 child_allocation.x += GTK_MENU_ITEM (widget)->toggle_size;
780 child_allocation.width -= GTK_MENU_ITEM (widget)->toggle_size;
784 if ((direction == GTK_TEXT_DIR_LTR) == (child_pack_dir != GTK_PACK_DIRECTION_BTT))
785 child_allocation.y += GTK_MENU_ITEM (widget)->toggle_size;
786 child_allocation.height -= GTK_MENU_ITEM (widget)->toggle_size;
789 child_allocation.x += widget->allocation.x;
790 child_allocation.y += widget->allocation.y;
792 gtk_widget_get_child_requisition (bin->child, &child_requisition);
793 if (menu_item->submenu && menu_item->show_submenu_indicator)
795 if (direction == GTK_TEXT_DIR_RTL)
796 child_allocation.x += child_requisition.height;
797 child_allocation.width -= child_requisition.height;
800 if (child_allocation.width < 1)
801 child_allocation.width = 1;
803 gtk_widget_size_allocate (bin->child, &child_allocation);
806 if (GTK_WIDGET_REALIZED (widget))
807 gdk_window_move_resize (menu_item->event_window,
808 allocation->x, allocation->y,
809 allocation->width, allocation->height);
811 if (menu_item->submenu)
812 gtk_menu_reposition (GTK_MENU (menu_item->submenu));
816 gtk_menu_item_realize (GtkWidget *widget)
818 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
819 GdkWindowAttr attributes;
820 gint attributes_mask;
822 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
824 widget->window = gtk_widget_get_parent_window (widget);
825 g_object_ref (widget->window);
827 attributes.x = widget->allocation.x;
828 attributes.y = widget->allocation.y;
829 attributes.width = widget->allocation.width;
830 attributes.height = widget->allocation.height;
831 attributes.window_type = GDK_WINDOW_CHILD;
832 attributes.wclass = GDK_INPUT_ONLY;
833 attributes.event_mask = (gtk_widget_get_events (widget) |
834 GDK_BUTTON_PRESS_MASK |
835 GDK_BUTTON_RELEASE_MASK |
836 GDK_ENTER_NOTIFY_MASK |
837 GDK_LEAVE_NOTIFY_MASK |
838 GDK_POINTER_MOTION_MASK);
840 attributes_mask = GDK_WA_X | GDK_WA_Y;
841 menu_item->event_window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, attributes_mask);
842 gdk_window_set_user_data (menu_item->event_window, widget);
844 widget->style = gtk_style_attach (widget->style, widget->window);
848 gtk_menu_item_unrealize (GtkWidget *widget)
850 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
852 gdk_window_set_user_data (menu_item->event_window, NULL);
853 gdk_window_destroy (menu_item->event_window);
854 menu_item->event_window = NULL;
856 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->unrealize (widget);
860 gtk_menu_item_map (GtkWidget *widget)
862 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
864 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->map (widget);
866 gdk_window_show (menu_item->event_window);
870 gtk_menu_item_unmap (GtkWidget *widget)
872 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
874 gdk_window_hide (menu_item->event_window);
876 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->unmap (widget);
880 gtk_menu_item_paint (GtkWidget *widget,
883 GtkMenuItem *menu_item;
884 GtkStateType state_type;
885 GtkShadowType shadow_type, selected_shadow_type;
888 gint border_width = GTK_CONTAINER (widget)->border_width;
890 if (GTK_WIDGET_DRAWABLE (widget))
892 menu_item = GTK_MENU_ITEM (widget);
894 state_type = widget->state;
896 x = widget->allocation.x + border_width;
897 y = widget->allocation.y + border_width;
898 width = widget->allocation.width - border_width * 2;
899 height = widget->allocation.height - border_width * 2;
901 if ((state_type == GTK_STATE_PRELIGHT) &&
902 (GTK_BIN (menu_item)->child))
904 gtk_widget_style_get (widget,
905 "selected-shadow-type", &selected_shadow_type,
907 gtk_paint_box (widget->style,
910 selected_shadow_type,
911 area, widget, "menuitem",
912 x, y, width, height);
915 if (menu_item->submenu && menu_item->show_submenu_indicator)
917 gint arrow_x, arrow_y;
920 guint horizontal_padding;
921 gfloat arrow_scaling;
922 GtkTextDirection direction;
923 GtkArrowType arrow_type;
924 PangoContext *context;
925 PangoFontMetrics *metrics;
927 direction = gtk_widget_get_direction (widget);
929 gtk_widget_style_get (widget,
930 "horizontal-padding", &horizontal_padding,
931 "arrow-scaling", &arrow_scaling,
934 context = gtk_widget_get_pango_context (GTK_BIN (menu_item)->child);
935 metrics = pango_context_get_metrics (context,
936 GTK_WIDGET (GTK_BIN (menu_item)->child)->style->font_desc,
937 pango_context_get_language (context));
939 arrow_size = (PANGO_PIXELS (pango_font_metrics_get_ascent (metrics) +
940 pango_font_metrics_get_descent (metrics)));
942 pango_font_metrics_unref (metrics);
944 arrow_extent = arrow_size * arrow_scaling;
946 shadow_type = GTK_SHADOW_OUT;
947 if (state_type == GTK_STATE_PRELIGHT)
948 shadow_type = GTK_SHADOW_IN;
950 if (direction == GTK_TEXT_DIR_LTR)
952 arrow_x = x + width - horizontal_padding - arrow_extent;
953 arrow_type = GTK_ARROW_RIGHT;
957 arrow_x = x + horizontal_padding;
958 arrow_type = GTK_ARROW_LEFT;
961 arrow_y = y + (height - arrow_extent) / 2;
963 gtk_paint_arrow (widget->style, widget->window,
964 state_type, shadow_type,
965 area, widget, "menuitem",
968 arrow_extent, arrow_extent);
970 else if (!GTK_BIN (menu_item)->child)
972 gboolean wide_separators;
973 gint separator_height;
974 guint horizontal_padding;
976 gtk_widget_style_get (widget,
977 "wide-separators", &wide_separators,
978 "separator-height", &separator_height,
979 "horizontal-padding", &horizontal_padding,
983 gtk_paint_box (widget->style, widget->window,
984 GTK_STATE_NORMAL, GTK_SHADOW_ETCHED_OUT,
985 area, widget, "hseparator",
986 widget->allocation.x + horizontal_padding + widget->style->xthickness,
987 widget->allocation.y + (widget->allocation.height -
989 widget->style->ythickness) / 2,
990 widget->allocation.width -
991 2 * (horizontal_padding + widget->style->xthickness),
994 gtk_paint_hline (widget->style, widget->window,
995 GTK_STATE_NORMAL, area, widget, "menuitem",
996 widget->allocation.x + horizontal_padding + widget->style->xthickness,
997 widget->allocation.x + widget->allocation.width - horizontal_padding - widget->style->xthickness - 1,
998 widget->allocation.y + (widget->allocation.height -
999 widget->style->ythickness) / 2);
1005 gtk_menu_item_expose (GtkWidget *widget,
1006 GdkEventExpose *event)
1008 g_return_val_if_fail (GTK_IS_MENU_ITEM (widget), FALSE);
1009 g_return_val_if_fail (event != NULL, FALSE);
1011 if (GTK_WIDGET_DRAWABLE (widget))
1013 gtk_menu_item_paint (widget, &event->area);
1015 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->expose_event (widget, event);
1022 gtk_real_menu_item_select (GtkItem *item)
1024 GtkMenuItem *menu_item;
1025 gboolean touchscreen_mode;
1027 g_return_if_fail (GTK_IS_MENU_ITEM (item));
1029 menu_item = GTK_MENU_ITEM (item);
1031 g_object_get (gtk_widget_get_settings (GTK_WIDGET (item)),
1032 "gtk-touchscreen-mode", &touchscreen_mode,
1035 if (!touchscreen_mode &&
1036 menu_item->submenu &&
1037 (!GTK_WIDGET_MAPPED (menu_item->submenu) ||
1038 GTK_MENU (menu_item->submenu)->tearoff_active))
1040 _gtk_menu_item_popup_submenu (GTK_WIDGET (menu_item), TRUE);
1043 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_PRELIGHT);
1044 gtk_widget_queue_draw (GTK_WIDGET (menu_item));
1048 gtk_real_menu_item_deselect (GtkItem *item)
1050 GtkMenuItem *menu_item;
1052 g_return_if_fail (GTK_IS_MENU_ITEM (item));
1054 menu_item = GTK_MENU_ITEM (item);
1056 if (menu_item->submenu)
1057 _gtk_menu_item_popdown_submenu (GTK_WIDGET (menu_item));
1059 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_NORMAL);
1060 gtk_widget_queue_draw (GTK_WIDGET (menu_item));
1064 gtk_menu_item_mnemonic_activate (GtkWidget *widget,
1065 gboolean group_cycling)
1067 if (group_cycling &&
1069 GTK_IS_MENU_SHELL (widget->parent) &&
1070 GTK_MENU_SHELL (widget->parent)->active)
1072 gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent),
1076 g_signal_emit (widget, menu_item_signals[ACTIVATE_ITEM], 0);
1082 gtk_real_menu_item_activate_item (GtkMenuItem *menu_item)
1086 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1088 widget = GTK_WIDGET (menu_item);
1090 if (widget->parent &&
1091 GTK_IS_MENU_SHELL (widget->parent))
1093 if (menu_item->submenu == NULL)
1094 gtk_menu_shell_activate_item (GTK_MENU_SHELL (widget->parent),
1098 GtkMenuShell *menu_shell = GTK_MENU_SHELL (widget->parent);
1100 _gtk_menu_shell_activate (menu_shell);
1102 gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent), widget);
1103 _gtk_menu_item_popup_submenu (widget, FALSE);
1105 gtk_menu_shell_select_first (GTK_MENU_SHELL (menu_item->submenu), TRUE);
1111 gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
1114 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1120 gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
1123 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1125 menu_item->toggle_size = allocation;
1129 free_timeval (GTimeVal *val)
1131 g_slice_free (GTimeVal, val);
1135 gtk_menu_item_real_popup_submenu (GtkWidget *widget,
1136 gboolean remember_exact_time)
1138 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1140 if (GTK_WIDGET_IS_SENSITIVE (menu_item->submenu))
1142 gboolean take_focus;
1143 GtkMenuPositionFunc menu_position_func;
1145 take_focus = gtk_menu_shell_get_take_focus (GTK_MENU_SHELL (widget->parent));
1146 gtk_menu_shell_set_take_focus (GTK_MENU_SHELL (menu_item->submenu),
1149 if (remember_exact_time)
1151 GTimeVal *popup_time = g_slice_new0 (GTimeVal);
1153 g_get_current_time (popup_time);
1155 g_object_set_data_full (G_OBJECT (menu_item->submenu),
1156 "gtk-menu-exact-popup-time", popup_time,
1157 (GDestroyNotify) free_timeval);
1161 g_object_set_data (G_OBJECT (menu_item->submenu),
1162 "gtk-menu-exact-popup-time", NULL);
1165 /* gtk_menu_item_position_menu positions the submenu from the
1166 * menuitems position. If the menuitem doesn't have a window,
1167 * that doesn't work. In that case we use the default
1168 * positioning function instead which places the submenu at the
1172 menu_position_func = gtk_menu_item_position_menu;
1174 menu_position_func = NULL;
1176 gtk_menu_popup (GTK_MENU (menu_item->submenu),
1181 GTK_MENU_SHELL (widget->parent)->button,
1185 /* Enable themeing of the parent menu item depending on whether
1186 * its submenu is shown or not.
1188 gtk_widget_queue_draw (widget);
1192 gtk_menu_item_popup_timeout (gpointer data)
1194 GtkMenuItem *menu_item;
1197 menu_item = GTK_MENU_ITEM (data);
1199 parent = GTK_WIDGET (menu_item)->parent;
1201 if ((GTK_IS_MENU_SHELL (parent) && GTK_MENU_SHELL (parent)->active) ||
1202 (GTK_IS_MENU (parent) && GTK_MENU (parent)->torn_off))
1204 gtk_menu_item_real_popup_submenu (GTK_WIDGET (menu_item), TRUE);
1205 if (menu_item->timer_from_keypress && menu_item->submenu)
1206 GTK_MENU_SHELL (menu_item->submenu)->ignore_enter = TRUE;
1209 menu_item->timer = 0;
1215 get_popup_delay (GtkWidget *widget)
1217 if (GTK_IS_MENU_SHELL (widget->parent))
1219 return _gtk_menu_shell_get_popup_delay (GTK_MENU_SHELL (widget->parent));
1225 g_object_get (gtk_widget_get_settings (widget),
1226 "gtk-menu-popup-delay", &popup_delay,
1234 _gtk_menu_item_popup_submenu (GtkWidget *widget,
1235 gboolean with_delay)
1237 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1239 if (menu_item->timer)
1241 g_source_remove (menu_item->timer);
1242 menu_item->timer = 0;
1248 gint popup_delay = get_popup_delay (widget);
1250 if (popup_delay > 0)
1252 GdkEvent *event = gtk_get_current_event ();
1254 menu_item->timer = gdk_threads_add_timeout (popup_delay,
1255 gtk_menu_item_popup_timeout,
1259 event->type != GDK_BUTTON_PRESS &&
1260 event->type != GDK_ENTER_NOTIFY)
1261 menu_item->timer_from_keypress = TRUE;
1263 menu_item->timer_from_keypress = FALSE;
1266 gdk_event_free (event);
1272 gtk_menu_item_real_popup_submenu (widget, FALSE);
1276 _gtk_menu_item_popdown_submenu (GtkWidget *widget)
1278 GtkMenuItem *menu_item;
1280 menu_item = GTK_MENU_ITEM (widget);
1282 if (menu_item->submenu)
1284 g_object_set_data (G_OBJECT (menu_item->submenu),
1285 "gtk-menu-exact-popup-time", NULL);
1287 if (menu_item->timer)
1289 g_source_remove (menu_item->timer);
1290 menu_item->timer = 0;
1293 gtk_menu_popdown (GTK_MENU (menu_item->submenu));
1295 gtk_widget_queue_draw (widget);
1300 get_offsets (GtkMenu *menu,
1301 gint *horizontal_offset,
1302 gint *vertical_offset)
1304 gint vertical_padding;
1305 gint horizontal_padding;
1307 gtk_widget_style_get (GTK_WIDGET (menu),
1308 "horizontal-offset", horizontal_offset,
1309 "vertical-offset", vertical_offset,
1310 "horizontal-padding", &horizontal_padding,
1311 "vertical-padding", &vertical_padding,
1314 *vertical_offset -= GTK_WIDGET (menu)->style->ythickness;
1315 *vertical_offset -= vertical_padding;
1316 *horizontal_offset += horizontal_padding;
1320 gtk_menu_item_position_menu (GtkMenu *menu,
1326 GtkMenuItem *menu_item;
1328 GtkMenuItem *parent_menu_item;
1330 gint twidth, theight;
1332 GtkTextDirection direction;
1333 GdkRectangle monitor;
1335 gint horizontal_offset;
1336 gint vertical_offset;
1337 gint parent_xthickness;
1338 gint available_left, available_right;
1340 g_return_if_fail (menu != NULL);
1341 g_return_if_fail (x != NULL);
1342 g_return_if_fail (y != NULL);
1344 menu_item = GTK_MENU_ITEM (user_data);
1345 widget = GTK_WIDGET (user_data);
1350 direction = gtk_widget_get_direction (widget);
1352 twidth = GTK_WIDGET (menu)->requisition.width;
1353 theight = GTK_WIDGET (menu)->requisition.height;
1355 screen = gtk_widget_get_screen (GTK_WIDGET (menu));
1356 monitor_num = gdk_screen_get_monitor_at_window (screen, menu_item->event_window);
1357 if (monitor_num < 0)
1359 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
1361 if (!gdk_window_get_origin (widget->window, &tx, &ty))
1363 g_warning ("Menu not on screen");
1367 tx += widget->allocation.x;
1368 ty += widget->allocation.y;
1370 get_offsets (menu, &horizontal_offset, &vertical_offset);
1372 available_left = tx - monitor.x;
1373 available_right = monitor.x + monitor.width - (tx + widget->allocation.width);
1375 if (GTK_IS_MENU_BAR (widget->parent))
1377 menu_item->from_menubar = TRUE;
1379 else if (GTK_IS_MENU (widget->parent))
1381 if (GTK_MENU (widget->parent)->parent_menu_item)
1382 menu_item->from_menubar = GTK_MENU_ITEM (GTK_MENU (widget->parent)->parent_menu_item)->from_menubar;
1384 menu_item->from_menubar = FALSE;
1388 menu_item->from_menubar = FALSE;
1391 switch (menu_item->submenu_placement)
1393 case GTK_TOP_BOTTOM:
1394 if (direction == GTK_TEXT_DIR_LTR)
1395 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
1398 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
1399 tx += widget->allocation.width - twidth;
1401 if ((ty + widget->allocation.height + theight) <= monitor.y + monitor.height)
1402 ty += widget->allocation.height;
1403 else if ((ty - theight) >= monitor.y)
1405 else if (monitor.y + monitor.height - (ty + widget->allocation.height) > ty)
1406 ty += widget->allocation.height;
1411 case GTK_LEFT_RIGHT:
1412 if (GTK_IS_MENU (widget->parent))
1413 parent_menu_item = GTK_MENU_ITEM (GTK_MENU (widget->parent)->parent_menu_item);
1415 parent_menu_item = NULL;
1417 parent_xthickness = widget->parent->style->xthickness;
1419 if (parent_menu_item && !GTK_MENU (widget->parent)->torn_off)
1421 menu_item->submenu_direction = parent_menu_item->submenu_direction;
1425 if (direction == GTK_TEXT_DIR_LTR)
1426 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
1428 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
1431 switch (menu_item->submenu_direction)
1433 case GTK_DIRECTION_LEFT:
1434 if (tx - twidth - parent_xthickness - horizontal_offset >= monitor.x ||
1435 available_left >= available_right)
1436 tx -= twidth + parent_xthickness + horizontal_offset;
1439 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
1440 tx += widget->allocation.width + parent_xthickness + horizontal_offset;
1444 case GTK_DIRECTION_RIGHT:
1445 if (tx + widget->allocation.width + parent_xthickness + horizontal_offset + twidth <= monitor.x + monitor.width ||
1446 available_right >= available_left)
1447 tx += widget->allocation.width + parent_xthickness + horizontal_offset;
1450 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
1451 tx -= twidth + parent_xthickness + horizontal_offset;
1456 ty += vertical_offset;
1458 /* If the height of the menu doesn't fit we move it upward. */
1459 ty = CLAMP (ty, monitor.y, MAX (monitor.y, monitor.y + monitor.height - theight));
1463 /* If we have negative, tx, here it is because we can't get
1464 * the menu all the way on screen. Favor the left portion.
1466 *x = CLAMP (tx, monitor.x, MAX (monitor.x, monitor.x + monitor.width - twidth));
1469 gtk_menu_set_monitor (menu, monitor_num);
1471 if (!GTK_WIDGET_VISIBLE (menu->toplevel))
1473 gtk_window_set_type_hint (GTK_WINDOW (menu->toplevel), menu_item->from_menubar?
1474 GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU : GDK_WINDOW_TYPE_HINT_POPUP_MENU);
1479 * gtk_menu_item_set_right_justified:
1480 * @menu_item: a #GtkMenuItem.
1481 * @right_justified: if %TRUE the menu item will appear at the
1482 * far right if added to a menu bar.
1484 * Sets whether the menu item appears justified at the right
1485 * side of a menu bar. This was traditionally done for "Help" menu
1486 * items, but is now considered a bad idea. (If the widget
1487 * layout is reversed for a right-to-left language like Hebrew
1488 * or Arabic, right-justified-menu-items appear at the left.)
1491 gtk_menu_item_set_right_justified (GtkMenuItem *menu_item,
1492 gboolean right_justified)
1494 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1496 right_justified = right_justified != FALSE;
1498 if (right_justified != menu_item->right_justify)
1500 menu_item->right_justify = right_justified;
1501 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
1506 * gtk_menu_item_get_right_justified:
1507 * @menu_item: a #GtkMenuItem
1509 * Gets whether the menu item appears justified at the right
1510 * side of the menu bar.
1512 * Return value: %TRUE if the menu item will appear at the
1513 * far right if added to a menu bar.
1516 gtk_menu_item_get_right_justified (GtkMenuItem *menu_item)
1518 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), FALSE);
1520 return menu_item->right_justify;
1525 gtk_menu_item_show_all (GtkWidget *widget)
1527 GtkMenuItem *menu_item;
1529 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
1531 menu_item = GTK_MENU_ITEM (widget);
1533 /* show children including submenu */
1534 if (menu_item->submenu)
1535 gtk_widget_show_all (menu_item->submenu);
1536 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_show_all, NULL);
1538 gtk_widget_show (widget);
1542 gtk_menu_item_hide_all (GtkWidget *widget)
1544 GtkMenuItem *menu_item;
1546 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
1548 gtk_widget_hide (widget);
1550 menu_item = GTK_MENU_ITEM (widget);
1552 /* hide children including submenu */
1553 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_hide_all, NULL);
1554 if (menu_item->submenu)
1555 gtk_widget_hide_all (menu_item->submenu);
1559 gtk_menu_item_can_activate_accel (GtkWidget *widget,
1562 /* Chain to the parent GtkMenu for further checks */
1563 return (GTK_WIDGET_IS_SENSITIVE (widget) && GTK_WIDGET_VISIBLE (widget) &&
1564 widget->parent && gtk_widget_can_activate_accel (widget->parent, signal_id));
1568 gtk_menu_item_accel_name_foreach (GtkWidget *widget,
1571 const gchar **path_p = data;
1575 if (GTK_IS_LABEL (widget))
1577 *path_p = gtk_label_get_text (GTK_LABEL (widget));
1578 if (*path_p && (*path_p)[0] == 0)
1581 else if (GTK_IS_CONTAINER (widget))
1582 gtk_container_foreach (GTK_CONTAINER (widget),
1583 gtk_menu_item_accel_name_foreach,
1589 gtk_menu_item_parent_set (GtkWidget *widget,
1590 GtkWidget *previous_parent)
1592 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1593 GtkMenu *menu = GTK_IS_MENU (widget->parent) ? GTK_MENU (widget->parent) : NULL;
1596 _gtk_menu_item_refresh_accel_path (menu_item,
1601 if (GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->parent_set)
1602 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->parent_set (widget, previous_parent);
1606 _gtk_menu_item_refresh_accel_path (GtkMenuItem *menu_item,
1607 const gchar *prefix,
1608 GtkAccelGroup *accel_group,
1609 gboolean group_changed)
1614 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1615 g_return_if_fail (!accel_group || GTK_IS_ACCEL_GROUP (accel_group));
1617 widget = GTK_WIDGET (menu_item);
1621 gtk_widget_set_accel_path (widget, NULL, NULL);
1625 path = _gtk_widget_get_accel_path (widget, NULL);
1626 if (!path) /* no active accel_path yet */
1628 path = menu_item->accel_path;
1629 if (!path && prefix)
1631 const gchar *postfix = NULL;
1634 /* try to construct one from label text */
1635 gtk_container_foreach (GTK_CONTAINER (menu_item),
1636 gtk_menu_item_accel_name_foreach,
1640 new_path = g_strconcat (prefix, "/", postfix, NULL);
1641 path = menu_item->accel_path = (char*)g_intern_string (new_path);
1646 gtk_widget_set_accel_path (widget, path, accel_group);
1648 else if (group_changed) /* reinstall accelerators */
1649 gtk_widget_set_accel_path (widget, path, accel_group);
1653 * gtk_menu_item_set_accel_path
1654 * @menu_item: a valid #GtkMenuItem
1655 * @accel_path: accelerator path, corresponding to this menu item's
1656 * functionality, or %NULL to unset the current path.
1658 * Set the accelerator path on @menu_item, through which runtime changes of the
1659 * menu item's accelerator caused by the user can be identified and saved to
1660 * persistant storage (see gtk_accel_map_save() on this).
1661 * To setup a default accelerator for this menu item, call
1662 * gtk_accel_map_add_entry() with the same @accel_path.
1663 * See also gtk_accel_map_add_entry() on the specifics of accelerator paths,
1664 * and gtk_menu_set_accel_path() for a more convenient variant of this function.
1666 * This function is basically a convenience wrapper that handles calling
1667 * gtk_widget_set_accel_path() with the appropriate accelerator group for
1670 * Note that you do need to set an accelerator on the parent menu with
1671 * gtk_menu_set_accel_group() for this to work.
1673 * Note that @accel_path string will be stored in a #GQuark. Therefore, if you
1674 * pass a static string, you can save some memory by interning it first with
1675 * g_intern_static_string().
1678 gtk_menu_item_set_accel_path (GtkMenuItem *menu_item,
1679 const gchar *accel_path)
1683 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1684 g_return_if_fail (accel_path == NULL ||
1685 (accel_path[0] == '<' && strchr (accel_path, '/')));
1687 widget = GTK_WIDGET (menu_item);
1689 /* store new path */
1690 menu_item->accel_path = (char*)g_intern_string (accel_path);
1692 /* forget accelerators associated with old path */
1693 gtk_widget_set_accel_path (widget, NULL, NULL);
1695 /* install accelerators associated with new path */
1696 if (GTK_IS_MENU (widget->parent))
1698 GtkMenu *menu = GTK_MENU (widget->parent);
1700 if (menu->accel_group)
1701 _gtk_menu_item_refresh_accel_path (GTK_MENU_ITEM (widget),
1709 * gtk_menu_item_get_accel_path
1710 * @menu_item: a valid #GtkMenuItem
1712 * Retrieve the accelerator path that was previously set on @menu_item.
1714 * See gtk_menu_item_set_accel_path() for details.
1716 * Returns: the accelerator path corresponding to this menu item's
1717 * functionality, or %NULL if not set
1721 G_CONST_RETURN gchar *
1722 gtk_menu_item_get_accel_path (GtkMenuItem *menu_item)
1724 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);
1726 return menu_item->accel_path;
1730 gtk_menu_item_forall (GtkContainer *container,
1731 gboolean include_internals,
1732 GtkCallback callback,
1733 gpointer callback_data)
1737 g_return_if_fail (GTK_IS_MENU_ITEM (container));
1738 g_return_if_fail (callback != NULL);
1740 bin = GTK_BIN (container);
1743 callback (bin->child, callback_data);
1747 _gtk_menu_item_is_selectable (GtkWidget *menu_item)
1749 if ((!GTK_BIN (menu_item)->child &&
1750 G_OBJECT_TYPE (menu_item) == GTK_TYPE_MENU_ITEM) ||
1751 GTK_IS_SEPARATOR_MENU_ITEM (menu_item) ||
1752 !GTK_WIDGET_IS_SENSITIVE (menu_item) ||
1753 !GTK_WIDGET_VISIBLE (menu_item))
1759 #define __GTK_MENU_ITEM_C__
1760 #include "gtkaliasdef.c"