Graphics.UI.Gtk.MenuComboToolbar.ComboBoxEntry

A ComboBoxEntry 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 a ComboBox, but it displays the selected value in an entry to allow modifying it.

In contrast to a ComboBox, the underlying model of a ComboBoxEntry must always have a text column (see comboBoxEntrySetTextColumn), and the entry will show the content of the text column in the selected row. To get the text from the entry, use comboBoxGetActiveText.

The convenience API to construct simple text-only ComboBoxes can also be used with ComboBoxEntrys which have been constructed with comboBoxEntryNewText.

Class Hierarchy

 |  GObject
 |   +----Object
 |         +----Widget
 |               +----Container
 |                     +----Bin
 |                           +----ComboBox
 |                                 +----ComboBoxEntry

Types

data ComboBoxEntry

Instances

BinClass ComboBoxEntry

CellLayoutClass ComboBoxEntry

ComboBoxClass ComboBoxEntry

ComboBoxEntryClass ComboBoxEntry

ContainerClass ComboBoxEntry

GObjectClass ComboBoxEntry

ObjectClass ComboBoxEntry

WidgetClass ComboBoxEntry

class ComboBoxClass o => ComboBoxEntryClass o

Instances

ComboBoxEntryClass ComboBoxEntry

castToComboBoxEntry :: GObjectClass obj => obj -> ComboBoxEntry

toComboBoxEntry :: ComboBoxEntryClass o => o -> ComboBoxEntry

Constructors

comboBoxEntryNew :: IO ComboBoxEntry

Creates a new ComboBoxEntry which has a Entry as child. After construction, you should set a model using comboBoxSetModel and a text column using comboBoxEntrySetTextColumn.

comboBoxEntryNewWithModel

:: TreeModelClass model
=> model	`model` - A `TreeModel`.
-> Int	`textColumn` - A column in `model` to get the strings from.
-> IO ComboBoxEntry
Creates a new `ComboBoxEntry` which has a `Entry` as child and a list of strings as popup. You can get the `Entry` from a `ComboBoxEntry` using `binGetChild`. To add and remove strings from the list, just modify `model` using its data manipulation API.

comboBoxEntryNewText :: IO ComboBoxEntry

Convenience function which constructs a new editable text combo box, which is a ComboBoxEntry just displaying strings. If you use this function to create a text combo box, you should only manipulate its data source with the following convenience functions: comboBoxAppendText, comboBoxInsertText, comboBoxPrependText and comboBoxRemoveText.

Methods

comboBoxEntrySetTextColumn

:: ComboBoxEntryClass self
=> self
-> Int	`textColumn` - A column in the model to get the strings from.
-> IO ()
Sets the model column which the entry box should use to get strings from to be `textColumn`.

comboBoxEntryGetTextColumn

:: ComboBoxEntryClass self
=> self
-> IO Int	returns a column in the data source model of the entry box.
Returns the column which the entry box is using to get the strings from.

Attributes

comboBoxEntryTextColumn :: ComboBoxEntryClass self => Attr self Int

A column in the data source model to get the strings from.

Allowed values: >= -1

Default value: -1

Produced by Haddock version 0.8