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)  
Web Studio Help pics2ffunctions activex xrun.xml d398789e134 XRun
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

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)  

XRun