XSet
The function XSet sets the value of a Property on an ActiveX Control or .NET Control object.
| Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
|---|---|---|---|---|---|---|
| XSet | ActiveX and .NET Control | Asynchronous | Supported | ActiveX Controls only (see “Notes” below) | Supported | Not supported |
Syntax
XSet(strName,strProperties,Value)
- strName
- The unique name of the ActiveX Control or .NET Control object, as specified in the Name box in the Object Properties dialog box.
- strProperties
- The Property that you want to set the value of. Available Properties are listed in the Configuration (for an ActiveX Control) or Members (for a .NET Control) dialog box.
- Value
- A tag, expression, or data value of any type; the value to which you want to set the Property.
Returned value
This function does not return any value.
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
Set the value of the Display property on the ActiveX Control named “ActXDisplay” to “Status Normal”:
XSet("ActXDisplay","Display","Status Normal")