Chapter Contents

Previous

Next
Form Data Model: _getProperties

Form Data Model: _getProperties



Returns the current state


Syntax
Details

Syntax

CALL SEND (model-id, '_getProperties', list);

Argument Type Descriptionntains...
list
N specifies the identifier of an SCL list that will contain the model-specific properties


Details

The _getProperties method is used to save the model's state. The list returned can be sent to the _setProperties method or to the _new method.

When the viewer needs to save the most up-to-date information about the model on its MODEL_INFO list, you can call the _getProperties model method from the viewer's _getProperties method to provide that information. The _getProperties method is responsible for returning all model information. Note:Some of the items in the list are marked NOWRITE and are not written out when you execute a SAVELIST.

The _getProperties method fills in list with a copy of the instance variables of the model. Therefore, by default the _getProperties method for subclasses of the Form Data Model class saves any information on the subclass's instance variable list.

If there are items for the subclass that are not on the instance variable list but should be saved with the DATAFORM catalog entry, the subclass can still add these items to the list. To do so, the subclass of Form Data Model should override the _getProperties method by performing a CALL SUPER to the Form Data Model's _getProperties method.

The model's _setProperties method is then responsible for taking the items it needs from the list.


Chapter Contents

Previous

Next

Top of Page

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