Ce tutorial va vous permettre de réaliser une aide contextuelle pour votre programme. Pour l'appeler, il suffira de cliquer sur le bouton [?] en haut à droite de la fenêtre (à côté du bouton de fermeture) puis sur le contrôle dont on veut une explication. Si une rubrique d'aide est associée, alors le contenu est affiché dans une sorte de pop-up.
Ce tutorial se sert des logiciels suivants :
- Word (c'est pour faire du RTF donc n'importe quel éditeur relativement évolué suffit)
- Microsoft Help Workshop (il est possible de faire des fichiers HLP avec d'autres logiciels, mais la procédure risque d'être différente)
- et bien sur VB !
Ouvrir Word et créer un nouveau document vierge.
Enregistrer au format RTF sous un nom quelconque.
Commencer à taper vos rubriques d'aide comme suit :
* Commencer par insérer une note de bas de page (Insertion/Note de bas de page...)
Dans la fenêtre apparue, choisir "Note de bas de page", "Personnalisée" et taper "#" dans la zone de texte. Valider
Dans la barre qui vient de s'afficher en bas de la page, taper derrière le signe dièse soit "0" (texte affiché si on lance le HLP par l'explorateur) soit un numéro (pour identifier la rubrique lors de l'appel de l'aide - ce peut donc être n'importe quel signe, mais il doit être unique - pour plus de facilité, continuer 1, 2, 3, 4...).
* Retourner dans la zone de frappe et écrire le contenu de la rubrique. Pour la page affichée par défaut ("0"), vous pouvez mettre un message du genre "Ce fichier n'est pas destiné à être parcouru". Attention, vous pouvez mettre en page le texte mais - entre autres - vous ne pouvez pas mettre d'image.
*Enfin faire un saut de page (insertion/saut.../saut de page) et recommencer
Ensuite, enregistrer le tout et quitter Word. Pensez à écrire les correspondances contrôle<=>numéro dans l'aide sur un bout de papier par exemple (style : numéro 1 : aide pour le bouton OK)
Ouvrir Help Workshop et cliquer sur "file/new/help project".
Donner un nom au projet et cliquer sur "enregistrer"
Cliquer à droite sur "files". Dans la fenetre, cliquer sur "add", sélectionner votre fichier puis "ok" et "ok"
Cliquer sur "map" puis sur "add"
Dans la zone "topic id", mettre un identifiant et dans "mapped numeric value", mettez le numéro de la rubrique dans le fichier RTF et recommencer pour chaque rubrique. Le plus simple et de mettre la même valeur pour les deux.
Dans "options", vous pouvez paramétrer les propriétés du fichier :
- Default topic : "0" (notre texte : ceci n'est pas destiné à etre parcouru..."
- Help title : titre de la fenetre qui s'affiche si on passe par l'explorateur windows
- Compression : maximum
- Help file : nom du fichier généré (*.hlp)
- Log file : fichier de log des erreurs de compilation
Dans "windows", vous pouvez créer un nouveau style de fenetre pour par exemple changer la couleur de fond (défaut : jaune).
Enfin, cliquer sur "save and compile" en bas à droite
Maintenant, ouvrir le projet VB qui doit être lié à l'aide.
Au niveau de la fenêtre, mettez les propriétés "whatsthishelp" et "whatsthisbutton" sur "true"
Sélectionnez un contrôle et dans la propriété "whatsthishelpid" mettez le numéro correspondant du fichier d'aide
Enfin, dans les propriétés du projet, définissez comme "helpfile" le chemin d'accès et le nom du fichier
Cette valeur, si elle peut changer (app.path par exemple), doit alors être modifiée au démarrage du prog par :
app.helpfile = app.path & "fichieraide.hlp"
Voila voila
Si c'est trop long ou trop compliqué, allez voir dans le zip ce que ca donne en action (j'ai mis en plus le contenu de cet article à l'intérieur).
Laissez des commentaires SVP !!!