Personalizar la ayuda de tipo .DBF

Artículo
04/11/2008

En el código de la aplicación, especifique el archivo de ayuda que utiliza, los temas que se muestran y cuándo se muestran, y otras configuraciones opcionales. Si incluye ayuda interactiva, los usuarios podrán obtener ayuda al solicitarla desde cuadros de diálogo y los comandos de menú de la aplicación.

Especificar una tabla de ayuda

Especifique la tabla de ayuda; para ello, ejecute el comando SET HELP TO filename. De este modo se cerrará la tabla de ayuda actual, si había alguna abierta, y se abrirá filename como nueva tabla de ayuda.

En una situación típica de programación, guarde en una variable el nombre del archivo de ayuda actual y especifique el nombre del archivo de ayuda en el código de inicialización, como en el ejemplo siguiente:

cUserHlp = SET("HELP", 1)
SET HELP TO MYHELP.DBF

Al salir de la aplicación, podrá restaurar el archivo de ayuda original:

SET HELP TO (cUserHlp)

Mostrar temas en la ventana de ayuda

Después de especificar la tabla de ayuda, puede especificar los temas que desea mostrar de esta forma:

Para seleccionar temas por nombre, utilice los comandos HELP Topic o SET TOPIC TO cHelpTopicName.
Para temas de ayuda interactiva, utilice la propiedad HelpContextID.
Para mostrar un subconjunto de temas, use el comando SET HELPFILTER.

Seleccionar temas por nombre

Para seleccionar temas por nombre, utilice el comando HELP Topic. Cuando utilice este comando, Visual FoxPro buscará en la tabla de ayuda el registro cuyo campo de tema coincide con Topic. En la búsqueda no se distinguen mayúsculas de minúsculas.

Cuando Visual FoxPro encuentre una coincidencia, mostrará el contenido del campo memo Detalles en el modo Detalles de la ventana de ayuda. Si Visual FoxPro no encuentra ninguna coincidencia, mostrará todos los temas de una lista en el cuadro de diálogo Temas de ayuda con la coincidencia más cercana resaltada.

Activar la ayuda interactiva

Puede diseñar la aplicación de modo que el usuario pueda obtener ayuda interactiva de dos formas:

Al presionar la tecla F1 en cualquier momento.
Al hacer clic en un botón Ayuda que se incluye en los formularios y cuadros de diálogo.

Reservar F1

Cuando un usuario presiona F1 dentro de su aplicación, Visual FoxPro puede mostrar un tema de ayuda interactiva. Para ello, asigne un Id. de contexto de ayuda a un tema de su tabla de ayuda y asigne el mismo valor a la propiedad HelpContextID del formulario o control. Cuando el formulario o el control tengan el foco o estén resaltados y el usuario presione F1, Visual FoxPro mostrará el tema asociado.

Nota De forma predeterminada, F1 está activada para la ayuda interactiva. Como es un estándar admitido para la ayuda, no se recomienda la modificación de esta tecla.

Agregar botones de ayuda a formularios

Si agrega botones de ayuda a los formularios, los usuarios pueden tener acceso a la ayuda con más facilidad. Especialmente, debe considerar la inclusión de un botón de ayuda si sus usuarios no son muy experimentados.

Para crear un tema de ayuda interactiva

En el primer campo de un registro de la tabla de ayuda, escriba un valor numérico.
Rellene los campos Tema y Detalles del registro.

Ahora ya puede asignar el tema de ayuda al formulario. Es conveniente asignar un botón Ayuda, el formulario y sus objetos al mismo tema de ayuda.

Para establecer ayuda interactiva y agregar un botón ayuda

En el evento Init de su formulario, establezca en la propiedad HelpContextID de todos los objetos del formulario el mismo valor que el asignado al tema de ayuda. Por ejemplo, si dicho valor es 7, utilice el siguiente comando:
```
THIS.SetAll("HelpContextID", 7)
```
Agregue un botón de comando al formulario.
Establezca el valor Ayuda en la propiedad Caption del botón de comando.
En el evento Click del botón de comando, agregue el siguiente comando:
```
HELP ID THIS.HelpContextID
```
Sugerencia Guarde el botón de ayuda como una clase para poder incluirlo fácilmente en cualquier otro formulario. En el menú Archivo del Diseñador de formularios, elija Guardar como clase. Para obtener más información acerca de cómo guardar objetos como clases, vea Crear formularios.

Controlar la ubicación de la ventana de ayuda

Para especificar una ubicación para la ayuda, debe crear su propia ventana mediante el comando DEFINE WINDOW. Utilice este comando en el código de inicialización para especificar el tamaño y la ubicación de la ventana. A continuación, muestre la ventana activándola o mostrándola.

Por ejemplo, los comandos siguientes definen una ventana denominada test y muestran la tabla de ayuda actual dentro de esa ventana:

DEFINE WINDOW test FROM 1,1 TO 35,60 SYSTEM 
ACTIVATE WINDOW test 
HELP IN WINDOW test

Adaptar la ayuda a su aplicación

Puesto que es posible agregar cualquier número de campos a una tabla de ayuda, y puede emplearse cualquier expresión lógica para seleccionar temas de ayuda, la imaginación es el único límite para el sistema de ayuda que puede crear.

Por ejemplo, puede:

Definir una o muchas variables de programa que controlen el comportamiento del sistema de ayuda y, a continuación, asignar valores a estas variables de acuerdo con el modo operativo del programa.
Proporcionar información más detallada en los archivos de ayuda para los usuarios sin experiencia que para los usuarios experimentados.
Permitir que los usuarios tengan acceso a la ayuda sólo si introducen una contraseña determinada.

Vea también

Compartir a través de