Esiste una libreria / api per leggere il contenuto di un file di aiuto .hlp?

Question

Ho un file di aiuto per il mio programma e mi è stato chiesto di aggiungere una descrizione dei menu in una barra degli strumenti mentre l'utente li naviga. Quindi ho pensato di poter usare solo l'inizio della descrizione del menu dell'aiuto, ma non riesco a trovare il modo di accedervi.

Ho visto WinHelp avere un linguaggio macro, quindi ho capito forse attraverso questo, ma non sono riuscito a trovare riferimenti su questo in giro.

Qualcuno ora alcuni puntatori o esempi di hot per fare questo?

Answer 1

l'utilità winhelpcgi contiene il codice della libreria in grado di leggere i file .hlp. La fonte è qui: link

Non l'ho usato, quindi non posso garantirne l'utilizzo.

Answer 2

Innanzitutto, il tuo sistema di aiuto dovrebbe avere un indice su ciascun argomento che ti consenta di aprire l'aiuto e di far apparire quell'argomento (in caso contrario, controlla Guida e manuale - ti aiuterà a creare file di guida più completi). Tuttavia, questo non risolve direttamente il tuo problema poiché, come ho capito, vuoi che questo compaia in una finestra di aiuto.

Pertanto, dovrai andare sotto la superficie e capire come il sistema di guida utilizza la chiave per estrarre le informazioni appropriate. Tuttavia, non è banale (per quanto posso dire) accedere direttamente a un pezzo di testo specifico e indicizzato in un file WinHelp. È possibile trovare alcune informazioni qui utili. È inoltre possibile consultare i forum sul sito Web Guida e Manuale.

Ecco una domanda più grande: ha davvero senso far apparire un intero argomento di aiuto (anche se breve) quando un utente passa sopra una voce di menu o un pulsante? Non è per me e ho trascorso anni in un gruppo di progettazione dell'interfaccia utente presso Bell Labs. È A) semplicemente troppe informazioni e B) sarà fonte di distrazione visiva (e quindi incredibilmente irritante) per utenti esperti. La pratica accettata qui è quella di far apparire una finestra di aiuto con un descrittore molto breve (1-4 parole) del pulsante (" Apri " o " Apri file ").

Se vuoi che l'aiuto sia disponibile per ogni voce di menu o pulsante, suggerirei una delle due alternative.

Per prima cosa, considera di avere una "Guida in modalità cursore" " dove il cursore utilizza l'icona della guida (una freccia con un punto interrogativo). L'utente accede ad esso tramite un pulsante Guida sulla barra dei pulsanti. In modalità Cursore guida, un utente fa clic su qualsiasi elemento per portarlo all'argomento della guida per quell'elemento. Sono un po 'tiepido con questo approccio dato che è modale ma sicuramente l'ho visto fatto.

In secondo luogo, potresti semplicemente rinforzare un po 'il tuo sistema di aiuto. Cioè, crea un argomento nel tuo sistema di Guida che presenta una schermata della tua applicazione. In questa schermata, crea hot spot per ciascuna voce di menu e / o pulsante e consenti all'utente di accedere all'argomento appropriato facendo clic su di esso. Fatto bene, questo fornisce all'utente una chiave visiva degli argomenti che desiderano conoscere senza interferire con il normale funzionamento del programma.

Soprattutto: prima di fare tutto il lavoro necessario per attuare il tuo piano attuale, assicurati di essere sicuro che è il piano giusto!