Partager via

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 combinée à un contrôle statique ou un contrôle d’édition qui affiche l’élément actuellement sélectionné dans la partie zone de liste déroulante de la zone de liste modifiable. La partie zone de liste du contrôle s’affiche à tout moment ou s’affiche uniquement lorsque l’utilisateur sélectionne la flèche déroulante (qui est un bouton push) en regard du contrôle. Si le champ de sélection est un contrôle d’édition, l’utilisateur peut entrer des informations qui ne se trouvent pas dans la liste ; sinon, l’utilisateur ne peut sélectionner que des éléments dans la liste.

Les sections suivantes définissent la structure d’arborescence, les propriétés, les modèles de contrôle et les événements UI Automation 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/la plateforme d’interface utilisateur intègre la prise en charge d’UI Automation pour les types de contrôles et les modèles de contrôle.

Cette rubrique contient les sections suivantes.

Structure d’arborescence classique

Le tableau suivant illustre un contrôle et une vue de contenu typiques 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.

Vue contrôle Affichage de contenu
  • ComboBox
    • Modifier (0 ou 1)
    • Liste (0 ou 1)
    • Élément de liste (enfant de liste ; 0 à plusieurs)
    • Bouton (1)
  • ComboBox
    • Élément de liste (0 à plusieurs)

 

Le contrôle d’édition dans l’affichage contrôle de la zone de liste modifiable est nécessaire uniquement si la zone de liste modifiable peut être modifiée pour prendre une entrée, comme c’est le cas de la zone de liste déroulante dans 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’UI Automation Elements.

UI Automation, propriété Valeur Notes
UIA_AutomationIdPropertyId Consultez les notes. 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 notes. Rectangle le plus externe qui contient l’ensemble du contrôle.
UIA_ClickablePointPropertyId Consultez les notes. Prise en charge s’il existe un rectangle englobant. Si aucun point dans le rectangle englobant n’est cliquable et que l’élément effectue des tests de positionnement spécialisés, remplacez et fournissez un point cliquable.
UIA_ControlTypePropertyId ComboBox
UIA_HelpTextPropertyId Consultez les notes. 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 modifiable. Le texte est similaire aux informations présentées par le biais d’une info-bulle. Par exemple, « Sélectionnez un élément pour définir la résolution d’affichage de votre moniteur ».
UIA_IsContentElementPropertyId VRAI Les contrôles de zone de liste modifiable sont toujours inclus dans la vue de contenu de l’arborescence UI Automation.
UIA_IsControlElementPropertyId VRAI Les contrôles de zone de liste modifiable sont toujours inclus dans l’affichage de contrôle de l’arborescence UI Automation.
UIA_IsKeyboardFocusablePropertyId VRAI Les contrôles de zone de liste modifiable peuvent recevoir le focus clavier ; Toutefois, lorsqu’un client UI Automation définit le focus sur une zone de liste modifiable, tout élément de la sous-arborescence de la zone de liste modifiable peut recevoir le focus.
UIA_LabeledByPropertyId Consultez les notes. 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 notes. 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 l’anglais (États-Unis).
UIA_NamePropertyId Consultez les notes. 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 attribuer une valeur pour la propriété Name. La propriété Name ne doit jamais contenir le contenu actuel de la zone de liste modifiable ou modifier 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 requis pour être pris en charge par tous les contrôles de zone de liste modifiable. 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 Soutien Notes
IExpandCollapseProvider Obligatoire Le modèle de contrôle ExpandCollapse doit être pris en charge, car un contrôle de zone de liste modifiable doit toujours contenir un bouton déroulant.
ISelectionProvider Dépend Affiche la sélection actuelle dans la zone de liste déroulante. La prise en charge de la modèle de contrôle Sélection est déléguée à la zone de liste déroulante sous la zone de liste modifiable, mais peut ne pas toujours être réalisable.
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 modifiable. Si le modèle de contrôle Valeur n’est pas pris en charge, l’utilisateur doit sélectionner parmi les éléments de liste dans la sous-arborescence de la zone de liste déroulante.
IScrollProvider Jamais Le modèle de contrôle de défilement n’est jamais pris en charge directement sur 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 requis pour prendre en charge les contrôles de zone de liste modifiable. Pour plus d’informations sur les événements, consultez vue d’ensemble des événements UI Automation.

É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 valeur, il doit prendre en charge cet événement.

 

conceptuelle

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

Vue d’ensemble UI Automation