Evento _XDocumentEventSink2_Event.OnContextChange

Articolo
04/27/2010

Generato dopo la modifica del nodo di contesto.

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

Sintassi

Event OnContextChange As _XDocumentEventSink2_OnContextChangeEventHandler

Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnContextChangeEventHandler

AddHandler instance.OnContextChange, handler

event _XDocumentEventSink2_OnContextChangeEventHandler OnContextChange

Osservazioni

Il nodo di contesto è il nodo DOM XML mappato alla visualizzazione corrispondente al contenitore (o all'elemento) con la selezione XML corrente. Ad esempio, se la selezione corrente nella visualizzazione è in una casella di testo il nodo di contesto è il nodo a cui è associata la casella di testo. Se la sezione corrente è una sezione ripetuta, il nodo di contesto è il nodo per tale elemento. Se sono selezionate due sezioni ripetute, il nodo di contesto è il nodo DOM XML predecessore per entrambi gli elementi mappati alla visualizzazione.

L'evento OnContextChange è asincrono, ovvero non viene generato per ogni modifica del nodo di contesto ma quando l'applicazione termina l'elaborazione di altri eventi.

Quando il documento viene caricato, o quando si verifica un cambio di visualizzazione, l'evento OnContextChange viene generato dopo gli eventi OnLoade OnSwitchView.

Se la proprietà IsUndoRedo dell'oggetto DocContextChangeEventObject è true, la modifica del contesto è stata causata da un'operazione Annulla o Ripristina eseguita dall'utente piuttosto che da una modifica esplicita del contesto utente. È consigliabile evitare di includere operazioni per la modifica del nodo DOM XML nel gestore dell'evento OnContextChange in risposta a operazioni Annulla o Ripristina, perché tali operazioni potrebbero interferire con l'intenzione dell'utente di ripristinare i dati a uno stato precedente.

Per i controlli casella di testo RTF, l'evento OnContextChange non viene generato per modifiche di contesto all'interno del contenuto XHTML, ovvero modifiche della selezione nel testo RTF all'interno del controllo. È possibile utilizzare il metodo GetContextNodes per determinare la selezione nei controlli casella di testo RTF.

Esempio

public void OnContextChange(DocContextChangeEvent e)
{
if (e.Type == "ContextNode")
{
IXMLNode expNode=XDocument.DOM.selectSingleNode("//my:field4");
// set field4 with the name of the current context.
expNode.text=e.Context.nodeName;
}
}

Vedere anche

Riferimenti

Interfaccia _XDocumentEventSink2_Event
Membri _XDocumentEventSink2_Event
Spazio dei nomi Microsoft.Office.Interop.InfoPath.SemiTrust

Condividi tramite