EstDev raconte VB


 
Page d'accueil
 
Code Source
  INTERNET
  FICHIER
  SYSTEME
  CONTROLE
  DIVERS
 
Trucs et Astuces
  API
  SYSTEME
  CONTROLE
  DIVERS
 
VB Knowledgebase
  BUG
  FIX
  HOWTO
  INFO
  PRB
  SAMPLE
  DOC
  FILE
 
Liens
  SITE FRANCOPHONE
  SITE ANGLOPHONE
 
Livres
  EN FRANCAIS
  EN ANGLAIS
 
Downloads
  ADD-INS POUR VB
  FREE ACTIVEX
  OUTILS
 
Api Win32
  ACCUEIL API
  EXPLICATION
  LES FONCTIONS
  EXEMPLES
 
Divers
  VBSCRIPT
  VBAPPLICATION
  ACCUEIL DIVERS
  RECHERCHE
 
Me contacter



Microsoft a présenté HTML Help au mois d'août 1997 comme le successeur de WinHelp. Comme ce produit est relativement récent, il n'a pas encore été utilisé dans beaucoup d'application. Mais, il semblerait que tous les futurs produits de Microsoft utiliseront ce système, a commencé par Windows 98, Visual Studio 6.0 et Office 2000.
Il faut qu'Internet Explorer 3.02, ou supérieur soit installé par faire fonctionner ce système d'aide ; pour tirer parti de tous les avantages du système, il vaut mieux posséder la dernière version.
Ci-dessous vous trouvez : L'article
                                      Des outils
                                      Des liens
                                      Un Tutorial complet a télécharger (en anglais)

Si vous ne possédez pas encore HTML Workshop, ou pour télécharger la dernière version 1.2, RDV sur le site de Microsoft.
Voici les extensions des fichiers utilisés dans HTML Help :
.HHP = Projet d'aide
.HHC = Toc (Table of contents)
.HHK = Index
.CHM = Fichier d'aide Html compilé
.HTM = Fichier individuel
.H = Fichier Header

L'exemple avec tous ces fichiers + un exemple VB, vous pouvez le télécharger ici

Créer votre 1er projet HTML Help

Avant de faire votre système d'aide, vous devez créez les fichiers HTML que vous aurez besoin. Ouvrez Workshop pour créer un nouveau projet. L'assistant démarre, remplissez les options, n'oubliez pas de cocher la case "HTML Files" et enfin sur "Finish". La fenêtre principale de Workshop doit ressembler à la Figure A.

Fenêtre de HTML Help Workshop

Figure A

La partie gauche de la fenêtre comprends 3 onglets, ainsi que des boutons personnalisés pour chaque onglet (sur la gauche). Vous pouvez utiliser l'onglet Project pour changer des options, ajouter ou supprimer des Topic files, ajouter ou modifier les définitions de la fenêtre, ainsi que de changer les options du HTML Help API.
Pour ajouter une toc (table of contents) dans votre projet, cliquez sur l'onglet "Contents". Une boîte apparaît, choisissez "Create a new contents file" pour créer une toc vide.. Maintenant vous pouvez ajoutez votre sommaire en utilisant les boutons "Insert Heading" et "Insert Page". Dans la boîte de dialogue qui apparaît lorsque vous sélectionnez ces options, vous pouvez associer les fichiers HTML aux "Headings" et "Pages". Le fichier Index définit les entrées d'index (mots clés) que vous voyez lorsque vous cliquez sur l'onglet Index. Pour ajouter un index à votre projet, cliquez sur son onglet, et dans la boîte qui apparaît, choisissez "Create New Index". Puis vous pouvez ajoutez vos mots clés en cliquant sur le bouton "Insert a Keyword" et associer un fichier HTML pour ce mot clé. De même, vous pouvez supprimer, organiser vos mots clés en utilisant les boutons Edit, Delete et Move Selection.

"Windows definitions" vous permet de définir l'apparence d'une fenêtre d'aide. Vous pouvez spécifiez quels boutons a afficher sur la barre d'outils, quel onglet a afficher dans le panneau de navigation, et d'autres propriétés, lesquels joueront sur le style d'affichage d'une fenêtre d'aide.

Lorsque vous appelez HTMLHelp Api de VB, vous pouvez référencer les définitions des fenêtres et afficher la fenêtre d'aide dans différent styles. Cliquez sur l'onglet "Project", puis sur le bouton "Add/Modify Windows Definitions". Dans la boîte qui apparaît, écrivez MyWindow (ou un autre nom) et cliquez sur OK. A ce moment, une nouvelle définition de fenêtre est créée. Si vous voulez ajouter un onglet Recherche dans votre projet, avant de cliquer sur Ok, cliquez sur l'onglet "Navigation Pane" et sélectionnez l'option "Add Search Option". A ce moment la, si vous cliquez sur Ok, un assistant démarre. Dans la 2ème fenêtre de cette assistant, sélectionnez "Compile Full-text Information" pour laisser au Help compilateur de construire les entrées pour l'onglet recherche lorsque vous compilerez votre projet.

