## Documentation

Table of Contents
Class Inheritance Tree
Widget Screenshots
Package groups

## Index

Package: Combo_Box_Entry

- Goto spec source

# Description

    package Gtk.Combo_Box_Entry is

A Gtk_Combo_Box_Entry is a widget that allows the user to choose from a list of valid choices or enter a different value. It is very similar to Gtk_Combo_Box, but it displays the selected value in an entry to allow modifying it.

In contrast to a Gtk_Combo_Box, the underlying model of a Gtk_Combo_Box_Entry must always have a text column (see Set_Text_Column), and the entry will show the content of the text column in the selected row.

To get the text from the entry, use Gtk.Combo_Box.Get_Active_Text.

The changed signal will be emitted while typing into a Gtk_Combo_Box_Entry, as well as when selecting an item from the Gtk_Combo_Box_Entry's list. Use Gtk.Combo_Box.Get_Active or Gtk.Combo_Box.Get_Active_Iter to discover whether an item was actually selected from the list.

Connect to the activate signal of the Gtk_Entry (use Gtk.Bin.Get_Child) to detect when the user actually finishes entering text.

The convenience API to construct simple text-only Gtk_Combo_Box can also be used with Gtk_Combo_Box_Entry which have been constructed with Gtk_New_Text.

</description>

Binding from C File version 2.8.17

### Screenshot

# Packages

### Implements_Cell_Layout (new Glib.Types.Implements)

    package Implements_Cell_Layout is new Glib.Types.Implements
         (Gtk.Cell_Layout.Gtk_Cell_Layout, Gtk_Combo_Box_Entry_Record,
          Gtk_Combo_Box_Entry);

### Implements_Cell_Editable (new Glib.Types.Implements)

    package Implements_Cell_Editable is new Glib.Types.Implements
         (Gtk.Cell_Editable.Gtk_Cell_Editable,
          Gtk_Combo_Box_Entry_Record, Gtk_Combo_Box_Entry);

# Classes

### Gtk_Combo_Box_Entry_Record

- Goto declaration in source

    type Gtk_Combo_Box_Entry_Record is new Gtk.Combo_Box.Gtk_Combo_Box_Record
          with null record;

#### Ancestors:

Gtk.Combo_Box.Gtk_Combo_Box_Record
Gtk.Bin.Gtk_Bin_Record
Gtk.Container.Gtk_Container_Record
Gtk.Widget.Gtk_Widget_Record
Glib.Object.GObject_Record

#### Primitive operations:

Get_Text_Column

- To API doc
- To spec

Glib.Object.Deallocate

- To API doc
- To spec

(Inherited)
Glib.Object.Get_Type

- To API doc
- To spec

(Inherited)
Glib.Object.Notify

- To API doc
- To spec

(Inherited)
Glib.Object.Ref

- To API doc
- To spec

(Inherited)
Glib.Object.Ref_Sink

- To API doc
- To spec

(Inherited)
Glib.Object.Unref

- To API doc
- To spec

(Inherited)
Gtk.Bin.Get_Child

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Append_Text

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Active

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Active_Iter

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Active_Text

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Add_Tearoffs

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Button_Sensitivity

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Column_Span_Column

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Entry_Text_Column

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Focus_On_Click

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Has_Entry

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Model

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Row_Separator_Func

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Row_Span_Column

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Title

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Get_Wrap_Width

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Insert_Text

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Popdown

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Popup

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Prepend_Text

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Remove_Text

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Active

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Active_Iter

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Add_Tearoffs

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Button_Sensitivity

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Column_Span_Column

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Entry_Text_Column

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Focus_On_Click

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Model

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Row_Separator_Func

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Row_Span_Column

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Title

- To API doc
- To spec

(Inherited)
Gtk.Combo_Box.Set_Wrap_Width

- To API doc
- To spec

(Inherited)
Gtk.Container.Add

- To API doc
- To spec

(Inherited)
Gtk.Container.Check_Resize

- To API doc
- To spec

(Inherited)
Gtk.Container.Child_Get_Property

- To API doc
- To spec

(Inherited)
Gtk.Container.Child_Set_Property

- To API doc
- To spec

(Inherited)
Gtk.Container.Child_Type

- To API doc
- To spec

(Inherited)
Gtk.Container.Forall

- To API doc
- To spec

(Inherited)
Gtk.Container.Foreach

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Border_Width

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Children

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Focus_Chain

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Focus_Child

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Focus_Hadjustment

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Focus_Vadjustment

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Resize_Mode

- To API doc
- To spec

(Inherited)
Gtk.Container.Propagate_Expose

- To API doc
- To spec

(Inherited)
Gtk.Container.Remove

- To API doc
- To spec

(Inherited)
Gtk.Container.Resize_Children

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Border_Width

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Focus_Chain

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Focus_Child

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Focus_Hadjustment

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Focus_Vadjustment

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Reallocate_Redraws

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Resize_Mode

