IAccessible::accSelect

[This is preliminary documentation and subject to change.]

Modifies the selection or moves the keyboard focus according to the specified flags.

HRESULT accSelect(
  long flagsSelect,
  VARIANT varChild
);
 

Parameters

flagsSelect
[in] Value specifying how to change the current selection. This parameter can be a combination of the values from the SELFLAG enumerated type.
varChild
[in] Value identifying the child that will be selected. This parameter can be the child ID value (provided by the object), CHILDID_SELF for the object itself, or a string identifying the child (such as "A1").

Return Values

Returns S_OK if successful or one of the following values or a standard COM error code otherwise.

DISP_E_MEMBERNOTFOUND
E_INVALIDARG
S_FALSE

If the selection can't be placed at the requested location, the server fails the call and returns S_FALSE.

Applications can use this method to perform complex selection operations. For more information, see Selecting Child Objects.