Controle de XMLNodes

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

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

Observação
Se você acessar um elemento filho do controle de XMLNodes através da propriedade de Item , retorna um objeto de Microsoft.Office.Interop.Word.XMLNode em vez de um controle de Microsoft.Office.Tools.Word.XMLNode .Para obter mais informações, consulte Limitações de programação de itens de Host e controles de Host.

Associando dados ao controle

Um controle de XMLNodes não suportam associação de dados.Isso ocorre porque o controle de XMLNodes não tem os recursos de associação de dados complexos, e a associação de dados simples não pode representar repita dados.

Formatação

Qualquer formatação que pode ser aplicado a texto dentro do documento pode ser aplicado a um controle de XMLNodes .

Eventos

os eventos disponíveis para o controle de XMLNodes são:

comparando eventos

Você pode capturar um evento quando o usuário move o cursor dentro do contexto de um controle específico de XMLNodes .Por exemplo, você pode ter um controle de XMLNodes chamado Customer que tenha um filho XMLNodesCompanychamado controle, e Company tem dois controles filho de XMLNodes 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 XMLNodes , 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 o é colocado dentro um dos nós de coleção de XMLNodes .	Ocorre quando o cursor o é colocado dentro um dos nós ou de nós descendentes de coleção de XMLNodes , uma área fora do contexto do nó.Ou seja é gerado apenas quando o contexto é alterada, e pode ser gerado para controles aninhados várias de XMLNodes .

Por exemplo, quando você move o cursor fora de Customer em CompanyName, os eventos de ContextEnter para Customer, Company, e CompanyName são gerados.Se você move o cursor de CompanyName a CompanyRegion, o evento de ContextEnter somente para CompanyRegion é gerado, porque o contexto é o mesmo para Company e Customer.você pode ter vários nós de Company em seu documento.Se você move o cursor do nó de CompanyName de um Company para o nó de CompanyName de outro Company, o contexto é o mesmo, portanto somente o evento de Select é gerado.

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