IUIAutomationSynchronizedInputPattern::StartListening Method
Causes the Microsoft UI Automation provider to start listening for mouse or keyboard input.
Syntax
HRESULT StartListening( SynchronizedInputType inputType );
Parameters
- inputType
[in] A combination of values from the SynchronizedInputType enumerated type specifying the type of input for which to listen.
Return Value
Returns S_OK if successful, or an error value otherwise.
Remarks
When matching input is found, the provider checks whether the target element matches the current element. If they match, the provider raises the UIA_InputReachedTargetEventId event; otherwise it raises the UIA_InputReachedOtherElementEventId or UIA_InputDiscardedEventId event.
After receiving input of the specified type, the provider stops checking for input and continues as normal.
If the provider is already listening for input, this method returns E_INVALIDOPERATION.
See Also