Type de contrôle ComboBox

  • Article

Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle ComboBox.

Une zone de liste modifiable est une zone de liste associée à un contrôle statique ou à un contrôle d’édition qui affiche dans la zone de liste l’élément actuellement sélectionné. La zone de liste du contrôle est affichée en permanence ou apparaît uniquement quand l’utilisateur sélectionne la flèche de déroulement (qui est 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, l’utilisateur peut sélectionner uniquement les éléments de la liste.

Les sections suivantes définissent les UI Automation arborescence, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle ComboBox. Les exigences UI Automation s’appliquent à tous les contrôles de zone de liste modifiable où l’infrastructure/plateforme de l’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

Le tableau suivant illustre une vue de contrôle et de contenu typique de l’arborescence UI Automation qui se rapporte aux contrôles de zone de liste modifiable 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
  • ComboBox
    • Edit (0 ou 1)
    • Liste (0 ou 1)
    • List Item (enfant de List. De 0 à plusieurs)
    • Button (1)
  • ComboBox
    • List Item (De 0 à plusieurs)

 

Le contrôle d’édition dans la vue de contrôle de la zone de liste modifiable n’est nécessaire que si la zone de liste modifiable peut être modifiée pour prendre n’importe quelle entrée, comme c’est le cas de la zone de liste modifiable de la boîte de dialogue Exécuter .

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 ComboBox. 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. Pris en charge s’il existe un rectangle englobant. Si tous les points du rectangle englobant ne sont pas cliquables et que l’élément effectue des tests d’accès spécialisés, remplacez et fournissez un point cliquable.
UIA_ControlTypePropertyId ComboBox
UIA_HelpTextPropertyId Consultez les remarques. Le texte d’aide pour les contrôles de zone de liste modifiable doit expliquer pourquoi l’utilisateur est invité à choisir une option dans la zone de liste déroulante. Le texte est semblable aux informations présentées dans une info-bulle. Par exemple, « Sélectionnez un élément pour définir la résolution d’affichage de votre moniteur ».
UIA_IsContentElementPropertyId true Les contrôles de zone de liste déroulante sont toujours inclus dans l’affichage du contenu de l’arborescence UI Automation.
UIA_IsControlElementPropertyId true Les contrôles de zone de liste déroulante sont toujours inclus dans l’affichage de contrôle de l’arborescence UI Automation.
UIA_IsKeyboardFocusablePropertyId true Les contrôles de zone de liste modifiable peuvent recevoir le focus du clavier ; toutefois, lorsqu’un client UI Automation définit le focus sur une zone de liste modifiable, n’importe quel élément de la sous-arborescence de zone de liste modifiable peut recevoir le focus.
UIA_LabeledByPropertyId Consultez les remarques. Les contrôles de zone de liste modifiable ont généralement une étiquette de texte statique référencée par cette propriété.
UIA_LocalizedControlTypePropertyId Consultez les remarques. Chaîne localisée correspondant au type de contrôle ComboBox . La valeur par défaut est « zone de liste modifiable » pour en-US ou anglais (États-Unis).
UIA_NamePropertyId Consultez les remarques. Le nom du contrôle de zone de liste modifiable est généralement généré à partir d’une étiquette de texte statique. S’il n’existe pas d’étiquette de texte statique, vous devez affecter une valeur à la propriété Name . La propriété Name ne doit jamais contenir le contenu actuel de la zone de liste déroulante ou changer lorsque le contenu de la zone de liste modifiable change.

 

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 de zone de liste déroulante. Pour plus d’informations sur les modèles de contrôle, consultez UI Automation Control Patterns Overview.

Modèle de contrôle Support Notes
IExpandCollapseProvider Obligatoire Le modèle de contrôle ExpandCollapse doit être pris en charge, car un contrôle de zone de liste déroulante doit toujours contenir un bouton déroulant.
ISelectionProvider Dépend Affiche la sélection actuelle dans la zone de liste modifiable. La prise en charge du modèle de contrôle Sélection est déléguée à la zone de liste située sous la zone de liste modifiable, mais peut ne pas toujours être possible.
IValueProvider Dépend Si la zone de liste modifiable peut prendre des valeurs de texte arbitraires, le modèle de contrôle Valeur doit être pris en charge. Ce modèle permet de définir par programmation le contenu de chaîne de la zone de liste déroulante. Si le modèle de contrôle Valeur n’est pas pris en charge, l’utilisateur doit sélectionner des éléments de liste dans la sous-arborescence de la zone de liste déroulante.
IScrollProvider Jamais Le modèle de contrôle Scroll n’est jamais pris en charge directement dans une zone de liste déroulante. Elle est prise en charge si une zone de liste contenue dans une zone de liste modifiable peut faire défiler, et uniquement lorsque la zone de liste est visible à l’écran.

 

Événements obligatoires

Le tableau suivant répertorie les événements UI Automation que les contrôles de zone de liste déroulante 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_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId événement de modification de propriété.
UIA_ValueValuePropertyId événement de modification de propriété. Si le contrôle prend en charge le modèle de contrôle Value , il doit prendre en charge cet événement.

 

Conceptuel

Vue d'ensemble des types de contrôle UI Automation

Vue d'ensemble d'UI Automation