XMLNodes (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 XMLNodes es una colección de objetos de nodo XML asignados que expone eventos. El control XMLNodes sólo se crea cuando se asigna un elemento de repetición de esquema a un documento de Microsoft Office Word. Si el elemento de repetición contiene elementos secundarios, los elementos secundarios también se crearán como un control XMLNodes.

Después de que Visual Studio haya creado la colección de nodos XML, puede programar directamente para el control sin tener que pasar por el modelo de objetos de Word. El control XMLNodes sólo se puede eliminar quitando el elemento que asigna desde el documento.

Nota

Si tiene acceso a un elemento secundario del control XMLNodes a través de la propiedad Item, devuelve un objeto Microsoft.Office.Interop.Word.XMLNode en lugar de un control Microsoft.Office.Tools.Word.XMLNode. Para obtener más información, vea Limitaciones de programación de elementos y controles Host.

Enlazar datos al control

Los controles XMLNodes no admiten el enlace de datos. Esto ocurre porque el control XMLNodes no tiene capacidades de enlace de datos complejo y el enlace de datos simple no puede representar datos de repetición.

Formato

A los controles XMLNodes se puede aplicar cualquier formato que se pueda aplicar al texto del documento.

Eventos

Los eventos disponibles para el control XMLNodes son:

Comparar eventos

Puede capturar un evento cuando el usuario desplaza el cursor dentro del contexto de un control XMLNodes determinado. Por ejemplo, podría tener un control XMLNodes denominado Customer que incluyera un control XMLNodes secundario llamado Company, y Company incluye dos controles XMLNodes secundarios denominados CompanyName y CompanyRegion, de esta manera:

<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 XMLNodes, se producen los eventos Select y ContextEnter. En la siguiente tabla se muestran las diferencias entre estos eventos.

Evento Select	Evento ContextEnter
Se produce cuando se coloca el cursor dentro de uno de los nodos de la colección XMLNodes.	Aparece cuando el cursor se coloca en el interior de uno de los nodos o nodos de descendiente de la colección XMLNodes, desde un área situada fuera del contexto del nodo. Dicho de otra forma, sólo se produce cuando cambia el contexto y se puede producir para varios controles XMLNodes anidados.

Por ejemplo, cuando mueve el cursor desde fuera de Customer a CompanyName, se provocan los eventos ContextEnter para Customer, Company y CompanyName. Si después mueve el cursor desde CompanyName a CompanyRegion, sólo se provoca el evento ContextEnter para CompanyRegion porque el contexto es el mismo para Company y Customer. Puede tener varios nodos Company en el documento. Si mueve el cursor desde el nodo CompanyName de un contexto Company al nodo CompanyName de otro contexto Company, el contexto es igual, por lo que sólo se produce el evento Select.

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