XRun

This function runs a Method on an ActiveX Control or .NET Control object.

Function Group Execution Windows Embedded Thin Client
XRun ActiveX and .NET Control Asynchronous Supported ActiveX Controls only (see Notes) Supported

Syntax

XRun ( strName , strMethod , Parameter1 ,ParameterN)
strName
The unique name of the ActiveX Control or .NET Control object, as configured in the Name field of the Object Properties dialog.
strMethod
The Method that you want to run. Available Methods are listed in the Configuration (for an ActiveX Control) or Members (for a .NET Control) dialog.
Parameter(1…N)
Data of various types that are required by the Method to run. The number of parameters can range from 0 to 255 and depends on the specified Method. The data types (e.g., Boolean, Integer, Real or String) of referring tags must match the parameters on the Method.

Returned value

Returns the Method result as reported by the ActiveX Control or .NET Control object. Not all Methods return results.

Notes

This function cannot be used in Tasks or in the Global Procedures script. Also, this function is not supported for .NET Control objects running on a Windows Embedded station.

Examples

Run the XPos method on the ActiveX Control named "ActXCir," with four original values passed to the method:
XRun( "ActXCir", "XPos", FALSE, 12, 4.6, "This is my text." )
Run the XPos method on the ActiveX Control named "ActXCir," with four referring tags passed to the method:
XRun( "ActXCir", "XPos", TagA, TagB, TagC, TagD )