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/.
30 #include "gtkaccellabel.h"
32 #include "gtkmarshalers.h"
33 #include "gtkmenuprivate.h"
34 #include "gtkmenushellprivate.h"
35 #include "gtkmenuitemprivate.h"
36 #include "gtkmenubar.h"
37 #include "gtkmenuprivate.h"
38 #include "gtkseparatormenuitem.h"
39 #include "gtkprivate.h"
40 #include "gtkbuildable.h"
41 #include "gtkactivatable.h"
63 /* activatable properties */
64 PROP_ACTIVATABLE_RELATED_ACTION,
65 PROP_ACTIVATABLE_USE_ACTION_APPEARANCE
69 static void gtk_menu_item_dispose (GObject *object);
70 static void gtk_menu_item_set_property (GObject *object,
74 static void gtk_menu_item_get_property (GObject *object,
78 static void gtk_menu_item_destroy (GtkWidget *widget);
79 static void gtk_menu_item_size_allocate (GtkWidget *widget,
80 GtkAllocation *allocation);
81 static void gtk_menu_item_realize (GtkWidget *widget);
82 static void gtk_menu_item_unrealize (GtkWidget *widget);
83 static void gtk_menu_item_map (GtkWidget *widget);
84 static void gtk_menu_item_unmap (GtkWidget *widget);
85 static gboolean gtk_menu_item_enter (GtkWidget *widget,
86 GdkEventCrossing *event);
87 static gboolean gtk_menu_item_leave (GtkWidget *widget,
88 GdkEventCrossing *event);
89 static gboolean gtk_menu_item_draw (GtkWidget *widget,
91 static void gtk_menu_item_parent_set (GtkWidget *widget,
92 GtkWidget *previous_parent);
95 static void gtk_real_menu_item_select (GtkMenuItem *item);
96 static void gtk_real_menu_item_deselect (GtkMenuItem *item);
97 static void gtk_real_menu_item_activate (GtkMenuItem *item);
98 static void gtk_real_menu_item_activate_item (GtkMenuItem *item);
99 static void gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
101 static void gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
103 static gboolean gtk_menu_item_mnemonic_activate (GtkWidget *widget,
104 gboolean group_cycling);
106 static void gtk_menu_item_ensure_label (GtkMenuItem *menu_item);
107 static gint gtk_menu_item_popup_timeout (gpointer data);
108 static void gtk_menu_item_position_menu (GtkMenu *menu,
113 static void gtk_menu_item_show_all (GtkWidget *widget);
114 static void gtk_menu_item_forall (GtkContainer *container,
115 gboolean include_internals,
116 GtkCallback callback,
117 gpointer callback_data);
118 static gboolean gtk_menu_item_can_activate_accel (GtkWidget *widget,
121 static void gtk_real_menu_item_set_label (GtkMenuItem *menu_item,
123 static G_CONST_RETURN gchar * gtk_real_menu_item_get_label (GtkMenuItem *menu_item);
125 static void gtk_menu_item_get_preferred_width (GtkWidget *widget,
128 static void gtk_menu_item_get_preferred_height (GtkWidget *widget,
131 static void gtk_menu_item_get_preferred_height_for_width (GtkWidget *widget,
136 static void gtk_menu_item_buildable_interface_init (GtkBuildableIface *iface);
137 static void gtk_menu_item_buildable_add_child (GtkBuildable *buildable,
141 static void gtk_menu_item_buildable_custom_finished(GtkBuildable *buildable,
144 const gchar *tagname,
147 static void gtk_menu_item_activatable_interface_init (GtkActivatableIface *iface);
148 static void gtk_menu_item_update (GtkActivatable *activatable,
150 const gchar *property_name);
151 static void gtk_menu_item_sync_action_properties (GtkActivatable *activatable,
153 static void gtk_menu_item_set_related_action (GtkMenuItem *menu_item,
155 static void gtk_menu_item_set_use_action_appearance (GtkMenuItem *menu_item,
156 gboolean use_appearance);
159 static guint menu_item_signals[LAST_SIGNAL] = { 0 };
161 static GtkBuildableIface *parent_buildable_iface;
163 G_DEFINE_TYPE_WITH_CODE (GtkMenuItem, gtk_menu_item, GTK_TYPE_BIN,
164 G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
165 gtk_menu_item_buildable_interface_init)
166 G_IMPLEMENT_INTERFACE (GTK_TYPE_ACTIVATABLE,
167 gtk_menu_item_activatable_interface_init))
169 #define GET_PRIVATE(object) \
170 (G_TYPE_INSTANCE_GET_PRIVATE ((object), GTK_TYPE_MENU_ITEM, GtkMenuItemPrivate))
173 gtk_menu_item_class_init (GtkMenuItemClass *klass)
175 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
176 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
177 GtkContainerClass *container_class = GTK_CONTAINER_CLASS (klass);
179 gobject_class->dispose = gtk_menu_item_dispose;
180 gobject_class->set_property = gtk_menu_item_set_property;
181 gobject_class->get_property = gtk_menu_item_get_property;
183 widget_class->destroy = gtk_menu_item_destroy;
184 widget_class->size_allocate = gtk_menu_item_size_allocate;
185 widget_class->draw = gtk_menu_item_draw;
186 widget_class->realize = gtk_menu_item_realize;
187 widget_class->unrealize = gtk_menu_item_unrealize;
188 widget_class->map = gtk_menu_item_map;
189 widget_class->unmap = gtk_menu_item_unmap;
190 widget_class->enter_notify_event = gtk_menu_item_enter;
191 widget_class->leave_notify_event = gtk_menu_item_leave;
192 widget_class->show_all = gtk_menu_item_show_all;
193 widget_class->mnemonic_activate = gtk_menu_item_mnemonic_activate;
194 widget_class->parent_set = gtk_menu_item_parent_set;
195 widget_class->can_activate_accel = gtk_menu_item_can_activate_accel;
196 widget_class->get_preferred_width = gtk_menu_item_get_preferred_width;
197 widget_class->get_preferred_height = gtk_menu_item_get_preferred_height;
198 widget_class->get_preferred_height_for_width = gtk_menu_item_get_preferred_height_for_width;
200 container_class->forall = gtk_menu_item_forall;
202 klass->activate = gtk_real_menu_item_activate;
203 klass->activate_item = gtk_real_menu_item_activate_item;
204 klass->toggle_size_request = gtk_real_menu_item_toggle_size_request;
205 klass->toggle_size_allocate = gtk_real_menu_item_toggle_size_allocate;
206 klass->set_label = gtk_real_menu_item_set_label;
207 klass->get_label = gtk_real_menu_item_get_label;
208 klass->select = gtk_real_menu_item_select;
209 klass->deselect = gtk_real_menu_item_deselect;
211 klass->hide_on_activate = TRUE;
213 menu_item_signals[ACTIVATE] =
214 g_signal_new (I_("activate"),
215 G_OBJECT_CLASS_TYPE (gobject_class),
216 G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
217 G_STRUCT_OFFSET (GtkMenuItemClass, activate),
219 _gtk_marshal_VOID__VOID,
221 widget_class->activate_signal = menu_item_signals[ACTIVATE];
223 menu_item_signals[ACTIVATE_ITEM] =
224 g_signal_new (I_("activate-item"),
225 G_OBJECT_CLASS_TYPE (gobject_class),
227 G_STRUCT_OFFSET (GtkMenuItemClass, activate_item),
229 _gtk_marshal_VOID__VOID,
232 menu_item_signals[TOGGLE_SIZE_REQUEST] =
233 g_signal_new (I_("toggle-size-request"),
234 G_OBJECT_CLASS_TYPE (gobject_class),
236 G_STRUCT_OFFSET (GtkMenuItemClass, toggle_size_request),
238 _gtk_marshal_VOID__POINTER,
242 menu_item_signals[TOGGLE_SIZE_ALLOCATE] =
243 g_signal_new (I_("toggle-size-allocate"),
244 G_OBJECT_CLASS_TYPE (gobject_class),
246 G_STRUCT_OFFSET (GtkMenuItemClass, toggle_size_allocate),
248 _gtk_marshal_VOID__INT,
252 menu_item_signals[SELECT] =
253 g_signal_new (I_("select"),
254 G_OBJECT_CLASS_TYPE (gobject_class),
256 G_STRUCT_OFFSET (GtkMenuItemClass, select),
258 _gtk_marshal_VOID__VOID,
261 menu_item_signals[DESELECT] =
262 g_signal_new (I_("deselect"),
263 G_OBJECT_CLASS_TYPE (gobject_class),
265 G_STRUCT_OFFSET (GtkMenuItemClass, deselect),
267 _gtk_marshal_VOID__VOID,
271 * GtkMenuItem:right-justified:
273 * Sets whether the menu item appears justified
274 * at the right side of a menu bar.
278 g_object_class_install_property (gobject_class,
279 PROP_RIGHT_JUSTIFIED,
280 g_param_spec_boolean ("right-justified",
281 P_("Right Justified"),
282 P_("Sets whether the menu item appears justified at the right side of a menu bar"),
284 GTK_PARAM_READWRITE));
287 * GtkMenuItem:submenu:
289 * The submenu attached to the menu item, or %NULL if it has none.
293 g_object_class_install_property (gobject_class,
295 g_param_spec_object ("submenu",
297 P_("The submenu attached to the menu item, or NULL if it has none"),
299 GTK_PARAM_READWRITE));
302 * GtkMenuItem:accel-path:
304 * Sets the accelerator path of the menu item, through which runtime
305 * changes of the menu item's accelerator caused by the user can be
306 * identified and saved to persistant storage.
310 g_object_class_install_property (gobject_class,
312 g_param_spec_string ("accel-path",
314 P_("Sets the accelerator path of the menu item"),
316 GTK_PARAM_READWRITE));
321 * The text for the child label.
325 g_object_class_install_property (gobject_class,
327 g_param_spec_string ("label",
329 P_("The text for the child label"),
331 GTK_PARAM_READWRITE));
334 * GtkMenuItem:use-underline:
336 * %TRUE if underlines in the text indicate mnemonics.
340 g_object_class_install_property (gobject_class,
342 g_param_spec_boolean ("use-underline",
344 P_("If set, an underline in the text indicates "
345 "the next character should be used for the "
346 "mnemonic accelerator key"),
348 GTK_PARAM_READWRITE));
350 g_object_class_override_property (gobject_class, PROP_ACTIVATABLE_RELATED_ACTION, "related-action");
351 g_object_class_override_property (gobject_class, PROP_ACTIVATABLE_USE_ACTION_APPEARANCE, "use-action-appearance");
353 gtk_widget_class_install_style_property_parser (widget_class,
354 g_param_spec_enum ("selected-shadow-type",
355 "Selected Shadow Type",
356 "Shadow type when item is selected",
357 GTK_TYPE_SHADOW_TYPE,
360 gtk_rc_property_parse_enum);
362 gtk_widget_class_install_style_property (widget_class,
363 g_param_spec_int ("horizontal-padding",
364 "Horizontal Padding",
365 "Padding to left and right of the menu item",
369 GTK_PARAM_READABLE));
371 gtk_widget_class_install_style_property (widget_class,
372 g_param_spec_int ("toggle-spacing",
374 "Space between icon and label",
378 GTK_PARAM_READABLE));
380 gtk_widget_class_install_style_property (widget_class,
381 g_param_spec_int ("arrow-spacing",
383 "Space between label and arrow",
387 GTK_PARAM_READABLE));
389 gtk_widget_class_install_style_property (widget_class,
390 g_param_spec_float ("arrow-scaling",
392 P_("Amount of space used up by arrow, relative to the menu item's font size"),
394 GTK_PARAM_READABLE));
397 * GtkMenuItem:width-chars:
399 * The minimum desired width of the menu item in characters.
403 gtk_widget_class_install_style_property (widget_class,
404 g_param_spec_int ("width-chars",
405 P_("Width in Characters"),
406 P_("The minimum desired width of the menu item in characters"),
408 GTK_PARAM_READABLE));
410 g_type_class_add_private (klass, sizeof (GtkMenuItemPrivate));
414 gtk_menu_item_init (GtkMenuItem *menu_item)
416 GtkMenuItemPrivate *priv;
418 priv = G_TYPE_INSTANCE_GET_PRIVATE (menu_item,
421 menu_item->priv = priv;
423 gtk_widget_set_has_window (GTK_WIDGET (menu_item), FALSE);
426 priv->use_action_appearance = TRUE;
428 menu_item->submenu = NULL;
429 menu_item->toggle_size = 0;
430 menu_item->accelerator_width = 0;
431 if (gtk_widget_get_direction (GTK_WIDGET (menu_item)) == GTK_TEXT_DIR_RTL)
432 priv->submenu_direction = GTK_DIRECTION_LEFT;
434 priv->submenu_direction = GTK_DIRECTION_RIGHT;
435 priv->submenu_placement = GTK_TOP_BOTTOM;
436 priv->right_justify = FALSE;
437 priv->use_action_appearance = TRUE;
443 gtk_menu_item_new (void)
445 return g_object_new (GTK_TYPE_MENU_ITEM, NULL);
449 gtk_menu_item_new_with_label (const gchar *label)
451 return g_object_new (GTK_TYPE_MENU_ITEM,
458 * gtk_menu_item_new_with_mnemonic:
459 * @label: The text of the button, with an underscore in front of the
462 * Creates a new #GtkMenuItem containing a label.
464 * The label will be created using gtk_label_new_with_mnemonic(),
465 * so underscores in @label indicate the mnemonic for the menu item.
467 * Returns: a new #GtkMenuItem
470 gtk_menu_item_new_with_mnemonic (const gchar *label)
472 return g_object_new (GTK_TYPE_MENU_ITEM,
473 "use-underline", TRUE,
479 gtk_menu_item_dispose (GObject *object)
481 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
482 GtkMenuItemPrivate *priv = menu_item->priv;
486 gtk_action_disconnect_accelerator (priv->action);
487 gtk_activatable_do_set_related_action (GTK_ACTIVATABLE (menu_item), NULL);
490 G_OBJECT_CLASS (gtk_menu_item_parent_class)->dispose (object);
494 gtk_menu_item_set_property (GObject *object,
499 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
503 case PROP_RIGHT_JUSTIFIED:
504 gtk_menu_item_set_right_justified (menu_item, g_value_get_boolean (value));
507 gtk_menu_item_set_submenu (menu_item, g_value_get_object (value));
509 case PROP_ACCEL_PATH:
510 gtk_menu_item_set_accel_path (menu_item, g_value_get_string (value));
513 gtk_menu_item_set_label (menu_item, g_value_get_string (value));
515 case PROP_USE_UNDERLINE:
516 gtk_menu_item_set_use_underline (menu_item, g_value_get_boolean (value));
518 case PROP_ACTIVATABLE_RELATED_ACTION:
519 gtk_menu_item_set_related_action (menu_item, g_value_get_object (value));
521 case PROP_ACTIVATABLE_USE_ACTION_APPEARANCE:
522 gtk_menu_item_set_use_action_appearance (menu_item, g_value_get_boolean (value));
525 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
531 gtk_menu_item_get_property (GObject *object,
536 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
537 GtkMenuItemPrivate *priv = menu_item->priv;
541 case PROP_RIGHT_JUSTIFIED:
542 g_value_set_boolean (value, gtk_menu_item_get_right_justified (menu_item));
545 g_value_set_object (value, gtk_menu_item_get_submenu (menu_item));
547 case PROP_ACCEL_PATH:
548 g_value_set_string (value, gtk_menu_item_get_accel_path (menu_item));
551 g_value_set_string (value, gtk_menu_item_get_label (menu_item));
553 case PROP_USE_UNDERLINE:
554 g_value_set_boolean (value, gtk_menu_item_get_use_underline (menu_item));
556 case PROP_ACTIVATABLE_RELATED_ACTION:
557 g_value_set_object (value, priv->action);
559 case PROP_ACTIVATABLE_USE_ACTION_APPEARANCE:
560 g_value_set_boolean (value, priv->use_action_appearance);
563 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
569 gtk_menu_item_destroy (GtkWidget *widget)
571 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
572 GtkMenuItemPrivate *priv = menu_item->priv;
575 gtk_widget_destroy (priv->submenu);
577 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->destroy (widget);
581 gtk_menu_item_detacher (GtkWidget *widget,
584 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
585 GtkMenuItemPrivate *priv = menu_item->priv;
587 g_return_if_fail (priv->submenu == (GtkWidget*) menu);
589 priv->submenu = NULL;
593 get_arrow_size (GtkWidget *widget,
597 PangoContext *context;
598 PangoFontMetrics *metrics;
599 gfloat arrow_scaling;
603 gtk_widget_style_get (widget,
604 "arrow-scaling", &arrow_scaling,
607 context = gtk_widget_get_pango_context (child);
608 metrics = pango_context_get_metrics (context,
609 gtk_widget_get_style (child)->font_desc,
610 pango_context_get_language (context));
612 *size = (PANGO_PIXELS (pango_font_metrics_get_ascent (metrics) +
613 pango_font_metrics_get_descent (metrics)));
615 pango_font_metrics_unref (metrics);
617 *size = *size * arrow_scaling;
622 gtk_menu_item_accel_width_foreach (GtkWidget *widget,
627 if (GTK_IS_ACCEL_LABEL (widget))
631 w = gtk_accel_label_get_accel_width (GTK_ACCEL_LABEL (widget));
632 *width = MAX (*width, w);
634 else if (GTK_IS_CONTAINER (widget))
635 gtk_container_foreach (GTK_CONTAINER (widget),
636 gtk_menu_item_accel_width_foreach,
641 get_minimum_width (GtkWidget *widget)
643 PangoContext *context;
644 PangoFontMetrics *metrics;
648 context = gtk_widget_get_pango_context (widget);
649 metrics = pango_context_get_metrics (context,
650 gtk_widget_get_style (widget)->font_desc,
651 pango_context_get_language (context));
653 width = pango_font_metrics_get_approximate_char_width (metrics);
655 pango_font_metrics_unref (metrics);
657 gtk_widget_style_get (widget, "width-chars", &width_chars, NULL);
659 return PANGO_PIXELS (width_chars * width);
663 gtk_menu_item_get_preferred_width (GtkWidget *widget,
667 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
668 GtkMenuItemPrivate *priv = menu_item->priv;
673 guint horizontal_padding;
675 GtkPackDirection pack_dir;
676 GtkPackDirection child_pack_dir;
677 gint min_width, nat_width;
679 min_width = nat_width = 0;
681 gtk_widget_style_get (widget,
682 "horizontal-padding", &horizontal_padding,
685 bin = GTK_BIN (widget);
686 parent = gtk_widget_get_parent (widget);
688 if (GTK_IS_MENU_BAR (parent))
690 pack_dir = gtk_menu_bar_get_pack_direction (GTK_MENU_BAR (parent));
691 child_pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (parent));
695 pack_dir = GTK_PACK_DIRECTION_LTR;
696 child_pack_dir = GTK_PACK_DIRECTION_LTR;
699 border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
700 min_width = (border_width + gtk_widget_get_style (widget)->xthickness) * 2;
702 if ((pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL) &&
703 (child_pack_dir == GTK_PACK_DIRECTION_LTR || child_pack_dir == GTK_PACK_DIRECTION_RTL))
704 min_width += 2 * horizontal_padding;
706 nat_width = min_width;
708 child = gtk_bin_get_child (bin);
710 if (child != NULL && gtk_widget_get_visible (child))
712 GtkMenuItemPrivate *priv = GET_PRIVATE (menu_item);
713 gint child_min, child_nat;
715 gtk_widget_get_preferred_width (child, &child_min, &child_nat);
717 if ((menu_item->submenu && !GTK_IS_MENU_BAR (parent)) || priv->reserve_indicator);
722 gtk_widget_style_get (widget,
723 "arrow-spacing", &arrow_spacing,
726 get_arrow_size (widget, child, &arrow_size);
728 gtk_widget_style_get (widget,
729 "arrow-spacing", &arrow_spacing,
732 get_arrow_size (widget, child, &arrow_size);
734 min_width += arrow_size;
735 min_width += arrow_spacing;
737 min_width = MAX (min_width, get_minimum_width (widget));
738 nat_width = min_width;
741 min_width += child_min;
742 nat_width += child_nat;
746 gtk_container_foreach (GTK_CONTAINER (menu_item),
747 gtk_menu_item_accel_width_foreach,
749 priv->accelerator_width = accel_width;
752 *minimum_size = min_width;
755 *natural_size = nat_width;
759 gtk_menu_item_get_preferred_height (GtkWidget *widget,
763 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
764 GtkMenuItemPrivate *priv = menu_item->priv;
770 guint horizontal_padding;
772 GtkPackDirection pack_dir;
773 GtkPackDirection child_pack_dir;
774 gint min_height, nat_height;
776 min_height = nat_height = 0;
778 style = gtk_widget_get_style (widget);
780 gtk_widget_style_get (widget,
781 "horizontal-padding", &horizontal_padding,
784 bin = GTK_BIN (widget);
785 parent = gtk_widget_get_parent (widget);
787 if (GTK_IS_MENU_BAR (parent))
789 pack_dir = gtk_menu_bar_get_pack_direction (GTK_MENU_BAR (parent));
790 child_pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (parent));
794 pack_dir = GTK_PACK_DIRECTION_LTR;
795 child_pack_dir = GTK_PACK_DIRECTION_LTR;
798 border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
799 min_height = (border_width + style->ythickness) * 2;
801 if ((pack_dir == GTK_PACK_DIRECTION_TTB || pack_dir == GTK_PACK_DIRECTION_BTT) &&
802 (child_pack_dir == GTK_PACK_DIRECTION_TTB || child_pack_dir == GTK_PACK_DIRECTION_BTT))
803 min_height += 2 * horizontal_padding;
805 nat_height = min_height;
807 child = gtk_bin_get_child (bin);
809 if (child != NULL && gtk_widget_get_visible (child))
811 GtkMenuItemPrivate *priv = GET_PRIVATE (menu_item);
812 gint child_min, child_nat;
814 gtk_widget_get_preferred_height (child, &child_min, &child_nat);
816 min_height += child_min;
817 nat_height += child_nat;
819 if ((menu_item->submenu && !GTK_IS_MENU_BAR (parent)) || priv->reserve_indicator)
823 get_arrow_size (widget, child, &arrow_size);
825 min_height = MAX (min_height, arrow_size);
826 nat_height = MAX (nat_height, arrow_size);
829 else /* separator item */
831 gboolean wide_separators;
832 gint separator_height;
834 gtk_widget_style_get (widget,
835 "wide-separators", &wide_separators,
836 "separator-height", &separator_height,
840 min_height += separator_height + style->ythickness;
842 min_height += style->ythickness * 2;
844 nat_height = min_height;
848 gtk_container_foreach (GTK_CONTAINER (menu_item),
849 gtk_menu_item_accel_width_foreach,
851 priv->accelerator_width = accel_width;
854 *minimum_size = min_height;
857 *natural_size = nat_height;
861 gtk_menu_item_get_preferred_height_for_width (GtkWidget *widget,
866 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
867 GtkMenuItemPrivate *priv = menu_item->priv;
872 guint horizontal_padding;
874 GtkPackDirection pack_dir;
875 GtkPackDirection child_pack_dir;
876 gint min_height, nat_height;
879 min_height = nat_height = 0;
881 style = gtk_widget_get_style (widget);
883 gtk_widget_style_get (widget,
884 "horizontal-padding", &horizontal_padding,
887 bin = GTK_BIN (widget);
888 parent = gtk_widget_get_parent (widget);
890 if (GTK_IS_MENU_BAR (parent))
892 pack_dir = gtk_menu_bar_get_pack_direction (GTK_MENU_BAR (parent));
893 child_pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (parent));
897 pack_dir = GTK_PACK_DIRECTION_LTR;
898 child_pack_dir = GTK_PACK_DIRECTION_LTR;
901 border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
902 min_height = (border_width + style->ythickness) * 2;
904 avail_size = for_size;
905 avail_size -= (border_width + style->xthickness) * 2;
907 if ((pack_dir == GTK_PACK_DIRECTION_TTB || pack_dir == GTK_PACK_DIRECTION_BTT) &&
908 (child_pack_dir == GTK_PACK_DIRECTION_TTB || child_pack_dir == GTK_PACK_DIRECTION_BTT))
909 min_height += 2 * horizontal_padding;
911 if ((pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL) &&
912 (child_pack_dir == GTK_PACK_DIRECTION_LTR || child_pack_dir == GTK_PACK_DIRECTION_RTL))
913 avail_size -= 2 * horizontal_padding;
915 nat_height = min_height;
917 child = gtk_bin_get_child (bin);
919 if (child != NULL && gtk_widget_get_visible (child))
921 GtkMenuItemPrivate *priv = GET_PRIVATE (menu_item);
922 gint child_min, child_nat;
925 if ((menu_item->submenu && !GTK_IS_MENU_BAR (parent)) || priv->reserve_indicator)
929 gtk_widget_style_get (widget,
930 "arrow-spacing", &arrow_spacing,
933 get_arrow_size (widget, child, &arrow_size);
935 avail_size -= arrow_size;
936 avail_size -= arrow_spacing;
939 gtk_widget_get_preferred_height_for_width (child,
944 min_height += child_min;
945 nat_height += child_nat;
947 if (menu_item->submenu && !GTK_IS_MENU_BAR (parent))
949 min_height = MAX (min_height, arrow_size);
950 nat_height = MAX (nat_height, arrow_size);
953 else /* separator item */
955 gboolean wide_separators;
956 gint separator_height;
958 gtk_widget_style_get (widget,
959 "wide-separators", &wide_separators,
960 "separator-height", &separator_height,
964 min_height += separator_height + style->ythickness;
966 min_height += style->ythickness * 2;
968 nat_height = min_height;
972 *minimum_size = min_height;
975 *natural_size = nat_height;
979 gtk_menu_item_buildable_interface_init (GtkBuildableIface *iface)
981 parent_buildable_iface = g_type_interface_peek_parent (iface);
982 iface->add_child = gtk_menu_item_buildable_add_child;
983 iface->custom_finished = gtk_menu_item_buildable_custom_finished;
987 gtk_menu_item_buildable_add_child (GtkBuildable *buildable,
992 if (type && strcmp (type, "submenu") == 0)
993 gtk_menu_item_set_submenu (GTK_MENU_ITEM (buildable),
996 parent_buildable_iface->add_child (buildable, builder, child, type);
1001 gtk_menu_item_buildable_custom_finished (GtkBuildable *buildable,
1002 GtkBuilder *builder,
1004 const gchar *tagname,
1007 GtkWidget *toplevel;
1009 if (strcmp (tagname, "accelerator") == 0)
1011 GtkMenuShell *menu_shell;
1014 menu_shell = GTK_MENU_SHELL (gtk_widget_get_parent (GTK_WIDGET (buildable)));
1017 while (GTK_IS_MENU (menu_shell) &&
1018 (attach = gtk_menu_get_attach_widget (GTK_MENU (menu_shell))) != NULL)
1019 menu_shell = GTK_MENU_SHELL (gtk_widget_get_parent (attach));
1021 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (menu_shell));
1025 /* Fall back to something ... */
1026 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (buildable));
1028 g_warning ("found a GtkMenuItem '%s' without a parent GtkMenuShell, assigned accelerators wont work.",
1029 gtk_buildable_get_name (buildable));
1032 /* Feed the correct toplevel to the GtkWidget accelerator parsing code */
1033 _gtk_widget_buildable_finish_accelerator (GTK_WIDGET (buildable), toplevel, user_data);
1036 parent_buildable_iface->custom_finished (buildable, builder, child, tagname, user_data);
1041 gtk_menu_item_activatable_interface_init (GtkActivatableIface *iface)
1043 iface->update = gtk_menu_item_update;
1044 iface->sync_action_properties = gtk_menu_item_sync_action_properties;
1048 activatable_update_label (GtkMenuItem *menu_item, GtkAction *action)
1052 child = gtk_bin_get_child (GTK_BIN (menu_item));
1054 if (GTK_IS_LABEL (child))
1058 label = gtk_action_get_label (action);
1059 gtk_menu_item_set_label (menu_item, label);
1063 gboolean _gtk_menu_is_empty (GtkWidget *menu);
1066 gtk_menu_item_update (GtkActivatable *activatable,
1068 const gchar *property_name)
1070 GtkMenuItem *menu_item = GTK_MENU_ITEM (activatable);
1071 GtkMenuItemPrivate *priv = menu_item->priv;
1073 if (strcmp (property_name, "visible") == 0)
1074 _gtk_action_sync_menu_visible (action, GTK_WIDGET (menu_item),
1075 _gtk_menu_is_empty (gtk_menu_item_get_submenu (menu_item)));
1076 else if (strcmp (property_name, "sensitive") == 0)
1077 gtk_widget_set_sensitive (GTK_WIDGET (menu_item), gtk_action_is_sensitive (action));
1078 else if (priv->use_action_appearance)
1080 if (strcmp (property_name, "label") == 0)
1081 activatable_update_label (menu_item, action);
1086 gtk_menu_item_sync_action_properties (GtkActivatable *activatable,
1089 GtkMenuItem *menu_item = GTK_MENU_ITEM (activatable);
1090 GtkMenuItemPrivate *priv = menu_item->priv;
1093 if (!priv->use_action_appearance || !action)
1095 label = gtk_bin_get_child (GTK_BIN (menu_item));
1097 if (GTK_IS_ACCEL_LABEL (label))
1098 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (label), GTK_WIDGET (menu_item));
1104 _gtk_action_sync_menu_visible (action, GTK_WIDGET (menu_item),
1105 _gtk_menu_is_empty (gtk_menu_item_get_submenu (menu_item)));
1107 gtk_widget_set_sensitive (GTK_WIDGET (menu_item), gtk_action_is_sensitive (action));
1109 if (priv->use_action_appearance)
1111 label = gtk_bin_get_child (GTK_BIN (menu_item));
1113 /* make sure label is a label, deleting it otherwise */
1114 if (label && !GTK_IS_LABEL (label))
1116 gtk_container_remove (GTK_CONTAINER (menu_item), label);
1119 /* Make sure that menu_item has a label and that any
1120 * accelerators are set */
1121 gtk_menu_item_ensure_label (menu_item);
1122 gtk_menu_item_set_use_underline (menu_item, TRUE);
1123 /* Make label point to the menu_item's label */
1124 label = gtk_bin_get_child (GTK_BIN (menu_item));
1126 if (GTK_IS_ACCEL_LABEL (label) && gtk_action_get_accel_path (action))
1128 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (label), NULL);
1129 gtk_accel_label_set_accel_closure (GTK_ACCEL_LABEL (label),
1130 gtk_action_get_accel_closure (action));
1133 activatable_update_label (menu_item, action);
1138 gtk_menu_item_set_related_action (GtkMenuItem *menu_item,
1141 GtkMenuItemPrivate *priv = menu_item->priv;
1143 if (priv->action == action)
1148 gtk_action_disconnect_accelerator (priv->action);
1153 const gchar *accel_path;
1155 accel_path = gtk_action_get_accel_path (action);
1158 gtk_action_connect_accelerator (action);
1159 gtk_menu_item_set_accel_path (menu_item, accel_path);
1163 gtk_activatable_do_set_related_action (GTK_ACTIVATABLE (menu_item), action);
1165 priv->action = action;
1169 gtk_menu_item_set_use_action_appearance (GtkMenuItem *menu_item,
1170 gboolean use_appearance)
1172 GtkMenuItemPrivate *priv = menu_item->priv;
1174 if (priv->use_action_appearance != use_appearance)
1176 priv->use_action_appearance = use_appearance;
1178 gtk_activatable_sync_action_properties (GTK_ACTIVATABLE (menu_item), priv->action);
1184 * gtk_menu_item_set_submenu:
1185 * @menu_item: a #GtkMenuItem
1186 * @submenu: (allow-none): the submenu, or %NULL
1188 * Sets or replaces the menu item's submenu, or removes it when a %NULL
1189 * submenu is passed.
1192 gtk_menu_item_set_submenu (GtkMenuItem *menu_item,
1195 GtkMenuItemPrivate *priv = menu_item->priv;
1197 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1198 g_return_if_fail (submenu == NULL || GTK_IS_MENU (submenu));
1200 if (priv->submenu != submenu)
1203 gtk_menu_detach (GTK_MENU (priv->submenu));
1207 priv->submenu = submenu;
1208 gtk_menu_attach_to_widget (GTK_MENU (submenu),
1209 GTK_WIDGET (menu_item),
1210 gtk_menu_item_detacher);
1213 if (gtk_widget_get_parent (GTK_WIDGET (menu_item)))
1214 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
1216 g_object_notify (G_OBJECT (menu_item), "submenu");
1221 * gtk_menu_item_get_submenu:
1222 * @menu_item: a #GtkMenuItem
1224 * Gets the submenu underneath this menu item, if any.
1225 * See gtk_menu_item_set_submenu().
1227 * Return value: (transfer none): submenu for this menu item, or %NULL if none
1230 gtk_menu_item_get_submenu (GtkMenuItem *menu_item)
1232 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);
1234 return menu_item->priv->submenu;
1237 void _gtk_menu_item_set_placement (GtkMenuItem *menu_item,
1238 GtkSubmenuPlacement placement);
1241 _gtk_menu_item_set_placement (GtkMenuItem *menu_item,
1242 GtkSubmenuPlacement placement)
1244 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1246 menu_item->priv->submenu_placement = placement;
1250 gtk_menu_item_select (GtkMenuItem *menu_item)
1254 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1256 g_signal_emit (menu_item, menu_item_signals[SELECT], 0);
1258 /* Enable themeing of the parent menu item depending on whether
1259 * something is selected in its submenu
1261 parent = gtk_widget_get_parent (GTK_WIDGET (menu_item));
1262 if (GTK_IS_MENU (parent))
1264 GtkMenu *menu = GTK_MENU (parent);
1266 if (menu->priv->parent_menu_item)
1267 gtk_widget_queue_draw (GTK_WIDGET (menu->priv->parent_menu_item));
1272 gtk_menu_item_deselect (GtkMenuItem *menu_item)
1276 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1278 g_signal_emit (menu_item, menu_item_signals[DESELECT], 0);
1280 /* Enable themeing of the parent menu item depending on whether
1281 * something is selected in its submenu
1283 parent = gtk_widget_get_parent (GTK_WIDGET (menu_item));
1284 if (GTK_IS_MENU (parent))
1286 GtkMenu *menu = GTK_MENU (parent);
1288 if (menu->priv->parent_menu_item)
1289 gtk_widget_queue_draw (GTK_WIDGET (menu->priv->parent_menu_item));
1294 gtk_menu_item_activate (GtkMenuItem *menu_item)
1296 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1298 g_signal_emit (menu_item, menu_item_signals[ACTIVATE], 0);
1302 gtk_menu_item_toggle_size_request (GtkMenuItem *menu_item,
1305 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1307 g_signal_emit (menu_item, menu_item_signals[TOGGLE_SIZE_REQUEST], 0, requisition);
1311 gtk_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
1314 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1316 g_signal_emit (menu_item, menu_item_signals[TOGGLE_SIZE_ALLOCATE], 0, allocation);
1320 gtk_menu_item_size_allocate (GtkWidget *widget,
1321 GtkAllocation *allocation)
1323 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1324 GtkMenuItemPrivate *priv = menu_item->priv;
1326 GtkAllocation child_allocation;
1327 GtkTextDirection direction;
1328 GtkPackDirection pack_dir;
1329 GtkPackDirection child_pack_dir;
1333 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
1334 g_return_if_fail (allocation != NULL);
1336 bin = GTK_BIN (widget);
1338 direction = gtk_widget_get_direction (widget);
1340 parent = gtk_widget_get_parent (widget);
1341 if (GTK_IS_MENU_BAR (parent))
1343 pack_dir = gtk_menu_bar_get_pack_direction (GTK_MENU_BAR (parent));
1344 child_pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (parent));
1348 pack_dir = GTK_PACK_DIRECTION_LTR;
1349 child_pack_dir = GTK_PACK_DIRECTION_LTR;
1352 gtk_widget_set_allocation (widget, allocation);
1354 child = gtk_bin_get_child (bin);
1357 GtkMenuItemPrivate *priv = GET_PRIVATE (menu_item);
1359 guint horizontal_padding;
1362 style = gtk_widget_get_style (widget);
1363 gtk_widget_style_get (widget,
1364 "horizontal-padding", &horizontal_padding,
1367 border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
1368 child_allocation.x = border_width + style->xthickness;
1369 child_allocation.y = border_width + style->ythickness;
1371 if ((pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL) &&
1372 (child_pack_dir == GTK_PACK_DIRECTION_LTR || child_pack_dir == GTK_PACK_DIRECTION_RTL))
1373 child_allocation.x += horizontal_padding;
1374 else if ((pack_dir == GTK_PACK_DIRECTION_TTB || pack_dir == GTK_PACK_DIRECTION_BTT) &&
1375 (child_pack_dir == GTK_PACK_DIRECTION_TTB || child_pack_dir == GTK_PACK_DIRECTION_BTT))
1376 child_allocation.y += horizontal_padding;
1378 child_allocation.width = MAX (1, (gint)allocation->width - child_allocation.x * 2);
1379 child_allocation.height = MAX (1, (gint)allocation->height - child_allocation.y * 2);
1381 if (child_pack_dir == GTK_PACK_DIRECTION_LTR ||
1382 child_pack_dir == GTK_PACK_DIRECTION_RTL)
1384 if ((direction == GTK_TEXT_DIR_LTR) == (child_pack_dir != GTK_PACK_DIRECTION_RTL))
1385 child_allocation.x += priv->toggle_size;
1386 child_allocation.width -= priv->toggle_size;
1390 if ((direction == GTK_TEXT_DIR_LTR) == (child_pack_dir != GTK_PACK_DIRECTION_BTT))
1391 child_allocation.y += priv->toggle_size;
1392 child_allocation.height -= priv->toggle_size;
1395 child_allocation.x += allocation->x;
1396 child_allocation.y += allocation->y;
1398 if ((menu_item->submenu && !GTK_IS_MENU_BAR (parent)) || priv->reserve_indicator)
1400 guint arrow_spacing;
1403 gtk_widget_style_get (widget,
1404 "arrow-spacing", &arrow_spacing,
1407 get_arrow_size (widget, child, &arrow_size);
1409 if (direction == GTK_TEXT_DIR_RTL)
1410 child_allocation.x += arrow_size + arrow_spacing;
1411 child_allocation.width -= arrow_size + arrow_spacing;
1414 if (child_allocation.width < 1)
1415 child_allocation.width = 1;
1417 gtk_widget_size_allocate (child, &child_allocation);
1420 if (gtk_widget_get_realized (widget))
1421 gdk_window_move_resize (priv->event_window,
1422 allocation->x, allocation->y,
1423 allocation->width, allocation->height);
1426 gtk_menu_reposition (GTK_MENU (priv->submenu));
1430 gtk_menu_item_realize (GtkWidget *widget)
1432 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1433 GtkMenuItemPrivate *priv = menu_item->priv;
1434 GtkAllocation allocation;
1436 GdkWindowAttr attributes;
1437 gint attributes_mask;
1439 gtk_widget_set_realized (widget, TRUE);
1441 window = gtk_widget_get_parent_window (widget);
1442 gtk_widget_set_window (widget, window);
1443 g_object_ref (window);
1445 gtk_widget_get_allocation (widget, &allocation);
1447 attributes.x = allocation.x;
1448 attributes.y = allocation.y;
1449 attributes.width = allocation.width;
1450 attributes.height = allocation.height;
1451 attributes.window_type = GDK_WINDOW_CHILD;
1452 attributes.wclass = GDK_INPUT_ONLY;
1453 attributes.event_mask = (gtk_widget_get_events (widget) |
1454 GDK_BUTTON_PRESS_MASK |
1455 GDK_BUTTON_RELEASE_MASK |
1456 GDK_ENTER_NOTIFY_MASK |
1457 GDK_LEAVE_NOTIFY_MASK |
1458 GDK_POINTER_MOTION_MASK);
1460 attributes_mask = GDK_WA_X | GDK_WA_Y;
1462 priv->event_window = gdk_window_new (gtk_widget_get_parent_window (widget),
1463 &attributes, attributes_mask);
1464 gdk_window_set_user_data (priv->event_window, widget);
1466 gtk_widget_style_attach (widget);
1470 gtk_menu_item_unrealize (GtkWidget *widget)
1472 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1473 GtkMenuItemPrivate *priv = menu_item->priv;
1475 gdk_window_set_user_data (priv->event_window, NULL);
1476 gdk_window_destroy (priv->event_window);
1477 priv->event_window = NULL;
1479 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->unrealize (widget);
1483 gtk_menu_item_map (GtkWidget *widget)
1485 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1486 GtkMenuItemPrivate *priv = menu_item->priv;
1488 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->map (widget);
1490 gdk_window_show (priv->event_window);
1494 gtk_menu_item_unmap (GtkWidget *widget)
1496 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1497 GtkMenuItemPrivate *priv = menu_item->priv;
1499 gdk_window_hide (priv->event_window);
1501 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->unmap (widget);
1505 gtk_menu_item_enter (GtkWidget *widget,
1506 GdkEventCrossing *event)
1508 g_return_val_if_fail (event != NULL, FALSE);
1510 return gtk_widget_event (gtk_widget_get_parent (widget), (GdkEvent *) event);
1514 gtk_menu_item_leave (GtkWidget *widget,
1515 GdkEventCrossing *event)
1517 g_return_val_if_fail (event != NULL, FALSE);
1519 return gtk_widget_event (gtk_widget_get_parent (widget), (GdkEvent*) event);
1523 gtk_menu_item_draw (GtkWidget *widget,
1526 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1527 GtkMenuItemPrivate *priv = menu_item->priv;
1528 GtkStateType state_type;
1529 GtkShadowType shadow_type, selected_shadow_type;
1531 GtkWidget *child, *parent;
1533 gint x, y, w, h, width, height;
1534 guint border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
1536 state_type = gtk_widget_get_state (widget);
1537 style = gtk_widget_get_style (widget);
1538 window = gtk_widget_get_window (widget);
1539 width = gtk_widget_get_allocated_width (widget);
1540 height = gtk_widget_get_allocated_height (widget);
1544 w = width - border_width * 2;
1545 h = height - border_width * 2;
1547 child = gtk_bin_get_child (GTK_BIN (menu_item));
1548 parent = gtk_widget_get_parent (widget);
1550 if (child && state_type == GTK_STATE_PRELIGHT)
1552 gtk_widget_style_get (widget,
1553 "selected-shadow-type", &selected_shadow_type,
1555 gtk_paint_box (style,
1558 selected_shadow_type,
1563 if (menu_item->submenu && !GTK_IS_MENU_BAR (parent))
1565 gint arrow_x, arrow_y;
1567 guint horizontal_padding;
1568 GtkTextDirection direction;
1569 GtkArrowType arrow_type;
1571 direction = gtk_widget_get_direction (widget);
1573 gtk_widget_style_get (widget,
1574 "horizontal-padding", &horizontal_padding,
1577 get_arrow_size (widget, child, &arrow_size);
1579 shadow_type = GTK_SHADOW_OUT;
1580 if (state_type == GTK_STATE_PRELIGHT)
1581 shadow_type = GTK_SHADOW_IN;
1583 if (direction == GTK_TEXT_DIR_LTR)
1585 arrow_x = x + w - horizontal_padding - arrow_size;
1586 arrow_type = GTK_ARROW_RIGHT;
1590 arrow_x = x + horizontal_padding;
1591 arrow_type = GTK_ARROW_LEFT;
1594 arrow_y = y + (h - arrow_size) / 2;
1596 gtk_paint_arrow (style, cr,
1597 state_type, shadow_type,
1601 arrow_size, arrow_size);
1605 gboolean wide_separators;
1606 gint separator_height;
1607 guint horizontal_padding;
1609 gtk_widget_style_get (widget,
1610 "wide-separators", &wide_separators,
1611 "separator-height", &separator_height,
1612 "horizontal-padding", &horizontal_padding,
1615 if (wide_separators)
1616 gtk_paint_box (style, cr,
1617 GTK_STATE_NORMAL, GTK_SHADOW_ETCHED_OUT,
1618 widget, "hseparator",
1619 horizontal_padding + style->xthickness,
1620 (height - separator_height - style->ythickness) / 2,
1621 width - 2 * (horizontal_padding + style->xthickness),
1624 gtk_paint_hline (style, cr,
1625 GTK_STATE_NORMAL, widget, "menuitem",
1626 horizontal_padding + style->xthickness,
1627 width - horizontal_padding - style->xthickness - 1,
1628 (height - style->ythickness) / 2);
1631 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->draw (widget, cr);
1637 gtk_real_menu_item_select (GtkMenuItem *menu_item)
1639 GtkMenuItemPrivate *priv = menu_item->priv;
1640 gboolean touchscreen_mode;
1642 g_object_get (gtk_widget_get_settings (GTK_WIDGET (menu_item)),
1643 "gtk-touchscreen-mode", &touchscreen_mode,
1646 if (!touchscreen_mode && priv->submenu &&
1647 (!gtk_widget_get_mapped (priv->submenu) ||
1648 GTK_MENU (priv->submenu)->priv->tearoff_active))
1650 _gtk_menu_item_popup_submenu (GTK_WIDGET (menu_item), TRUE);
1653 gtk_widget_set_state_flags (GTK_WIDGET (menu_item),
1654 GTK_STATE_FLAG_PRELIGHT, FALSE);
1655 gtk_widget_queue_draw (GTK_WIDGET (menu_item));
1659 gtk_real_menu_item_deselect (GtkMenuItem *menu_item)
1661 GtkMenuItemPrivate *priv = menu_item->priv;
1664 _gtk_menu_item_popdown_submenu (GTK_WIDGET (menu_item));
1666 gtk_widget_unset_state_flags (GTK_WIDGET (menu_item),
1667 GTK_STATE_FLAG_PRELIGHT);
1668 gtk_widget_queue_draw (GTK_WIDGET (menu_item));
1672 gtk_menu_item_mnemonic_activate (GtkWidget *widget,
1673 gboolean group_cycling)
1677 parent = gtk_widget_get_parent (widget);
1679 if (GTK_IS_MENU_SHELL (parent))
1680 _gtk_menu_shell_set_keyboard_mode (GTK_MENU_SHELL (parent), TRUE);
1682 if (group_cycling &&
1684 GTK_IS_MENU_SHELL (parent) &&
1685 GTK_MENU_SHELL (parent)->priv->active)
1687 gtk_menu_shell_select_item (GTK_MENU_SHELL (parent), widget);
1690 g_signal_emit (widget, menu_item_signals[ACTIVATE_ITEM], 0);
1696 gtk_real_menu_item_activate (GtkMenuItem *menu_item)
1698 GtkMenuItemPrivate *priv = menu_item->priv;
1701 gtk_action_activate (priv->action);
1706 gtk_real_menu_item_activate_item (GtkMenuItem *menu_item)
1708 GtkMenuItemPrivate *priv = menu_item->priv;
1712 widget = GTK_WIDGET (menu_item);
1713 parent = gtk_widget_get_parent (widget);
1715 if (parent && GTK_IS_MENU_SHELL (parent))
1717 GtkMenuShell *menu_shell = GTK_MENU_SHELL (parent);
1719 if (priv->submenu == NULL)
1720 gtk_menu_shell_activate_item (menu_shell, widget, TRUE);
1723 _gtk_menu_shell_activate (menu_shell);
1725 gtk_menu_shell_select_item (menu_shell, widget);
1726 _gtk_menu_item_popup_submenu (widget, FALSE);
1728 gtk_menu_shell_select_first (GTK_MENU_SHELL (priv->submenu), TRUE);
1734 gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
1737 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1743 gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
1746 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1748 menu_item->priv->toggle_size = allocation;
1752 gtk_real_menu_item_set_label (GtkMenuItem *menu_item,
1757 gtk_menu_item_ensure_label (menu_item);
1759 child = gtk_bin_get_child (GTK_BIN (menu_item));
1760 if (GTK_IS_LABEL (child))
1762 gtk_label_set_label (GTK_LABEL (child), label ? label : "");
1764 g_object_notify (G_OBJECT (menu_item), "label");
1768 static G_CONST_RETURN gchar *
1769 gtk_real_menu_item_get_label (GtkMenuItem *menu_item)
1773 gtk_menu_item_ensure_label (menu_item);
1775 child = gtk_bin_get_child (GTK_BIN (menu_item));
1776 if (GTK_IS_LABEL (child))
1777 return gtk_label_get_label (GTK_LABEL (child));
1783 free_timeval (GTimeVal *val)
1785 g_slice_free (GTimeVal, val);
1789 gtk_menu_item_real_popup_submenu (GtkWidget *widget,
1790 gboolean remember_exact_time)
1792 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1793 GtkMenuItemPrivate *priv = menu_item->priv;
1796 parent = gtk_widget_get_parent (widget);
1798 if (gtk_widget_is_sensitive (priv->submenu) && parent)
1800 gboolean take_focus;
1801 GtkMenuPositionFunc menu_position_func;
1803 take_focus = gtk_menu_shell_get_take_focus (GTK_MENU_SHELL (parent));
1804 gtk_menu_shell_set_take_focus (GTK_MENU_SHELL (priv->submenu), take_focus);
1806 if (remember_exact_time)
1808 GTimeVal *popup_time = g_slice_new0 (GTimeVal);
1810 g_get_current_time (popup_time);
1812 g_object_set_data_full (G_OBJECT (priv->submenu),
1813 "gtk-menu-exact-popup-time", popup_time,
1814 (GDestroyNotify) free_timeval);
1818 g_object_set_data (G_OBJECT (priv->submenu),
1819 "gtk-menu-exact-popup-time", NULL);
1822 /* gtk_menu_item_position_menu positions the submenu from the
1823 * menuitems position. If the menuitem doesn't have a window,
1824 * that doesn't work. In that case we use the default
1825 * positioning function instead which places the submenu at the
1828 if (gtk_widget_get_window (widget))
1829 menu_position_func = gtk_menu_item_position_menu;
1831 menu_position_func = NULL;
1833 gtk_menu_popup (GTK_MENU (priv->submenu),
1838 GTK_MENU_SHELL (parent)->priv->button,
1842 /* Enable themeing of the parent menu item depending on whether
1843 * its submenu is shown or not.
1845 gtk_widget_queue_draw (widget);
1849 gtk_menu_item_popup_timeout (gpointer data)
1851 GtkMenuItem *menu_item = GTK_MENU_ITEM (data);
1852 GtkMenuItemPrivate *priv = menu_item->priv;
1855 parent = gtk_widget_get_parent (GTK_WIDGET (menu_item));
1857 if ((GTK_IS_MENU_SHELL (parent) && GTK_MENU_SHELL (parent)->priv->active) ||
1858 (GTK_IS_MENU (parent) && GTK_MENU (parent)->priv->torn_off))
1860 gtk_menu_item_real_popup_submenu (GTK_WIDGET (menu_item), TRUE);
1861 if (priv->timer_from_keypress && priv->submenu)
1862 GTK_MENU_SHELL (priv->submenu)->priv->ignore_enter = TRUE;
1871 get_popup_delay (GtkWidget *widget)
1875 parent = gtk_widget_get_parent (widget);
1876 if (GTK_IS_MENU_SHELL (parent))
1878 return _gtk_menu_shell_get_popup_delay (GTK_MENU_SHELL (parent));
1884 g_object_get (gtk_widget_get_settings (widget),
1885 "gtk-menu-popup-delay", &popup_delay,
1893 _gtk_menu_item_popup_submenu (GtkWidget *widget,
1894 gboolean with_delay)
1896 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1897 GtkMenuItemPrivate *priv = menu_item->priv;
1901 g_source_remove (priv->timer);
1908 gint popup_delay = get_popup_delay (widget);
1910 if (popup_delay > 0)
1912 GdkEvent *event = gtk_get_current_event ();
1914 priv->timer = gdk_threads_add_timeout (popup_delay,
1915 gtk_menu_item_popup_timeout,
1919 event->type != GDK_BUTTON_PRESS &&
1920 event->type != GDK_ENTER_NOTIFY)
1921 priv->timer_from_keypress = TRUE;
1923 priv->timer_from_keypress = FALSE;
1926 gdk_event_free (event);
1932 gtk_menu_item_real_popup_submenu (widget, FALSE);
1936 _gtk_menu_item_popdown_submenu (GtkWidget *widget)
1938 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1939 GtkMenuItemPrivate *priv = menu_item->priv;
1943 g_object_set_data (G_OBJECT (priv->submenu),
1944 "gtk-menu-exact-popup-time", NULL);
1948 g_source_remove (priv->timer);
1952 gtk_menu_popdown (GTK_MENU (priv->submenu));
1954 gtk_widget_queue_draw (widget);
1959 get_offsets (GtkMenu *menu,
1960 gint *horizontal_offset,
1961 gint *vertical_offset)
1963 gint vertical_padding;
1964 gint horizontal_padding;
1966 gtk_widget_style_get (GTK_WIDGET (menu),
1967 "horizontal-offset", horizontal_offset,
1968 "vertical-offset", vertical_offset,
1969 "horizontal-padding", &horizontal_padding,
1970 "vertical-padding", &vertical_padding,
1973 *vertical_offset -= gtk_widget_get_style (GTK_WIDGET (menu))->ythickness;
1974 *vertical_offset -= vertical_padding;
1975 *horizontal_offset += horizontal_padding;
1979 gtk_menu_item_position_menu (GtkMenu *menu,
1985 GtkMenuItem *menu_item = GTK_MENU_ITEM (user_data);
1986 GtkMenuItemPrivate *priv = menu_item->priv;
1987 GtkAllocation allocation;
1989 GtkMenuItem *parent_menu_item;
1990 GtkRequisition requisition;
1993 gint twidth, theight;
1995 GtkTextDirection direction;
1996 GdkRectangle monitor;
1998 gint horizontal_offset;
1999 gint vertical_offset;
2000 gint parent_xthickness;
2001 gint available_left, available_right;
2003 g_return_if_fail (menu != NULL);
2004 g_return_if_fail (x != NULL);
2005 g_return_if_fail (y != NULL);
2007 widget = GTK_WIDGET (user_data);
2012 direction = gtk_widget_get_direction (widget);
2014 gtk_widget_get_preferred_size (GTK_WIDGET (menu), &requisition, NULL);
2015 twidth = requisition.width;
2016 theight = requisition.height;
2018 screen = gtk_widget_get_screen (GTK_WIDGET (menu));
2019 monitor_num = gdk_screen_get_monitor_at_window (screen, priv->event_window);
2020 if (monitor_num < 0)
2022 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
2024 if (!gdk_window_get_origin (gtk_widget_get_window (widget), &tx, &ty))
2026 g_warning ("Menu not on screen");
2030 gtk_widget_get_allocation (widget, &allocation);
2035 get_offsets (menu, &horizontal_offset, &vertical_offset);
2037 available_left = tx - monitor.x;
2038 available_right = monitor.x + monitor.width - (tx + allocation.width);
2040 parent = gtk_widget_get_parent (widget);
2041 if (GTK_IS_MENU_BAR (parent))
2043 priv->from_menubar = TRUE;
2045 else if (GTK_IS_MENU (parent))
2047 if (GTK_MENU (parent)->priv->parent_menu_item)
2048 priv->from_menubar = GTK_MENU_ITEM (GTK_MENU (parent)->priv->parent_menu_item)->priv->from_menubar;
2050 priv->from_menubar = FALSE;
2054 priv->from_menubar = FALSE;
2057 switch (priv->submenu_placement)
2059 case GTK_TOP_BOTTOM:
2060 if (direction == GTK_TEXT_DIR_LTR)
2061 priv->submenu_direction = GTK_DIRECTION_RIGHT;
2064 priv->submenu_direction = GTK_DIRECTION_LEFT;
2065 tx += allocation.width - twidth;
2067 if ((ty + allocation.height + theight) <= monitor.y + monitor.height)
2068 ty += allocation.height;
2069 else if ((ty - theight) >= monitor.y)
2071 else if (monitor.y + monitor.height - (ty + allocation.height) > ty)
2072 ty += allocation.height;
2077 case GTK_LEFT_RIGHT:
2078 if (GTK_IS_MENU (parent))
2079 parent_menu_item = GTK_MENU_ITEM (GTK_MENU (parent)->priv->parent_menu_item);
2081 parent_menu_item = NULL;
2083 parent_xthickness = gtk_widget_get_style (parent)->xthickness;
2085 if (parent_menu_item && !GTK_MENU (parent)->priv->torn_off)
2087 priv->submenu_direction = parent_menu_item->priv->submenu_direction;
2091 if (direction == GTK_TEXT_DIR_LTR)
2092 priv->submenu_direction = GTK_DIRECTION_RIGHT;
2094 priv->submenu_direction = GTK_DIRECTION_LEFT;
2097 switch (priv->submenu_direction)
2099 case GTK_DIRECTION_LEFT:
2100 if (tx - twidth - parent_xthickness - horizontal_offset >= monitor.x ||
2101 available_left >= available_right)
2102 tx -= twidth + parent_xthickness + horizontal_offset;
2105 priv->submenu_direction = GTK_DIRECTION_RIGHT;
2106 tx += allocation.width + parent_xthickness + horizontal_offset;
2110 case GTK_DIRECTION_RIGHT:
2111 if (tx + allocation.width + parent_xthickness + horizontal_offset + twidth <= monitor.x + monitor.width ||
2112 available_right >= available_left)
2113 tx += allocation.width + parent_xthickness + horizontal_offset;
2116 priv->submenu_direction = GTK_DIRECTION_LEFT;
2117 tx -= twidth + parent_xthickness + horizontal_offset;
2122 ty += vertical_offset;
2124 /* If the height of the menu doesn't fit we move it upward. */
2125 ty = CLAMP (ty, monitor.y, MAX (monitor.y, monitor.y + monitor.height - theight));
2129 /* If we have negative, tx, here it is because we can't get
2130 * the menu all the way on screen. Favor the left portion.
2132 *x = CLAMP (tx, monitor.x, MAX (monitor.x, monitor.x + monitor.width - twidth));
2135 gtk_menu_set_monitor (menu, monitor_num);
2137 if (!gtk_widget_get_visible (menu->priv->toplevel))
2139 gtk_window_set_type_hint (GTK_WINDOW (menu->priv->toplevel), priv->from_menubar?
2140 GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU : GDK_WINDOW_TYPE_HINT_POPUP_MENU);
2145 * gtk_menu_item_set_right_justified:
2146 * @menu_item: a #GtkMenuItem.
2147 * @right_justified: if %TRUE the menu item will appear at the
2148 * far right if added to a menu bar
2150 * Sets whether the menu item appears justified at the right
2151 * side of a menu bar. This was traditionally done for "Help"
2152 * menu items, but is now considered a bad idea. (If the widget
2153 * layout is reversed for a right-to-left language like Hebrew
2154 * or Arabic, right-justified-menu-items appear at the left.)
2157 gtk_menu_item_set_right_justified (GtkMenuItem *menu_item,
2158 gboolean right_justified)
2160 GtkMenuItemPrivate *priv = menu_item->priv;
2162 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
2164 right_justified = right_justified != FALSE;
2166 if (priv->right_justify != right_justified)
2168 priv->right_justify = right_justified;
2169 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
2174 * gtk_menu_item_get_right_justified:
2175 * @menu_item: a #GtkMenuItem
2177 * Gets whether the menu item appears justified at the right
2178 * side of the menu bar.
2180 * Return value: %TRUE if the menu item will appear at the
2181 * far right if added to a menu bar.
2184 gtk_menu_item_get_right_justified (GtkMenuItem *menu_item)
2186 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), FALSE);
2188 return menu_item->priv->right_justify;
2193 gtk_menu_item_show_all (GtkWidget *widget)
2195 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
2196 GtkMenuItemPrivate *priv = menu_item->priv;
2198 /* show children including submenu */
2200 gtk_widget_show_all (priv->submenu);
2201 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_show_all, NULL);
2203 gtk_widget_show (widget);
2207 gtk_menu_item_can_activate_accel (GtkWidget *widget,
2212 parent = gtk_widget_get_parent (widget);
2214 /* Chain to the parent GtkMenu for further checks */
2215 return (gtk_widget_is_sensitive (widget) && gtk_widget_get_visible (widget) &&
2216 parent && gtk_widget_can_activate_accel (parent, signal_id));
2220 gtk_menu_item_accel_name_foreach (GtkWidget *widget,
2223 const gchar **path_p = data;
2227 if (GTK_IS_LABEL (widget))
2229 *path_p = gtk_label_get_text (GTK_LABEL (widget));
2230 if (*path_p && (*path_p)[0] == 0)
2233 else if (GTK_IS_CONTAINER (widget))
2234 gtk_container_foreach (GTK_CONTAINER (widget),
2235 gtk_menu_item_accel_name_foreach,
2241 gtk_menu_item_parent_set (GtkWidget *widget,
2242 GtkWidget *previous_parent)
2244 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
2248 parent = gtk_widget_get_parent (widget);
2249 menu = GTK_IS_MENU (parent) ? GTK_MENU (parent) : NULL;
2252 _gtk_menu_item_refresh_accel_path (menu_item,
2253 menu->priv->accel_path,
2254 menu->priv->accel_group,
2257 if (GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->parent_set)
2258 GTK_WIDGET_CLASS (gtk_menu_item_parent_class)->parent_set (widget, previous_parent);
2262 _gtk_menu_item_refresh_accel_path (GtkMenuItem *menu_item,
2263 const gchar *prefix,
2264 GtkAccelGroup *accel_group,
2265 gboolean group_changed)
2267 GtkMenuItemPrivate *priv = menu_item->priv;
2271 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
2272 g_return_if_fail (!accel_group || GTK_IS_ACCEL_GROUP (accel_group));
2274 widget = GTK_WIDGET (menu_item);
2278 gtk_widget_set_accel_path (widget, NULL, NULL);
2282 path = _gtk_widget_get_accel_path (widget, NULL);
2283 if (!path) /* no active accel_path yet */
2285 path = priv->accel_path;
2286 if (!path && prefix)
2288 const gchar *postfix = NULL;
2291 /* try to construct one from label text */
2292 gtk_container_foreach (GTK_CONTAINER (menu_item),
2293 gtk_menu_item_accel_name_foreach,
2297 new_path = g_strconcat (prefix, "/", postfix, NULL);
2298 path = priv->accel_path = (char*)g_intern_string (new_path);
2303 gtk_widget_set_accel_path (widget, path, accel_group);
2305 else if (group_changed) /* reinstall accelerators */
2306 gtk_widget_set_accel_path (widget, path, accel_group);
2310 * gtk_menu_item_set_accel_path
2311 * @menu_item: a valid #GtkMenuItem
2312 * @accel_path: (allow-none): accelerator path, corresponding to this menu
2313 * item's functionality, or %NULL to unset the current path.
2315 * Set the accelerator path on @menu_item, through which runtime
2316 * changes of the menu item's accelerator caused by the user can be
2317 * identified and saved to persistent storage (see gtk_accel_map_save()
2318 * on this). To set up a default accelerator for this menu item, call
2319 * gtk_accel_map_add_entry() with the same @accel_path. See also
2320 * gtk_accel_map_add_entry() on the specifics of accelerator paths,
2321 * and gtk_menu_set_accel_path() for a more convenient variant of
2324 * This function is basically a convenience wrapper that handles
2325 * calling gtk_widget_set_accel_path() with the appropriate accelerator
2326 * group for the menu item.
2328 * Note that you do need to set an accelerator on the parent menu with
2329 * gtk_menu_set_accel_group() for this to work.
2331 * Note that @accel_path string will be stored in a #GQuark.
2332 * Therefore, if you pass a static string, you can save some memory
2333 * by interning it first with g_intern_static_string().
2336 gtk_menu_item_set_accel_path (GtkMenuItem *menu_item,
2337 const gchar *accel_path)
2339 GtkMenuItemPrivate *priv = menu_item->priv;
2343 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
2344 g_return_if_fail (accel_path == NULL ||
2345 (accel_path[0] == '<' && strchr (accel_path, '/')));
2347 widget = GTK_WIDGET (menu_item);
2349 /* store new path */
2350 priv->accel_path = (char*)g_intern_string (accel_path);
2352 /* forget accelerators associated with old path */
2353 gtk_widget_set_accel_path (widget, NULL, NULL);
2355 /* install accelerators associated with new path */
2356 parent = gtk_widget_get_parent (widget);
2357 if (GTK_IS_MENU (parent))
2359 GtkMenu *menu = GTK_MENU (parent);
2361 if (menu->priv->accel_group)
2362 _gtk_menu_item_refresh_accel_path (GTK_MENU_ITEM (widget),
2364 menu->priv->accel_group,
2370 * gtk_menu_item_get_accel_path
2371 * @menu_item: a valid #GtkMenuItem
2373 * Retrieve the accelerator path that was previously set on @menu_item.
2375 * See gtk_menu_item_set_accel_path() for details.
2377 * Returns: the accelerator path corresponding to this menu
2378 * item's functionality, or %NULL if not set
2382 G_CONST_RETURN gchar *
2383 gtk_menu_item_get_accel_path (GtkMenuItem *menu_item)
2385 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);
2387 return menu_item->priv->accel_path;
2391 gtk_menu_item_forall (GtkContainer *container,
2392 gboolean include_internals,
2393 GtkCallback callback,
2394 gpointer callback_data)
2398 g_return_if_fail (GTK_IS_MENU_ITEM (container));
2399 g_return_if_fail (callback != NULL);
2401 child = gtk_bin_get_child (GTK_BIN (container));
2403 callback (child, callback_data);
2407 _gtk_menu_item_is_selectable (GtkWidget *menu_item)
2409 if ((!gtk_bin_get_child (GTK_BIN (menu_item)) &&
2410 G_OBJECT_TYPE (menu_item) == GTK_TYPE_MENU_ITEM) ||
2411 GTK_IS_SEPARATOR_MENU_ITEM (menu_item) ||
2412 !gtk_widget_is_sensitive (menu_item) ||
2413 !gtk_widget_get_visible (menu_item))
2420 gtk_menu_item_ensure_label (GtkMenuItem *menu_item)
2422 GtkWidget *accel_label;
2424 if (!gtk_bin_get_child (GTK_BIN (menu_item)))
2426 accel_label = g_object_new (GTK_TYPE_ACCEL_LABEL, NULL);
2427 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
2429 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
2430 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label),
2431 GTK_WIDGET (menu_item));
2432 gtk_widget_show (accel_label);
2437 * gtk_menu_item_set_label:
2438 * @menu_item: a #GtkMenuItem
2439 * @label: the text you want to set
2441 * Sets @text on the @menu_item label
2446 gtk_menu_item_set_label (GtkMenuItem *menu_item,
2449 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
2451 GTK_MENU_ITEM_GET_CLASS (menu_item)->set_label (menu_item, label);
2455 * gtk_menu_item_get_label:
2456 * @menu_item: a #GtkMenuItem
2458 * Sets @text on the @menu_item label
2460 * Returns: The text in the @menu_item label. This is the internal
2461 * string used by the label, and must not be modified.
2465 G_CONST_RETURN gchar *
2466 gtk_menu_item_get_label (GtkMenuItem *menu_item)
2468 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);
2470 return GTK_MENU_ITEM_GET_CLASS (menu_item)->get_label (menu_item);
2474 * gtk_menu_item_set_use_underline:
2475 * @menu_item: a #GtkMenuItem
2476 * @setting: %TRUE if underlines in the text indicate mnemonics
2478 * If true, an underline in the text indicates the next character
2479 * should be used for the mnemonic accelerator key.
2484 gtk_menu_item_set_use_underline (GtkMenuItem *menu_item,
2489 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
2491 gtk_menu_item_ensure_label (menu_item);
2493 child = gtk_bin_get_child (GTK_BIN (menu_item));
2494 if (GTK_IS_LABEL (child))
2496 gtk_label_set_use_underline (GTK_LABEL (child), setting);
2498 g_object_notify (G_OBJECT (menu_item), "use-underline");
2503 * gtk_menu_item_get_use_underline:
2504 * @menu_item: a #GtkMenuItem
2506 * Checks if an underline in the text indicates the next character
2507 * should be used for the mnemonic accelerator key.
2509 * Return value: %TRUE if an embedded underline in the label
2510 * indicates the mnemonic accelerator key.
2515 gtk_menu_item_get_use_underline (GtkMenuItem *menu_item)
2519 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), FALSE);
2521 gtk_menu_item_ensure_label (menu_item);
2523 child = gtk_bin_get_child (GTK_BIN (menu_item));
2524 if (GTK_IS_LABEL (child))
2525 return gtk_label_get_use_underline (GTK_LABEL (child));
2531 gtk_menu_item_set_reserve_indicator (GtkMenuItem *menu_item,
2534 GtkMenuItemPrivate *priv;
2536 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
2538 priv = GET_PRIVATE (menu_item);
2540 if (priv->reserve_indicator != reserve)
2542 priv->reserve_indicator = reserve;
2543 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
2548 gtk_menu_item_get_reserve_indicator (GtkMenuItem *menu_item)
2550 GtkMenuItemPrivate *priv;
2552 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), FALSE);
2554 priv = GET_PRIVATE (menu_item);
2556 return priv->reserve_indicator;