updateSpread {iSPlot}R Documentation

Update any Views that are Spreadsheets


updateSpread is called by the handleMessage method for a gUpdateViewMessage object. If only certain rows need to be updated in the spreadsheet, then the updated information will be placed in only those rows. Otherwise, the whole spreadsheet is redrawn. To tell if only certain rows need to be updated, updateSpread looks at the length of the data parameter. data is expected to be a list with a Rname element, that pertains to row names or indices that need to be updated. data will be a list of length zero if the whole spreadsheet should be redrawn.


updateSpread(curDataName, spreadIndex, data)


curDataName the data set name
spreadIndex the index of the spreadsheet in viewList that needs to be updated - only one spreadsheet can be updated at a time because each data set can only be represented in one spreadsheet
data a list of length zero if the spreadsheet should be redrawn or a list with a Rname element to indicate which rows should be updated


Elizabeth Whalen

See Also

gUpdateViewMessage-class, getRowDataFromDF, createView


  if (interactive())
    # should load data through Open Data or Open File under the File menu
    # creating a spreadsheet should occur through View Data under 
    # the Display menu
    createView(type = "spreadView", dataName = "USArrests") 
    # should set the view mode using the View Mode menu
    # now click on a row in the spreadsheet and that will cause 
    # updateSpread to be called - you can tell it was called because the 
    # data and thus, the spreadsheet will change  

[Package iSPlot version 1.0.3 Index]