Procedura: Utilizzare le visualizzazioni tramite il modello a oggetti di InfoPath 2003

Quando si utilizza un modello di modulo di InfoPath, è possibile scrivere codice di script per accedere alle visualizzazioni del modulo e quindi eseguire un'ampia gamma di azioni sui dati contenuti in tali visualizzazioni. Il modello a oggetti compatibile con InfoPath 2003 supporta l'accesso alle visualizzazioni di un modulo tramite i membri dell'interfaccia ViewObject.

Informazioni generali sull'interfaccia ViewObject

L'interfaccia ViewObject include i metodi e proprietà seguenti, che possono essere utilizzati dagli sviluppatori di moduli per interagire con una visualizzazione di InfoPath.

Nota:
I metodi e le proprietà dell'interfaccia ViewObject non sono disponibili durante l'evento OnLoad.

Nome	Descrizione
Metodo DisableAutoUpdate	Disattiva la sincronizzazione tra il modello DOM (Document Object Model) XML e la visualizzazione.
Metodo EnableAutoUpdate	Attiva la sincronizzazione tra il modello DOM XML e la visualizzazione.
Metodo ExecuteAction	Esegue un'azione di modifica di InfoPath.
Metodo Export	Esporta la visualizzazione come file nel formato specificato.
Metodo ForceUpdate	Sincronizza il modello DOM XML con la visualizzazione.
Metodo GetContextNodes	Ottiene un riferimento all'interfaccia XMLNodesCollection, in base al nodo XML specificato e al contesto della visualizzazione oppure alla selezione corrente nella visualizzazione.
Metodo GetSelectedNodes	Ottiene un riferimento all'interfaccia XMLNodesCollection, in base alla selezione corrente nella visualizzazione.
Metodo SelectNodes	Seleziona un intervallo di nodi XML nella visualizzazione.
Metodo SelectText	Seleziona il testo contenuto nel nodo XML specificato nella visualizzazione.
Metodo SwitchView	Imposta un modulo di InfoPath sulla visualizzazione specificata.
Proprietà Name	Restituisce un valore stringa che indica il nome della visualizzazione corrente.
Proprietà Window	Restituisce un riferimento all'interfaccia WindowObject che accede all'oggetto Window associato alla visualizzazione.

Nota:
Il modello a oggetti compatibile con InfoPath 2003 include inoltre l'interfaccia ViewInfosCollection, che può essere utilizzata per ottenere informazioni su tutte le visualizzazioni implementate in un modulo.

Utilizzo dell'interfaccia ViewObject

L'interfaccia ViewObject è accessibile tramite la proprietà View dell'interfaccia XDocument, a cui è possibile accedere tramite la variabile thisXDocument inizializzata nel metodo _Startup della classe di codice del modulo. Nell'esempio seguente viene illustrato l'utilizzo del metodo Alert dell'interfaccia UIObject per visualizzare una finestra di messaggio con il nome della visualizzazione corrente associata al documento XML sottostante di un modulo.

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

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

Tutti i moduli di InfoPath contengono almeno una visualizzazione predefinita. Tuttavia, InfoPath supporta anche la creazione di più visualizzazioni del documento XML sottostante di un modulo. Quando in un modulo sono implementate più visualizzazioni, è possibile utilizzare l'oggetto View per accedere alla visualizzazione attiva. È possibile cambiare la visualizzazione corrente a livello di programmazione utilizzando il metodo SwitchView dell'oggetto View, come illustrato nel codice di esempio seguente:

thisXDocument.View.SwitchView("MySecondView");

thisXDocument.View.SwitchView("MySecondView")

L'esempio precedente relativo al passaggio a un'altra visualizzazione funziona solo se il modulo è aperto. Per impostare una visualizzazione predefinita durante l'evento OnLoad, utilizzare la proprietà IsDefault dell'interfaccia ViewInfoObject, come illustrato nell'esempio seguente.

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

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