A text entry field with a dropdown list. More...
Inherits Gtk::HBox.
Public Member Functions | |
virtual | ~Combo () |
GtkCombo* | gobj () |
Provides access to the underlying C GtkObject. | |
const GtkCombo* | gobj () const |
Provides access to the underlying C GtkObject. | |
Combo () | |
void | set_value_in_list (bool value=true, bool empty=false) |
Allow direct text entry Whether the text in the entry must be or not be in the list. | |
void | set_use_arrows (bool arrows_on=true) |
Set arrows keys to change value Up and down will scroll through the list items. | |
void | set_use_arrows_always (bool arrows_always=true) |
Set arrows keys to change if value not in list Up and down will scroll through the list items but only change the current value if the text does not match a list item. | |
void | set_case_sensitive (bool val=true) |
Sets list case sensitive Determines if the list items and text comparisons for set_use_arrows_always() should be case sensitive. | |
void | set_item_string (Gtk::Item& item, const Glib::ustring& item_value) |
Set the current entry Glib::ustring Call this function on an item if it isn't a label or you want it to have a different value to be displayed in the entry. | |
void | remove_item_string (Gtk::Item& item) |
void | set_popdown_strings (const Glib::ListHandle< Glib::ustring >& strings) |
Insert a list of items. | |
Glib::ListHandle< Glib::ustring > | get_popdown_strings () const |
void | disable_activate () |
Entry* | get_entry () |
const Entry* | get_entry () const |
ComboDropDown* | get_list () |
const ComboDropDown* | get_list () const |
Glib::PropertyProxy< bool > | property_enable_arrow_keys () |
Whether the arrow keys move through the list of items. | |
Glib::PropertyProxy_ReadOnly < bool > | property_enable_arrow_keys () const |
Whether the arrow keys move through the list of items. | |
Glib::PropertyProxy< bool > | property_enable_arrows_always () |
Obsolete property. | |
Glib::PropertyProxy_ReadOnly < bool > | property_enable_arrows_always () const |
Obsolete property. | |
Glib::PropertyProxy< bool > | property_case_sensitive () |
Whether list item matching is case sensitive. | |
Glib::PropertyProxy_ReadOnly < bool > | property_case_sensitive () const |
Whether list item matching is case sensitive. | |
Glib::PropertyProxy< bool > | property_allow_empty () |
Whether an empty value may be entered in this field. | |
Glib::PropertyProxy_ReadOnly < bool > | property_allow_empty () const |
Whether an empty value may be entered in this field. | |
Glib::PropertyProxy< bool > | property_value_in_list () |
Whether entered values must already be present in the list. | |
Glib::PropertyProxy_ReadOnly < bool > | property_value_in_list () const |
Whether entered values must already be present in the list. | |
Related Functions | |
(Note that these are not member functions.) | |
Gtk::Combo* | wrap (GtkCombo* object, bool take_copy=false) |
A Glib::wrap() method for this object. |
A text entry field with a dropdown list.
A combo is a compound widget which crosses a text entry area and a pull down list. It may allow text entry or it may just allow list values depending on the settings.
Access members allow altering of the widget components.
virtual Gtk::Combo::~Combo | ( | ) | [virtual] |
Gtk::Combo::Combo | ( | ) |
void Gtk::Combo::disable_activate | ( | ) |
const Entry* Gtk::Combo::get_entry | ( | ) | const |
Entry* Gtk::Combo::get_entry | ( | ) |
const ComboDropDown* Gtk::Combo::get_list | ( | ) | const |
ComboDropDown* Gtk::Combo::get_list | ( | ) |
Glib::ListHandle<Glib::ustring> Gtk::Combo::get_popdown_strings | ( | ) | const |
const GtkCombo* Gtk::Combo::gobj | ( | ) | const [inline] |
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::HBox.
GtkCombo* Gtk::Combo::gobj | ( | ) | [inline] |
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::HBox.
Glib::PropertyProxy_ReadOnly<bool> Gtk::Combo::property_allow_empty | ( | ) | const |
Whether an empty value may be entered in this field.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy<bool> Gtk::Combo::property_allow_empty | ( | ) |
Whether an empty value may be entered in this field.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly<bool> Gtk::Combo::property_case_sensitive | ( | ) | const |
Whether list item matching is case sensitive.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy<bool> Gtk::Combo::property_case_sensitive | ( | ) |
Whether list item matching is case sensitive.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly<bool> Gtk::Combo::property_enable_arrow_keys | ( | ) | const |
Whether the arrow keys move through the list of items.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy<bool> Gtk::Combo::property_enable_arrow_keys | ( | ) |
Whether the arrow keys move through the list of items.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly<bool> Gtk::Combo::property_enable_arrows_always | ( | ) | const |
Obsolete property.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy<bool> Gtk::Combo::property_enable_arrows_always | ( | ) |
Obsolete property.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly<bool> Gtk::Combo::property_value_in_list | ( | ) | const |
Whether entered values must already be present in the list.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy<bool> Gtk::Combo::property_value_in_list | ( | ) |
Whether entered values must already be present in the list.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
void Gtk::Combo::remove_item_string | ( | Gtk::Item& | item | ) |
void Gtk::Combo::set_case_sensitive | ( | bool | val = true |
) |
Sets list case sensitive Determines if the list items and text comparisons for set_use_arrows_always() should be case sensitive.
void Gtk::Combo::set_item_string | ( | Gtk::Item& | item, | |
const Glib::ustring & | item_value | |||
) |
Set the current entry Glib::ustring Call this function on an item if it isn't a label or you want it to have a different value to be displayed in the entry.
void Gtk::Combo::set_popdown_strings | ( | const Glib::ListHandle< Glib::ustring > & | strings | ) |
Insert a list of items.
void Gtk::Combo::set_use_arrows | ( | bool | arrows_on = true |
) |
Set arrows keys to change value Up and down will scroll through the list items.
Useful when there is a small list of value that the list must have.
arrows_on | true indicates the arrow keys scroll. |
void Gtk::Combo::set_use_arrows_always | ( | bool | arrows_always = true |
) |
Set arrows keys to change if value not in list Up and down will scroll through the list items but only change the current value if the text does not match a list item.
Useful when there is a small list of value that the list must have.
arrows_always | true indicates the value will change. |
void Gtk::Combo::set_value_in_list | ( | bool | value = true , |
|
bool | empty = false | |||
) |
Allow direct text entry Whether the text in the entry must be or not be in the list.
value | Set to true if the value must be in list. | |
empty | Set to true if the text area is allowed to be empty. |
Gtk::Combo* wrap | ( | GtkCombo * | object, | |
bool | take_copy = false | |||
) | [related] |
A Glib::wrap() method for this object.
object | The C instance. | |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |