IUIAutomationSynchronizedInputPattern::StartListening-Methode (uiautomationclient.h)

Bewirkt, dass der Microsoft-Benutzeroberflächenautomatisierungsanbieter mit dem Lauschen auf Maus- oder Tastatureingaben beginnt.

Syntax

HRESULT StartListening(
  [in] SynchronizedInputType inputType
);

Parameter

[in] inputType

Typ: SynchronizedInputType

Eine Kombination von Werten, die den Typ der zu überwachenden Eingabe angeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Bemerkungen

Wenn eine übereinstimmende Eingabe gefunden wird, überprüft der Anbieter, ob das Zielelement mit dem aktuellen Element übereinstimmt. Wenn sie übereinstimmen, löst der Anbieter das UIA_InputReachedTargetEventId-Ereignis aus. Andernfalls löst es das UIA_InputReachedOtherElementEventId- oder UIA_InputDiscardedEventId-Ereignis aus.

Nach dem Empfang der Eingabe des angegebenen Typs beendet der Anbieter die Überprüfung auf Eingabe und fährt wie gewohnt fort.

Wenn der Anbieter bereits auf Eingabe lauscht, gibt diese Methode E_INVALIDOPERATION zurück.

Anforderungen

Siehe auch

IUIAutomationSynchronizedInputPattern