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
30 #include "gtkaccellabel.h"
32 #include "gtkmarshalers.h"
34 #include "gtkmenubar.h"
35 #include "gtkmenuitem.h"
36 #include "gtkseparatormenuitem.h"
37 #include "gtksignal.h"
40 #define BORDER_SPACING 3
41 #define SELECT_TIMEOUT 75
43 #define MENU_ITEM_CLASS(w) GTK_MENU_ITEM_CLASS (GTK_OBJECT (w)->klass)
55 static void gtk_menu_item_class_init (GtkMenuItemClass *klass);
56 static void gtk_menu_item_init (GtkMenuItem *menu_item);
57 static void gtk_menu_item_destroy (GtkObject *object);
58 static void gtk_menu_item_finalize (GObject *object);
59 static void gtk_menu_item_size_request (GtkWidget *widget,
60 GtkRequisition *requisition);
61 static void gtk_menu_item_size_allocate (GtkWidget *widget,
62 GtkAllocation *allocation);
63 static void gtk_menu_item_realize (GtkWidget *widget);
64 static void gtk_menu_item_unrealize (GtkWidget *widget);
65 static void gtk_menu_item_map (GtkWidget *widget);
66 static void gtk_menu_item_unmap (GtkWidget *widget);
67 static void gtk_menu_item_paint (GtkWidget *widget,
69 static gint gtk_menu_item_expose (GtkWidget *widget,
70 GdkEventExpose *event);
71 static void gtk_menu_item_parent_set (GtkWidget *widget,
72 GtkWidget *previous_parent);
75 static void gtk_real_menu_item_select (GtkItem *item);
76 static void gtk_real_menu_item_deselect (GtkItem *item);
77 static void gtk_real_menu_item_activate_item (GtkMenuItem *item);
78 static void gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
80 static void gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
82 static gboolean gtk_menu_item_mnemonic_activate (GtkWidget *widget,
83 gboolean group_cycling);
85 static gint gtk_menu_item_select_timeout (gpointer data);
86 static void gtk_menu_item_popup_submenu (gpointer data);
87 static void gtk_menu_item_position_menu (GtkMenu *menu,
92 static void gtk_menu_item_show_all (GtkWidget *widget);
93 static void gtk_menu_item_hide_all (GtkWidget *widget);
94 static void gtk_menu_item_forall (GtkContainer *container,
95 gboolean include_internals,
97 gpointer callback_data);
100 static GtkItemClass *parent_class;
101 static guint menu_item_signals[LAST_SIGNAL] = { 0 };
102 static guint32 last_submenu_deselect_time = 0;
107 gtk_menu_item_get_type (void)
109 static GtkType menu_item_type = 0;
113 static const GTypeInfo menu_item_info =
115 sizeof (GtkMenuItemClass),
116 NULL, /* base_init */
117 NULL, /* base_finalize */
118 (GClassInitFunc) gtk_menu_item_class_init,
119 NULL, /* class_finalize */
120 NULL, /* class_data */
121 sizeof (GtkMenuItem),
122 16, /* n_preallocs */
123 (GInstanceInitFunc) gtk_menu_item_init,
126 menu_item_type = g_type_register_static (GTK_TYPE_ITEM, "GtkMenuItem", &menu_item_info, 0);
129 return menu_item_type;
133 gtk_menu_item_class_init (GtkMenuItemClass *klass)
135 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
136 GtkObjectClass *object_class = GTK_OBJECT_CLASS (klass);
137 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
138 GtkContainerClass *container_class = GTK_CONTAINER_CLASS (klass);
139 GtkItemClass *item_class = GTK_ITEM_CLASS (klass);
141 parent_class = g_type_class_peek_parent (klass);
143 gobject_class->finalize = gtk_menu_item_finalize;
145 object_class->destroy = gtk_menu_item_destroy;
147 widget_class->size_request = gtk_menu_item_size_request;
148 widget_class->size_allocate = gtk_menu_item_size_allocate;
149 widget_class->expose_event = gtk_menu_item_expose;
150 widget_class->realize = gtk_menu_item_realize;
151 widget_class->unrealize = gtk_menu_item_unrealize;
152 widget_class->map = gtk_menu_item_map;
153 widget_class->unmap = gtk_menu_item_unmap;
154 widget_class->show_all = gtk_menu_item_show_all;
155 widget_class->hide_all = gtk_menu_item_hide_all;
156 widget_class->mnemonic_activate = gtk_menu_item_mnemonic_activate;
157 widget_class->parent_set = gtk_menu_item_parent_set;
159 container_class->forall = gtk_menu_item_forall;
161 item_class->select = gtk_real_menu_item_select;
162 item_class->deselect = gtk_real_menu_item_deselect;
164 klass->activate = NULL;
165 klass->activate_item = gtk_real_menu_item_activate_item;
166 klass->toggle_size_request = gtk_real_menu_item_toggle_size_request;
167 klass->toggle_size_allocate = gtk_real_menu_item_toggle_size_allocate;
169 klass->hide_on_activate = TRUE;
171 menu_item_signals[ACTIVATE] =
172 gtk_signal_new ("activate",
173 GTK_RUN_FIRST | GTK_RUN_ACTION,
174 GTK_CLASS_TYPE (object_class),
175 GTK_SIGNAL_OFFSET (GtkMenuItemClass, activate),
176 _gtk_marshal_VOID__VOID,
178 widget_class->activate_signal = menu_item_signals[ACTIVATE];
180 menu_item_signals[ACTIVATE_ITEM] =
181 gtk_signal_new ("activate_item",
183 GTK_CLASS_TYPE (object_class),
184 GTK_SIGNAL_OFFSET (GtkMenuItemClass, activate_item),
185 gtk_signal_default_marshaller,
188 menu_item_signals[TOGGLE_SIZE_REQUEST] =
189 gtk_signal_new ("toggle_size_request",
191 GTK_CLASS_TYPE (object_class),
192 GTK_SIGNAL_OFFSET (GtkMenuItemClass, toggle_size_request),
193 _gtk_marshal_VOID__POINTER,
197 menu_item_signals[TOGGLE_SIZE_ALLOCATE] =
198 gtk_signal_new ("toggle_size_allocate",
200 GTK_CLASS_TYPE (object_class),
201 GTK_SIGNAL_OFFSET (GtkMenuItemClass, toggle_size_allocate),
202 _gtk_marshal_NONE__INT,
206 gtk_widget_class_install_style_property_parser (widget_class,
207 g_param_spec_enum ("selected_shadow_type",
208 "Selected Shadow Type",
209 "Shadow type when item is selected",
210 GTK_TYPE_SHADOW_TYPE,
213 gtk_rc_property_parse_enum);
217 gtk_menu_item_init (GtkMenuItem *menu_item)
219 GTK_WIDGET_SET_FLAGS (menu_item, GTK_NO_WINDOW);
221 menu_item->submenu = NULL;
222 menu_item->toggle_size = 0;
223 menu_item->accelerator_width = 0;
224 menu_item->show_submenu_indicator = FALSE;
225 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
226 menu_item->submenu_placement = GTK_TOP_BOTTOM;
227 menu_item->right_justify = FALSE;
229 menu_item->timer = 0;
233 gtk_menu_item_new (void)
235 return GTK_WIDGET (gtk_type_new (gtk_menu_item_get_type ()));
239 gtk_menu_item_new_with_label (const gchar *label)
241 GtkWidget *menu_item;
242 GtkWidget *accel_label;
244 menu_item = gtk_menu_item_new ();
245 accel_label = gtk_accel_label_new (label);
246 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
248 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
249 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
250 gtk_widget_show (accel_label);
257 * gtk_menu_item_new_with_mnemonic:
258 * @label: The text of the button, with an underscore in front of the
260 * @returns: a new #GtkMenuItem
262 * Creates a new #GtkMenuItem containing a label. The label
263 * will be created using gtk_label_new_with_mnemonic(), so underscores
264 * in @label indicate the mnemonic for the menu item.
267 gtk_menu_item_new_with_mnemonic (const gchar *label)
269 GtkWidget *menu_item;
270 GtkWidget *accel_label;
272 menu_item = gtk_menu_item_new ();
273 accel_label = gtk_type_new (GTK_TYPE_ACCEL_LABEL);
274 gtk_label_set_text_with_mnemonic (GTK_LABEL (accel_label), label);
275 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
277 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
278 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
279 gtk_widget_show (accel_label);
285 gtk_menu_item_destroy (GtkObject *object)
287 GtkMenuItem *menu_item;
289 g_return_if_fail (GTK_IS_MENU_ITEM (object));
291 menu_item = GTK_MENU_ITEM (object);
293 if (menu_item->submenu)
294 gtk_widget_destroy (menu_item->submenu);
296 GTK_OBJECT_CLASS (parent_class)->destroy (object);
300 gtk_menu_item_finalize (GObject *object)
302 GtkMenuItem *menu_item = GTK_MENU_ITEM (object);
304 g_free (menu_item->accel_path);
306 G_OBJECT_CLASS (parent_class)->finalize (object);
310 gtk_menu_item_detacher (GtkWidget *widget,
313 GtkMenuItem *menu_item;
315 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
317 menu_item = GTK_MENU_ITEM (widget);
318 g_return_if_fail (menu_item->submenu == (GtkWidget*) menu);
320 menu_item->submenu = NULL;
324 gtk_menu_item_set_submenu (GtkMenuItem *menu_item,
327 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
329 if (menu_item->submenu != submenu)
331 gtk_menu_item_remove_submenu (menu_item);
333 menu_item->submenu = submenu;
334 gtk_menu_attach_to_widget (GTK_MENU (submenu),
335 GTK_WIDGET (menu_item),
336 gtk_menu_item_detacher);
338 if (GTK_WIDGET (menu_item)->parent)
339 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
344 * gtk_menu_item_get_submenu:
345 * @menu_item: a #GtkMenuItem
347 * Gets the submenu underneath this menu item, if any. See
348 * gtk_menu_item_set_submenu().
350 * Return value: submenu for this menu item, or %NULL if none.
353 gtk_menu_item_get_submenu (GtkMenuItem *menu_item)
355 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);
357 return menu_item->submenu;
361 gtk_menu_item_remove_submenu (GtkMenuItem *menu_item)
363 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
365 if (menu_item->submenu)
366 gtk_menu_detach (GTK_MENU (menu_item->submenu));
369 void _gtk_menu_item_set_placement (GtkMenuItem *menu_item,
370 GtkSubmenuPlacement placement);
373 _gtk_menu_item_set_placement (GtkMenuItem *menu_item,
374 GtkSubmenuPlacement placement)
376 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
378 menu_item->submenu_placement = placement;
382 gtk_menu_item_select (GtkMenuItem *menu_item)
384 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
386 gtk_item_select (GTK_ITEM (menu_item));
390 gtk_menu_item_deselect (GtkMenuItem *menu_item)
392 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
394 gtk_item_deselect (GTK_ITEM (menu_item));
398 gtk_menu_item_activate (GtkMenuItem *menu_item)
400 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
402 gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[ACTIVATE]);
406 gtk_menu_item_toggle_size_request (GtkMenuItem *menu_item,
409 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
411 gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[TOGGLE_SIZE_REQUEST], requisition);
415 gtk_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
418 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
420 gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[TOGGLE_SIZE_ALLOCATE], allocation);
424 gtk_menu_item_accel_width_foreach (GtkWidget *widget,
429 if (GTK_IS_ACCEL_LABEL (widget))
433 w = gtk_accel_label_get_accel_width (GTK_ACCEL_LABEL (widget));
434 *width = MAX (*width, w);
436 else if (GTK_IS_CONTAINER (widget))
437 gtk_container_foreach (GTK_CONTAINER (widget),
438 gtk_menu_item_accel_width_foreach,
443 gtk_menu_item_size_request (GtkWidget *widget,
444 GtkRequisition *requisition)
446 GtkMenuItem *menu_item;
450 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
451 g_return_if_fail (requisition != NULL);
453 bin = GTK_BIN (widget);
454 menu_item = GTK_MENU_ITEM (widget);
456 requisition->width = (GTK_CONTAINER (widget)->border_width +
457 widget->style->xthickness +
459 requisition->height = (GTK_CONTAINER (widget)->border_width +
460 widget->style->ythickness) * 2;
462 if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
464 GtkRequisition child_requisition;
466 gtk_widget_size_request (bin->child, &child_requisition);
468 requisition->width += child_requisition.width;
469 requisition->height += child_requisition.height;
471 if (menu_item->submenu && menu_item->show_submenu_indicator)
472 requisition->width += child_requisition.height;
476 gtk_container_foreach (GTK_CONTAINER (menu_item),
477 gtk_menu_item_accel_width_foreach,
479 menu_item->accelerator_width = accel_width;
483 gtk_menu_item_size_allocate (GtkWidget *widget,
484 GtkAllocation *allocation)
486 GtkMenuItem *menu_item;
488 GtkAllocation child_allocation;
490 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
491 g_return_if_fail (allocation != NULL);
493 menu_item = GTK_MENU_ITEM (widget);
494 bin = GTK_BIN (widget);
496 widget->allocation = *allocation;
500 GtkRequisition child_requisition;
502 child_allocation.x = (GTK_CONTAINER (widget)->border_width +
503 widget->style->xthickness +
505 child_allocation.y = (GTK_CONTAINER (widget)->border_width +
506 widget->style->ythickness);
507 child_allocation.width = MAX (1, (gint)allocation->width - child_allocation.x * 2);
508 child_allocation.height = MAX (1, (gint)allocation->height - child_allocation.y * 2);
509 child_allocation.x += GTK_MENU_ITEM (widget)->toggle_size;
510 child_allocation.width -= GTK_MENU_ITEM (widget)->toggle_size;
511 child_allocation.x += widget->allocation.x;
512 child_allocation.y += widget->allocation.y;
514 gtk_widget_get_child_requisition (bin->child, &child_requisition);
515 if (menu_item->submenu && menu_item->show_submenu_indicator)
516 child_allocation.width -= child_requisition.height;
518 gtk_widget_size_allocate (bin->child, &child_allocation);
521 if (GTK_WIDGET_REALIZED (widget))
522 gdk_window_move_resize (menu_item->event_window,
523 allocation->x, allocation->y,
524 allocation->width, allocation->height);
526 if (menu_item->submenu)
527 gtk_menu_reposition (GTK_MENU (menu_item->submenu));
531 gtk_menu_item_realize (GtkWidget *widget)
533 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
534 GdkWindowAttr attributes;
535 gint attributes_mask;
537 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
539 widget->window = gtk_widget_get_parent_window (widget);
540 gdk_window_ref (widget->window);
542 attributes.x = widget->allocation.x;
543 attributes.y = widget->allocation.y;
544 attributes.width = widget->allocation.width;
545 attributes.height = widget->allocation.height;
546 attributes.window_type = GDK_WINDOW_CHILD;
547 attributes.wclass = GDK_INPUT_ONLY;
548 attributes.event_mask = (gtk_widget_get_events (widget) |
550 GDK_BUTTON_PRESS_MASK |
551 GDK_BUTTON_RELEASE_MASK |
552 GDK_ENTER_NOTIFY_MASK |
553 GDK_LEAVE_NOTIFY_MASK |
554 GDK_POINTER_MOTION_MASK);
556 attributes_mask = GDK_WA_X | GDK_WA_Y;
557 menu_item->event_window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, attributes_mask);
558 gdk_window_set_user_data (menu_item->event_window, widget);
560 widget->style = gtk_style_attach (widget->style, widget->window);
564 gtk_menu_item_unrealize (GtkWidget *widget)
566 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
568 gdk_window_set_user_data (menu_item->event_window, NULL);
569 gdk_window_destroy (menu_item->event_window);
570 menu_item->event_window = NULL;
572 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
573 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
577 gtk_menu_item_map (GtkWidget *widget)
579 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
581 GTK_WIDGET_CLASS (parent_class)->map (widget);
583 gdk_window_show (menu_item->event_window);
587 gtk_menu_item_unmap (GtkWidget *widget)
589 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
591 gdk_window_hide (menu_item->event_window);
593 GTK_WIDGET_CLASS (parent_class)->unmap (widget);
597 gtk_menu_item_paint (GtkWidget *widget,
600 GtkMenuItem *menu_item;
601 GtkStateType state_type;
602 GtkShadowType shadow_type, selected_shadow_type;
605 gint border_width = GTK_CONTAINER (widget)->border_width;
607 if (GTK_WIDGET_DRAWABLE (widget))
609 menu_item = GTK_MENU_ITEM (widget);
611 state_type = widget->state;
613 x = widget->allocation.x + border_width;
614 y = widget->allocation.y + border_width;
615 width = widget->allocation.width - border_width * 2;
616 height = widget->allocation.height - border_width * 2;
618 if ((state_type == GTK_STATE_PRELIGHT) &&
619 (GTK_BIN (menu_item)->child))
621 gtk_widget_style_get (widget,
622 "selected_shadow_type", &selected_shadow_type,
624 gtk_paint_box (widget->style,
627 selected_shadow_type,
628 area, widget, "menuitem",
629 x, y, width, height);
632 if (menu_item->submenu && menu_item->show_submenu_indicator)
634 GtkRequisition child_requisition;
635 gint arrow_x, arrow_y;
639 gtk_widget_get_child_requisition (GTK_BIN (menu_item)->child,
642 arrow_size = child_requisition.height - 2 * widget->style->ythickness;
643 arrow_extent = arrow_size * 0.6;
645 shadow_type = GTK_SHADOW_OUT;
646 if (state_type == GTK_STATE_PRELIGHT)
647 shadow_type = GTK_SHADOW_IN;
649 arrow_x = x + width - 1 - arrow_size + (arrow_size - arrow_extent) / 2;
650 arrow_y = y + (height - arrow_extent) / 2;
652 gtk_paint_arrow (widget->style, widget->window,
653 state_type, shadow_type,
654 area, widget, "menuitem",
655 GTK_ARROW_RIGHT, TRUE,
657 arrow_extent, arrow_extent);
659 else if (!GTK_BIN (menu_item)->child)
661 gtk_paint_hline (widget->style, widget->window, GTK_STATE_NORMAL,
662 area, widget, "menuitem",
663 widget->allocation.x, widget->allocation.width,
664 widget->allocation.y);
670 gtk_menu_item_expose (GtkWidget *widget,
671 GdkEventExpose *event)
673 g_return_val_if_fail (GTK_IS_MENU_ITEM (widget), FALSE);
674 g_return_val_if_fail (event != NULL, FALSE);
676 if (GTK_WIDGET_DRAWABLE (widget))
678 gtk_menu_item_paint (widget, &event->area);
680 (* GTK_WIDGET_CLASS (parent_class)->expose_event) (widget, event);
687 gtk_real_menu_item_select (GtkItem *item)
689 GtkMenuItem *menu_item;
691 g_return_if_fail (GTK_IS_MENU_ITEM (item));
693 menu_item = GTK_MENU_ITEM (item);
695 /* if (menu_item->submenu && !GTK_WIDGET_VISIBLE (menu_item->submenu))*/
696 if (menu_item->submenu)
699 GdkEvent *event = gtk_get_current_event ();
701 etime = event ? gdk_event_get_time (event) : GDK_CURRENT_TIME;
703 etime >= last_submenu_deselect_time &&
704 last_submenu_deselect_time + SELECT_TIMEOUT > etime)
706 if (!menu_item->timer)
707 menu_item->timer = gtk_timeout_add (SELECT_TIMEOUT - (etime - last_submenu_deselect_time),
708 gtk_menu_item_select_timeout,
711 event->type != GDK_BUTTON_PRESS &&
712 event->type != GDK_ENTER_NOTIFY)
713 menu_item->timer_from_keypress = TRUE;
715 menu_item->timer_from_keypress = FALSE;
718 gtk_menu_item_popup_submenu (menu_item);
720 gdk_event_free(event);
723 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_PRELIGHT);
724 gtk_widget_draw (GTK_WIDGET (menu_item), NULL);
728 gtk_real_menu_item_deselect (GtkItem *item)
730 GtkMenuItem *menu_item;
732 g_return_if_fail (GTK_IS_MENU_ITEM (item));
734 menu_item = GTK_MENU_ITEM (item);
736 if (menu_item->submenu)
739 GdkEvent *event = gtk_get_current_event ();
741 if (menu_item->timer)
743 gtk_timeout_remove (menu_item->timer);
744 menu_item->timer = 0;
747 gtk_menu_popdown (GTK_MENU (menu_item->submenu));
749 etime = event ? gdk_event_get_time (event) : GDK_CURRENT_TIME;
750 if (etime > last_submenu_deselect_time)
751 last_submenu_deselect_time = etime;
753 gdk_event_free(event);
756 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_NORMAL);
757 gtk_widget_draw (GTK_WIDGET (menu_item), NULL);
761 gtk_menu_item_mnemonic_activate (GtkWidget *widget,
762 gboolean group_cycling)
766 if (widget->parent &&
767 GTK_IS_MENU_SHELL (widget->parent))
768 gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent),
773 gtk_signal_emit (GTK_OBJECT (widget), menu_item_signals[ACTIVATE_ITEM]);
780 gtk_real_menu_item_activate_item (GtkMenuItem *menu_item)
783 GtkMenuShell *submenu;
785 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
787 widget = GTK_WIDGET (menu_item);
789 if (widget->parent &&
790 GTK_IS_MENU_SHELL (widget->parent))
792 if (menu_item->submenu == NULL)
793 gtk_menu_shell_activate_item (GTK_MENU_SHELL (widget->parent),
797 GtkMenuShell *menu_shell = GTK_MENU_SHELL (widget->parent);
799 _gtk_menu_shell_activate (menu_shell);
801 gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent), widget);
802 gtk_menu_item_popup_submenu (widget);
804 _gtk_menu_shell_select_first (GTK_MENU_SHELL (menu_item->submenu));
805 submenu = GTK_MENU_SHELL (menu_item->submenu);
810 gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
813 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
819 gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
822 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
824 menu_item->toggle_size = allocation;
828 gtk_menu_item_select_timeout (gpointer data)
830 GtkMenuItem *menu_item;
833 GDK_THREADS_ENTER ();
835 menu_item = GTK_MENU_ITEM (data);
837 parent = GTK_WIDGET (menu_item)->parent;
839 if (parent && GTK_IS_MENU_SHELL (parent) && GTK_MENU_SHELL (parent)->active)
841 gtk_menu_item_popup_submenu (data);
842 if (menu_item->timer_from_keypress && menu_item->submenu)
843 GTK_MENU_SHELL (menu_item->submenu)->ignore_enter = TRUE;
846 GDK_THREADS_LEAVE ();
852 gtk_menu_item_popup_submenu (gpointer data)
854 GtkMenuItem *menu_item;
856 menu_item = GTK_MENU_ITEM (data);
857 menu_item->timer = 0;
859 if (GTK_WIDGET_IS_SENSITIVE (menu_item->submenu))
861 gtk_menu_popup (GTK_MENU (menu_item->submenu),
862 GTK_WIDGET (menu_item)->parent,
863 GTK_WIDGET (menu_item),
864 gtk_menu_item_position_menu,
866 GTK_MENU_SHELL (GTK_WIDGET (menu_item)->parent)->button,
872 gtk_menu_item_position_menu (GtkMenu *menu,
878 GtkMenuItem *menu_item;
880 GtkWidget *parent_menu_item;
884 gint twidth, theight;
887 g_return_if_fail (menu != NULL);
888 g_return_if_fail (x != NULL);
889 g_return_if_fail (y != NULL);
891 menu_item = GTK_MENU_ITEM (user_data);
892 widget = GTK_WIDGET (user_data);
894 twidth = GTK_WIDGET (menu)->requisition.width;
895 theight = GTK_WIDGET (menu)->requisition.height;
897 screen = gtk_widget_get_screen (widget);
898 screen_width = gdk_screen_get_width (screen);
899 screen_height = gdk_screen_get_height (screen);
901 if (!gdk_window_get_origin (widget->window, &tx, &ty))
903 g_warning ("Menu not on screen");
907 tx += widget->allocation.x;
908 ty += widget->allocation.y;
910 switch (menu_item->submenu_placement)
913 if ((ty + widget->allocation.height + theight) <= screen_height)
914 ty += widget->allocation.height;
915 else if ((ty - theight) >= 0)
917 else if (screen_height - (ty + widget->allocation.height) > ty)
918 ty += widget->allocation.height;
924 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
925 parent_menu_item = GTK_MENU (widget->parent)->parent_menu_item;
926 if (parent_menu_item)
927 menu_item->submenu_direction = GTK_MENU_ITEM (parent_menu_item)->submenu_direction;
929 switch (menu_item->submenu_direction)
931 case GTK_DIRECTION_LEFT:
932 if ((tx - twidth) >= 0)
936 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
937 tx += widget->allocation.width - 5;
941 case GTK_DIRECTION_RIGHT:
942 if ((tx + widget->allocation.width + twidth - 5) <= screen_width)
943 tx += widget->allocation.width - 5;
946 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
952 ty += widget->allocation.height / 4;
954 /* If the height of the menu doesn't fit we move it upward. */
955 ty = CLAMP (ty, 0, MAX (0, screen_height - theight));
959 /* If we have negative, tx, here it is because we can't get
960 * the menu all the way on screen. Favor the left portion.
962 *x = CLAMP (tx, 0, MAX (0, screen_width - twidth));
967 * gtk_menu_item_set_right_justified:
968 * @menu_item: a #GtkMenuItem.
969 * @right_justified: if %TRUE the menu item will appear at the
970 * far right if added to a menu bar.
972 * Sets whether the menu item appears justified at the right
973 * side of a menu bar. This was traditionally done for "Help" menu
974 * items, but is now considered a bad idea. (If the widget
975 * layout is reversed for a right-to-left language like Hebrew
976 * or Arabic, right-justified-menu-items appear at the left.)
979 gtk_menu_item_set_right_justified (GtkMenuItem *menu_item,
980 gboolean right_justified)
982 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
984 right_justified = right_justified != FALSE;
986 if (right_justified != menu_item->right_justify)
988 menu_item->right_justify = right_justified;
989 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
994 * gtk_menu_item_get_right_justified:
995 * @menu_item: a #GtkMenuItem
997 * Gets whether the menu item appears justified at the right
998 * side of the menu bar.
1000 * Return value: %TRUE if the menu item will appear at the
1001 * far right if added to a menu bar.
1004 gtk_menu_item_get_right_justified (GtkMenuItem *menu_item)
1006 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), FALSE);
1008 return menu_item->right_justify;
1013 gtk_menu_item_show_all (GtkWidget *widget)
1015 GtkMenuItem *menu_item;
1017 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
1019 menu_item = GTK_MENU_ITEM (widget);
1021 /* show children including submenu */
1022 if (menu_item->submenu)
1023 gtk_widget_show_all (menu_item->submenu);
1024 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_show_all, NULL);
1026 gtk_widget_show (widget);
1030 gtk_menu_item_hide_all (GtkWidget *widget)
1032 GtkMenuItem *menu_item;
1034 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
1036 gtk_widget_hide (widget);
1038 menu_item = GTK_MENU_ITEM (widget);
1040 /* hide children including submenu */
1041 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_hide_all, NULL);
1042 if (menu_item->submenu)
1043 gtk_widget_hide_all (menu_item->submenu);
1047 gtk_menu_item_accel_name_foreach (GtkWidget *widget,
1050 const gchar **path_p = data;
1054 if (GTK_IS_LABEL (widget))
1056 *path_p = gtk_label_get_text (GTK_LABEL (widget));
1057 if (*path_p && (*path_p)[0] == 0)
1060 else if (GTK_IS_CONTAINER (widget))
1061 gtk_container_foreach (GTK_CONTAINER (widget),
1062 gtk_menu_item_accel_name_foreach,
1068 gtk_menu_item_parent_set (GtkWidget *widget,
1069 GtkWidget *previous_parent)
1071 GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
1072 GtkMenu *menu = GTK_IS_MENU (widget->parent) ? GTK_MENU (widget->parent) : NULL;
1075 _gtk_menu_item_refresh_accel_path (menu_item,
1080 if (GTK_WIDGET_CLASS (parent_class)->parent_set)
1081 GTK_WIDGET_CLASS (parent_class)->parent_set (widget, previous_parent);
1085 _gtk_menu_item_refresh_accel_path (GtkMenuItem *menu_item,
1086 const gchar *prefix,
1087 GtkAccelGroup *accel_group,
1088 gboolean group_changed)
1093 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1094 g_return_if_fail (!accel_group || GTK_IS_ACCEL_GROUP (accel_group));
1096 widget = GTK_WIDGET (menu_item);
1100 gtk_widget_set_accel_path (widget, NULL, NULL);
1104 path = _gtk_widget_get_accel_path (widget, NULL);
1105 if (!path) /* no active accel_path yet */
1107 path = menu_item->accel_path;
1108 if (!path && prefix)
1110 gchar *postfix = NULL;
1112 /* try to construct one from label text */
1113 gtk_container_foreach (GTK_CONTAINER (menu_item),
1114 gtk_menu_item_accel_name_foreach,
1116 menu_item->accel_path = postfix ? g_strconcat (prefix, "/", postfix, NULL) : NULL;
1117 path = menu_item->accel_path;
1120 gtk_widget_set_accel_path (widget, path, accel_group);
1122 else if (group_changed) /* reinstall accelerators */
1123 gtk_widget_set_accel_path (widget, path, accel_group);
1127 * gtk_menu_item_set_accel_path
1128 * @menu_item: a valid #GtkMenuItem
1129 * @accel_path: accelerator path, corresponding to this menu item's functionality
1131 * Set the accelerator path on @menu_item, through which runtime changes of the
1132 * menu item's accelerator caused by the user can be identified and saved to
1133 * persistant storage (see gtk_accel_map_save() on this).
1134 * To setup a default accelerator for this menu item, call
1135 * gtk_accel_map_add_entry() with the same @accel_path.
1136 * See also gtk_accel_map_add_entry() on the specifics of accelerator paths,
1137 * and gtk_menu_set_accel_path() for a more convenient variant of this function.
1139 * This function is basically a convenience wrapper that handles calling
1140 * gtk_widget_set_accel_path() with the appropriate accelerator group for
1144 gtk_menu_item_set_accel_path (GtkMenuItem *menu_item,
1145 const gchar *accel_path)
1149 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1150 g_return_if_fail (accel_path && accel_path[0] == '<' && strchr (accel_path, '/'));
1152 widget = GTK_WIDGET (menu_item);
1154 /* store new path */
1155 g_free (menu_item->accel_path);
1156 menu_item->accel_path = g_strdup (accel_path);
1158 /* forget accelerators associated with old path */
1159 gtk_widget_set_accel_path (widget, NULL, NULL);
1161 /* install accelerators associated with new path */
1162 if (widget->parent && GTK_IS_MENU (widget->parent))
1164 GtkMenu *menu = GTK_MENU (widget->parent);
1166 if (menu->accel_group)
1167 _gtk_menu_item_refresh_accel_path (GTK_MENU_ITEM (widget),
1175 gtk_menu_item_forall (GtkContainer *container,
1176 gboolean include_internals,
1177 GtkCallback callback,
1178 gpointer callback_data)
1181 GtkMenuItem *menu_item;
1183 g_return_if_fail (GTK_IS_MENU_ITEM (container));
1184 g_return_if_fail (callback != NULL);
1186 bin = GTK_BIN (container);
1187 menu_item = GTK_MENU_ITEM (container);
1190 callback (bin->child, callback_data);
1194 _gtk_menu_item_is_selectable (GtkWidget *menu_item)
1196 if ((!GTK_BIN (menu_item)->child &&
1197 G_OBJECT_TYPE (menu_item) == GTK_TYPE_MENU_ITEM) ||
1198 GTK_IS_SEPARATOR_MENU_ITEM (menu_item) ||
1199 !GTK_WIDGET_IS_SENSITIVE (menu_item) ||
1200 !GTK_WIDGET_VISIBLE (menu_item))