Prise en charge d'UI Automation pour le type de contrôle ComboBox
.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 ComboBox. 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, les modèles de contrôle et les événements d'UI Automation.
Une zone de liste déroulante est une zone de liste associée à un contrôle statique ou à un contrôle d'édition, qui affiche l'élément actuellement sélectionné dans la zone de liste de la zone de liste déroulante. La zone de liste du contrôle s'affiche à tout moment ou n'apparaît que lorsque l'utilisateur sélectionne la flèche de déroulement (il s'agit d'un bouton de commande) à côté du contrôle. Si le champ de sélection est un contrôle d'édition, l'utilisateur peut entrer des informations qui ne sont pas dans la liste ; sinon, il peut sélectionner uniquement des éléments de la liste.
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 ComboBox. Les spécifications UI Automation s'appliquent à tous les contrôles de zone de liste déroulante, 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 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 zone de liste déroulante 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 |
|---|---|
ComboBox
|
ComboBox
|
Le contrôle d'édition de l'affichage de contrôle de la zone de liste déroulante est nécessaire uniquement si la zone de liste déroulante peut être modifiée pour accepter n'importe quelle entrée, comme c'est le cas pour la zone de liste déroulante de la boîte de dialogue Exécuter.
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 zone de liste déroulante. 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. |
Prise en charge s'il existe un rectangle englobant. Si les points du rectangle englobant ne sont pas tous interactifs et que vous effectuez un test de recherche spécialisé, vous devez substituer et fournir un point interactif. |
|
ComboBox |
Cette valeur est la même pour toutes les infrastructures d'UI. |
|
Consulter les remarques. |
Le texte d'aide des contrôles de zone de liste déroulante doit expliquer pourquoi on demande à l'utilisateur de choisir une option dans la zone de liste déroulante. Le texte est semblable aux informations présentées via une info-bulle. Par exemple, « Sélectionnez un élément pour définir la résolution de votre moniteur ». |
|
True |
Les contrôles de zone de liste déroulante sont toujours inclus dans l'affichage du contenu de l'arborescence UI Automation. |
|
True |
Les contrôles de zone de liste déroulante sont toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation. |
|
True |
Les contrôles de zone de liste déroulante exposent un jeu d'éléments depuis un conteneur de sélection. Le contrôle de zone de liste déroulante peut recevoir le focus clavier, bien que lorsqu'un client UI Automation définit le focus sur une zone de liste déroulante, tous les éléments du sous-arbre de la zone de liste déroulante peuvent recevoir le focus. |
|
Consulter les remarques. |
Les contrôles de zone de liste déroulante ont une étiquette de texte statique référencée par cette propriété. |
|
"zone de liste déroulante" |
Chaîne localisée correspondant au type de contrôle ComboBox. |
|
Consulter les remarques. |
Le nom du contrôle de zone de liste déroulante correspond en général à un contrôle de texte statique. |
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 tous les contrôles de zone de liste déroulante. 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 |
Prise en charge |
Remarques |
|---|---|---|
Oui |
Pour être une zone de liste déroulante, le contrôle de zone de liste déroulante doit toujours contenir le bouton déroulant. |
|
Oui |
Affiche la sélection actuelle dans la zone de liste déroulante. Cette prise en charge est déléguée à la zone de liste située sous la zone de liste déroulante. |
|
Selon le cas |
Si la zone de liste déroulante a la capacité de prendre des valeurs texte arbitraires, le modèle Value doit être pris en charge. Ce modèle fournit la capacité de définir le contenu de la chaîne de la zone de liste déroulante par programme. Si le modèle Value n'est pas pris en charge, cela indique que l'utilisateur doit faire une sélection parmi les éléments de liste du sous-arbre de la zone de liste déroulante. |
|
Jamais |
Le modèle Scroll n'est jamais pris en charge directement sur une zone de liste déroulante. Il est pris en charge si une zone de liste contenue dans une zone de liste déroulante peut défiler. Il ne peut être pris en charge que lorsque la zone de liste est visible à l'écran. |
Événements requis
Le tableau suivant répertorie les événements UI Automation qui doivent être pris en charge par tous les contrôles de zone de liste déroulante. 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é IsOffscreenProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété IsEnabledProperty. |
Obligatoire |
Aucun |
Obligatoire |
Aucun |
|
Événement de modification de propriété ExpandCollapseStateProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété ValueProperty. |
Selon le cas |
Si le contrôle prend en charge le modèle Value, il doit prendre en charge cet événement. |