updateDFBysPlot            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_c_a_t_t_e_r_p_l_o_t

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

     updateDFBysPlot is called by updateDF when initializing a
     gUpdateDataMessage object and the active view is a scatterplot. 
     updateDFBysPlot  determines the slot values for the new object by
     calling the function,  getChangeDFData.  Then updateDFBysPlot
     returns the slot  values in a list.

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

     updateDFBysPlot(viewObj, where)

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

 viewObj: a view object, inherited from genView 

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

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

     'updateDFBySpread', 'gUpdateDataMessage-class', 'getChangeDFData'

_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")
         # plotting the data should occur through Plot Data under 
         # the Display menu
         createView(type = "plotView", dataName = "USArrests", 
                    plotType = "sPlotView", dfRows = 1:nrow(USArrests), 
                    dfColumns = 1:2)  
         # now set the view mode
         setHighlightMode()

         # now click on a point on the plot and that will cause updateDFBysPlot
         # to be called - you can tell it was called because the data and
         # thus, the plot will change  
       }

