CallAxMethod - method of object Pm

Description:

Allows calling ActiveX object methods from JavaScript (input/output parameters, VBArray, etc.). ActiveX uses VBScript data types and conventions, but this method adapts JavaScript to be usable..

Syntax:

CallAxMethod(sReserved, oAxObject, sAxMethod, arglist)

Calling:

var r = Pm.CallAxMethod("", oAxObject, sAxMethod, arglist)

Parameters:

sReserved	(String) Reserved. An empty string ("") must be here.
oAxObject	(Object) Reference to ActiveX object.
sAxMethod	(String) Name of called method.
arglist	(Variant) A variable number of parameters follows. These parameters are passed to the method called in the ActiveX object. The parameters are are passed as input paramater value. If there is PmArray among these paramaters then it is automatically converted into VBArray.

Return Values:

The value returned by called ActiveX method. If the ActiveX returned VBArray then this array is automatically converted into PmArray.

Note:

VBScript and ActiveX support input/output parameters while JavaScript does not support such parameters. The method CallAxMethod allows passing of input/output parameter to the ActiveX method by auxiliary object PmMap as follows:

1) The PmMap auxiliary object is created.

2) The property ParValue in the auxiliary object is set to the first value of the input parameter (both steps 1 and 2 can be completed together by the PmMap.mapAdd method).

3) The reference to the auxiliary object is passed insted of the original parameter by calling the CallAxMethod method.

4) The output parameter value is read from the property ParValue.

Caution! If the input parameter is represented by PmArray then this array is automatically converted into VBArray. If the output parameter is represented by VBArray then this array is automatically converted into PmArray.

Example:

An example of calling the DBGetInfo method of ActiveX object AtouchX for communication with AMiT devices, where the requested input/output value (mInfo) is of the VBArray type.

Promotic