|
Graphics.UI.Gtk.MenuComboToolbar.Combo | Portability | portable (depends on GHC) | Stability | provisional | Maintainer | gtk2hs-users@lists.sourceforge.net |
|
|
|
|
|
Description |
A text entry field with a dropdown list
- Warning: this module is deprecated and should not be used in
newly-written code.
|
|
Synopsis |
|
|
|
|
Detail
|
|
The 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.
List elements
can contain arbitrary widgets, but if an element is not a plain label, then
you must use the comboSetItemString 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
comboSetUseArrows.
As of Gtk+ 2.4, Combo has been deprecated in favor of ComboBox.
|
|
Class Hierarchy
|
|
| GObject
| +----Object
| +----Widget
| +----Container
| +----Box
| +----HBox
| +----Combo
|
|
Types
|
|
|
|
|
|
|
|
|
|
|
|
|
Constructors
|
|
|
|
Methods
|
|
|
Insert a set of Strings into the
Combo drop down list.
|
|
|
:: ComboClass self | | => self | val - True if the value entered must match one of the
values in the list.
| -> Bool | okIfEmpty - True if an empty value is considered valid.
| -> Bool | | -> IO () | | Specifies 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 okIfEmpty parameter should be
True.
|
|
|
|
Specifies if the arrow (cursor) keys can be used to step through the
items in the list. This is on by default.
|
|
|
Obsolete function, does nothing.
|
|
|
Specifies whether the text entered into the Entry field and the text in
the list items is case sensitive.
This may be useful, for example, when you have called
comboSetValueInList to limit the values entered, but you are not worried
about differences in case.
|
|
|
Stops the Combo widget from showing the popup list when the Entry
emits the "activate" signal, i.e. when the Return key is pressed. This may
be useful if, for example, you want the Return key to close a dialog
instead.
|
|
Attributes
|
|
|
Whether the arrow keys move through the list of items.
Default value: True
|
|
|
Obsolete property, ignored.
Default value: True
|
|
|
Whether list item matching is case sensitive.
Default value: False
|
|
|
Whether an empty value may be entered in this field.
Default value: True
|
|
|
Whether entered values must already be present in the list.
Default value: False
|
|
Produced by Haddock version 2.6.0 |