Compartilhar via


_XDocumentEventSink2_Event.OnContextChange Evento

Definição

Ocorre após as alterações do nó de contexto.

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 

Tipo de evento

Exemplos

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

Comentários

O nó de contexto é o nó XML DOM mapeado para a exibição que corresponde ao contêiner (ou item) com a seleção XML atual. Por exemplo, se a seleção atual no modo de exibição estiver em uma caixa de texto, o nó de contexto será o nó ao qual a caixa de texto está vinculada. Se a seleção atual for uma seção repetida, o nó de contexto será o nó para esse item. Se duas seções repetidas forem selecionadas, o nó de contexto será o DOM XML ancestral para ambos os itens mapeados para o modo de exibição.

O evento OnContextChange é assíncrono. Ele não dispara em todas as alterações no nó de contexto; Em vez disso, ele é acionado depois que o aplicativo parou de processar outros eventos.

Quando o documento for carregado ou quando ocorrer uma alteração de exibição, o evento OnContextChange ocorrerá após a ocorrência dos OnLoadeventos e OnSwitchView .

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

Para controles de caixa de texto avançados, o evento OnContextChange não é gerado para alterações de contexto no conteúdo XHTML, ou seja, alterações de seleção no texto avançado no controle. O GetContextNodes(Object, Object) método pode ser usado para determinar a seleção dentro de controles de caixa de texto avançados.

Aplica-se a