ISynchronizedInputProvider::StartListening-Methode (uiautomationcore.h)

  • Artikel

Beginnt mit dem Lauschen auf Eingaben des angegebenen Typs.

Syntax

HRESULT StartListening(
  [in] SynchronizedInputType inputType
);

Parameter

[in] inputType

Typ: SynchronizedInputType

Der Typ der Eingabe, die zur Synchronisierung angefordert wird.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn die übereinstimmende Eingabe gefunden wird, überprüft der Anbieter, ob das Zielelement Benutzeroberflächenautomatisierung mit dem aktuellen Element übereinstimmt. Wenn sie übereinstimmen, löst der Anbieter das UIA_InputReachedTargetEventId-Ereignis aus. Andernfalls wird das UIA_InputReachedOtherElementEventId- oder UIA_InputDiscardedEventId-Ereignis ausgelöst. Der Benutzeroberflächenautomatisierung Anbieter muss die Eingabe verwerfen, wenn es sich um ein anderes Element als dieses handelt.

Dies ist eine One-Shot-Methode; nach dem Empfang der Eingabe beendet der Anbieter die Überwachung und setzt den Vorgang normal fort.

Diese Methode gibt E_INVALIDOPERATION zurück, wenn der Anbieter bereits auf Eingaben lauscht.

Anforderungen

Anforderung Wert
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 [Desktop-Apps | UWP-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 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile uiautomationcore.h (uiAutomation.h einschließen)

Weitere Informationen

ISynchronizedInputProvider