updateDFBySpread {iSPlot} | R Documentation

## Determines values needed to initialize a gUpdateDataMessage object if the current view is a spreadsheet

### Description

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.

### Usage

    updateDFBySpread(viewObj, where, ...)

### Arguments

`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"

### Value

`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

### Author(s)

Elizabeth Whalen

### See Also

`updateDFBysPlot`, `gUpdateDataMessage-class`

### Examples

      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
      }

[Package iSPlot version 1.0.7 Index]