Type de contrôle d’arborescence
Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle Tree.
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 avec la façon dont les fichiers et dossiers sont affichés dans le volet gauche de Windows Explorer. Chaque nœud peut contenir d’autres nœuds, appelés nœuds enfants. Vous pouvez afficher les nœuds parents, ou nœuds qui contiennent des nœuds enfants, sous forme développée ou réduite. Le contrôle d’arborescence Windows (identifié par WC_TREEVIEW) est un exemple de contrôle qui appartient au type de contrôle Tree .
Les sections suivantes définissent les UI Automation arborescence requises, les propriétés, les modèles de contrôle et les événements pour le type de contrôle Tree. Les exigences UI Automation s’appliquent à tous les contrôles d’éléments d’arborescence où l’infrastructure/plateforme d’interface utilisateur intègre UI Automation prise en charge des types de contrôles et des modèles de contrôle.
Cette rubrique contient les sections suivantes.
- Structure d’arborescence classique
- Propriétés pertinentes
- Modèles de contrôle requis
- Événements obligatoires
- Rubriques connexes
Structure d’arborescence classique
Le tableau suivant illustre une vue de contrôle et de contenu typique 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 |
|---|---|
|
|
L’affichage de contrôle de l’arborescence UI Automation comprend :
- Zéro des nombreux éléments dans le conteneur (les éléments peuvent être basés sur les types de contrôle TreeItem ou DataItem ).
- Zéro, un ou deux contrôles scroll bar
La vue de contenu de l’arborescence UI Automation se compose de zéro ou de plusieurs éléments dans le conteneur (les éléments peuvent être basés sur les types de contrôle TreeItem ou DataItem).
Propriétés pertinentes
Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour le type de contrôle Tree. Pour plus d’informations sur les propriétés UI Automation, consultez Récupération des propriétés à partir d’éléments UI Automation.
| Propriété UI Automation | Valeur | Notes |
|---|---|---|
| UIA_AutomationIdPropertyId | Consultez les remarques. | La valeur de cette propriété doit être unique parmi tous les éléments homologues dans la vue brute de l’arborescence UI Automation. |
| UIA_BoundingRectanglePropertyId | Consultez les remarques. | Rectangle externe qui contient l’ensemble du contrôle. |
| UIA_ClickablePointPropertyId | Consultez les remarques. | Les contrôles d’arborescence ont un point cliquable qui fait que l’arborescence ou l’un des éléments du conteneur d’arborescences reçoit le focus. Un contrôle d’arborescence peut avoir un point cliquable uniquement s’il est possible de cliquer sur un emplacement dans l’arborescence sans provoquer la sélection d’un élément ou la réception du focus. |
| UIA_ControlTypePropertyId | Arborescence | Cette valeur est identique pour toutes les infrastructures d’interface utilisateur. |
| UIA_IsContentElementPropertyId | true | Le contrôle d’arborescence est toujours inclus dans l’affichage du contenu de l’arborescence UI Automation. |
| UIA_IsControlElementPropertyId | true | Le contrôle d’arborescence est toujours inclus dans l’affichage de contrôle de l’arborescence UI Automation. |
| UIA_IsKeyboardFocusablePropertyId | Consultez les remarques. | Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
| UIA_LabeledByPropertyId | Consultez les remarques. | Si une étiquette est associée au contrôle d’arborescence, cette propriété retourne un pointeur IUIAutomationElement pour cette étiquette. Sinon, la propriété retourne une référence null. |
| UIA_LocalizedControlTypePropertyId | Consultez les remarques. | Chaîne localisée correspondant au type de contrôle Tree . La valeur par défaut est « tree » pour en-US ou English (États-Unis). |
| UIA_NamePropertyId | Consultez les remarques. | La valeur de propriété du nom d’un contrôle d’arborescence provient généralement du texte correspondant à l’étiquette du contrôle. S’il n’y a pas d’étiquette de texte, vous devez fournir une valeur pour cette propriété. |
Modèles de contrôle requis
Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge par tous les contrôles d’arborescence. Pour plus d’informations sur les modèles de contrôle, consultez UI Automation Control Patterns Overview.
| Modèle de contrôle/Propriété de modèle | Prise en charge/valeur | Notes |
|---|---|---|
| IScrollProvider | Dépend | Implémentez le modèle de contrôle Scroll si les éléments du conteneur d’arborescences peuvent être défiler. |
| ISelectionProvider | Dépend | Les contrôles d’arborescence qui contiennent un ensemble d’éléments sélectionnables doivent implémenter le modèle de contrôle sélection . Elle n’a pas besoin d’être implémentée si la sélection d’un élément ne transmet aucune information significative à l’utilisateur. |
| CanSelectMultiple | Consultez 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). |
| IsSelectionRequiredred | Consultez les remarques. | La valeur de cette propriété est exposée si le contrôle nécessite la sélection d’un élément. |
Événements obligatoires
Le tableau suivant répertorie les événements UI Automation que tous les contrôles d’arborescence doivent prendre en charge. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.
| Événement UI Automation | Notes |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId’événement de modification de propriété. | |
| UIA_IsEnabledPropertyId’événement de modification de propriété. | Si le contrôle prend en charge la propriété IsEnabled , il doit prendre en charge cet événement. |
| UIA_IsOffscreenPropertyId’événement de modification de propriété. | Si le contrôle prend en charge la propriété IsOffscreen , il doit prendre en charge cet événement. |
| UIA_ScrollHorizontallyScrollablePropertyId’événement de modification de propriété. | Si le contrôle prend en charge le modèle de contrôle Scroll , il doit prendre en charge cet événement. |
| UIA_ScrollHorizontalScrollPercentPropertyId’événement de modification de propriété. | Si le contrôle prend en charge le modèle de contrôle Scroll , il doit prendre en charge cet événement. |
| UIA_ScrollHorizontalViewSizePropertyId’événement de modification de propriété. | Si le contrôle prend en charge le modèle de contrôle Scroll , il doit prendre en charge cet événement. |
| UIA_ScrollVerticalScrollPercentPropertyId’événement de modification de propriété. | Si le contrôle prend en charge le modèle de contrôle Scroll , il doit prendre en charge cet événement. |
| UIA_ScrollVerticallyScrollablePropertyId’événement de modification de propriété. | Si le contrôle prend en charge le modèle de contrôle Scroll , il doit prendre en charge cet événement. |
| UIA_ScrollVerticalViewSizePropertyId événement de modification de propriété. | Si le contrôle prend en charge le modèle de contrôle Scroll , il doit prendre en charge cet événement. |
| UIA_Selection_InvalidatedEventId | Si le contrôle prend en charge le modèle de contrôle Sélection , il doit prendre en charge cet événement. |
| UIA_StructureChangedEventId |
Rubriques connexes
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour