Partager via

Prise en charge d’UI Automation pour le type de contrôle Tab

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 Tab. 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 UI Automation. modèles de contrôle.

Un contrôle tabulation est analogue aux séparateurs d’un bloc-notes ou des étiquettes d’une armoire de fichiers. En utilisant un contrôle tab, une application peut définir plusieurs pages pour la même zone d’une fenêtre ou d’une boîte de dialogue.

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 Tab. Les exigences UI Automation s’appliquent à tous les contrôles d’onglet, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre l’affichage de contrôle et la vue de contenu de l’arborescence UI Automation qui se rapporte aux contrôles d’onglets 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
Onglet

  • TabItem (1 ou plus)
  • ScrollBar (0 ou 1)

    • Bouton (0 ou 2)
 Onglet

- TabItem (1 ou plus)

Les contrôles Tab ont des éléments UI Automation enfants en fonction du type de contrôle Élément de tabulation. Lorsque les éléments de tabulation sont regroupés (par exemple, comme dans les applications Microsoft Office 2007), le type de contrôle Tab peut également héberger des types de contrôle Groupes pour les éléments d’onglet groupés, comme le montre la structure d’arborescence suivante.

Affichage de contrôle Affichage de contenu
Onglet

  • TabItem (1 ou plus)
  • Groupe (0 ou plus)

    • TabItem (0 ou plus)
  • ScrollBar (0 ou plus)

    • Bouton (0 ou 2)
 Onglet

  • TabItem (1 ou plus)
  • Groupe (0 ou plus)

    • TabItem (0 ou plus)

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 le type de contrôle Tab. 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 remarques. La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
BoundingRectangleProperty Consultez les remarques. Rectangle externe qui contient l’ensemble du contrôle.
IsKeyboardFocusableProperty Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty Consultez les remarques. Le contrôle tabulation nécessite rarement une propriété Name.
ClickablePointProperty Non Le contrôle tabulation n’a pas de point cliquable.
LabeledByProperty Consultez les remarques. Les contrôles tabulation ont généralement une étiquette de texte statique qui est exposée via cette propriété.
ControlTypeProperty Onglet Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « tab » Chaîne localisée correspondant au type de contrôle Tab.
IsKeyboardFocusableProperty Vrai Le type de contrôle Tab doit être en mesure de recevoir le focus clavier. En règle générale, un client UI Automation appelle SetFocus sur un contrôle tabulation et l’un de ses éléments transfère le focus clavier au contrôle tabulation. Il est possible que certains conteneurs d’onglets prennent le focus sans définir le focus sur l’un de ses éléments.
IsContentElementProperty Vrai Le contrôle tabulation est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
IsControlElementProperty Vrai Le contrôle tabulation est toujours inclus dans la vue contrôle de l’arborescence UI Automation.
OrientationProperty Consultez les remarques. Le contrôle Tab doit toujours indiquer s’il est positionné horizontalement ou verticalement.

Modèles et propriétés de contrôle UI Automation requis

Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par tous les contrôles d’onglet. Pour plus d’informations sur les modèles de contrôle, consultez Vue d’ensemble des modèles de contrôle UI Automation.

Control Pattern/Pattern, propriété Prise en charge/valeur Remarques
ISelectionProvider Oui Tous les contrôles d’onglet doivent prendre en charge le modèle sélection.
IsSelectionRequired Vrai Les contrôles tabulation nécessitent toujours qu’une sélection soit effectuée.
CanSelectMultiple Faux Les contrôles tabulation sont toujours des conteneurs de sélection unique.
IScrollProvider Dépend Le modèle de défilement doit être pris en charge dans le contrôle tabulation comporte des widgets qui permettent à un ensemble d’éléments d’onglet de faire défiler l’écran.

É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’onglet. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.

Événement UI Automation Soutien Remarques
É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é HorizontallyScrollableProperty. Dépend Aucun
Événement de modification de la propriété HorizontalScrollPercentProperty. Dépend Aucun
Événement de modification de la propriété HorizontallyScrollableProperty. Dépend Aucun
Événement de modification de la propriété HorizontalViewSizeProperty. Dépend Aucun
Événement de modification de la propriété VerticalScrollPercentProperty. Dépend Aucun
Événement de modification de la propriété VerticalViewSizeProperty. Dépend Aucun
AutomationFocusChangedEvent Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun

Voir aussi