GtkCombo                package:RGtk2                R Documentation

_G_t_k_C_o_m_b_o

_D_e_s_c_r_i_p_t_i_o_n:

     A text entry field with a dropdown list

_M_e_t_h_o_d_s _a_n_d _F_u_n_c_t_i_o_n_s:

     'gtkComboNew(show = TRUE)'
      'gtkComboSetPopdownStrings(object, strings)'
      'gtkComboSetValueInList(object, val, ok.if.empty)'
      'gtkComboSetUseArrows(object, val)'
      'gtkComboSetUseArrowsAlways(object, val)'
      'gtkComboSetCaseSensitive(object, val)'
      'gtkComboSetItemString(object, item, item.value)'
      'gtkComboDisableActivate(object)'
      'gtkCombo(show = TRUE)'

_H_i_e_r_a_r_c_h_y:

     GObject
        +----GInitiallyUnowned
              +----GtkObject
                    +----GtkWidget
                          +----GtkContainer
                                +----GtkBox
                                      +----GtkHBox
                                            +----GtkCombo 

_I_n_t_e_r_f_a_c_e_s:

     GtkCombo implements AtkImplementorIface and  'GtkBuildable'.

_D_e_t_a_i_l_e_d _D_e_s_c_r_i_p_t_i_o_n:

     The 'GtkCombo' widget consists of a single-line text entry field
     and a drop-down list. The drop-down list is displayed when the
     user clicks on a small arrow button to the right of the entry
     field.

     The drop-down list is a 'GtkList' widget and can be accessed using
     the 'list' member of the 'GtkCombo'. List elements can contain
     arbitrary widgets, but if an element is not a plain label, then
     you must use the 'gtkListSetItemString()' function. This sets the
     string which will be placed in the text entry field when the item
     is selected.

     By default, the user can step through the items in the list using
     the arrow (cursor) keys, though this behaviour can be turned off
     with 'gtkComboSetUseArrows'.

     As of GTK+ 2.4, 'GtkCombo' has been deprecated in favor of
     'GtkComboBox'.

     _Creating a   'GtkCombo'   widget with simple text  items._


     ######
     # Creating a combobox with simple text items
     ######

     items <- c("First Item", "Second Item", "Third Item", "Fourth
     Item",
                "Fifth Item")
     combo <- gtkCombo()
     combo$setPopdownStrings(items)
      _Creating a   'GtkCombo'   widget with a complex item._


     ######
     # Creating a combobox with a complex item
     ######

     combo <- gtkCombo()
     item <- gtkListItem()

     ## You can put almost anything into the GtkListItem widget. Here
     we will use
     ##   a horizontal box with an arrow and a label in it.
     hbox <- gtkHbox(FALSE, 3)
     item$add(hbox)

     arrow <- gtkArrow("right", "out")
     hbox$packStart(arrow, FALSE, FALSE, 0)

     label <- gtkLabel("First Item")
     hbox$packStart(label, FALSE, FALSE, 0)

     ## You must set the string to display in the entry field when the
     item is
     ##   selected.
     combo$setItemString(item, "1st Item")

     ## Now we simply add the item to the combo's list.
     combo[["list"]]$add(item)


_S_t_r_u_c_t_u_r_e_s:


     '_G_t_k_C_o_m_b_o' *WARNING: 'GtkCombo' has been deprecated since version
          2.4 and should not be used in newly-written code. Use
          'GtkComboBox' instead.* The 'GtkFixedChild' struct contains
          the following fields. (These fields should be considered
          read-only. They should never be set by an application.)

          '_e_n_t_r_y' ['GtkWidget'] the text entry field.

          '_l_i_s_t' ['GtkWidget'] the list shown in the drop-down window.


_C_o_n_v_e_n_i_e_n_t _C_o_n_s_t_r_u_c_t_i_o_n:

     'gtkCombo' is the equivalent of 'gtkComboNew'.

_P_r_o_p_e_r_t_i_e_s:


     '_a_l_l_o_w-_e_m_p_t_y' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Whether an empty value may
          be entered in this field.  Default value: TRUE


     '_c_a_s_e-_s_e_n_s_i_t_i_v_e' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Whether list item
          matching is case sensitive.  Default value: FALSE


     '_e_n_a_b_l_e-_a_r_r_o_w-_k_e_y_s' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Whether the arrow
          keys move through the list of items.  Default value: TRUE


     '_e_n_a_b_l_e-_a_r_r_o_w_s-_a_l_w_a_y_s' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Obsolete property,
          ignored.  Default value: TRUE


     '_v_a_l_u_e-_i_n-_l_i_s_t' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Whether entered values
          must already be present in the list.  Default value: FALSE


_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://developer.gnome.org/doc/API/2.0/gtk/GtkCombo.html>

