Dunque... immaginiamo di richiamare la guida su una textbox alla pressione di F1. Questa textbox dovrebbe contenere per esempio con un codice fiscale. Per prima cosa bisogna impostare la proprietà HelpContextID con un valore numerico, per esempio 50.
Nelle proprietà del progetto, scheda Generale, devi impostare la proprietà "Nome file della guida" con il nome del file chm che hai generato con l'HTML Help WorkShop (HHW), per esempio "guida.chm". Per quello che riguarda VB è tutto, tranne che per chiamare direttamente la guida da codice devi servirti della funzione API HtmlHelp:
codice:
Dim ret As Long
ret = HtmlHelp(Me.hwnd, App.Path & "\guida.chm", HH_DISPLAY_TOPIC, 0)
Vediamo ora cosa fare con HHW.
HHW è un programma abbastanza scarno, ma le impostazioni non sono del tutto incomprensibili, anzi, se penso a come si sviluppavano le guide con il vecchio sistema (.hlp) mi viene male.
Bisogna innanzitutto creare un nuovo progetto (guida.hhp) ed impostare le proprietà principali, disponibili premendo il primo pulsante in alto nella scheda Project (Change project options). Si apre la finestra Options, sulla scheda General puoi impostare il titolo, il file html di default (l'home page, in pratica) e altre opzioni meno importanti. Chiudi questa finestra e torna a HHW.
Con il secondo pulsante (Add/Remove topic files) puoi aggiungere l'elenco dei file html che vuoi includere nel progetto. Essi appariranno nella sezione [FILES] del progetto. Nell'esempio si andrà a caricare home.htm e codicefiscale.htm
Il quarto pulsante (HtmlHelp API information) è quello più interessante, appare una finestra con tre schede: Map, Alias, Text Pop-ups.
Map. Premere il pulsante "Header file" per aggiungere il file map.h contenente il collegamento tra l'HelpContextID (che è un numero) ed una definizione di tipo testo. nel nostro esempio map.h contiene solamente una riga:
codice:
#Define CODICE_FISCALE 50
Di seguito si aggiungeranno via via altre definizioni, sempre in concerto con quanto fatto all'interno di VB.
Alias. Permette di associare la definizione testuale del file map.h con il file html da collegare. Premendo Add si entra in un'altra finestra, nella prima textbox si scrive il nome della definizione: CODICE_FISCALE ; nella seconda casella si prende il file htm da associare (codicefiscale.htm).
Dopo questi contorti passaggi, puoi avviare la compilazione e vedere cosa accade! Probabilmente mancano ancora altri dettagli, è da un po' che non mi cimento con HHW, se hai problemi chiedi pure! Ciao
Permessi di invio
Rispondi quotando