Partager via

Implémentation du modèle de contrôle MultipleView UI Automation

Remarque

Cette documentation est destinée 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 informations les plus récentes 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. Les liens vers des références supplémentaires sont répertoriés à la fin de la rubrique.

Le MultipleViewPattern modèle de contrôle est utilisé pour prendre en charge les contrôles qui fournissent et peuvent basculer entre plusieurs représentations du même ensemble d’informations ou de contrôles enfants.

Parmi les contrôles qui peuvent présenter plusieurs affichages, citons l’affichage de liste (qui peut afficher son contenu sous forme de miniatures, vignettes, icônes ou détails), des graphiques Microsoft Excel (secteurs, ligne, barre, valeur de cellule avec une formule), des documents Microsoft Word (normal, disposition web, mise en page, mise en page, plan), calendrier Microsoft Outlook (année, mois, semaine, jour) et des apparences du lecteur Microsoft Windows Media. Les vues prises en charge sont déterminées par le développeur du contrôle et sont spécifiques à chaque contrôle.

Directives et conventions de mise en œuvre

Lors de l’implémentation du modèle de contrôle Affichage multiple, notez les instructions et conventions suivantes :

  • IMultipleViewProvider doit également être implémenté sur un conteneur qui gère l’affichage actuel s’il est différent d’un contrôle qui fournit l’affichage actuel. Par exemple, l’Explorateur Windows contient un contrôle Liste pour le contenu du dossier actif tandis que l’affichage du contrôle est géré à partir de l’application De l’Explorateur Windows.

  • Un contrôle capable de trier son contenu n’est pas pris en charge pour prendre en charge plusieurs vues.

  • La collection de vues doit être identique entre les instances.

  • Les noms d’affichage doivent être adaptés à une utilisation dans la reconnaissance vocale, le braille et d’autres applications lisibles par l’homme.

Membres obligatoires pour IMultipleViewProvider

Les propriétés et méthodes suivantes sont requises pour implémenter IMultipleViewProvider.

Membres obligatoires Type de membre Remarques
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 État
ArgumentException Lorsque l’une SetCurrentView ou GetViewName l’autre est appelée avec un paramètre qui n’est pas membre de la collection de vues prises en charge.

Voir aussi