Identificateurs de propriété d’élément Automation

Cette rubrique décrit les constantes nommées qui identifient les propriétés des éléments microsoft UI Automation.

Constante/valeur Description
UIA_AcceleratorKeyPropertyId
30006
Identifie la propriété AcceleratorKey , qui est une chaîne contenant les combinaisons de touche d’accélérateur (également appelée touche de raccourci) pour l’élément Automation.
Les combinaisons de touches de raccourci appellent une action. Par exemple, Ctrl+O est souvent utilisée pour appeler la boîte de dialogue Ouvrir le fichier commun. Un élément Automation qui a la propriété AcceleratorKey peut implémenter le modèle de contrôle Invoke pour l’action équivalente à la commande de raccourci.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_AccessKeyPropertyId
30007
Identifie la propriété AccessKey , qui est une chaîne contenant le caractère de clé d’accès pour l’élément Automation.
Une clé d’accès (parfois appelée mnemonic) est un caractère dans le texte d’un menu, d’un élément de menu ou d’une étiquette d’un contrôle tel qu’un bouton, qui active la fonction de menu associée. Par exemple, pour ouvrir le menu Fichier, pour lequel la touche d’accès est généralement F, l’utilisateur appuie sur ALT+F.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_AnnotationObjectsPropertyId
30156
Identifie la propriété AnnotationObjects , qui est une liste d’objets d’annotation dans un document, comme le commentaire, l’en-tête, le pied de page, etc.
Type de variante : VT_I4 | VT_ARRAY
Valeur par défaut : tableau vide
UIA_AnnotationTypesPropertyId
30155
Identifie la propriété AnnotationTypes , qui est une liste des types d’annotations dans un document, comme le commentaire, l’en-tête, le pied de page, etc.
Type de variante : VT_I4 | VT_ARRAY
Valeur par défaut : tableau vide
UIA_AriaPropertiesPropertyId
30102
Identifie la propriété AriaProperties , qui est une chaîne mise en forme contenant les informations de propriété ARIA (Accessible Rich Internet Application) pour l’élément Automation. Pour plus d’informations sur le mappage des états et des propriétés ARIA pour UI Automation propriétés et fonctions, consultez UI Automation pour la spécification des applications Internet enrichies accessibles W3C.
AriaProperties est une collection de paires Name/Value avec des séparateurs de = (égaux) et ; (point-virgule), par exemple, « check=true;disabled=false ». La \ barre oblique inverse est utilisée comme caractère d’échappement lorsque ces caractères délimiteurs ou \ apparaissent dans les valeurs. Pour des raisons de sécurité et d’autres raisons, l’implémentation du fournisseur de cette propriété peut prendre des mesures pour valider les propriétés ARIA d’origine; toutefois, il n’est pas nécessaire.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_AriaRolePropertyId
30101
Identifie la propriété AriaRole , qui est une chaîne contenant les informations de rôle ARIA (Accessible Rich Internet Application) pour l’élément Automation. Pour plus d’informations sur le mappage des rôles ARIA pour UI Automation types de contrôle, consultez UI Automation pour la spécification des applications Internet enrichies W3C.
[! Remarque]
En guise d’option, l’agent utilisateur peut également proposer une description localisée du rôle ARIA W3C dans la propriété LocalizedControlType . Lorsque la chaîne localisée n’est pas spécifiée, le système fournit la chaîne LocalizedControlType par défaut pour l’élément.


Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_AutomationIdPropertyId
30011
Identifie la propriété AutomationId, qui est une chaîne contenant l’identificateur (ID) UI Automation pour l’élément Automation.
Lorsqu’il est disponible, l’AutomationId d’un élément doit être identique dans n’importe quelle instance de l’application, quelle que soit la langue locale. La valeur doit être unique parmi les éléments frères, mais pas nécessairement uniques sur l’ensemble du bureau. Par exemple, plusieurs instances d’une application ou plusieurs vues de dossiers dans Microsoft Windows Explorer peuvent contenir des éléments avec la même propriété AutomationId, telle que « SystemMenuBar ».
Bien que la prise en charge d’AutomationId soit toujours recommandée pour une meilleure prise en charge des tests automatisés, cette propriété n’est pas obligatoire. Lorsqu’il est pris en charge, AutomationId est utile pour créer un script d’automatisation de test qui s’exécute indépendamment du langage de l’interface utilisateur. Les clients ne doivent pas faire d’hypothèses concernant les valeurs AutomationId exposées par d’autres applications. AutomationId n’est pas garanti d’être stable dans différentes versions ou builds d’une application.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_BoundingRectanglePropertyId
30001
Identifie la propriété BoundingRectangle , qui spécifie les coordonnées du rectangle qui entoure complètement l’élément Automation. Le rectangle est exprimé en coordonnées d’écran physiques. Il peut contenir des points qui ne peuvent pas être cliqués si la forme ou la région pouvant être cliquée de l’élément d’interface utilisateur est irrégulière ou si l’élément est masqué par d’autres éléments d’interface utilisateur.
Type de variante : VT_R8 | VT_ARRAY
Valeur par défaut : [0,0,0,0,0]
[! Remarque]
Cette propriété est NULL si l’élément n’affiche pas actuellement une interface utilisateur.


