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.
.gif) 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