Prise en charge d'UI Automation pour le type de contrôle DataItem
Mise à jour : novembre 2007
Cette rubrique fournit des informations sur la prise en charge d'Microsoft UI Automation pour le type de contrôle DataItem. 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.
L'entrée dans une liste de contacts est un exemple de contrôle d'élément de données. Un contrôle d'élément de données contient des informations intéressantes pour l'utilisateur final. Il est plus compliqué que l'élément de liste simple, car il contient des informations plus riches.
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 DataItem. Les spécifications UI Automation s'appliquent à tous les contrôles d'élément de données, 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
- Utilisation d'éléments de données dans les longues listes
- Événements UI Automation requis
- Exemple de type de contrôle DataItem
- 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 data 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.
Arborescence UI Automation - Affichage de contrôle |
Arborescence UI Automation - Affichage du contenu |
|---|---|
|
|
Propriétés UI Automation requises
Le tableau suivant répertorie les propriétés dont la valeur ou la définition est particulièrement pertinente pour les contrôles d'élément de données. Pour plus d'informations sur les propriétés UI Automation, consultez Propriétés UI Automation pour les clients.
Propriété |
Valeur |
Remarques |
|---|---|---|
AutomationIdProperty() |
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. |
|
DataItem |
Cette valeur est la même pour toutes les infrastructures d'interface utilisateur. |
|
True |
Le contrôle d'élément de données doit toujours être du contenu. |
|
True |
Le contrôle d'élément de données doit toujours être un contrôle. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Consulter les remarques. |
Si le contrôle contient l'état qui est mis à jour dynamiquement, cette propriété doit être prise en charge afin qu'une technologie d'assistance puisse recevoir des mises à jour lorsque l'état de l'élément change. |
|
Consulter les remarques. |
Il s'agit de la valeur de chaîne qui transmet à l'utilisateur final l'objet sous-jacent représenté par l'élément. « Fichier multimédia » ou « Contact » en sont des exemples. |
|
Null |
Les contrôles d'élément de données n'ont pas d'étiquette de texte statique. |
|
"élément de données" |
Chaîne localisée correspondant au type de contrôle DataItem. |
|
Consulter les remarques. |
Le contrôle d'élément de données contient toujours un élément texte principal qui se rapporte à ce que l'utilisateur associerait comme identificateur le plus sémantique pour l'élément. |
Modèles de contrôle UI Automation requis
Le tableau suivant répertorie les modèles de contrôle Microsoft UI Automation qui doivent être pris en charge par tous les contrôles d'élément de données. 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 / Propriété du modèle |
Prise en charge / Valeur |
Remarques |
|---|---|---|
Selon le cas |
Si l'élément de données peut être développé ou réduit pour afficher et masquer des informations, le modèle Expand Collapse doit être pris en charge. |
|
Selon le cas |
Les éléments de données prendront en charge le modèle Grid Item lorsqu'une collection d'éléments de données sera disponible dans un conteneur pouvant être parcouru de manière spatiale d'un élément à un autre. |
|
Selon le cas |
Tous les éléments de données prennent en charge la capacité de défilement avec le modèle ScrollItem lorsque leur conteneur de données contient un nombre d'éléments supérieur à la capacité d'affichage de l'écran. |
|
Oui |
Tous les éléments de données doivent prendre en charge le modèle SelectionItem pour indiquer quand l'élément est sélectionné. |
|
Selon le cas |
Si l'élément de données est contenu dans un type de contrôle Data Grid, il prendra en charge ce modèle. |
|
Selon le cas |
Si l'élément de données contient un état qui peut être parcouru. |
|
Selon le cas |
Si le texte principal de l'élément de données est modifiable, le modèle Value doit être pris en charge. |
Utilisation d'éléments de données dans les longues listes
Les longues listes sont souvent des données virtualisées dans des infrastructures d'interface utilisateur facilitant les performances. Ainsi, un client UI Automation ne peut pas utiliser la fonctionnalité de requête UI Automation pour capturer le contenu de l'arborescence complète de la même façon que dans d'autres conteneurs d'éléments. Un client doit faire défiler l'élément dans l'affichage avant d'accéder au jeu complet d'informations de l'élément de données.
Lors de l'appel de SetFocus sur l'élément UI Automation pour l'élément de données, le cas Explorateur Microsoft Windows sera correctement retourné et provoquera l'affectation de la valeur Edit au focus dans le sous-arbre d'élément de données.
É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 données. 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 |
Aucune |
|
Événement de modification de propriété BoundingRectangleProperty. |
Obligatoire |
Aucune |
Événement de modification de propriété IsEnabledProperty. |
Obligatoire |
Aucune |
Événement de modification de propriété IsOffscreenProperty. |
Obligatoire |
Aucune |
Événement de modification de propriété NameProperty. |
Obligatoire |
Aucune |
Obligatoire |
Aucune |
|
Selon le cas |
Aucune |
|
Événement de modification de propriété ExpandCollapseStateProperty. |
Selon le cas |
Aucune |
Obligatoire |
Aucune |
|
Obligatoire |
Aucune |
|
Obligatoire |
Aucune |
|
Événement de modification de propriété ToggleStateProperty. |
Selon le cas |
Aucune |
Événement de modification de propriété ValueProperty. |
Selon le cas |
Aucune |
Exemple de type de contrôle DataItem
L'image suivante illustre un type de contrôle DataItem dans un contrôle List View.
.gif)
L' affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation relatifs au contrôle d'élément de données sont affichés ci-dessous. Les modèles de contrôle de chaque élément Automation sont mis entre parenthèses.
Arborescence UI Automation - Affichage de contrôle |
Arborescence UI Automation - Affichage du contenu |
|---|---|
DataItem (Sort, Table, Selection, Grid)
|
DataItem (Sort, Table, Selection, Grid)
|
Voir aussi
Concepts
Vue d'ensemble des types de contrôle UI Automation
Vue d'ensemble d'UI Automation