Vorgehensweise: Arbeiten mit Ansichten mithilfe des InfoPath 2003-Objektmodells

Sie können bei der Arbeit mit einer InfoPath-Formularvorlage Code für den Zugriff auf die Ansichten des Formulars schreiben und anschließend eine Reihe von Aktionen für die Daten ausführen, die die Ansichten enthalten. Das mit InfoPath 2003 kompatible Objektmodell unterstützt den Zugriff auf die Ansichten eines Formulars mithilfe der Member der ViewObject-Schnittstelle.

Übersicht über die ViewObject-Schnittstelle

Die ViewObject-Schnittstelle stellt die folgenden Methoden und Eigenschaften bereit, die Formularentwickler für die Interaktion mit einer InfoPath-Ansicht verwenden können.

Hinweis

Die Methoden und Eigenschaften der ViewObject-Schnittstelle sind während des OnLoad-Ereignisses nicht verfügbar.

Name	Beschreibung
DisableAutoUpdate-Methode	Deaktiviert die Synchronisierung von XML-DOM (Document Object Model) und der Ansicht.
EnableAutoUpdate-Methode	Aktiviert die Synchronisierung von XML-DOM und der Ansicht.
ExecuteAction-Methode	Führt eine Bearbeitungsaktion von InfoPath aus.
Export-Methode	Exportiert die Ansicht als Datei des angegebenen Formats.
ForceUpdate-Methode	Synchronisiert XML-DOM mit der Ansicht.
GetContextNodes-Methode	Gibt einen Verweis auf die XMLNodesCollection-Schnittstelle auf Grundlage des angegebenen XML-Knotens und Kontexts der Ansicht bzw. auf Grundlage der aktuellen Auswahl in der Ansicht zurück.
GetSelectedNodes-Methode	Gibt einen Verweis auf die XMLNodesCollection-Schnittstelle auf Grundlage der aktuellen Auswahl in der Ansicht zurück.
SelectNodes-Methode	Wählt einen Bereich mit XML-Knoten in der Ansicht aus.
SelectText-Methode	Wählt den im in der Ansicht enthaltenen angegebenen XML-Knoten aus.
SwitchView-Methode	Wechselt von einem InfoPath-Formular zur angegebenen Ansicht.
Name-Eigenschaft	Gibt einen Zeichenfolgenwert zurück, der den Namen der aktuellen Ansicht angibt.
Window-Eigenschaft	Gibt einen Verweis auf die WindowObject-Schnittstelle zurück, die auf das der Ansicht zugeordnete Window zugreift.

Hinweis

Das mit InfoPath 2003 kompatible Objektmodell stellt außerdem die ViewInfosCollection-Schnittstelle bereit, die zum Abrufen von Informationen zu allen in einem Formular implementierten Ansichten verwendet werden kann.

Verwenden der ViewObject-Schnittstelle

Der Zugriff auf die ViewObject-Schnittstelle erfolgt über die View-Eigenschaft der XDocument-Schnittstelle, auf die über die in der _Startup-Methode der Formularcodeklasse initialisierten thisXDocument-Variablen zugegriffen wird. So veranschaulicht das folgende Codebeispiel die Verwendung der Alert-Methode der UIObject-Schnittstelle zum Anzeigen eines Meldungsfeldes mit dem Namen der aktuellen Ansicht, die dem zugrunde liegenden XML-Dokument eines Formulars zugeordnet ist.

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

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

Alle InfoPath-Formulare enthalten mindestens eine Standardansicht. InfoPath unterstützt dennoch das Erstellen mehrerer Ansichten des zugrunde liegenden XML-Dokuments eines Formulars. Wenn in einem Formular mehrere Ansichten vorhanden sind, kann das View-Objekt zur Interaktion mit der aktuell aktiven Ansicht verwendet werden. Sie können die aktuell aktive Ansicht programmgesteuert ändern, indem Sie die SwitchView-Methode des View-Objekts verwenden, wie im folgenden Codebeispiel dargestellt.

thisXDocument.View.SwitchView("MySecondView");

thisXDocument.View.SwitchView("MySecondView")

Das vorherige Beispiel zum Wechseln einer Ansicht funktioniert nur, nachdem das Formular geöffnet wurde. Verwenden Sie zum Festlegen einer Standardansicht während des OnLoad-Ereignisses die IsDefault-Eigenschaft der ViewInfoObject-Schnittstelle, wie im folgenden Beispiel dargestellt.

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

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