Astuces de recherche...
Home
- Accueil & nouveautés
- Les newsgroups VB
- Téléchargements
- L'équipe
- Nous contacter
- Liens
Rubriques
- Toutes les questions
- Affichage & graphismes
- Algorithmique
- API
- Base de registre
- Bases de données
- Contrôles
- Date & heure
- Déploiement
- Divers
- Erreurs & problèmes
- Fichiers & dossiers
- Généralités
- Impression
- Internet & mails
- Math
- Multimédia
- Réseaux
- Structures de données
- Texte & strings
- VB .Net
- VB Script
- VBA
- Windows

Question 119

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 :

Date de publication : 13 février 2003
Dernière modification : 13 février 2003
Rubriques : Divers
Mots-clés : aide, help, HTML Workshop, HTMLHelp, hxs, chm, hlp