AX_TKSET

Set a property for an ActiveX control

xcall AX_TKSET(tk_container_id, property, new_value)

Arguments

tk_container_id

The window ID for the ActiveX control’s Toolkit container. (n)

property

The name of the property to access. For supported properties, see Published properties for ActiveX Toolkit lists and Properties for ActiveX objects. (a)

new_value

The new value for the property. (a or n)

Discussion

AX_TKSET enables you to set an ActiveX control’s properties by passing the Toolkit container ID. You can use this subroutine only if you used %AX_TKSINGLE or %GRID_CREATE to create the container and load the control. (If you used %AX_TKWIN to create the container, you must use AX_SET in the Synergy ActiveX API.)

Make sure the data type of new_value has meaning within the context of the specified property. If it doesn’t (for example, if you specify an alpha string for a numeric property), the results are undefined.

Rather than making multiple calls to AX_TKSET to set properties for the same control, use %AX_TKCTLID to get the ActiveX control ID, and then use AX_GET to get the properties. AX_TKSET is convenient (because you don’t need the control ID), but it calls AX_SET, so it’s not as efficient.

On Unix, a call to this routine will cause an error. On OpenVMS, this routine is ignored.