Le bouton HTMLHelp API Information permet de faire l'aide contextuel. Lorsque vous cliquez ce bouton, la boîte de dialogue d'information HTMLHelp API apparaît. Vous pouvez y associer un fichier Header (Figure B), qui définit tous les context IDs. HTMLHelp accepte uniquement des fichiers header de type C, la Figure B montre le contenu d'un fichier header typique, fait avec Notepad.

Fichier Header

Figure B

Vous pouvez utilisez l'onglet "Alias" pour associer les constantes ID de l'aide      contextuelle définis dans le fichier header aux fichiers HTML (voir Figure C). Lorsque vous appelez HTMLHelp de VB avec avec une constante ID d'aide contextuelle, vous pouvez naviguez vers le fichier HTML associé avec cette constante.

Associer des IDs contextuel avec des fichiers HTML dans l'onglet "Alias"

Figure C

Les outils

KeyTools : est un set d'utilitaires pour gérer vos systèmes d'aide HTML Help et WinHelp. Permet de décompiler le source d'un fichier HTML Help compilé (.chm) et de les recompiler. Possède une multitude de fonctions pour gérer vos fichiers d'aide.
Cliquez ici pour le télécharger (Freeware). Pour en savoir plus, RDV sur sa
page d'accueil.

HHC2List : cet utilitaire lit le fichier toc (.HHC - Table of contents) ou le fichier Index (.HHK) et crée du html à partir de la table, que tout navigateur peut lire. Cliquez ici pour le télécharger (Freeware).Pour en savoir plus, RDV sur la page du créateur

KeyHH : est un programme qui accroît les possibilités de HTML Help Workshop. Il peut être utilisé en addition ou en remplacement de HH.exe. Il contient toutes les fonctionnalités de HH.exe, et donne des solutions sur quelques bugs de HTML Help comme : ouvrir une fenêtre HTML Help automone, ouvrir un HTML Help topic depuis un WinHelp topic, etc...Cliquez ici pour un essai (Freeware). Allez sur la
page d'accueil pour plus de renseignements.

HHLPCTL : c'est un HTML Help OCX pour une utilisation avec Visual Basic. Ce contrôle enveloppe la version de HTML Help API de VB, et fournit les méthodes suivantes : ShowContents, ShowIndex, ShowTopic, ShowContents et plusieurs propriétés. Un exemple est fourni dans le fichier .zip ainsi qu'un fichier d'aide HTML. Cliquez ici pour télécharger (Freeware).

HTMLHelp/WinHelp Objects DLL 1.0 : (Freeware) cette DLL enveloppe les API's pour HTML Help et WinHelp. Elle implémente les fonctions nécessaires les plus importantes pour inclure ces 2 types de système d'aide dans une application VB, et décide quand utiliser WinHelp lorsque HTML Help n'est pas installé sur un système. Téléchargez la DLL suivant votre version de VB : Visual Basic 5 ou Visual Basic 6

DLLVB5SRC : ce fichier contient la DLL HTMLHelp/WinHelp Objects DLL 1.0 ainsi qu'un projet et son source code. Ce projet contient les 2 modes d'appel, pour HTMLHelp et WinHelp. Si vous faites des améliorations sur ce code, veuillez contacter David E. Liske à delmar@tc3net.com, pour en faire profiter toute la communauté. Pour téléchargez ce projet et la DLL, cliquez ici.

Vous pouvez aussi téléchargez VBF1Test, qui est un projet test en Visual Basic pourAide contextuellefaire des aide contextuelle avec HTML Help (voir image ci-contre).

Vous trouverez d'autres outils sur le site de FAR, tel que HHServer, freeware qui remplace HH.exe, ou FAR Utility, qui possède une variété de "multi-file and Html Tools" incluant un rapide et un simple générateur de MS Html Help.

Les liens

http://www.helpstuff.com/ 
http://www.keyworks.net/
http://www.helpuniversity.com/
http://www.helpmaster.com/
http://www.hypertexas.com/htmlhelp.htm
http://www.216.46.233.36/htmlhelp.asp
http://www.blue-sky.com/products/download/
http://www.microsoft.com/workshop/author/htmlhelp/


Mise à jour le 07.02.1999
Webmaster : mstoll