Index

Package: Menu_Item

Description

package Gtk.Menu_Item is

This widget represents one of the lines in a menu, on which the user can click to execute an action. The menu items can be bound to a submenu, so that clicking on them will in fact display the submenu on the screen.

They can also be associated with key shortcuts (called accelerators). See the subprogram Set_Accel_Path, and the subprograms in the package Gtk.Accel_Map.

Activating the proper options in the theme files will allow the user to interactively modify the shortcuts.

Binding from C File version 2.16.6

Classes

Gtk_Menu_Item_Record

type Gtk_Menu_Item_Record is new Item.Gtk_Item_Record with private;

Ancestors:

Immediate Children:

Primitive operations:

Get_Accel_Path
Get_Right_Justified
Get_Use_Underline
Glib.Object.Deallocate (Inherited)
Glib.Object.Get_Type (Inherited)
Glib.Object.Notify (Inherited)
Glib.Object.Ref (Inherited)
Glib.Object.Ref_Sink (Inherited)
Glib.Object.Unref (Inherited)
Gtk.Bin.Get_Child (Inherited)
Gtk.Container.Add (Inherited)
Gtk.Container.Check_Resize (Inherited)
Gtk.Container.Child_Get_Property (Inherited)
Gtk.Container.Child_Set_Property (Inherited)
Gtk.Container.Child_Type (Inherited)
Gtk.Container.Forall (Inherited)
Gtk.Container.Foreach (Inherited)
Gtk.Container.Get_Border_Width (Inherited)
Gtk.Container.Get_Children (Inherited)
Gtk.Container.Get_Focus_Chain (Inherited)
Gtk.Container.Get_Focus_Child (Inherited)
Gtk.Container.Get_Focus_Hadjustment (Inherited)
Gtk.Container.Get_Focus_Vadjustment (Inherited)
Gtk.Container.Get_Resize_Mode (Inherited)
Gtk.Container.Propagate_Expose (Inherited)
Gtk.Container.Remove (Inherited)
Gtk.Container.Resize_Children (Inherited)
Gtk.Container.Set_Border_Width (Inherited)
Gtk.Container.Set_Focus_Chain (Inherited)
Gtk.Container.Set_Focus_Child (Inherited)
Gtk.Container.Set_Focus_Hadjustment (Inherited)
Gtk.Container.Set_Focus_Vadjustment (Inherited)
Gtk.Container.Set_Reallocate_Redraws (Inherited)
Gtk.Container.Set_Resize_Mode (Inherited)
Gtk.Container.Unset_Focus_Chain (Inherited)
Gtk.Item.Item_Deselect (Inherited)
Gtk.Item.Item_Select (Inherited)
Gtk.Item.Toggle (Inherited)
Gtk.Widget.Add_Accelerator (Inherited)
Gtk.Widget.Add_Events (Inherited)
Gtk.Widget.Add_Mnemonic_Label (Inherited)
Gtk.Widget.Can_Activate_Accel (Inherited)
Gtk.Widget.Child_Notify (Inherited)
Gtk.Widget.Class_Path (Inherited)
Gtk.Widget.Class_Path_Reversed (Inherited)
Gtk.Widget.Create_Pango_Context (Inherited)
Gtk.Widget.Create_Pango_Layout (Inherited)
Gtk.Widget.Destroy (Inherited)
Gtk.Widget.Draw (Inherited)
Gtk.Widget.Ensure_Style (Inherited)
Gtk.Widget.Error_Bell (Inherited)
Gtk.Widget.Flag_Is_Set (Inherited)
Gtk.Widget.Flags (Inherited)
Gtk.Widget.Freeze_Child_Notify (Inherited)
Gtk.Widget.Get_Allocation_Height (Inherited)
Gtk.Widget.Get_Allocation_Width (Inherited)
Gtk.Widget.Get_Allocation_X (Inherited)
Gtk.Widget.Get_Allocation_Y (Inherited)
Gtk.Widget.Get_Ancestor (Inherited)
Gtk.Widget.Get_Child_Requisition (Inherited)
Gtk.Widget.Get_Child_Visible (Inherited)
Gtk.Widget.Get_Colormap (Inherited)
Gtk.Widget.Get_Composite_Name (Inherited)
Gtk.Widget.Get_Direction (Inherited)
Gtk.Widget.Get_Events (Inherited)
Gtk.Widget.Get_Extension_Events (Inherited)
Gtk.Widget.Get_Has_Tooltip (Inherited)
Gtk.Widget.Get_Name (Inherited)
Gtk.Widget.Get_No_Show_All (Inherited)
Gtk.Widget.Get_Pango_Context (Inherited)
Gtk.Widget.Get_Parent (Inherited)
Gtk.Widget.Get_Parent_Window (Inherited)
Gtk.Widget.Get_Pointer (Inherited)
Gtk.Widget.Get_Root_Window (Inherited)
Gtk.Widget.Get_Size_Request (Inherited)
Gtk.Widget.Get_Snapshot (Inherited)
Gtk.Widget.Get_State (Inherited)
Gtk.Widget.Get_Style (Inherited)
Gtk.Widget.Get_Tooltip_Markup (Inherited)
Gtk.Widget.Get_Tooltip_Text (Inherited)
Gtk.Widget.Get_Tooltip_Window (Inherited)
Gtk.Widget.Get_Toplevel (Inherited)
Gtk.Widget.Get_Visual (Inherited)
Gtk.Widget.Get_Window (Inherited)
Gtk.Widget.Grab_Default (Inherited)
Gtk.Widget.Grab_Focus (Inherited)
Gtk.Widget.Has_Screen (Inherited)
Gtk.Widget.Hide (Inherited)
Gtk.Widget.Hide_All (Inherited)
Gtk.Widget.Input_Shape_Combine_Mask (Inherited)
Gtk.Widget.Intersect (Inherited)
Gtk.Widget.Is_Ancestor (Inherited)
Gtk.Widget.Is_Composited (Inherited)
Gtk.Widget.Is_Focus (Inherited)
Gtk.Widget.Keynav_Failed (Inherited)
Gtk.Widget.List_Mnemonic_Labels (Inherited)
Gtk.Widget.Map (Inherited)
Gtk.Widget.Mnemonic_Activate (Inherited)
Gtk.Widget.Modify_Base (Inherited)
Gtk.Widget.Modify_Bg (Inherited)
Gtk.Widget.Modify_Cursor (Inherited)
Gtk.Widget.Modify_Fg (Inherited)
Gtk.Widget.Modify_Font (Inherited)
Gtk.Widget.Modify_Text (Inherited)
Gtk.Widget.Path (Inherited)
Gtk.Widget.Path_Reversed (Inherited)
Gtk.Widget.Queue_Clear (Inherited)
Gtk.Widget.Queue_Clear_Area (Inherited)
Gtk.Widget.Queue_Draw (Inherited)
Gtk.Widget.Queue_Draw_Area (Inherited)
Gtk.Widget.Queue_Resize (Inherited)
Gtk.Widget.Queue_Resize_No_Redraw (Inherited)
Gtk.Widget.Realize (Inherited)
Gtk.Widget.Region_Intersect (Inherited)
Gtk.Widget.Remove_Accelerator (Inherited)
Gtk.Widget.Remove_Mnemonic_Label (Inherited)
Gtk.Widget.Render_Icon (Inherited)
Gtk.Widget.Reparent (Inherited)
Gtk.Widget.Reset_Rc_Styles (Inherited)
Gtk.Widget.Reset_Shapes (Inherited)
Gtk.Widget.Restore_Default_Style (Inherited)
Gtk.Widget.Send_Expose (Inherited)
Gtk.Widget.Set_Accel_Path (Inherited)
Gtk.Widget.Set_App_Paintable (Inherited)
Gtk.Widget.Set_Child_Visible (Inherited)
Gtk.Widget.Set_Colormap (Inherited)
Gtk.Widget.Set_Composite_Name (Inherited)
Gtk.Widget.Set_Direction (Inherited)
Gtk.Widget.Set_Double_Buffered (Inherited)
Gtk.Widget.Set_Events (Inherited)
Gtk.Widget.Set_Extension_Events (Inherited)
Gtk.Widget.Set_Flags (Inherited)
Gtk.Widget.Set_Has_Tooltip (Inherited)
Gtk.Widget.Set_Name (Inherited)
Gtk.Widget.Set_No_Show_All (Inherited)
Gtk.Widget.Set_Parent (Inherited)
Gtk.Widget.Set_Parent_Window (Inherited)
Gtk.Widget.Set_Redraw_On_Allocate (Inherited)
Gtk.Widget.Set_Scroll_Adjustments (Inherited)
Gtk.Widget.Set_Sensitive (Inherited)
Gtk.Widget.Set_Size_Request (Inherited)
Gtk.Widget.Set_State (Inherited)
Gtk.Widget.Set_Style (Inherited)
Gtk.Widget.Set_Tooltip_Markup (Inherited)
Gtk.Widget.Set_Tooltip_Text (Inherited)
Gtk.Widget.Set_Tooltip_Window (Inherited)
Gtk.Widget.Set_UPosition (Inherited)
Gtk.Widget.Set_USize (Inherited)
Gtk.Widget.Set_Window (Inherited)
Gtk.Widget.Shape_Combine_Mask (Inherited)
Gtk.Widget.Show (Inherited)
Gtk.Widget.Show_All (Inherited)
Gtk.Widget.Show_Now (Inherited)
Gtk.Widget.Size_Allocate (Inherited)
Gtk.Widget.Size_Request (Inherited)
Gtk.Widget.Style_Get_Property (Inherited)
Gtk.Widget.Thaw_Child_Notify (Inherited)
Gtk.Widget.Trigger_Tooltip_Query (Inherited)
Gtk.Widget.Unmap (Inherited)
Gtk.Widget.Unrealize (Inherited)
Gtk.Widget.Unset_Flags (Inherited)
Remove_Submenu
Right_Justify
Set_Accel_Path
Set_Right_Justified
Set_Use_Underline
Toggle_Size_Allocate
Toggle_Size_Request

