Prise en charge d'UI Automation pour le type de contrôle Table
.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 UI Automation pour type de contrôle Table. 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 Table contiennent des lignes et des colonnes de texte et, éventuellement, des en-têtes de lignes et des en-têtes de colonnes.
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 Table. Les spécifications UI Automation s'appliquent à tous les contrôles de table, 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 de table 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 |
|---|---|
Table
|
Table
|
Si un contrôle de table contient des en-têtes de lignes ou de colonnes, ceux-ci doivent être exposés dans l'affichage de contrôle de l'arborescence UI Automation. L'affichage de contenu n'a pas besoin d'exposer cette information dans la mesure où il est accessible via TablePattern.
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 Table. 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. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Consulter les remarques. |
Le nom du contrôle Table correspond en général à une étiquette de texte statique. En l'absence d'une étiquette de texte statique, vous devez affecter une propriété Name qui doit toujours être disponible pour expliquer le but de la table. |
|
Consulter les remarques. |
En présence d'une étiquette de texte statique, cette propriété doit exposer une référence à l'élément d'automatisation du contrôle. |
|
Table |
Cette valeur est la même pour toutes les infrastructures d'interface utilisateur. |
|
« table » |
Chaîne localisée correspondant au type de contrôle Table. |
|
Consulter les remarques. |
Des détails supplémentaires sur le but de la table doivent être exposés par le biais de cette propriété si elle n'est pas suffisamment expliquée par l'accès à NameProperty. |
|
DescribedByProperty() |
Consulter les remarques. |
Si la table est annotée par un autre élément d'interface (par exemple, un élément de type texte contenant la description de la table), la propriété DescribedBy doit exposer une référence à l'élément d'automatisation du contrôle de texte. |
True |
Le contrôle de table doit toujours être du contenu. |
|
True |
Le contrôle de table doit toujours être un contrôle. |
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 Table. 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 de table de données prend toujours en charge ce modèle de contrôle car les éléments qu'il contient sont dotés de données exposées dans une grille. |
|
Oui (obligatoire avec les objets enfants) |
Les objets internes d'une table doivent prendre en charge à la fois les modèles de contrôle GridItem et TableItem. La table elle-même n'a pas besoin de prendre en charge les éléments de contrôle GridItem ou TableItem à moins que la table fasse partie d'une autre table. |
|
Oui |
Le contrôle de table peut toujours avoir des en-têtes associés au contenu. |
|
Oui (obligatoire avec les objets enfants) |
Les objets internes d'une table doivent prendre en charge à la fois les modèles de contrôle GridItem et TableItem. La table elle-même n'a pas besoin de prendre en charge les éléments de contrôle GridItem ou TableItem à moins que la table fasse partie d'une autre table. |
Événements UI Automation requis
Le tableau suivant répertorie les événements UI Automation requis afin d'être pris en charge par tous les contrôles de table. 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 |
|---|---|---|
É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 |
|
Obligatoire |
Aucun |