Gtk-- Reference: Gtk::Combo

Class Index | Cross Index | Namespace Index

# Class Gtk::Combo

Combo widget
Contained in: Gtk
Derived from: Gtk::HBox
Derived by: none

#include <gtk--/combo.h>

### public function member index:
`` | `Combo` | `()`;
``void`` | `disable_activate` | `()`;
``Button`*` | `get_button` | `() `const``;
``bool`` | `get_case_sensitive` | `() `const``;
``Entry`*` | `get_entry` | `() `const``;
``List`*` | `get_list` | `() `const``;
``bool`` | `get_ok_if_empty` | `() `const``;
``ScrolledWindow`*` | `get_popup` | `() `const``;
``Window`*` | `get_popwin` | `() `const``;
``bool`` | `get_use_arrows` | `() `const``;
``bool`` | `get_use_arrows_always` | `() `const``;
``bool`` | `get_value_in_list` | `() `const``;
``GtkCombo`*` | `gtkobj` | `()`;
``const` `GtkCombo`*` | `gtkobj` | `() `const``;
``static` `bool`` | `isA` | `(`Object`* `object`)`;
``void`` | `set_case_sensitive` | `(`bool` `val`)`;
``void`` | `set_item_string` | `(`Item`& `item`, `const` `nstring`& `item_value`=0)`;
``void`` | `set_popdown_strings` | `(`const` `SArray`& `strings`)`;
``void`` | `set_use_arrows` | `(`bool` `arrows_on`)`;
``void`` | `set_use_arrows_always` | `(`bool` `arrows_always`)`;
``void`` | `set_value_in_list` | `(`bool` `value`, `bool` `empty`)`;
``virtual`` | `~Combo` | `()`;

## Description:

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.

## Function Member Descriptions:

Gtk::Combo::disable_activate - Disables the activation of the combo.

``void`` `disable_activate``()`;

> ???? This does not appear to be possible to undo. This seems like a bug or a private method!

Gtk::Combo::gtkobj - Returns the underlaying gtk+ object.

``GtkCombo`*` `gtkobj``()`;
Gtk::Combo::isA - Returns true if object is this type.

``static` `bool`` `isA``(`Object`* `object`)`;
Gtk::Combo::set_case_sensitive - Sets list case sensitive.

``void`` `set_case_sensitive``(`bool` `val`)`;

> Determines if the list items and text comparisons for `set_use_arrows_always` should be case sensitive.

Gtk::Combo::set_item_string - Set the current entry string.

``void`` `set_item_string``(`Item`& `item`, `const` `nstring`& `item_value`=0)`;

> 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.

Gtk::Combo::set_popdown_strings - Insert a list of items.

``void`` `set_popdown_strings``(`const` `SArray`& `strings`)`;
Gtk::Combo::set_use_arrows - Set arrows keys to change value.

``void`` `set_use_arrows``(`bool` `arrows_on`)`;

> 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.

Gtk::Combo::set_use_arrows_always - Set arrows keys to change if value not in list.

``void`` `set_use_arrows_always``(`bool` `arrows_always`)`;

> 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.

Gtk::Combo::set_value_in_list - Allow direct text entry.

``void`` `set_value_in_list``(`bool` `value`, `bool` `empty`)`;

> 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.