Comment : fournir de l'aide dans une application Windows

Vous pouvez utiliser le composant HelpProvider pour joindre des rubriques d'aide d'un fichier d'aide à des contrôles spécifiques sur les Windows Forms. Le fichier d'aide peut être de type HTML ou HTMLHelp 1.x ou d'un format supérieur.

Notes

Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Utilisation des paramètres.

Pour associer l'aide aux contrôles

1. À partir de la Boîte à outils, faites glisser un composant HelpProvider vers votre formulaire.

   Le composant résidera dans la barre d'état située au bas de la fenêtre Concepteur Windows Forms.

2. Dans la fenêtre Propriétés, attribuez à la propriété HelpNamespace la valeur du fichier d'aide .chm, .col ou .htm.

3. Sélectionnez un autre contrôle figurant dans votre formulaire, et dans la fenêtre Propriétés, définissez la propriété HelpKeyword.

   Il s'agit de la chaîne passée via le composant HelpProvider à votre fichier d'aide pour appeler la rubrique d'aide appropriée.

4. Dans la fenêtre Propriétés, attribuez à la propriété HelpNavigator la valeur de l'énumération HelpNavigator.

   Cette valeur détermine la façon dont la propriété HelpKeyword est passée au système d'aide. Le tableau suivant affiche les paramètres possibles et leurs descriptions.

   Nom du membre	Description
   AssociateIndex	Indique que l'index d'une rubrique spécifiée est exécuté dans l'URL spécifiée.
   Find	Indique que la page de recherche d'une URL spécifiée est affichée.
   Index	Indique que l'index d'une URL spécifiée est affiché.
   KeywordIndex	Spécifie un mot clé à rechercher et l'action à effectuer dans l'URL spécifiée.
   TableOfContents	Indique que le sommaire du fichier d'aide HTML 1.0 est affiché.
   Rubrique	Indique que la rubrique à laquelle l'URL spécifiée fait référence est affichée.

Au moment de l'exécution, le fait d'appuyer sur F1 lorsque le contrôle (dont vous avez défini les propriétés HelpKeyword et HelpNavigator ) a le focus ouvre le fichier d'aide associé à ce composant HelpProvider.

Actuellement, la propriété HelpNamespace prend en charge des fichiers d'aide aux formats suivants : HTMLHelp 1.x, HTMLHelp 2.0 et HTML. Par conséquent, vous pouvez attribuer à la propriété HelpNamespace une adresse http://, telle qu'une page Web. Le cas échéant, elle ouvrira le navigateur par défaut à la page Web avec la chaîne spécifiée dans la propriété HelpKeyword utilisée comme ancre. L'ancre est utilisée pour accéder à une partie spécifique d'une page HTML.

Note de sécurité

Prenez soin de vérifier toute information envoyée par un client avant de l'utiliser dans votre application. Des utilisateurs malveillants peuvent tenter d'envoyer ou d'injecter un script, des instructions SQL ou d'autres types de code exécutables. Avant d'afficher une entrée d'utilisateur, stockez-la dans une base de données ou vérifiez-la afin de vous assurer qu'elle ne comporte pas d'information potentiellement nuisible. Vous pouvez par exemple utiliser une expression régulière pour rechercher des mots clés, tels que « SCRIPT », lorsque vous recevez une entrée d'utilisateur.

Vous pouvez également utiliser le composant HelpProvider pour afficher une aide contextuelle, même si vous l'avez configuré pour afficher des fichiers d'aide relatifs aux contrôles de vos Windows Forms. Pour plus d'informations, consultez Comment : afficher l'aide contextuelle.

Voir aussi

Tâches

Comment : afficher l'aide contextuelle

Concepts

Affichage sous forme d'info-bulles de l'aide relative aux contrôles

Autres ressources

Intégration de l'aide d'utilisateur dans les Windows Forms

Windows Forms