Type Library

The type library defines the object type to be used. Select the type library by zooming from this property to browse through the objects registered in the current machine and select the type library of the object.

When this property and the Object name property are set and the field definition is confirmed, the Object name cannot be modified. The type library can be modified only to a different version of the already selected type library.

See also How Do I Change a Reference to a Certain COM Object?

Object Name

This property specifies the actual object within the type library. The type library may support several type of objects.

Zoom to select the object name after you have selected the type library. The list of objects displays all the objects supported by the selected type library.

When this property and the Type Library property are set and the field definition is confirmed, the Object name cannot be modified. The type library can be modified only to a different version of the already selected type library.

Sub-Object Name

Some objects are constructed by a hierarchy of sub-objects. If the object you selected has sub-objects, you can zoom from this property to select the sub-object.

For example, the object worksheet in Microsoft Excel. This property is only enabled when the Object Name is specified. Select a sub-object by zooming to the COM object tree display.

Use the sub-object field to store references of the sub-object as it may be retrieved at runtime.

Some COM objects include Collection Type sub-objects. A collection item is usually retrieved from an ID field. You can use the MGItemSequential internal method to retrieve an item from the collection by specifying its sequential index.

Stored Data

Specifies how the data is stored by Magic xpa. The options are:

Object – The field stores the handle of the object and the object's persistent data.

Reference – The field only stores the handle of the object.

Instantiation

This property specifies whether the COM object should be automatically instantiated by Magic xpa.

When this property is set to Automatic, Magic xpa automatically instantiates the object as the task is opened and releases the object as the task closes.

When this property is set to None, you can create or release the object manually by using the COMObjCreate and COMObjRelease functions.

If this property is disabled, you cannot create the object manually.

Remote Host

You can define a DCOM object instantiated on a specified remote host machine by entering the Host IP or Host Name. The remote host can be set by a regular string, logical name, or secret name. The property default value is blank. If the remote host is not specified, the object is instantiated according to the object’s settings on the running operating system.