Ejemplo Actions Pane Help Label

Actualización: noviembre 2007

Nota:
Este ejemplo sólo se ejecuta en Microsoft Office Excel 2007 y Microsoft Office Word 2007.

Este ejemplo incluye un control que proporciona ayuda contextual dinámica sobre un panel de acciones de un documento u hoja de cálculo que contiene regiones con asignaciones XML. El control se asocia automáticamente al esquema XML y utiliza las anotaciones del esquema como texto de ayuda. Cuando un usuario coloca el punto de inserción en una región que contiene un nodo de XML, el control muestra el nombre de región y el texto de anotación asociados. El programador puede utilizar las propiedades del control para indicar lo que ocurre cuando una región no posee texto de anotación.

El control tiene cuatro propiedades que se pueden establecer para determinar lo que muestra el control si no hay texto de anotación. Estas propiedades aparecen en la ventana Propiedades, en una sección llamada Contenido.

• UseAncestorAnnotation
  Especifica si el control debe mostrar el texto de anotación de la región primaria más próxima si no se ha especificado uno en la región seleccionada.

• AnnotationType
  Determina si se debe mostrar el tipo o el nombre del elemento.

• PlaceholderText
  Texto que muestra el control si no hay ninguna anotación.

• ShowLocationName
  Activa o desactiva la presentación del nombre de la región en el control de la etiqueta de ayuda.

El ejemplo de etiqueta de ayuda incluye una solución con tres proyectos: un proyecto de biblioteca de controles, un proyecto de documento de Word y un proyecto de libro de Excel. Los proyectos de Word y Excel muestran cómo utilizar el control. Cuando hace clic en las distintas áreas del documento o de la hoja de cálculo, la etiqueta de ayuda muestra texto que se obtiene de la región asociada del esquema XML.

Nota de seguridad:

Este ejemplo de código está pensado para explicar un concepto y sólo muestra el código relevante para ese concepto. Es posible que no cumpla los requisitos de seguridad de un entorno específico y no se debe usar exactamente como en el ejemplo. Se recomienda agregar código de seguridad y de control de errores para que los proyectos sean más sólidos y seguros. Microsoft proporciona este código de ejemplo "TAL CUAL" sin ninguna garantía.

Para obtener información sobre la instalación del proyecto de ejemplo en el equipo, vea Cómo: Instalar y utilizar archivos de ejemplo de la Ayuda.

Download sample

Para ejecutar este ejemplo

• Presione F5.

Demostraciones

Este ejemplo muestra cómo crear un control de usuario e incorporarlo a un proyecto, y cómo responder a los eventos en las regiones con asignaciones XML.

Vea también

Conceptos

Esquemas y datos XML (Visual Studio Tools para Office)

Información general sobre paneles de acciones

Tutoriales de personalización de la interfaz de usuario

Otros recursos

Ejemplos en el nivel de documento