Share via

Modifier le type de contrôle

  • Article

Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle Modifier.

Les contrôles Edit permettent à un utilisateur d’afficher et modifier une simple ligne de texte sans une prise en charge évoluée de la mise en forme.

Les sections suivantes définissent les UI Automation l’arborescence, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle d’édition. Les exigences UI Automation s’appliquent à tous les contrôles de modification où l’infrastructure/plateforme de l’interface utilisateur intègre UI Automation prise en charge des types de contrôles et des modèles de contrôle.

Cette rubrique contient les sections suivantes.

Structure d’arborescence classique

Le tableau suivant illustre une vue de contrôle et de contenu typique de l’arborescence UI Automation relative 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.

Affichage de contrôle Affichage de contenu
  • Modifier
  • Modifier

 

Les contrôles qui implémentent le type de contrôle Modifier n’auront toujours aucune barre de défilement dans la vue de contrôle de l’arborescence UI Automation, car il s’agit d’un contrôle à une seule ligne. Dans certains scénarios de disposition, la ligne de texte unique peut faire l’objet d’un retour automatique à la ligne. Le type de contrôle Modifier est uniquement destiné à 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 de modification. Pour plus d’informations sur les propriétés UI Automation, consultez Récupération des propriétés à partir d’éléments UI Automation.

Propriété UI Automation Valeur Notes
UIA_AutomationIdPropertyId Consultez les remarques. 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 remarques. Rectangle externe qui contient l’ensemble du contrôle.
UIA_ClickablePointPropertyId Consultez les remarques. Le contrôle d’édition doit avoir un point interactif qui donne le focus d’entrée à la partie d’édition du contrôle quand un utilisateur clique dessus avec la souris.
UIA_ControlTypePropertyId Modifier
UIA_IsContentElementPropertyId TRUE Le contrôle d’édition est toujours inclus dans l’affichage du contenu de l’arborescence UI Automation.
UIA_IsControlElementPropertyId TRUE Le contrôle d’édition est toujours inclus dans l’affichage du contrôle d’arborescence UI Automation.
UIA_IsKeyboardFocusablePropertyId Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
UIA_IsPasswordPropertyId Consultez les remarques. Doit avoir la valeur TRUE sur les contrôles de modification qui contiennent des mots de passe. Si un contrôle d’édition contient du contenu de 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.
UIA_LabeledByPropertyId Consultez les remarques. Si une étiquette de texte statique est 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 propriété LabeledBy définie.
UIA_LocalizedControlTypePropertyId Consultez les remarques. Chaîne localisée correspondant au type de contrôle Modifier . La valeur par défaut est « edit » pour en-US ou English (États-Unis).
UIA_NamePropertyId Consultez les remarques. Le nom du contrôle d’édition est habituellement 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 Name doit être attribuée par le développeur d’application. 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 qui doivent être pris en charge par les contrôles de modification. Pour plus d’informations sur les modèles de contrôle, consultez UI Automation Control Patterns Overview.

Modèle de contrôle/Propriété de modèle 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 remarques. 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 remarques. 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 remarques. Cette propriété doit indiquer le nombre de décimales pouvant être défini pour la valeur. Si le contrôle d’édition accepte uniquement des entiers, la valeur de la 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’est pas tenue d’être exposée sur un contrôle d’édition.
Valeur Consultez les remarques. 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.
ITextProvider Obligatoire Tous les contrôles d’édition doivent prendre en charge le modèle de contrôle Texte , car des 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 Value .
IsReadOnly Consultez les remarques. Cette propriété doit être définie pour indiquer si le contrôle peut avoir une valeur définie par programmation ou qui peut être modifiée par l’utilisateur.
Valeur Consultez les remarques. Cette propriété contient le contenu textuel du contrôle d’édition. Si la propriété UIA_IsPasswordPropertyId a la valeur TRUE, l’interrogation de la propriété Value doit renvoyer une erreur.

 

Événements obligatoires

Le tableau suivant répertorie les événements UI Automation que les contrôles de modification doivent prendre en charge. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.

É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 Scroll .
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 Scroll .
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 Scroll .
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 Scroll .
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 Scroll .
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 Scroll .
UIA_StructureChangedEventId
UIA_Text_TextChangedEventId Si le contrôle prend en charge le modèle de contrôle Texte , il doit prendre en charge cet événement.
UIA_Text_TextSelectionChangedEventId Si le contrôle prend en charge le modèle de contrôle Texte , 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 Value , il doit prendre en charge cet événement.

 

Notes

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é en tant que texte d’espace réservé. Par exemple, la barre d’adresse windows Internet Explorer contient le texte « about:Tabs » lorsqu’un nouvel onglet est ouvert. Il ne s’agit pas de HelpText , car il s’agit d’une adresse programmatique qui peut être utilisée ou modifiée par l’utilisateur.

Conceptuel

Vue d'ensemble des types de contrôle UI Automation

Vue d'ensemble d'UI Automation