Ejemplo TESTHELP: control ActiveX con información sobre herramientas y ayuda

  • Artículo

Actualización: noviembre 2007

El ejemplo TESTHELP ilustra la forma de utilizar MFC para generar un control ActiveX con su archivo de Ayuda para proporcionar ayuda al usuario. Testhelp.ocx también muestra la forma de agregar información sobre herramientas a un control ActiveX de MFC.

Nota de seguridad:

Este código de ejemplo se proporciona para ilustrar un concepto y no debe utilizarse en aplicaciones o sitios Web, ya que quizás no ilustre las prácticas de codificación más seguras. Microsoft no asume ninguna responsabilidad por daños incidentales o consecuentes en caso de que el código de ejemplo se utilice para propósitos distintos de aquellos para los que se concibió.

Para obtener ejemplos e instrucciones para su instalación:

  • En el menú Ayuda de Visual Studio, haga clic en Ejemplos.

    Para obtener más información, vea Localizar archivos de ejemplo.

  • La lista de ejemplos completa con la versión más reciente está disponible en línea en la página Visual Studio 2008 Samples.

  • También encontrará ejemplos en el disco duro de su equipo. De manera predeterminada, los ejemplos y el archivo Léame se copian en una carpeta bajo \Archivos de programa\Visual Studio 9.0\Samples\. Para las versiones Express de Visual Studio, todos los ejemplos están en línea.

Generar y ejecutar el ejemplo

Para generar y ejecutar el ejemplo TESTHELP

  1. Abra la solución Testhelp.sln.

  2. En el menú Generar, haga clic en Generar.

Cuando haya generado el ejemplo TESTHELP, podrá utilizarlo en cualquier aplicación de tipo contenedor ActiveX. Vea Probar propiedades y eventos con Test Container para obtener información sobre cómo tener acceso a Test Container. Incluya el control TESTHELP en el proyecto del contenedor y ejecute el proyecto. Para establecer las propiedades del control TESTHELP, abra el cuadro de diálogo de propiedades del contenedor.

En este ejemplo se incluyen el archivo del proyecto de Ayuda y los demás archivos del proyecto de Ayuda.

Para volver a generar y ejecutar el archivo de Ayuda TESTHELP

  1. En el menú Inicio, haga clic en Help Workshop.

  2. Abra Testhelp.hpj. Help Workshop muestra un asistente para convertir archivos en archivos .hhp. Ejecute el asistente, asigne un nombre al archivo y acepte las modificaciones.

  3. Haga clic en el comando Compile del menú File. En el cuadro de diálogo Create a compiled file, indique si desea almacenar el archivo compilado y después haga clic en Compile.

  4. Para ver el archivo compilado, haga clic en Compiled Help File en el menú View.

Características de TESTHELP

TESTHELP ilustra la forma de:

  • Mostrar información sobre herramientas para el control ActiveX.

  • Activar y desactivar la información sobre herramientas en la página de propiedades del control.

  • Cambiar el texto de información sobre herramientas en la página de propiedades del control.

  • Habilitar el botón Ayuda del marco de propiedades del contenedor del control ActiveX para mostrar el archivo de Ayuda del control cuando se haga clic en el botón Ayuda.

  • Habilitar el botón "?" en la Galería de componentes y controles de Visual C++ de forma que se muestre el archivo de Ayuda del control cuando se elija este control en la Galería y se haga clic en el botón "?".

  • Mostrar ayuda en tiempo de ejecución cuando el control tenga el foco del teclado y se presione F1.

  • Utilizar las propiedades estándar Font, BackColor y ForeColor de un control ActiveX.

Página de propiedades General

  • Type of Help to Use
    Esta propiedad determina cómo se utilizará la Ayuda cuando el usuario presione F1 mientras el control TESTHELP tenga el foco del teclado. La Ayuda mostrada en una ventana emergente indica que si el usuario presiona F1 mientras el control TESTHELP se ejecuta en un contenedor y tiene el foco del teclado se mostrará una ventana emergente con el tema "What is this thing?" del archivo de ayuda Testhelp.hlp. Show the Whole Help File" indica que cuando el usuario presione F1 mientras el control TESTHELP se ejecuta en un contenedor y tiene el foco del teclado se mostrará el programa de ayuda completo con el contenido del archivo Testhelp.hlp.

  • Use Control's Help File
    Si esta casilla está activada, cuando el usuario presione F1 durante la ejecución del control en un contenedor con el foco del teclado, se mostrará la Ayuda en el formato determinado por la propiedad Type of Help to Use.

  • Use ToolTip for this Control
    Si esta casilla está activada, se mostrará información sobre herramientas en la ventana del control si éste se está ejecutando en el contenedor y el cursor del mouse (ratón) pasa a la ventana del control y se detiene en ella. La propiedad Tooltip Caption determina el texto que se mostrará.

  • Tooltip Caption
    Es un texto que se mostrará en la información sobre herramientas si el usuario elige mostrar información sobre herramientas.

    • Name1   El nombre mostrado en la parte superior del control.

    • Name2   El nombre mostrado en la parte central del control.

    • Name3   El nombre mostrado en la parte inferior del control.

Página de propiedades Color

Permite al usuario seleccionar colores que se utilizarán al dibujar este control.

Página de propiedades Fuente

Permite al usuario especificar la fuente utilizada para el texto del control.

Nota:

Algunos ejemplos, como éste, no se han modificado para reflejar los cambios en los asistentes, las bibliotecas y el compilador de Visual C++, pero, aun así, muestran cómo realizar la tarea deseada.

Palabras clave

En el ejemplo TESTHELP se muestra el uso de las siguientes clases y palabras clave:

CToolTipCtrl; COleControl::OnDraw; COleControl::OnResetState; COlePropertyPage::OnHelp

Nota:

Algunos ejemplos, como éste, no se han modificado para reflejar los cambios en los asistentes, las bibliotecas y el compilador de Visual C++, pero, aun así, muestran cómo realizar la tarea deseada.

Vea también

Otros recursos

Ejemplos de MFC