1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 2001 Red Hat, Inc.
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 "gtkimagemenuitem.h"
29 #include "gtkaccellabel.h"
32 #include "gtkiconfactory.h"
34 #include "gtkmenubar.h"
35 #include "gtkcontainer.h"
36 #include "gtkwindow.h"
37 #include "gtkactivatable.h"
38 #include "gtkprivate.h"
41 static void gtk_image_menu_item_destroy (GtkObject *object);
42 static void gtk_image_menu_item_size_request (GtkWidget *widget,
43 GtkRequisition *requisition);
44 static void gtk_image_menu_item_size_allocate (GtkWidget *widget,
45 GtkAllocation *allocation);
46 static void gtk_image_menu_item_map (GtkWidget *widget);
47 static void gtk_image_menu_item_remove (GtkContainer *container,
49 static void gtk_image_menu_item_toggle_size_request (GtkMenuItem *menu_item,
51 static void gtk_image_menu_item_set_label (GtkMenuItem *menu_item,
53 static G_CONST_RETURN gchar *gtk_image_menu_item_get_label (GtkMenuItem *menu_item);
55 static void gtk_image_menu_item_forall (GtkContainer *container,
56 gboolean include_internals,
58 gpointer callback_data);
60 static void gtk_image_menu_item_finalize (GObject *object);
61 static void gtk_image_menu_item_set_property (GObject *object,
65 static void gtk_image_menu_item_get_property (GObject *object,
69 static void gtk_image_menu_item_screen_changed (GtkWidget *widget,
70 GdkScreen *previous_screen);
72 static void gtk_image_menu_item_recalculate (GtkImageMenuItem *image_menu_item);
74 static void gtk_image_menu_item_activatable_interface_init (GtkActivatableIface *iface);
75 static void gtk_image_menu_item_update (GtkActivatable *activatable,
77 const gchar *property_name);
78 static void gtk_image_menu_item_sync_action_properties (GtkActivatable *activatable,
84 guint always_show_image : 1;
85 } GtkImageMenuItemPrivate;
92 PROP_ALWAYS_SHOW_IMAGE
95 static GtkActivatableIface *parent_activatable_iface;
98 G_DEFINE_TYPE_WITH_CODE (GtkImageMenuItem, gtk_image_menu_item, GTK_TYPE_MENU_ITEM,
99 G_IMPLEMENT_INTERFACE (GTK_TYPE_ACTIVATABLE,
100 gtk_image_menu_item_activatable_interface_init))
102 #define GET_PRIVATE(object) \
103 (G_TYPE_INSTANCE_GET_PRIVATE ((object), GTK_TYPE_IMAGE_MENU_ITEM, GtkImageMenuItemPrivate))
106 gtk_image_menu_item_class_init (GtkImageMenuItemClass *klass)
108 GObjectClass *gobject_class = (GObjectClass*) klass;
109 GtkObjectClass *object_class = (GtkObjectClass*) klass;
110 GtkWidgetClass *widget_class = (GtkWidgetClass*) klass;
111 GtkMenuItemClass *menu_item_class = (GtkMenuItemClass*) klass;
112 GtkContainerClass *container_class = (GtkContainerClass*) klass;
114 object_class->destroy = gtk_image_menu_item_destroy;
116 widget_class->screen_changed = gtk_image_menu_item_screen_changed;
117 widget_class->size_request = gtk_image_menu_item_size_request;
118 widget_class->size_allocate = gtk_image_menu_item_size_allocate;
119 widget_class->map = gtk_image_menu_item_map;
121 container_class->forall = gtk_image_menu_item_forall;
122 container_class->remove = gtk_image_menu_item_remove;
124 menu_item_class->toggle_size_request = gtk_image_menu_item_toggle_size_request;
125 menu_item_class->set_label = gtk_image_menu_item_set_label;
126 menu_item_class->get_label = gtk_image_menu_item_get_label;
128 gobject_class->finalize = gtk_image_menu_item_finalize;
129 gobject_class->set_property = gtk_image_menu_item_set_property;
130 gobject_class->get_property = gtk_image_menu_item_get_property;
132 g_object_class_install_property (gobject_class,
134 g_param_spec_object ("image",
136 P_("Child widget to appear next to the menu text"),
138 GTK_PARAM_READWRITE));
140 * GtkImageMenuItem:use-stock:
142 * If %TRUE, the label set in the menuitem is used as a
143 * stock id to select the stock item for the item.
147 g_object_class_install_property (gobject_class,
149 g_param_spec_boolean ("use-stock",
151 P_("Whether to use the label text to create a stock menu item"),
153 GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT));
156 * GtkImageMenuItem:always-show-image:
158 * If %TRUE, the menu item will ignore the #GtkSettings:gtk-menu-images
159 * setting and always show the image, if available.
161 * Use this property if the menuitem would be useless or hard to use
166 g_object_class_install_property (gobject_class,
167 PROP_ALWAYS_SHOW_IMAGE,
168 g_param_spec_boolean ("always-show-image",
169 P_("Always show image"),
170 P_("Whether the image will always be shown"),
172 GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT));
175 * GtkImageMenuItem:accel-group:
177 * The Accel Group to use for stock accelerator keys
181 g_object_class_install_property (gobject_class,
183 g_param_spec_object ("accel-group",
185 P_("The Accel Group to use for stock accelerator keys"),
186 GTK_TYPE_ACCEL_GROUP,
187 GTK_PARAM_WRITABLE));
189 gtk_settings_install_property (g_param_spec_boolean ("gtk-menu-images",
190 P_("Show menu images"),
191 P_("Whether images should be shown in menus"),
193 GTK_PARAM_READWRITE));
196 g_type_class_add_private (object_class, sizeof (GtkImageMenuItemPrivate));
201 gtk_image_menu_item_init (GtkImageMenuItem *image_menu_item)
203 GtkImageMenuItemPrivate *priv = GET_PRIVATE (image_menu_item);
205 priv->use_stock = FALSE;
208 image_menu_item->image = NULL;
212 gtk_image_menu_item_finalize (GObject *object)
214 GtkImageMenuItemPrivate *priv = GET_PRIVATE (object);
216 g_free (priv->label);
219 G_OBJECT_CLASS (gtk_image_menu_item_parent_class)->finalize (object);
223 gtk_image_menu_item_set_property (GObject *object,
228 GtkImageMenuItem *image_menu_item = GTK_IMAGE_MENU_ITEM (object);
233 gtk_image_menu_item_set_image (image_menu_item, (GtkWidget *) g_value_get_object (value));
236 gtk_image_menu_item_set_use_stock (image_menu_item, g_value_get_boolean (value));
238 case PROP_ALWAYS_SHOW_IMAGE:
239 gtk_image_menu_item_set_always_show_image (image_menu_item, g_value_get_boolean (value));
241 case PROP_ACCEL_GROUP:
242 gtk_image_menu_item_set_accel_group (image_menu_item, g_value_get_object (value));
245 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
251 gtk_image_menu_item_get_property (GObject *object,
256 GtkImageMenuItem *image_menu_item = GTK_IMAGE_MENU_ITEM (object);
261 g_value_set_object (value, gtk_image_menu_item_get_image (image_menu_item));
264 g_value_set_boolean (value, gtk_image_menu_item_get_use_stock (image_menu_item));
266 case PROP_ALWAYS_SHOW_IMAGE:
267 g_value_set_boolean (value, gtk_image_menu_item_get_always_show_image (image_menu_item));
270 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
276 show_image (GtkImageMenuItem *image_menu_item)
278 GtkImageMenuItemPrivate *priv = GET_PRIVATE (image_menu_item);
279 GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (image_menu_item));
282 if (priv->always_show_image)
285 g_object_get (settings, "gtk-menu-images", &show, NULL);
291 gtk_image_menu_item_map (GtkWidget *widget)
293 GtkImageMenuItem *image_menu_item = GTK_IMAGE_MENU_ITEM (widget);
295 GTK_WIDGET_CLASS (gtk_image_menu_item_parent_class)->map (widget);
297 if (image_menu_item->image)
298 g_object_set (image_menu_item->image,
299 "visible", show_image (image_menu_item),
304 gtk_image_menu_item_destroy (GtkObject *object)
306 GtkImageMenuItem *image_menu_item = GTK_IMAGE_MENU_ITEM (object);
308 if (image_menu_item->image)
309 gtk_container_remove (GTK_CONTAINER (image_menu_item),
310 image_menu_item->image);
312 GTK_OBJECT_CLASS (gtk_image_menu_item_parent_class)->destroy (object);
316 gtk_image_menu_item_toggle_size_request (GtkMenuItem *menu_item,
319 GtkImageMenuItem *image_menu_item = GTK_IMAGE_MENU_ITEM (menu_item);
320 GtkPackDirection pack_dir;
322 if (GTK_IS_MENU_BAR (GTK_WIDGET (menu_item)->parent))
323 pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (GTK_WIDGET (menu_item)->parent));
325 pack_dir = GTK_PACK_DIRECTION_LTR;
329 if (image_menu_item->image && gtk_widget_get_visible (image_menu_item->image))
331 GtkRequisition image_requisition;
332 guint toggle_spacing;
333 gtk_widget_get_child_requisition (image_menu_item->image,
336 gtk_widget_style_get (GTK_WIDGET (menu_item),
337 "toggle-spacing", &toggle_spacing,
340 if (pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL)
342 if (image_requisition.width > 0)
343 *requisition = image_requisition.width + toggle_spacing;
347 if (image_requisition.height > 0)
348 *requisition = image_requisition.height + toggle_spacing;
354 gtk_image_menu_item_recalculate (GtkImageMenuItem *image_menu_item)
356 GtkImageMenuItemPrivate *priv = GET_PRIVATE (image_menu_item);
357 GtkStockItem stock_item;
359 const gchar *resolved_label = priv->label;
361 if (priv->use_stock && priv->label)
364 if (!image_menu_item->image)
366 image = gtk_image_new_from_stock (priv->label, GTK_ICON_SIZE_MENU);
367 gtk_image_menu_item_set_image (image_menu_item, image);
370 if (gtk_stock_lookup (priv->label, &stock_item))
371 resolved_label = stock_item.label;
373 gtk_menu_item_set_use_underline (GTK_MENU_ITEM (image_menu_item), TRUE);
377 (gtk_image_menu_item_parent_class)->set_label (GTK_MENU_ITEM (image_menu_item), resolved_label);
382 gtk_image_menu_item_set_label (GtkMenuItem *menu_item,
385 GtkImageMenuItemPrivate *priv = GET_PRIVATE (menu_item);
387 if (priv->label != label)
389 g_free (priv->label);
390 priv->label = g_strdup (label);
392 gtk_image_menu_item_recalculate (GTK_IMAGE_MENU_ITEM (menu_item));
394 g_object_notify (G_OBJECT (menu_item), "label");
399 static G_CONST_RETURN gchar *
400 gtk_image_menu_item_get_label (GtkMenuItem *menu_item)
402 GtkImageMenuItemPrivate *priv = GET_PRIVATE (menu_item);
408 gtk_image_menu_item_size_request (GtkWidget *widget,
409 GtkRequisition *requisition)
411 GtkImageMenuItem *image_menu_item;
412 gint child_width = 0;
413 gint child_height = 0;
414 GtkPackDirection pack_dir;
416 if (GTK_IS_MENU_BAR (widget->parent))
417 pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (widget->parent));
419 pack_dir = GTK_PACK_DIRECTION_LTR;
421 image_menu_item = GTK_IMAGE_MENU_ITEM (widget);
423 if (image_menu_item->image && gtk_widget_get_visible (image_menu_item->image))
425 GtkRequisition child_requisition;
427 gtk_widget_size_request (image_menu_item->image,
430 child_width = child_requisition.width;
431 child_height = child_requisition.height;
434 GTK_WIDGET_CLASS (gtk_image_menu_item_parent_class)->size_request (widget, requisition);
436 /* not done with height since that happens via the
437 * toggle_size_request
439 if (pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL)
440 requisition->height = MAX (requisition->height, child_height);
442 requisition->width = MAX (requisition->width, child_width);
445 /* Note that GtkMenuShell always size requests before
446 * toggle_size_request, so toggle_size_request will be able to use
447 * image_menu_item->image->requisition
452 gtk_image_menu_item_size_allocate (GtkWidget *widget,
453 GtkAllocation *allocation)
455 GtkImageMenuItem *image_menu_item;
456 GtkPackDirection pack_dir;
458 if (GTK_IS_MENU_BAR (widget->parent))
459 pack_dir = gtk_menu_bar_get_child_pack_direction (GTK_MENU_BAR (widget->parent));
461 pack_dir = GTK_PACK_DIRECTION_LTR;
463 image_menu_item = GTK_IMAGE_MENU_ITEM (widget);
465 GTK_WIDGET_CLASS (gtk_image_menu_item_parent_class)->size_allocate (widget, allocation);
467 if (image_menu_item->image && gtk_widget_get_visible (image_menu_item->image))
470 GtkRequisition child_requisition;
471 GtkAllocation child_allocation;
472 guint horizontal_padding, toggle_spacing;
474 gtk_widget_style_get (widget,
475 "horizontal-padding", &horizontal_padding,
476 "toggle-spacing", &toggle_spacing,
479 /* Man this is lame hardcoding action, but I can't
480 * come up with a solution that's really better.
483 gtk_widget_get_child_requisition (image_menu_item->image,
486 if (pack_dir == GTK_PACK_DIRECTION_LTR ||
487 pack_dir == GTK_PACK_DIRECTION_RTL)
489 offset = gtk_container_get_border_width (GTK_CONTAINER (image_menu_item)) +
490 widget->style->xthickness;
492 if ((gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR) ==
493 (pack_dir == GTK_PACK_DIRECTION_LTR))
494 x = offset + horizontal_padding +
495 (GTK_MENU_ITEM (image_menu_item)->toggle_size -
496 toggle_spacing - child_requisition.width) / 2;
498 x = widget->allocation.width - offset - horizontal_padding -
499 GTK_MENU_ITEM (image_menu_item)->toggle_size + toggle_spacing +
500 (GTK_MENU_ITEM (image_menu_item)->toggle_size -
501 toggle_spacing - child_requisition.width) / 2;
503 y = (widget->allocation.height - child_requisition.height) / 2;
507 offset = gtk_container_get_border_width (GTK_CONTAINER (image_menu_item)) +
508 widget->style->ythickness;
510 if ((gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR) ==
511 (pack_dir == GTK_PACK_DIRECTION_TTB))
512 y = offset + horizontal_padding +
513 (GTK_MENU_ITEM (image_menu_item)->toggle_size -
514 toggle_spacing - child_requisition.height) / 2;
516 y = widget->allocation.height - offset - horizontal_padding -
517 GTK_MENU_ITEM (image_menu_item)->toggle_size + toggle_spacing +
518 (GTK_MENU_ITEM (image_menu_item)->toggle_size -
519 toggle_spacing - child_requisition.height) / 2;
521 x = (widget->allocation.width - child_requisition.width) / 2;
524 child_allocation.width = child_requisition.width;
525 child_allocation.height = child_requisition.height;
526 child_allocation.x = widget->allocation.x + MAX (x, 0);
527 child_allocation.y = widget->allocation.y + MAX (y, 0);
529 gtk_widget_size_allocate (image_menu_item->image, &child_allocation);
534 gtk_image_menu_item_forall (GtkContainer *container,
535 gboolean include_internals,
536 GtkCallback callback,
537 gpointer callback_data)
539 GtkImageMenuItem *image_menu_item = GTK_IMAGE_MENU_ITEM (container);
541 GTK_CONTAINER_CLASS (gtk_image_menu_item_parent_class)->forall (container,
546 if (include_internals && image_menu_item->image)
547 (* callback) (image_menu_item->image, callback_data);
552 gtk_image_menu_item_activatable_interface_init (GtkActivatableIface *iface)
554 parent_activatable_iface = g_type_interface_peek_parent (iface);
555 iface->update = gtk_image_menu_item_update;
556 iface->sync_action_properties = gtk_image_menu_item_sync_action_properties;
560 activatable_update_stock_id (GtkImageMenuItem *image_menu_item, GtkAction *action)
563 const gchar *stock_id = gtk_action_get_stock_id (action);
565 image = gtk_image_menu_item_get_image (image_menu_item);
567 if (GTK_IS_IMAGE (image) &&
568 stock_id && gtk_icon_factory_lookup_default (stock_id))
570 gtk_image_set_from_stock (GTK_IMAGE (image), stock_id, GTK_ICON_SIZE_MENU);
578 activatable_update_gicon (GtkImageMenuItem *image_menu_item, GtkAction *action)
581 GIcon *icon = gtk_action_get_gicon (action);
582 const gchar *stock_id = gtk_action_get_stock_id (action);
584 image = gtk_image_menu_item_get_image (image_menu_item);
586 if (icon && GTK_IS_IMAGE (image) &&
587 !(stock_id && gtk_icon_factory_lookup_default (stock_id)))
589 gtk_image_set_from_gicon (GTK_IMAGE (image), icon, GTK_ICON_SIZE_MENU);
597 activatable_update_icon_name (GtkImageMenuItem *image_menu_item, GtkAction *action)
600 const gchar *icon_name = gtk_action_get_icon_name (action);
602 image = gtk_image_menu_item_get_image (image_menu_item);
604 if (GTK_IS_IMAGE (image) &&
605 (gtk_image_get_storage_type (GTK_IMAGE (image)) == GTK_IMAGE_EMPTY ||
606 gtk_image_get_storage_type (GTK_IMAGE (image)) == GTK_IMAGE_ICON_NAME))
608 gtk_image_set_from_icon_name (GTK_IMAGE (image), icon_name, GTK_ICON_SIZE_MENU);
613 gtk_image_menu_item_update (GtkActivatable *activatable,
615 const gchar *property_name)
617 GtkImageMenuItem *image_menu_item;
618 gboolean use_appearance;
620 image_menu_item = GTK_IMAGE_MENU_ITEM (activatable);
622 parent_activatable_iface->update (activatable, action, property_name);
624 use_appearance = gtk_activatable_get_use_action_appearance (activatable);
628 if (strcmp (property_name, "stock-id") == 0)
629 activatable_update_stock_id (image_menu_item, action);
630 else if (strcmp (property_name, "gicon") == 0)
631 activatable_update_gicon (image_menu_item, action);
632 else if (strcmp (property_name, "icon-name") == 0)
633 activatable_update_icon_name (image_menu_item, action);
637 gtk_image_menu_item_sync_action_properties (GtkActivatable *activatable,
640 GtkImageMenuItem *image_menu_item;
642 gboolean use_appearance;
644 image_menu_item = GTK_IMAGE_MENU_ITEM (activatable);
646 parent_activatable_iface->sync_action_properties (activatable, action);
651 use_appearance = gtk_activatable_get_use_action_appearance (activatable);
655 image = gtk_image_menu_item_get_image (image_menu_item);
656 if (image && !GTK_IS_IMAGE (image))
658 gtk_image_menu_item_set_image (image_menu_item, NULL);
664 image = gtk_image_new ();
665 gtk_widget_show (image);
666 gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (activatable),
670 if (!activatable_update_stock_id (image_menu_item, action) &&
671 !activatable_update_gicon (image_menu_item, action))
672 activatable_update_icon_name (image_menu_item, action);
674 gtk_image_menu_item_set_always_show_image (image_menu_item,
675 gtk_action_get_always_show_image (action));
680 * gtk_image_menu_item_new:
681 * @returns: a new #GtkImageMenuItem.
683 * Creates a new #GtkImageMenuItem with an empty label.
686 gtk_image_menu_item_new (void)
688 return g_object_new (GTK_TYPE_IMAGE_MENU_ITEM, NULL);
692 * gtk_image_menu_item_new_with_label:
693 * @label: the text of the menu item.
694 * @returns: a new #GtkImageMenuItem.
696 * Creates a new #GtkImageMenuItem containing a label.
699 gtk_image_menu_item_new_with_label (const gchar *label)
701 return g_object_new (GTK_TYPE_IMAGE_MENU_ITEM,
708 * gtk_image_menu_item_new_with_mnemonic:
709 * @label: the text of the menu item, with an underscore in front of the
711 * @returns: a new #GtkImageMenuItem
713 * Creates a new #GtkImageMenuItem containing a label. The label
714 * will be created using gtk_label_new_with_mnemonic(), so underscores
715 * in @label indicate the mnemonic for the menu item.
718 gtk_image_menu_item_new_with_mnemonic (const gchar *label)
720 return g_object_new (GTK_TYPE_IMAGE_MENU_ITEM,
721 "use-underline", TRUE,
727 * gtk_image_menu_item_new_from_stock:
728 * @stock_id: the name of the stock item.
729 * @accel_group: (allow-none): the #GtkAccelGroup to add the menu items
730 * accelerator to, or %NULL.
731 * @returns: a new #GtkImageMenuItem.
733 * Creates a new #GtkImageMenuItem containing the image and text from a
734 * stock item. Some stock ids have preprocessor macros like #GTK_STOCK_OK
735 * and #GTK_STOCK_APPLY.
737 * If you want this menu item to have changeable accelerators, then pass in
738 * %NULL for accel_group. Next call gtk_menu_item_set_accel_path() with an
739 * appropriate path for the menu item, use gtk_stock_lookup() to look up the
740 * standard accelerator for the stock item, and if one is found, call
741 * gtk_accel_map_add_entry() to register it.
744 gtk_image_menu_item_new_from_stock (const gchar *stock_id,
745 GtkAccelGroup *accel_group)
747 return g_object_new (GTK_TYPE_IMAGE_MENU_ITEM,
750 "accel-group", accel_group,
755 * gtk_image_menu_item_set_use_stock:
756 * @image_menu_item: a #GtkImageMenuItem
757 * @use_stock: %TRUE if the menuitem should use a stock item
759 * If %TRUE, the label set in the menuitem is used as a
760 * stock id to select the stock item for the item.
765 gtk_image_menu_item_set_use_stock (GtkImageMenuItem *image_menu_item,
768 GtkImageMenuItemPrivate *priv;
770 g_return_if_fail (GTK_IS_IMAGE_MENU_ITEM (image_menu_item));
772 priv = GET_PRIVATE (image_menu_item);
774 if (priv->use_stock != use_stock)
776 priv->use_stock = use_stock;
778 gtk_image_menu_item_recalculate (image_menu_item);
780 g_object_notify (G_OBJECT (image_menu_item), "use-stock");
785 * gtk_image_menu_item_get_use_stock:
786 * @image_menu_item: a #GtkImageMenuItem
788 * Checks whether the label set in the menuitem is used as a
789 * stock id to select the stock item for the item.
791 * Returns: %TRUE if the label set in the menuitem is used as a
792 * stock id to select the stock item for the item
797 gtk_image_menu_item_get_use_stock (GtkImageMenuItem *image_menu_item)
799 GtkImageMenuItemPrivate *priv;
801 g_return_val_if_fail (GTK_IS_IMAGE_MENU_ITEM (image_menu_item), FALSE);
803 priv = GET_PRIVATE (image_menu_item);
805 return priv->use_stock;
809 * gtk_image_menu_item_set_always_show_image:
810 * @image_menu_item: a #GtkImageMenuItem
811 * @always_show: %TRUE if the menuitem should always show the image
813 * If %TRUE, the menu item will ignore the #GtkSettings:gtk-menu-images
814 * setting and always show the image, if available.
816 * Use this property if the menuitem would be useless or hard to use
822 gtk_image_menu_item_set_always_show_image (GtkImageMenuItem *image_menu_item,
823 gboolean always_show)
825 GtkImageMenuItemPrivate *priv;
827 g_return_if_fail (GTK_IS_IMAGE_MENU_ITEM (image_menu_item));
829 priv = GET_PRIVATE (image_menu_item);
831 if (priv->always_show_image != always_show)
833 priv->always_show_image = always_show;
835 if (image_menu_item->image)
837 if (show_image (image_menu_item))
838 gtk_widget_show (image_menu_item->image);
840 gtk_widget_hide (image_menu_item->image);
843 g_object_notify (G_OBJECT (image_menu_item), "always-show-image");
848 * gtk_image_menu_item_get_always_show_image:
849 * @image_menu_item: a #GtkImageMenuItem
851 * Returns whether the menu item will ignore the #GtkSettings:gtk-menu-images
852 * setting and always show the image, if available.
854 * Returns: %TRUE if the menu item will always show the image
859 gtk_image_menu_item_get_always_show_image (GtkImageMenuItem *image_menu_item)
861 GtkImageMenuItemPrivate *priv;
863 g_return_val_if_fail (GTK_IS_IMAGE_MENU_ITEM (image_menu_item), FALSE);
865 priv = GET_PRIVATE (image_menu_item);
867 return priv->always_show_image;
872 * gtk_image_menu_item_set_accel_group:
873 * @image_menu_item: a #GtkImageMenuItem
874 * @accel_group: the #GtkAccelGroup
876 * Specifies an @accel_group to add the menu items accelerator to
877 * (this only applies to stock items so a stock item must already
878 * be set, make sure to call gtk_image_menu_item_set_use_stock()
879 * and gtk_menu_item_set_label() with a valid stock item first).
881 * If you want this menu item to have changeable accelerators then
882 * you shouldnt need this (see gtk_image_menu_item_new_from_stock()).
887 gtk_image_menu_item_set_accel_group (GtkImageMenuItem *image_menu_item,
888 GtkAccelGroup *accel_group)
890 GtkImageMenuItemPrivate *priv;
891 GtkStockItem stock_item;
893 /* Silent return for the constructor */
897 g_return_if_fail (GTK_IS_IMAGE_MENU_ITEM (image_menu_item));
898 g_return_if_fail (GTK_IS_ACCEL_GROUP (accel_group));
900 priv = GET_PRIVATE (image_menu_item);
902 if (priv->use_stock && priv->label && gtk_stock_lookup (priv->label, &stock_item))
903 if (stock_item.keyval)
905 gtk_widget_add_accelerator (GTK_WIDGET (image_menu_item),
912 g_object_notify (G_OBJECT (image_menu_item), "accel-group");
917 * gtk_image_menu_item_set_image:
918 * @image_menu_item: a #GtkImageMenuItem.
919 * @image: (allow-none): a widget to set as the image for the menu item.
921 * Sets the image of @image_menu_item to the given widget.
922 * Note that it depends on the show-menu-images setting whether
923 * the image will be displayed or not.
926 gtk_image_menu_item_set_image (GtkImageMenuItem *image_menu_item,
929 g_return_if_fail (GTK_IS_IMAGE_MENU_ITEM (image_menu_item));
931 if (image == image_menu_item->image)
934 if (image_menu_item->image)
935 gtk_container_remove (GTK_CONTAINER (image_menu_item),
936 image_menu_item->image);
938 image_menu_item->image = image;
943 gtk_widget_set_parent (image, GTK_WIDGET (image_menu_item));
945 "visible", show_image (image_menu_item),
949 g_object_notify (G_OBJECT (image_menu_item), "image");
953 * gtk_image_menu_item_get_image:
954 * @image_menu_item: a #GtkImageMenuItem.
955 * @returns: the widget set as image of @image_menu_item.
957 * Gets the widget that is currently set as the image of @image_menu_item.
958 * See gtk_image_menu_item_set_image().
961 gtk_image_menu_item_get_image (GtkImageMenuItem *image_menu_item)
963 g_return_val_if_fail (GTK_IS_IMAGE_MENU_ITEM (image_menu_item), NULL);
965 return image_menu_item->image;
969 gtk_image_menu_item_remove (GtkContainer *container,
972 GtkImageMenuItem *image_menu_item;
974 image_menu_item = GTK_IMAGE_MENU_ITEM (container);
976 if (child == image_menu_item->image)
978 gboolean widget_was_visible;
980 widget_was_visible = gtk_widget_get_visible (child);
982 gtk_widget_unparent (child);
983 image_menu_item->image = NULL;
985 if (widget_was_visible &&
986 gtk_widget_get_visible (GTK_WIDGET (container)))
987 gtk_widget_queue_resize (GTK_WIDGET (container));
989 g_object_notify (G_OBJECT (image_menu_item), "image");
993 GTK_CONTAINER_CLASS (gtk_image_menu_item_parent_class)->remove (container, child);
998 show_image_change_notify (GtkImageMenuItem *image_menu_item)
1000 if (image_menu_item->image)
1002 if (show_image (image_menu_item))
1003 gtk_widget_show (image_menu_item->image);
1005 gtk_widget_hide (image_menu_item->image);
1010 traverse_container (GtkWidget *widget,
1013 if (GTK_IS_IMAGE_MENU_ITEM (widget))
1014 show_image_change_notify (GTK_IMAGE_MENU_ITEM (widget));
1015 else if (GTK_IS_CONTAINER (widget))
1016 gtk_container_forall (GTK_CONTAINER (widget), traverse_container, NULL);
1020 gtk_image_menu_item_setting_changed (GtkSettings *settings)
1024 list = gtk_window_list_toplevels ();
1026 for (l = list; l; l = l->next)
1027 gtk_container_forall (GTK_CONTAINER (l->data),
1028 traverse_container, NULL);
1034 gtk_image_menu_item_screen_changed (GtkWidget *widget,
1035 GdkScreen *previous_screen)
1037 GtkSettings *settings;
1038 guint show_image_connection;
1040 if (!gtk_widget_has_screen (widget))
1043 settings = gtk_widget_get_settings (widget);
1045 show_image_connection =
1046 GPOINTER_TO_UINT (g_object_get_data (G_OBJECT (settings),
1047 "gtk-image-menu-item-connection"));
1049 if (show_image_connection)
1052 show_image_connection =
1053 g_signal_connect (settings, "notify::gtk-menu-images",
1054 G_CALLBACK (gtk_image_menu_item_setting_changed), NULL);
1055 g_object_set_data (G_OBJECT (settings),
1056 I_("gtk-image-menu-item-connection"),
1057 GUINT_TO_POINTER (show_image_connection));
1059 show_image_change_notify (GTK_IMAGE_MENU_ITEM (widget));