ViewObject-Schnittstelle

Artikel
04/27/2010

Stellt eine Ansicht in einem Microsoft Office InfoPath-Formular dar.

Namespace: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Syntax

<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

Hinweise

Dies ist ein Wrappertyp für eine Coklasse, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie diesen Typ zum Zugreifen auf die Member der COM-Schnittstelle, die von der Coklasse implementiert wurden. Informationen zur COM-Schnittstelle, einschließlich eines Links zu den Memberbeschreibungen, finden Sie unter View.

Das ViewObject-Objekt stellt mehrere Eigenschaften und Methoden bereit, die für die programmgesteuerte Interaktion mit einer InfoPath-Ansicht verwendet werden können, einschließlich Methoden zum Auswählen von in der Ansicht enthaltenen Daten, zum Wechseln von einer Ansicht zu einer anderen, zum Synchronisieren der Ansicht mit dem einem Formular zugrunde liegenden XML-Dokument sowie zum Ausführen einer InfoPath-Bearbeitungsaktion.

Beispiel

Im folgenden Beispiel wird die IsDefault-Eigenschaft des ViewInfoObject-Objekts verwendet, um zu bestimmen, ob eine Ansicht die Standardansicht des Formulars ist. Anschließend verwendet der Code die Name-Eigenschaft des ViewInfo-Objekts, um den Namen der Standardansicht in einem Meldungsfeld anzuzeigen.

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);
 }
}

Der Zugriff auf das View-Objekt erfolgt über die View-Eigenschaft des XDocument-Objekts. Der folgende Code legt beispielsweise einen Verweis auf die aktive Ansicht eines Formulars fest:

View view;

view = thisXDocument.View;

Zum Ändern der aktiven Ansicht können Sie die SwitchView-Methode des View-Objekts folgendermaßen verwenden:

thisXDocument.View.SwitchView("View2");

Um eine Aktualisierung einer Ansicht, basierend auf den Änderungen in dem einem Formular zugrunde liegenden XML-Dokument zu erzwingen, können Sie die ForceUpdate-Methode des View-Objekts folgendermaßen verwenden:

thisXDocument.View.ForceUpdate();

Siehe auch

Referenz

ViewObject-Member
Microsoft.Office.Interop.InfoPath-Namespace

Share via