Prise en charge d'UI Automation pour le type de contrôle ScrollBar
.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 ScrollBar. 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.
Les contrôles de barre de défilement permettent à un utilisateur de faire défiler le contenu dans une fenêtre ou un conteneur d'élément. Le contrôle est composé d'un jeu de boutons et d'un contrôle de curseur de défilement.
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 ScrollBar. Les spécifications UI Automation s'appliquent à tous les contrôles de liste, 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 de barre de défilement 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 |
|---|---|
ScrollBar
|
Non applicable. Le contrôle de barre de défilement ne contient pas de contenu. |
Le contrôle de barre de défilement a toujours trois à cinq enfants. Étant donné que le sous-arbre a plusieurs contrôles bouton, vous devez définir une valeur AutomationIdProperty spécifique pour chaque élément afin de les rendre détectables pour les outils d'automation de tests.
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 barre de défilement. Notez qu'un contrôle de barre de défilement n'a jamais de contenu ; ses fonctionnalités sont exposées via le modèle de contrôle Scroll qui est pris en charge sur le conteneur faisant l'objet d'un défilement.
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é contient l'ensemble du contrôle. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Null |
Le contrôle de barre de défilement n'a pas d'éléments de contenu et la définition de NameProperty n'est pas obligatoire. |
|
Pas un nombre. |
Le contrôle de barre de défilement n'a pas de points interactifs. |
|
Null |
Les barres de défilement n'ont pas d'étiquettes. |
|
ScrollBar |
Cette valeur est la même pour toutes les infrastructures. Les barres de défilement qui fonctionnent comme des curseurs doivent utiliser le type de contrôle Slider. |
|
"barre de défilement" |
Chaîne localisée qui correspond au type de contrôle Button. |
|
False |
Le contrôle de barre de défilement n'est jamais un élément de contenu. Si le contrôle de barre de défilement est un contrôle autonome, il doit respecter le type de contrôle Slider et retourner ControlType.Slider pour la propriété ControlType. |
|
True |
La barre de défilement doit toujours être un contrôle. |
|
True |
Le contrôle de barre de défilement doit toujours exposer son orientation horizontale ou verticale. |
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 barre de défilement. Pour plus d'informations sur les modèles de contrôle, consultez Vue d'ensemble des modèles de contrôle UI Automation. Notez que lorsqu'une barre de défilement est utilisée comme contrôle pour la manipulation de la souris uniquement, elle ne prend pas en charge les modèles de contrôle. Si elle est utilisée comme contrôle Slider dans une application, le type de contrôle Slider doit lui être attribué.
Modèle de contrôle |
Prise en charge |
Remarques |
|---|---|---|
Jamais |
Le modèle de contrôle Scroll n'est jamais directement pris en charge sur la barre de défilement. |
|
Selon le cas |
Ces fonctionnalités doivent être prises en charge uniquement si le modèle de contrôle Scroll n'est pas pris en charge sur le conteneur disposant de la barre de 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 de barre de défilement. Pour plus d'informations sur les événements, consultez Vue d'ensemble des événements UI Automation.
Événement UI Automation |
Prise en charge/Valeur |
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é HorizontallyScrollableProperty. |
Jamais |
Aucun |
Événement de modification de propriété HorizontalScrollPercentProperty. |
Jamais |
Aucun |
Événement de modification de propriété HorizontalViewSizeProperty. |
Jamais |
Aucun |
Événement de modification de propriété VerticalScrollPercentProperty . |
Jamais |
Aucun |
Événement de modification de propriété VerticallyScrollableProperty. |
Jamais |
Aucun |
Événement de modification de propriété VerticalViewSizeProperty. |
Jamais |
Aucun |
Événement de modification de propriété ValueProperty. |
Selon le cas |
Aucun |
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |