Comment faire pour créer un système d'aide HTML à l'aide de l'API HTMLHelp ou l'aide HTML dans Access

Traductions disponibles Traductions disponibles
Numéro d'article: 828419 - Voir les produits auxquels s'applique cet article
Agrandir tout | Réduire tout

Sommaire

Résumé

Microsoft HTML Help Workshop est un outil avec une interface graphique facile à utiliser de création d'aide. Vous pouvez utiliser HTML Help Workshop pour créer les types de fichiers suivants :
  • Fichiers de projet d'aide
  • Fichiers de rubrique
  • Fichiers de contenu
  • Fichiers d'index
Vous pouvez placer ces fichiers pour créer un système d'aide en ligne.

Atelier d'aide HTML version 1.3 est fourni avec le Kit de ressources Microsoft Office 2003. Atelier d'aide HTML version 1.3 peut être utilisé pour créer un système d'aide qui fournit une assistance et des informations personnalisées.

Cet article décrit comment créer un système d'aide simple dans HTML Help Workshop, puis comment utiliser le fichier d'aide dans un formulaire Microsoft Office Access 2003 à l'aide de l'API HTMLHelp.


Créer le Systemby aide à l'aide de HTML Help Workshop

Vous pouvez créer deux types de rubriques d'aide à l'aide de HTML Help Workshop :
  • Au niveau de la fenêtre aide Dans l'aide au niveau de la fenêtre, la rubrique d'aide apparaît dans un déclencheur de whenyou la fenêtre de la rubrique d'aide. La source de la rubrique d'aide au niveau de la fenêtre est le fichier anHTML.
  • Aide contextuelle Dans l'aide contextuelle, la rubrique d'aide apparaît dans un pop-upwindow lorsque vous déclencher la rubrique d'aide. La source de la rubrique contexte-sensitiveHelp est un fichier texte qui contient le contenu qui doit apparaître dans la fenêtre de thepop pour chaque rubrique d'aide.
Rubriques d'aide sont créées individuellement, et ensuite les rubriques sont incluses dans un projet HTML Help Workshop. Ce projet est ensuite compilé pour créer un système d'aide HTML (fichier *.chm).


Créer des rubriques d'aide

Vous pouvez créer une rubrique d'aide au niveau de la fenêtre en créant au moins un fichier HTML de la rubrique d'aide. Utilisez le bloc-notes ou un éditeur HTML pour créer des fichiers HTML. HTML Help Workshop vous permet également de créer un fichier HTML. Pour créer un fichier HTML pour les rubriques d'aide à l'aide de HTML Help Workshop, procédez comme suit :
  1. Cliquez sur Démarrer, pointez sur tous les programmes, puis cliquez sur HTML Help Workshop.
  2. Dans le menu fichier , cliquez surNouveau.
  3. Dans la boîte de dialogue Nouveau , cliquez surprojet, puis cliquez sur OK.
  4. Dans la boîte de dialogue Nouveau projet , cliquez sursuivant.
  5. Dans le Nouveau projet--Destination dialogbox, cliquez sur Parcourir.
  6. Dans la boîte de dialogue Ouvrir , cliquez surC: dans la liste Regarder dans .
  7. Créez un nouveau dossier nomméTestHelpProject.
  8. Dans la boîte de dialogue Ouvrir , sélectionnezTestHelpProject, puis cliquez sur Ouvrir.
  9. Dans la zone nom de fichier , tapezMyProject, puis cliquez surOuvrir.
  10. Dans le Nouveau projet--Destination dialogbox, cliquez sur suivant.
  11. Dans la boîte de dialogue Nouveau projet, les fichiers existants, cliquez sur suivant.
  12. Dans la boîte de dialogue Nouveau projet, terminer , cliquez sur Terminer.
  13. Dans le menu fichier , cliquez surNouveau.
  14. Dans la boîte de dialogue Nouveau , cliquez sur HTMLFile, puis cliquez sur OK.
  15. Dans la boîte de dialogue Titre HTML , tapezAide de zone de texte, puis cliquez sur OK.
  16. Entre<BODY></BODY>et, type Il s'agit de la rubrique d'aide pour la zone, puis cliquez sur OK.
  17. Dans le menu fichier , cliquez sur SaveFile.
  18. Dans la boîte de dialogue Enregistrer sous , double-cliquez surC:\TestHelpProject. Dans la zone Nom de fichier , tapez Sample1.htm, puis cliquez surEnregistrer.

    Le fichier d'aide Sample1.htm est enregistré dans le dossier theC:\TestHelpProject.
  19. Dans le menu fichier , cliquez surNouveau.
  20. Dans la boîte de dialogue Nouveau , cliquez sur HTMLFile, puis cliquez sur OK.
  21. Dans la boîte de dialogue Titre HTML , tapezBouton aide, puis cliquez sur OK.
  22. Entre<BODY></BODY>et, type Il s'agit de la rubrique d'aide pour le contrôle de bouton, puis cliquez sur OK.
  23. Dans le menu fichier , cliquez sur SaveFile.
  24. Dans la boîte de dialogue Enregistrer sous , double-cliquez surC:\TestHelpProject. Dans la zone Nom de fichier , tapez Sample2.htm, puis cliquez surEnregistrer.
  25. Dans HTML Help Workshop, cliquez sur Ajouter/supprimer les fichiers de rubrique.

    Remarque :Ajouter ou supprimer les fichiers de rubrique est le second bouton vers le bas sous l'onglet projet .
  26. Dans la boîte de dialogue Fichiers de rubriques , cliquez surAjouter, puis recherchez et ajoutez les fichiers Sample1.htm et theSample2.htm.

