Prise en charge d'UI Automation pour le type de contrôle TreeItem
.gif "Remarque") 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 de UI Automation pour le type de contrôle TreeItem. 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 .
Le type de contrôle TreeItem représente un nœud dans un conteneur d'arborescence. Chaque nœud peut contenir d'autres nœuds, appelés nœuds enfants. Les nœuds parents, c'est-à-dire ceux qui contiennent des nœuds enfants, peuvent être affichés sous forme développée ou réduite.
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 TreeItem. Les spécifications UI Automation s'appliquent à tous les contrôles d'élément d'arborescence, 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 d'élément d'arborescence 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 |
|---|---|
TreeItem
|
TreeItem
|
Les contrôles d'élément d'arborescence peuvent compter zéro ou plusieurs enfants d'élément d'arborescence dans l'affichage du contenu de l'arborescence UI Automation. Si le contrôle d'élément d'arborescence a d'autres fonctionnalités que celles exposées dans les modèles de contrôle répertoriés ci-dessous, le contrôle doit être basé sur le type de contrôle Data Item.
Les éléments d'arborescence réduits n'apparaissent dans l'affichage de contrôle ou l'affichage du contenu que lorsqu'ils sont développés et visibles (ou qu'ils peuvent faire l'objet d'un défilement).
L'affichage de contrôle peut contenir des détails supplémentaires pour un contrôle, notamment une image ou un bouton associé(e). Par exemple, un élément dans un mode Plan peut contenir une image ainsi qu'un bouton permettant de développer ou de réduire le plan. Ces objets de détail n'apparaissent pas dans l'affichage du contenu car les informations sont déjà représentées par l'élément d'arborescence parent. Les éléments d'arborescence qui défilent au-delà de l'écran apparaissent dans les affichages de contrôle et du contenu de l'arborescence UI Automation et leur IsOffscreenProperty doit avoir la valeur true.
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 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 |
|---|---|---|
Consulter les remarques. |
La valeur de cette propriété doit être unique dans tous les contrôles d'une application. |
|
Consulter les remarques. |
Le rectangle le plus éloigné qui contient l'ensemble du contrôle. |
|
Consulter les remarques. |
Cette propriété doit retourner un emplacement de l'élément qui provoquera la modification de l'état de sélection ou l'obtention du focus pour l'élément. |
|
TreeItem |
Cette valeur est la même pour toutes les infrastructures d'interface utilisateur. |
|
True |
Le contrôle de liste est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation. |
|
True |
Le contrôle de liste est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation. |
|
Consulter les remarques. |
Cette propriété est définie pour indiquer lorsqu'un contrôle d'élément d'arborescence défile au-delà de l'écran. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Consulter les remarques. |
Si le contrôle d'élément d'arborescence utilise une icône visuelle pour indiquer qu'il s'agit d'un type d'objet particulier, cette propriété doit être prise en charge et indiquer quel est cet objet. |
|
Null |
Les contrôles d'élément d'arborescence sont à étiquetage automatique. |
|
"élément d'arborescence" |
Chaîne localisée correspondant au type de contrôle TreeItem. |
|
Consulter les remarques. |
Cette propriété expose le texte affiché pour chaque contrôle d'élément d'arborescence. |
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 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.
Modèle de contrôle / Propriété du modèle |
Prise en charge / Valeur |
Remarques |
|---|---|---|
Selon le cas |
Implémentez ce modèle de contrôle si l'élément d'arborescence dispose d'une commande séparée pouvant être actionnée. |
|
Oui |
Tous les éléments d'arborescence peuvent être développés ou réduits. |
|
Nœud développé, réduit ou terminal |
Les éléments d'arborescence sont des nœuds terminaux lorsqu'ils ne sont ni développés ni réduits. |
|
Selon le cas |
Implémentez ce modèle de contrôle si le conteneur d'arborescence prend en charge le modèle de contrôle Scroll. |
|
Selon le cas |
Implémentez ce modèle de contrôle s'il est possible qu'une sélection active soit maintenue lorsque l'utilisateur retourne au conteneur d'arborescence. |
|
Oui |
Cette propriété exposera le même conteneur pour tous les éléments du conteneur. |
|
Selon le cas |
Implémentez ce modèle de contrôle si une case à cocher est associée à l'élément d'arborescence. |
É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 d'élément d'arborescence. 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 |
|---|---|---|
Obligatoire |
Aucun |
|
Événement de modification de propriété BoundingRectangleProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété IsEnabledProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété IsOffscreenProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété ItemStatusProperty. |
Selon le cas |
Aucun |
Événement de modification de propriété NameProperty. |
Obligatoire |
Aucun |
Obligatoire |
Aucun |
|
Événement de modification de propriété ExpandCollapseStateProperty. |
Obligatoire |
Aucun |
Selon le cas |
Aucun |
|
Événement de modification de propriété CurrentViewProperty. |
Selon le cas |
Aucun |
Selon le cas |
Aucun |
|
Selon le cas |
Aucun |
|
Selon le cas |
Aucun |
|
Événement de modification de propriété ToggleStateProperty. |
Selon le cas |
Aucun |
Événement de modification de propriété ValueProperty. |
Selon le cas |
Aucun |