DspAnCreateControlObject

Creates a new instance of an ActiveX object. If the object already exists for the given Animation Point Number, then that object will be used, that is a new object will not be created, the existing object will merely be refreshed.

AN object created using this function remains in existence until the page is closed or the associated Cicode Object is deleted.

Syntax

DspAnCreateControlObject(nAN, sClass, Width, Height [, sEventClass] )

nAN:

The animation-point number.

sClass:

The class of the object. You can use the object's human readable name, its program ID, or its GUID. If the class does not exist, the function will return an error.

For example:

• "Calendar Control 8.0" - human readable name

• "MSCAL.Calendar.7" - Program ID

• "{8E27C92B-1264-101C-8A2F-040224009C02}" - GUID

Width:

The width of the ActiveX object.

Height:

The height of the ActiveX object.

sEventClass:

The string you would like to use as the event class for the object.

Return Value

The newly created object, if successful, otherwise an error is generated.

Related Functions

CreateObject, CreateControlObject

Example

See CreateControlObject.

See Also

Display Functions