UIA_CenterPointPropertyId
30165
Identifie la propriété CenterPoint , qui spécifie les coordonnées de point X et Y centre de l’élément Automation. L’espace de coordonnées est ce que le fournisseur considère logiquement une page.
Type de variante : VT_R8 | VT_ARRAY
Valeur par défaut : VT_EMPTY
UIA_ClassNamePropertyId
30012
Identifie la propriété ClassName , qui est une chaîne contenant le nom de classe de l’élément Automation comme affecté par le développeur du contrôle.
Le nom de classe dépend de l’implémentation du fournisseur UI Automation et n’est donc pas toujours au format standard. Toutefois, si le nom de classe est connu, il peut être utilisé pour vérifier qu’une application fonctionne avec l’élément Automation attendu.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_ClickablePointPropertyId
30014
Identifie la propriété ClickablePoint , qui est un point sur l’élément Automation qui peut être cliqué. Un élément ne peut pas être cliqué s’il est complètement ou partiellement masqué par une autre fenêtre.
Type de variante : VT_R8 | VT_ARRAY
Valeur par défaut : VT_EMPTY
UIA_ControllerForPropertyId
30104
Identifie la propriété ControllerFor , qui est un tableau d’éléments d’automatisation qui sont manipulés par l’élément automation qui prend en charge cette propriété.
ControllerFor est utilisé lorsqu’un élément Automation affecte un ou plusieurs segments de l’interface utilisateur de l’application ou du bureau ; sinon, il est difficile d’associer l’impact de l’opération de contrôle aux éléments d’interface utilisateur.
Cet identificateur est couramment utilisé pour l’accessibilité de suggestion automatique.
Type de variante pour les fournisseurs : VT_UNKNOWN | VT_ARRAY
Type variant pour les clients : VT_UNKNOWN (IUIAutomationElementArray )
Valeur par défaut : tableau vide
UIA_ControlTypePropertyId
30003
Identifie la propriété ControlType , qui est une classe qui identifie le type de l’élément Automation. ControlType définit les caractéristiques des éléments de l’interface utilisateur par des primitives de contrôle d’interface utilisateur connues telles que le bouton ou la case à cocher.
Type de variante : VT_I4
Valeur par défaut : UIA_CustomControlTypeId
[! Remarque]
Utilisez la valeur par défaut uniquement si l’élément Automation représente un nouveau type de contrôle complètement nouveau.


