GtkComboBoxEntry            package:RGtk2            R Documentation

_G_t_k_C_o_m_b_o_B_o_x_E_n_t_r_y

_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:

     'gtkComboBoxEntryNew(show = TRUE)'
      'gtkComboBoxEntryNewWithModel(model, text.column)'
      'gtkComboBoxEntryNewText()'
      'gtkComboBoxEntrySetTextColumn(object, text.column)'
      'gtkComboBoxEntryGetTextColumn(object)'
      'gtkComboBoxEntry(show = TRUE)'

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

     GObject
        +----GInitiallyUnowned
              +----GtkObject
                    +----GtkWidget
                          +----GtkContainer
                                +----GtkBin
                                      +----GtkComboBox
                                            +----GtkComboBoxEntry 

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

     GtkComboBoxEntry implements AtkImplementorIface,  'GtkBuildable', 
     'GtkCellEditable' and  'GtkCellLayout'.

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

     A 'GtkComboBoxEntry' is a widget that allows the user to choose
     from a list of valid choices or enter a different value. It is
     very similar to a 'GtkComboBox', but it displays the selected
     value in an entry to allow modifying it.

     In contrast to a 'GtkComboBox', the underlying model of a
     'GtkComboBoxEntry'  must always have a text column (see
     'gtkComboBoxEntrySetTextColumn'), and the entry will show the
     content of the text column in the selected row.   To get the text
     from the entry, use 'gtkComboBoxGetActiveText'.

     The changed signal will be emitted while typing into a
     GtkComboBoxEntry,  as well as when selecting an item from the
     GtkComboBoxEntry's list. Use  'gtkComboBoxGetActive' or
     'gtkComboBoxGetActiveIter' to discover  whether an item was
     actually selected from the list.

     Connect to the activate signal of the GtkEntry (use
     'gtkBinGetChild')  to detect when the user actually finishes
     entering text.

     The convenience API to construct simple text-only 'GtkComboBox'es 
     can also be used with 'GtkComboBoxEntry's which have been
     constructed with 'gtkComboBoxEntryNewText'.

     If you have special needs that go beyond a simple entry (e.g.
     input validation), it is possible to replace the child entry by a
     different widget using 'gtkContainerRemove' and 'gtkContainerAdd'.

_G_t_k_C_o_m_b_o_B_o_x_E_n_t_r_y _a_s _G_t_k_B_u_i_l_d_a_b_l_e:

     Beyond the <attributes> support that is shared by all
     GtkCellLayout implementation, GtkComboBoxEntry makes the entry
     available in UI definitions as an internal  child with name
     "entry".

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


     '_G_t_k_C_o_m_b_o_B_o_x_E_n_t_r_y' _undocumented _


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

     'gtkComboBoxEntry' is the equivalent of 'gtkComboBoxEntryNew'.

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


     '_t_e_x_t-_c_o_l_u_m_n' [_i_n_t_e_g_e_r : _R_e_a_d / _W_r_i_t_e] A column in the data source
          model to get the strings from.  Allowed values: >= -1 
          Default value: -1


_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/GtkComboBoxEntry.html>

_S_e_e _A_l_s_o:

     'GtkComboBox'

