Prise en charge d'UI Automation pour le type de contrôle Tree
.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 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 afin d'utiliser la propriété ControlTypeProperty. Les conditions incluent des instructions 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 Tree est utilisé pour les conteneurs dont le contenu est pertinent en tant que hiérarchie de nœuds, comme la façon dont les fichiers et les dossiers sont affichés dans le volet gauche de Microsoft Windows Explorer. Chaque nœud a la capacité de 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 Tree. Les spécifications UI Automation s'appliquent à tous les contrôles 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'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 |
|---|---|
Tree
|
Tree
|
L'affichage de contrôle de l'arborescence UI Automation se compose de :
zéro ou plusieurs éléments dans le conteneur (les éléments peuvent être basés sur les types de contrôle Tree Item, Data Item ou autre).
zéro, une ou deux barres de défilement.
L'affichage du contenu de l'arborescence UI Automation se compose de zéro ou plusieurs éléments dans le conteneur (les éléments peuvent être basés sur les types de contrôle Tree Item, Data Item ou autre).
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. |
Les contrôles d'arborescence ont un point interactif qui entraînera l'obtention du focus par l'arborescence ou l'un des éléments du conteneur d'arborescence. Vous obtenez un point interactif pour une arborescence uniquement si vous pouvez cliquer à un endroit qui n'entraîne pas la sélection ou l'obtention du focus par l'un des éléments. |
|
Tree |
Cette valeur est la même pour toutes les infrastructures d'interface utilisateur. |
|
True |
Le contrôle d'arborescence est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation. |
|
True |
Le contrôle d'arborescence est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Consulter les remarques. |
Si une étiquette est associée au contrôle d'arborescence, cette propriété retournera un AutomationElement pour cette étiquette. Sinon, la propriété retournera une référence null (Nothing dans Microsoft Visual Basic .NET). |
|
"tree" |
Chaîne localisée correspondant au type de contrôle List. |
|
Consulter 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'application doit fournir une valeur pour cette propriété. |
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 |
Les contrôles d'arborescence qui contiennent un jeu 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 les informations explicites à l'utilisateur. |
|
Consulter les remarques. |
Implémentez cette propriété si le contrôle d'arborescence prend en charge la sélection multiple (la plupart des contrôles d'arborescence ne prennent pas en charge la sélection multiple). |
|
Consulter les remarques. |
La valeur de cette propriété est exposée si le contrôle requiert la sélection d'un élément. |
|
Selon le cas |
Implémentez ce modèle de contrôle si le contenu du conteneur d'arborescence peut faire l'objet d'un défilement. |
É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'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 |
|---|---|---|
Selon le cas |
Aucun |
|
É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é HorizontalViewSizeProperty. |
Selon le cas |
Aucun |
Événement de modification de propriété VerticalScrollPercentProperty . |
Selon le cas |
Aucun |
Événement de modification de propriété VerticallyScrollableProperty. |
Selon le cas |
Aucun |
Événement de modification de propriété VerticalViewSizeProperty. |
Selon le cas |
Aucun |
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |