Controle de XMLNode

Artigo
08/08/2011

Importante as informações estabelecidas neste tópico sobre o Microsoft Word são apresentadas exclusivamente para o benefício e o uso de pessoas e organizações que estão localizados fora dos Estados Unidos e em seus territórios, ou quem está usando ou o desenvolvimento de programas executados em produtos do Microsoft Word que foram licenciados pela Microsoft antes de janeiro de 2010, quando o Microsoft removido uma implementação da funcionalidade específica, relacionada a XML personalizado a partir do Microsoft Word. Essas informações sobre o Microsoft Word não podem ser lidas ou usadas por pessoas ou organizações nos Estados Unidos ou em suas regiões que estão usando ou o desenvolvimento de programas executados em produtos do Microsoft Word que foram licenciados pela Microsoft após 10 de janeiro de 2010; Esses produtos não se comportar os mesmos produtos licenciados antes dessa data ou adquirido e licenciado 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 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

O XMLNode é um objeto de nó XML mapeado que expõe eventos de controle e pode ser vinculado a dados. O XMLNode controle é criado somente quando um elemento de esquema não-repetição é mapeado para um documento do Word de Microsoft Office. Depois de Visual Studio cria o nó XML, você pode programar em relação a ele diretamente, sem ter de atravessar o modelo de objeto do Word.

O XMLNode controle pode ser excluído somente removendo o mapeamento do elemento no Word.

Binding Data to the Control

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

Formatting

Formatação que pode ser aplicado a uma Microsoft.Office.Interop.Word.XMLNode objeto podem ser aplicadas a uma Microsoft.Office.Tools.Word.XMLNode de controle. Isso inclui fontes, estilos de sublinhado e estilos de caractere.

Events

Os eventos a seguir estão disponíveis para o XMLNode controle:

Comparando os eventos

Você pode capturar um evento quando o usuário move o cursor dele dentro do contexto de um determinado XMLNode de controle. Por exemplo, você pode ter um XMLNode controle chamado Customer que tem um filho XMLNode controle chamado Company, e Company tem dois filhos XMLNode controles denominados CompanyName e CompanyRegion da seguinte maneira:

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

Se você quiser mostrar um controle no painel de ações sempre que o cursor é movido para o Company nó, ele deve não importa se o cursor é colocado na CompanyName ou CompanyRegion porque eles estão dentro do contexto de Company. Nesse caso, você pode escrever seu código no ContextEnter o evento de Company.

Na maioria dos casos, quando o cursor entra um XMLNode controlar ambos os Select e ContextEnter eventos são disparados. A tabela a seguir mostra as diferenças entre esses eventos.

Selecione o evento	Evento de ContextEnter
Ocorre quando o cursor é colocado dentro de um XMLNode.	Ocorre quando o cursor é colocado dentro de um XMLNode ou um de seus nós descendentes, de uma área fora do contexto do nó. Em outras palavras, ele é disparado somente quando o contexto é alterado.

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

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