Partager via

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

  • Article

Dans cette étape, vous ajoutez un contrôle à votre projet, générez-le et testez-le 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 la structure d’arborescences à gauche.

  3. Cliquez sur le dossier ATL .

  4. Dans la liste des modèles à droite, sélectionnez CONTRÔLE ATL. Cliquez sur Ajouter. L’Assistant Contrôle ATL s’ouvre et vous pouvez configurer le contrôle.

  5. Tapez PolyCtl le nom court et notez que les autres champs sont automatiquement terminés. Ne cliquez pas encore sur Terminer , car vous devez apporter d’autres modifications.

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

Champ Contenu
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 enrichies et des points de connexion

  1. Cliquez sur Options pour ouvrir la page Options.

  2. Sélectionnez la zone case activée points d’Connecter. Cette option crée la prise en charge d’une interface sortante dans le fichier IDL.

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

Pour étendre la fonctionnalité du contrôle

  1. Cliquez sur Interfaces pour ouvrir la page Interfaces .

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

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

Vous pouvez également rendre le contrôle insèreable, ce qui signifie qu’il est incorporé dans des applications qui prennent en charge des objets incorporés, tels qu’Excel ou Word.

Pour rendre le contrôle insétable

  1. Cliquez sur Apparence pour ouvrir la page Apparence .

  2. Sélectionnez la zone de case activée insère.

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

Pour ajouter une propriété de stock Fill Color et créer le contrôle

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

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

  3. Cliquez sur Terminer.

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

Fichier Description
PolyCtl.h Contient la plupart de l’implémentation de la classe CPolyCtlC++.
PolyCtl.cpp Contient les parties restantes de CPolyCtl.
PolyCtl.rgs Fichier texte qui contient le script de Registre utilisé pour inscrire le contrôle.
PolyCtl.htm Page Web contenant une référence au contrôle nouvellement créé.

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

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

  • Modifie Polygon.idl pour inclure les détails du nouveau contrôle.

  • Ajoute le nouveau contrôle à la carte d’objets dans Polygon.cpp.

Vous pouvez maintenant 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 Build Polygon.

    Une fois le contrôle terminé, cliquez avec le bouton droit sur PolyCtl.htm dans Explorateur de solutions et sélectionnez Affichage 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.

Remarque

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.

Remarque

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ôle ActiveX et générez à nouveau la solution. Si vous ne pouvez toujours pas créer la DLL, redémarrez l’ordinateur ou déconnectez-vous si vous utilisez Terminal Services.

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

Retour à l’étape 1 | à l’étape 3

Voir aussi

Didacticiel