Synopsis#include <gtk/gtk.h> GtkMenuItem; GtkWidget* gtk_menu_item_new (void); GtkWidget* gtk_menu_item_new_with_label (const gchar *label); GtkWidget* gtk_menu_item_new_with_mnemonic (const gchar *label); void gtk_menu_item_set_right_justified (GtkMenuItem *menu_item, gboolean right_justified); gboolean gtk_menu_item_get_right_justified (GtkMenuItem *menu_item); void gtk_menu_item_set_submenu (GtkMenuItem *menu_item, GtkWidget *submenu); GtkWidget* gtk_menu_item_get_submenu (GtkMenuItem *menu_item); void gtk_menu_item_set_accel_path (GtkMenuItem *menu_item, const gchar *accel_path); const gchar* gtk_menu_item_get_accel_path (GtkMenuItem *menu_item); void gtk_menu_item_remove_submenu (GtkMenuItem *menu_item); void gtk_menu_item_select (GtkMenuItem *menu_item); void gtk_menu_item_deselect (GtkMenuItem *menu_item); void gtk_menu_item_activate (GtkMenuItem *menu_item); void gtk_menu_item_toggle_size_request (GtkMenuItem *menu_item, gint *requisition); void gtk_menu_item_toggle_size_allocate (GtkMenuItem *menu_item, gint allocation); #define gtk_menu_item_right_justify (menu_item) Object HierarchyGObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkItem +----GtkMenuItem +----GtkCheckMenuItem +----GtkImageMenuItem +----GtkSeparatorMenuItem +----GtkTearoffMenuItem Properties"accel-path" gchar* : Read / Write "right-justified" gboolean : Read / Write "submenu" GtkMenu* : Read / Write Style Properties"arrow-scaling" gfloat : Read "arrow-spacing" gint : Read "horizontal-padding" gint : Read "selected-shadow-type" GtkShadowType : Read "toggle-spacing" gint : Read "width-chars" gint : Read Signals"activate" : Run First / Action "activate-item" : Run First "toggle-size-allocate" : Run First "toggle-size-request" : Run First DescriptionThe GtkMenuItem widget and the derived widgets are the only valid childs for menus. Their function is to correctly handle highlighting, alignment, events and submenus. As it derives from GtkBin it can hold any valid child widget, altough only a few are really useful. Detailsgtk_menu_item_new ()GtkWidget* gtk_menu_item_new (void); Creates a new GtkMenuItem.
gtk_menu_item_new_with_label ()GtkWidget* gtk_menu_item_new_with_label (const gchar *label); Creates a new GtkMenuItem whose child is a GtkLabel.
gtk_menu_item_new_with_mnemonic ()GtkWidget* gtk_menu_item_new_with_mnemonic (const gchar *label);
Creates a new GtkMenuItem containing a label. The label
will be created using
gtk_menu_item_set_right_justified ()void gtk_menu_item_set_right_justified (GtkMenuItem *menu_item, gboolean right_justified); Sets whether the menu item appears justified at the right side of a menu bar. This was traditionally done for "Help" menu items, but is now considered a bad idea. (If the widget layout is reversed for a right-to-left language like Hebrew or Arabic, right-justified-menu-items appear at the left.)
gtk_menu_item_get_right_justified ()gboolean gtk_menu_item_get_right_justified (GtkMenuItem *menu_item); Gets whether the menu item appears justified at the right side of the menu bar.
gtk_menu_item_set_submenu ()void gtk_menu_item_set_submenu (GtkMenuItem *menu_item, GtkWidget *submenu);
Sets or replaces the menu item's submenu, or removes it when a
gtk_menu_item_get_submenu ()GtkWidget* gtk_menu_item_get_submenu (GtkMenuItem *menu_item);
Gets the submenu underneath this menu item, if any. See
gtk_menu_item_set_accel_path ()void gtk_menu_item_set_accel_path (GtkMenuItem *menu_item, const gchar *accel_path);
Set the accelerator path on
This function is basically a convenience wrapper that handles calling
Note that you do need to set an accelerator on the parent menu with
Note that
gtk_menu_item_get_accel_path ()const gchar* gtk_menu_item_get_accel_path (GtkMenuItem *menu_item);
Retrieve the accelerator path that was previously set on
See
Since 2.14 gtk_menu_item_remove_submenu ()void gtk_menu_item_remove_submenu (GtkMenuItem *menu_item); Warning
Removes the widget's submenu.
gtk_menu_item_select ()void gtk_menu_item_select (GtkMenuItem *menu_item); Emits the "select" signal on the given item. Behaves exactly like gtk_item_select.
gtk_menu_item_deselect ()void gtk_menu_item_deselect (GtkMenuItem *menu_item); Emits the "deselect" signal on the given item. Behaves exactly like gtk_item_deselect.
gtk_menu_item_activate ()void gtk_menu_item_activate (GtkMenuItem *menu_item); Emits the "activate" signal on the given item
gtk_menu_item_toggle_size_request ()void gtk_menu_item_toggle_size_request (GtkMenuItem *menu_item, gint *requisition); Emits the "toggle_size_request" signal on the given item.
gtk_menu_item_toggle_size_allocate ()void gtk_menu_item_toggle_size_allocate (GtkMenuItem *menu_item, gint allocation); Emits the "toggle_size_allocate" signal on the given item.
gtk_menu_item_right_justify()#define gtk_menu_item_right_justify(menu_item) gtk_menu_item_set_right_justified ((menu_item), TRUE) Warning
Sets the menu item to be right-justified. Only useful for menu bars.
Property DetailsThe
|
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"activate-item"
signalvoid user_function (GtkMenuItem *menuitem, gpointer user_data) : Run First
Emitted when the item is activated, but also if the menu item has a submenu. For normal applications, the relevant signal is "activate".
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"toggle-size-allocate"
signalvoid user_function (GtkMenuItem *menuitem, gint arg1, gpointer user_data) : Run First
|
the object which received the signal. |
|
|
|
user data set when the signal handler was connected. |
"toggle-size-request"
signalvoid user_function (GtkMenuItem *menuitem, gpointer arg1, gpointer user_data) : Run First
|
the object which received the signal. |
|
|
|
user data set when the signal handler was connected. |
for how to handle the child. |
|
is the abstract class for all sorts of items. |
|
is always the parent of GtkMenuItem. |