Partager via

Type de contrôle de texte

  • Article

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

Un contrôle de texte est un élément d’interface utilisateur de base qui représente un morceau de texte à l’écran.

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 Text. Les exigences UI Automation s’appliquent à tous les contrôles d’arborescence où l’infrastructure/la plateforme d’interface utilisateur intègre la prise en charge d’UI Automation pour les types de contrôle et les modèles de contrôle.

Cette rubrique contient les sections suivantes.

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 texte 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
  • SMS
  • Texte (si le contenu)

 

Un contrôle de texte peut être utilisé seul en tant qu’étiquette ou en tant que texte statique sur un formulaire. Il peut également être contenu dans la structure de l’un des éléments suivants :

Les contrôles de texte peuvent ne pas apparaître dans la vue de contenu de l’arborescence UI Automation, car le texte est souvent affiché via la propriété Name d’un autre contrôle. Par exemple, le texte utilisé pour étiqueter un contrôle de zone de liste modifiable est exposé via la propriété Name du contrôle. Étant donné que le contrôle de zone de liste modifiable se trouve dans l’affichage de contenu de l’arborescence UI Automation, le contrôle de texte n’a pas besoin d’être là. Les contrôles de texte peuvent avoir des enfants dans la vue de contenu s’il existe un objet incorporé tel qu’un lien hypertexte.

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 texte. 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. Prise en charge s’il existe un rectangle englobant. Si aucun point dans le rectangle englobant n’est cliquable et que l’élément effectue des tests de positionnement spécialisés, remplacez et fournissez un point cliquable.
UIA_ControlTypePropertyId texte
UIA_IsContentElementPropertyId Dépend Le contrôle de texte est du contenu s’il contient des informations non exposées dans la propriété Name d’un autre contrôle.
UIA_IsControlElementPropertyId VRAI Le contrôle de texte doit toujours être un contrôle.
UIA_IsKeyboardFocusablePropertyId Consultez les notes. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
UIA_LabeledByPropertyId ZÉRO Les contrôles de texte n’ont pas d’étiquette de texte statique.
UIA_LocalizedControlTypePropertyId Consultez les notes. Chaîne localisée correspondant au type de contrôle texte. La valeur par défaut est « text » pour en-US ou l’anglais (États-Unis).
UIA_NamePropertyId Consultez les notes. Le nom d’un contrôle de texte peut être le texte qu’il affiche. Toutefois, si le contrôle prend également en charge le modèle de texte et que le texte est étendu, n’utilisez pas le contenu de texte intégral comme valeur Name. Au lieu de cela, fournissez une valeur Name plus courte, dérivée d’autres propriétés de votre contrôle.

 

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 texte. 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 Soutien Notes
IGridItemProvider Dépend Si le contrôle de texte est contenu dans un contrôle de table, le modèle de contrôle GridItem doit être pris en charge.
ITableItemProvider Dépend Si le contrôle de texte est contenu dans un contrôle de table, le modèle de contrôle TableItem doit être pris en charge.
ITextProvider Dépend Le texte doit prendre en charge le modèle de contrôle texte pour une meilleure accessibilité ; toutefois, il n’est pas nécessaire. Le modèle de contrôle Texte est utile lorsque le texte a un style et des attributs enrichis (par exemple, couleur, gras et italique).
IValueProvider Jamais Un contrôle de texte ne prend jamais en charge le modèle de contrôle valeur. Si le texte est modifiable, il s’agit du type de contrôle Modifier.

 

Événements obligatoires

Le tableau suivant répertorie les événements UI Automation nécessaires à la prise en charge des contrôles de texte. 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_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.

 

conceptuelle

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

Vue d’ensemble UI Automation