ViewObject, interface

Article
04/27/2010

Représente une vue dans un formulaire Microsoft Office InfoPath.

Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans microsoft.office.interop.infopath.dll)

Syntaxe

<CoClassAttribute(GetType(ViewObjectClass))> _
<GuidAttribute("096CD55D-0786-11D1-95FA-0080C78EE3BB")> _
Public Interface ViewObject
    Inherits View

Dim instance As ViewObject

[CoClassAttribute(typeof(ViewObjectClass))] 
[GuidAttribute("096CD55D-0786-11D1-95FA-0080C78EE3BB")] 
public interface ViewObject : View

Remarques

Ce type est le wrapper d'une classe de composants (coclass) requise par le code managé pour l'interopérabilité COM. Ce type permet d'accéder aux membres de l'interface COM implémentés par cette classe de composants. Pour plus d'informations sur l'interface COM, et pour accéder aux descriptions de ses membres, voir View.

L'objet ViewObject fournit un certain nombre de propriétés et de méthodes qui peuvent être utilisées pour interagir avec une vue InfoPath ; il peut s'agir de méthodes permettant de sélectionner des données contenues dans la vue, de basculer d'une vue à une autre, de synchroniser la vue avec le document XML sous-jacent d'un formulaire et d'exécuter une action de modification dans InfoPath.

Exemple

Dans l'exemple suivant, la propriété IsDefault de l'objet ViewInfoObject est utilisée pour déterminer si une vue est la vue par défaut du formulaire. Le code utilise ensuite la propriété Name de l'objet ViewInfo pour afficher le nom de la vue par défaut dans une boîte de message.

ViewInfos viewInfos;
// Set a reference to the ViewInfos collection.
viewInfos = thisXDocument.ViewInfos;
// Determine the default view and display a 
// message box with its name.
foreach (ViewInfo viewInfo in viewInfos)
{
 if (viewInfo.IsDefault)
 {
  thisXDocument.UI.Alert("The default view is: " + viewInfo.Name);
 }
}

L'objet View est accessible via la propriété View de l'objet XDocument. Par exemple, le code suivant définit une référence à la vue actuellement active d'un formulaire :

View view;

view = thisXDocument.View;

Pour modifier la vue active, vous pouvez utiliser la méthode SwitchView de l'objet View comme suit :

thisXDocument.View.SwitchView("View2");

Pour imposer une mise à jour d'une vue basée sur des modifications dans le document XML sous-jacent d'un formulaire, vous pouvez utiliser la méthode ForceUpdate de l'objet View, comme l'illustre l'exemple suivant :

thisXDocument.View.ForceUpdate();

Voir aussi

Référence

Membres ViewObject
Microsoft.Office.Interop.InfoPath, espace de noms

Partager via