XMLNode (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 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. Un vez que Visual Studio Tools para Office 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.
Vea también
Tareas
Cómo: Agregar controles XMLNode a documentos de Word
Cómo: Asignar esquemas a documentos de Word en Visual Studio
Tutorial: Cambiar el panel de acciones de acuerdo con el contexto del usuario
Conceptos
Información general sobre elementos y controles Host
Limitaciones de programación de elementos y controles Host