UIA_CulturePropertyId
30015
Identifie la propriété Culture, qui contient un identificateur de paramètres régionaux pour l’élément Automation (par exemple, 0x0409 pour « en-US » ou l’anglais (États-Unis)).
Chaque paramètre régional a un identificateur unique, une valeur 32 bits qui se compose d’un identificateur de langue et d’un identificateur d’ordre de tri. L’identificateur de paramètres régionaux est une abréviation numérique internationale standard et contient les composants nécessaires pour identifier de manière unique l’un des paramètres régionaux définis par le système d’exploitation installé. Pour plus d’informations, consultez Constantes et chaînes d’identificateur de langage.
Cette propriété peut exister par contrôle, mais elle est généralement disponible uniquement au niveau de l’application.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_DescribedByPropertyId
30105
Identifie la propriété DescriptionBy , qui est un tableau d’éléments qui fournissent plus d’informations sur l’élément Automation.
DécritBy est utilisé lorsqu’un élément Automation est expliqué par un autre segment de l’interface utilisateur de l’application. Par exemple, la propriété peut pointer vers un élément de texte « 2 529 éléments dans 85 groupes, 10 éléments sélectionnés » à partir d’un objet de liste personnalisé complexe. Au lieu d’utiliser le modèle objet pour que les clients puissent digester des informations similaires, la propriété DescriptionBy peut offrir un accès rapide à l’élément d’interface utilisateur qui peut déjà offrir des informations utiles sur l’utilisateur final qui décrit l’élément d’interface utilisateur.
Type de variante pour les fournisseurs : VT_UNKNOWN | VT_ARRAY
Type variant pour les clients : VT_UNKNOWN (IUIAutomationElementArray)
Valeur par défaut : tableau vide
UIA_FillColorPropertyId
30160
Identifie la propriété FillColor , qui spécifie la couleur utilisée pour remplir l’élément Automation. Cet attribut est spécifié sous la forme d’une valeur COLORREF, une valeur 32 bits utilisée pour spécifier une couleur RVB ou RVBA.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_FillTypePropertyId
30162
Identifie la propriété FillType , qui spécifie le modèle utilisé pour remplir l’élément Automation, tel qu’aucun, couleur, dégradé, image, modèle, etc.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_FlowsFromPropertyId
30148
Identifie la propriété FlowFrom , qui est un tableau d’éléments d’automatisation qui suggère l’ordre de lecture avant l’élément Automation actuel. Prise en charge à partir de Windows 8.
La propriété FlowFrom spécifie l’ordre de lecture lorsque les éléments d’automatisation ne sont pas exposés ou structurés dans le même ordre de lecture que celui perçu par l’utilisateur. Bien que la propriété FlowFrom puisse spécifier plusieurs éléments précédents, elle contient généralement uniquement l’élément précédent dans l’ordre de lecture.
Type de variante pour les fournisseurs : VT_UNKNOWN | VT_ARRAY
Type variant pour les clients : VT_UNKNOWN (IUIAutomationElementArray)
Valeur par défaut : tableau vide
UIA_FlowsToPropertyId
30106
Identifie la propriété FlowTo , qui est un tableau d’éléments d’automatisation qui suggère l’ordre de lecture après l’élément Automation actuel.
La propriété FlowTo spécifie l’ordre de lecture lorsque les éléments d’automatisation ne sont pas exposés ou structurés dans le même ordre de lecture que celui perçu par l’utilisateur. Bien que la propriété FlowTo puisse spécifier plusieurs éléments réussis, elle contient généralement uniquement l’élément suivant dans l’ordre de lecture.
Type de variante pour les fournisseurs : VT_UNKNOWN | VT_ARRAY
Type variant pour les clients : VT_UNKNOWN (IUIAutomationElementArray)
Valeur par défaut : tableau vide
UIA_FrameworkIdPropertyId
30024
Identifie la propriété FrameworkId , qui est une chaîne contenant le nom de l’infrastructure d’interface utilisateur sous-jacente à laquelle appartient l’élément Automation.
FrameworkId permet aux applications clientes de traiter les éléments d’automatisation différemment en fonction de l’infrastructure d’interface utilisateur particulière. Parmi les exemples de valeurs de propriété, citons « Win32 », « WinForm » et « DirectUI ».
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_FullDescriptionPropertyId
30159
La propriété FullDescription expose une chaîne localisée qui peut contenir du texte de description étendu pour un élément. FullDescription peut contenir une description plus complète d’un élément que celui qui peut être approprié pour l’élément Name.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_HasKeyboardFocusPropertyId
30008
Identifie la propriété HasKeyboardFocus , qui est une valeur booléenne qui indique si l’élément Automation a le focus clavier.
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_HeadingLevelPropertyId
30173
Identifie la propriété HeadingLevel, qui indique le niveau d’en-tête d’un élément UI Automation.
Type de variante : VT_I4
Valeur par défaut : HeadingLevel_None
UIA_HelpTextPropertyId
30013
Identifie la propriété HelpText , qui est une chaîne de texte d’aide associée à l’élément Automation.
La propriété HelpText peut être prise en charge avec du texte d’espace réservé qui apparaît dans les contrôles d’édition ou de liste. Par exemple, « Tapez du texte ici pour la recherche » est un bon candidat à la propriété HelpText pour un contrôle d’édition qui place le texte avant l’entrée réelle de l’utilisateur. Toutefois, il n’est pas suffisant pour la propriété de nom du contrôle d’édition.
Lorsque HelpText est pris en charge, la chaîne doit correspondre à la langue de l’interface utilisateur de l’application ou au langage d’interface utilisateur par défaut du système d’exploitation.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_IsContentElementPropertyId
30017
Identifie la propriété IsContentElement , qui est une valeur booléenne qui spécifie si l’élément apparaît dans la vue de contenu de l’arborescence des éléments Automation. Pour plus d’informations, consultez UI Automation Vue d’ensemble de l’arborescence.
[! Remarque]
Pour qu’un élément apparaisse dans la vue de contenu, la propriété IsContentElement et la propriété IsControlElement doivent être TRUE.


