A Gtk.Check_Menu_Item.Gtk_Check_Menu_Item is a menu item that maintains the state of a boolean value in addition to a Gtk.Menu_Item.Gtk_Menu_Item usual role in activating application code.
A check box indicating the state of the boolean value is displayed at the left side of the Gtk.Menu_Item.Gtk_Menu_Item. Activating the Gtk.Menu_Item.Gtk_Menu_Item toggles the value.
# CSS nodes
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.
function "+"
(Widget : access Gtk_Check_Menu_Item_Record'Class)
return Gtk.Actionable.Gtk_Actionable
function "+"
(Widget : access Gtk_Check_Menu_Item_Record'Class)
return Gtk.Activatable.Gtk_Activatable
function "+"
(Widget : access Gtk_Check_Menu_Item_Record'Class)
return Gtk.Buildable.Gtk_Buildable
function "-"
(Interf : Gtk.Actionable.Gtk_Actionable)
return Gtk_Check_Menu_Item
function "-"
(Interf : Gtk.Activatable.Gtk_Activatable)
return Gtk_Check_Menu_Item
function "-"
(Interf : Gtk.Buildable.Gtk_Buildable)
return Gtk_Check_Menu_Item
Active_Property : constant Glib.Properties.Property_Boolean;
type Cb_GObject_Void is not null access procedure
(Self : access Glib.Object.GObject_Record'Class);
type Cb_Gtk_Check_Menu_Item_Void is not null access procedure
(Self : access Gtk_Check_Menu_Item_Record'Class);
procedure Do_Set_Related_Action
(Self : not null access Gtk_Check_Menu_Item_Record;
Action : not null access Gtk.Action.Gtk_Action_Record'Class)
Draw_As_Radio_Property : constant Glib.Properties.Property_Boolean;
function Get_Action_Name
(Self : not null access Gtk_Check_Menu_Item_Record) return UTF8_String
function Get_Action_Target_Value
(Self : not null access Gtk_Check_Menu_Item_Record)
return Glib.Variant.Gvariant
function Get_Active
(Check_Menu_Item : not null access Gtk_Check_Menu_Item_Record)
return Boolean
Returns whether the check menu item is active. See gtk_check_menu_item_set_active ().
True if the menu item is checked.
function Get_Draw_As_Radio
(Check_Menu_Item : not null access Gtk_Check_Menu_Item_Record)
return Boolean
Returns whether Check_Menu_Item looks like a Gtk.Radio_Menu_Item.Gtk_Radio_Menu_Item Since: gtk+ 2.4
Whether Check_Menu_Item looks like a Gtk.Radio_Menu_Item.Gtk_Radio_Menu_Item
function Get_Inconsistent
(Check_Menu_Item : not null access Gtk_Check_Menu_Item_Record)
return Boolean
Retrieves the value set by Gtk.Check_Menu_Item.Set_Inconsistent.
True if inconsistent
function Get_Related_Action
(Self : not null access Gtk_Check_Menu_Item_Record)
return Gtk.Action.Gtk_Action
function Get_Type return Glib.GType
function Get_Use_Action_Appearance
(Self : not null access Gtk_Check_Menu_Item_Record) return Boolean
type Gtk_Check_Menu_Item is access all Gtk_Check_Menu_Item_Record'Class;
function Gtk_Check_Menu_Item_New_With_Label
(Label : UTF8_String := "") return Gtk_Check_Menu_Item
Creates a new Gtk.Check_Menu_Item.Gtk_Check_Menu_Item with a label.
the string to use for the label.
function Gtk_Check_Menu_Item_New_With_Mnemonic
(Label : UTF8_String) return Gtk_Check_Menu_Item
Creates a new Gtk.Check_Menu_Item.Gtk_Check_Menu_Item containing a label. The label will be created using Gtk.Label.Gtk_New_With_Mnemonic, so underscores in Label indicate the mnemonic for the menu item.
The text of the button, with an underscore in front of the character
type Gtk_Check_Menu_Item_Record is new Gtk_Menu_Item_Record with null record;
procedure Gtk_New
(Check_Menu_Item : out Gtk_Check_Menu_Item;
Label : UTF8_String := "")
Creates a new Gtk.Check_Menu_Item.Gtk_Check_Menu_Item with a label. Initialize does nothing if the object was already created with another call to Initialize* or G_New.
the string to use for the label.
procedure Gtk_New_With_Mnemonic
(Check_Menu_Item : out Gtk_Check_Menu_Item;
Label : UTF8_String)
Creates a new Gtk.Check_Menu_Item.Gtk_Check_Menu_Item containing a label. The label will be created using Gtk.Label.Gtk_New_With_Mnemonic, so underscores in Label indicate the mnemonic for the menu item. Initialize_With_Mnemonic does nothing if the object was already created with another call to Initialize* or G_New.
The text of the button, with an underscore in front of the character
package Implements_Gtk_Actionable is new Glib.Types.Implements
(Gtk.Actionable.Gtk_Actionable, Gtk_Check_Menu_Item_Record, Gtk_Check_Menu_Item);
package Implements_Gtk_Activatable is new Glib.Types.Implements
(Gtk.Activatable.Gtk_Activatable, Gtk_Check_Menu_Item_Record, Gtk_Check_Menu_Item);
package Implements_Gtk_Buildable is new Glib.Types.Implements
(Gtk.Buildable.Gtk_Buildable, Gtk_Check_Menu_Item_Record, Gtk_Check_Menu_Item);
Inconsistent_Property : constant Glib.Properties.Property_Boolean;
procedure Initialize
(Check_Menu_Item : not null access Gtk_Check_Menu_Item_Record'Class;
Label : UTF8_String := "")
Creates a new Gtk.Check_Menu_Item.Gtk_Check_Menu_Item with a label. Initialize does nothing if the object was already created with another call to Initialize* or G_New.
the string to use for the label.
procedure Initialize_With_Mnemonic
(Check_Menu_Item : not null access Gtk_Check_Menu_Item_Record'Class;
Label : UTF8_String)
Creates a new Gtk.Check_Menu_Item.Gtk_Check_Menu_Item containing a label. The label will be created using Gtk.Label.Gtk_New_With_Mnemonic, so underscores in Label indicate the mnemonic for the menu item. Initialize_With_Mnemonic does nothing if the object was already created with another call to Initialize* or G_New.
The text of the button, with an underscore in front of the character
procedure On_Toggled
(Self : not null access Gtk_Check_Menu_Item_Record;
Call : Cb_GObject_Void;
Slot : not null access Glib.Object.GObject_Record'Class;
After : Boolean := False)
This signal is emitted when the state of the check box is changed.
A signal handler can use Gtk.Check_Menu_Item.Get_Active to discover the new state.
procedure On_Toggled
(Self : not null access Gtk_Check_Menu_Item_Record;
Call : Cb_Gtk_Check_Menu_Item_Void;
After : Boolean := False)
This signal is emitted when the state of the check box is changed.
A signal handler can use Gtk.Check_Menu_Item.Get_Active to discover the new state.
procedure Set_Action_Name
(Self : not null access Gtk_Check_Menu_Item_Record;
Action_Name : UTF8_String := "")
procedure Set_Action_Target_Value
(Self : not null access Gtk_Check_Menu_Item_Record;
Target_Value : Glib.Variant.Gvariant)
procedure Set_Active
(Check_Menu_Item : not null access Gtk_Check_Menu_Item_Record;
Is_Active : Boolean)
Sets the active state of the menu item's check box.
boolean value indicating whether the check box is active.
procedure Set_Detailed_Action_Name
(Self : not null access Gtk_Check_Menu_Item_Record;
Detailed_Action_Name : UTF8_String)
procedure Set_Draw_As_Radio
(Check_Menu_Item : not null access Gtk_Check_Menu_Item_Record;
Draw_As_Radio : Boolean)
Sets whether Check_Menu_Item is drawn like a Gtk.Radio_Menu_Item.Gtk_Radio_Menu_Item Since: gtk+ 2.4
whether Check_Menu_Item is drawn like a Gtk.Radio_Menu_Item.Gtk_Radio_Menu_Item
procedure Set_Inconsistent
(Check_Menu_Item : not null access Gtk_Check_Menu_Item_Record;
Setting : Boolean)
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.
True to display an "inconsistent" third state check
procedure Set_Related_Action
(Self : not null access Gtk_Check_Menu_Item_Record;
Action : not null access Gtk.Action.Gtk_Action_Record'Class)
procedure Set_Use_Action_Appearance
(Self : not null access Gtk_Check_Menu_Item_Record;
Use_Appearance : Boolean)
Signal_Toggled : constant Glib.Signal_Name := "toggled";
This signal is emitted when the state of the check box is changed.
A signal handler can use Gtk.Check_Menu_Item.Get_Active to discover the new state.
procedure Sync_Action_Properties
(Self : not null access Gtk_Check_Menu_Item_Record;
Action : access Gtk.Action.Gtk_Action_Record'Class)
procedure Toggled
(Check_Menu_Item : not null access Gtk_Check_Menu_Item_Record)
Emits the Gtk.Check_Menu_Item.Gtk_Check_Menu_Item::toggled signal.