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

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 Groupe. 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 directives spécifiques concernant la structure d'arborescence de l'UI Automation, les valeurs des propriétés de l'UI Automation et les modèles de contrôle de l'UI Automation.

Le contrôle de groupe représente un nœud au sein d’une hiérarchie. Le type de contrôle Groupe crée une séparation dans l’arborescence UI Automation afin que les éléments regroupés aient une division logique dans l’arborescence UI Automation.

Les sections suivantes définissent l’arborescence, les propriétés, les modèles de contrôle et les événements UI Automation nécessaires pour le type de contrôle Groupe. Les exigences UI Automation s’appliquent à tous les contrôles de groupe, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre la vue de contrôle et la vue de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de groupe 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
Groupe - 0 ou plusieurs contrôles	Groupe - 0 ou plusieurs contrôles

En règle générale, les contrôles de groupe ont la prise en charge UI Automation pour le type de contrôle ListItem, prise en charge UI Automation pour le type de contrôle TreeItem ou prise en charge UI Automation pour le type de contrôle DataItem qui se trouvent sous eux dans le sous-arbre. « Group » étant un conteneur générique, tous les types de contrôle peuvent se trouver sous le contrôle de groupe dans l’arborescence.

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 les contrôles de groupe. 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 notes.	La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
BoundingRectangleProperty	Consultez les notes.	Rectangle le plus externe qui contient l’ensemble du contrôle.
ClickablePointProperty	Consultez les notes.	Prise en charge s’il existe un rectangle englobant. Si les points du rectangle englobant ne sont pas tous interactifs et que vous effectuez un test de positionnement spécialisé, vous devez remplacer et fournir un point interactif.
IsKeyboardFocusableProperty	Consultez les notes.	Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty	Consultez les notes.	Le contrôle de groupe obtient généralement son nom à partir du texte qui étiquette le contrôle.
LabeledByProperty	Consultez les notes.	En général, les contrôles de groupe créent eux-mêmes leurs étiquettes. Dans ces cas, retournez null ici. S’il existe une étiquette de texte statique pour le groupe, elle doit être retournée comme valeur de la propriété LabeledBy.
ControlTypeProperty	Groupe	Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty	"groupe"	Chaîne localisée correspondant au type de contrôle groupe.
IsContentElementProperty	Vrai	Le contrôle de groupe est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
IsControlElementProperty	Vrai	Le groupe de calendriers est toujours inclus dans la vue de contrôle de l’arborescence UI Automation.

Modèles de contrôle UI Automation obligatoires

Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge pour le type de contrôle Groupe. 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	Remarques
IExpandCollapseProvider	Dépend	Les contrôles de groupe qui peuvent être utilisés pour afficher ou masquer les informations doivent prendre en charge le modèle Expand Collapse.

É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 de groupe. Pour plus d’informations sur les événements, consultez Vue d’ensemble des événements UI Automation.

É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é ExpandCollapseStateProperty.	Dépend	Aucun
Événement de modification de la propriété ToggleStateProperty.	Dépend	Aucun
AutomationFocusChangedEvent	Obligatoire	Aucun
StructureChangedEvent	Obligatoire	Aucun

Voir aussi

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