3.L'interfaçage à un programme Delphi 1

Utiliser une méthode de l'application.

Une façon simple d'invoquer le fichier d'aide est d'ajouter la commande à l'action Clic d'un bouton :

Application.HelpJump(ChaîneDeContexte : string)

Au préalable, il faut avoir indiquer au projet Delphi le nom du fichier d'aide ou régler la propriété HelpFile... Sinon il faut faire appel à l'API Windows.

Vous pouvez essayer avec ce fichier d'aide et la chaîne contexte 'hlp_fichierRTF' .

 

Utiliser la propriété HelpContext.

Néanmoins ceci demande l'écriture d'une ligne de code pour chaque appel à une rubrique différente.

Le projet ayant différents thèmes, il faut que l'aide demandée sur un objet Delphi par F1 dans le logiciel arrive directement sur la bonne rubrique. C'est le rôle de la propriété HelpContext

La propriété HelpContext contient un nombre entier, qui différent de 0 (zéro) est un numéro de contexte unique. Ce numéro de contexte va de pair avec une chaîne de contexte. Mais dans une aide indépendante, aucun numéro de contexte n'est utilisé, donc aucun numéro de context n'est défini à prioiri.

Il va falloir indiquer la correspondance entre un numéro et une chaîne de contexte dans le fichier projet HPJ.

Le menu Edit, Application Contexts vous permet d'indiquer un numéro et la chaîne contexte associée.

Ainsi HelpContext contient le numéro de contexte associé à la chaîne contexte de la rubrique sur laquelle l'aide va pointer.

Essayez avec le HelpContext d'un objet à 5 et ce fichier HLP comme fichier d'aide.

Vous devez retomber sur la page RTF de ce fichier.

 

Maintenant vous pouvez améliorer votre aide


Sommaire | 1 le fichier texte RTF | 2 le fichier scripte HPJ | 3 l'interfaçage à Delphi 1 | 4 les améliorations | 5 un avenir proche