wpCreateFromTemplate
This instance method is called to create an object from a template.
Syntax
_wpCreateFromTemplate(somSelf, folder, fLock)
Parameters
- somSelf (WPObject *) - input
- Pointer to the object on which the method is being invoked.
- Points to an object of class WPObject.
- folder (WPFolder *) - input
- Pointer to a Folder object in which to place the new object. This pointer can be determined by issuing a call to the wpclsQueryFolder method.
- fLock (BOOL) - input
- Lock object flag.
- If this flag is **FALSE**, the newly created object will be made dormant whenever the object and the folder containing the object are closed.
- If this flag is **TRUE**, the new flag will remain active until the caller issues the wpUnlockObject method on it.
Returns
- rc (WPObject *) - returns
- Pointer to the new object.
- A return value of **NULL** indicates that an error occurred.
How to Override
This method is generally not overridden.
Usage
This method can be called at any time in order to create a new object from a template object.
Remarks
The new object will be an identical copy of the template object except that the `OBJSTYLE_TEMPLATE` object style will be taken out. wpCopiedFromTemplate will be called on the new object.
Example Code
#define INCL_WINWORKPLACE
#include <os2.h>
WPObject *somSelf; /* Pointer to the object on which the method is being invoked. */
WPFolder *folder; /* Pointer to a Folder object. */
BOOL fLock; /* Lock object flag. */
WPObject *rc; /* Pointer to the new object. */
rc = _wpCreateFromTemplate(somSelf, folder,
fLock);