<html> <head><title>Gtk-- Reference: Gtk::Combo</title></head> <body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#000077" alink="#FF0000"> <table align=center border=0 cellspacing=10> <tr> <td><a href="class_index.html">Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="name_index.html">Namespace Index</a></td> </table> <h1 align=center>Class Gtk::Combo</h1><p> <b> Combo widget</b><br> Contained in: <a href="Gtk.html">Gtk</a><br> Derived from: <a href="Gtk%3A%3AHBox.html">Gtk::HBox</a> <br> Derived by: <i>none</i> <p> #include <gtk--/combo.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#962"><tt><font color=blue><b>Combo</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#974"><tt><font color=blue><b>disable_activate</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AButton.html"><tt><font color=navy><b>Button</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#976"><tt><font color=blue><b>get_button</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#967"><tt><font color=blue><b>get_case_sensitive</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AEntry.html"><tt><font color=navy><b>Entry</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#975"><tt><font color=blue><b>get_entry</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AList.html"><tt><font color=navy><b>List</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#979"><tt><font color=blue><b>get_list</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#964"><tt><font color=blue><b>get_ok_if_empty</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AScrolledWindow.html"><tt><font color=navy><b>ScrolledWindow</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#977"><tt><font color=blue><b>get_popup</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AWindow.html"><tt><font color=navy><b>Window</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#978"><tt><font color=blue><b>get_popwin</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#965"><tt><font color=blue><b>get_use_arrows</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#966"><tt><font color=blue><b>get_use_arrows_always</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#963"><tt><font color=blue><b>get_value_in_list</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkCombo</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#958"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>GtkCombo</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#959"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#960"><tt><font color=blue><b>isA</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#971"><tt><font color=blue><b>set_case_sensitive</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>val</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#972"><tt><font color=blue><b>set_item_string</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AItem.html"><tt><font color=navy><b>Item</b></font></tt></a>& <tt><font color=blue>item</font></tt>, <tt>const</tt> <a href="Gtk%3A%3Anstring.html"><tt><font color=navy><b>nstring</b></font></tt></a>& <tt><font color=blue>item_value</font></tt>=0)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#973"><tt><font color=blue><b>set_popdown_strings</b></font></tt></a></td><td><tt>(<tt>const</tt> <a href="Gtk%3A%3ASArray.html"><tt><font color=navy><b>SArray</b></font></tt></a>& <tt><font color=blue>strings</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#969"><tt><font color=blue><b>set_use_arrows</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>arrows_on</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#970"><tt><font color=blue><b>set_use_arrows_always</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>arrows_always</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#968"><tt><font color=blue><b>set_value_in_list</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>value</font></tt>, <tt><font color=purple>bool</font></tt> <tt><font color=blue>empty</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="Gtk%3A%3ACombo.html#961"><tt><font color=blue><b>~Combo</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> 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. <P> Access members allow altering of the widget components.<br> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="974"><font size=+1><b>Gtk::Combo::disable_activate</b></font></a> - Disables the activation of the combo.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACombo.html#974"><tt><font color=blue><b>disable_activate</b></font></tt></a><tt>()</tt>;<br><blockquote> ???? This does not appear to be possible to undo. This seems like a bug or a private method!</blockquote> <br><br> <a name="958"><font size=+1><b>Gtk::Combo::gtkobj</b></font></a> - Returns the underlaying gtk+ object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>GtkCombo</font></tt>*</tt> <a href="Gtk%3A%3ACombo.html#958"><tt><font color=blue><b>gtkobj</b></font></tt></a><tt>()</tt>;<br><br> <a name="960"><font size=+1><b>Gtk::Combo::isA</b></font></a> - Returns true if object is this type.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3ACombo.html#960"><tt><font color=blue><b>isA</b></font></tt></a><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;<br><br> <a name="971"><font size=+1><b>Gtk::Combo::set_case_sensitive</b></font></a> - Sets list case sensitive.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACombo.html#971"><tt><font color=blue><b>set_case_sensitive</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>val</font></tt>)</tt>;<br><blockquote> Determines if the list items and text comparisons for <a href="Gtk%3A%3ACombo.html#970"><tt><font color=blue><b>set_use_arrows_always</b></font></tt></a> should be case sensitive.</blockquote> <br><br> <a name="972"><font size=+1><b>Gtk::Combo::set_item_string</b></font></a> - Set the current entry string.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACombo.html#972"><tt><font color=blue><b>set_item_string</b></font></tt></a><tt>(<a href="Gtk%3A%3AItem.html"><tt><font color=navy><b>Item</b></font></tt></a>& <tt><font color=blue>item</font></tt>, <tt>const</tt> <a href="Gtk%3A%3Anstring.html"><tt><font color=navy><b>nstring</b></font></tt></a>& <tt><font color=blue>item_value</font></tt>=0)</tt>;<br><blockquote> 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.</blockquote> <br><br> <a name="973"><font size=+1><b>Gtk::Combo::set_popdown_strings</b></font></a> - Insert a list of items.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACombo.html#973"><tt><font color=blue><b>set_popdown_strings</b></font></tt></a><tt>(<tt>const</tt> <a href="Gtk%3A%3ASArray.html"><tt><font color=navy><b>SArray</b></font></tt></a>& <tt><font color=blue>strings</font></tt>)</tt>;<br><br> <a name="969"><font size=+1><b>Gtk::Combo::set_use_arrows</b></font></a> - Set arrows keys to change value.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACombo.html#969"><tt><font color=blue><b>set_use_arrows</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>arrows_on</font></tt>)</tt>;<br><blockquote> Up and down will scroll through the list items. Useful when there is a small list of value that the list must have. <P> arrows_on: true indicates the arrow keys scroll.</blockquote> <br><br> <a name="970"><font size=+1><b>Gtk::Combo::set_use_arrows_always</b></font></a> - Set arrows keys to change if value not in list.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACombo.html#970"><tt><font color=blue><b>set_use_arrows_always</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>arrows_always</font></tt>)</tt>;<br><blockquote> 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. <P> arrows_always: true indicates the value will change.</blockquote> <br><br> <a name="968"><font size=+1><b>Gtk::Combo::set_value_in_list</b></font></a> - Allow direct text entry.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACombo.html#968"><tt><font color=blue><b>set_value_in_list</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>value</font></tt>, <tt><font color=purple>bool</font></tt> <tt><font color=blue>empty</font></tt>)</tt>;<br><blockquote> Whether the text in the entry must be or not be in the list. <P> value: Set to true if the value must be in list. <P> empty: Set to true if the text area is allowed to be empty.</blockquote> <br><br> <hr noshade> </html>