_XDocumentEventSink2_Event.OnContextChange Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt nach der Änderung des Kontextknotens ein.
public:
event Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocumentEventSink2_OnContextChangeEventHandler ^ OnContextChange;event Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnContextChangeEventHandler OnContextChange;member this.OnContextChange : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnContextChangeEventHandler Event OnContextChange As _XDocumentEventSink2_OnContextChangeEventHandler Ereignistyp
Beispiele
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;
}
}
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;
}
}
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.
Wenn das Dokument geladen wird oder eine Ansichtsänderung auftritt, tritt das OnContextChange-Ereignis nach dem Auftreten der OnLoadEreignisse und OnSwitchView auf.
Wenn die IsUndoRedo -Eigenschaft des DocContextChangeEventObject Objekts true ist, wurde die Kontextänderung durch den Rückgängig- oder Wiederholungsvorgang eines Benutzers verursacht, anstatt durch eine explizite Änderung des Benutzerkontexts. 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. Die GetContextNodes(Object, Object) -Methode kann verwendet werden, um die Auswahl in Rich-Text-Steuerelementen zu bestimmen.