Modifier le type de contrôle
Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle Modifier.
Les contrôles De modification permettent à un utilisateur d’afficher et de modifier une ligne de texte simple sans prise en charge de la mise en forme enrichie.
Les sections suivantes définissent la structure d’arborescence, les propriétés, les modèles de contrôle et les événements UI Automation requis pour le type de contrôle d’édition. Les exigences UI Automation s’appliquent à tous les contrôles d’édition dans lesquels l’infrastructure/la plateforme d’interface utilisateur intègre la prise en charge d’UI Automation pour les types de contrôles et les modèles de contrôle.
Cette rubrique contient les sections suivantes.
- structure d’arborescence classique
- propriétés pertinentes
- modèles de contrôle requis
- événements obligatoires
- Remarques
- rubriques connexes
Structure d’arborescence classique
Le tableau suivant illustre un contrôle et une vue de contenu typiques de l’arborescence UI Automation qui se rapporte aux contrôles de modification et décrit ce qui peut être contenu dans chaque vue. Pour plus d’informations sur l’arborescence UI Automation, consultez vue d’ensemble de l’arborescence UI Automation.
| Vue contrôle | Affichage de contenu |
|---|---|
|
|
Les contrôles qui implémentent l'Modifier type de contrôle ont toujours zéro barres de défilement dans l’affichage contrôle de l’arborescence UI Automation, car il s’agit d’un contrôle à ligne unique. La ligne de texte unique peut s’encapsuler dans certains scénarios de disposition. Le Modifier type de contrôle est destiné uniquement à de petites quantités de texte.
Propriétés pertinentes
Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour les contrôles d’édition. Pour plus d’informations sur les propriétés UI Automation, consultez Récupération des propriétés à partir d’UI Automation Elements.
| UI Automation, propriété | Valeur | Notes |
|---|---|---|
| UIA_AutomationIdPropertyId | Consultez les notes. | La valeur de cette propriété doit être unique parmi tous les éléments homologues dans la vue brute de l’arborescence UI Automation. |
| UIA_BoundingRectanglePropertyId | Consultez les notes. | Rectangle le plus externe qui contient l’ensemble du contrôle. |
| UIA_ClickablePointPropertyId | Consultez les notes. | Le contrôle d’édition doit avoir un point cliquable qui donne le focus d’entrée à la partie d’édition du contrôle lorsqu’un utilisateur clique sur la souris. |
| UIA_ControlTypePropertyId | Modifier | |
| UIA_IsContentElementPropertyId | TRUE | Le contrôle d’édition est toujours inclus dans la vue de contenu de l’arborescence UI Automation. |
| UIA_IsControlElementPropertyId | TRUE | Le contrôle d’édition est toujours inclus dans la vue de contrôle de l’arborescence UI Automation. |
| UIA_IsKeyboardFocusablePropertyId | Consultez les notes. | Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
| UIA_IsPasswordPropertyId | Consultez les notes. | Doit être défini sur TRUE sur les contrôles de modification qui contiennent des mots de passe. Si un contrôle d’édition contient le contenu du mot de passe, cette propriété peut être utilisée par un lecteur d’écran pour déterminer si les séquences de touches doivent être lues en tant qu’utilisateur les tape. |
| UIA_LabeledByPropertyId | Consultez les notes. | S’il existe une étiquette de texte statique associée au contrôle, cette propriété doit exposer une référence à ce contrôle. Si le contrôle de texte est un sous-composant d’un autre contrôle, il n’aura pas de LabeledBy propriété définie. |
| UIA_LocalizedControlTypePropertyId | Consultez les notes. | Chaîne localisée correspondant au type de contrôle Edit. La valeur par défaut est « edit » pour en-US ou l’anglais (États-Unis). |
| UIA_NamePropertyId | Consultez les notes. | Le nom du contrôle d’édition est généralement généré à partir d’une étiquette de texte statique. S’il n’existe pas d’étiquette de texte statique, une valeur de propriété pour Nom doit être affectée par le développeur d’applications. La propriété Name ne doit jamais contenir le contenu textuel du contrôle d’édition. |
Modèles de contrôle requis
Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par les contrôles de modification. Pour plus d’informations sur les modèles de contrôle, consultez Vue d’ensemble des modèles de contrôle UI Automation.
| Control Pattern/Pattern, propriété | Prise en charge/valeur | Notes |
|---|---|---|
| IRangeValueProvider | Dépend | Tous les contrôles de modification qui prennent une plage numérique doivent exposer le modèle de contrôle RangeValue . |
| minimum | Consultez les notes. | Cette propriété doit être la plus petite valeur à laquelle le contenu du contrôle d’édition peut être défini. |
| maximum | Consultez les notes. | Cette propriété doit être la plus grande valeur à laquelle le contenu du contrôle d’édition peut être défini. |
| SmallChange | Consultez les notes. | Cette propriété doit indiquer le nombre de décimales sur lesquels la valeur peut être définie. Si le contrôle d’édition prend uniquement des entiers, la valeur de propriété SmallChange doit être 1. Si le contrôle d’édition prend une plage comprise entre 1.0 et 2.0, la valeur de la propriété SmallChange doit être 0.1. Si le contrôle d’édition prend une plage comprise entre 1.00 et 2.00, la valeur de la propriété SmallChange doit être 0,001. |
| LargeChange | NULL | Cette propriété n’a pas besoin d’être exposée sur un contrôle d’édition. |
| valeur | Consultez les notes. | Cette propriété indique le contenu numérique du contrôle d’édition. Lorsqu’une valeur plus précise est définie par un client UI Automation dans les plages spécifiées dans le minimum et les propriétés Maximum, la propriété Valeur est automatiquement arrondie à la valeur acceptée la plus proche. |
| ITextProvider | Obligatoire | Tous les contrôles d’édition doivent prendre en charge le modèle de contrôle texte, car les informations détaillées doivent toujours être disponibles pour les clients de technologie d’assistance. |
| IValueProvider | Dépend | Tous les contrôles d’édition qui prennent une chaîne doivent exposer le modèle de contrôle Valeur. |
| IsReadOnly | Consultez les notes. | Cette propriété doit être définie pour indiquer si le contrôle peut avoir une valeur définie par programme ou qui peut être modifiée par l’utilisateur. |
| valeur | Consultez les notes. | Cette propriété contient le contenu textuel du contrôle d’édition. Si la propriété UIA_IsPasswordPropertyId est définie sur TRUE, l’interrogation de la propriété Value doit retourner une erreur. |
Événements obligatoires
Le tableau suivant répertorie les événements UI Automation qui modifient les contrôles sont nécessaires à la prise en charge. Pour plus d’informations sur les événements, consultez vue d’ensemble des événements UI Automation.
| Événement UI Automation | Notes |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId événement de modification de propriété. | |
| UIA_IsEnabledPropertyId événement de modification de propriété. | Si le contrôle prend en charge la propriété IsEnabled, il doit prendre en charge cet événement. |
| UIA_IsOffscreenPropertyId événement de modification de propriété. | Si le contrôle prend en charge la propriété IsOffscreen, il doit prendre en charge cet événement. |
| UIA_NamePropertyId événement de modification de propriété. | |
| UIA_RangeValueValuePropertyId événement de modification de propriété. | Si le contrôle prend en charge le modèle de contrôle RangeValue, il doit prendre en charge cet événement. |
| UIA_ScrollHorizontallyScrollablePropertyId événement de modification de propriété. | Un contrôle d’édition ne prend jamais en charge le modèle de contrôle de défilement. |
| UIA_ScrollHorizontalScrollPercentPropertyId événement de modification de propriété. | Un contrôle d’édition ne prend jamais en charge le modèle de contrôle de défilement. |
| UIA_ScrollHorizontalViewSizePropertyId événement de modification de propriété. | Un contrôle d’édition ne prend jamais en charge le modèle de contrôle de défilement. |
| UIA_ScrollVerticallyScrollablePropertyId événement de modification de propriété. | Un contrôle d’édition ne prend jamais en charge le modèle de contrôle de défilement. |
| UIA_ScrollVerticalScrollPercentPropertyId événement de modification de propriété. | Un contrôle d’édition ne prend jamais en charge le modèle de contrôle de défilement. |
| UIA_ScrollVerticalViewSizePropertyId événement de modification de propriété. | Un contrôle d’édition ne prend jamais en charge le modèle de contrôle de défilement. |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Si le contrôle prend en charge le modèle de contrôle Text, il doit prendre en charge cet événement. |
| UIA_Text_TextSelectionChangedEventId | Si le contrôle prend en charge le modèle de contrôle Text, il doit prendre en charge cet événement. |
| UIA_ValueValuePropertyId événement de modification de propriété . | Si le contrôle prend en charge le modèle de contrôle valeur, il doit prendre en charge cet événement. |
Remarques
Un contrôle d’édition peut être utilisé comme champ de texte en lecture seule qui ne prend pas en charge la sélection ou la modification de texte. Un tel contrôle d’édition se comporte comme un objet de champ qui a un nom et une valeur spécifiques.
Si un contrôle d’édition contient du texte d’espace réservé (par exemple, une bannière d’indicateur), le texte doit être utilisé comme propriété HelpText, sauf si le texte peut être modifié par l’utilisateur, puis réutilisé comme texte d’espace réservé. Par exemple, la barre d’adresses Windows Internet Explorer contient le texte « about :Tabs » lorsqu’un nouvel onglet est ouvert. Cela n’est pas HelpText, car il s’agit d’une adresse programmatique qui peut être utilisée ou modifiée par l’utilisateur.
Rubriques connexes
-
conceptuelle
-
Vue d’ensemble UI Automation