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 )