Index

Package: Combo

Description

package Gtk.Combo is

The Gtk_Combo widget consists of a single-line text entry field and a drop-down list. The drop-down list is displayed when the user clicks on a small arrow button to the right of the entry field.

The drop-down list is a Gtk_List widget and can be accessed using the list member of the Gtk_Combo. List elements can contain arbitrary widgets, but if an element is not a plain label, then you must use the Gtk_List.Set_Item_String function. This sets the string which will be placed in the text entry field when the item is selected.

By default, the user can step through the items in the list using the arrow (cursor) keys, though this behaviour can be turned off with Set_Use_Arrows.

Normally the arrow keys are only active when the contents of the text entry field matches one of the items in the list. If the contents of the entry field do not match any of the list items, then pressing the arrow keys does nothing. However, by calling Set_Use_Arrows_Always you can specify that the arrow keys are always active. If the contents of the entry field does not match any of the items in the list, then pressing the up or down arrow key will set the entry field to the last or first item in the list, respectively.

Screenshot

gtk-combo.png
<see>Gtk.Combo_Box</see>

Packages

Implements_Buildable (new Glib.Types.Implements)

Implements_Orientable (new Glib.Types.Implements)

Classes

Gtk_Combo_Record

type Gtk_Combo_Record is new Gtk_Hbox_Record with null record;

Ancestors:

Primitive operations:

Disable_Activate
Get_Orientation (overriding Gtk.Box.Get_Orientation)
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.Box.Get_Child (Inherited)
Gtk.Box.Get_Homogeneous (Inherited)
Gtk.Box.Get_Spacing (Inherited)
Gtk.Box.Pack_End (Inherited)
Gtk.Box.Pack_End_Defaults (Inherited)
Gtk.Box.Pack_Start (Inherited)
Gtk.Box.Pack_Start_Defaults (Inherited)
Gtk.Box.Query_Child_Packing (Inherited)
Gtk.Box.Reorder_Child (Inherited)
Gtk.Box.Set_Child_Packing (Inherited)
Gtk.Box.Set_Homogeneous (Inherited)
Gtk.Box.Set_Spacing (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.Widget.Activate (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)
Set_Case_Sensitive
Set_Item_String
Set_Orientation (overriding Gtk.Box.Set_Orientation)
Set_Popdown_Strings
Set_Use_Arrows
Set_Use_Arrows_Always
Set_Value_In_List

Types

Gtk_Combo

type Gtk_Combo is access all Gtk_Combo_Record'Class;

Constants & Global variables

Allow_Empty_Property (Glib.Properties.Property_Boolean)

Allow_Empty_Property : constant Glib.Properties.Property_Boolean;

Case_Sensitive_Property (Glib.Properties.Property_Boolean)

Case_Sensitive_Property : constant Glib.Properties.Property_Boolean;

Enable_Arrow_Keys_Property (Glib.Properties.Property_Boolean)

Enable_Arrow_Keys_Property : constant Glib.Properties.Property_Boolean;

Enable_Arrows_Always_Property (Glib.Properties.Property_Boolean)

Enable_Arrows_Always_Property : constant Glib.Properties.Property_Boolean;

Value_In_List_Property (Glib.Properties.Property_Boolean)

Value_In_List_Property : constant Glib.Properties.Property_Boolean;

Subprograms & Entries

Gtk_New

procedure Gtk_New 
(Combo_Box: out Gtk_Combo);

Initialize

procedure Initialize 
(Combo_Box: access Gtk_Combo_Record'Class);

Get_Type

function Get_Type return Glib.GType;

Disable_Activate

procedure Disable_Activate 
(Combo_Box: access Gtk_Combo_Record);
Disable the standard handler for the return key in the entry field. The default behavior is to popdown the combo box list, so that the user can choose from it. However, if you want to add your own callback for the return key, you need to call this subprogram, and connect a handler to the "activate" signal for the entry.

Set_Case_Sensitive

procedure Set_Case_Sensitive 
(Combo_Box: access Gtk_Combo_Record;
Val: Boolean := True);
Specify whether the text entered into the Gtk_Entry field and the text in the list items are case sensitive. This may be useful, for example, when you have called Set_Value_In_List to limit the values entered, but you are not worried about differences in case.

Set_Item_String

procedure Set_Item_String 
(Combo_Box: access Gtk_Combo_Record;
Item: access Gtk.Item.Gtk_Item_Record'Class;
Item_Value: UTF8_String);
Set the string to place in the Gtk_Entry field when a particular list item is selected. This is needed if the list item is not a simple label.

Set_Popdown_Strings

procedure Set_Popdown_Strings 
(Combo_Box: access Gtk_Combo_Record;
Strings: Gtk.Enums.String_List.Glist);
Set all the items in the popup list.

Set_Use_Arrows

procedure Set_Use_Arrows 
(Combo_Box: access Gtk_Combo_Record;
Val: Boolean := True);
Specify if the arrow (cursor) keys can be used to step through the items in the list. This is on by default.

Set_Use_Arrows_Always

procedure Set_Use_Arrows_Always 
(Combo_Box: access Gtk_Combo_Record;
Val: Boolean := True);
Specify if the arrow keys will still work even if the current contents of the Gtk_Entry field do not match any of the list items.

Set_Value_In_List

procedure Set_Value_In_List 
(Combo_Box: access Gtk_Combo_Record;
Val: Boolean := True;
Ok_If_Empty: Boolean := False);
Specify whether the value entered in the text entry field must match one of the values in the list. If this is set then the user will not be able to perform any other action until a valid value has been entered. If an empty field is acceptable, the Ok_If_Empty parameter should be True. If the value entered must match one of the values in the list, val should be True.

Get_Entry

function Get_Entry 
(Combo_Box: access Gtk_Combo_Record) return Gtk.Widget.Gtk_Widget;

Set_Entry

procedure Set_Entry 
(Combo_Box: access Gtk_Combo_Record;
Value: access Gtk.Widget.Gtk_Widget_Record'Class);

Get_List

function Get_List 
(Combo_Box: access Gtk_Combo_Record) return Gtk.Widget.Gtk_Widget;

Get_Orientation

function Get_Orientation 
(Self: access Gtk_Combo_Record) return Gtk.Enums.Gtk_Orientation;

Set_Orientation

procedure Set_Orientation 
(Self: access Gtk_Combo_Record;
Orientation: Gtk.Enums.Gtk_Orientation);