| Category | Application |
| Default Catalog | Visual FoxPro Catalog\Foundation Classes\Application |
| Class | _objectstate |
| Base Class | Custom |
| Class Library | _app.vcx |
| Parent Class | _custom |
| Sample | ...\Samples\Vfp98\Solution\Ffc\environ.scx |
Remarks
This class determines the state of an object. It saves and/or restores object property settings automatically or explicitly.
To use, drop the class on a project or form or, from the Component Gallery Item Shortcut menu, select Add to Project or Add to Form. When you add the class to a form, provide any necessary input and output objects. When you drop the class on a project, you can choose between adding the class or creating a subclass.
See Guidelines for Using Visual FoxPro Foundation Classes for more information on using foundation classes.
| Properties, Events, Methods | Description |
| aProperties[1,3] property | The array for saving/restoring properties of oObject. Default: .F. |
| lAutomatic property | Specifies whether oObject properties are saved and restored. If this attribute is true (.T.), the _ObjectState object will restore all the attributes you've saved for its target object when the _ObjectState object is destroyed. Default: .F. |
| oObject | Reference to the target object whose state is being saved. Default: .NULL. |
| Restore method | Restores the value of a property for oObject if the value has changed. If tcWhichProperty is not passed, all saved properties of oObject are restored. (This method is called with no argument in the _ObjectState.Destroy( ) event when _ObjectState.lAutomatic is true (.T.). Syntax: Restore(tcWhichProperty) Return: tcSave Arguments: tcWhichProperty specifies the property to be restored. tcSave specifies the value to be restored. |
| Save method | Saves the current value of a property for oObject. You can use this instead of the tlSave argument of the Set method. Syntax: Save(tcProperty, tcTypeValue) Return: none Arguments: tcProperty specifies the property being accessed. tcTypeValue specifies the value being saved for tcProperty. |
| Set method | Sets a property to a new value for oObject. Syntax: Set(tcProperty, tvValue, tlSave) Return: Arguments: tcProperty specifies the property to set. tvValue specifies the value tcProperty is to be set to. tlSave specifies whether the current value is retained for later restoration. |