Controle de XMLNode

Artigo
02/25/2013

importante informações expostas em esse tópico em relação ao Microsoft Word é apresentado exclusivamente para o benefício e uso de pessoas e as organizações que estão localizadas fora dos Estados Unidos e seus territórios ou que estão usando o, ou os programas desenvolvendo que executam em, os produtos Microsoft Word que foram licenciadas pela Microsoft antes de janeiro de 2010, quando Microsoft removeu uma implementação de funcionalidade específica relativa para XML personalizado do Microsoft Word.Essas informações a respeito do Microsoft Word não pode ser lido ou usado por indivíduos ou organizações em Estados Unidos ou seus territórios que estão usando o, ou os programas desenvolvendo que executam em, os produtos Microsoft Word que foram licenciadas; pela Microsoft depois do 10 de janeiro de 2010 esses produtos não se comportarão o mesmo que os produtos licenciadas antes de data ou comprados e licenciadas para uso fora dos Estados Unidos.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento para Word 2013 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

O controle de XMLNode um objeto é mapeado do nó XML que expõe eventos e podem ser associados a dados.O controle de XMLNode é criado somente quando um elemento não repetindo de esquema é mapeado em um documento Microsoft Office Word.Depois que o Visual Studio cria o nó XML, você pode programar contra ele diretamente sem ter que percorrer o modelo de objeto de palavras.

O controle de XMLNode pode ser excluído somente removendo o mapeamento de elemento em palavras.

Associando dados ao controle

Um controle de XMLNode suporta associação de dados simples.O nó XML deve ser associado a uma fonte de dados utilizando a propriedade de DataBindings .Se os dados no dataset associado são atualizados, o controle de XMLNode reflete as alterações.

Formatação

Formatação que pode ser aplicado a um objeto de Microsoft.Office.Interop.Word.XMLNode pode ser aplicado a um controle de Microsoft.Office.Tools.Word.XMLNode .Isso inclui fontes, estilo sublinhado, e estilos de caracteres.

Eventos

os seguintes eventos estão disponíveis para o controle de XMLNode :

comparando eventos

Você pode capturar um evento quando o usuário move o cursor dentro do contexto de um controle específico de XMLNode .Por exemplo, você pode ter um controle de XMLNode chamado Customer que tenha um filho XMLNodeCompanychamado controle, e Company tem dois controles filho de XMLNode nomeados CompanyName e CompanyRegion como segue:

<Customer>
    <Company>
        <CompanyName>
        <CompanyRegion>

Se você quiser mostrar um controle no painel ações sempre que o cursor seja movido no nó de Company , não deve importar se o cursor está colocado em CompanyName ou em CompanyRegion porque eles são ambos dentro do contexto de Company.Em esse caso, você pode escrever o código no evento de ContextEnter de Company.

Em a maioria dos casos, quando o cursor insere um controle de XMLNode , os eventos de Select e de ContextEnter são gerados.A tabela a seguir mostra as diferenças entre esses eventos.

Selecione evento	evento de ContextEnter
Ocorre quando o cursor é colocado em XMLNode.	Ocorre quando o cursor é colocado em XMLNode ou do dos nós descendentes, uma área fora do contexto do nó.Ou seja é gerado apenas quando o contexto é alterado.

Por exemplo, quando você move o cursor fora de Customer em CompanyName, o evento de ContextEnter para Customer, Company, e CompanyName é gerado.Se você move o cursor de CompanyName a CompanyRegion, apenas o evento de ContextEnter para CompanyRegion é gerado porque você ainda está dentro do contexto de Company e de Customer.

As mesmas existem diferenças entre o evento de ContextLeave e o evento de Deselect .