Partager via

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

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

Le type de contrôle Tree est utilisé pour les conteneurs dont le contenu a une pertinence en tant que hiérarchie de nœuds, comme avec la façon dont les fichiers et dossiers sont affichés dans le volet gauche de l’Explorateur Microsoft Windows. Chaque nœud peut contenir d’autres nœuds, appelés nœuds enfants. Les nœuds parents ou les nœuds qui contiennent des nœuds enfants peuvent être affichés comme développés ou réduits.

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 Tree. Les exigences UI Automation s’appliquent à tous les contrôles d’arborescence, 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 d’arborescence 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
Arborescence

  • DataItem (0 ou plus)
  • TreeItem (0 ou plus)

    • TreeItem (0 ou plus)• ...
  • ScrollBar (0, 1, 2)
 Arborescence

  • DataItem (0 ou plus)
  • TreeItem (0 ou plus)

    • TreeItem (0 ou plus)• ...

La vue de contrôle de l’arborescence UI Automation se compose des éléments suivants :

  • Zéro à plusieurs éléments du conteneur (les éléments peuvent être basés sur l’élément d’arborescence, l’élément de données ou un autre type de contrôle).

  • Zéro, une ou deux barres de défilement.

La vue de contenu de l’arborescence UI Automation se compose de zéro ou de nombreux éléments dans le conteneur (les éléments peuvent être basés sur l’élément d’arborescence, l’élément de données ou un autre type de contrôle).

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 liste. 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.
ClickablePointProperty Consultez les remarques. Les contrôles d’arborescence ont un point cliquable qui provoquera l’arborescence ou l’un des éléments du conteneur d’arborescences pour que le focus soit défini sur eux. Vous obtenez un point cliquable pour une arborescence uniquement si vous pouvez cliquer quelque part qui n’entraîne pas la sélection ou l’obtention du focus sur l’un des éléments.
ControlTypeProperty Arborescence Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
IsContentElementProperty Vrai Le contrôle d’arborescence est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
IsControlElementProperty Vrai Le contrôle d’arborescence est toujours inclus dans la vue de contrôle de l’arborescence UI Automation.
IsKeyboardFocusableProperty Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
LabeledByProperty Consultez les remarques. Si le contrôle d’arborescence a une étiquette associée à celle-ci, cette propriété retourne une AutomationElement étiquette pour cette étiquette. Sinon, la propriété retourne une référence Null (Nothing dans Microsoft Visual Basic .NET).
LocalizedControlTypeProperty « tree » Chaîne localisée correspondant au type de contrôle List.
NameProperty Consultez les remarques. La valeur de la propriété name d’un contrôle d’arborescence provient généralement du texte qui étiquette le contrôle. S’il n’existe aucune étiquette de texte, le développeur d’applications doit fournir une valeur pour cette propriété.

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 par les contrôles de liste. 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 Dépend Les contrôles d’arborescence qui contiennent un ensemble d’éléments sélectionnables doivent implémenter ce modèle de contrôle. Ce modèle de contrôle n’a pas besoin d’être implémenté si la sélection d’un élément ne transmet pas d’informations significatives à l’utilisateur.
CanSelectMultiple Consultez les remarques. Implémentez cette propriété si le contrôle d’arborescence prend en charge plusieurs sélections (la plupart des contrôles d’arborescence ne prennent pas en charge plusieurs sélections).
IsSelectionRequired Consultez les remarques. La valeur de cette propriété est exposée si le contrôle exige qu’un élément soit sélectionné.
IScrollProvider Dépend Implémentez ce modèle de contrôle si le contenu du conteneur d’arborescences peut être défilement.

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

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

Voir aussi