Get a property value for an ActiveX object
|
WSupported on Windows
|
|
|
|
xcall AX_GET(id, property, current_value[, parameters])
or
return = %AX_GET(id, property, current_value[, parameters])
Return value
return
Always returns 1. (i)
Arguments
id
The ID of the container or control for which you’re getting 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)
current_value
A field that will be loaded with the current value for the property. (a)
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 current_value has meaning within the context of the specified property. If it does not, the results are undefined.
We recommend that you XCALL AX_GET 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.
