index
gtk-- homepage



Description:
Gtk_Combo

#include <gtk--/combo.h>
Base classes: Gtk_HBox

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



Properties:


Public member index:


static GtkType get_type();
GtkCombo *gtkobj();
const GtkCombo *gtkobj()const;
static bool isA(Gtk_Object *checkcast);
virtual ~Gtk_Combo();
Gtk_Combo();
bool get_value_in_list()const;
bool get_ok_if_empty()const;
bool get_use_arrows()const;
bool get_use_arrows_always()const;
bool get_case_sensitive()const;
void set_value_in_list(bool value,bool empty);
Allow direct text entry

void set_use_arrows(bool arrows_on);
Set arrows keys to change value

void set_use_arrows_always(bool arrows_always);
Set arrows keys to change if value not in list

void set_case_sensitive(bool val);
Sets list case sensitive

void set_item_string(Gtk_Item &item,const gtkmm_string &item_value=0);
Set the current entry string

void set_popdown_strings(const Gtk_SArray &strings);
Insert a list of items.

void disable_activate();
Disables the activation of the combo

Gtk_Entry *get_entry()const;
Gtk_Button *get_button()const;
Gtk_ScrolledWindow *get_popup()const;
Gtk_Window *get_popwin()const;
Gtk_List *get_list()const;
Protected member index:


void initialize_class();
void *get_parent_class();
static void init_parent_class();
explicit Gtk_Combo(GtkCombo *castitem);
Private member index:


Gtk_Combo(const Gtk_Combo &);
Gtk_Combo &operator =(const Gtk_Combo &);

Public member details:


set_value_in_list
void Gtk_Combo::set_value_in_list(bool value,bool empty);

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.


set_use_arrows
void Gtk_Combo::set_use_arrows(bool arrows_on);

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.


set_use_arrows_always
void Gtk_Combo::set_use_arrows_always(bool arrows_always);

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.


set_case_sensitive
void Gtk_Combo::set_case_sensitive(bool val);

Sets list case sensitive
Determines if the list items and text comparisons for set_use_arrows_always() should be case sensitive.


set_item_string
void Gtk_Combo::set_item_string(Gtk_Item &item,const gtkmm_string &item_value=0);

Set the current entry string
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


disable_activate
void Gtk_Combo::disable_activate();

Disables the activation of the combo
???? This does not appear to be possible to undo. This seems like a bug or a private method!


Protected member details:



Private member details:



Examples:





(pages generated by PERCEPS -script.)