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

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 Tab. Dans UI Automation, un type de contrôle est un ensemble de conditions qu'un contrôle doit respecter pour pouvoir utiliser la propriété ControlTypeProperty. Les conditions incluent des indications spécifiques pour l'arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôle UI Automation.

Un contrôle onglet équivaut aux intercalaires d'un classeur. En utilisant un contrôle onglet, une application peut définir plusieurs pages pour la même zone d'une fenêtre ou boîte de dialogue.

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 Tab. Les spécifications UI Automation s'appliquent à tous les contrôles onglet, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou 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 onglet 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
Onglet TabItem (1 ou plus) ScrollBar (0 ou 1) Bouton (0 ou 2)	Onglet TabItem (1 ou plus)

Les contrôles onglet disposent d'éléments UI Automation enfants basés sur le type de contrôle Élément d'onglet. Lorsque les éléments d'onglet sont groupé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 Group pour les éléments d'onglet groupés, comme le montre l'arborescence suivante.

Affichage de contrôle	Affichage du contenu
Onglet TabItem (1 ou plus) Group (0 ou plus) TabItem (0 ou plus) ScrollBar (0 ou plus) Bouton (0 ou 2)	Onglet TabItem (1 ou plus) Group (0 ou plus) TabItem (0 ou plus)

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 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	Consulter les remarques.	La valeur de cette propriété doit être unique dans tous les contrôles d'une application.
BoundingRectangleProperty	Consulter les remarques.	Le rectangle le plus éloigné contient l'ensemble du contrôle.
IsKeyboardFocusableProperty	Consulter les remarques.	Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty	Consulter les remarques.	Le contrôle onglet requiert rarement une propriété Name.
ClickablePointProperty	Non	Le contrôle onglet n'a pas de point interactif.
LabeledByProperty	Consulter les remarques.	Les contrôles onglet ont en général 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	True	Le type de contrôle Tab doit être en mesure de recevoir le focus clavier. En général, un client UI Automation appelle SetFocus sur un contrôle onglet et un de ses éléments transmettra le focus clavier au contrôle onglet. Il est possible pour certains conteneurs d'onglet de prendre le focus sans lui affecter un de ses éléments.
IsContentElementProperty	True	Le contrôle onglet est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation.
IsControlElementProperty	True	Le contrôle onglet est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation.
OrientationProperty	Consulter les remarques.	Le contrôle onglet doit toujours indiquer s'il est positionné horizontalement ou verticalement.

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

Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge par tous les contrôles onglet. 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	Prise en charge/Valeur	Remarques
ISelectionProvider	Oui	Tous les contrôles onglet doivent prendre en charge le modèle Sélection.
IsSelectionRequired	True	Les contrôles onglet requièrent toujours qu'une sélection soit faite.
CanSelectMultiple	False	Les contrôles onglet sont toujours des conteneurs à sélection unique.
IScrollProvider	Selon le cas	Le modèle Scroll devant être pris en charge dans le contrôle onglet dispose de widgets qui permettent de faire défiler un jeu d'éléments d'onglet.

É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 onglet. 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
É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é HorizontallyScrollableProperty.	Selon le cas	Aucun
Événement de modification de propriété HorizontalScrollPercentProperty.	Selon le cas	Aucun
Événement de modification de propriété HorizontallyScrollableProperty.	Selon le cas	Aucun
Événement de modification de propriété HorizontalViewSizeProperty.	Selon le cas	Aucun
Événement de modification de propriété VerticalScrollPercentProperty .	Selon le cas	Aucun
Événement de modification de propriété VerticalViewSizeProperty.	Selon le cas	Aucun
AutomationFocusChangedEvent	Obligatoire	Aucun
StructureChangedEvent	Obligatoire	Aucun

Voir aussi

Référence

Tab

Concepts

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

Vue d'ensemble d'UI Automation