[Contents] [Back] [Prev] [Up] [Next] [Forward]

# Package Gtk.Check`_`Menu`_`Item

A Gtk_Check_Menu_Item is a menu item that maintains the state of a boolean value in addition to a Gtk_Menu_Item's 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. Activating the Gtk_Menu_Item toggles the value.

- Gtk.Check_Menu_Item Widget Hierarchy
- Gtk.Check_Menu_Item Signals
- Gtk.Check_Menu_Item Subprograms

## Widget Hierarchy

    Gtk_Object                    (see section Package Gtk.Object)
       \___ Gtk_Widget            (see section Package Gtk.Widget)
          \___ Gtk_Container      (see section Package Gtk.Container)
             \___ Gtk_Bin         (see section Package Gtk.Bin)
                \___ Gtk_Item     (see section Package Gtk.Item)
                   \___ Gtk_Menu_Item (see section Package Gtk.Menu_Item)
                      \___ Gtk_Check_Menu_Item (see section Package Gtk.Check_Menu_Item)

## Signals

- "toggled" procedure Handler
  (Check_Menu_Item : access Gtk_Check_Menu_Item_Record'Class);
  Emitted when the state of the check box is changed. A signal handler can call Get_Active to discover the new state.

## Subprograms

    procedure Gtk_New
      (Check_Menu_Item    : out    Gtk_Check_Menu_Item;
       Label              : in     String := "");

| Create a new Gtk_Check_Menu_Item with a label, if label isn't null.

    function Get_Type              return Gtk.Gtk_Type;

| Return the internal value associated with a Gtk_Calendar.

    procedure Set_Show_Toggle
      (Check_Menu_Item    : access Gtk_Check_Menu_Item_Record;
       Always             : in     Boolean);

| Control whether the check box is shown at all times. Normally the check box is shown only when it is active or while the menu item is selected.

    procedure Set_Always_Show_Toggle
      (Check_Menu_Item    : access Gtk_Check_Menu_Item_Record;
       Always             : in     Boolean);

| Same as Set_Show_Toggle. Provided to simplify automated tools, such as Gate.

    procedure Set_Active
      (Check_Menu_Item    : access Gtk_Check_Menu_Item_Record;
       Is_Active          : in     Boolean);

| Set the active state of the menu item's check box.

    procedure Toggled
      (Check_Menu_Item    : access Gtk_Check_Menu_Item_Record);

| Emit the "toggled" signal.

    function Get_Active
      (Check_Menu_Item    : access Gtk_Check_Menu_Item_Record)
       return Boolean;

| Return True if the Item is active

[Contents] [Back] [Prev] [Up] [Next] [Forward]