tk_select.list             package:tcltk             R Documentation

_S_e_l_e_c_t _I_t_e_m_s _f_r_o_m _a _L_i_s_t

_D_e_s_c_r_i_p_t_i_o_n:

     Select item(s) from a character vector using a Tk listbox.

_U_s_a_g_e:

     tk_select.list(list, preselect = NULL, multiple = FALSE, title = NULL)

_A_r_g_u_m_e_n_t_s:

    list: character. A list of items.

preselect: a character vector, or 'NULL'.  If non-null and if the
          string(s) appear in the list, the item(s) are selected
          initially.

multiple: logical: can more than one item be selected?

   title: optional character string for window title.

_D_e_t_a_i_l_s:

     This is a version of 'select.list' implemented as a Tk list box
     plus 'OK' and 'Cancel' buttons.  There will be a scrollbar if the
     list is too long to fit comfortably on the screen.

     The dialog box is _modal_, so a selection must be made or
     cancelled before the R session can proceed.

     If Tk is version 8.5 or later, themed widgets will be used.

_V_a_l_u_e:

     A character vector of selected items.  If 'multiple' is false and
     no item was selected (or 'Cancel' was used), '""' is returned.  
     If 'multiple' is true and no item was selected (or 'Cancel' was
     used) then a character vector of length 0 is returned.

_S_e_e _A_l_s_o:

     'select.list' (a text version except on Windows), 'menu' (whose
     'graphics=TRUE' mode uses this on most Unix-alikes.