DocContextChangeEventObject Interface

Definição

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Um objeto de evento que é usado durante um evento de alteração de contexto do Microsoft InfoPath.

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

Derivado

Microsoft.Office.Interop.InfoPath.DocContextChangeEventObjectClass

Atributos

GuidAttribute

Implementações

DocContextChangeEvent

Exemplos

No exemplo a seguir, um nó chamado lastChanged é atualizado em resposta a alterações de contexto:

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

Comentários

This type is a wrapper for a coclass that is required by managed code for COM interoperability. Use this type to access the members of the COM interface implemented by this coclass. Para obter informações sobre a interface COM, incluindo um link para descrições de seus membros, consulteDocContextChangeEvent.

O objeto DocContextChangeEvent fornece várias propriedades que podem ser usadas dentro de uma alteração de contexto para interagir programaticamente com os dados no documento XML subjacente de um formulário, para fornecer comentários contextuais ao usuário ou para executar ações para o usuário.

O objeto DocContextChangeEvent é passado como um parâmetro para o OnContextChange evento.

O objeto DocContextChangeEvent é usado para obter informações sobre o nó DOM (Modelo de Objeto de Documento XML) que é o contexto atual do documento XML subjacente do formulário. Além disso, ele fornece informações sobre o tipo de alteração de contexto e se a alteração aconteceu em resposta a uma operação de desfazer ou refazer executada pelo usuário.

A Type propriedade retorna apenas o valor "ContextNode" para alterações de contexto no Microsoft InfoPath 2003 Service Pack 1. No entanto, se o código em um manipulador de eventos executar ações que dependem da funcionalidade atual, esse código ainda deve ser projetado para marcar o valor da propriedade Type, pois versões futuras do InfoPath podem usar valores diferentes para diferentes alterações de contexto.

Quando a IsUndoRedo propriedade é verdadeira, a alteração de contexto foi causada por uma operação de desfazer ou refazer, em vez de uma alteração explícita do contexto do usuário. As operações executadas em um evento OnContextChange que modificam o DOM XML devem ser evitadas em resposta a ações de desfazer ou refazer, pois podem interferir na intenção do usuário de reverter dados para um estado anterior.

Propriedades

Context	Obtém uma referência ao nó DOM (Modelo de Objeto de Documento XML) que é o novo nó de contexto fornecido pelo DocContextChangeEventObject objeto. (Herdado de DocContextChangeEvent)
IsUndoRedo	Obtém um valor que indica se o evento de alteração de contexto ocorreu em resposta à desfazer uma operação ou refazer uma operação. (Herdado de DocContextChangeEvent)
Type	Obtém o tipo de evento de alteração de contexto que ocorreu quando o OnContextChange evento foi disparado. (Herdado de DocContextChangeEvent)
XDocument	Obtém uma referência ao XDocument objeto associado ao DocContextChangeEventObject objeto em um OnContextChange evento. (Herdado de DocContextChangeEvent)