Implémentation du modèle de contrôle MultipleView d’UI Automation
Notes
Cette documentation s’adresse aux développeurs .NET Framework qui souhaitent utiliser les classes UI Automation managées définies dans l’espace de noms System.Windows.Automation. Pour obtenir les dernières informations sur UI Automation, consultez API Windows Automation : UI Automation.
Cette rubrique présente les conventions et recommandations à respecter pour implémenter IMultipleViewProvider, notamment des informations sur les événements et les propriétés. Des liens vers des références supplémentaires sont répertoriés à la fin de la rubrique.
Le modèle de contrôle MultipleViewPattern permet de prendre en charge des contrôles qui fournissent plusieurs représentations du même ensemble d’informations ou de contrôles enfants, et permettent de basculer entre elles.
Les exemples de contrôles qui peuvent présenter plusieurs vues incluent la vue Liste (dont le contenu peut apparaître sous forme de miniatures, vignettes, icônes ou détails), les graphiques Microsoft Excel (secteur, ligne, barre, valeur d’une cellule avec une formule), les documents Microsoft Word (affichage normal, mode web, mode Impression, mode Lecture, mode Plan), le calendrier Microsoft Outlook (année, mois, semaine, jour) et les apparences du Lecteur Microsoft Windows Media. Les vues prises en charge sont déterminées par le développeur de contrôle et sont spécifiques à chaque contrôle.
Conventions et directives d'implémentation
Quand vous implémentez le modèle de contrôle Multiple View, notez les conventions et recommandations suivantes :
IMultipleViewProvider doit également être implémenté sur un conteneur qui gère la vue actuelle s’il est différent d’un contrôle qui fournit la vue actuelle. Par exemple, l’Explorateur Windows contient un contrôle List pour le contenu du dossier actuel, tandis que la vue du contrôle est gérée à partir de l’application de l’Explorateur Windows.
Un contrôle qui est en mesure de trier son contenu n’est pas censé prendre en charge plusieurs vues.
La collection de vues doit être identique sur l’ensemble des instances.
Les noms des vues doivent pouvoir être utilisés dans le cadre de la synthèse vocale, de l’écriture en Braille et dans d’autres applications lisibles par l’utilisateur.
Membres requis pour IMultipleViewProvider
Les propriétés et méthodes suivantes sont requises pour implémenter IMultipleViewProvider.
| Membres nécessaires | Type de membre | Notes |
|---|---|---|
| CurrentView | Propriété | Aucun |
| GetSupportedViews | Méthode | Aucun |
| GetViewName | Méthode | Aucun |
| SetCurrentView | Méthode | Aucun |
Aucun événement n’est associé à ce modèle de contrôle.
Exceptions
Le fournisseur doit lever les exceptions suivantes.
| Type d'exception | Condition |
|---|---|
| ArgumentException | Quand la méthode SetCurrentView ou GetViewName est appelée avec un paramètre qui n’est pas membre de la collection de vues prises en charge. |