Types

Gtk_Menu_Item

type Gtk_Menu_Item is access all Gtk_Menu_Item_Record'Class;

Constants & Global variables

Null_Submenu (Gtk.Widget.Gtk_Widget)

Null_Submenu : constant Widget.Gtk_Widget;

Signal_Activate (Glib.Signal_Name)

Signal_Activate             : constant Glib.Signal_Name :=
                                   "activate";

Signal_Activate_Item (Glib.Signal_Name)

Signal_Activate_Item        : constant Glib.Signal_Name :=
                                   "activate_item";

Signal_Toggle_Size_Allocate (Glib.Signal_Name)

Signal_Toggle_Size_Allocate : constant Glib.Signal_Name :=
                                   "toggle_size_allocate";

Signal_Toggle_Size_Request (Glib.Signal_Name)

Signal_Toggle_Size_Request  : constant Glib.Signal_Name :=
                                   "toggle_size_request";

Right_Justified_Property (Glib.Properties.Property_Boolean)

Right_Justified_Property : constant Glib.Properties.Property_Boolean;

Use_Underline_Property (Glib.Properties.Property_Boolean)

Use_Underline_Property   : constant Glib.Properties.Property_Boolean;

Arrow_Scaling_Property (Glib.Properties.Property_Float)

Arrow_Scaling_Property : constant Glib.Properties.Property_Float;