Créer une aide contextuelle pour chaque rubrique d'aide

L'aide contextuelle pour toutes les rubriques d'aide pris en charge doit être répertoriés dans un fichier texte. Vous pouvez créer le fichier texte en utilisant le bloc-notes, et ensuite, vous pouvez inclure le fichier texte dans le projet actuel dans HTML Help Workshop.

Pour créer le fichier d'aide contextuelle pour les rubriques d'aide, procédez comme suit :
  1. Cliquez sur Démarrer, puis cliquez surexécuter.
  2. Dans la zone Ouvrir , tapezbloc-notes, puis cliquez sur OK.
  3. Copiez le texte suivant, puis collez le texte inNotepad :

    .topic 1
    This is a text pop-up window for Text Box Control Help.
    
    .topic 2
    This is a text pop-up window for Button Control Help.
    
    
    Remarque : Chacune des références de rubrique d'aide doit commencer par .topic. Le .topic doit être suivi par un espace et ensuite par un numéro ou par un numericconstant. Ce numéro doit correspondre à l'ID de contexte pour la rubrique d'aide. Thecontent de la fenêtre contextuelle de la rubrique d'aide se trouve sur la ligne suivante.
  4. Dans le menu fichier , cliquez surEnregistrer.
  5. Dans la boîte de dialogue Enregistrer sous , double-cliquez surC:\TestHelpProject, type Popuptext.txtdans la boîte de dialogue Nom de fichier de zone, puis cliquez surEnregistrer.
  6. Fermez le bloc-notes.


Associer des ID de contexte d'aide à la rubrique identificateurs

Vous pouvez affecter les numéros d'ID de contexte à des rubriques spécifiques dans un fichier de mappage. Le fichier de mappage est en fait un fichier d'en-tête C qui est utilisé par le compilateur d'aide lorsque le compilateur d'aide compresse tous les fichiers *.htm dans un seul fichier *.chm. Le fichier de mappage est un fichier texte brut contenant le #define instruction pour chaque rubrique de votre système d'aide.

Par exemple, vous pouvez utiliser le code suivant :
#define FirstTopic 1
Dans le fichier de mappage, chaque instruction doit inclure un identificateur de rubrique est suivi par l'ID de contexte. Les applications qui utilisent le système d'aide peuvent faire référence à une rubrique à l'aide de l'ID de contexte qui est défini dans le fichier de mappage. Par conséquent, les fichiers de mappage vous aident à associer des ID de contexte aide à chaque rubrique d'aide.

Remarque : Le fichier de mappage est un fichier texte avec l'extension .h.

Pour créer un fichier de mappage pour les rubriques d'aide, procédez comme suit :
  1. Cliquez sur Démarrer, puis cliquez surexécuter.
  2. Dans la zone Ouvrir , tapezbloc-notes, puis cliquez sur OK.
  3. Copiez le texte suivant, puis collez le texte inNotepad :

    #define TEXTBOXHELP 1 #define BUTTONHELP 2
  4. Dans le menu fichier , cliquez surEnregistrer.
  5. Dans la boîte de dialogue Enregistrer sous , double-cliquez surC:\TestHelpProjectet puis sélectionnez Tous les fichiersdans la liste Enregistrer en tant que type .
  6. Dans la zone Nom de fichier , tapezMap.h, puis cliquez sur Enregistrer.

Associer des rubriques d'aide avec la rubrique identificateurs

Les rubriques d'aide (fichiers .html) doit être associé à un identificateur de rubrique qui est définis dans le fichier de mappage. Vous pouvez procéder de la sorte si vous définissez des alias pour les rubriques d'aide. Un alias est la relation entre une rubrique d'aide au niveau de la fenêtre (fichier .html) et un identificateur de rubrique dans un fichier de mappage. Par conséquent, vous devez créer les rubriques d'aide au niveau de la fenêtre avant de créer les alias.

Pour créer des alias pour les rubriques de niveau de fenêtre fonctionne correctement, procédez comme suit :
  1. Cliquez sur Démarrer, puis cliquez surexécuter.
  2. Dans la zone Ouvrir , tapezbloc-notes, puis cliquez sur OK.
  3. Dans le bloc-notes, tapez les lignes suivantes :TEXTBOXHELP = Sample1.htm ;BUTTONHELP = Sample2.htm ;
  4. Dans le menu fichier , cliquez surEnregistrer.
  5. Dans la boîte de dialogue Enregistrer sous , double-cliquez surC:\TestHelpProjectet puis sélectionnez Tous les fichiersdans la liste Enregistrer en tant que type .
  6. Dans la zone Nom de fichier , tapezAlias.h, puis cliquez sur Enregistrer.


Compiler le système d'aide pour créer un seul fichier HTML compressé

Une fois toutes les rubriques d'aide (fichiers .html), le fichier texte, le fichier de mappage et le fichier d'alias sont créées individuellement, vous devez désormais intégrer tous les fichiers dans le projet actuel de HTML Help Workshop. Ensuite, vous devez compiler le projet. Par conséquent, vous avez maintenant un seul fichier d'aide HTML compressé avec l'extension .chm qui est créé dans le répertoire en cours.

Pour intégrer tous les fichiers d'aide et ensuite, pour compiler le projet HTML Help Workshop, procédez comme suit :
  1. Cliquez sur Démarrer, pointez sur tous les programmes, puis cliquez sur HTML Help Workshop.
  2. Dans le menu fichier , cliquez surOuvrir.
  3. Dans la boîte de dialogue Ouvrir , cliquez surMyProject.hhp.
  4. Dans HTML Help Workshop, cliquez sur HTMLHelp APIInformation sous l'onglet projet .

    Remarque : Il s'agit du quatrième bouton vers le bas sur le côté gauche de l'ongletprojet .
  5. Sous l'onglet carte , cliquez sur Headerfile.
  6. Dans la zone fichier à inclure , tapezC:\TestHelpProject\Map.h, puis cliquez surOK.

    Notez que #include Map.happaraît dans la liste.
  7. Sous l'onglet Alias , cliquez surinclure.
  8. Dans la zone fichier à inclure , tapezC:\TestHelpProject\Alias.h, puis cliquez surOK.

    Notez que #include Alias.happaraît dans la liste.
  9. Dans l'onglet Menus contextuels du texte , cliquez sur fichier texte.
  10. Dans la zone fichier à inclure , tapezC:\TestHelpProject\Popuptext.txt, puis cliquez surOK.
  11. Cliquez sur OK.
  12. Dans le menu fichier , cliquez surcompiler.

    Le fichier d'aide MyProject.hhp compile pour créer le fichier MonProjet.chm.


