askToFind               package:iSPlot               R Documentation

_A_s_k_s _t_h_e _u_s_e_r _w_h_i_c_h _r_o_w _o_r _d_a_t_a _e_l_e_m_e_n_t _t_h_e_y _w_a_n_t _t_o _l_o_c_a_t_e _i_n _a _v_i_e_w

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

     askToFind opens a gtk window (using the function getFindInfo) 
     that asks the user which row or data element they want to locate 
     in the active view.  askToFind is meant to be called when the user
      chooses the menu item 'find' under the edit menu.  If the user
     enters  a valid row name or data element, then that row will be
     highlighted,  colored, identified, or hidden depending on the view
     mode.

_U_s_a_g_e:

     askToFind()
     getFindInfo()

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

     Elizabeth Whalen

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

     'updateControlWindow'

_E_x_a_m_p_l_e_s:

       if (interactive())
       {
         createControlWindow()
         # loading data should be performed through the menu item 'open data'
         data(USArrests)
         loadDFData(USArrests,"USArrests")
         # createView should be performed through the menu item 'plot data'
         createView(type = "plotView", dataName = "USArrests", 
                    plotType = "sPlotView", dfRows = 1:nrow(USArrests), 
                    dfColumns = 1:2)
         # make the view mode be highlight - this should be performed by
         # choosing the Highlight menu item under the ViewMode menu 
         setHighlightMode()
         # should choose 'find' under edit menu to call askToFind()
         askToFind()
         # then enter the name of a state such as 'Minnesota' in the text box, 
         # set Find based on to Row, and click ok
       }

