XMLNodes (Control)
Actualización: noviembre 2007
Se aplica a |
|---|
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto
Versión de Microsoft Office
Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto. |
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 Tools para Office 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.
.gif "Nota") 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.
Vea también
Tareas
Cómo: Agregar controles XMLNodes a documentos de Word
Cómo: Asignar esquemas a documentos de Word en Visual Studio
Conceptos
Información general sobre elementos y controles Host
Limitaciones de programación de elementos y controles Host