CheckMenuItem

A #GtkCheckMenuItem is a menu item that maintains the state of a boolean value in addition to a #GtkMenuItem usual role in activating application code.

A check box indicating the state of the boolean value is displayed at the left side of the #GtkMenuItem. Activating the #GtkMenuItem toggles the value.

CSS nodes

|[<!-- language="plain" --> menuitem ├── check.left ╰── <child> ]|

GtkCheckMenuItem has a main CSS node with name menuitem, and a subnode with name check, which gets the .left or .right style class.

Constructors

this
this(GtkCheckMenuItem* gtkCheckMenuItem, bool ownedRef)

Sets our main struct and passes it to the parent class.

this
this(string label, bool mnemonic)

Creates a new GtkCheckMenuItem with a label.

this
this()

Creates a new #GtkCheckMenuItem.

Members

Classes

OnToggledDelegateWrapper
class OnToggledDelegateWrapper
Undocumented in source.

Functions

addOnToggled
gulong addOnToggled(void delegate(CheckMenuItem) dlg, ConnectFlags connectFlags)

This signal is emitted when the state of the check box is changed.

getActive
bool getActive()

Returns whether the check menu item is active. See gtk_check_menu_item_set_active ().

getCheckMenuItemStruct
GtkCheckMenuItem* getCheckMenuItemStruct(bool transferOwnership)

Get the main Gtk struct

getDrawAsRadio
bool getDrawAsRadio()

Returns whether @check_menu_item looks like a #GtkRadioMenuItem

getInconsistent
bool getInconsistent()

Retrieves the value set by gtk_check_menu_item_set_inconsistent().

getStruct
void* getStruct()

the main Gtk struct as a void*

setActive
void setActive(bool isActive)

Sets the active state of the menu item’s check box.

setDrawAsRadio
void setDrawAsRadio(bool drawAsRadio)

Sets whether @check_menu_item is drawn like a #GtkRadioMenuItem

setInconsistent
void setInconsistent(bool setting)

If the user has selected a range of elements (such as some text or spreadsheet cells) that are affected by a boolean setting, and the current values in that range are inconsistent, you may want to display the check in an “in between” state. This function turns on “in between” display. Normally you would turn off the inconsistent state again if the user explicitly selects a setting. This has to be done manually, gtk_check_menu_item_set_inconsistent() only affects visual appearance, it doesn’t affect the semantics of the widget.

setStruct
void setStruct(GObject* obj)
Undocumented in source. Be warned that the author may not have intended to support it.
toggled
void toggled()

Emits the #GtkCheckMenuItem::toggled signal.

Static functions

callBackToggled
void callBackToggled(GtkCheckMenuItem* checkmenuitemStruct, OnToggledDelegateWrapper wrapper)
Undocumented in source. Be warned that the author may not have intended to support it.
callBackToggledDestroy
void callBackToggledDestroy(OnToggledDelegateWrapper wrapper, GClosure* closure)
Undocumented in source. Be warned that the author may not have intended to support it.
getType
GType getType()

Variables

gtkCheckMenuItem
GtkCheckMenuItem* gtkCheckMenuItem;

the main Gtk struct

onToggledListeners
OnToggledDelegateWrapper[] onToggledListeners;
Undocumented in source.

Inherited Members

From MenuItem

gtkMenuItem
GtkMenuItem* gtkMenuItem;

the main Gtk struct

getMenuItemStruct
GtkMenuItem* getMenuItemStruct(bool transferOwnership)

Get the main Gtk struct

getStruct
void* getStruct()

the main Gtk struct as a void*

setStruct
void setStruct(GObject* obj)
Undocumented in source. Be warned that the author may not have intended to support it.
__anonymous
mixin ActionableT!(GtkMenuItem)
Undocumented in source.
__anonymous
mixin ActivatableT!(GtkMenuItem)
Undocumented in source.
getActionName
string getActionName()

Gets the application set action code

getType
GType getType()
itemActivate
void itemActivate()

Emits the #GtkMenuItem::activate signal on the given item

deselect
void deselect()

Emits the #GtkMenuItem::deselect signal on the given item.

getAccelPath
string getAccelPath()

Retrieve the accelerator path that was previously set on @menu_item.

getLabel
string getLabel()

Sets @text on the @menu_item label

getReserveIndicator
bool getReserveIndicator()

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

getRightJustified
bool getRightJustified()

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

getSubmenu
Widget getSubmenu()

Gets the submenu underneath this menu item, if any. See gtk_menu_item_set_submenu().

getUseUnderline
bool getUseUnderline()

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

select
void select()

Emits the #GtkMenuItem::select signal on the given item.

setAccelPath
void setAccelPath(string accelPath)

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.

setLabel
void setLabel(string label)

Sets @text on the @menu_item label

setReserveIndicator
void setReserveIndicator(bool reserve)

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

setRightJustified
void setRightJustified(bool rightJustified)

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

setSubmenu
void setSubmenu(Menu submenu)

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

