Google

logo top
Main Page   Widgets   Namespaces   Book  

Gtk::Combo Class Reference
[Widgets]

A text entry field with a dropdown list. More...

Inheritance diagram for Gtk::Combo:

Inheritance graph
[legend]
List of all members.

Public Methods

virtual ~Combo ()
GtkCombo* gobj ()
const GtkCombo* gobj () const
 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::ustringget_popdown_strings () const
void disable_activate ()
Entryget_entry ()
const Entryget_entry () const
ComboDropDownget_list ()
const ComboDropDownget_list () const
Glib::PropertyProxy<bool> property_enable_arrow_keys ()
Glib::PropertyProxy<bool> property_enable_arrows_always ()
Glib::PropertyProxy<bool> property_case_sensitive ()
Glib::PropertyProxy<bool> property_allow_empty ()
Glib::PropertyProxy<bool> property_value_in_list ()

Related Functions

(Note that these are not member functions.)

Gtk::Combo* wrap (GtkCombo* object, bool take_copy=false)

Detailed Description

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.


Constructor & Destructor Documentation

virtual Gtk::Combo::~Combo (   [virtual]
 

Gtk::Combo::Combo (  
 


Member Function Documentation

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]
 

Reimplemented from Gtk::HBox.

GtkCombo* Gtk::Combo::gobj (   [inline]
 

Reimplemented from Gtk::HBox.

Glib::PropertyProxy<bool> Gtk::Combo::property_allow_empty (  
 

Glib::PropertyProxy<bool> Gtk::Combo::property_case_sensitive (  
 

Glib::PropertyProxy<bool> Gtk::Combo::property_enable_arrow_keys (  
 

Glib::PropertyProxy<bool> Gtk::Combo::property_enable_arrows_always (  
 

Glib::PropertyProxy<bool> Gtk::Combo::property_value_in_list (  
 

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.

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

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

Parameters:
value Set to true if the value must be in list.
empty Set to true if the text area is allowed to be empty.


Friends And Related Function Documentation

Gtk::Combo* wrap ( GtkCombo*    object,
bool    take_copy = false
[related]
 


The documentation for this class was generated from the following file:
Generated for gtkmm by Doxygen 1.3-rc1 © 1997-2001