| Top |
| GtkAccelGroup * | accel-group | Write |
| gboolean | always-show-image | Read / Write / Construct |
| GtkWidget * | image | Read / Write |
| gboolean | use-stock | Read / Write / Construct |
GObject
╰── GInitiallyUnowned
╰── GtkObject
╰── GtkWidget
╰── GtkContainer
╰── GtkBin
╰── GtkItem
╰── GtkMenuItem
╰── GtkImageMenuItem
GtkImageMenuItem implements AtkImplementorIface, GtkBuildable and GtkActivatable.
void gtk_image_menu_item_set_image (GtkImageMenuItem *image_menu_item,GtkWidget *image);
Sets the image of image_menu_item
to the given widget.
Note that it depends on the show-menu-images setting whether
the image will be displayed or not.
GtkWidget *
gtk_image_menu_item_get_image (GtkImageMenuItem *image_menu_item);
Gets the widget that is currently set as the image of image_menu_item
.
See gtk_image_menu_item_set_image().
GtkWidget *
gtk_image_menu_item_new (void);
Creates a new GtkImageMenuItem with an empty label.
GtkWidget * gtk_image_menu_item_new_from_stock (const gchar *stock_id,GtkAccelGroup *accel_group);
Creates a new GtkImageMenuItem containing the image and text from a stock item. Some stock ids have preprocessor macros like GTK_STOCK_OK and GTK_STOCK_APPLY.
If you want this menu item to have changeable accelerators, then pass in
NULL for accel_group. Next call gtk_menu_item_set_accel_path() with an
appropriate path for the menu item, use gtk_stock_lookup() to look up the
standard accelerator for the stock item, and if one is found, call
gtk_accel_map_add_entry() to register it.
stock_id |
the name of the stock item. |
|
accel_group |
the GtkAccelGroup to add the menu items
accelerator to, or |
[allow-none] |
returns |
a new GtkImageMenuItem. |
GtkWidget *
gtk_image_menu_item_new_with_label (const gchar *label);
Creates a new GtkImageMenuItem containing a label.
GtkWidget *
gtk_image_menu_item_new_with_mnemonic (const gchar *label);
Creates a new GtkImageMenuItem containing a label. The label
will be created using gtk_label_new_with_mnemonic(), so underscores
in label
indicate the mnemonic for the menu item.
label |
the text of the menu item, with an underscore in front of the mnemonic character |
|
returns |
a new GtkImageMenuItem |
gboolean
gtk_image_menu_item_get_use_stock (GtkImageMenuItem *image_menu_item);
Checks whether the label set in the menuitem is used as a stock id to select the stock item for the item.
TRUE if the label set in the menuitem is used as a
stock id to select the stock item for the item
Since: 2.16
void gtk_image_menu_item_set_use_stock (GtkImageMenuItem *image_menu_item,gboolean use_stock);
If TRUE, the label set in the menuitem is used as a
stock id to select the stock item for the item.
Since: 2.16
gboolean
gtk_image_menu_item_get_always_show_image
(GtkImageMenuItem *image_menu_item);
Returns whether the menu item will ignore the “gtk-menu-images” setting and always show the image, if available.
Since: 2.16
void gtk_image_menu_item_set_always_show_image (GtkImageMenuItem *image_menu_item,gboolean always_show);
If TRUE, the menu item will ignore the “gtk-menu-images”
setting and always show the image, if available.
Use this property if the menuitem would be useless or hard to use without the image.
Since: 2.16
void gtk_image_menu_item_set_accel_group (GtkImageMenuItem *image_menu_item,GtkAccelGroup *accel_group);
Specifies an accel_group
to add the menu items accelerator to
(this only applies to stock items so a stock item must already
be set, make sure to call gtk_image_menu_item_set_use_stock()
and gtk_menu_item_set_label() with a valid stock item first).
If you want this menu item to have changeable accelerators then
you shouldnt need this (see gtk_image_menu_item_new_from_stock()).
Since: 2.16
“accel-group” property“accel-group” GtkAccelGroup *
The Accel Group to use for stock accelerator keys
Flags: Write
Since: 2.16
“always-show-image” property “always-show-image” gboolean
If TRUE, the menu item will ignore the “gtk-menu-images”
setting and always show the image, if available.
Use this property if the menuitem would be useless or hard to use without the image.
Flags: Read / Write / Construct
Default value: FALSE
Since: 2.16
“image” property“image” GtkWidget *
Child widget to appear next to the menu text.
Flags: Read / Write
“use-stock” property “use-stock” gboolean
If TRUE, the label set in the menuitem is used as a
stock id to select the stock item for the item.
Flags: Read / Write / Construct
Default value: FALSE
Since: 2.16