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 Library 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 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library 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.
20 #include "gtkaccellabel.h"
23 #include "gtkmenubar.h"
24 #include "gtkmenuitem.h"
25 #include "gtksignal.h"
28 #define BORDER_SPACING 3
29 #define SELECT_TIMEOUT 20
31 #define MENU_ITEM_CLASS(w) GTK_MENU_ITEM_CLASS (GTK_OBJECT (w)->klass)
41 static void gtk_menu_item_class_init (GtkMenuItemClass *klass);
42 static void gtk_menu_item_init (GtkMenuItem *menu_item);
43 static void gtk_menu_item_destroy (GtkObject *object);
44 static void gtk_menu_item_size_request (GtkWidget *widget,
45 GtkRequisition *requisition);
46 static void gtk_menu_item_size_allocate (GtkWidget *widget,
47 GtkAllocation *allocation);
48 static void gtk_menu_item_paint (GtkWidget *widget,
50 static void gtk_menu_item_draw (GtkWidget *widget,
52 static gint gtk_menu_item_expose (GtkWidget *widget,
53 GdkEventExpose *event);
54 static void gtk_real_menu_item_select (GtkItem *item);
55 static void gtk_real_menu_item_deselect (GtkItem *item);
56 static void gtk_real_menu_item_activate_item (GtkMenuItem *item);
57 static gint gtk_menu_item_select_timeout (gpointer data);
58 static void gtk_menu_item_position_menu (GtkMenu *menu,
62 static void gtk_menu_item_show_all (GtkWidget *widget);
63 static void gtk_menu_item_hide_all (GtkWidget *widget);
64 static void gtk_menu_item_forall (GtkContainer *container,
65 gboolean include_internals,
67 gpointer callback_data);
69 static GtkItemClass *parent_class;
70 static guint menu_item_signals[LAST_SIGNAL] = { 0 };
74 gtk_menu_item_get_type (void)
76 static GtkType menu_item_type = 0;
80 GtkTypeInfo menu_item_info =
84 sizeof (GtkMenuItemClass),
85 (GtkClassInitFunc) gtk_menu_item_class_init,
86 (GtkObjectInitFunc) gtk_menu_item_init,
87 /* reserved_1 */ NULL,
88 /* reserved_2 */ NULL,
89 (GtkClassInitFunc) NULL,
92 menu_item_type = gtk_type_unique (gtk_item_get_type (), &menu_item_info);
93 gtk_type_set_chunk_alloc (menu_item_type, 16);
96 return menu_item_type;
100 gtk_menu_item_class_init (GtkMenuItemClass *klass)
102 GtkObjectClass *object_class;
103 GtkWidgetClass *widget_class;
104 GtkContainerClass *container_class;
105 GtkItemClass *item_class;
107 object_class = (GtkObjectClass*) klass;
108 widget_class = (GtkWidgetClass*) klass;
109 container_class = (GtkContainerClass*) klass;
110 item_class = (GtkItemClass*) klass;
112 parent_class = gtk_type_class (gtk_item_get_type ());
114 menu_item_signals[ACTIVATE] =
115 gtk_signal_new ("activate",
118 GTK_SIGNAL_OFFSET (GtkMenuItemClass, activate),
119 gtk_marshal_NONE__NONE,
122 menu_item_signals[ACTIVATE_ITEM] =
123 gtk_signal_new ("activate_item",
126 GTK_SIGNAL_OFFSET (GtkMenuItemClass, activate_item),
127 gtk_signal_default_marshaller,
130 gtk_object_class_add_signals (object_class, menu_item_signals, LAST_SIGNAL);
132 object_class->destroy = gtk_menu_item_destroy;
134 widget_class->activate_signal = menu_item_signals[ACTIVATE];
135 widget_class->size_request = gtk_menu_item_size_request;
136 widget_class->size_allocate = gtk_menu_item_size_allocate;
137 widget_class->draw = gtk_menu_item_draw;
138 widget_class->expose_event = gtk_menu_item_expose;
139 widget_class->show_all = gtk_menu_item_show_all;
140 widget_class->hide_all = gtk_menu_item_hide_all;
142 container_class->forall = gtk_menu_item_forall;
144 item_class->select = gtk_real_menu_item_select;
145 item_class->deselect = gtk_real_menu_item_deselect;
147 klass->activate = NULL;
148 klass->activate_item = gtk_real_menu_item_activate_item;
150 klass->toggle_size = 0;
151 klass->hide_on_activate = TRUE;
155 gtk_menu_item_init (GtkMenuItem *menu_item)
157 menu_item->submenu = NULL;
158 menu_item->accelerator_signal = menu_item_signals[ACTIVATE];
159 menu_item->toggle_size = 0;
160 menu_item->accelerator_width = 0;
161 menu_item->show_toggle_indicator = FALSE;
162 menu_item->show_submenu_indicator = FALSE;
163 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
164 menu_item->submenu_placement = GTK_TOP_BOTTOM;
165 menu_item->right_justify = FALSE;
167 menu_item->timer = 0;
171 gtk_menu_item_new (void)
173 return GTK_WIDGET (gtk_type_new (gtk_menu_item_get_type ()));
177 gtk_menu_item_new_with_label (const gchar *label)
179 GtkWidget *menu_item;
180 GtkWidget *accel_label;
182 menu_item = gtk_menu_item_new ();
183 accel_label = gtk_accel_label_new (label);
184 gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
186 gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
187 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
188 gtk_widget_show (accel_label);
194 gtk_menu_item_destroy (GtkObject *object)
196 GtkMenuItem *menu_item;
198 g_return_if_fail (object != NULL);
199 g_return_if_fail (GTK_IS_MENU_ITEM (object));
201 menu_item = GTK_MENU_ITEM (object);
203 if (menu_item->submenu)
204 gtk_widget_destroy (menu_item->submenu);
206 if (GTK_OBJECT_CLASS (parent_class)->destroy)
207 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
211 gtk_menu_item_detacher (GtkWidget *widget,
214 GtkMenuItem *menu_item;
216 g_return_if_fail (widget != NULL);
217 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
219 menu_item = GTK_MENU_ITEM (widget);
220 g_return_if_fail (menu_item->submenu == (GtkWidget*) menu);
222 menu_item->submenu = NULL;
226 gtk_menu_item_set_submenu (GtkMenuItem *menu_item,
229 g_return_if_fail (menu_item != NULL);
230 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
232 if (menu_item->submenu != submenu)
234 gtk_menu_item_remove_submenu (menu_item);
236 menu_item->submenu = submenu;
237 gtk_menu_attach_to_widget (GTK_MENU (submenu),
238 GTK_WIDGET (menu_item),
239 gtk_menu_item_detacher);
241 if (GTK_WIDGET (menu_item)->parent)
242 gtk_widget_queue_resize (GTK_WIDGET (menu_item));
247 gtk_menu_item_remove_submenu (GtkMenuItem *menu_item)
249 g_return_if_fail (menu_item != NULL);
250 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
252 if (menu_item->submenu)
253 gtk_menu_detach (GTK_MENU (menu_item->submenu));
257 gtk_menu_item_set_placement (GtkMenuItem *menu_item,
258 GtkSubmenuPlacement placement)
260 g_return_if_fail (menu_item != NULL);
261 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
263 menu_item->submenu_placement = placement;
267 gtk_menu_item_configure (GtkMenuItem *menu_item,
268 gint show_toggle_indicator,
269 gint show_submenu_indicator)
271 g_return_if_fail (menu_item != NULL);
272 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
274 menu_item->show_toggle_indicator = (show_toggle_indicator == TRUE);
275 menu_item->show_submenu_indicator = (show_submenu_indicator == TRUE);
279 gtk_menu_item_select (GtkMenuItem *menu_item)
281 gtk_item_select (GTK_ITEM (menu_item));
285 gtk_menu_item_deselect (GtkMenuItem *menu_item)
287 gtk_item_deselect (GTK_ITEM (menu_item));
291 gtk_menu_item_activate (GtkMenuItem *menu_item)
293 gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[ACTIVATE]);
297 gtk_menu_item_accel_width_foreach (GtkWidget *widget,
302 if (GTK_IS_ACCEL_LABEL (widget))
306 w = gtk_accel_label_accelerator_width (GTK_ACCEL_LABEL (widget));
307 *width = MAX (*width, w);
309 else if (GTK_IS_CONTAINER (widget))
310 gtk_container_foreach (GTK_CONTAINER (widget),
311 gtk_menu_item_accel_width_foreach,
316 gtk_menu_item_size_request (GtkWidget *widget,
317 GtkRequisition *requisition)
319 GtkMenuItem *menu_item;
323 g_return_if_fail (widget != NULL);
324 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
325 g_return_if_fail (requisition != NULL);
327 bin = GTK_BIN (widget);
328 menu_item = GTK_MENU_ITEM (widget);
330 requisition->width = (GTK_CONTAINER (widget)->border_width +
331 widget->style->klass->xthickness +
333 requisition->height = (GTK_CONTAINER (widget)->border_width +
334 widget->style->klass->ythickness) * 2;
336 if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
338 gtk_widget_size_request (bin->child, &bin->child->requisition);
340 requisition->width += bin->child->requisition.width;
341 requisition->height += bin->child->requisition.height;
344 if (menu_item->submenu && menu_item->show_submenu_indicator)
345 requisition->width += 21;
348 gtk_container_foreach (GTK_CONTAINER (menu_item),
349 gtk_menu_item_accel_width_foreach,
351 menu_item->accelerator_width = accel_width;
355 gtk_menu_item_size_allocate (GtkWidget *widget,
356 GtkAllocation *allocation)
358 GtkMenuItem *menu_item;
360 GtkAllocation child_allocation;
362 g_return_if_fail (widget != NULL);
363 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
364 g_return_if_fail (allocation != NULL);
366 menu_item = GTK_MENU_ITEM (widget);
367 bin = GTK_BIN (widget);
369 widget->allocation = *allocation;
373 child_allocation.x = (GTK_CONTAINER (widget)->border_width +
374 widget->style->klass->xthickness +
376 child_allocation.y = (GTK_CONTAINER (widget)->border_width +
377 widget->style->klass->ythickness);
378 child_allocation.width = MAX (1, allocation->width - child_allocation.x * 2);
379 child_allocation.height = MAX (1, allocation->height - child_allocation.y * 2);
380 child_allocation.x += GTK_MENU_ITEM (widget)->toggle_size;
381 child_allocation.width -= GTK_MENU_ITEM (widget)->toggle_size;
382 if (menu_item->submenu && menu_item->show_submenu_indicator)
383 child_allocation.width -= 21;
385 gtk_widget_size_allocate (bin->child, &child_allocation);
388 if (GTK_WIDGET_REALIZED (widget))
389 gdk_window_move_resize (widget->window,
390 allocation->x, allocation->y,
391 allocation->width, allocation->height);
393 if (menu_item->submenu)
394 gtk_menu_reposition (GTK_MENU (menu_item->submenu));
398 gtk_menu_item_paint (GtkWidget *widget,
401 GtkMenuItem *menu_item;
402 GtkStateType state_type;
403 GtkShadowType shadow_type;
407 g_return_if_fail (widget != NULL);
408 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
410 if (GTK_WIDGET_DRAWABLE (widget))
412 menu_item = GTK_MENU_ITEM (widget);
414 state_type = widget->state;
415 if (!GTK_WIDGET_IS_SENSITIVE (widget))
416 state_type = GTK_STATE_INSENSITIVE;
418 gtk_style_set_background (widget->style, widget->window, state_type);
419 gdk_window_clear_area (widget->window, area->x, area->y, area->width, area->height);
421 x = GTK_CONTAINER (menu_item)->border_width;
422 y = GTK_CONTAINER (menu_item)->border_width;
423 width = widget->allocation.width - x * 2;
424 height = widget->allocation.height - y * 2;
426 if ((state_type == GTK_STATE_PRELIGHT) &&
427 (GTK_BIN (menu_item)->child))
428 gtk_draw_shadow (widget->style,
432 x, y, width, height);
434 if (menu_item->submenu && menu_item->show_submenu_indicator)
436 shadow_type = GTK_SHADOW_OUT;
437 if (state_type == GTK_STATE_PRELIGHT)
438 shadow_type = GTK_SHADOW_IN;
440 gtk_draw_arrow (widget->style, widget->window,
441 state_type, shadow_type, GTK_ARROW_RIGHT, FALSE,
442 x + width - 15, y + height / 2 - 5, 10, 10);
444 else if (!GTK_BIN (menu_item)->child)
446 gtk_draw_hline (widget->style, widget->window, GTK_STATE_NORMAL,
447 0, widget->allocation.width, 0);
453 gtk_menu_item_draw (GtkWidget *widget,
457 GdkRectangle child_area;
459 g_return_if_fail (widget != NULL);
460 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
461 g_return_if_fail (area != NULL);
463 if (GTK_WIDGET_DRAWABLE (widget))
465 gtk_menu_item_paint (widget, area);
467 bin = GTK_BIN (widget);
471 if (gtk_widget_intersect (bin->child, area, &child_area))
472 gtk_widget_draw (bin->child, &child_area);
478 gtk_menu_item_expose (GtkWidget *widget,
479 GdkEventExpose *event)
482 GdkEventExpose child_event;
484 g_return_val_if_fail (widget != NULL, FALSE);
485 g_return_val_if_fail (GTK_IS_MENU_ITEM (widget), FALSE);
486 g_return_val_if_fail (event != NULL, FALSE);
488 if (GTK_WIDGET_DRAWABLE (widget))
490 gtk_menu_item_paint (widget, &event->area);
492 bin = GTK_BIN (widget);
496 child_event = *event;
498 if (GTK_WIDGET_NO_WINDOW (bin->child) &&
499 gtk_widget_intersect (bin->child, &event->area, &child_event.area))
500 gtk_widget_event (bin->child, (GdkEvent*) &child_event);
508 gtk_real_menu_item_select (GtkItem *item)
510 GtkMenuItem *menu_item;
512 g_return_if_fail (item != NULL);
513 g_return_if_fail (GTK_IS_MENU_ITEM (item));
515 menu_item = GTK_MENU_ITEM (item);
517 /* if (menu_item->submenu && !GTK_WIDGET_VISIBLE (menu_item->submenu))*/
518 if (menu_item->submenu)
520 /* Boy this is a hack! */
521 GdkEvent *current_event = gtk_get_current_event();
522 if (current_event && (current_event->type != GDK_ENTER_NOTIFY))
523 gtk_menu_item_select_timeout (menu_item);
525 menu_item->timer = gtk_timeout_add (SELECT_TIMEOUT, gtk_menu_item_select_timeout, menu_item);
528 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_PRELIGHT);
529 gtk_widget_draw (GTK_WIDGET (menu_item), NULL);
533 gtk_real_menu_item_deselect (GtkItem *item)
535 GtkMenuItem *menu_item;
537 g_return_if_fail (item != NULL);
538 g_return_if_fail (GTK_IS_MENU_ITEM (item));
540 menu_item = GTK_MENU_ITEM (item);
542 if (menu_item->submenu)
544 if (menu_item->timer)
545 gtk_timeout_remove (menu_item->timer);
547 gtk_menu_popdown (GTK_MENU (menu_item->submenu));
550 gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_NORMAL);
551 gtk_widget_draw (GTK_WIDGET (menu_item), NULL);
555 gtk_real_menu_item_activate_item (GtkMenuItem *menu_item)
559 g_return_if_fail (menu_item != NULL);
560 g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
562 widget = GTK_WIDGET (menu_item);
564 if (widget->parent &&
565 GTK_IS_MENU_SHELL (widget->parent))
567 if (menu_item->submenu == NULL)
568 gtk_menu_shell_activate_item (GTK_MENU_SHELL (widget->parent),
572 GtkMenuShell *menu_shell = GTK_MENU_SHELL (widget->parent);
574 if (!menu_shell->active)
576 gtk_grab_add (GTK_WIDGET (menu_shell));
577 menu_shell->have_grab = TRUE;
578 menu_shell->active = TRUE;
581 gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent), widget);
587 gtk_menu_item_select_timeout (gpointer data)
589 GtkMenuItem *menu_item;
591 menu_item = GTK_MENU_ITEM (data);
592 menu_item->timer = 0;
594 gtk_menu_popup (GTK_MENU (menu_item->submenu),
595 GTK_WIDGET (menu_item)->parent,
596 GTK_WIDGET (menu_item),
597 gtk_menu_item_position_menu,
599 GTK_MENU_SHELL (GTK_WIDGET (menu_item)->parent)->button,
602 /* This is a bit of a hack - we want to select the first item
603 * of menus hanging of a menu bar, but not for cascading submenus
605 if (GTK_IS_MENU_BAR (GTK_WIDGET (menu_item)->parent))
607 GtkMenuShell *submenu = GTK_MENU_SHELL (menu_item->submenu);
608 if (submenu->children)
609 gtk_menu_shell_select_item (submenu, submenu->children->data);
616 gtk_menu_item_position_menu (GtkMenu *menu,
621 GtkMenuItem *menu_item;
622 GtkWidget *parent_menu_item;
625 gint twidth, theight;
628 g_return_if_fail (menu != NULL);
629 g_return_if_fail (x != NULL);
630 g_return_if_fail (y != NULL);
632 menu_item = GTK_MENU_ITEM (user_data);
634 twidth = GTK_WIDGET (menu)->requisition.width;
635 theight = GTK_WIDGET (menu)->requisition.height;
637 screen_width = gdk_screen_width ();
638 screen_height = gdk_screen_height ();
640 if (!gdk_window_get_origin (GTK_WIDGET (menu_item)->window, &tx, &ty))
642 g_warning ("Menu not on screen");
646 switch (menu_item->submenu_placement)
649 if ((ty + GTK_WIDGET (menu_item)->allocation.height + theight) <= screen_height)
650 ty += GTK_WIDGET (menu_item)->allocation.height;
651 else if ((ty - theight) >= 0)
654 ty += GTK_WIDGET (menu_item)->allocation.height;
656 if ((tx + twidth) > screen_width)
658 tx -= ((tx + twidth) - screen_width);
665 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
666 parent_menu_item = GTK_MENU (GTK_WIDGET (menu_item)->parent)->parent_menu_item;
667 if (parent_menu_item)
668 menu_item->submenu_direction = GTK_MENU_ITEM (parent_menu_item)->submenu_direction;
670 switch (menu_item->submenu_direction)
672 case GTK_DIRECTION_LEFT:
673 if ((tx - twidth) >= 0)
677 menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
678 tx += GTK_WIDGET (menu_item)->allocation.width - 5;
682 case GTK_DIRECTION_RIGHT:
683 if ((tx + GTK_WIDGET (menu_item)->allocation.width + twidth - 5) <= screen_width)
684 tx += GTK_WIDGET (menu_item)->allocation.width - 5;
687 menu_item->submenu_direction = GTK_DIRECTION_LEFT;
693 if ((ty + GTK_WIDGET (menu_item)->allocation.height / 4 + theight) <= screen_height)
694 ty += GTK_WIDGET (menu_item)->allocation.height / 4;
697 ty -= ((ty + theight) - screen_height);
709 gtk_menu_item_right_justify(GtkMenuItem *menuitem)
711 g_return_if_fail (menuitem != NULL);
712 g_return_if_fail (GTK_IS_MENU_ITEM (menuitem));
714 menuitem->right_justify = 1;
719 gtk_menu_item_show_all (GtkWidget *widget)
721 GtkMenuItem *menu_item;
723 g_return_if_fail (widget != NULL);
724 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
726 menu_item = GTK_MENU_ITEM (widget);
728 /* show children including submenu */
729 if (menu_item->submenu)
730 gtk_widget_show_all (menu_item->submenu);
731 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_show_all, NULL);
733 gtk_widget_show (widget);
737 gtk_menu_item_hide_all (GtkWidget *widget)
739 GtkMenuItem *menu_item;
741 g_return_if_fail (widget != NULL);
742 g_return_if_fail (GTK_IS_MENU_ITEM (widget));
744 gtk_widget_hide (widget);
746 menu_item = GTK_MENU_ITEM (widget);
748 /* hide children including submenu */
749 gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_hide_all, NULL);
750 if (menu_item->submenu)
751 gtk_widget_hide_all (menu_item->submenu);
755 gtk_menu_item_forall (GtkContainer *container,
756 gboolean include_internals,
757 GtkCallback callback,
758 gpointer callback_data)
761 GtkMenuItem *menu_item;
763 g_return_if_fail (container != NULL);
764 g_return_if_fail (GTK_IS_MENU_ITEM (container));
765 g_return_if_fail (callback != NULL);
767 bin = GTK_BIN (container);
768 menu_item = GTK_MENU_ITEM (container);
771 (* callback) (bin->child, callback_data);
772 if (include_internals && menu_item->submenu)
773 (* callback) (menu_item->submenu, callback_data);