Partager via


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é pour appeler la boîte de dialogue Ouvrir le fichier commun. Un élément automation doté de 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 de l’élément automation.
Une clé d’accès (parfois appelée mnémonique) 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 clé 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 un commentaire, un en-tête, un 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 d’un document, tels que commentaire, en-tête, 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 aux propriétés et fonctions UI Automation, consultez UI Automation for W3C Accessible Internet Rich Internet Applications Specification.
AriaProperties est une collection de paires Name/Value avec des délimiteurs de = (égal) et ; (point-virgule), par exemple, « checked=true;disabled=false ». ( \ barre oblique inverse) est utilisé comme caractère d’échappement lorsque ces caractères délimiteurs ou \ apparaissent dans les valeurs. Pour des raisons de sécurité et pour 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, elle n’est pas obligatoire.
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 de rôles ARIA à des types de contrôle UI Automation, consultez Ui Automation for W3C Accessible Internet Applications Specification.

Remarque :
En 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 UI Automation (ID) pour l’élément automation.
Lorsqu’il est disponible, l’AutomationId d’un élément doit être identique dans n’importe quel 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 unique sur l’ensemble du bureau. Par exemple, plusieurs instances d’une application, ou plusieurs affichages 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. Là où il est pris en charge, AutomationId est utile pour créer un script d’automatisation de test qui s’exécute quelle que soit la langue de l’interface utilisateur. Les clients ne doivent faire aucune hypothèse concernant les valeurs AutomationId exposées par d’autres applications. AutomationId n’est pas garanti pour ê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 sont pas cliquables si la forme ou la région cliquable 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]

Remarque :
Cette propriété a la valeur NULL si l’élément n’affiche pas d’interface utilisateur.



UIA_CenterPointPropertyId
30165
Identifie la propriété CenterPoint , qui spécifie les coordonnées de point X et Y au centre de l’élément automation. L’espace de coordonnées est ce que le fournisseur considère logiquement comme 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, tel qu’attribué par le développeur de contrôles.
Le nom de la 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 sur lequel vous pouvez cliquer. Impossible de cliquer sur un élément s’il est totalement 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 Automation 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 à des éléments d’interface utilisateur.
Cet identificateur est couramment utilisé pour l’accessibilité de la 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 d’interface utilisateur par des primitives de contrôle d’interface utilisateur connues telles que button ou case activée box.
Type de variant : 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.



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 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 comporte 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és. Pour plus d’informations, consultez Constantes et chaînes d’identificateur de langue.
Cette propriété peut exister par contrôle, mais n’est généralement disponible qu’au niveau de l’application.
Type de variant : VT_I4
Valeur par défaut : 0
UIA_DescribedByPropertyId
30105
Identifie la propriété DescribedBy , qui est un tableau d’éléments qui fournissent plus d’informations sur l’élément Automation.
DescribedBy 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 permettre aux clients de condenser des informations similaires, la propriété DescribedBy peut offrir un accès rapide à l’élément d’interface utilisateur qui peut déjà offrir des informations utiles à l’utilisateur final qui décrivent l’élément d’interface utilisateur.
Type de variante pour les fournisseurs : VT_UNKNOWN | VT_ARRAY
Type de variante 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é en tant que COLORREF, une valeur 32 bits utilisée pour spécifier une couleur RVB ou RVBA.
Type de variant : 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 que aucun, couleur, dégradé, image, modèle, etc.
Type de variant : VT_I4
Valeur par défaut : 0
UIA_FlowsFromPropertyId
30148
Identifie la propriété FlowsFrom , qui est un tableau d’éléments Automation qui suggère l’ordre de lecture avant l’élément Automation actuel. Pris en charge à partir de Windows 8.
La propriété FlowsFrom spécifie l’ordre de lecture lorsque les éléments Automation 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é FlowsFrom 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 de variante pour les clients : VT_UNKNOWN (IUIAutomationElementArray)
Valeur par défaut : tableau vide
UIA_FlowsToPropertyId
30106
Identifie la propriété FlowsTo , 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é FlowsTo spécifie l’ordre de lecture lorsque les éléments Automation 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é FlowsTo puisse spécifier plusieurs éléments suivants, 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 de variante 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. Exemples de valeurs de propriété : « 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 ce 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 de titre d’un élément UI Automation.
Type de variant : 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 le texte d’espace réservé qui apparaît dans les contrôles de modification 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, elle ne convient pas à la propriété name 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 à la langue 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 d’éléments Automation. Pour plus d’informations, consultez Vue d’ensemble de l’arborescence UI Automation.

