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;
Gtk::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.