TESTHELP, exemple : contrôle ActiveX contenant des info-bulles et de l'aide
Mise à jour : novembre 2007
L'exemple TESTHELP montre comment utiliser MFC pour générer un contrôle ActiveX possédant son propre fichier d'aide destiné à être affiché à l'utilisateur. Testhelp.ocx montre également comment ajouter des info-bulles à un contrôle ActiveX MFC.
.gif "Note de sécurité") Note de sécurité : |
|---|
Cet exemple de code est fourni pour illustrer un concept et ne doit pas être utilisé dans des applications ou des sites Web, car il peut ne pas illustrer les pratiques de programmation les plus sûres. Microsoft n'assume aucune responsabilité pour tout dommage indirect ou consécutif en cas d'utilisation de l'exemple de code à des fins autres que celles prévues. |
Pour obtenir des exemples et des instructions d'installation :
Dans le menu ? (Aide) de Visual Studio, cliquez sur Exemples.
Pour plus d'informations, consultez Recherche des fichiers d'exemple.
La liste la plus récente et la plus complète d'exemples est disponible en ligne à partir de la page Visual Studio 2008 Samples.
Des exemples sont également disponibles sur le disque dur de votre ordinateur. Des exemples et un fichier Readme sont copiés par défaut dans un dossier sous \Program Files\Visual Studio 9.0\Samples\. Pour les éditions Express de Visual Studio, tous les exemples sont accessibles en ligne.
Génération et exécution de l'exemple
Pour générer et exécuter l'exemple TESTHELP
Ouvrez la solution Testhelp.sln.
Dans le menu Générer, cliquez sur Générer.
Après avoir généré l'exemple TESTHELP, vous pouvez l'utiliser dans n'importe quelle application conteneur ActiveX. Pour plus d'informations sur la manière d'accéder à Test Container, consultez Test des propriétés et des événements à l'aide de Test Container. Ajoutez le contrôle TESTHELP au projet de votre conteneur, puis exécutez le projet. Vous pouvez définir les propriétés du contrôle TESTHELP en ouvrant la boîte de dialogue des propriétés de votre conteneur.
Le fichier projet de l'aide et tous les fichiers projet sources de l'aide sont également inclus dans cet exemple.
Pour régénérer et exécuter le fichier d'aide TESTHELP
Dans le menu Démarrer, cliquez sur Help Workshop.
Ouvrez Testhelp.hpj. Help Workshop affiche un Assistant permettant de convertir ce fichier en fichier .hhp. Exécutez l'Assistant, nommez le fichier et acceptez les modifications.
Dans le menu File, cliquez sur Compile. Dans la boîte de dialogue Create a compiled file, indiquez l'emplacement de stockage du fichier compilé, puis cliquez sur Compile.
Pour afficher le fichier compilé, cliquez dans le menu View sur Compiled Help File.
Fonctionnalités de TESTHELP
TESTHELP montre comment effectuer les tâches suivantes :
afficher une info-bulle pour votre contrôle ActiveX ;
activer et désactiver l'info-bulle à l'aide de la page de propriétés du contrôle ;
modifier le texte de l'info-bulle à l'aide de la page de propriétés du contrôle ;
activer le bouton Aide du frame de propriété du conteneur de contrôles ActiveX pour afficher le fichier d'aide du contrôle lorsqu'un utilisateur clique sur ce bouton Aide ;
activer le bouton "?" dans le Component and Controls Gallery de Visual C++de telle sorte que le fichier d'aide approprié s'affiche lorsqu'un utilisateur sélectionne le contrôle Gallery et qu'il clique sur le bouton "?" ;
afficher l'aide au moment de l'exécution lorsque le contrôle possède le focus clavier et que la touche F1 est enfoncée ;
utiliser les propriétés stock Font, BackColor et ForeColor d'un contrôle ActiveX.
Général, page de propriétés
Type of Help to Use
Cette propriété détermine le mode d'utilisation de l'aide lorsque l'utilisateur appuie sur la touche F1 pendant que le contrôle TESTHELP détient le focus clavier. L'aide dans une fenêtre indépendante signifie que lorsque l'utilisateur appuie sur F1 pendant que le contrôle TESTHELP s'exécute dans un conteneur et qu'il détient le focus clavier, une fenêtre indépendante affiche la rubrique "What is this thing?" à partir du fichier d'aide Testhelp.hlp. "Show the Whole Help File" signifie que lorsque l'utilisateur appuie sur F1 pendant que le contrôle TESTHELP s'exécute dans un conteneur et qu'il détient le focus clavier, le programme d'aide tout entier de Windows s'affiche avec les rubriques du fichier Testhelp.hlp.Use Control's Help File
Lorsque cette case à cocher est activée, l'aide est affichée dans le format déterminé par la propriété Type of Help to Use lorsque l'utilisateur appuie sur F1 pendant que le contrôle s'exécute dans un conteneur et qu'il détient le focus clavier.Use ToolTip for this Control
Si cette case à cocher est activée, une info-bulle s'affiche sur la fenêtre du contrôle lorsque celui-ci s'exécute dans le conteneur et que le curseur de la souris se déplace et s'arrête dans la fenêtre du contrôle. Le texte affiché est déterminé par la propriété Tooltip Caption.Tooltip Caption
Il s'agit du texte affiché dans une info-bulle lorsque l'utilisateur choisit d'afficher les info-bulles.Name1 Nom affiché en haut du contrôle.
Name2 Nom affiché au milieu du contrôle.
Name3 Nom affiché en bas du contrôle.
Page de propriétés de couleur
Permet à l'utilisateur de sélectionner les couleurs utilisées pour peindre ce contrôle.
Page de propriétés de police
Permet à l'utilisateur de spécifier la police du texte du contrôle.
.gif "Remarque") Remarque : |
|---|
Certains exemples, tels que celui-ci, n'ont pas été modifiés pour refléter les changements apportés aux Assistants, aux bibliothèques et au compilateur Visual C++, mais ils illustrent bien l'exécution de la tâche souhaitée. |
Mots clés
L'exemple TESTHELP illustre l'utilisation des classes et des mots clés suivants :
CToolTipCtrl; COleControl::OnDraw; COleControl::OnResetState; COlePropertyPage::OnHelp
| Remarque : |
|---|
Certains exemples, tels que celui-ci, n'ont pas été modifiés pour refléter les changements apportés aux Assistants, aux bibliothèques et au compilateur Visual C++, mais ils illustrent bien l'exécution de la tâche souhaitée. |