XRun
The function XRun runs a Method on an ActiveX Control or .NET Control object.
| Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
|---|---|---|---|---|---|---|
| XRun | ActiveX and .NET Control | Asynchronous | Supported | ActiveX Controls only (see “Notes” below) | Supported | Not supported |
Syntax
XRun(strName,strMethod,Parameter1,…,ParameterN)
- strName
- The unique name of the ActiveX Control or .NET Control object, as specified in the Name box in the Object Properties dialog box.
- 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 box.
- 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
This function returns the Method result as reported by the ActiveX Control or .NET Control object. Not all Methods return results.
Notes
If the option Enforce Web functionality equivalence is selected in the project settings, this function cannot be called from Global Procedures or Script worksheets. This is because the function is meaningful only when it is executed on stations that display project screens; it might cause unexpected behavior if it is called from background tasks that are executed on the project runtime server. For more information, see Preferences tab.
Also, this function is not supported for .NET Control objects running on a Windows Embedded device.
Examples
XRun("ActXCir","XPos",FALSE,12,4.6,"This is my text.")
XRun("ActXCir","XPos",TagA,TagB,TagC,TagD)