GETOBJECT

Purpose:

Returns a handle to a running ActiveX server object.

Syntax:

GETOBJECT("objname")

"objname"

A string, the name of the ActiveX object.

Returns:

A handle to the running object or –1 if an error occurs.

Example:

Word = getobject("word.application");

Word.visible = 1;

Connects to the running MS word as an ActiveX server and makes Word visible.

Remarks:

GETOBJECT connects to a running ActiveX object as a server. Once connected, any methods or properties supported by the object can be invoked, set or queried. Use CREATEOBJECT to connect to a server that is not already running.

If objname is unspecified, GETOBJECT connects to the current running instance of DADiSP. For example:

dadisp = getobject();

dadisp.getdata("version")

Displays the current version of the running DADiSP.

Each running instance of DADiSP registers a unique name so that an ActiveX client can connect to a specific instance. The name is of the form:

DADiSP Automation Server:pid

Where pid is an integer, the process identification number. For example:

DADiSP = getobject("DADiSP Automation Server:1748");

connects to the running instance of DADiSP with process id 1748. See GETEXENAME to return the automation server name.

A simple procedure to connect one running instance of DADiSP with another:

In DADiSP 1:

copydata(getexename(2));

In DADiSP 2:

dadisp1 = getobject(pastedata(3));