Guia Rapida De Hcw

Guía rápida de creación de Ayudas
en formato .HLP con el Help Compiler Workshop (hcw)
 
Publicado el 5/Ene/1999
Revisión del 07/Ago/2005 (21/Ago/2000)

1. Guía rápida de creación de ayuda (formato HLP) con el Help Compiler Workshop (HCW) (5/Ene/99)
Creación del fichero con el Word:
* Títulos, marcadores, palabras claves, etc. * Crear un enlace (link) * Crear un enlace paramostrarlo en una ventana emergente * Mostrar el título de la página separado del texto normal * Usar links a páginas WEB y a e-mail desde un fichero de ayuda HLP |
Configurando la ayuda con el Help Compiler Workshop (HCW):
* Especificar el fichero RTF y creación de ventanas * Mapear las claves para usar con la ayuda del Visual Basic |

 Guía rápida de creación de ayuda (formato HLP) conel Help Workshop (HCW) (5/Ene/99)
Estaba yo trasteando con la librería gsAxDLL cuando me dio el punto de crear la ayuda de este componente y probar los ID de contexto y esas cosas, ya sabes para que al pulsar F1 sobre el nombre de una propiedad de la clase te muestre la ayuda asociada. Entonces me planteé si usar el nuevo sistema de ayuda HTML o el "añejo" formato HLP.
La ayuda en el formatoHTML es más fácil de crear, siempre que se le tenga cogido el tranquillo al tema de crear páginas HTML, pero tiene el inconveniente de que no está plenamente integrado con el Visual Basic, al menos con la versión 5 que es en la que estoy haciendo la referida DLL.
El sistema de ayuda en formato HLP es algo más complicado, pero tiene la ventaja de que estará disponible para más gente, no necesitatener el Internet Explorer instalado ni tampoco comprobar si tenemos el control hhctrl.ocx
Por lo cual me decidí por el sistema HLP. Al fí y al cabo tenía en mis páginas un "mini-tutorial" que explica cómo crear este tipo de ayudas, y podía seguirlo en caso de que no recordara cómo hacerlo, cosa que al final resultó ser así... con lo cual se "demustra" que lo que hay en mis páginas es útil hasta parami mismo, je, je...
Pero después de buscar y leer lo que hay en esa sección de ayuda (desde la que posiblemente habrás llegado a esta página), me di cuenta de que para los más "expertos" sería necesario crear una guía rápida, ya que, se supone, no necesitamos de todas las explicaciones "paso a paso".
Como resultado, aquí está esta Guía rápida para poder encontrar de forma rápida las cosillasque nos pueden hacer falta.
También hay cosas que o no están "claras" o no está incluidas en el citado tutorial, por tanto sería conveniente que le echaras un vistazo a lo que viene a continuación.
Recuerda que necesitas el Help Compiler Workshop (HCW.exe) para crear la ayuda con las explicaciones que doy aquí; ese programa puedes instalarlo desde el CD del Visual Basic, en el que se incluye desdela versión 4 y posteriores, normalmente está en un directorio llamado \Tools\HCW.
¡Que lo disfrutes!

Creación del fichero con el Word:
Lo que viene a continuación, (en los siguientes cuatro puntos), se refiere a la creación del texto en un editor de texto, normalmente el Word, el tipo de documento a usar debe ser en formato RTF; crea un nuevo documento y dale a guardar como y selecciona eseformato, deberá mostrarte esa extensión.
Cada página contendrá cada uno de los tópicos y/o mensajes a mostrar en ventanas emergentes.
Para crear una nueva página, sitúate al final de donde la quieres introducir y pulsa Control+Intro (Ctrl+Intro)
 
 Títulos, marcadores, palabras claves, etc
Para crear estas cosillas, (que después se usarán al hacer los links, mostrar el índice, etc.), situateal principio de la página que quieres "marcar".
En el Word, que es el editor que uso para estas cosas, (ya que el WordPad no tiene estas "opciones"), selecciona del menú Insertar, Notas al pie.
En el diálogo, selecciona Marca Personal y en la caja de texto, escribe alguna de estas claves, según la tarea que quieras realizar:
 
Clave/Marca | Descripción |
$ | El título a mostrar en el...