Interfaccia DocContextChangeEventObject

Articolo
04/27/2010

Oggetto evento utilizzato durante un evento di modifica del contesto di Microsoft Office InfoPath 2007.

Spazio dei nomi: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Sintassi

<CoClassAttribute(GetType(DocContextChangeEventObjectClass))> _
<GuidAttribute("096CD6D2-0786-11D1-95FA-0080C78EE3BB")> _
Public Interface DocContextChangeEventObject
    Inherits DocContextChangeEvent

Dim instance As DocContextChangeEventObject

[CoClassAttribute(typeof(DocContextChangeEventObjectClass))] 
[GuidAttribute("096CD6D2-0786-11D1-95FA-0080C78EE3BB")] 
public interface DocContextChangeEventObject : DocContextChangeEvent

Osservazioni

Questo tipo è un wrapper per una coclasse richiesta dal codice gestito per l'interoperabilità COM. Utilizzare questo tipo per accedere ai membri dell'interfaccia COM implementata dalla coclasse. Per informazioni sull'interfaccia COM e un collegamento alle descrizioni dei relativi membri, vedere DocContextChangeEvent.

L'oggetto DocContextChangeEvent implementa numerose proprietà che possono essere utilizzate in un evento di modifica del contesto per interagire a livello di programmazione con i dati del documento XML sottostante di un modulo, per fornire informazioni contestuali all'utente oppure per eseguire azioni per l'utente.

L'oggetto DocContextChangeEvent viene passato come parametro all'evento OnContextChange.

L'oggetto DocContextChangeEvent viene utilizzato per recuperare informazioni sul nodo DOM (Document Object Model) XML che rappresenta il contesto corrente del documento XML sottostante del modulo. Fornisce inoltre informazioni sul tipo di modifica del contesto indicando anche se la modifica è il risultato di un'operazione Annulla o Ripristina eseguita dall'utente.

La proprietà Type restituisce solo il valore "ContextNode" per le modifiche del contesto in Microsoft InfoPath 2003 Service Pack 1. Se, tuttavia, il codice in un gestore eventi esegue azioni che dipendono dalla funzionalità corrente, tale codice deve essere comunque progettato in modo da controllare il valore della proprietà Type, in quanto le versioni future di InfoPath potrebbero utilizzare valori diversi per modifiche del contesto diverse.

Se la proprietà IsUndoRedo è impostata su true, la modifica del contesto è stata causata da un'operazione Annulla o Ripristina anziché da un cambio di contesto esplicito. È consigliabile evitare di includere operazioni per la modifica del nodo DOM XML nell'evento OnContextChange in risposta a operazioni di annullamento o ripristino, perché potrebbero interferire con l'intenzione dell'utente di ripristinare uno stato precedente dei dati.

Esempio

Nell'esempio seguente, un nodo denominato lastChanged viene aggiornato in risposta a modifiche del contesto:

public void OnContextChange(DocContextChangeEvent e)
{
 if ( e.Type == "ContextNode" && !e.IsUndoRedo )
 {
  IXMLDOMNode contextNode = e.Context;
  IXMLDOMNode lastChangedNode = thisXDocument.DOM.selectSingleNode("/my:myRoot/my:lastChanged");
  lastChangedNode.text = contextNode.nodeName;
 }
}

Vedere anche

Riferimenti

Membri DocContextChangeEventObject
Spazio dei nomi Microsoft.Office.Interop.InfoPath

Condividi tramite