Chapter Contents

Previous

Next

Form Data Model: _setProperties

Argument	Type	Description
list	N	specifies the identifier of an SCL list that contains the model-specific properties returned from a previous _getProperties call

Details

The _setProperties method is called from the form data model's _setEntry method and the viewer's _attach method. Optionally, the _setProperties method also is called from the _writeEntryFromList method. The _setProperties method retrieves from the list all of the information it recognizes and updates the model appropriately.

Call the _setProperties list with a list returned from a previous call to _getProperties on a model. These methods can save and restore a model's state.

The _setProperties method copies list into its instance variables list. Therefore, by default the _setProperties method for subclasses of the Form Data Model class copies the list into the subclass's instance variable list. The _setProperties model method checks for items that may have changed and does the necessary updates. For example, if the list that is passed to _setProperties at the Form Data Model level contains an item called SOURCE, the _setSource method is called to ensure that the model is updated to use the new source entry.

Additional information besides instance variables in the list can occur if the subclass of the Form Data Model class overrides the _getProperties method to insert items that are not instance variables. In this case, the _setProperties method of the subclass should check for this additional information as well as check for the appropriate instance variables.

Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.