Type de variante : VT_BOOL
Valeur par défaut : TRUE
UIA_IsControlElementPropertyId
30016
Identifie la propriété IsControlElement , qui est une valeur booléenne qui spécifie si l’élément apparaît dans la vue de contrôle de l’arborescence des éléments Automation. Pour plus d’informations, consultez UI Automation Vue d’ensemble de l’arborescence.
Type de variante : VT_BOOL
Valeur par défaut : TRUE
UIA_IsDataValidForFormPropertyId
30103
Identifie la propriété IsDataValidForForm , qui est une valeur booléenne qui indique si la valeur entrée ou sélectionnée est valide pour la règle de formulaire associée à l’élément Automation. Par exemple, si l’utilisateur a entré « 425-555-5555 » pour un champ de code postal qui nécessite 5 ou 9 chiffres, la propriété IsDataValidForForm peut être définie sur FALSE pour indiquer que les données ne sont pas valides.
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_IsDialogPropertyId
30174
Identifie la propriété IsDialog , qui est une valeur booléenne qui indique si l’élément Automation est une fenêtre de dialogue. Par exemple, les technologies d’assistance telles que les lecteurs d’écran parlent généralement le titre du dialogue, le contrôle ciblé dans la boîte de dialogue, puis le contenu du dialogue jusqu’au contrôle ciblé (« Voulez-vous enregistrer vos modifications avant de fermer »). Pour les fenêtres standard, un lecteur d’écran parle généralement le titre de la fenêtre suivi du contrôle ciblé. La propriété IsDialog peut être définie sur TRUE pour indiquer que l’application cliente doit traiter l’élément comme une fenêtre de boîte de dialogue.
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_IsEnabledPropertyId
30010
Identifie la propriété IsEnabled , qui est une valeur booléenne qui indique si l’élément d’interface utilisateur référencé par l’élément Automation est activé et peut être interagir avec.
Lorsque l’état activé d’un contrôle est FALSE, il est supposé que les contrôles enfants ne sont pas également activés. Les clients ne doivent pas s’attendre à des événements modifiés par des propriétés provenant d’éléments enfants lorsque l’état du contrôle parent change.
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_IsKeyboardFocusablePropertyId
30009
Identifie la propriété IsKeyboardFocusable , qui est une valeur booléenne qui indique si l’élément Automation peut accepter le focus clavier.
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_IsOffscreenPropertyId
30022
Identifie la propriété IsOffscreen , qui est une valeur booléenne qui indique si l’élément Automation est entièrement fait défiler hors d’affichage (par exemple, un élément dans une zone de liste qui se trouve en dehors de la zone d’affichage de l’objet conteneur) ou réduit en dehors de l’affichage (par exemple, un élément dans une arborescence ou un menu, ou dans une fenêtre réduite). Si l’élément a un point cliquable qui peut le provoquer pour recevoir le focus, l’élément est considéré comme étant à l’écran alors qu’une partie de l’élément est désactivée.
La valeur de la propriété n’est pas affectée par l’occlusion par d’autres fenêtres, ou si l’élément est visible sur un moniteur spécifique.
Si la propriété IsOffscreen est TRUE, l’élément d’interface utilisateur fait défiler l’écran hors écran ou réduit. L’élément est temporairement masqué, mais il reste dans la perception de l’utilisateur final et continue d’être inclus dans le modèle d’interface utilisateur. L’objet peut être renvoyé en mode en faisant défiler, en cliquant sur une liste déroulante, et ainsi de suite.
Les objets que l’utilisateur final ne perçoit pas du tout ou qui sont « masqués par programme » (par exemple, une boîte de dialogue qui a été ignorée, mais l’objet sous-jacent est toujours mis en cache par l’application) ne doit pas se trouver dans l’arborescence d’éléments Automation à la première place (au lieu de définir l’état de IsOffscreen sur TRUE).
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_IsPasswordPropertyId
30019
Identifie la propriété IsPassword , qui est une valeur booléenne qui indique si l’élément Automation contient du contenu protégé ou un mot de passe.
Lorsque la propriété IsPassword a la valeur TRUE et que l’élément a le focus clavier, une application cliente doit désactiver les commentaires d’écho clavier ou de saisie du clavier susceptibles d’exposer les informations protégées de l’utilisateur. La tentative d’accès à la propriété Value de l’élément protégé (contrôle de modification) peut entraîner une erreur.
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_IsPeripheralPropertyId
30150
Identifie la propriété IsPeripheral , qui est une valeur booléenne qui indique si l’élément Automation représente l’interface utilisateur périphérique. L’interface utilisateur périphérique s’affiche et prend en charge l’interaction utilisateur, mais ne prend pas le focus sur le clavier lorsqu’elle apparaît. Des exemples d’interface utilisateur périphérique incluent des fenêtres contextuelles, des menu volants, des menus contextuels ou des notifications flottantes. Prise en charge à partir de Windows 8.1.
Lorsque la propriété IsPeripheral est TRUE, une application cliente ne peut pas supposer que le focus a été pris par l’élément même s’il est actuellement interactif au clavier.
Cette propriété est pertinente pour ces types de contrôle :
  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_IsRequiredForFormPropertyId
