Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Remarque
Cette documentation est destinée aux développeurs .NET Framework qui souhaitent utiliser les classes UI Automation managées définies dans l’espace de noms System.Windows.Automation. Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation.
Cette rubrique fournit des informations sur la prise en charge d’UI Automation pour le type de contrôle Edit. Dans UI Automation, un type de contrôle est un ensemble de conditions qu’un contrôle doit respecter pour utiliser la ControlTypeProperty propriété. Les conditions incluent des instructions spécifiques pour la structure d’arborescence UI Automation, les valeurs des propriétés UI Automation et les modèles de contrôle.
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 Edit. Les exigences UI Automation s’appliquent à tous les contrôles de modification, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.
Arborescence UI Automation obligatoire
Le tableau suivant illustre la vue de contrôle et la vue de contenu 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 |
|---|---|
| Éditer | Éditer |
Les contrôles qui implémentent le type de contrôle Edit disposent toujours de barres de défilement nulles dans la vue de 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 type de contrôle Edit convient le mieux pour contenir de petites quantités de texte modifiables ou sélectionnables.
Propriétés UI Automation obligatoires
Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour modifier les contrôles. Pour plus d’informations sur les propriétés UI Automation, consultez Propriétés UI Automation pour les clients.
| Propriété UI Automation | Valeur | Remarques |
|---|---|---|
| AutomationIdProperty | Consultez les notes. | La valeur de cette propriété doit être unique sur tous les contrôles d’une application. |
| BoundingRectangleProperty | Consultez les notes. | Rectangle le plus externe qui contient l’ensemble du contrôle. |
| ClickablePointProperty | 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. |
| IsKeyboardFocusableProperty | Consultez les notes. | Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
| NameProperty | 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, le développeur d’applications doit affecter une valeur de propriété à Name. La Name propriété ne doit jamais contenir le contenu textuel du contrôle d’édition. |
| LabeledByProperty | 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 jeu de propriétés. |
| ControlTypeProperty | Éditer | Cette valeur est la même pour toutes les infrastructures d’interface utilisateur. |
| LocalizedControlTypeProperty | « édition » | Chaîne localisée correspondant au type de contrôle Edit. |
| IsContentElementProperty | Vrai | Le contrôle d’édition est toujours inclus dans la vue de contenu de l’arborescence UI Automation. |
| IsControlElementProperty | Vrai | Le contrôle d’édition est toujours inclus dans la vue de contrôle de l’arborescence UI Automation. |
| IsPasswordProperty | Consultez les notes. | Doit être défini sur true sur les contrôles d’édition 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. |
Modèles et propriétés de contrôle UI Automation requis
Le tableau suivant répertorie les modèles de contrôle requis pour être pris en charge par tous les contrôles d’édition. Pour plus d’informations sur les modèles de contrôle, consultez Vue d’ensemble des modèles de contrôle UI Automation.
| Modèle de contrôle/Propriété du modèle de contrôle | Prise en charge/valeur | Remarques |
|---|---|---|
| ITextProvider | Dépend | Les contrôles d’édition doivent prendre en charge le modèle de contrôle Texte, car les informations de texte détaillées doivent toujours être disponibles pour les clients. |
| IValueProvider | Dépend | Tous les contrôles d’édition qui utilisent une chaîne doivent exposer le modèle Value. |
| 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 est modifiable par l’utilisateur. |
| Value | Consultez les notes. | Cette propriété retourne le contenu textuel du contrôle d’édition. Si IsPasswordProperty est défini à true, cette propriété doit déclencher un InvalidOperationException lorsqu'on le demande. |
| IRangeValueProvider | Dépend | Tous les contrôles de saisie qui prennent une plage numérique doivent exposer le modèle de contrôle de valeur de plage. |
| Minimum | Consultez les notes. | Cette propriété doit être la plus petite valeur sur 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 sur 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 la modification prend uniquement des entiers, la SmallChangeProperty valeur doit être 1. Si la modification prend une plage comprise entre 1.0 et 2.0, la SmallChangeProperty valeur doit être 0.1. Si le contrôle d’édition prend une plage comprise entre 1.00 et 2.00, la SmallChangeProperty valeur doit être 0.001. |
| LargeChange | Null |
Cette propriété n’a pas besoin d’être exposée sur un contrôle d’édition. |
| Value | 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 les propriétés Minimum et Maximum, la propriété Value est automatiquement arrondie à la valeur acceptée la plus proche. |
Événements UI Automation obligatoires
Le tableau suivant répertorie les événements UI Automation requis pour être pris en charge par tous les contrôles d’édition. Pour plus d’informations sur les événements, consultez Vue d’ensemble des événements UI Automation.
| Événement UI Automation | Soutien | Remarques |
|---|---|---|
| InvalidatedEvent | Obligatoire | Aucun |
| TextSelectionChangedEvent | Obligatoire | Aucun |
| TextChangedEvent | Obligatoire | Aucun |
| Événement de modification de la propriété BoundingRectangleProperty. | Obligatoire | Aucun |
| Événement de modification de la propriété IsOffscreenProperty. | Obligatoire | Aucun |
| Événement de modification de la propriété IsEnabledProperty. | Obligatoire | Aucun |
| Événement de modification de la propriété NameProperty. | Obligatoire | Aucun |
| Événement de modification de la propriété ValueProperty. | Dépend | Aucun |
| Événement de modification de la propriété HorizontallyScrollableProperty. | Jamais | Aucun |
| Événement de modification de la propriété HorizontalScrollPercentProperty. | Jamais | Aucun |
| Événement de modification de la propriété HorizontalViewSizeProperty. | Jamais | Aucun |
| Événement de modification de la propriété VerticalScrollPercentProperty. | Jamais | Aucun |
| Événement de modification de la propriété VerticallyScrollableProperty. | Jamais | Aucun |
| Événement de modification de la propriété VerticalViewSizeProperty. | Jamais | Aucun |
| Événement de modification de la propriété ValueProperty. | Dépend | Si le contrôle prend en charge le modèle de contrôle Range Value, il doit prendre en charge cet événement. |
| AutomationFocusChangedEvent | Obligatoire | Aucun |
| StructureChangedEvent | Obligatoire | Aucun |
Voir aussi
- Edit
- Vue d’ensemble des types de contrôle UI Automation
- Vue d’ensemble UI Automation