- To API doc
- To spec

(Inherited)
Gtk.Container.Unset_Focus_Chain

- To API doc
- To spec

(Inherited)
Gtk.Widget.Activate

- To API doc
- To spec

(Inherited)
Gtk.Widget.Add_Accelerator

- To API doc
- To spec

(Inherited)
Gtk.Widget.Add_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Add_Mnemonic_Label

- To API doc
- To spec

(Inherited)
Gtk.Widget.Can_Activate_Accel

- To API doc
- To spec

(Inherited)
Gtk.Widget.Child_Notify

- To API doc
- To spec

(Inherited)
Gtk.Widget.Class_Path

- To API doc
- To spec

(Inherited)
Gtk.Widget.Class_Path_Reversed

- To API doc
- To spec

(Inherited)
Gtk.Widget.Create_Pango_Context

- To API doc
- To spec

(Inherited)
Gtk.Widget.Create_Pango_Layout

- To API doc
- To spec

(Inherited)
Gtk.Widget.Destroy

- To API doc
- To spec

(Inherited)
Gtk.Widget.Draw

- To API doc
- To spec

(Inherited)
Gtk.Widget.Ensure_Style

- To API doc
- To spec

(Inherited)
Gtk.Widget.Error_Bell

- To API doc
- To spec

(Inherited)
Gtk.Widget.Flag_Is_Set

- To API doc
- To spec

(Inherited)
Gtk.Widget.Flags

- To API doc
- To spec

(Inherited)
Gtk.Widget.Freeze_Child_Notify

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Allocation_Height

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Allocation_Width

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Allocation_X

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Allocation_Y

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Ancestor

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Child_Requisition

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Child_Visible

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Colormap

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Composite_Name

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Direction

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Extension_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Has_Tooltip

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Name

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_No_Show_All

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Pango_Context

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Parent

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Parent_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Pointer

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Root_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Size_Request

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Snapshot

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_State

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Style

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Tooltip_Markup

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Tooltip_Text

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Tooltip_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Toplevel

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Visual

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Grab_Default

- To API doc
- To spec

(Inherited)
Gtk.Widget.Grab_Focus

- To API doc
- To spec

(Inherited)
Gtk.Widget.Has_Screen

- To API doc
- To spec

(Inherited)
Gtk.Widget.Hide

- To API doc
- To spec

(Inherited)
Gtk.Widget.Hide_All

- To API doc
- To spec

(Inherited)
Gtk.Widget.Input_Shape_Combine_Mask

- To API doc
- To spec

(Inherited)
Gtk.Widget.Intersect

- To API doc
- To spec

(Inherited)
Gtk.Widget.Is_Ancestor

- To API doc
- To spec

(Inherited)
Gtk.Widget.Is_Composited

- To API doc
- To spec

(Inherited)
Gtk.Widget.Is_Focus

- To API doc
- To spec

(Inherited)
Gtk.Widget.Keynav_Failed

- To API doc
- To spec

(Inherited)
Gtk.Widget.List_Mnemonic_Labels

- To API doc
- To spec

(Inherited)
Gtk.Widget.Map

- To API doc
- To spec

(Inherited)
Gtk.Widget.Mnemonic_Activate

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Base

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Bg

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Cursor

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Fg

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Font

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Text

- To API doc
- To spec

(Inherited)
Gtk.Widget.Path

- To API doc
- To spec

(Inherited)
Gtk.Widget.Path_Reversed

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Clear

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Clear_Area

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Draw

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Draw_Area

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Resize

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Resize_No_Redraw

- To API doc
- To spec

(Inherited)
Gtk.Widget.Realize

- To API doc
- To spec

(Inherited)
Gtk.Widget.Region_Intersect

- To API doc
- To spec

(Inherited)
Gtk.Widget.Remove_Accelerator

- To API doc
- To spec

(Inherited)
Gtk.Widget.Remove_Mnemonic_Label

- To API doc
- To spec

(Inherited)
Gtk.Widget.Render_Icon

- To API doc
- To spec

(Inherited)
Gtk.Widget.Reparent

- To API doc
- To spec

(Inherited)
Gtk.Widget.Reset_Rc_Styles

- To API doc
- To spec

(Inherited)
Gtk.Widget.Reset_Shapes

- To API doc
- To spec

(Inherited)
Gtk.Widget.Restore_Default_Style

- To API doc
- To spec

(Inherited)
Gtk.Widget.Send_Expose

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Accel_Path

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_App_Paintable

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Child_Visible

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Colormap

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Composite_Name

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Direction

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Double_Buffered

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Extension_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Flags

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Has_Tooltip

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Name

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_No_Show_All

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Parent

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Parent_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Redraw_On_Allocate

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Scroll_Adjustments

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Sensitive

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Size_Request

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_State

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Style

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Tooltip_Markup

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Tooltip_Text

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Tooltip_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_UPosition

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_USize

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Shape_Combine_Mask