Valider le système d'aide

Pour valider que le système d'aide a été créé, procédez comme suit :
  1. Démarrez l'Explorateur Microsoft Windows.
  2. Déplacer vers le fichier MonProjet.chm dans WindowsExplorer.
  3. Double-cliquez sur le toopen de fichier MonProjet.chm le fichier.

    Notez que lorsque la fenêtre HTMLHelp s'ouvre, une des pages de thetopic s'affiche.


Intégrer l'aide l'accès Systemin 2003

Vous pouvez utiliser le système d'aide que vous avez créé dans la section précédente de cet article dans Access 2003. Dans cet exemple, le système d'aide est testé dans un formulaire qui est créé dans la base de données Access 2003.

Créer un formulaire Access pour tester le système d'aide (fichier .chm)

Microsoft fournit des exemples de programmation à titre d'illustration uniquement, sans garantie expresse ou implicite. Cela sous-entend, sans toutefois être exhaustif, un processus opérationnel pour des circonstances d'utilisation particulières. Cet article suppose que vous êtes familiarisé avec le langage de programmation présenté ainsi qu'avec les outils utilisés pour créer et déboguer les procédures. Les ingénieurs du support technique Microsoft sont en mesure de vous expliquer une procédure particulière mais ne modifieront pas le code proposé en vue d'ajouter des fonctionnalité supplémentaires ou bien de concevoir des procédures qui répondraient à vos besoin spécifiques.
  1. Démarrez Access 2003.
  2. Créer une nouvelle base de données nomméeTestHelp.mdb dans la C:\TestHelpProjectfolder.
  3. Ouvrez la base de données TestHelp.
  4. Dans la base de données TestHelp, ajoutez un formulaire avec les followingspecifications :

    Formulaire : Test
    ------------------------------
    Légende : TestForm
    HelpFile : MonProjet.chm
    HelpContextId: 1

    Zone de texte
    ------------------------------
    Nom : Control1
    HelpContextId: 1

    Bouton
    ---------------------------------
    Nom : contrôle2
    HelpContextId: 2
  5. Dans le menu affichage , cliquez surCode.
  6. Déclarer des constantes et le functionsin suivant la section « Declarations ».
    Option Compare Database
    
    Const HH_DISPLAY_TOPIC As Long = &H0
    Const HH_SET_WIN_TYPE As Long = &H4
    Const HH_GET_WIN_TYPE As Long = &H5
    Const HH_GET_WIN_HANDLE As Long = &H6
    Const HH_DISPLAY_TEXT_POPUP As Long = &HE
    Const HH_HELP_CONTEXT  As Long = &HF
    Const HH_TP_HELP_CONTEXTMENU As Long = &H10
    Const HH_TP_HELP_WM_HELP As Long = &H11
    Const g_sHTMLHelpFile As String = "MyProject.chm::/Popuptext.txt"
    
    Private Declare Function HtmlHelp Lib "hhctrl.ocx" Alias "HtmlHelpA" (ByVal hwndCaller As Long, ByVal pszFile As String, ByVal uCommand As Long, ByVal dwData As Long) As Long
    Private Declare Function HtmlHelpByRefArg Lib "hhctrl.ocx" Alias "HtmlHelpA" (ByVal hwndCaller As Long, ByVal pszFile As String, ByVal uCommand As Long, ByRef dwData As Any) As Long
    Private Declare Function GetDlgCtrlID Lib "user32" (ByVal hWnd As Long) As Long
    Private Type HH_IDPAIR
        dwControlId As Long
        dwTopicId As Long
    End Type
    
          'This array must contain the number of controls that have
          'context-sensitive Help, plus one more for a zero-terminating
          'pair.
          Private ids(3) As HH_IDPAIR
    
  7. L'appel de l'API HTMLHelp pour afficher le contexte-sensitiveHelp. Pour ce faire, tapez ou collez le code suivant dans le codewindow.

    Remarque : Le code suivant mappe la touche F2 à l'obtenir contextuelle le contrôle actif.
    Private Sub Control1_KeyUp(KeyCode As Integer, Shift As Integer)
    If KeyCode = vbKeyF2 Then
               iRetCode = HtmlHelpByRefArg(Me.hWnd, _
                      g_sHTMLHelpFile, HH_TP_HELP_WM_HELP, ids(0))
    
          End If
    End Sub
    
    Private Sub Control2_KeyUp(KeyCode As Integer, Shift As Integer)
    
           If KeyCode = vbKeyF2 Then
               iRetCode = HtmlHelpByRefArg(Me.hWnd, _
                      g_sHTMLHelpFile, HH_TP_HELP_WM_HELP, ids(1))
    
          End If
    End Sub
    
    Private Sub Form_Load()
    
           ids(0).dwControlId = GetDlgCtrlID(Me.hWnd)
           ids(0).dwTopicId = Me.Control1.HelpContextId
           ids(1).dwControlId = GetDlgCtrlID(Me.hWnd)
           ids(1).dwTopicId = Me.Control2.HelpContextId
           ids(2).dwControlId = 0
           ids(2).dwTopicId = 0
    End Sub
  8. Enregistrez le formulaire sous le nomFormTest, puis fermez l'écran.


