![]() |
![]() |
![]() |
GTK+ 3 Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <gtk/gtk.h> GtkImageMenuItem; void gtk_image_menu_item_set_image (GtkImageMenuItem *image_menu_item
,GtkWidget *image
); GtkWidget* gtk_image_menu_item_get_image (GtkImageMenuItem *image_menu_item
); GtkWidget* gtk_image_menu_item_new (void
); GtkWidget* gtk_image_menu_item_new_from_stock (const gchar *stock_id
,GtkAccelGroup *accel_group
); GtkWidget* gtk_image_menu_item_new_with_label (const gchar *label
); GtkWidget* gtk_image_menu_item_new_with_mnemonic (const gchar *label
); gboolean gtk_image_menu_item_get_use_stock (GtkImageMenuItem *image_menu_item
); void gtk_image_menu_item_set_use_stock (GtkImageMenuItem *image_menu_item
,gboolean use_stock
); gboolean gtk_image_menu_item_get_always_show_image (GtkImageMenuItem *image_menu_item
); void gtk_image_menu_item_set_always_show_image (GtkImageMenuItem *image_menu_item
,gboolean always_show
); void gtk_image_menu_item_set_accel_group (GtkImageMenuItem *image_menu_item
,GtkAccelGroup *accel_group
);
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.
|
a GtkImageMenuItem. |
|
a widget to set as the image for the menu item. [allow-none] |
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()
.
|
a GtkImageMenuItem |
Returns : |
the widget set as image of image_menu_item . [transfer none]
|
GtkWidget* gtk_image_menu_item_new (void
);
Creates a new GtkImageMenuItem with an empty label.
Returns : |
a new GtkImageMenuItem. |
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.
|
the name of the stock item. |
|
the GtkAccelGroup to add the menu items
accelerator to, or NULL . [allow-none]
|
Returns : |
a new GtkImageMenuItem. |
GtkWidget* gtk_image_menu_item_new_with_label (const gchar *label
);
Creates a new GtkImageMenuItem containing a label.
|
the text of the menu item. |
Returns : |
a new GtkImageMenuItem. |
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.
|
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.
|
a GtkImageMenuItem |
Returns : |
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.
|
a GtkImageMenuItem |
|
TRUE if the menuitem should use a stock 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.
|
a GtkImageMenuItem |
Returns : |
TRUE if the menu item will always show the image
|
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.
|
a GtkImageMenuItem |
|
TRUE if the menuitem should always show 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()
).
|
a GtkImageMenuItem |
|
the GtkAccelGroup |
Since 2.16