setUseUnderline
void setUseUnderline(bool setting)

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

toggleSizeAllocate
void toggleSizeAllocate(int allocation)

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

toggleSizeRequest
void toggleSizeRequest(int requisition)

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

OnActivateDelegateWrapper
class OnActivateDelegateWrapper
Undocumented in source.
onActivateListeners
OnActivateDelegateWrapper[] onActivateListeners;
Undocumented in source.
addOnActivate
gulong addOnActivate(void delegate(MenuItem) dlg, ConnectFlags connectFlags)

Emitted when the item is activated.

callBackActivate
void callBackActivate(GtkMenuItem* menuitemStruct, OnActivateDelegateWrapper wrapper)
Undocumented in source. Be warned that the author may not have intended to support it.
callBackActivateDestroy
void callBackActivateDestroy(OnActivateDelegateWrapper wrapper, GClosure* closure)
Undocumented in source. Be warned that the author may not have intended to support it.
OnActivateItemDelegateWrapper
class OnActivateItemDelegateWrapper
Undocumented in source.
onActivateItemListeners
OnActivateItemDelegateWrapper[] onActivateItemListeners;
Undocumented in source.
addOnActivateItem
gulong addOnActivateItem(void delegate(MenuItem) dlg, ConnectFlags connectFlags)

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

callBackActivateItem
void callBackActivateItem(GtkMenuItem* menuitemStruct, OnActivateItemDelegateWrapper wrapper)
Undocumented in source. Be warned that the author may not have intended to support it.
callBackActivateItemDestroy
void callBackActivateItemDestroy(OnActivateItemDelegateWrapper wrapper, GClosure* closure)
Undocumented in source. Be warned that the author may not have intended to support it.
OnDeselectDelegateWrapper
class OnDeselectDelegateWrapper
Undocumented in source.
onDeselectListeners
OnDeselectDelegateWrapper[] onDeselectListeners;
Undocumented in source.
addOnDeselect
gulong addOnDeselect(void delegate(MenuItem) dlg, ConnectFlags connectFlags)
callBackDeselect
void callBackDeselect(GtkMenuItem* menuitemStruct, OnDeselectDelegateWrapper wrapper)
Undocumented in source. Be warned that the author may not have intended to support it.
callBackDeselectDestroy
void callBackDeselectDestroy(OnDeselectDelegateWrapper wrapper, GClosure* closure)
Undocumented in source. Be warned that the author may not have intended to support it.
OnSelectDelegateWrapper
class OnSelectDelegateWrapper
Undocumented in source.
onSelectListeners
OnSelectDelegateWrapper[] onSelectListeners;
Undocumented in source.
addOnSelect
gulong addOnSelect(void delegate(MenuItem) dlg, ConnectFlags connectFlags)
callBackSelect
void callBackSelect(GtkMenuItem* menuitemStruct, OnSelectDelegateWrapper wrapper)
Undocumented in source. Be warned that the author may not have intended to support it.
callBackSelectDestroy
void callBackSelectDestroy(OnSelectDelegateWrapper wrapper, GClosure* closure)
Undocumented in source. Be warned that the author may not have intended to support it.
OnToggleSizeAllocateDelegateWrapper
class OnToggleSizeAllocateDelegateWrapper
Undocumented in source.
onToggleSizeAllocateListeners
OnToggleSizeAllocateDelegateWrapper[] onToggleSizeAllocateListeners;
Undocumented in source.
addOnToggleSizeAllocate
gulong addOnToggleSizeAllocate(void delegate(int, MenuItem) dlg, ConnectFlags connectFlags)
callBackToggleSizeAllocate
void callBackToggleSizeAllocate(GtkMenuItem* menuitemStruct, int object, OnToggleSizeAllocateDelegateWrapper wrapper)
Undocumented in source. Be warned that the author may not have intended to support it.
callBackToggleSizeAllocateDestroy
void callBackToggleSizeAllocateDestroy(OnToggleSizeAllocateDelegateWrapper wrapper, GClosure* closure)
Undocumented in source. Be warned that the author may not have intended to support it.
OnToggleSizeRequestDelegateWrapper
class OnToggleSizeRequestDelegateWrapper
Undocumented in source.
onToggleSizeRequestListeners
OnToggleSizeRequestDelegateWrapper[] onToggleSizeRequestListeners;
Undocumented in source.
addOnToggleSizeRequest
gulong addOnToggleSizeRequest(void delegate(void*, MenuItem) dlg, ConnectFlags connectFlags)
callBackToggleSizeRequest
void callBackToggleSizeRequest(GtkMenuItem* menuitemStruct, void* object, OnToggleSizeRequestDelegateWrapper wrapper)
Undocumented in source. Be warned that the author may not have intended to support it.
callBackToggleSizeRequestDestroy
void callBackToggleSizeRequestDestroy(OnToggleSizeRequestDelegateWrapper wrapper, GClosure* closure)
Undocumented in source. Be warned that the author may not have intended to support it.

Meta