Partager via


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

RemarqueRemarque

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 présente les conventions et instructions pour l'implémentation de 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 est utilisé pour prendre en charge les contrôles qui fournissent et sont en mesure de basculer entre plusieurs représentations du même jeu d'informations ou de contrôles enfants.

Les exemples de contrôles qui peuvent présenter plusieurs affichages incluent les vues Liste (qui peuvent afficher le contenu sous forme de miniatures, de mosaïques, d'icônes ou de 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 Microsoft Windows Media Player. Les affichages pris en charge sont déterminés par le développeur de contrôle et sont spécifiques à chaque contrôle.

Cette rubrique comprend les sections suivantes.

  • Conventions et instructions de l'implémentation
  • Membres requis pour IMultipleViewProvider
  • Exceptions
  • Rubriques connexes

Conventions et instructions de l'implémentation

Lorsque vous implémentez le modèle de contrôle Multiple View, notez les conventions et instructions suivantes :

  • IMultipleViewProvider doit également être implémenté dans un conteneur qui gère l'affichage actuel s'il est différent du contrôle qui fournit l'affichage actuel. Par exemple, l'Explorateur Windows contient un contrôle List pour le contenu du dossier en cours alors que l'affichage du contrôle est géré à 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 affichages.

  • La collection d'affichages doit être identique d'une instance à une autre.

  • Les noms de vues doivent convenir à une utilisation en Text to Speech (conversion de texte par synthèse vocale), en Braille et dans d'autres applications explicites.

Membres requis pour IMultipleViewProvider

Les propriétés et méthodes suivantes sont nécessaires à l'implémentation de IMultipleViewProvider.

Membres requis

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

Condition

ArgumentException

Si SetCurrentView ou GetViewName est appelé avec un paramètre qui n'est pas membre de la collection d'affichages pris en charge.

Voir aussi

Tâches

Prendre en charge des modèles de contrôle dans un fournisseur UI Automation

Utiliser la mise en cache dans UI Automation

Concepts

Vue d'ensemble des modèles de contrôle UI Automation

Modèles de contrôle UI Automation pour les clients

Vue d'ensemble de l'arborescence UI Automation