Existe-t-il une bibliothèque / api pour lire le contenu d'un fichier d'aide .hlp?

Question

J'ai un fichier d'aide pour mon programme et il m'a été demandé d'ajouter une description des menus dans une barre d'outils au fur et à mesure que l'utilisateur les parcourait. J'ai donc pensé pouvoir utiliser le début de la description de l'aide dans le menu, mais je ne trouve pas comment accéder au contenu de celle-ci.

J’ai vu que WinHelp avait un langage macro, alors j’ai peut-être pensé à cela, mais je n’ai trouvé aucune référence à ce sujet.

Quelqu'un a-t-il maintenant des indications ou des exemples à suivre pour le faire?

Answer 1

l'utilitaire winhelpcgi contient un code de bibliothèque capable de lire les fichiers .hlp. La source est ici: lien

Je ne l'ai pas utilisé, je ne peux donc pas en garantir l'utilisation.

Answer 2

Tout d’abord, votre système d’aide devrait avoir un index sur chaque sujet qui vous permette d’ouvrir l’aide et d’afficher ce sujet (sinon, consultez Aide & Manuel - cela vous aidera à créer des fichiers d’aide plus complets). Cependant, cela ne résout pas directement votre problème car, si j'ai bien compris, vous souhaitez que cela apparaisse dans une fenêtre d'aide.

Ainsi, vous devrez vous rendre sous la surface et comprendre comment le système d’aide utilise la clé pour extraire les informations appropriées. Cependant, ce n'est pas une mince affaire (à ma connaissance) d'accéder directement à un bloc de texte indexé spécifique dans un fichier WinHelp. Vous pouvez trouver des informations ici . Vous pouvez également vouloir parcourir les forums sur le site Web Aide et Manuel.

Cependant, voici une question plus importante: est-il vraiment judicieux d’afficher toute une rubrique d’aide (même courte) lorsqu'un utilisateur survole un élément de menu ou un bouton? Ce n'est pas le cas pour moi et j'ai passé des années dans un groupe de conception d'interface utilisateur chez Bell Labs. C’est simplement A trop d’informations et B) une source de distraction visuelle (et donc extrêmement irritante) pour les utilisateurs expérimentés. La pratique acceptée ici est de faire apparaître une fenêtre d’aide contenant un descripteur très court (1 à 4 mots) du bouton ("Ouvrir" ou "Ouvrir un fichier").

Si vous souhaitez que l'aide soit disponible pour chaque élément de menu ou bouton, je vous suggère l'une des deux alternatives.

D'abord, envisagez de définir un " mode Curseur d'aide ". où le curseur utilise l'icône d'aide (une flèche avec un point d'interrogation). L'utilisateur y accède via un bouton Aide sur la barre de boutons. En mode Curseur d’aide, un utilisateur qui clique sur n’importe quel élément l’affiche dans la rubrique d’aide correspondante. Je suis un peu tiède à l'égard de cette approche, car elle est modale, mais je l'ai certainement déjà vue.

Deuxièmement, vous pourriez simplement renforcer un peu votre système d’aide. En d’autres termes, créez une rubrique dans votre système d’aide comportant une capture d’écran de votre application. Sur cette capture d'écran, créez des points chauds pour chaque élément de menu et / ou bouton et laissez l'utilisateur accéder au sujet approprié en cliquant dessus. Si vous le faites bien, cela donne à l’utilisateur une clé visuelle des sujets qu’il souhaite approfondir sans interférer avec le fonctionnement normal de votre programme.

Plus important encore: avant de faire tout le travail nécessaire à la mise en œuvre de votre plan actuel, assurez-vous que c'est le bon plan!