The wpSetupOnce method is called during initial object creation following wpInitData and the creation of the persistent image. It is not called when an object is awakened from dormancy. The primary purpose of wpSetupOnce is to:

• Call wpSetup to set the object characteristics and behaviors based on the setup string input to WinCreateObject.

• Perform non-setup string initialization that cannot be done during the wpInitData processing.

The non-setup string initialization may have been deferred because it required existence of the persistent image or because it was data other than instance data that required initialization. Override wpSetupOnce only if your class has non-setup string initialization to perform because WPObject wpSetupOnce calls wpSetup. Override wpSetup if your object class has defined unique setup string keywords or keyword values.

The wpSetup method is also invoked as a result of WinSetObjectData being called on an existing object. The wpScanSetupString method exists as a helper routine for parsing values from the setup string.