Share via

IInvokeProvider::Invoke-Methode (uiautomationcore.h)

  • Artikel

Sendet eine Anforderung zum Aktivieren eines Steuerelements und Initiieren der einzelnen eindeutigen Aktion.

Syntax

HRESULT Invoke();

Rückgabewert

Typ: HRESULT

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

Hinweise

IInvokeProvider::Invoke ist ein asynchroner Aufruf und muss sofort ohne Blockierung zurückgegeben werden.

Hinweis Dies ist besonders wichtig für Steuerelemente, die direkt oder indirekt einen modale Dialog starten, wenn sie aufgerufen werden. Jeder Microsoft UI Automation-Client, der das Ereignis ausgelöst hat, bleibt blockiert, bis das modale Dialogfeld geschlossen wird.
 
IInvokeProvider::Invoke löst nach Möglichkeit das Invoked-Ereignis aus, nachdem das Steuerelement seine zugeordnete Aktion abgeschlossen hat.

Das Ereignis sollte ausgelöst werden, bevor die Invoke-Anforderung in den folgenden Szenarien gewartet wird:

  • Es ist nicht möglich oder zweckmäßig, bis zum Abschluss der Aktion zu warten.
  • Die Aktion erfordert eine Benutzeraktion.
  • Die Aktion ist zeitaufwändig und führt dazu, dass der aufrufende Client für einen erheblichen Zeitraum blockiert wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile uiautomationcore.h (include UIAutomation.h)
DLL Uiautomationcore.dll

Weitere Informationen

IInvokeProvider

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter