Le premier site francophone dédié
au développement Pocket PC
 |
Comment créer un fichier d'aide ?
|
Note: Cet article est valable pour eVB et pour eVC.
Il faut de rendre à l'évidence, un fichier d'aide Pocket PC est en fait un fichier au format HTML avec des balises en plus. Ni plus ni moins, et c'est plutôt pratique pour effectuer une mise en forme efficace.
PegHelp
Le programme qui affiche un fichier d'aide est "PEGHELP.EXE", et se trouve dans le dossier "\Windows". C'est lui qui affiche le fichier d'aide HTML et qui interprête les balises spéciales. Les fichiers d'aide sont généralement placés aussi dans le dossier "\Windows" car PegHelp "regarde" d'abord dans sont répertoire d'exécution la présence du fichier demandé.
Les balises de PegHelp
PegHelp n'affiche qu'un seul sujet à la fois, alors que le fichier d'aide contient toute l'aide. Pour séparer les différentes parties de l'aide, il faut inclure des balises :
<!-- PegHelp -->
Il faut aussi étiquetter la rubrique avec un nom (par exemple TOTO) par une balise anchor :
<a name="TOTO"></a>
Lorsque vous voulez créer un lien vers une autre partie du fichier d'aide, il suffit de stipuler le nom de la rubrique (TOTO) dans le lien avec le nom du fichier HTML (et oui il faut impérativement le répéter) :
<a href="NomDuFichierAide.htm#TOTO">Texte de votre lien</a>
Le sommaire
Le programme PegHelp utilise la balise <META> pour connaitre la partie du fichier d'aide qui est le sommaire (voir exemple), ceci lui permet de se replacer sur le sommaire si ceci est demandé par l'utilisateur (item "Sommaire" du menu de "Afficher" du programme d'aide)
Exemple (fichier testaide.htm)
<HTML>
<HEAD>
<META Content="testaide.htm#sommaire">
<TITLE>Aide Pocket PC</TITLE>
</HEAD>
<BODY>
<!-- PegHelp -->
<a name="sommaire"></a>Sommaire<br>
<a href="testaide.htm#sujet 1">Premier sujet</a><br>
<a href="testaide.htm#sujet 2">Deuxième sujet</a><br>
<a href="testaide.htm#sujet 3">Troisième sujet</a><br>
<!-- PegHelp -->
<a name="sujet 1"></a>Premier sujet<br>
Ceci est l'aide du premier sujet<br>
ligne 1<br>
ligne 2<br>
ligne 3<br>
<!-- PegHelp -->
<a name="sujet 2"></a>Deuxième sujet<br>
Ceci est l'aide du 2ème sujet<br>
ligne 1<br>
ligne 2<br>
ligne 3<br>
<!-- PegHelp -->
<a name="sujet 3"></a>Troisième sujet<br>
Ceci est l'aide du 3ème sujet<br>
ligne 1<br>
ligne 2<br>
ligne 3<br>
<!-- PegHelp -->
</BODY>
</HTML>
Ce fichier d'aide à la sauce Pocket PC affiche un sommaire composé de 3 liens.
Appel depuis eVC
Avec eVC, il suffit d'utiliser la fonction CreateProcess (librairie coredll) comme ceci :
CreateProcess(TEXT("PegHelp.exe"), TEXT("TestAide.htm#sommaire"), NULL, FALSE, 0, NULL, NULL, NULL, NULL, NULL);
Appel depuis eVB
En utilisant la même fonction qu'en C (voir sa mise en oeuvre dans l'article "Comment lancer un autre programme depuis eVB"), comme ceci :
Call CreateProcess("PegHelp.exe", "TestAide.htm#sommaire", 0, 0, 0, 0, 0, 0, 0, 0)
Voilà, vous pouvez maintenant ajouter à vos créations eVB et eVC++ un fichier d'aide, ce qui est très appréciable pour l'utilisateur !
iPAQ
est un produit de COMPAQ.
Visual Tools est un produit de Microsoft Corporation.
Toutes les autres marques et produits présents dans ces pages
sont la propriété exclusive de leurs sociétés
respectives.