Memory-managed wrapper type.

Type class for types which can be safely cast to MenuItem, for instance with toMenuItem.

Cast to MenuItem, for types for which this is known to be safe. For general casts, use castTo.

A convenience alias for Nothing :: Maybe MenuItem.

Emits the MenuItem::activate signal on the given item

Emits the MenuItem::deselect signal on the given item.

Retrieve the accelerator path that was previously set on menuItem.

See menuItemSetAccelPath for details.

Since: 2.14

Sets text on the menuItem label

Since: 2.16

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

Since: 3.0

Gets whether the menu item appears justified at the right side of the menu bar.

Gets the submenu underneath this menu item, if any. See menuItemSetSubmenu.

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

Since: 2.16

Creates a new MenuItem.

Creates a new MenuItem whose child is a Label.

Creates a new MenuItem containing a label.

The label will be created using labelNewWithMnemonic, so underscores in label indicate the mnemonic for the menu item.

Emits the MenuItem::select signal on the given item.

Set the accelerator path on menuItem, through which runtime changes of the menu item’s accelerator caused by the user can be identified and saved to persistent storage (see accelMapSave on this). To set up a default accelerator for this menu item, call accelMapAddEntry with the same accelPath. See also accelMapAddEntry on the specifics of accelerator paths, and menuSetAccelPath for a more convenient variant of this function.

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

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

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

Sets text on the menuItem label

Since: 2.16

Sets whether the menuItem 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

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

Sets or replaces the menu item’s submenu, or removes it when a Nothing submenu is passed.

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

Since: 2.16

Emits the MenuItem::toggle-size-allocate signal on the given item.

Emits the MenuItem::toggle-size-request signal on the given item.

Set the value of the “accel-path” property to Nothing. When overloading is enabled, this is equivalent to

clear #accelPath

Construct a GValueConstruct with valid value for the “accel-path” property. This is rarely needed directly, but it is used by new.

Get the value of the “accel-path” property. When overloading is enabled, this is equivalent to

get menuItem #accelPath

Set the value of the “accel-path” property. When overloading is enabled, this is equivalent to

set menuItem [ #accelPath := value ]

Construct a GValueConstruct with valid value for the “label” property. This is rarely needed directly, but it is used by new.

Get the value of the “label” property. When overloading is enabled, this is equivalent to

get menuItem #label

Set the value of the “label” property. When overloading is enabled, this is equivalent to

set menuItem [ #label := value ]

Construct a GValueConstruct with valid value for the “right-justified” property. This is rarely needed directly, but it is used by new.

Get the value of the “right-justified” property. When overloading is enabled, this is equivalent to

get menuItem #rightJustified

Set the value of the “right-justified” property. When overloading is enabled, this is equivalent to

set menuItem [ #rightJustified := value ]

Set the value of the “submenu” property to Nothing. When overloading is enabled, this is equivalent to

clear #submenu

Construct a GValueConstruct with valid value for the “submenu” property. This is rarely needed directly, but it is used by new.

Get the value of the “submenu” property. When overloading is enabled, this is equivalent to

get menuItem #submenu

Set the value of the “submenu” property. When overloading is enabled, this is equivalent to

set menuItem [ #submenu := value ]

Construct a GValueConstruct with valid value for the “use-underline” property. This is rarely needed directly, but it is used by new.

Get the value of the “use-underline” property. When overloading is enabled, this is equivalent to

get menuItem #useUnderline

Set the value of the “use-underline” property. When overloading is enabled, this is equivalent to

set menuItem [ #useUnderline := value ]

Type for the callback on the (unwrapped) C side.

Emitted when the item is activated.

Connect a signal handler for the “activate” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after menuItem #activate callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_MenuItemActivateCallback.

A convenience synonym for Nothing :: Maybe MenuItemActivateCallback.

Connect a signal handler for the “activate” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on menuItem #activate callback

Wrap a MenuItemActivateCallback into a C_MenuItemActivateCallback.

Type for the callback on the (unwrapped) C side.

Emitted when the item is activated, but also if the menu item has a submenu. For normal applications, the relevant signal is MenuItem::activate.

Connect a signal handler for the “activate-item” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after menuItem #activateItem callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_MenuItemActivateItemCallback.

A convenience synonym for Nothing :: Maybe MenuItemActivateItemCallback.

Connect a signal handler for the “activate-item” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on menuItem #activateItem callback

Wrap a MenuItemActivateItemCallback into a C_MenuItemActivateItemCallback.

Type for the callback on the (unwrapped) C side.

No description available in the introspection data.

Connect a signal handler for the “deselect” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after menuItem #deselect callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_MenuItemDeselectCallback.

A convenience synonym for Nothing :: Maybe MenuItemDeselectCallback.

Connect a signal handler for the “deselect” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on menuItem #deselect callback

Wrap a MenuItemDeselectCallback into a C_MenuItemDeselectCallback.

Type for the callback on the (unwrapped) C side.

No description available in the introspection data.

Connect a signal handler for the “select” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after menuItem #select callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_MenuItemSelectCallback.

A convenience synonym for Nothing :: Maybe MenuItemSelectCallback.

Connect a signal handler for the “select” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on menuItem #select callback

Wrap a MenuItemSelectCallback into a C_MenuItemSelectCallback.

Type for the callback on the (unwrapped) C side.

No description available in the introspection data.

Connect a signal handler for the “toggle-size-allocate” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after menuItem #toggleSizeAllocate callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_MenuItemToggleSizeAllocateCallback.

A convenience synonym for Nothing :: Maybe MenuItemToggleSizeAllocateCallback.

Connect a signal handler for the “toggle-size-allocate” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on menuItem #toggleSizeAllocate callback

Wrap a MenuItemToggleSizeAllocateCallback into a C_MenuItemToggleSizeAllocateCallback.

Type for the callback on the (unwrapped) C side.

No description available in the introspection data.

Connect a signal handler for the “toggle-size-request” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after menuItem #toggleSizeRequest callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_MenuItemToggleSizeRequestCallback.

A convenience synonym for Nothing :: Maybe MenuItemToggleSizeRequestCallback.

Connect a signal handler for the “toggle-size-request” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on menuItem #toggleSizeRequest callback

Wrap a MenuItemToggleSizeRequestCallback into a C_MenuItemToggleSizeRequestCallback.