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

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 UI Automation pour le type de contrôle Group. Dans UI Automation, un type de contrôle est un ensemble de conditions qu'un contrôle doit respecter afin d'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.

Le contrôle de groupe représente un nœud dans une hiérarchie. Le type de contrôle Group crée une séparation dans l'arborescence UI Automation ; ainsi, les éléments qui sont regroupés ont une division logique dans l'arborescence UI Automation.

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 Group. Les spécifications UI Automation s'appliquent à tous les contrôles de groupe, 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 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 group 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
Groupe 0 ou plusieurs contrôles	Groupe 0 ou plusieurs contrôles

En général, les types de contrôles Prise en charge d'UI Automation pour le type de contrôle ListItem, Prise en charge d'UI Automation pour le type de contrôle TreeItem ou Prise en charge d'UI Automation pour le type de contrôle DataItem se trouveront au-dessous des contrôles de groupe dans le sous-arbre. 'Group' étant un conteneur générique, tout type de contrôle peut être sous le contrôle Group dans l'arborescence.

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 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	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é qui contient l'ensemble du contrôle.
ClickablePointProperty	Consulter les remarques.	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 recherche spécialisé, vous devez substituer et fournir un point interactif.
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 nom du contrôle de groupe correspond en général au texte qui étiquette le contrôle.
LabeledByProperty	Consulter les remarques.	Les contrôles de groupe sont en général à étiquetage automatique. Dans ces cas, ils retournent null. Si une étiquette de texte statique est présente 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	"group"	Chaîne localisée correspondant au type de contrôle Group.
IsContentElementProperty	True	Le contrôle de groupe est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation.
IsControlElementProperty	True	Le groupe Calendar est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation.

Modèles de contrôle UI Automation requis

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

É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 de groupe. 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é ExpandCollapseStateProperty.	Selon le cas	Aucun
Événement de modification de propriété ToggleStateProperty.	Selon le cas	Aucun
AutomationFocusChangedEvent	Obligatoire	Aucun
StructureChangedEvent	Obligatoire	Aucun

Voir aussi

Référence

Group

Concepts

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

Vue d'ensemble d'UI Automation