Type de contrôle texte

  • Article

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

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 les UI Automation l’arborescence, les propriétés, les modèles de contrôle et les événements nécessaires pour le type de contrôle Text. Les exigences UI Automation s’appliquent à tous les contrôles d’arborescence où l’infrastructure/plateforme d’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 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.

Affichage de contrôle Affichage de contenu
  • Texte
  • Text (s’il s’agit de contenu)

 

Un contrôle de texte peut être utilisé seul comme étiquette ou texte statique dans 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 l’affichage 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 la vue 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 l’affichage 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’é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. Pris en charge s’il existe un rectangle englobant. Si tous les points du rectangle englobant ne sont pas cliquables et que l’élément effectue des tests d’accès spécialisés, remplacez et fournissez un point cliquable.
UIA_ControlTypePropertyId Text
UIA_IsContentElementPropertyId Dépend Le contrôle de texte est du contenu s’il contient des informations qui ne sont pas exposées dans la propriété Name d’un autre contrôle.
UIA_IsControlElementPropertyId true Le contrôle de texte doit toujours être un contrôle.
UIA_IsKeyboardFocusablePropertyId Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
UIA_LabeledByPropertyId NULL Les contrôles de texte n’ont pas d’étiquette de texte statique.
UIA_LocalizedControlTypePropertyId Consultez les remarques. Chaîne localisée correspondant au type de contrôle Text . La valeur par défaut est « text » pour en-US ou English (États-Unis).
UIA_NamePropertyId Consultez les remarques. 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 Texte et que le texte est volumineux, 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 qui doivent être pris en charge par les contrôles de texte. Pour plus d’informations sur les modèles de contrôle, consultez UI Automation Control Patterns Overview.

Modèle de contrôle Support 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, elle n’est pas obligatoire. Le modèle de contrôle Text est utile quand le texte possède un style complexe et des attributs (par exemple, couleur, gras et italique).
IValueProvider Jamais Un contrôle de texte ne prend jamais en charge le modèle de contrôle Value . 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 que les contrôles de texte 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_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.

 

Conceptuel

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

Vue d'ensemble d'UI Automation