Partager via

Ajout d'un contrôle (Didacticiel ATL, Partie 2)

Dans cette étape, vous ajoutez un contrôle à votre projet, vous le générez et le testez sur une page Web.

Procédures

Pour ajouter un objet à un projet ATL

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet Polygon.

  2. Pointez sur Ajouter dans le menu contextuel, puis cliquez sur Nouvel élément dans le sous-menu.

    La boîte de dialogue Ajouter un nouvel élément s'affiche. Les différentes catégories d’objets sont répertoriées dans l’arborescence à gauche.

  3. Cliquez sur le dossier ATL.

  4. Dans la liste des modèles à droite, sélectionnez Contrôle ATL. Cliquez sur Add. L’Assistant Contrôle ATL s’ouvre pour vous permettre de configurer le contrôle.

  5. Tapez PolyCtl comme nom court. Notez que les autres champs sont automatiquement remplis. Ne cliquez pas encore sur Terminer, car vous devez encore apporter quelques modifications.

La page Noms de l’Assistant Contrôle ATL contient les champs suivants :

Champ Sommaire
Nom court Nom que vous avez entré pour le contrôle.
Classe Nom de classe C++ créé pour implémenter le contrôle.
Fichier .h Fichier créé pour contenir la définition de la classe C++.
Fichier .cpp Fichier créé pour contenir l’implémentation de la classe C++.
CoClass Nom de la classe de composant pour ce contrôle.
Interface Nom de l’interface sur laquelle le contrôle implémente ses méthodes et propriétés personnalisées.
Type Description du contrôle.
ProgID Nom lisible qui peut être utilisé pour rechercher le CLSID du contrôle.

Vous trouverez plusieurs paramètres supplémentaires à modifier dans l’Assistant Contrôle ATL.

Pour activer la prise en charge des informations d’erreur complètes et des points de connexion

  1. Cliquez sur Options pour ouvrir la page Options.

  2. Activez la case à cocher Points de connexion. Cette option permet de prendre en charge une interface sortante dans le fichier IDL.

Vous pouvez également ajouter des interfaces pour étendre les fonctionnalités du contrôle.

Pour étendre les fonctionnalités du contrôle

  1. Cliquez sur Interfaces pour ouvrir la page Interfaces.

  2. Sélectionnez IProvideClassInfo2 et cliquez sur la flèche haut pour déplacer cet élément vers la liste Pris en charge.

  3. Sélectionnez ISpecifyPropertyPages et cliquez sur la flèche haut pour déplacer cet élément vers la liste Pris en charge.

Vous pouvez également rendre le contrôle insérable, ce qui signifie qu’il peut être incorporé dans des applications qui prennent en charge les objets incorporés, comme Excel ou Word.

Pour rendre le contrôle insérable

  1. Cliquez sur Apparence pour ouvrir la page Apparence.

  2. Activez la case à cocher Insérable.

Le polygone affiché par l’objet aura une couleur de remplissage unie. Vous devez donc ajouter une propriété stock Fill Color.

Pour ajouter une propriété stock Couleur de remplissage et créer le contrôle

  1. Cliquez sur Propriétés stock pour ouvrir la page Propriétés stock.

  2. Sous Non pris en charge, faites défiler la liste des propriétés stock possibles. Sélectionnez Fill Color et cliquez sur la flèche haut pour déplacer cet élément vers la liste Pris en charge.

  3. Cliquez sur Terminer.

À mesure que l’Assistant crée le contrôle, plusieurs modifications de code et ajouts de fichiers sont effectués. Les fichiers suivants sont créés :

Fichier Descriptif
PolyCtl.h Contient la majeure partie de l’implémentation de la classe C++ CPolyCtl.
PolyCtl.cpp Contient les autres parties de CPolyCtl.
PolyCtl.rgs Fichier texte contenant le script de registre utilisé pour enregistrer le contrôle.
PolyCtl.htm Page Web contenant une référence au contrôle nouvellement créé.

L’Assistant apporte également les modifications suivantes au code :

  • Ajout d’une instruction #include aux fichiers d’en-tête précompilés afin d’inclure les fichiers ATL nécessaires à la prise en charge des contrôles.

  • Modification de Polygon.idl afin d’y inclure les détails du nouveau contrôle.

  • Ajout du nouveau contrôle au mappage d’objets dans Polygon.cpp.

Vous pouvez à présent générer le contrôle pour le voir en action.

Création et test du contrôle

Pour générer et tester le contrôle

  1. Dans le menu Générer, cliquez sur Générer le polygone.

    Une fois le contrôle terminé, cliquez avec le bouton droit sur PolyCtl.htm dans l’Explorateur de solutions, puis sélectionnez Afficher dans le navigateur. La page Web HTML contenant le contrôle s’affiche. Vous devez voir une page avec le titre « Page de test ATL 8.0 pour l’objet PolyCtl » et votre contrôle, le texte PolyCtl.

Note

Si le contrôle n’est pas visible, sachez que certains navigateurs nécessitent des ajustements de paramètres pour exécuter des contrôles ActiveX. Reportez-vous à la documentation du navigateur sur l’activation des contrôles ActiveX.

Note

Lorsque vous avez terminé ce didacticiel, si vous recevez un message d’erreur indiquant que le fichier DLL ne peut pas être créé, fermez le fichier PolyCtl.htm et le conteneur de test de contrôles ActiveX, et générez à nouveau la solution. Si vous ne parvenez toujours pas à créer la DLL, redémarrez l’ordinateur ou déconnectez-vous si vous utilisez les services Terminal Server.

Ensuite, vous allez ajouter une propriété personnalisée au contrôle.

Revenir à l’étape 1 | Passer à l’étape 3

Voir aussi

Didacticiel

  • Last updated on