Prise en charge d'UI Automation pour le type de contrôle ListItem
.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 ListItem. 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 d'élément de liste sont un exemple de contrôles qui implémentent le type de contrôle ListItem.
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 ListItem. 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 list 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 |
|---|---|
ListItem
|
ListItem |
Les enfants d'un contrôle d'élément de liste dans l'affichage du contenu de l'arborescence UI Automation doivent toujours être « 0 ». Si la structure du contrôle est telle que d'autres éléments sont contenus sous l'élément de liste, elle doit suivre les spécifications pour le type de contrôle Prise en charge d'UI Automation pour le type de contrôle TreeItem.
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 d'élément de liste. 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. |
La valeur de cette propriété doit inclure la zone de l'image et le texte contenu dans l'élément de liste. |
|
Selon le cas |
Si le contrôle de liste inclut un point interactif (un point sur lequel l'utilisateur peut cliquer pour que la liste prenne le focus), ce point doit être exposé via cette propriété. Si le contrôle de liste est intégralement couvert par les éléments de liste descendants, il déclenchera une NoClickablePointException pour indiquer que le client doit demander un point interactif à un élément du contrôle de liste. |
|
Consulter les remarques. |
La valeur de la propriété Name d'un contrôle d'élément de liste provient du texte contenu dans l'élément. |
|
Consulter les remarques. |
Si une étiquette de texte statique est présente, alors cette propriété doit exposer une référence à ce contrôle. |
|
ListItem |
Cette valeur est la même pour toutes les infrastructures d'interface utilisateur. |
|
"élément de liste" |
Chaîne localisée correspondant au type de contrôle ListItem. |
|
True |
Le contrôle de liste est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation. |
|
True |
Le contrôle de liste est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation. |
|
True |
Si le conteneur peut accepter l'entrée au clavier, cette valeur de propriété doit être true. |
|
"" |
Le texte d'aide pour les contrôles de liste doit expliquer pourquoi l'utilisateur est amené à faire un choix dans une liste d'options et comprend généralement le même type d'informations que dans une infobulle. Par exemple, « Sélectionnez un élément pour définir la résolution de votre moniteur ». |
|
Selon le cas |
Cette propriété doit être exposée pour les contrôles d'élément de liste qui représentent un objet sous-jacent. Pour ces contrôles d'élément de liste, une icône est généralement associée au contrôle que les utilisateurs associent à l'objet sous-jacent. |
|
Selon le cas |
Cette propriété doit retourner une valeur indiquant si l'élément de liste fait actuellement l'objet d'un défilement dans le conteneur parent qui implémente le modèle de contrôle Scroll. |
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 d'élément de liste. 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 |
Le contrôle d'élément de liste doit implémenter ce modèle de contrôle. Cela autorise la transmission des contrôles d'élément de liste lorsqu'ils sont sélectionnés. |
|
Selon le cas |
Si l'élément de liste est contenu dans un conteneur déroulant, ce modèle de contrôle doit être implémenté. |
|
Selon le cas |
Si l'élément de liste est sélectionnable et que l'action n'effectue pas de modification de l'état de sélection, ce modèle de contrôle doit être implémenté. |
|
Selon le cas |
Si l'élément peut être manipulé pour afficher ou masquer des informations, ce modèle de contrôle doit être implémenté. |
|
Selon le cas |
Si l'élément peut être modifié, ce modèle de contrôle doit être implémenté. Les modifications apportées au contrôle d'élément de liste entraîneront la modification des valeurs de NameProperty, et Value. |
|
Selon le cas |
Si la navigation spatiale d'un élément à un autre est prise en charge dans le conteneur de liste et que le conteneur est organisé en lignes et en colonnes, le modèle de contrôle Grid Item doit être implémenté. |
|
Selon le cas |
Si l'élément dispose d'une commande qui peut y être exécutée, distincte de la sélection, ce modèle doit être implémenté. Il s'agit généralement d'une action associée à la sélection par double-clic du contrôle d'élément de liste. Par exemple, le lancement d'un document à partir de Microsoft Windows Explorer ou la lecture d'un fichier de musique dans Microsoft Windows Media Player. |
É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 d'élément de liste. 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 |
|---|---|---|
Selon le cas |
Aucun |
|
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |
|
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é ItemStatusProperty. |
Selon le cas |
Aucun |
Événement de modification de propriété ExpandCollapseStateProperty. |
Selon le cas |
Aucun |
Événement de modification de propriété ValueProperty. |
Selon le cas |
Aucun |
Événement de modification de propriété ToggleStateProperty. |
Selon le cas |
Aucun |
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |