Controle de XMLNodes

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 XMLNodes o controle é uma coleção de objetos de nó XML mapeadas que expõe eventos. O XMLNodes controle é criado somente quando um elemento do esquema de repetição é mapeado para um documento do Word de Microsoft Office. Se o elemento de repetição contém elementos filho, cada um dos elementos filho também é criada como um XMLNodes de controle.

Depois que Visual Studio cria uma coleção de nós XML, você pode programar o controle diretamente, sem ter de atravessar o modelo de objeto do Word. O XMLNodes controle pode ser excluído somente removendo o mapeamento do elemento do documento.

Observação
Se você acessar um elemento filho do XMLNodes controlar através do Item propriedade, retorna um Microsoft.Office.Interop.Word.XMLNode objeto em vez de um Microsoft.Office.Tools.Word.XMLNode de controle. For more information, see Limitações de programação de itens de Host e controles de Host.

Binding Data to the Control

Um XMLNodes não oferece suporte a controle de vinculação de dados. Isso ocorre porque o XMLNodes controle não tem recursos de ligação de dados complexa e não pode representar a ligação de dados simples repetição de dados.

Formatting

Qualquer formatação que podem ser aplicadas ao texto dentro do documento pode ser aplicado a uma XMLNodes de controle.

Events

Os eventos disponíveis para o XMLNodes controle são:

Comparando os eventos

Você pode capturar um evento quando o usuário move o cursor dele dentro do contexto de um determinado XMLNodes de controle. Por exemplo, você pode ter um XMLNodes controle chamado Customer que tem um filho XMLNodes controle chamado Company, e Company tem dois filhos XMLNodes 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 XMLNodes 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 de nós da XMLNodes coleção.	Ocorre quando o cursor é colocado dentro de um de nós ou nós descendentes da XMLNodes a coleta, a partir de uma área fora do contexto do nó. Em outras palavras, ele é disparado somente quando o contexto é alterado e pode ser aumentado para vários aninhado XMLNodes controles.

Por exemplo, quando você move o cursor de fora das Customer em CompanyName, o ContextEnter eventos para Customer, Company, e CompanyName são disparados. Se você mover o cursor de CompanyName para CompanyRegion, o ContextEnter evento apenas para CompanyRegion é gerado, porque o contexto é a mesma para ambos Company e Customer. É possível ter vários Company nós no documento. Se você mover o cursor do CompanyName o nó de um Company para o CompanyName nó de outro Company, o contexto é o mesmo, assim, apenas o Select evento é gerado.

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