IUIAutomationSynchronizedInputPattern::StartListening-Methode (uiautomationclient.h)

  • Artikel

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

   
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)

Siehe auch

IUIAutomationSynchronizedInputPattern