1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GTK+ Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
28 #include "gtkaccellabel.h"
31 #include "gtkmenubar.h"
32 #include "gtkmenuitem.h"
33 #include "gtksignal.h"
36 #define BORDER_SPACING 3
37 #define SELECT_TIMEOUT 75
39 #define MENU_ITEM_CLASS(w) GTK_MENU_ITEM_CLASS (GTK_OBJECT (w)->klass)
51 static void gtk_menu_item_class_init (GtkMenuItemClass *klass);
52 static void gtk_menu_item_init (GtkMenuItem *menu_item);
53 static void gtk_menu_item_destroy (GtkObject *object);
54 static void gtk_menu_item_size_request (GtkWidget *widget,
55 GtkRequisition *requisition);
56 static void gtk_menu_item_size_allocate (GtkWidget *widget,
57 GtkAllocation *allocation);
58 static void gtk_menu_item_paint (GtkWidget *widget,
60 static gint gtk_menu_item_expose (GtkWidget *widget,
61 GdkEventExpose *event);
63 static void gtk_real_menu_item_select (GtkItem *item);
64 static void gtk_real_menu_item_deselect (GtkItem *item);
65 static void gtk_real_menu_item_activate_item (GtkMenuItem *item);
66 static void gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
68 static void gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
70 static gboolean gtk_menu_item_mnemonic_activate (GtkWidget *widget,
71 gboolean group_cycling);
73 static gint gtk_menu_item_select_timeout (gpointer data);
74 static void gtk_menu_item_popup_submenu (gpointer data);
75 static void gtk_menu_item_position_menu (GtkMenu *menu,
80 static void gtk_menu_item_show_all (GtkWidget *widget);
81 static void gtk_menu_item_hide_all (GtkWidget *widget);
82 static void gtk_menu_item_forall (GtkContainer *container,
83 gboolean include_internals,
85 gpointer callback_data);
88 static GtkItemClass *parent_class;
89 static guint menu_item_signals[LAST_SIGNAL] = { 0 };
90 static guint32 last_submenu_deselect_time = 0;
95 gtk_menu_item_get_type (void)
97 static GtkType menu_item_type = 0;
101 static const GTypeInfo menu_item_info =
103 sizeof (GtkMenuItemClass),
104 NULL, /* base_init */
105 NULL, /* base_finalize */
106 (GClassInitFunc) gtk_menu_item_class_init,
107 NULL, /* class_finalize */
108 NULL, /* class_data */
109 sizeof (GtkMenuItem),
110 16, /* n_preallocs */
111 (GInstanceInitFunc) gtk_menu_item_init,
114 menu_item_type = g_type_register_static (GTK_TYPE_ITEM, "GtkMenuItem", &menu_item_info, 0);
117 return menu_item_type;
121 gtk_menu_item_class_init (GtkMenuItemClass *klass)
123 GtkObjectClass *object_class;
124 GtkWidgetClass *widget_class;
125 GtkContainerClass *container_class;
126 GtkItemClass *item_class;
128 object_class = (GtkObjectClass*) klass;
129 widget_class = (GtkWidgetClass*) klass;
130 container_class = (GtkContainerClass*) klass;
131 item_class = (GtkItemClass*) klass;
133 parent_class = gtk_type_class (gtk_item_get_type ());
136 object_class->destroy = gtk_menu_item_destroy;
138 widget_class->size_request = gtk_menu_item_size_request;
139 widget_class->size_allocate = gtk_menu_item_size_allocate;
140 widget_class->expose_event = gtk_menu_item_expose;
141 widget_class->show_all = gtk_menu_item_show_all;
142 widget_class->hide_all = gtk_menu_item_hide_all;
143 widget_class->mnemonic_activate = gtk_menu_item_mnemonic_activate;
145 container_class->forall = gtk_menu_item_forall;
147 item_class->select = gtk_real_menu_item_select;
148 item_class->deselect = gtk_real_menu_item_deselect;
150 klass->activate = NULL;
151 klass->activate_item = gtk_real_menu_item_activate_item;
152 klass->toggle_size_request = gtk_real_menu_item_toggle_size_request;
153 klass->toggle_size_allocate = gtk_real_menu_item_toggle_size_allocate;
155 klass->hide_on_activate = TRUE;
157 menu_item_signals[ACTIVATE] =
158 gtk_signal_new ("activate",
159 GTK_RUN_FIRST | GTK_RUN_ACTION,
160 GTK_CLASS_TYPE (object_class),
161 GTK_SIGNAL_OFFSET (GtkMenuItemClass, activate),
162 gtk_marshal_VOID__VOID,
164 widget_class->activate_signal = menu_item_signals[ACTIVATE];
166 menu_item_signals[ACTIVATE_ITEM] =
167 gtk_signal_new ("activate_item",
169 GTK_CLASS_TYPE (object_class),
170 GTK_SIGNAL_OFFSET (GtkMenuItemClass, activate_item),
171 gtk_signal_default_marshaller,
174 menu_item_signals[TOGGLE_SIZE_REQUEST] =
175 gtk_signal_new ("toggle_size_request",
177 GTK_CLASS_TYPE (object_class),
178 GTK_SIGNAL_OFFSET (GtkMenuItemClass, toggle_size_request),
179 gtk_marshal_NONE__POINTER,
183 menu_item_signals[TOGGLE_SIZE_ALLOCATE] =
184 gtk_signal_new ("toggle_size_allocate",
186 GTK_CLASS_TYPE (object_class),
187 GTK_SIGNAL_OFFSET (GtkMenuItemClass, toggle_size_allocate),
188 gtk_marshal_NONE__INT,
194 gtk_menu_item_init (GtkMenuItem *menu_item)
196 menu_item->submenu = NULL;
197 menu_item->accelerator_signal = menu_item_signals[ACTIVATE];
198 menu_item->toggle_size = 0;
199 menu_item->accelerator_width = 0;
200 menu_item->show_submenu_indicator = FALSE;
201 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
202 menu_item->submenu_placement = GTK_TOP_BOTTOM;
203 menu_item->right_justify = FALSE;
205 menu_item->timer = 0;
209 gtk_menu_item_new (void)
211 return GTK_WIDGET (gtk_type_new (gtk_menu_item_get_type ()));
215 gtk_menu_item_new_with_label (const gchar *label)
217 GtkWidget *menu_item;
218 GtkWidget *accel_label;
220 menu_item = gtk_menu_item_new ();
221 accel_label = gtk_accel_label_new (label);
222 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
224 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
225 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
226 gtk_widget_show (accel_label);
233 * gtk_menu_item_new_with_mnemonic:
234 * @label: The text of the button, with an underscore in front of the
236 * @returns: a new #GtkMenuItem
238 * Creates a new #GtkMenuItem containing a label. The label
239 * will be created using gtk_label_new_with_mnemonic(), so underscores
240 * in @label indicate the mnemonic for the menu item.
243 gtk_menu_item_new_with_mnemonic (const gchar *label)
245 GtkWidget *menu_item;
246 GtkWidget *accel_label;
248 menu_item = gtk_menu_item_new ();
249 accel_label = gtk_type_new (GTK_TYPE_ACCEL_LABEL);
250 gtk_label_set_text_with_mnemonic (GTK_LABEL (accel_label), label);
251 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
253 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
254 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
255 gtk_widget_show (accel_label);
261 gtk_menu_item_destroy (GtkObject *object)
263 GtkMenuItem *menu_item;
265 g_return_if_fail (GTK_IS_MENU_ITEM (object));
267 menu_item = GTK_MENU_ITEM (object);
269 if (menu_item->submenu)
270 gtk_widget_destroy (menu_item->submenu);
272 if (GTK_OBJECT_CLASS (parent_class)->destroy)
273 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
277 gtk_menu_item_detacher (GtkWidget *widget,
280 GtkMenuItem *menu_item;
282 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
284 menu_item = GTK_MENU_ITEM (widget);
285 g_return_if_fail (menu_item->submenu == (GtkWidget*) menu);
287 menu_item->submenu = NULL;
291 gtk_menu_item_set_submenu (GtkMenuItem *menu_item,
294 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
296 if (menu_item->submenu != submenu)
298 gtk_menu_item_remove_submenu (menu_item);
300 menu_item->submenu = submenu;
301 gtk_menu_attach_to_widget (GTK_MENU (submenu),
302 GTK_WIDGET (menu_item),
303 gtk_menu_item_detacher);
305 if (GTK_WIDGET (menu_item)->parent)
306 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
311 * gtk_menu_item_get_submenu:
312 * @menu_item: a #GtkMenuItem
314 * Gets the submenu underneath this menu item, if any. See
315 * gtk_menu_item_set_submenu().
317 * Return value: submenu for this menu item, or %NULL if none.
320 gtk_menu_item_get_submenu (GtkMenuItem *menu_item)
322 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);
324 return menu_item->submenu;
328 gtk_menu_item_remove_submenu (GtkMenuItem *menu_item)
330 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
332 if (menu_item->submenu)
333 gtk_menu_detach (GTK_MENU (menu_item->submenu));
337 gtk_menu_item_set_placement (GtkMenuItem *menu_item,
338 GtkSubmenuPlacement placement)
340 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
342 menu_item->submenu_placement = placement;
346 gtk_menu_item_select (GtkMenuItem *menu_item)
348 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
350 gtk_item_select (GTK_ITEM (menu_item));
354 gtk_menu_item_deselect (GtkMenuItem *menu_item)
356 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
358 gtk_item_deselect (GTK_ITEM (menu_item));
362 gtk_menu_item_activate (GtkMenuItem *menu_item)
364 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
366 gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[ACTIVATE]);
370 gtk_menu_item_toggle_size_request (GtkMenuItem *menu_item,
373 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
375 gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[TOGGLE_SIZE_REQUEST], requisition);
379 gtk_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
382 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
384 gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[TOGGLE_SIZE_ALLOCATE], allocation);
388 gtk_menu_item_accel_width_foreach (GtkWidget *widget,
393 if (GTK_IS_ACCEL_LABEL (widget))
397 w = gtk_accel_label_get_accel_width (GTK_ACCEL_LABEL (widget));
398 *width = MAX (*width, w);
400 else if (GTK_IS_CONTAINER (widget))
401 gtk_container_foreach (GTK_CONTAINER (widget),
402 gtk_menu_item_accel_width_foreach,
407 gtk_menu_item_size_request (GtkWidget *widget,
408 GtkRequisition *requisition)
410 GtkMenuItem *menu_item;
414 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
415 g_return_if_fail (requisition != NULL);
417 bin = GTK_BIN (widget);
418 menu_item = GTK_MENU_ITEM (widget);
420 requisition->width = (GTK_CONTAINER (widget)->border_width +
421 widget->style->xthickness +
423 requisition->height = (GTK_CONTAINER (widget)->border_width +
424 widget->style->ythickness) * 2;
426 if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
428 GtkRequisition child_requisition;
430 gtk_widget_size_request (bin->child, &child_requisition);
432 requisition->width += child_requisition.width;
433 requisition->height += child_requisition.height;
436 if (menu_item->submenu && menu_item->show_submenu_indicator)
437 requisition->width += 21;
440 gtk_container_foreach (GTK_CONTAINER (menu_item),
441 gtk_menu_item_accel_width_foreach,
443 menu_item->accelerator_width = accel_width;
447 gtk_menu_item_size_allocate (GtkWidget *widget,
448 GtkAllocation *allocation)
450 GtkMenuItem *menu_item;
452 GtkAllocation child_allocation;
454 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
455 g_return_if_fail (allocation != NULL);
457 menu_item = GTK_MENU_ITEM (widget);
458 bin = GTK_BIN (widget);
460 widget->allocation = *allocation;
464 child_allocation.x = (GTK_CONTAINER (widget)->border_width +
465 widget->style->xthickness +
467 child_allocation.y = (GTK_CONTAINER (widget)->border_width +
468 widget->style->ythickness);
469 child_allocation.width = MAX (1, (gint)allocation->width - child_allocation.x * 2);
470 child_allocation.height = MAX (1, (gint)allocation->height - child_allocation.y * 2);
471 child_allocation.x += GTK_MENU_ITEM (widget)->toggle_size;
472 child_allocation.width -= GTK_MENU_ITEM (widget)->toggle_size;
473 if (menu_item->submenu && menu_item->show_submenu_indicator)
474 child_allocation.width -= 21;
476 gtk_widget_size_allocate (bin->child, &child_allocation);
479 if (GTK_WIDGET_REALIZED (widget))
480 gdk_window_move_resize (widget->window,
481 allocation->x, allocation->y,
482 allocation->width, allocation->height);
484 if (menu_item->submenu)
485 gtk_menu_reposition (GTK_MENU (menu_item->submenu));
489 gtk_menu_item_paint (GtkWidget *widget,
492 GtkMenuItem *menu_item;
493 GtkStateType state_type;
494 GtkShadowType shadow_type;
498 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
500 if (GTK_WIDGET_DRAWABLE (widget))
502 menu_item = GTK_MENU_ITEM (widget);
504 state_type = widget->state;
506 x = GTK_CONTAINER (menu_item)->border_width;
507 y = GTK_CONTAINER (menu_item)->border_width;
508 width = widget->allocation.width - x * 2;
509 height = widget->allocation.height - y * 2;
511 if ((state_type == GTK_STATE_PRELIGHT) &&
512 (GTK_BIN (menu_item)->child))
513 gtk_paint_box (widget->style,
517 area, widget, "menuitem",
518 x, y, width, height);
521 gdk_window_set_back_pixmap (widget->window, NULL, TRUE);
522 gdk_window_clear_area (widget->window, area->x, area->y, area->width, area->height);
525 if (menu_item->submenu && menu_item->show_submenu_indicator)
527 shadow_type = GTK_SHADOW_OUT;
528 if (state_type == GTK_STATE_PRELIGHT)
529 shadow_type = GTK_SHADOW_IN;
531 gtk_paint_arrow (widget->style, widget->window,
532 state_type, shadow_type,
533 area, widget, "menuitem",
534 GTK_ARROW_RIGHT, TRUE,
535 x + width - 15, y + height / 2 - 5, 10, 10);
537 else if (!GTK_BIN (menu_item)->child)
539 gtk_paint_hline (widget->style, widget->window, GTK_STATE_NORMAL,
540 area, widget, "menuitem",
541 0, widget->allocation.width, 0);
547 gtk_menu_item_expose (GtkWidget *widget,
548 GdkEventExpose *event)
550 g_return_val_if_fail (GTK_IS_MENU_ITEM (widget), FALSE);
551 g_return_val_if_fail (event != NULL, FALSE);
553 if (GTK_WIDGET_DRAWABLE (widget))
555 gtk_menu_item_paint (widget, &event->area);
557 (* GTK_WIDGET_CLASS (parent_class)->expose_event) (widget, event);
564 gtk_real_menu_item_select (GtkItem *item)
566 GtkMenuItem *menu_item;
568 g_return_if_fail (GTK_IS_MENU_ITEM (item));
570 menu_item = GTK_MENU_ITEM (item);
572 /* if (menu_item->submenu && !GTK_WIDGET_VISIBLE (menu_item->submenu))*/
573 if (menu_item->submenu)
576 GdkEvent *event = gtk_get_current_event ();
578 etime = event ? gdk_event_get_time (event) : GDK_CURRENT_TIME;
579 if (etime >= last_submenu_deselect_time &&
580 last_submenu_deselect_time + SELECT_TIMEOUT > etime)
581 menu_item->timer = gtk_timeout_add (SELECT_TIMEOUT - (etime - last_submenu_deselect_time),
582 gtk_menu_item_select_timeout,
585 gtk_menu_item_popup_submenu (menu_item);
587 gdk_event_free(event);
590 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_PRELIGHT);
591 gtk_widget_draw (GTK_WIDGET (menu_item), NULL);
595 gtk_real_menu_item_deselect (GtkItem *item)
597 GtkMenuItem *menu_item;
599 g_return_if_fail (GTK_IS_MENU_ITEM (item));
601 menu_item = GTK_MENU_ITEM (item);
603 if (menu_item->submenu)
606 GdkEvent *event = gtk_get_current_event ();
608 if (menu_item->timer)
610 gtk_timeout_remove (menu_item->timer);
611 menu_item->timer = 0;
614 gtk_menu_popdown (GTK_MENU (menu_item->submenu));
616 etime = event ? gdk_event_get_time (event) : GDK_CURRENT_TIME;
617 if (etime > last_submenu_deselect_time)
618 last_submenu_deselect_time = etime;
620 gdk_event_free(event);
623 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_NORMAL);
624 gtk_widget_draw (GTK_WIDGET (menu_item), NULL);
628 gtk_menu_item_mnemonic_activate (GtkWidget *widget,
629 gboolean group_cycling)
633 if (widget->parent &&
634 GTK_IS_MENU_SHELL (widget->parent))
635 gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent),
640 gtk_signal_emit (GTK_OBJECT (widget), menu_item_signals[ACTIVATE_ITEM]);
647 gtk_real_menu_item_activate_item (GtkMenuItem *menu_item)
650 GtkMenuShell *submenu;
652 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
654 widget = GTK_WIDGET (menu_item);
656 if (widget->parent &&
657 GTK_IS_MENU_SHELL (widget->parent))
659 if (menu_item->submenu == NULL)
660 gtk_menu_shell_activate_item (GTK_MENU_SHELL (widget->parent),
664 GtkMenuShell *menu_shell = GTK_MENU_SHELL (widget->parent);
666 if (!menu_shell->active)
668 gtk_grab_add (GTK_WIDGET (menu_shell));
669 menu_shell->have_grab = TRUE;
670 menu_shell->active = TRUE;
673 gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent), widget);
674 gtk_menu_item_popup_submenu (widget);
676 submenu = GTK_MENU_SHELL (menu_item->submenu);
677 if (submenu->children)
678 gtk_menu_shell_select_item (submenu, submenu->children->data);
683 gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
686 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
692 gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
695 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
697 menu_item->toggle_size = allocation;
701 gtk_menu_item_select_timeout (gpointer data)
703 GDK_THREADS_ENTER ();
705 gtk_menu_item_popup_submenu (data);
707 GDK_THREADS_LEAVE ();
713 gtk_menu_item_popup_submenu (gpointer data)
715 GtkMenuItem *menu_item;
717 menu_item = GTK_MENU_ITEM (data);
718 menu_item->timer = 0;
720 if (GTK_WIDGET_IS_SENSITIVE (menu_item->submenu))
722 gtk_menu_popup (GTK_MENU (menu_item->submenu),
723 GTK_WIDGET (menu_item)->parent,
724 GTK_WIDGET (menu_item),
725 gtk_menu_item_position_menu,
727 GTK_MENU_SHELL (GTK_WIDGET (menu_item)->parent)->button,
733 gtk_menu_item_position_menu (GtkMenu *menu,
739 GtkMenuItem *menu_item;
740 GtkWidget *parent_menu_item;
743 gint twidth, theight;
746 g_return_if_fail (menu != NULL);
747 g_return_if_fail (x != NULL);
748 g_return_if_fail (y != NULL);
750 menu_item = GTK_MENU_ITEM (user_data);
752 twidth = GTK_WIDGET (menu)->requisition.width;
753 theight = GTK_WIDGET (menu)->requisition.height;
755 screen_width = gdk_screen_width ();
756 screen_height = gdk_screen_height ();
758 if (!gdk_window_get_origin (GTK_WIDGET (menu_item)->window, &tx, &ty))
760 g_warning ("Menu not on screen");
764 switch (menu_item->submenu_placement)
767 if ((ty + GTK_WIDGET (menu_item)->allocation.height + theight) <= screen_height)
768 ty += GTK_WIDGET (menu_item)->allocation.height;
769 else if ((ty - theight) >= 0)
771 else if (screen_height - (ty + GTK_WIDGET (menu_item)->allocation.height) > ty)
772 ty += GTK_WIDGET (menu_item)->allocation.height;
778 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
779 parent_menu_item = GTK_MENU (GTK_WIDGET (menu_item)->parent)->parent_menu_item;
780 if (parent_menu_item)
781 menu_item->submenu_direction = GTK_MENU_ITEM (parent_menu_item)->submenu_direction;
783 switch (menu_item->submenu_direction)
785 case GTK_DIRECTION_LEFT:
786 if ((tx - twidth) >= 0)
790 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
791 tx += GTK_WIDGET (menu_item)->allocation.width - 5;
795 case GTK_DIRECTION_RIGHT:
796 if ((tx + GTK_WIDGET (menu_item)->allocation.width + twidth - 5) <= screen_width)
797 tx += GTK_WIDGET (menu_item)->allocation.width - 5;
800 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
806 ty += GTK_WIDGET (menu_item)->allocation.height / 4;
808 /* If the height of the menu doesn't fit we move it upward. */
809 ty = CLAMP (ty, 0, MAX (0, screen_height - theight));
813 /* If we have negative, tx, here it is because we can't get
814 * the menu all the way on screen. Favor the left portion.
816 *x = CLAMP (tx, 0, MAX (0, screen_width - twidth));
821 * gtk_menu_item_set_right_justified:
822 * @menu_item: a #GtkMenuItem.
823 * @right_justified: if %TRUE the menu item will appear at the
824 * far right if added to a menu bar.
826 * Sets whether the menu item appears justified at the right
827 * side of a menu bar. This was traditionally done for "Help" menu
828 * items, but is now considered a bad idea. (If the widget
829 * layout is reversed for a right-to-left language like Hebrew
830 * or Arabic, right-justified-menu-items appear at the left.)
833 gtk_menu_item_set_right_justified (GtkMenuItem *menu_item,
834 gboolean right_justified)
836 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
838 right_justified = right_justified != FALSE;
840 if (right_justified != menu_item->right_justify)
842 menu_item->right_justify = right_justified;
843 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
848 * gtk_menu_item_get_right_justified:
849 * @menu_item: a #GtkMenuItem
851 * Gets whether the menu item appears justified at the right
852 * side of the menu bar.
854 * Return value: %TRUE if the menu item will appear at the
855 * far right if added to a menu bar.
858 gtk_menu_item_get_right_justified (GtkMenuItem *menu_item)
860 g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), FALSE);
862 return menu_item->right_justify;
867 gtk_menu_item_show_all (GtkWidget *widget)
869 GtkMenuItem *menu_item;
871 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
873 menu_item = GTK_MENU_ITEM (widget);
875 /* show children including submenu */
876 if (menu_item->submenu)
877 gtk_widget_show_all (menu_item->submenu);
878 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_show_all, NULL);
880 gtk_widget_show (widget);
884 gtk_menu_item_hide_all (GtkWidget *widget)
886 GtkMenuItem *menu_item;
888 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
890 gtk_widget_hide (widget);
892 menu_item = GTK_MENU_ITEM (widget);
894 /* hide children including submenu */
895 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_hide_all, NULL);
896 if (menu_item->submenu)
897 gtk_widget_hide_all (menu_item->submenu);
901 gtk_menu_item_forall (GtkContainer *container,
902 gboolean include_internals,
903 GtkCallback callback,
904 gpointer callback_data)
907 GtkMenuItem *menu_item;
909 g_return_if_fail (GTK_IS_MENU_ITEM (container));
910 g_return_if_fail (callback != NULL);
912 bin = GTK_BIN (container);
913 menu_item = GTK_MENU_ITEM (container);
916 (* callback) (bin->child, callback_data);