Prise en charge d'UI Automation pour le type de contrôle Edit
.gif "Remarque") Remarque |
|---|
Cette documentation s'adresse aux développeurs .NET Framework qui veulent 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 (page éventuellement en anglais). |
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 afin d'utiliser la propriété ControlTypeProperty. Les conditions incluent des instructions spécifiques pour l'arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôle.
Les contrôles d'édition permettent à un utilisateur d'afficher et modifier une ligne de texte simple sans prise en charge de la mise en forme enrichie.
Les sections suivantes définissent l'arborescence UI Automation, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle Edit. Les spécifications UI Automation s'appliquent à tous les contrôles d'édition, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou de Windows Forms.
Cette rubrique comprend les sections suivantes.
- Arborescence UI Automation requise
- Propriétés UI Automation requises
- Modèles de contrôle et propriétés UI Automation requis
- Événements UI Automation requis
- Rubriques connexes
Arborescence UI Automation requise
Le tableau suivant représente l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation concernant les contrôles d'édition et décrit ce qui peut être inclus dans chaque affichage. Pour plus d'informations sur l'arborescence UI Automation, consultez Vue d'ensemble de l'arborescence UI Automation.
Affichage de contrôle |
Affichage du contenu |
|---|---|
Modifier |
Modifier |
Les contrôles qui implémentent le type de contrôle Edit n'auront jamais de barre de défilement dans l'affichage de contrôle de l'arborescence UI Automation car il s'agit d'un contrôle sur une ligne. Dans certains scénarios de disposition, la ligne de texte peut être encapsulée. Le type de contrôle Edit est parfaitement adapté pour la maintenance de petites quantités de texte modifiable ou sélectionnable.
Propriétés UI Automation requises
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 Propriétés UI Automation pour les clients.
Propriété UI Automation |
Valeur |
Remarques |
|---|---|---|
Consulter les remarques. |
La valeur de cette propriété doit être unique dans tous les contrôles d'une application. |
|
Consulter les remarques. |
Le rectangle le plus éloigné qui contient l'ensemble du contrôle. |
|
Consulter les remarques. |
Le contrôle d'édition doit disposer d'un point interactif qui donne le focus d'entrée à la partie d'édition du contrôle lorsqu'un utilisateur clique dessus avec la souris. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Consulter les remarques. |
En général, le nom du contrôle d'édition est généré à partir d'une étiquette de texte statique. S'il n'y a pas d'étiquette de texte statique, le développeur de l'application doit assigner une valeur de propriété pour Name. La propriété Name ne doit jamais contenir les contenus textuels du contrôle d'édition. |
|
Consulter les remarques. |
Si le contrôle est associé à une étiquette de texte statique, 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, aucune propriété LabeledBy ne sera définie. |
|
Modifier |
Cette valeur est la même pour toutes les infrastructures d'UI. |
|
"edit" |
Chaîne localisée correspondant au type de contrôle Edit. |
|
True |
Le contrôle d'édition est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation. |
|
True |
Le contrôle d'édition est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation. |
|
Consulter les remarques. |
Elle doit avoir la valeur true pour les contrôles d'édition qui contiennent des mots de passe. Si un contrôle d'édition contient du contenu 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 au moment où l'utilisateur les tape. |
Modèles de contrôle et propriétés UI Automation requis
Le tableau suivant répertorie les modèles de contrôle qui doivent ê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 |
|---|---|---|
Selon le cas |
Les contrôles d'édition doivent prendre en charge le modèle de contrôle Text parce que les informations de texte détaillées doivent toujours être disponibles pour les clients. |
|
Selon le cas |
Tous les contrôles d'édition qui utilisent une chaîne doivent exposer le modèle Value. |
|
Consulter les remarques. |
Cette propriété doit être configurée pour indiquer si le contrôle peut avoir une valeur définie par programmation ou est modifiable par l'utilisateur. |
|
Consulter les remarques. |
Cette propriété retournera le contenu textuel du contrôle d'édition. Si IsPasswordProperty a la valeur true, cette propriété doit déclencher une InvalidOpertaionException lorsqu'on lui demande. |
|
Selon le cas |
Tous les contrôles d'édition qui utilisent une plage numérique doivent exposer le modèle de contrôle Range Value. |
|
Consulter les remarques. |
Cette propriété doit être la plus petite valeur pouvant être affectée au contenu du contrôle d'édition. |
|
Consulter les remarques. |
Cette propriété doit être la plus grande valeur pouvant être affectée au contenu du contrôle d'édition. |
|
Consulter les remarques. |
Cette propriété doit indiquer le nombre de décimales pouvant être défini pour la valeur. Si la modification accepte uniquement les entiers, le SmallChangeProperty doit avoir la valeur 1. Si la modification accepte une plage entre 1.0 et 2.0, le SmallChangeProperty doit avoir la valeur 0.1. Si le contrôle d'édition accepte une plage entre 1.00 et 2.00, le SmallChangeProperty doit avoir la valeur 0.001. |
|
Null |
Cette propriété ne doit pas forcément être exposée sur un contrôle d'édition. |
|
Consulter les remarques. |
Cette propriété indiquera 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 des propriétés Minimum et Maximum, la propriété Value sera automatiquement arrondie à la valeur acceptée la plus proche. |
Événements UI Automation requis
Le tableau suivant répertorie les événements UI Automation qui doivent ê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 |
Prise en charge |
Remarques |
|---|---|---|
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |
|
Événement de modification de propriété BoundingRectangleProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété IsOffscreenProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété IsEnabledProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété NameProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété ValueProperty. |
Selon le cas |
Aucun |
Événement de modification de propriété HorizontallyScrollableProperty. |
Jamais |
Aucun |
Événement de modification de propriété HorizontalScrollPercentProperty. |
Jamais |
Aucun |
Événement de modification de propriété HorizontalViewSizeProperty. |
Jamais |
Aucun |
Événement de modification de propriété VerticalScrollPercentProperty . |
Jamais |
Aucun |
Événement de modification de propriété VerticallyScrollableProperty. |
Jamais |
Aucun |
Événement de modification de propriété VerticalViewSizeProperty. |
Jamais |
Aucun |
Événement de modification de propriété ValueProperty. |
Selon le cas |
Si le contrôle prend en charge le modèle de contrôle Range Value, il doit prendre en charge cet événement. |
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |