Utilisation des vues

Lorsque vous utilisez un modèle de formulaire InfoPath, vous pouvez écrire du code permettant d'accéder aux vues du formulaire, puis effectuer une série d'actions sur les données figurant dans les vues. Le modèle d'objet InfoPath fourni par l'espace de noms Microsoft.Office.InfoPath prend en charge l'accès aux vues d'un formulaire par le biais de l'utilisation des membres de la classe View.

Présentation de la classe View

La classe View offre aux développeurs de formulaires les méthodes et les propriétés ci-dessous pour interagir avec une vue InfoPath.

Remarque
Les méthodes et les propriétés de la classe View ne sont pas disponibles au cours de l'événement Loading.

Nom	Description
Méthode DisableAutoUpdate	Désactive la synchronisation automatique entre le document XML sous-jacent d'un formulaire et la vue associée.
Méthode EnableAutoUpdate	Active la synchronisation automatique entre le document XML sous-jacent d'un formulaire et la vue associée.
Méthode ExecuteAction	Exécute une commande d'édition sur le document XML sous-jacent d'un formulaire, sur la base des données sélectionnées dans la vue.
Méthode ExecuteAction	Exécute une commande d'édition sur le document XML sous-jacent d'un formulaire, sur la base du champ ou groupe spécifié.
Méthode Export	Exporte la vue vers un fichier au format spécifié.
Méthode ForceUpdate	Impose de synchroniser le document XML sous-jacent d'un formulaire avec la vue associée.
Méthode GetContextNodes	Obtient une référence à un objet XPathNodeIterator permettant d'effectuer des itérations dans les nœuds XML renvoyés à partir du nœud spécifié.
Méthode GetContextNodes	Obtient une référence à un objet XPathNodeIterator permettant d'effectuer des itérations dans les nœuds XML renvoyés dans la sélection active au sein du contrôle associé au champ ou groupe spécifié.
Méthode GetSelectedNodes	Obtient une référence à un objet XPathNodeIterator permettant d'effectuer des itérations dans tous les nœuds XML dans la sélection active d'éléments d'une vue.
Méthode SelectNodes	Sélectionne une plage de nœuds dans une vue, sur la base du premier nœud XML spécifié.
Méthode SelectNodes	Sélectionne une plage de nœuds dans une vue, sur la base des premier et dernier nœuds XML spécifiés.
Méthode SelectNodes	Sélectionne une plage de nœuds dans une vue, sur la base du nœud XML de départ, du nœud XML de fin et du contrôle spécifiés.
Méthode SelectText	Sélectionne le texte contenu dans un contrôle modifiable lié au nœud spécifié par l'objet XPathNavigator transmis à cette méthode.
Méthode SelectText	Sélectionne le texte contenu dans un contrôle modifiable lié au nœud spécifié par l'objet XPathNavigator transmis à cette méthode, et le contrôle spécifié.
Méthode ShowMailItem	Crée un message électronique contenant la vue active.
Propriété ViewInfo	Obtient une référence à un objet ViewInfo associé à la vue.
Propriété Window	Obtient une référence à un objet Window associé à la vue.

Remarque
Le modèle objet InfoPath fournit également les classes ViewInfoCollection et ViewInfo, qui peuvent être utilisées pour obtenir des informations concernant toutes les vues implémentées dans un formulaire.

Utilisation de la classe View

La classe View est accessible par le biais de la propriété CurrentView de la classe XmlForm, elle-même accessible au moyen du mot clé this (C#) ou Me (Visual Basic). Par exemple, l'exemple de code suivant indique comment afficher une boîte de message avec le nom de la vue active.

MessageBox.Show("Current view name: " + 
   this.CurrentView.Name);

MessageBox.Show("Current view name: " & _
   Me.CurrentView.Name)

Tous les modèles de formulaires InfoPath comportent au moins une vue par défaut; toutefois, InfoPath prend également en charge la création de vues multiples d'un document XML sous-jacent. Dans le cas de vues multiples, la collection ViewInfoCollection permet d'utiliser toutes le vues implémentées dans le modèle de formulaire. Pour accéder à la collection ViewInfoCollection d'un modèle de formulaire, utilisez la propriété ViewInfos de la classe XmlForm. Par le biais de la programmation, vos pouvez changer la vue active au moyen de la méthode SwitchView de la collection ViewInfoCollection, comme l'illustre l'exemple de code suivant.

this.ViewInfos.SwitchView("MySecondView");

Me.ViewInfos.SwitchView("MySecondView")

L'exemple précédent de basculement d'une vue fonctionne uniquement un fois le formulaire ouvert. Pour définir une vue par défaut au cours de l'événement OnLoad, utilisez la propriété Initial de la classe ViewInfoCollection comme illustré dans l'exemple suivant. Remarquez, toutefois, que cette valeur ne prendra effet qu'après l'enregistrement et la réouverture du formulaire.

this.ViewInfos.Initial = this.ViewInfos["MyInitialView"];

Me.ViewInfos.Initial = Me.ViewInfos["MyInitialView"];