gUpdateViewMessage-class {iSPlot}R Documentation

Class "gUpdateViewMessage": A class to represent an update view message


gUpdateViewMessage is a class to represent an update view message. Thus, when either the controller or the model (i.e. the control window or the data) want to update the view(s), a gUpdateViewMessage object is created. gUpdateViewMessage is inherited from the class, gUpdateMessage, which inherits from the virtual class, gMessage. Whenever a gUpdateViewMessage is created (initialized), the next step is to call the handleMessage method to act upon that message and update the views.

Objects from the Class

Objects can be created by calls of the form new("gUpdateViewMessage", type, ...). When creating a gUpdateViewMessage, the type parameter can be one of the four following options: "add", "reset", "modify", or "delete". This parameter shows what type of update occurred on the data. If the type is "modify" or "delete", then an extra parameter is needed and this extra parameter is Rname to indicate which row names or indices have changed in the data.


the type of update to be performed, will be one of the following character strings: "updatePoint" or "replot"
the data needed to perform the update; if the type is "replot", then mData will be an empty list, if the type is "updatePoints", then mData will be a list with one element, Rname, to indicate which rows have changed


Class "gUpdateMessage", directly. Class "gMessage", by class "gUpdateMessage".


Depending on which data set was changed, it updates any views (plots or spreadsheets) that depend on that data by calling the functions, updatePlots and updateSpread
Creates a gUpdateViewMessage object


Elizabeth Whalen

See Also

updatePlots, updateSpread, gMessage-class, gUpdateMessage-class, gUpdateDataMessage-class


  if (interactive())
    # should load data through Open Data or Open File under the File menu
    # 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)    
    # should modify using the control window (by choosing the view mode and
    # then clicking on a plot)
    # by interacting with a plot when the view mode is color, these 
    # functions will be called automatically
    modify("USArrests", Rname=c("Massachusetts","Ohio"), 
           Cname=c("color","color"), data=c("red","green")) 
    # create an update view message and then dispatch it so the points
    # that have changed will be replot

    # now see if the message is inherited from gMessage

[Package iSPlot version 1.0.3 Index]