Étape 2 : ajouter un contrôle
Dans cette étape, vous ajouterez un contrôle à votre projet, l'générerez, et le tester dans une page Web.
Procédures
Pour ajouter un objet à un projet ATL
Dans l'Affichage de classes, cliquez avec le bouton droit sur le projet polygon.
Point à Ajouter dans le menu contextuel, puis cliquez sur ajoutez la classe dans le sous-menu.
La boîte de dialogue Ajouter une classe s'affiche.Les différentes catégories d'objet sont répertoriées dans l'arborescence à gauche.
Cliquez sur le dossier ATL .
Dans la liste de modèles à droite, Contrôle ATLsélectionnez.Cliquez sur Ajouter.L'Assistant Contrôle ATL s'ouvre, et vous pouvez configurer le contrôle.
Tapez PolyCtl comme nom court et notez que les autres champs sont automatiquement terminés.Ne cliquez pas sur Terminé encore, parce que vous devez apporter des modifications.
La page Noms de l'assistant de contrôle ATL contient les champs suivants :
Champ |
Sommaire |
|---|---|
Nom court |
Le nom que vous avez spécifié pour le contrôle. |
Classe |
Le nom de classe C++ créé pour implémenter le contrôle. |
fichier .h |
Le fichier créé pour contenir la définition de la classe C++. |
fichier .cpp |
Le fichier créé pour contenir l'implémentation de la classe C++. |
Coclasse |
Le nom de la classe de composant pour ce contrôle. |
Interface |
Le nom de l'interface dans laquelle le contrôle implémentera ses méthodes et propriétés personnalisées. |
Type |
Une description pour le contrôle. |
ProgID |
Le nom lisible qui peut être utilisé pour rechercher le CLSID du contrôle. |
Vous devez effectuer plusieurs paramètres supplémentaires dans l'Assistant Contrôle ATL.
Pour activer la prise en charge des informations sur l'erreur et les points de connexion riches
Cliquez sur Options pour ouvrir la page Options .
Activez la case à cocher Points de connexion .Cela créera la prise en charge d'une interface sortante dans le fichier IDL.
Vous pouvez également effectuer l'insérable de contrôle, que les moyens qui peuvent être incorporés dans les applications qui prennent en charge les objets incorporés, tels qu'Excel ou Word.
Pour rendre le contrôle insérable
Cliquez sur Apparence pour ouvrir la page Apparence .
Activez la case à cocher Insertable , qui sera désactivée par défaut.
Le polygone affiché par l'objet possède une couleur de remplissage solide ; vous devez donc ajouter une propriété d'actions d' Fill Color .
Pour ajouter une couleur de remplissage stockez la propriété et créer le contrôle
Cliquez sur Stockez des propriétés pour ouvrir la page Stockez des propriétés .
Sous Non pris en charge, faites défiler la liste de propriétés stock possibles.Double-cliquez sur Fill Color pour le déplacer dans la liste Pris en charge .
Cela termine les options pour le contrôle.Cliquez sur Terminer.
Comme l'assistant a créé le contrôle, plusieurs modifications du code et ajouts de fichier se sont produits.Les fichiers suivants ont été créés :
Fichier |
Description |
|---|---|
PolyCtl.h |
Contient la majeure partie de l'implémentation de la classe CPolyCtlC++. |
PolyCtl.cpp |
Contient les parties restantes d' CPolyCtl. |
PolyCtl.rgs |
Un fichier texte qui contient le script de Registre utilisé pour stocker le contrôle. |
PolyCtl.htm |
Une page Web contenant une référence au contrôle que vous venez de créer. |
l'assistant a également exécuté les modifications du code suivantes :
Ajout d'une instruction d' #include à stdafx.h et stdafx.cpp classe pour inclure les fichiers ATL nécessaires pour les contrôles de prise en charge.
Polygon.idl modifié pour inclure des détails du nouveau contrôle.
Ajout du nouveau contrôle à la table d'objets dans Polygon.cpp.
Vous pouvez maintenant générer le contrôle pour le voir dans l'action.
Génération et test du contrôle
Pour générer et tester le contrôle
Dans le menu Générer , cliquez sur polygone de génération.
Une fois le contrôle finit de générer, l'explorateur PolyCtl.htm de bouton droit sur la solution et Afficher dans le navigateursélectionnez.La page Web HTML contenant le contrôle s'affiche.Vous devez voir la page avec le titre « page de test ATL 8,0 pour l'objet PolyCtl » et le texte PolyCtl.Il s'agit de votre contrôle.
[!REMARQUE]
En effectuant ce didacticiel, si vous recevez un message d'erreur dans lequel le fichier DLL ne peut pas être créé, fermez le fichier PolyCtl.htm et l'ActiveX Control Test Container et générez la solution.Si vous ne pouvez pas créer la DLL, redémarrez l'ordinateur ou la fermeture de session (si vous utilisez des services Terminal Server).
Ensuite, vous ajouterez une propriété personnalisée au contrôle.
Pour revenir à l'étape 1 | Sur à l'étape 3