Controlarar de XMLNodes
Se aplica a |
|---|
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto
Versão do Microsoft Office
For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto. |
O Controlarar de XMLNodes é uma coleção de objetos de nó XML mapeadas que expõe eventos.O Controlarar de XMLNodes é criado somente quando um elemento do esquema repetido é mapeado para um documento do Microsoft Office Word.Se o elemento de repetição contém elementos filhos, cada um dos elementos filho também é criada como um Controlarar de XMLNodes.
Depois que Ferramentas do Visual Studio para o Office cria a coleção de nós XML, você pode programar o Controlarar diretamente sem ter que percorrer o modelo de objeto do Word.O Controlarar de XMLNodes pode ser excluído somente removendo o mapeamento de elemento do documento.
.gif "Observação") Observação: |
|---|
Se você acessar um elemento filho da Controlarar de XMLNodes através da propriedade Item , ele retorna um objeto de Microsoft.Office.Interop.Word.XMLNode em vez de um Controlarar de Microsoft.Office.Tools.Word.XMLNode.For more information, see Limitações através de programação de itens de host e controles de host. |
Vinculando dados ao controle
Um Controlarar de XMLNodes não dá suporte a ligação de dados.Isso ocorre porque o Controlarar de XMLNodes não tem recursos de ligação de dados complexos e vinculação de dados simples não é possível representar dados de repetição.
Formatação
Qualquer formatação que podem ser aplicadas ao texto no documento pode ser aplicada para um Controlarar de XMLNodes.
Eventos
Os eventos disponíveis para o Controlarar de XMLNodes são:
Comparação de eventos
Você pode capturar um evento quando o usuário move o cursor dele dentro do contexto de um Controlarar específico XMLNodes.Por exemplo, você pode ter um controle de XMLNodes denominado Customer que tenha um controle de XMLNodes filho chamado Companye Company tem dois controles de XMLNodes de filho chamados CompanyName e CompanyRegion da seguinte maneira:
<Customer>
<Company>
<CompanyName>
<CompanyRegion>
Se você quiser mostrar um Controlarar no painel de ações sempre que o cursor é movido para o nó de Company , ele não deve importa se o cursor é colocado em CompanyName ou CompanyRegion porque elas são ambos dentro do contexto de Company.Nesse maiúscminúsc, você pode Gravar seu código no evento ContextEnter de Company.
Na maioria dos cAmbosos, quando o cursor entra em um Controlarar de XMLNodes , os Select e ContextEnter eventos são gerados.A tabela a seguir mostra as diferenças entre esses eventos.
Selecionar evento |
Evento ContextEnter |
|---|---|
Ocorre quando o cursor é colocado dentro de um de nós da coleção XMLNodes. |
Ocorre quando o cursor é colocado dentro de um de nós ou nós descendentes de coleção XMLNodes, de uma área fora do contexto do nó.Em Outro palavras, ele é disparado somente quando o contexto for alterado e pode ser aumentado para Múltiplo controles aninhados XMLNodes. |
Por exemplo, quando você Mover o cursor de fora do Customer em CompanyName, os eventos de ContextEnterCustomer, Companye CompanyName são gerados.Se você, em seguida, mover o cursor de CompanyName a CompanyRegion, o evento ContextEnter somente para CompanyRegion é disparado, porque o contexto é o mesmo para Ambos Company e Customer.Você pode ter Múltiplo nós de Company no documento.Se você mover o cursor do nó de um CompanyNameCompany para o nó CompanyName do outro Company, o contexto é o mesmo, portanto, somente o evento de Select é disparado.
As diferenças mesmas existem entre o evento de ContextLeave e o evento Deselect.
Consulte também
Tarefas
Como: Adicionar controles de XMLNodes a documentos do Word
Como: Mapear esquemas para documentos do Word dentro do Visual Studio
Conceitos
Itens de host e Visão geral sobre controles de host
Limitações através de programação de itens de host e controles de host