30025
Identifie la propriété IsRequiredForForm , qui est une valeur booléenne qui indique si l’élément Automation doit être rempli sur un formulaire.
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_ItemStatusPropertyId
30026
Identifie la propriété ItemStatus , qui est une chaîne de texte décrivant l’état d’un élément de l’élément Automation.
ItemStatus permet à un client de déterminer si un élément transmet l’état d’un élément à propos d’un élément ainsi que ce que l’état est. Par exemple, un élément associé à un contact dans une application de messagerie peut être « Occupé » ou « Connecté ».
Lorsque ItemStatus est pris en charge, la chaîne doit correspondre à la langue de l’interface utilisateur de l’application ou au langage d’interface utilisateur par défaut du système d’exploitation.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_ItemTypePropertyId
300021
Identifie la propriété ItemType , qui est une chaîne de texte décrivant le type de l’élément Automation.
ItemType est utilisé pour obtenir des informations sur les éléments d’une liste, d’une arborescence ou d’une grille de données. Par exemple, un élément dans une vue de répertoire de fichiers peut être un « fichier de documents » ou un « dossier ».
Lorsque ItemType est pris en charge, la chaîne doit correspondre à la langue de l’interface utilisateur de l’application ou au langage d’interface utilisateur par défaut du système d’exploitation.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_LabeledByPropertyId
30018
Identifie la propriété LabeledBy , qui est un élément automation qui contient l’étiquette de texte de cet élément.
Cette propriété peut être utilisée pour récupérer, par exemple, l’étiquette de texte statique d’une zone de liste déroulante.
Type de variante : VT_UNKNOWN
Valeur par défaut : NULL
UIA_LandmarkTypePropertyId
30157
Identifie la propriété LandmarkType , qui est un identificateur de type de repère associé à un élément.
La propriété LandmarkType décrit un élément qui représente un groupe d’éléments. Par exemple, un point de repère de recherche peut représenter un ensemble de contrôles associés pour la recherche.
Si UIA_CustomLandmarkTypeId est utilisé, UIA_LocalizedLandmarkTypePropertyId est nécessaire pour décrire le repère personnalisé.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_LevelPropertyId
30154
Identifie la propriété Level , qui est un entier basé sur 1 associé à un élément Automation.
La propriété Level décrit l’emplacement d’un élément à l’intérieur d’une structure hiérarchique ou hiérarchique rompue. Par exemple, une liste à puces/numérotée, des en-têtes ou d’autres éléments de données structurés peuvent avoir différentes relations parent/enfant. Le niveau décrit où se trouve la structure de l’élément.
Il est recommandé d’utiliser le modèle de contrôle CustomNavigation en tandem avec Level.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_LiveSettingPropertyId
30135
Identifie la propriété LiveSetting , prise en charge par un élément Automation qui représente une région dynamique. La propriété LiveSetting indique le niveau « poli » qu’un client doit utiliser pour informer l’utilisateur des modifications apportées à la région dynamique. Cette propriété peut être l’une des valeurs de l’énumération LiveSetting . Prise en charge à partir de Windows 8.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_LocalizedControlTypePropertyId
30004
Identifie la propriété LocalizedControlType , qui est une chaîne de texte décrivant le type de contrôle que l’élément Automation représente. La chaîne doit contenir uniquement des caractères minuscules :
  • Correct : « bouton »
  • Incorrect : « Bouton »

