MenuItem

Object Hierarchy:

Description:

GtkWidget *menu_item = gtk_menu_item_new_with_label ("Example Menu Item");

GtkWidget *child = gtk_bin_get_child (GTK_BIN (menu_item));
gtk_label_set_markup (GTK_LABEL (child), "<i>new label</i> with <b>markup</b>");
gtk_accel_label_set_accel (GTK_ACCEL_LABEL (child), GDK_KEY_1, 0);

<object class="GtkMenuItem">
	<child type="submenu">
		<object class="GtkMenu"/>
	</child>
</object>

menuitem
├── <child>
╰── [arrow.right]

Content:

Properties:

• public string accel_path { get; set; }
  Sets the accelerator path of the menu item, through which runtime changes of the menu item's accelerator caused by the user can be identified and saved to persistant storage.
• public string label { get; set; }
  The text for the child label.
• public bool right_justified { get; set; }
  Sets whether the menu item appears justified at the right side of a menu bar.
• public Menu submenu { get; set; }
  The submenu attached to the menu item, or null if it has none.
• public bool use_underline { get; set; }
  true if underlines in the text indicate mnemonics.

Creation methods:

• public MenuItem ()
  Creates a new MenuItem.
• public MenuItem.with_label (string label)
  Creates a new MenuItem whose child is a Label.
• public MenuItem.with_mnemonic (string label)
  Creates a new MenuItem containing a label.

Methods:

• public unowned string? get_accel_path ()
  Retrieve the accelerator path that was previously set on this.
• public virtual unowned string get_label ()
  Sets text on the this label
• public bool get_reserve_indicator ()
  Returns whether the this reserves space for the submenu indicator, regardless if it has a submenu or not.
• public bool get_right_justified ()
  Gets whether the menu item appears justified at the right side of the menu bar.
• public unowned Widget? get_submenu ()
  Gets the submenu underneath this menu item, if any.
• public bool get_use_underline ()
  Checks if an underline in the text indicates the next character should be used for the mnemonic accelerator key.
• public void set_accel_path (string? accel_path)
  Set the accelerator path on this, through which runtime changes of the menu item’s accelerator caused by the user can be identified and saved to persistent storage ( see save on this).
• public virtual void set_label (string label)
  Sets text on the this label
• public void set_reserve_indicator (bool reserve)
  Sets whether the this should reserve space for the submenu indicator, regardless if it actually has a submenu or not.
• public void set_right_justified (bool right_justified)
  Sets whether the menu item appears justified at the right side of a menu bar.
• public void set_submenu (Menu? submenu)
  Sets or replaces the menu item’s submenu, or removes it when a null submenu is passed.
• public void set_use_underline (bool setting)
  If true, an underline in the text indicates the next character should be used for the mnemonic accelerator key.

Signals:

• public virtual signal void activate ()
  Emitted when the item is activated.
• public virtual signal void activate_item ()
  Emitted when the item is activated, but also if the menu item has a submenu.
• public virtual signal void deselect ()
  Emits the deselect signal on the given item.
• public virtual signal void select ()
  Emits the select signal on the given item.
• public virtual signal void toggle_size_allocate (int allocation)
  Emits the toggle_size_allocate signal on the given item.
• public virtual signal void toggle_size_request (void* requisition)
  Emits the toggle_size_request signal on the given item.

Inherited Members: