Comment intégrer un fichier d'aide à mon application ?
VB reconnaît deux formats de fichier d'aide :
- Le Microsoft Windows Help (.hlp) : Ce format, existant déjà depuis
longtemps, est à la base constitué de fichiers RTF (Rich Text Format) et
d'images. Le compilateur officiel n'est plus disponible, ni documenté en
ligne, mais il est toujours possible de l'installer à partir du dossier
"Common\Tools\VB\HCW" de votre CD de Visual Basic. Vous trouverez
sur Internet divers utilitaires permettant de générer facilement vos
fichiers .hlp et d'éditer les liens entre les différentes rubriques, comme
par exemple le programme Helpi.
Notez que ce format de fichier est devenu maintenant désuet et n'est plus du
tout conseillé.
- Le Microsoft HTML Help (.chm, .chi) : Beaucoup plus récent, mais non
supporté par VB5, ce format d'aide emploie des fichiers HTML, des scripts
Java, VB et des images au format gif, jpeg, png et bmp. Le compilateur
officiel (HTML Help Workshop) et sa documentation sont disponible en
téléchargement sur la MSDN : Microsoft
HTML Help Downloads. Une version online de la documentation est aussi
disponible : HTML
Help 1.3 SDK.
Les fichiers d'aide DOS (portant eux aussi l'extension hlp), de même que le
nouveau format de fichier d'aide .hxs (utilisé notamment par la nouvelle
platform SDK), ne sont pas pris en charge par VB.
Une fois votre fichier d'aide créé, il ne vous reste plus qu'à renseigner
son nom et son emplacement dans les propriétés de votre projet. Pour ce faire,
cliquez sur le menu "Projet/Propriétés...". Sous l'onglet
"Général", dans le champ "Nom du fichier d'aide", vous
pouvez maintenant spécifier soit :
- Un chemin relatif : c'est-à-dire un chemin du type "help/help.chm".
Dans ce cas, Visual Basic recherchera le fichier help.chm dans le
sous-dossier "help" du dossier de votre application. Si VB ne
trouve pas le fichier, il essayera alors de le chercher dans le dossier de
votre application ou bien dans le dossier "Help" de Windows.
- Un chemin absolu : c'est-à-dire un chemin du type "C:\Mes
Documents\Babar\help.chm". De même, si VB ne trouve pas le fichier, il
essayera alors de le chercher dans le dossier de votre application ou bien
de le dossier "Help" de Windows.
Le champ "ID de contexte d'aide du projet" sert, quant à lui, à
définir quelle page doit être affichée "par défaut" (il s'agit
généralement d'une page d'accueil) lorsque l'utilisateur presse F1 dans votre
programme.
Ensuite, pour lier une page d'aide à un contrôle, il vous suffit de
renseigner la propriété HelpContextID.
Pour terminer, voici deux sites sur lesquels vous trouverez plein
d'informations sur la conception de fichiers d'aide :
|