Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This class determines the state of an object. It saves and/or restores object property settings automatically or explicitly.
Category |
Application |
|---|---|
Default Catalog |
Visual FoxPro Catalog\Foundation Classes\Application |
Class |
_objectstate |
Base Class |
Custom |
Class Library |
_app.vcx |
Parent Class |
_custom |
Sample |
...\Samples\Solution\Ffc\environ.scx |
Remarks
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 Classesfor 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: none 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. |
See Also
Concepts
Guidelines for Using Visual FoxPro Foundation Classes
Reference
Visual FoxPro Foundation Classes A-Z