¿Hay una biblioteca / api para leer el contenido de un archivo de ayuda .hlp?

Question

Tengo un archivo de ayuda para mi programa y se me pidió que agregara una descripción de los menús en una barra de herramientas a medida que el usuario los examina. Así que pensé que podría usar el comienzo de la descripción del menú de la ayuda, pero no puedo encontrar cómo acceder a su contenido.

Vi que WinHelp tiene un lenguaje macro, así que pensé que quizás a través de esto, pero no pude encontrar ninguna referencia sobre esto.

¿Alguien ahora tiene algunos consejos o ejemplos para hacer esto?

Answer 1

la utilidad winhelpcgi contiene código de biblioteca que puede leer archivos .hlp. La fuente está aquí: enlace

No lo he usado, así que no puedo garantizar su uso.

Answer 2

Primero, su sistema de ayuda debe tener un Índice sobre cada tema que le permita abrir la ayuda y hacer que aparezca ese tema (si no, consulte Help & amp; Manual : te ayudará a crear archivos de ayuda más completos). Sin embargo, esto no resuelve directamente su problema ya que, según tengo entendido, desea que aparezca en una ventana de ayuda de herramientas.

Por lo tanto, deberá pasar por debajo de la superficie y descubrir cómo el sistema de Ayuda utiliza la clave para obtener la información adecuada. Sin embargo, no es una tarea trivial (por lo que puedo decir) acceder directamente a un fragmento de texto específico e indexado en un archivo WinHelp. Puede encontrar alguna información aquí que es de utilidad. También es posible que desee explorar los foros en el sitio web de Ayuda y Manual.

Sin embargo, aquí hay una pregunta más importante: ¿realmente tiene sentido abrir un tema de ayuda completo (incluso si es breve) cuando un usuario simplemente se desplaza sobre un elemento o botón de menú? A mí no, y pasé años en un grupo de diseño de interfaz de usuario en Bell Labs. Es A) simplemente demasiada información y B) va a ser una distracción visual (y por lo tanto increíblemente irritante) para los usuarios experimentados. La práctica aceptada aquí es abrir una ventana de ayuda de herramientas con un descriptor muy breve (1-4 palabras) del botón ("Abrir" o "Abrir archivo").

Si desea que la ayuda esté disponible para cada elemento de menú o botón, sugeriría una de dos alternativas.

Primero, considere tener un " Modo de cursor de ayuda " donde el cursor usa el ícono de ayuda (una flecha con un signo de interrogación). El usuario accede a través de un botón de Ayuda en la barra de botones. Cuando está en modo de cursor de ayuda, un usuario que hace clic en cualquier elemento lo llevará al tema de ayuda para ese elemento. Estoy un poco tibio con este enfoque, ya que es modal, pero ciertamente lo he visto hecho.

Segundo, puede que simplemente refuerce un poco su sistema de ayuda. Es decir, cree un tema en su sistema de Ayuda que presente una captura de pantalla de su aplicación. En esta captura de pantalla, cree puntos calientes para cada elemento y / o botón del menú y permita que el usuario vaya al tema apropiado haciendo clic en él. Bien hecho, esto le da al usuario una clave visual de los temas que desea aprender sin interferir con el funcionamiento normal de su programa.

Lo más importante: antes de hacer todo el trabajo necesario para implementar su plan actual, ¡esté seguro de que es el plan correcto!