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 de Microsoft UI Automation.
| Constante/valeur | Description |
|---|---|
|
Identifie la propriété AcceleratorKey , qui est une chaîne contenant les combinaisons touche 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, la combinaison de touches CTRL + O est souvent utilisée pour appeler la boîte de dialogue Ouvrir un 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 qui est équivalente à la commande de raccourci. Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété AccessKey , qui est une chaîne contenant le caractère 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, un élément de menu ou 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 Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété AnnotationObjects , qui est une liste d’objets annotation dans un document, comme un commentaire, un en-tête, un pied de page, etc. Type Variant : VT_I4 | VT_ARRAY Valeur par défaut : tableau vide |
|
Identifie la propriété AnnotationTypes , qui est une liste des types d’annotations dans un document, tels que le commentaire, l’en-tête, le pied de page, etc. Type Variant : VT_I4 | VT_ARRAY Valeur par défaut : tableau vide |
|
Identifie la propriété AriaProperties , qui est une chaîne mise en forme contenant les informations de propriété d’application Internet riche (ARIA) accessibles 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 pour la spécification des applications Internet riches accessibles par le W3C. AriaProperties est une collection de paires nom/valeur avec des délimiteurs de = (égal à) et ; (point-virgule), par exemple, " Checked = True ; Disabled = false " . La \ barre oblique inverse () est utilisée comme caractère d’échappement lorsque ces caractères délimitent ou \ s’affichent dans les valeurs. Pour des raisons de sécurité et autres, l’implémentation du fournisseur de cette propriété peut prendre des mesures pour valider les propriétés ARIA d’origine. Toutefois, ce n’est pas obligatoire. Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété AriaRole , qui est une chaîne contenant les informations de rôle Aria (Rich Internet application) accessibles pour l’élément Automation. Pour plus d’informations sur le mappage des rôles ARIA à des types de contrôle UI Automation, consultez UI Automation pour la spécification des applications Internet riches accessibles par le W3C.[!Note] Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété AutomationId , qui est une chaîne contenant l’identificateur UI Automation (ID) de l’élément Automation. Lorsqu’il est disponible, le AutomationId d’un élément doit être le même 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 elle n’est pas nécessairement unique sur l’ensemble du bureau. par exemple, plusieurs instances d’une application, ou plusieurs affichages de dossiers dans l’explorateur de Windows Microsoft, peuvent contenir des éléments avec la même propriété AutomationId , par exemple " SystemMenuBar " . Bien que la prise en charge de 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 des tests qui s’exécute indépendamment de la langue de l’interface utilisateur. Les clients ne doivent pas faire d’hypothèses concernant les valeurs AutomationId exposées par d’autres applications. Il n’est pas garanti que AutomationId soit stable dans les différentes versions ou les versions d’une application. Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété BoundingRectangle , qui spécifie les coordonnées du rectangle qui englobe complètement l’élément Automation. Le rectangle est exprimé en coordonnées d’écran physiques. Elle peut contenir des points qui ne sont pas interdépendants si la forme ou la zone de l’élément de l’interface utilisateur cliquable est irrégulière, ou si l’élément est masqué par d’autres éléments de l’interface utilisateur. Type Variant : VT_R8 | VT_ARRAY Valeur par défaut : [0, 0, 0, 0] [!Note] |
|
Identifie la propriété Centerpoint , qui spécifie les coordonnées du centre X et Y de l’élément Automation. L’espace de coordonnées est ce que le fournisseur considère logiquement comme une page. Type Variant : VT_R8 | VT_ARRAY Valeur par défaut : VT_EMPTY |
|
Identifie la propriété className , qui est une chaîne contenant le nom de classe de l’élément Automation tel qu’assigné par le développeur de contrôle. Le nom de la classe dépend de l’implémentation du fournisseur UI Automation et, par conséquent, n’est pas toujours dans un format standard. Toutefois, si le nom de la classe est connu, il peut être utilisé pour vérifier qu’une application fonctionne avec l’élément Automation attendu. Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété ClickablePoint , qui est un point de l’élément Automation sur lequel vous pouvez cliquer. Un élément ne peut pas être cliqué s’il est totalement ou partiellement masqué par une autre fenêtre. Type Variant : VT_R8 | VT_ARRAY Valeur par défaut : VT_EMPTY |
|
Identifie la propriété ControllerFor , qui est un tableau d’éléments Automation 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. dans le cas contraire, 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 Variant pour les fournisseurs : VT_UNKNOWN | VT_ARRAY Type Variant pour les clients : VT_UNKNOWN (IUIAutomationElementArray ) Valeur par défaut : tableau vide |
|
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 le biais de primitives de contrôle d’interface utilisateur connues comme Button ou case à cocher. Type Variant : VT_I4 Valeur par défaut : UIA_CustomControlTypeId [!Note] |
|
Identifie la propriété de 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 de 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és. Pour plus d’informations, consultez constantes et chaînesde l’identificateur de langue. Cette propriété peut exister pour chaque contrôle, mais elle est généralement disponible uniquement au niveau de l’application. Type Variant : VT_I4 Valeur par défaut : 0 |
|
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 de " 2 529 éléments dans 85 groupes, 10 éléments sélectionnés " à partir d’un objet de liste personnalisée complexe. Au lieu d’utiliser le modèle objet pour les clients afin 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 Variant pour les fournisseurs : VT_UNKNOWN | VT_ARRAY Type Variant pour les clients : VT_UNKNOWN (IUIAutomationElementArray) Valeur par défaut : tableau vide |
|
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, valeur 32 bits utilisée pour spécifier une couleur RVB ou RVBA. Type Variant : VT_I4 Valeur par défaut : 0 |
|
Identifie la propriété fillType , qui spécifie le modèle utilisé pour remplir l’élément Automation, tel que None, Color, gradient, image, pattern, et ainsi de suite. Type Variant : VT_I4 Valeur par défaut : 0 |
|
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. Alors que la propriété FlowsFrom peut 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 Variant pour les fournisseurs : VT_UNKNOWN | VT_ARRAY Type Variant pour les clients : VT_UNKNOWN (IUIAutomationElementArray) Valeur par défaut : tableau vide |
|
Identifie la propriété FlowsTo , qui est un tableau d’éléments Automation 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. Alors que la propriété FlowsTo peut spécifier plusieurs éléments suivants, elle contient généralement uniquement l’élément suivant dans l’ordre de lecture. Type Variant pour les fournisseurs : VT_UNKNOWN | VT_ARRAY Type Variant pour les clients : VT_UNKNOWN (IUIAutomationElementArray) Valeur par défaut : tableau vide |
|
Identifie la propriété FrameworkId , qui est une chaîne contenant le nom de l’infrastructure d’interface utilisateur sous-jacente à laquelle l’élément Automation appartient. Le FrameworkId permet aux applications clientes de traiter les éléments d’automatisation différemment en fonction de l’infrastructure d’interface utilisateur particulière. Les exemples de valeurs de propriété incluent " Win32 " , " WinForm " et " directui " . Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
La propriété FullDescription expose une chaîne localisée qui peut contenir un texte de description étendu pour un élément. FullDescription peut contenir une description plus complète d’un élément que celle qui peut être appropriée pour le nomde l’élément. Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété HasKeyboardFocus , qui est une valeur booléenne qui indique si l’élément Automation a le focus clavier. Type Variant : VT_BOOL Valeur par défaut : false |
|
Identifie la propriété HeadingLevel , qui indique le niveau de titre d’un élément UI Automation. Type Variant : VT_I4 Valeur par défaut : HeadingLevel_None |
|
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 de l’espace réservé apparaissant dans les contrôles d’édition ou de liste. Par exemple, " tapez le 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 approprié pour la propriété Name du contrôle Edit. Quand 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 Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété IsContentElement , qui est une valeur booléenne qui spécifie si l’élément apparaît dans l’affichage de contenu de l’arborescence des éléments Automation. Pour plus d’informations, consultez UI Automation Tree Overview.[!Note] Type Variant : VT_BOOL Valeur par défaut : true |
|
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 Tree Overview. Type Variant : VT_BOOL Valeur par défaut : true |
|
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 Code postal qui requiert 5 ou 9 chiffres, la propriété IsDataValidForForm peut avoir la valeur false pour indiquer que les données ne sont pas valides. Type Variant : VT_BOOL Valeur par défaut : false |
|
Identifie la propriété IsDialog , qui est une valeur booléenne qui indique si l’élément Automation est une fenêtre de boîte de dialogue. Par exemple, les technologies d’assistance comme les lecteurs d’écran parlent généralement le titre de la boîte de dialogue, le contrôle ayant le focus dans la boîte de dialogue, puis le contenu de la boîte de dialogue jusqu’au contrôle ayant le focus (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 ayant le focus. La propriété IsDialog peut avoir la valeur true pour indiquer que l’application cliente doit traiter l’élément comme une fenêtre de dialogue. Type Variant : VT_BOOL Valeur par défaut : false |
|
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 a la valeur false, il est supposé que les contrôles enfants ne sont pas activés. Les clients ne doivent pas s’attendre à des événements de modification de propriété à partir d’éléments enfants lorsque l’état du contrôle parent change. Type Variant : VT_BOOL Valeur par défaut : false |
|
Identifie la propriété IsKeyboardFocusable , qui est une valeur booléenne qui indique si l’élément Automation peut accepter le focus clavier. Type Variant : VT_BOOL Valeur par défaut : false |
|
Identifie la propriété IsOffscreen , qui est une valeur booléenne qui indique si l’élément Automation est entièrement défilant de l’affichage (par exemple, un élément d’une zone de liste qui se trouve en dehors de la fenêtre d’affichage de l’objet conteneur) ou s’il est réduit hors 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 de clic qui peut provoquer le focus, l’élément est considéré comme étant à l’écran alors 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 si l’élément est visible sur une analyse spécifique. Si la propriété IsOffscreen a la valeur true, l’élément d’interface utilisateur est défilant hors de l’écran ou réduit. L’élément est temporairement masqué, mais il reste dans la perception de l’utilisateur final et continue à être inclus dans le modèle d’interface utilisateur. L’objet peut être rétabli en mode de défilement, en cliquant sur une liste déroulante, et ainsi de suite. Les objets que l’utilisateur final ne perçoivent pas du tout, ou qui sont " masqués par programmation " (par exemple, une boîte de dialogue qui a été fermée, mais l’objet sous-jacent est toujours mis en cache par l’application) ne doivent pas figurer dans l’arborescence des éléments Automation (au lieu de définir l’état de IsOffscreen sur true). Type Variant : VT_BOOL Valeur par défaut : false |
|
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 l’écho du clavier ou les commentaires d’entrée au clavier qui peuvent 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 provoquer une erreur. Type Variant : VT_BOOL Valeur par défaut : false |
|
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 du périphérique apparaît et prend en charge l’interaction de l’utilisateur, mais ne prend pas le focus clavier lorsqu’il apparaît. Les fenêtres contextuelles, les lanceurs, les menus contextuels ou les notifications flottantes sont des exemples d’interface utilisateur. 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 à ces types de contrôles :
Valeur par défaut : false |
|
Identifie la propriété IsRequiredForForm , qui est une valeur booléenne qui indique si l’élément Automation doit obligatoirement être renseigné sur un formulaire. Type Variant : VT_BOOL Valeur par défaut : false |
|
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 communique l’état d’un élément, ainsi que l’État. 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 Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
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 d’une vue de répertoire de fichiers peut être un " fichier de document " ou un " dossier " . Quand 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 Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
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 pour une zone de liste déroulante. Type Variant : VT_UNKNOWN Valeur par défaut : null |
|
Identifie la propriété LandmarkType , qui est un identificateur de type 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 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 requis pour décrire le repère personnalisé. Type Variant : VT_I4 Valeur par défaut : 0 |
|
Identifie la propriété de niveau , 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 de structures hiérarchiques rompues. Par exemple, une liste à puces/numérotées, des en-têtes ou d’autres éléments de données structurées peuvent avoir plusieurs relations parent/enfant. Le niveau 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 Variant : VT_I4 Valeur par défaut : 0 |
|
Identifie la propriété LiveSetting , qui est prise en charge par un élément Automation qui représente une zone dynamique. La propriété LiveSetting indique le " niveau de poli " qu’un client doit utiliser pour informer l’utilisateur des modifications apportées à la zone dynamique. Cette propriété peut être l’une des valeurs de l’énumération LiveSetting . Pris en charge à partir de Windows 8. Type Variant : VT_I4 Valeur par défaut : 0 |
|
Identifie la propriété LocalizedControlType , qui est une chaîne de texte décrivant le type de contrôle représenté par l’élément Automation. La chaîne ne doit contenir que des caractères minuscules :
Quand 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ée qui représente le rôle de l’élément (par exemple, un " Sélecteur " de couleurs pour un contrôle personnalisé qui permet aux utilisateurs de choisir et de spécifier des couleurs). Quand une valeur personnalisée est fournie, la chaîne doit correspondre à la langue de l’interface utilisateur de l’application ou à la langue de l’interface utilisateur par défaut du système d’exploitation. Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie le LocalizedLandmarkType, qui est une chaîne de texte décrivant le type d’élément géographique représenté par l’élément Automation. Cela doit être utilisé en tandem avec UIA_CustomLandmarkTypeId Toutefois, LocalizedLandmarkType doit toujours avoir la priorité sur LandmarkType et être utilisé pour décrire le repère avant LandmarkType. La chaîne doit correspondre à la langue de l’interface utilisateur de l’application ou à la langue de l’interface utilisateur par défaut du système d’exploitation. Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
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 la même que le texte de l’étiquette à l’écran. Par exemple, le nom doit être " Rechercher " un élément Button avec l’étiquette " Browse " . La propriété Name ne doit pas inclure le caractère mnémonique pour les touches d’accès (autrement dit, " & " ), qui est souligné dans la présentation 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 utilisateurs et les applications clientes. Lorsque le texte de l’étiquette correspondant n’est pas visible à l’écran ou lorsqu’il est remplacé par des graphiques, vous devez choisir le texte de remplacement. 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 visuels, mais une description concise de la fonction ou de la fonctionnalité de l’interface utilisateur comme si elle était étiquetée par du texte simple. par exemple, le bouton menu Démarrer Windows s’intitule " démarrer " (bouton) au lieu de " Windows Logo dans le bouton bleu round sphere graphics " (button). Pour plus d’informations, consultez création d’équivalents de texte pour les images. Quand une étiquette d’interface utilisateur utilise des graphiques de texte (par exemple, à l’aide " >> " d’un bouton qui ajoute un élément de gauche à droite), la propriété Name doit être remplacée par une alternative textuelle appropriée (par exemple, " Add " ). Toutefois, la pratique consistant à utiliser des graphiques de texte comme étiquette d’interface utilisateur est déconseillée en raison des problèmes de localisation et d’accessibilité. La propriété Name ne doit pas inclure les informations de rôle ou de type de contrôle, telles que " Button " ou " List " ; sinon, elle 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 en tant qu’identificateur unique parmi les frères. Toutefois, tant qu’il est cohérent avec la présentation de l’interface utilisateur, la même valeur de nom peut être prise en charge parmi les homologues. 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 la même propriété Name que le texte affiché dans le contrôle, tant que le modèle de texte est également pris en charge. Type Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété NativeWindowHandle , qui est un entier qui représente le handle (HWND) de la fenêtre de l’élément Automation, le cas échéant ; dans le cas contraire, cette propriété a la valeur 0. Type Variant : VT_I4 Valeur par défaut : 0 |
|
Identifie la propriété OptimizeForVisualContent , qui est une valeur booléenne qui indique si le fournisseur expose uniquement les éléments qui sont 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 parcourt une grande partie du 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 UIA_E_ELEMENTNOTAVAILABLE code d’erreur. Pris en charge à partir de Windows 8. Type Variant : VT_BOOL Valeur par défaut : false |
|
Identifie la propriété d' 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. Dans le cas contraire, il peut toujours être OrientationType_None, ce qui signifie que le contrôle n’a pas d’orientation. Type Variant : VT_I4 Valeur par défaut : 0 (OrientationType_None) |
|
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é en tant que COLORREF, valeur 32 bits utilisée pour spécifier une couleur RVB ou RVBA. Type Variant : VT_I4 | VT_ARRAY Valeur par défaut : 0 |
|
Identifie la propriété OutlineThickness , qui spécifie la largeur du contour de l’élément Automation. Type Variant : VT_R8 | VT_ARRAY Valeur par défaut : VT_EMPTY |
|
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 qui sont considérés comme des frères. PositionInSet fonctionne en coordination avec la propriété SizeOfSet pour décrire l’emplacement ordinal dans le jeu. Type Variant : VT_I4 Valeur par défaut : 0 |
|
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 assigné par le système d’exploitation. Vous pouvez le voir dans la colonne PID de l’onglet processus du gestionnaire des tâches. Type Variant : VT_I4 Valeur par défaut : 0 |
|
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 Variant : VT_BSTR Valeur par défaut : chaîne vide |
|
Identifie la propriété de rotation , qui spécifie l’angle de rotation en unités non spécifiées. Type Variant : VT_R8 Valeur par défaut : 0 |
|
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 est unique 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 pour la comparaison ; par exemple, pour déterminer si un élément Automation se trouve dans le cache. Type Variant : VT_I4 | VT_ARRAY Valeur par défaut : VT_EMPTY |
|
Identifie la propriété Size , qui spécifie la largeur et la hauteur de l’élément Automation. Type Variant : VT_R8 | VT_ARRAY Valeur par défaut : VT_EMPTY |
|
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 d’un groupe ou d’un ensemble qui sont considérés comme des frères. SizeOfSet fonctionne en coordination avec la propriété PositionInSet pour décrire le nombre d’éléments dans le jeu. Type Variant : VT_I4 Valeur par défaut : 0 |
|
Identifie la propriété VisualEffects , qui est un champ de bits qui spécifie les effets sur l’élément Automation, tels que l’ombre, la réflexion, la lueur, les bords adoucis ou le biseau. VisualEffects:
Valeur par défaut : 0 |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Applications de bureau XP pour applications [ | UWP] |
| Serveur minimal pris en charge |
Windows Applications de bureau du serveur 2003 [ | applications UWP] |
| En-tête |
|