XMLNode (Control)

Artículo
08/10/2011

Importante La información que se incluye en este tema relacionada con Microsoft Word se presenta exclusivamente para beneficio y uso de individuos y organizaciones residentes fuera de los Estados Unidos y sus territorios, o que estén utilizando, o desarrollando programas que se ejecutan en, productos de Microsoft Word con licencia concedida por Microsoft antes de enero de 2010, fecha en que Microsoft quitó una implementación de funcionalidad concreta relacionada con XML personalizado de Microsoft Word. Puede que esta información relacionada con Microsoft Word no sea leída o utilizada por individuos u organizaciones residentes en los Estados Unidos o sus territorios que estén utilizando, o desarrollando programas que se ejecutan en, productos de Microsoft Word con licencia concedida por Microsoft después del 10 de enero de 2010; dichos productos no tendrán el mismo comportamiento que los productos con licencia anterior a esa fecha o comprados, y con licencia para su uso, fuera de los Estados Unidos.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento para Word 2007 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

El control XMLNode es un objeto de nodo XML asignado que expone eventos y se puede enlazar a datos. Sólo se crea el control XMLNode cuando un elemento de esquema que no es de repetición se asigna a un documento de Microsoft Office Word. Una vez que Visual Studio crea el nodo XML, es posible programar directamente con el nodo sin tener que recorrer el modelo de objetos de Word.

El control XMLNode se puede eliminar quitando la asignación de elementos en Word.

Enlazar datos al control

Un control XMLNode admite un enlace de datos simple. El nodo XML debe enlazarse a un origen de datos mediante la propiedad DataBindings. Si los datos del conjunto de datos enlazado se actualizan, el control XMLNode reflejará los cambios.

Formato

El formato que puede aplicarse a un objeto Microsoft.Office.Interop.Word.XMLNode también puede aplicarse a un control Microsoft.Office.Tools.Word.XMLNode. Esto incluye fuentes, estilos de subrayado y estilos de caracteres.

Eventos

Los siguientes eventos están disponibles para el control XMLNode:

Comparar eventos

Puede capturar un evento cuando el usuario desplaza el cursor dentro del contexto de un control XMLNode determinado. Por ejemplo, podría tener un control XMLNode denominado Customer que tenga un control XMLNode secundario denominado Company, y que Company tenga dos controles XMLNode secundarios denominados CompanyName y CompanyRegion, tal como se indica a continuación:

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

Si desea mostrar un control en el panel de acciones cada vez que el cursor se desplaza al nodo Company, debería ser indiferente si el cursor se coloca en CompanyName o en CompanyRegion, porque ambos se encuentran dentro del contexto de Company. En este caso, puede escribir el código en el evento ContextEnter de Company.

En la mayoría de los casos, cuando el cursor entra en un control XMLNode, se producen los eventos Select y ContextEnter. En la siguiente tabla se muestran las diferencias entre estos eventos.

Evento Select	Evento ContextEnter
Aparece cuando el cursor se coloca dentro de un control XMLNode.	Aparece cuando el cursor se coloca dentro de XMLNode o uno de sus nodos descendentes, en un área situada fuera del contexto del nodo. Es decir, sólo se produce cuando el contexto cambia.

Por ejemplo, cuando mueve el cursor desde fuera de Customer a CompanyName, se provoca el evento ContextEnter para Customer, Company y CompanyName. Si después mueve el cursor de CompanyName a CompanyRegion, sólo se provoca el evento ContextEnter para CompanyRegion porque todavía está dentro del contexto de Company y Customer.

Existen las mismas diferencias entre el evento ContextLeave y el evento Deselect.