struct GtkMenuItem

struct GtkMenuItem {
  GtkBin bin;
};

gtk_menu_item_new ()

GtkWidget *         gtk_menu_item_new                   (void);

gtk_menu_item_new_with_label ()

GtkWidget *         gtk_menu_item_new_with_label        (const gchar *label);

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_label_new_with_mnemonic(), so underscores in label indicate the mnemonic for the menu item.

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_get_label ()

const gchar *       gtk_menu_item_get_label             (GtkMenuItem *menu_item);

Sets text on the menu_item label

Since 2.16

gtk_menu_item_set_label ()

void                gtk_menu_item_set_label             (GtkMenuItem *menu_item,
                                                         const gchar *label);

Sets text on the menu_item label

Since 2.16

gtk_menu_item_get_use_underline ()

gboolean            gtk_menu_item_get_use_underline     (GtkMenuItem *menu_item);

Checks if an underline in the text indicates the next character should be used for the mnemonic accelerator key.

Since 2.16

gtk_menu_item_set_use_underline ()

void                gtk_menu_item_set_use_underline     (GtkMenuItem *menu_item,
                                                         gboolean setting);

If true, an underline in the text indicates the next character should be used for the mnemonic accelerator key.

Since 2.16

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 NULL submenu is passed.

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_submenu().

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 menu_item, through which runtime changes of the menu item's accelerator caused by the user can be identified and saved to persistent storage (see gtk_accel_map_save() on this). To set up a default accelerator for this menu item, call gtk_accel_map_add_entry() with the same accel_path. See also gtk_accel_map_add_entry() on the specifics of accelerator paths, and gtk_menu_set_accel_path() for a more convenient variant of this function.

This function is basically a convenience wrapper that handles calling gtk_widget_set_accel_path() with the appropriate accelerator group for the menu item.

Note that you do need to set an accelerator on the parent menu with gtk_menu_set_accel_group() for this to work.

Note that accel_path string will be stored in a GQuark. Therefore, if you pass a static string, you can save some memory by interning it first with g_intern_static_string().

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 menu_item.

See gtk_menu_item_set_accel_path() for details.

Since 2.14

gtk_menu_item_select ()

void                gtk_menu_item_select                (GtkMenuItem *menu_item);

gtk_menu_item_deselect ()

void                gtk_menu_item_deselect              (GtkMenuItem *menu_item);

gtk_menu_item_activate ()

void                gtk_menu_item_activate              (GtkMenuItem *menu_item);

gtk_menu_item_toggle_size_request ()

void                gtk_menu_item_toggle_size_request   (GtkMenuItem *menu_item,
                                                         gint *requisition);

gtk_menu_item_toggle_size_allocate ()

void                gtk_menu_item_toggle_size_allocate  (GtkMenuItem *menu_item,
                                                         gint allocation);

gtk_menu_item_get_reserve_indicator ()

gboolean            gtk_menu_item_get_reserve_indicator (GtkMenuItem *menu_item);

Returns whether the menu_item reserves space for the submenu indicator, regardless if it has a submenu or not.

Since 3.0

gtk_menu_item_set_reserve_indicator ()

void                gtk_menu_item_set_reserve_indicator (GtkMenuItem *menu_item,
                                                         gboolean reserve);

Sets whether the menu_item should reserve space for the submenu indicator, regardless if it actually has a submenu or not.

There should be little need for applications to call this functions.

Since 3.0