Utilisation des vues à l'aide du modèle objet InfoPath 2003

Lorsque vous utilisez un modèle de formulaire InfoPath, vous pouvez écrire du code pour accéder aux vues du formulaire, puis exécuter différentes actions sur les données qu'elles contiennent. Le modèle objet compatible InfoPath 2003 prend en charge l'accès aux vues d'une forme à travers l'utilisation des membres de l'interface ViewObject.

Vue d'ensemble de l'interface ViewObject

L'interface ViewObject 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 propriétés de l'interface ViewObject ne sont pas disponibles au cours de l'événement OnLoad.

Nom	Description
Méthode DisableAutoUpdate	Désactive la synchronisation du DOM (Document Object Model) XML et de la vue.
Méthode EnableAutoUpdate	Active la synchronisation du DOM XML et de la vue.
Méthode ExecuteAction	Exécute une action d'édition InfoPath.
Méthode Export	Exporte la vue en tant que fichier au format spécifié.
Méthode ForceUpdate	Synchronise le DOM XML et la vue.
Méthode GetContextNodes	Renvoie une référence à l'interface XMLNodesCollection, sur la base du nœud XML spécifié et du contexte de la vue, ou de la sélection en cours dans la vue
Méthode GetSelectedNodes	Renvoie une référence à l'interface XMLNodesCollection, sur la base de la sélection en cours dans la vue.
Méthode SelectNodes	Sélectionne une plage de nœuds XML dans la vue.
Méthode SelectText	Sélectionne le texte contenu dans le nœud XML spécifié de la vue.
Méthode SwitchView	Bascule le formulaire InfoPath vers la vue spécifiée.
Propriété Name	Renvoie une valeur chaîne indiquant le nom de la vue active.
Propriété Window	Renvoie une référence à l'interface WindowObject qui accède à la fenêtre (Window) associée à la vue.

Remarque
Le modèle objet compatible InfoPath 2003 fournit également l'interface ViewInfosCollectionqui peut être utilisée pour obtenir des informations sur toutes les vues mises en œuvre dans un formulaire.

Utilisation de l'interface ViewObject

L'interface ViewObject est accessible via la propriété View de l'interface XDocument (accessible via la variable thisXDocument initialisée dans la méthode _Startup de la classe du code du formulaire). L'exemple de code suivant vous montre comment utiliser la méthode Alert de l'interface UIObject pour afficher une boîte de message indiquant le nom de la vue active associée au document XML sous-jacent d'un formulaire.

thisXDocument.UI.Alert("Current view name: " + 
   thisXDocument.View.Name);

thisXDocument.UI.Alert("Current view name: " & _
   thisXDocument.View.Name)

Un formulaire InfoPath contient au moins une vue par défaut. Toutefois, InfoPath prend également en charge la création de plusieurs vues du document XML sous-jacent d'un formulaire. Lorsqu'un formulaire possède plusieurs vues, vous pouvez avoir recours à l'objet View pour utiliser la vue actuellement active. Vous pouvez modifier la vue active par programme à l'aide de la méthode SwitchView de l'objet View, comme illustré dans le code suivant :

thisXDocument.View.SwitchView("MySecondView");

thisXDocument.View.SwitchView("MySecondView")

L'exemple précédent de basculement d'une vue fonctionne uniquement une fois le formulaire ouvert. Pour définir une vue par défaut au cours de l'événement OnLoad, utilisez la propriété IsDefault de l'interface ViewInfoObject, telle qu'elle est représentée dans l'exemple suivant.

thisXDocument.ViewInfos["MyDefaultView"].IsDefault = true;

thisXDocument.ViewInfos("MyDefaultView").IsDefault = True