_XDocumentEventSink2_Event.OnContextChange-Ereignis

Artikel
04/27/2010

Tritt nach der Änderung des Kontextknotens ein.

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

Syntax

Event OnContextChange As _XDocumentEventSink2_OnContextChangeEventHandler

Dim instance As _XDocumentEventSink2_Event
Dim handler As _XDocumentEventSink2_OnContextChangeEventHandler

AddHandler instance.OnContextChange, handler

event _XDocumentEventSink2_OnContextChangeEventHandler OnContextChange

Hinweise

Der Kontextknoten ist der XML-DOM-Knoten, der der Ansicht zugeordnet ist, die dem Container (oder Element) mit der aktuellen XML-Auswahl zugeordnet ist. Wenn sich die aktuelle Auswahl in der Ansicht z. B. in einem Textfeld befindet, ist der Kontextknoten der Knoten, an den das Textfeld gebunden ist. Wenn die aktuelle Auswahl ein wiederholter Abschnitt ist, ist der Kontextknoten der Knoten für dieses Element. Wenn zwei wiederholte Abschnitte ausgewählt wurden, ist der Kontextknoten der übergeordnete XML-DOM-Knoten beider Elemente, die der Ansicht zugeordnet sind.

Das OnContextChange-Ereignis ist asynchron. Es wird nicht bei jeder Änderung im Kontextknoten ausgelöst, sondern nur dann, wenn die Anwendung die Verarbeitung anderer Ereignisse abgeschlossen hat.

Beim Laden des Dokuments oder beim Wechsel von Ansichten tritt das OnContextChange-Ereignis nach den Ereignissen OnLoad und OnSwitchView auf.

Wenn die IsUndoRedo-Eigenschaft des DocContextChangeEventObject-Objekts true ist, wurde die Kontextänderung durch den von einem Benutzer ausgeführten Vorgang zum Rückgängigmachen oder Wiederholen statt einer expliziten Benutzerkontextänderung ausgelöst. Vorgänge im OnContextChange-Ereignis, die den XML-DOM-Knoten ändern, sollten als Reaktion auf Vorgänge zumRückgängigmachen oder Wiederholen vermieden werden, da sie sich möglicherweise negativ auf die Absicht eines Benutzers auswirken, Daten in einen früheren Zustand zurückzuversetzen.

Bei Steuerelementen für Rich-Text-Felder wird das OnContextChange-Ereignis nicht bei Kontextänderungen im XHTML-Inhalt, also Auswahländerungen am Rich-Text im Steuerelement, ausgelöst. Mithilfe der GetContextNodes-Methode kann die Auswahl innerhalb von Steuerelementen für Rich-Text-Felder bestimmt werden.

Beispiel

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;
}
}

Siehe auch

Referenz

_XDocumentEventSink2_Event-Schnittstelle
_XDocumentEventSink2_Event-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Freigeben über