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.
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 |