updateDFBySpread           package:iSPlot           R Documentation

_D_e_t_e_r_m_i_n_e_s _v_a_l_u_e_s _n_e_e_d_e_d _t_o _i_n_i_t_i_a_l_i_z_e _a _g_U_p_d_a_t_e_D_a_t_a_M_e_s_s_a_g_e _o_b_j_e_c_t _i_f _t_h_e _c_u_r_r_e_n_t _v_i_e_w _i_s _a _s_p_r_e_a_d_s_h_e_e_t

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

     updateDFBySpread is called by updateDF when initializing a
     gUpdateDataMessage object and the active view is a spreadsheet. 
     updateDFBySpread determines  the slot values for the new object by
     determining if a select or unselect event just occurred.  Event
     information is contained in the 'dots' parameter.  Then
     updateDFBySpread returns the slot values in a list.

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

     updateDFBySpread(viewObj, where, ...)

_A_r_g_u_m_e_n_t_s:

 viewObj: a view object, inherited from class genView 

   where: where the data will change (for instance it could be a row
          name or index) 

     ...: the event information, can be either "select" or "unselect" 

_V_a_l_u_e:

    type: the type of change, can be "add", "delete", "modify", or
          "reset"

   mData: the new data needed to update the data set 

      to: which data set to update

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

     Elizabeth Whalen

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

     'updateDFBysPlot', 'gUpdateDataMessage-class'

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

       if (interactive())
       {
         createControlWindow()
         # should load data through Open Data or Open File under the File menu
         data(USArrests)
         loadDFData(USArrests,"USArrests")
         # creating a spreadsheet should occur through View Data under
         # the Display menu
         createView(type = "spreadView", dataName = "USArrests")
         # should set highlight mode using the Highlight menu item under ViewMode
         setHighlightMode()
         # now click on a row of the spreadsheet
         # this will cause updateDF and updateDFBySpread to be called
         # you can tell it was called because the data for that row will now
         # have highlit set to TRUE  
       }

