LOTUSSCRIPT LANGUAGE
Creates an OLE Automation object of the specified class.
Note CreateObject is not supported under OS/2 or UNIX. It is supported on the Macintosh as long as OLE support is installed.
Syntax
CreateObject ( className )
Elements
className
The appName is an application that supports OLE Automation.
The appClass is the class of the object to create. Products that support OLE Automation provide one or more classes. See the product documentation for details.
CreateObject returns a reference to an OLE Automation object.
Usage
Use the Set statement to assign the object reference returned by CreateObject to a Variant variable.
If the application is not already running, CreateObject starts it before creating the OLE Automation object. References to the object remain valid only while the application is running. If the application terminates while you are using the object reference, LotusScript raises a run-time error.
LotusScript supports the OLE vartypes listed in the table below. Only an OLE method or property can return a vartype designated as "OLE only."
LotusScript supports passing arguments to OLE properties. For example:
' Set v.prop to 4; v.prop takes two arguments. v.prop(arg1, arg2) = 4
LotusScript does not support identifying arguments for OLE methods or properties by name rather than by the order in which they appear, nor does LotusScript support using an OLE name by itself (without an explicit property) to identify a default property.
Results are unspecified for arguments to OLE methods and properties of type boolean, byte, and date that are passed by reference. LotusScript does not support these data types.
The word CreateObject is not a LotusScript keyword.
Example See Also