- To API doc
- To spec

(Inherited)
Gtk.Widget.Show

- To API doc
- To spec

(Inherited)
Gtk.Widget.Show_All

- To API doc
- To spec

(Inherited)
Gtk.Widget.Show_Now

- To API doc
- To spec

(Inherited)
Gtk.Widget.Size_Allocate

- To API doc
- To spec

(Inherited)
Gtk.Widget.Size_Request

- To API doc
- To spec

(Inherited)
Gtk.Widget.Style_Get_Property

- To API doc
- To spec

(Inherited)
Gtk.Widget.Thaw_Child_Notify

- To API doc
- To spec

(Inherited)
Gtk.Widget.Trigger_Tooltip_Query

- To API doc
- To spec

(Inherited)
Gtk.Widget.Unmap

- To API doc
- To spec

(Inherited)
Gtk.Widget.Unrealize

- To API doc
- To spec

(Inherited)
Gtk.Widget.Unset_Flags

- To API doc
- To spec

(Inherited)
Set_Text_Column

- To API doc
- To spec

# Types

### Gtk_Combo_Box_Entry

- Goto declaration in source

    type Gtk_Combo_Box_Entry is access all Gtk_Combo_Box_Entry_Record'Class;

# Constants & Global variables

### Text_Column_Property

- Goto declaration in source

(Glib.Properties.Property_Int)

    Text_Column_Property : constant Glib.Properties.Property_Int;

# Subprograms & Entries

### Gtk_New

- Goto spec in source

    procedure Gtk_New    (Combo: out Gtk_Combo_Box_Entry);

### Initialize

- Goto spec in source

    procedure Initialize (Combo: access Gtk_Combo_Box_Entry_Record'Class);

Creates a new combo entry which has a Gtk.Gentry.Gtk_Entry as child. After construction, you should set a model using Gtk.Combo_Box.Set_Model and text_column using Set_Text_Column.

### Gtk_New_Text

- Goto spec in source

    procedure Gtk_New_Text    (Combo: out Gtk_Combo_Box_Entry);

### Initialize_Text

- Goto spec in source

    procedure Initialize_Text (Combo: access Gtk_Combo_Box_Entry_Record'Class);

Convenience function which constructs a new editable text combo box, which is an entry just displaying strings. If you use this function to create a text combo box, you should only manipulate its data source with the convenience functions Gtk.Combo_Box.Append_Text, Gtk.Combo_Box.Insert_Text,...

### Gtk_New_With_Model

- Goto spec in source

    procedure Gtk_New_With_Model (Combo: out Gtk_Combo_Box_Entry;Model: access Gtk.Tree_Model.Gtk_Tree_Model_Record'Class;Text_Column: Gint);

### Initialize_With_Model

- Goto spec in source

    procedure Initialize_With_Model (Combo: access Gtk_Combo_Box_Entry_Record'Class;Model: access Gtk.Tree_Model.Gtk_Tree_Model_Record'Class;Text_Column: Gint);

Creates a new entry which has a Gtk_Entry as child and a list of strings as popup. You can get the Gtk_Entry using Gtk.Bin.Get_Child. To add and remove strings from the list, just modify Model

### Get_Type

- Goto spec in source
- Goto body in source

    function Get_Type return Glib.GType;

Returns the internal value used for Gtk_Combo_Box_Entry widgets

### Set_Text_Column

- Goto spec in source

    procedure Set_Text_Column (Entry_Box: access Gtk_Combo_Box_Entry_Record;Text_Column: Gint);

### Get_Text_Column

- Goto spec in source

    function Get_Text_Column (Entry_Box: access Gtk_Combo_Box_Entry_Record)  return Gint;

Sets the model column which Entry_Box should use to get strings from to be Text_Column.

### +

- Goto spec in source

    function "+" (Box: access Gtk_Combo_Box_Entry_Record'Class) return Gtk.Cell_Layout.Gtk_Cell_Layout renames Implements_Cell_Layout.To_Interface;

### -

- Goto spec in source

    function "-" (Layout: Gtk.Cell_Layout.Gtk_Cell_Layout) return Gtk_Combo_Box_Entry renames Implements_Cell_Layout.To_Object;

Converts to and from the Gtk_Cell_Layout interface

### +

- Goto spec in source

    function "+" (Box: access Gtk_Combo_Box_Entry_Record'Class) return Gtk.Cell_Editable.Gtk_Cell_Editable renames Implements_Cell_Editable.To_Interface;

### -

- Goto spec in source

    function "-" (Editable: Gtk.Cell_Editable.Gtk_Cell_Editable) return Gtk_Combo_Box_Entry renames Implements_Cell_Editable.To_Object;

Converts to and from the Gtk_Cell_Editable interface