DocContextChangeEventObject Schnittstelle

Definition

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Ein Ereignisobjekt, das während eines Microsoft InfoPath-Kontextänderungsereignisses verwendet wird.

public interface class DocContextChangeEventObject : Microsoft::Office::Interop::InfoPath::DocContextChangeEvent

[System.Runtime.InteropServices.Guid("096CD6D2-0786-11D1-95FA-0080C78EE3BB")]
public interface DocContextChangeEventObject : Microsoft.Office.Interop.InfoPath.DocContextChangeEvent

type DocContextChangeEventObject = interface
    interface DocContextChangeEvent

Public Interface DocContextChangeEventObject
Implements DocContextChangeEvent

Abgeleitet

Microsoft.Office.Interop.InfoPath.DocContextChangeEventObjectClass

Attribute

GuidAttribute

Implementiert

DocContextChangeEvent

Beispiele

Im folgenden Beispiel wird ein Knoten mit dem Namen lastChanged als Reaktion auf Kontextänderungen aktualisiert:

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

Hinweise

Dieser Typ ist ein Wrapper für eine CoClass, die von verwaltetem Code für COM-Interoperabilität benötigt wird. Verwenden Sie diesen Typ, um auf die Mitglieder der COM-Schnittstelle zuzugreifen, die von dieser CoClass implementiert wird. Informationen zur COM-Schnittstelle, einschließlich eines Links zu Beschreibungen ihrer Member, finden Sie unterDocContextChangeEvent .

Das DocContextChangeEvent-Objekt stellt mehrere Eigenschaften bereit, die in einer Kontextänderung verwendet werden können, um mit den Daten in dem einem Formular zugrunde liegenden XML-Dokument programmgesteuert zu interagieren, dem Benutzer Feedback bereitzustellen oder Aktionen für ihn auszuführen.

Das DocContextChangeEvent-Objekt wird als Parameter an das OnContextChange Ereignis übergeben.

Mithilfe des DocContextChangeEvent-Objekts werden Informationen zum XML-DOM-Knoten (Document Object Model), der den aktuellen Kontext des dem Formular zugrunde liegenden XML-Dokuments darstellt, abgerufen. Darüber hinaus werden Informationen zum Kontextänderungstyp bereitgestellt, und es wird angegeben, ob die Änderung als Reaktion auf einen vom Benutzer ausgeführten Vorgang zum Rückgängigmachen oder Wiederholen erfolgte.

Die Type Eigenschaft gibt nur den Wert "ContextNode" für Kontextänderungen in Microsoft InfoPath 2003 Service Pack 1 zurück. Wenn Code in einem Ereignishandler Aktionen ausführt, die von der aktuellen Funktionalität abhängen, sollte dieser Code dennoch so entworfen werden, dass er den Wert der Type-Eigenschaft überprüft, da in zukünftigen Versionen von InfoPath möglicherweise unterschiedliche Werte für unterschiedliche Kontextänderungen verwendet werden.

Wenn die IsUndoRedo -Eigenschaft auf true festgelegt ist, wurde die Kontextänderung durch einen Rückgängig- oder Wiederholungsvorgang und nicht durch eine explizite Änderung des Benutzerkontexts verursacht. Vorgänge im OnContextChange-Ereignis, die den XML-DOM-Knoten ändern, sollten als Reaktion auf Aktionen zum Rückgängigmachen oder Wiederholen vermieden werden, da sie sich eventuell negativ auf die Absicht eines Benutzers, Daten in einen früheren Zustand zurückzuversetzen, auswirken.

Eigenschaften

Context	Ruft einen Verweis auf den XML-DOM-Knoten (Document Object Model) ab, bei dem es sich um den neuen Kontextknoten handelt, der vom -Objekt bereitgestellt wird DocContextChangeEventObject . (Geerbt von DocContextChangeEvent)
IsUndoRedo	Ruft einen Wert ab, der angibt, ob das Kontextänderungsereignis als Reaktion auf ein Vorgang zum Rückgängigmachen oder Wiederholen ausgeführt wurde. (Geerbt von DocContextChangeEvent)
Type	Ruft den Typ des Kontextänderungsereignisses ab, das beim Auslösen des OnContextChange Ereignisses aufgetreten ist. (Geerbt von DocContextChangeEvent)
XDocument	Ruft einen Verweis auf das XDocument -Objekt ab, das dem DocContextChangeEventObject -Objekt in einem OnContextChange -Ereignis zugeordnet ist. (Geerbt von DocContextChangeEvent)