ISelectionProvider::IsSelectionRequired Property

Gets a value that specifies whether the UI Automation provider requires at least one child element to be selected.

Syntax

HRESULT ISelectionProvider::get_IsSelectionRequired(BOOL *pRetVal);

Parameters

  • pRetVal
    The address of a variable that receives TRUE if a selection is required; otherwise FALSE. This parameter is passed uninitialized.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This property can be dynamic. For example, the initial state of a control might not have any items selected by default, meaning that ISelectionProvider::IsSelectionRequired is false. However, after an item is selected the control must always have at least one item selected.

See Also

UI Automation Providers Overview