[C#] lancer fichier .chm

Version imprimable

07/10/2006, 02h06
damned3

[C#] lancer fichier .chm

bonjour

J'ai un fichier d'aide html compilé (.chm) que j'aimerais lancer quand je clique sur le menu Aide dans mon prog principal. Seulement, je n'arrive pas à le lancer car je ne sais pas où le mettre - dans le dossier Resources/ mais apres le manager de ressources ne le gère pas, il l'interprète comme un tableau de bytes. J'ai essayé de le mettre directement dans le projet au même niveau que les fichiers de code source. Là encore, je ne sais pas comment aller le chercher (quel est le chemin). Car je veux un chemin relatif au répertoire de l'installation ou quelque chose du genre de Open(Properties.Resources.help.chm). Quelqu'un pourrait-il me dire où placer mon fichier .chm, comment aller le chercher pour l'exécuter, et, s'il le faut, comment l'inclure dans le setup pour qu'il soit distribué.

merci d'avance à toute personne qui répondra à cette longue question.
07/10/2006, 12h36
Thomas Lebrun

Place le dans le répertoire avec ton exécutable et après, tu le lances avec un Process.Start("monfichier.chm");

A+
08/10/2006, 12h39
jyl2002

Ou encore...

Tu peux inclure ton fichier CHM à la racine de ton application dans le projet de déploiement. Puis tu peux l'ouvrir en utilisant la classe Help avec le chemin relatif du fichier.

En effet, il y a un objet spécifique en .NET pour afficher un fichier d'aide d'une façon donnée :

Pour afficher le contenu :

Code:

Help.ShowHelp(this, GetHelpFile(), HelpNavigator.TableOfContents);

(ici this est une winform)

Pour afficher l'index :

Code:

Help.ShowHelpIndex(this, GetHelpFile());

Pour une recherche sur un mot clé:

Code:

Help.ShowHelp(this, GetHelpFile(), HelpNavigator.Find, "motCle");

Dons mon cas, GetHelpFile() renvoie le chemin relatif (ou absolu) du fichier d'aide, par exemple "fichierAide.chm".
Cf. doc sur classe Help.
@ +
10/10/2006, 03h18
damned3

merci je suis sûr que je suis sur la bonne voie:D Mais j'ai encore un problème : quand tu dit de mettre mon fichier chm à la racine de mon projet de déploiement, je suis pas sûr c'est où. Pour l'instant, mon fichier chm est dans MonProg\help.chm

et mon exécutable est dans
MonProg\bin\Debug\prog.exe

alors, lorsque j'ai un chemin relatif, il commence à mon exe et donc je ne sais pas comment reculer jusqu'à mon fichier d'aide. De toute façon, dans mon projet de déploiement, tout est sur un étage de telle sorte que le chemin relatif de l'exe - 9 caractères (pour reculer assez loin, vous n'avez qu'à compter) ne marche plus pour trouver mon fichier d'aide. Cette technique fonctionne pour le débuggage, mais pas une fois le projet compilé et déployé sur une autre machine. Je chercherais donc un moyen d'avoir un chemin sûr dans les 2 cas. En tout cas, je vais essayer de mettre mon .chm dans le même répertoire que mon exe et je vous rapporterai le résultat. Entre-temps, si quelqu'un connaîtrait une autre façon de s'y prendre, qu'il me le fasse savoir svp.
10/10/2006, 03h25
damned3

ok j'ai réussi de cette façon seulement j'ai deux autres questions :

1. Assez facile sûrement, je voudrais que la fenêtre de l'aide apparaisse maximisée et non toute petite comme elle est;

2. Toute ma table des matières est là, mais lorsque je clique sur une page de celle-ci, elle ne s'affiche pas à côté comme elle est supposée. Est-ce que je dois gérer manuellement les click sur chaque item de la table des matières afin de montrer la page correspondante ? Sûrement pas...
10/10/2006, 08h28
toniolol

Citation:

Envoyé par jyl2002

Pour une recherche sur un mot clé:

Code:

Help.ShowHelp(this, GetHelpFile(), HelpNavigator.Find, "motCle");

Salut,
une petite question sur ce code, d'où provient le string "motCle" ?
Est-il possible de lacer l'aide (via F1) et de "tomber" à un endroit particulier de cette dernière en fonction du contrôle où l'on se trouve ?
10/10/2006, 10h19
jyl2002

Citation:

Envoyé par toniolol

Salut,
une petite question sur ce code, d'où provient le string "motCle" ?
Est-il possible de lacer l'aide (via F1) et de "tomber" à un endroit particulier de cette dernière en fonction du contrôle où l'on se trouve ?

Bien sûr !
Pour ça il faut utiliser l'objet "HellpProvider", par exemple via drag and drop de la toolbox VS sur ta form.
Extrait de MSDN :

Citation:

The Windows Forms HelpProvider component is used to associate an HTML Help 1.x Help file (either a .chm file, produced with the HTML Help Workshop, or an .htm file) with your Windows application. You can provide help in a variety of ways:

- Provide context-sensitive Help for controls on Windows Forms.
- Provide context-sensitive Help on a particular dialog box or specific controls on a dialog box.
- Open a Help file to specific areas, such as the main page of a Table of Contents, the Index, or a search function.

Je te laisse jeter un oeil sur MSDN pour voir comment l'utiliser ;) .
@ +
10/10/2006, 10h22
jyl2002

Citation:

Envoyé par damned3

ok j'ai réussi de cette façon seulement j'ai deux autres questions :

1. Assez facile sûrement, je voudrais que la fenêtre de l'aide apparaisse maximisée et non toute petite comme elle est;

2. Toute ma table des matières est là, mais lorsque je clique sur une page de celle-ci, elle ne s'affiche pas à côté comme elle est supposée. Est-ce que je dois gérer manuellement les click sur chaque item de la table des matières afin de montrer la page correspondante ? Sûrement pas...

Là j'ai pas d'idée. Mais à mon avis, le point 2 vient plutôt d'un problème dans le chm... Et je ne sais pas quel outil tu as utilisé pour le faire...
10/10/2006, 16h51
damned3

j'utilise html help workshop et mon aide marche très bien quand je teste le fichier tout seul. Donc, le problème vient de VS.
10/10/2006, 17h56
serge-07

Si le nom de ton fichier .chm contient le caractere # , comme dans
' C# ' par exemple, tu devrais supprimer ce caractere pour voir...
11/10/2006, 01h17
damned3

mon fichier d'aide se nomme simplement help.chm et tout est bien il fonctionne correctement en dehors de VS. Quelqu'un aurait-il une idée d'où pourrait venir ce problème ?
11/10/2006, 09h44
jyl2002

J'ai jamais eu ce problm... quand tu le testes en dehors de VS, est-ce qu'il marche toujours si tu le déplaces dans un tout autre répertoire que celui de ton test initial ?
Je pense par exemple à un linkage relatif vers un fichier extérieur... mais ça me parait peu probable.

:arf:
Pas d'autre idée, dsl.
11/10/2006, 20h50
damned3

je suis sûr que le problème vient du fait que

Code:

Help.ShowHelp(this, "help.chm", HelpNavigator.TableOfContents);

montre la table des matières uniquement à cause de HelpNavigator. Il faudrait sûrement changer cette valeur. J'ai essayé, mais aucune ne semble correspondre à " All" pour montrer toute l'aide.