Width_Chars_Property (Glib.Properties.Property_Int)

Width_Chars_Property   : constant Glib.Properties.Property_Int;

Subprograms & Entries

Gtk_New

procedure Gtk_New 
(Menu_Item: out Gtk_Menu_Item;
Label: UTF8_String := "");

Initialize

procedure Initialize 
(Menu_Item: access Gtk_Menu_Item_Record'Class;
Label: UTF8_String);
Creates or initializes a new menu item containing a simple label.

Gtk_New_With_Mnemonic

procedure Gtk_New_With_Mnemonic 
(Menu_Item: out Gtk_Menu_Item;
Label: UTF8_String);

Initialize_With_Mnemonic

procedure Initialize_With_Mnemonic 
(Menu_Item: access Gtk_Menu_Item_Record'Class;
Label: UTF8_String);
Creates or initializes a new Gtk_Menu_Item containing a label. The label is created using Gtk.Label.Gtk_New_With_Mnemonic, so underscores in Label indicate the mnemonic for the menu item. Warning: with some versions of gtk+, the menu_item will not be properly destroyed when you remove it from its parent menu, if you created it with a non-empty Label. In this case, you first need to destroy the child of the Menu_Item, and then remove it from its parent menu.

Get_Type

function Get_Type return Gtk.Gtk_Type;
Return the internal value associated with a Gtk_Menu_Item.