Tester le système d'aide (fichier .chm)

Utiliser le formulaire dans une base de données Access 2003 afin de tester l'aide au niveau de la fenêtre et l'aide contextuelle.

L'aide au niveau de la fenêtre de test
  1. Démarrez Access 2003.
  2. Ouvrez la base de données TestHelp.mdb.
  3. Ouvrez le formulaire FormTest en mode formulaire.
  4. Déplacer le focus vers la zone de texte Control1 sur l'écran et appuyez sur F1.

    Notez que ce niveau de la taille de lafenêtre rubrique d'aide pour le contrôle de Zone de texte apparaît.
  5. Déplacer le focus vers le bouton contrôle2 sur l'écran et appuyez sur F1.

    Notez que ce niveau de la taille de lafenêtre rubrique d'aide pour le contrôle de bouton apparaît.
Tester l'aide contextuelle
  1. Démarrez Access 2003.
  2. Ouvrez la base de données TestHelp.mdb.
  3. Ouvrez le formulaire FormTest en mode formulaire.
  4. Sélectionnez Control1et appuyez sur F2.

    Notez que l'aide contextuelle pour le contrôle de Zone de texte apparaît.
  5. Sélectionnez contrôle2et appuyez sur F2.

    Notez que l'aide contextuelle pour le contrôle de bouton apparaît.

Références

Pour plus d'informations, cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft :
192118 Comment faire : Utiliser les fenêtres texte HTML Help un programme VBasic

Propriétés

Numéro d'article: 828419 - Dernière mise à jour: lundi 23 septembre 2013 - Version: 6.0
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft Office Access 2003
Mots-clés : 
kbprogramming kbhelpfile kbhelp kbhowtomaster kbmt KB828419 KbMtfr
Traduction automatique
IMPORTANT : Cet article est issu d'une traduction automatique réalisée par un logiciel Microsoft et non par un traducteur professionnel. Cette traduction automatique a pu aussi être révisée par la communauté Microsoft grâce à la technologie Community Translation Framework (CTF). Pour en savoir plus sur cette technologie, veuillez consulter la page http://support.microsoft.com/gp/machine-translation-corrections/fr. Microsoft vous propose en effet des articles traduits par des professionnels, des articles issus de traductions automatiques et des articles issus de traductions automatiques révisées par la communauté Microsoft, de manière à ce que vous ayez accès à tous les articles de notre Base de connaissances dans votre langue. Il est important de noter que les articles issus de la traduction automatique, y compris ceux révisés par la communauté Microsoft, peuvent contenir des erreurs de vocabulaire, de syntaxe ou de grammaire. Microsoft ne pourra être tenu responsable des imprécisions, erreurs, ainsi que de tout dommage résultant d?une traduction incorrecte du contenu ou de son utilisation par les clients.
La version anglaise de cet article est la suivante: 828419
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com