Interface IUIAutomation (uiautomationclient.h)
Expose les méthodes qui permettent aux applications clientes Microsoft UI Automation de découvrir, d’accéder et de filtrer les éléments UI Automation. UI Automation expose chaque élément du UI Automation en tant qu’objet représenté par l’interface IUIAutomation. Les membres de cette interface ne sont pas spécifiques à un élément particulier.
Héritage
L’interface IUIAutomation hérite de l’interface IUnknown . IUIAutomation a également les types de membres suivants :
Méthodes
L’interface IUIAutomation possède ces méthodes.
| IUIAutomation ::AddAutomationEventHandler Inscrit une méthode qui gère les événements Microsoft UI Automation. Remarque Avant d’implémenter un gestionnaire d’événements, vous devez être familiarisé avec les problèmes de threads décrits dans Présentation des problèmes liés aux threads. |
| IUIAutomation ::AddFocusChangedEventHandler Inscrit une méthode qui gère les événements de modification du focus. Remarque Avant d’implémenter un gestionnaire d’événements, vous devez être familiarisé avec les problèmes de threads décrits dans Présentation des problèmes liés aux threads. |
| IUIAutomation ::AddPropertyChangedEventHandler Inscrit une méthode qui gère et un tableau d’événements modifiés par des propriétés. |
| IUIAutomation ::AddPropertyChangedEventHandlerNativeArray Inscrit une méthode qui gère un tableau natif d’événements modifiés par des propriétés. |
| IUIAutomation ::AddStructureChangedEventHandler Inscrit une méthode qui gère les événements de modification de structure. Remarque Avant d’implémenter un gestionnaire d’événements, vous devez être familiarisé avec les problèmes de threads décrits dans Présentation des problèmes liés aux threads. |
| IUIAutomation ::CheckNotSupported Vérifie un VARIANT fourni pour voir s’il contient l’identificateur Non pris en charge. |
| IUIAutomation ::CompareElements Compare deux éléments UI Automation pour déterminer s’ils représentent le même élément d’interface utilisateur sous-jacent. |
| IUIAutomation ::CompareRuntimeIds Compare deux tableaux d’entiers contenant des identificateurs d’exécution (ID) pour déterminer si leur contenu est identique et s’ils appartiennent au même élément d’interface utilisateur. |
| IUIAutomation ::CreateAndCondition Crée une condition qui sélectionne les éléments qui correspondent aux deux conditions. |
| IUIAutomation ::CreateAndConditionFromArray Crée une condition qui sélectionne des éléments en fonction de plusieurs conditions, qui doivent toutes avoir la valeur true. |
| IUIAutomation ::CreateAndConditionFromNativeArray Crée une condition qui sélectionne des éléments d’un tableau natif, en fonction de plusieurs conditions qui doivent toutes être vraies. |
| IUIAutomation ::CreateCacheRequest Crée une demande de cache. |
| IUIAutomation ::CreateFalseCondition Crée une condition qui est toujours false. |
| IUIAutomation ::CreateNotCondition Crée une condition qui est la condition négative d’une condition spécifiée. |
| IUIAutomation ::CreateOrCondition Crée une combinaison de deux conditions où une correspondance existe si l’une des conditions est vraie. |
| IUIAutomation ::CreateOrConditionFromArray Crée une combinaison de deux conditions ou plus où une correspondance existe si l’une des conditions est vraie. |
| IUIAutomation ::CreateOrConditionFromNativeArray Crée une combinaison de deux conditions ou plus où une correspondance existe si l’une des conditions est vraie. |
| IUIAutomation ::CreatePropertyCondition Crée une condition qui sélectionne les éléments qui ont une propriété avec la valeur spécifiée. |
| IUIAutomation ::CreatePropertyConditionEx Crée une condition qui sélectionne les éléments qui ont une propriété avec la valeur spécifiée, à l’aide d’indicateurs facultatifs. |
| IUIAutomation ::CreateProxyFactoryEntry Crée une instance d’un objet de fabrique de proxy. |
| IUIAutomation ::CreateTreeWalker Récupère un objet tree walker qui peut être utilisé pour parcourir l’arborescence Microsoft UI Automation. |
| IUIAutomation ::CreateTrueCondition Récupère une condition prédéfinie qui sélectionne tous les éléments. |
| IUIAutomation ::ElementFromHandle Récupère un élément UI Automation pour la fenêtre spécifiée. |
| IUIAutomation ::ElementFromHandleBuildCache Récupère un élément UI Automation pour la fenêtre spécifiée, préfète les propriétés et les modèles de contrôle demandés, et stocke les éléments prédéfinis dans le cache. |
| IUIAutomation ::ElementFromIAccessible Récupère un élément UI Automation pour l’objet accessible spécifié à partir d’un serveur Microsoft Active Accessibility. |
| IUIAutomation ::ElementFromIAccessibleBuildCache Récupère un élément UI Automation pour l’objet accessible spécifié à partir d’un serveur Microsoft Active Accessibility, prééches les propriétés et les modèles de contrôle demandés, et stocke les éléments prédéfinis dans le cache. |
| IUIAutomation ::ElementFromPoint Récupère l’élément UI Automation au point spécifié sur le bureau. |
| IUIAutomation ::ElementFromPointBuildCache Récupère l’élément UI Automation au point spécifié sur le bureau, préfaitise les propriétés et les modèles de contrôle demandés, et stocke les éléments prédéfinis dans le cache. |
| IUIAutomation ::get_ContentViewCondition Récupère une interface IUIAutomationCondition prédéfinie qui sélectionne les éléments de contenu. |
| IUIAutomation ::get_ContentViewWalker Récupère une interface IUIAutomationTreeWalker utilisée pour découvrir les éléments de contenu. |
| IUIAutomation ::get_ControlViewCondition Récupère une interface IUIAutomationCondition prédéfinie qui sélectionne les éléments de contrôle. |
| IUIAutomation ::get_ControlViewWalker Récupère une interface IUIAutomationTreeWalker utilisée pour découvrir les éléments de contrôle. |
| IUIAutomation ::get_ProxyFactoryMapping Récupère un objet qui représente le mappage des noms de classe Window et des données associées à des fabriques de proxy individuelles. |
| IUIAutomation ::get_RawViewCondition Récupère une interface IUIAutomationCondition prédéfinie qui sélectionne tous les éléments d’interface utilisateur dans une vue non filtrée. |
| IUIAutomation ::get_RawViewWalker Récupère un objet tree walker utilisé pour parcourir une vue non filtrée de l’arborescence Microsoft UI Automation. |
| IUIAutomation ::get_ReservedMixedAttributeValue Récupère un objet de jeton statique représentant un attribut de texte qui est un attribut mixte. |
| IUIAutomation ::get_ReservedNotSupportedValue Récupère un objet de jeton statique représentant une propriété ou un attribut de texte qui n’est pas pris en charge. |
| IUIAutomation ::GetFocusedElement Récupère l’élément UI Automation qui a le focus d’entrée. |
| IUIAutomation ::GetFocusedElementBuildCache Récupère l’élément UI Automation qui a le focus d’entrée, préfète les propriétés et les modèles de contrôle demandés, et stocke les éléments prédéfinis dans le cache. |
| IUIAutomation ::GetPatternProgrammaticName Récupère le nom par programme inscrit d’un modèle de contrôle. |
| IUIAutomation ::GetPropertyProgrammaticName Récupère le nom par programme inscrit d’une propriété. |
| IUIAutomation ::GetRootElement Récupère l’élément UI Automation qui représente le bureau. |
| IUIAutomation ::GetRootElementBuildCache Récupère l’élément UI Automation qui représente le bureau, préfète les propriétés et les modèles de contrôle demandés, et stocke les éléments prédéfinis dans le cache. |
| IUIAutomation ::IntNativeArrayToSafeArray Convertit un tableau d’entiers en SAFEARRAY. |
| IUIAutomation ::IntSafeArrayToNativeArray Convertit un SAFEARRAY d’entiers en tableau. |
| IUIAutomation ::P ollForPotentialSupportedPatterns Récupère les modèles de contrôle qui peuvent être pris en charge sur un élément UI Automation. |
| IUIAutomation ::P ollForPotentialSupportedProperties Récupère les propriétés qui peuvent être prises en charge sur un élément UI Automation. |
| IUIAutomation ::RectToVariant Crée un VARIANT qui contient les coordonnées d’un rectangle. |
| IUIAutomation ::RemoveAllEventHandlers Supprime tous les gestionnaires d’événements Microsoft UI Automation inscrits. |
| IUIAutomation ::RemoveAutomationEventHandler Supprime le gestionnaire d’événements UI Automation spécifié. |
| IUIAutomation ::RemoveFocusChangedEventHandler Supprime un gestionnaire d’événements avec changement de focus. |
| IUIAutomation ::RemovePropertyChangedEventHandler Supprime un gestionnaire d’événements modifié par des propriétés. |
| IUIAutomation ::RemoveStructureChangedEventHandler Supprime un gestionnaire d’événements modifié par une structure. |
| IUIAutomation ::SafeArrayToRectNativeArray Convertit un SAFEARRAY contenant des coordonnées de rectangle en tableau de type RECT. |
| IUIAutomation ::VariantToRect Convertit un VARIANT contenant des coordonnées de rectangle en RECT. |
Remarques
Chaque application cliente UI Automation doit obtenir cette interface vers un objet CUIAutomation afin d’accéder aux fonctionnalités de UI Automation.
L’exemple de fonction suivant crée un objet CUIAutomation et obtient l’interface IUIAutomation .
IUIAutomation *g_pAutomation;
BOOL InitializeUIAutomation()
{
CoInitialize(NULL);
HRESULT hr = CoCreateInstance(__uuidof(CUIAutomation), NULL, CLSCTX_INPROC_SERVER,
__uuidof(IUIAutomation), (void**)&g_pAutomation);
return (SUCCEEDED(hr));
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7, Windows Vista avec SP2 et Platform Update pour Windows Vista, Windows XP avec SP3 et Platform Update pour Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008, Windows Server 2003 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | uiautomationclient.h (incluez UIAutomation.h) |