Set a property in an ActiveX object
|
WSupported on Windows
|
|
|
|
xcall AX_SET(id, property, new_value[, parameters])
or
return = %AX_SET(id, property, new_value[, parameters])
Return value
return
Always returns 1. (i)
Arguments
id
The ID of the container or control for which you’re setting a property. (D_HANDLE)
property
A string that contains the name of the property to access. See Properties for ActiveX objects for information about supported properties. (a)
new_value
The new value for the property. (a or n)
parameters
(optional) Up to eight additional parameters required by a property. (n)
Discussion
It is the caller’s responsibility to ensure that the data type of new_value has meaning within the context of the specified property. If it does not (for example, if you specify an alpha string for a numeric property), the results are undefined.
We recommend that you XCALL AX_SET instead of accessing it as a function.
Some controls support indexed properties, which are stored as arrays in a control and have one or more indices. If the property is an indexed property, parameters must be the index values of the array element to reference. The user documentation for a given control should specify when a property is indexed.
The parameters argument can only pass integer parameters. It cannot be used to pass additional parameters for a property that expects alpha parameters.
Examples
See Sample program.