Set_Submenu

procedure Set_Submenu 
(Menu_Item: access Gtk_Menu_Item_Record;
Submenu: access Widget.Gtk_Widget_Record'Class);

Get_Submenu

function Get_Submenu 
(Menu_Item: access Gtk_Menu_Item_Record) return Gtk.Widget.Gtk_Widget;
Set or Get the submenu underneath Menu_Item.

Set_Label

procedure Set_Label 
(Menu_Item: access Gtk_Menu_Item_Record;
Label: String);

Get_Label

function Get_Label 
(Menu_Item: access Gtk_Menu_Item_Record) return String;
Controls the text in Menu_Item's label.

Set_Right_Justified

procedure Set_Right_Justified 
(Menu_Item: access Gtk_Menu_Item_Record;
Justify: Boolean := True);

Get_Right_Justified

function Get_Right_Justified 
(Menu_Item: access Gtk_Menu_Item_Record) return Boolean;
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.)

Set_Use_Underline

procedure Set_Use_Underline 
(Menu_Item: access Gtk_Menu_Item_Record;
Setting: Boolean);

Get_Use_Underline

function Get_Use_Underline 
(Menu_Item: access Gtk_Menu_Item_Record) return Boolean;
If true, an underline in the text indicates the next character should be used for the mnemonic accelerator key.

Set_Accel_Path

procedure Set_Accel_Path 
(Menu_Item: access Gtk_Menu_Item_Record;
Accel_Path: UTF8_String);

Get_Accel_Path

function Get_Accel_Path 
(Menu_Item: access Gtk_Menu_Item_Record) return String;
Set the path that will be used to reference the widget in calls to the subprograms in Gtk.Accel_Map. This means, for instance, that the widget is fully setup for interactive modification of the shortcuts by the user, should he choose to activate this possibility in his themes (see gtk-accel_map.ads for more information).

Remove_Submenu

procedure Remove_Submenu 
(Menu_Item: access Gtk_Menu_Item_Record);
Remove_Submenu Remove the menu_item's submenu Deprecated: 2.12: Remove_Submenu deprecated and should not be used in newly written code. Use Set_Submenu instead.

Set_Right_Justify

procedure Set_Right_Justify 
(Menu_Item: access Gtk_Menu_Item_Record;
Justify: Boolean) renames Set_Right_Justified;
pragma Obsolescent; This procedure is needed by Gate to automate the code generation.

Right_Justify

procedure Right_Justify 
(Menu_Item: access Gtk_Menu_Item_Record);

Gtk_Select

procedure Gtk_Select 
(Menu_Item: access Gtk_Menu_Item_Record);
Emits the "select" signal on Menu_Item

Deselect

procedure Deselect 
(Menu_Item: access Gtk_Menu_Item_Record);
Emits the "deselect" signal on Menu_Item

Activate

procedure Activate 
(Menu_Item: access Gtk_Menu_Item_Record);
Emits the "activate" signal on Menu_Item

Toggle_Size_Allocate

procedure Toggle_Size_Allocate 
(Menu_Item: access Gtk_Menu_Item_Record;
Allocation: Gtk.Widget.Gtk_Allocation);
Emits the "toggle_size_allocate" signal on Menu_Item

Toggle_Size_Request

procedure Toggle_Size_Request 
(Menu_Item: access Gtk_Menu_Item_Record;
Requisition: out Gtk.Widget.Gtk_Requisition);
Emits the "toggle_size_request" signal on Menu_Item