Lorsque LocalizedControlType n’est pas spécifié par le fournisseur d’éléments, la chaîne localisée par défaut est fournie par l’infrastructure, selon le type de contrôle de l’élément (par exemple, « bouton » pour le type de contrôle Button ). Un élément Automation avec le type de contrôle personnalisé doit prendre en charge une chaîne de type de contrôle localisée qui représente le rôle de l’élément (par exemple, « sélecteur de couleurs » pour un contrôle personnalisé qui permet aux utilisateurs de choisir et de spécifier des couleurs).
Lorsqu’une valeur personnalisée est fournie, la chaîne doit correspondre à la langue de l’interface utilisateur de l’application ou au langage d’interface utilisateur par défaut du système d’exploitation.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_LocalizedLandmarkTypePropertyId
30158
Identifie le LocalizedLandmarkType, qui est une chaîne de texte décrivant le type de repère que l’élément Automation représente.
Cela doit être utilisé en tandem avec UIA_CustomLandmarkTypeId toutefois, LocalizedLandmarkType doit toujours être prioritaire sur LandmarkType et être utilisé pour décrire le point de repère avant LandmarkType.
La chaîne doit correspondre à la langue de l’interface utilisateur de l’application ou au langage d’interface utilisateur par défaut du système d’exploitation.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_NamePropertyId
30005
Identifie la propriété Name , qui est une chaîne qui contient le nom de l’élément Automation.
La propriété Name doit être identique au texte de l’étiquette à l’écran. Par exemple, Name doit être « Browse » pour un élément de bouton avec l’étiquette « Parcourir ». La propriété Name ne doit pas inclure le caractère mnemonique des clés d’accès (autrement dit, « & »), qui est souligné dans la présentation du texte de l’interface utilisateur. En outre, la propriété Name ne doit pas être une version étendue ou modifiée de l’étiquette à l’écran, car l’incohérence entre le nom et l’étiquette peut entraîner une confusion entre les applications clientes et les utilisateurs.
Lorsque le texte d’étiquette correspondant n’est pas visible à l’écran ou lorsqu’il est remplacé par des graphiques, le texte de remplacement doit être choisi. Le texte de remplacement doit être concis, intuitif et localisé dans la langue de l’interface utilisateur de l’application ou dans la langue d’interface utilisateur par défaut du système d’exploitation. Le texte de remplacement ne doit pas être une description détaillée des détails visuels, mais une description concise de la fonction d’interface utilisateur ou de la fonctionnalité comme si elle était étiquetée par du texte simple. Par exemple, le bouton Windows menu Démarrer est nommé « Démarrer » (bouton) au lieu de « Windows Logo sur des graphiques à sphère ronde bleue » (bouton). Pour plus d’informations, consultez Création d’équivalents de texte pour les images.
Lorsqu’une étiquette d’interface utilisateur utilise des graphiques texte (par exemple, en utilisant « >> » pour un bouton qui ajoute un élément de gauche à droite), la propriété Name doit être remplacée par une alternative de texte appropriée (par exemple, « Ajouter »). Toutefois, la pratique d’utiliser des graphiques de texte comme étiquette d’interface utilisateur est déconseillée en raison de problèmes de localisation et d’accessibilité.
La propriété Name ne doit pas inclure le rôle de contrôle ou les informations de type, telles que « bouton » ou « list » ; sinon, il est en conflit avec le texte de la propriété LocalizedControlType lorsque ces deux propriétés sont ajoutées (de nombreuses technologies d’assistance existantes le font).
La propriété Name ne peut pas être utilisée comme identificateur unique parmi les frères. Toutefois, tant qu’elle est cohérente avec la présentation de l’interface utilisateur, la même valeur de nom peut être prise en charge entre pairs. Pour tester l’automatisation, les clients doivent envisager d’utiliser la propriété AutomationId ou RuntimeId .
Les contrôles de texte n’ont pas toujours besoin que la propriété Name soit identique au texte affiché dans le contrôle, tant que le modèle texte est également pris en charge.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_NativeWindowHandlePropertyId
30020
Identifie la propriété NativeWindowHandle , qui est un entier qui représente le handle (HWND) de la fenêtre d’élément Automation, s’il existe ; sinon, cette propriété est 0.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_OptimizeForVisualContentPropertyId
30111
Identifie la propriété OptimizeForVisualContent , qui est une valeur booléenne qui indique si le fournisseur expose uniquement les éléments visibles. Un fournisseur peut utiliser cette propriété pour optimiser les performances lors de l’utilisation de très grands éléments de contenu. Par exemple, comme les pages utilisateur via un grand élément de contenu, le fournisseur peut détruire les éléments de contenu qui ne sont plus visibles. Lorsqu’un élément de contenu est détruit, le fournisseur doit retourner le code d’erreur UIA_E_ELEMENTNOTAVAILABLE . Prise en charge à partir de Windows 8.
Type de variante : VT_BOOL
Valeur par défaut : FALSE
UIA_OrientationPropertyId
300023
Identifie la propriété Orientation , qui indique l’orientation du contrôle représenté par l’élément Automation. La propriété est exprimée en tant que valeur du type énuméré OrientationType .
La propriété Orientation est prise en charge par les contrôles, tels que les barres de défilement et les curseurs, qui peuvent avoir une orientation verticale ou horizontale. Sinon, il peut toujours être OrientationType_None, ce qui signifie que le contrôle n’a aucune orientation.
Type de variante : VT_I4
Valeur par défaut : 0 (OrientationType_None)
UIA_OutlineColorPropertyId
30161
Identifie la propriété OutlineColor , qui spécifie la couleur utilisée pour le contour de l’élément Automation. Cet attribut est spécifié sous la forme d’une valeur COLORREF, une valeur 32 bits utilisée pour spécifier une couleur RVB ou RVBA.
Type de variante : VT_I4 | VT_ARRAY
Valeur par défaut : 0
UIA_OutlineThicknessPropertyId
30164
Identifie la propriété OutlineThickness , qui spécifie la largeur du contour de l’élément Automation.
Type de variante : VT_R8 | VT_ARRAY
Valeur par défaut : VT_EMPTY
UIA_PositionInSetPropertyId
30152
Identifie la propriété PositionInSet , qui est un entier basé sur 1 associé à un élément Automation. PositionInSet décrit l’emplacement ordinal de l’élément dans un ensemble d’éléments considérés comme frères.
PositionInSet fonctionne en coordination avec la propriété SizeOfSet pour décrire l’emplacement ordinal dans l’ensemble.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_ProcessIdPropertyId
30002
Identifie la propriété ProcessId , qui est un entier représentant l’identificateur de processus (ID) de l’élément Automation.
L’identificateur de processus (ID) est affecté par le système d’exploitation. Il est visible dans la colonne PID de l’onglet Processus dans Le Gestionnaire de tâches.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_ProviderDescriptionPropertyId
30107
Identifie la propriété ProviderDescription, qui est une chaîne mise en forme contenant les informations sources du fournisseur UI Automation pour l’élément Automation, y compris les informations de proxy.
Type de variante : VT_BSTR
Valeur par défaut : chaîne vide
UIA_RotationPropertyId
30166
Identifie la propriété Rotation , qui spécifie l’angle de rotation dans des unités non spécifiées.
Type de variante : VT_R8
Valeur par défaut : 0
UIA_RuntimeIdPropertyId
30000
Identifie la propriété RuntimeId , qui est un tableau d’entiers représentant l’identificateur d’un élément Automation.
L’identificateur est unique sur le bureau, mais il est garanti qu’il soit unique uniquement dans l’interface utilisateur du bureau sur lequel il a été généré. Les identificateurs peuvent être réutilisés au fil du temps.
Le format d’RuntimeId peut changer. L’identificateur retourné doit être traité comme une valeur opaque et utilisé uniquement pour la comparaison; par exemple, pour déterminer si un élément Automation se trouve dans le cache.
Type de variante : VT_I4 | VT_ARRAY
Valeur par défaut : VT_EMPTY
UIA_SizePropertyId
30167
Identifie la propriété Size , qui spécifie la largeur et la hauteur de l’élément Automation.
Type de variante : VT_R8 | VT_ARRAY
Valeur par défaut : VT_EMPTY
UIA_SizeOfSetPropertyId
30153
Identifie la propriété SizeOfSet , qui est un entier basé sur 1 associé à un élément Automation. SizeOfSet décrit le nombre d’éléments d’automatisation d’un groupe ou d’un ensemble considérés comme frères.
SizeOfSet fonctionne en coordination avec la propriété PositionInSet pour décrire le nombre d’éléments dans l’ensemble.
Type de variante : VT_I4
Valeur par défaut : 0
UIA_VisualEffectsPropertyId
30163
Identifie la propriété VisualEffects , qui est un champ de bits qui spécifie des effets sur l’élément d’automatisation, tels que l’ombre, la réflexion, la lumière, les bords doux ou le biseau.
VisualEffects :
  • VisualEffects_Shadow : 0x1
  • VisualEffects_Reflection : 0x2
  • VisualEffects_Glow : 0x4
  • VisualEffects_SoftEdges : 0x8
  • VisualEffects_Bevel : 0x10
Type de variante : VT_I4
Valeur par défaut : 0

Configuration requise

Condition requise Valeur
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]
En-tête
UIAutomationClient.h

Voir aussi

Conceptuel

Vue d'ensemble des propriétés UI Automation

Récupération des propriétés à partir d’éléments UI Automation