Interfaccia DocContextChangeEventObject
Oggetto evento utilizzato durante gli eventi di modifica del contesto di Microsoft InfoPath 2010.
Spazio dei nomi: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in Microsoft.Office.Interop.InfoPath.SemiTrust.dll)
Sintassi
'Dichiarazione
<GuidAttribute("096cd6d2-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface DocContextChangeEventObject _
Inherits DocContextChangeEvent, DocEvent
'Utilizzo
Dim instance As DocContextChangeEventObject
[GuidAttribute("096cd6d2-0786-11d1-95fa-0080c78ee3bb")]
public interface DocContextChangeEventObject : DocContextChangeEvent,
DocEvent
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, vedereDocContextChangeEvent.
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 2010. 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.
Esempi
Nell'esempio seguente, un nodo denominato lastChanged viene aggiornato in risposta a modifiche del contesto:
[InfoPathEventHandler(EventType=InfoPathEventType.OnContextChange)]
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;
}
}