Partager via


IInvokeProvider::Invoke, méthode (uiautomationcore.h)

Envoie une requête pour activer un contrôle et initier son action unique et non équivoque.

Syntaxe

HRESULT Invoke();

Valeur de retour

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

IInvokeProvider::Invoke est un appel asynchrone qui doit être retourné immédiatement sans blocage.

Note Cela est particulièrement essentiel pour les contrôles qui, directement ou indirectement, lancent une boîte de dialogue modale lorsqu’ils sont appelés. Tout client Microsoft UI Automation à l’origine de l’événement reste bloqué jusqu’à ce que la boîte de dialogue modale soit fermée.
 
IInvokeProvider::Invoke déclenche l’événement Invoked une fois que le contrôle a terminé son action associée, si possible.

L’événement doit être déclenché avant de traiter la demande Invoke dans les scénarios suivants :

  • Il n’est pas possible ou pratique d’attendre que l’action soit terminée.
  • L’action requiert une intervention de l’utilisateur.
  • L’action prend beaucoup de temps et entraîne le blocage du client appelant pendant une durée significative.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête uiautomationcore.h (incluez UIAutomation.h)
DLL Uiautomationcore.dll

Voir aussi

IInvokeProvider

Vue d'ensemble des fournisseurs UI Automation