Remarque :
Pour qu’un élément apparaisse dans l’affichage de contenu, la propriété IsContentElement et la propriété IsControlElement doivent avoir la valeur 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 d’éléments Automation. Pour plus d’informations, consultez Vue d’ensemble de l’arborescence UI Automation.
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 expriment généralement le titre du dialogue, le contrôle prioritaire dans le 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 indique généralement le titre de la fenêtre, suivi du contrôle prioritaire. 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 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 interagi avec.
Lorsque l’état activé d’un contrôle est FALSE, il est supposé que les contrôles enfants ne sont pas non plus activés. Les clients ne doivent pas s’attendre à des événements de modification de propriété 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 de vue (par exemple, un élément dans une zone de liste qui se trouve en dehors de la fenêtre d’affichage de l’objet conteneur) ou réduit hors vue (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 l’amener à recevoir le focus, l’élément est considéré comme étant à l’écran tandis qu’une partie de l’élément est hors écran.
La valeur de la propriété n’est pas affectée par l’occlusion par d’autres fenêtres ou par le fait que l’élément est visible sur un moniteur spécifique.
Si la propriété IsOffscreen a la valeur TRUE, l’élément d’interface utilisateur est défilé 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 remis en vue en faisant défiler, en cliquant sur une liste déroulante, etc.
Les objets que l’utilisateur final ne perçoit pas du tout ou qui sont « masqués par programmation » (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 doivent pas se trouver dans l’arborescence d’éléments Automation en premier lieu (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 la écho du clavier ou les commentaires d’entrée au clavier susceptibles d’exposer les informations protégées de l’utilisateur. Toute tentative d’accès à la propriété Value de l’élément protégé (contrôle d’édition) 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 du périphérique. L’interface utilisateur du périphérique s’affiche et prend en charge l’interaction utilisateur, mais n’accepte pas le focus clavier lorsqu’elle s’affiche. Les fenêtres contextuelles, les menus volants, les menus contextuels ou les notifications flottantes sont des exemples d’interface utilisateur de périphérique. Pris en charge à partir de Windows 8.1.
Lorsque la propriété IsPeripheral a la valeur 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é s’applique aux types de contrôle suivants :
  • 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 la status d’un élément de l’élément Automation.
ItemStatus permet à un client de déterminer si un élément transmet status sur un élément, ainsi que ce qu’est le status. 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 à la langue 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 permet d’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 document » ou un « Dossier ».
Lorsque ItemType est pris en charge, la chaîne doit correspondre à la langue de l’interface utilisateur de l’application ou à la langue 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 pour 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 point 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 point de 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 de base 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 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. Level décrit l’emplacement de l’élément dans la structure.
Il est recommandé d’utiliser le modèle de contrôle CustomNavigation en tandem avec Level.
Type de variant : VT_I4
Valeur par défaut : 0
UIA_LiveSettingPropertyId
30135
Identifie la propriété LiveSetting , qui est prise en charge par un élément Automation qui représente une région dynamique. La propriété LiveSetting indique le niveau de « politesse » qu’un client doit utiliser pour informer l’utilisateur des modifications apportées à la région active. Cette propriété peut être l’une des valeurs de l’énumération LiveSetting . Pris en charge à partir de Windows 8.
Type de variant : 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 : « Button »

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, en fonction du type de contrôle de l’élément (par exemple, « button » 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é 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 à la langue 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 point de repère que l’élément automation représente.
Cela doit être utilisé conjointement 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 à la langue 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 contenant 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 « Parcourir » pour un élément de bouton avec l’étiquette « Parcourir ». La propriété Name ne doit pas inclure le caractère mnémonique des clés d’accès (c’est-à-dire, « & »), qui est souligné dans la présentation de 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, un 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 de l’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 du visuel, mais une description concise de la fonction ou de la fonctionnalité d’interface utilisateur comme si elle était étiquetée par du texte simple. Par exemple, le bouton du menu Démarrer de Windows est nommé « Démarrer » (bouton) au lieu de « Logo Windows 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 en tant qu’é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 les informations de type ou de rôle de contrôle, telles que « button » ou « list » ; sinon, elle entre 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 et sœurs. Toutefois, tant qu’elle est cohérente avec la présentation de l’interface utilisateur, la même valeur Name peut être prise en charge par les pairs. Pour l’automatisation des tests, 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 variant : 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, à mesure que l’utilisateur effectue une page de contenu volumineux, le fournisseur peut détruire des é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 . Pris 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 sous la forme d’une 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 variant : 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 plan de l’élément Automation. Cet attribut est spécifié en tant que 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 plan de l’élément Automation.
Type de variante : VT_ARRAY VT_R8 |
Valeur par défaut : VT_EMPTY
UIA_PositionInSetPropertyId
30152
Identifie la propriété PositionInSet , qui est un entier de base 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 variant : 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 attribué par le système d’exploitation. Vous pouvez le voir dans la colonne PID de l’onglet Processus du Gestionnaire des tâches.
Type de variant : 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 en 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 ne l’est que 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 de RuntimeId peut changer. L’identificateur retourné doit être traité comme une valeur opaque et utilisé uniquement à des fins de 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_ARRAY VT_R8 |
Valeur par défaut : VT_EMPTY
UIA_SizeOfSetPropertyId
30153
Identifie la propriété SizeOfSet , qui est un entier de base 1 associé à un élément Automation. SizeOfSet décrit le nombre d’éléments Automation dans un groupe ou un jeu considérés comme frères.
SizeOfSet fonctionne en coordination avec la propriété PositionInSet pour décrire le nombre d’éléments dans le jeu.
Type de variant : 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, l’éclat, les bords mous ou le biseau.
VisualEffects :
  • VisualEffects_Shadow : 0x1
  • VisualEffects_Reflection : 0x2
  • VisualEffects_Glow : 0x4
  • VisualEffects_SoftEdges : 0x8
  • VisualEffects_Bevel : 0x10
Type de variant : VT_I4
Valeur par défaut : 0

Spécifications

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 de propriétés à partir d’éléments UI Automation