Partager via

Assistant Objet simple ATL

  • Article

Mise à jour : novembre 2007

Cet Assistant insère un objet COM minimal dans le projet. Utilisez cette page de l'Assistant pour spécifier les noms qui identifient les fichiers et la classe C++ pour votre objet, ainsi que ses fonctionnalités COM.

Utilisez la page Options de cet Assistant pour spécifier le modèle de thread de l'objet, sa prise en charge de l'agrégation et la prise en charge des interfaces doubles et de l'automation. Vous pouvez également indiquer la prise en charge de l'interface d'informations sur les erreurs, des points de connexion, de Microsoft Internet Explorer et du marshaling libre de threads.

Notes

À partir de Visual Studio 2008, le script d'inscription produit par cet Assistant inscrira ses composants COM sous HKEY_CURRENT_USER au lieu de HKEY_LOCAL_MACHINE. Pour modifier ce comportement, définissez l'option Inscrire le composant pour tous les utilisateurs de l'Assistant ATL.

Noms

Spécifiez les noms de l'objet, de l'interface et des classes à ajouter à votre projet. À l'exception de Nom court, toutes les zones peuvent être modifiées indépendamment les unes des autres. Si vous changez le texte figurant dans la zone Nom court, la modification est répercutée au niveau des noms de toutes les autres zones de cette page. Si vous changez le nom figurant dans la zone Coclasse de la section COM, cette modification est répercutée dans les zones Type et ProgID, mais le nom figurant dans la zone Interface demeure inchangé. Ce mode d'affectation des noms est destiné à faciliter l'identification de tous les noms lorsque vous développez votre contrôle.

Remarque :

La coclasse ne peut être modifiée que pour les projets sans attributs. Si votre projet est avec attributs, vous ne pouvez pas modifier la coclasse.

C++

Fournit des informations pour la classe C++ créée pour l'objet.

  • Nom court
    Définit l'abréviation du nom de l'objet. Le nom que vous entrez détermine le nom de différents éléments (Class, Coclasse, fichier .cpp, fichier .h, Interface et Type), ainsi que le ProgID, sauf si vous modifiez ces champs individuellement.

  • fichier .h
    Définit le nom du fichier d'en-tête de la nouvelle classe d'objets. Par défaut, ce nom dépend du nom que vous entrez dans la zone Nom court. Cliquez sur le bouton de sélection pour enregistrer le nom de fichier à l'emplacement de votre choix ou pour ajouter la déclaration de classe à un fichier existant. Si vous sélectionnez un fichier existant, l'Assistant ne l'enregistrera pas à l'emplacement choisi tant que vous n'aurez pas cliqué sur Terminer dans l'Assistant.

    L'Assistant n'écrase pas un fichier. Si vous sélectionnez le nom d'un fichier existant et cliquez sur Terminer, l'Assistant vous demande d'indiquer si la déclaration de classe doit être ajoutée au contenu du fichier. Cliquez sur Oui pour ajouter le fichier ; cliquez sur Non pour revenir à l'Assistant et spécifier un autre nom de fichier.

  • Classe
    Définit le nom de la classe que vous souhaitez créer. Ce nom dépend du nom que vous entrez dans la zone Nom court, précédé de « C » (préfixe classique pour un nom de classe).

  • fichier .cpp
    Définit le nom du fichier d'implémentation pour la nouvelle classe d'objet. Par défaut, ce nom dépend du nom que vous entrez dans la zone Nom court. Cliquez sur le bouton de sélection pour enregistrer le nom de fichier à l'emplacement de votre choix. Le fichier n'est pas enregistré à l'emplacement souhaité tant que vous n'avez pas cliqué sur Terminer dans l'Assistant.

    L'Assistant n'écrase pas un fichier. Si vous sélectionnez le nom d'un fichier existant et cliquez sur Terminer, l'Assistant vous invite à indiquer si l'implémentation de classe doit être ajoutée au contenu du fichier. Cliquez sur Oui pour ajouter le fichier ; cliquez sur Non pour revenir à l'Assistant et spécifier un autre nom de fichier.

  • Avec attributs
    Indique si l'objet utilise des attributs. Si vous ajoutez un objet à un projet ATL avec attributs, cette option est sélectionnée et ne peut pas être modifiée. Cela signifie que vous ne pouvez ajouter des objets avec attributs qu'à un projet créé avec la prise en charge des attributs.

    Vous ne pouvez ajouter un objet avec attributs qu'à un projet ATL utilisant des attributs. Si vous sélectionnez cette option pour un projet ATL ne prenant pas en charge les attributs, l'Assistant vous invite à spécifier si vous souhaitez ajouter la prise en charge des attributs à ce projet.

    Les objets que vous ajoutez après avoir défini cette option sont désignés par défaut comme étant avec attributs (la case à cocher correspondante est activée). Vous pouvez désactiver cette case à cocher pour ajouter un objet qui n'utilise pas d'attributs.

    Pour plus d'informations, consultez Paramètres de l'application, Assistant Projet ATL et Mécanismes de base des attributs.

COM

Fournit des informations sur la fonctionnalité COM de l'objet.

  • CoClasse
    Définit le nom de la classe de composant contenant une liste des interfaces prises en charge par l'objet.

    Remarque :

    Si vous créez votre projet à l'aide d'attributs ou si vous indiquez sur cette page de l'Assistant que l'objet utilise des attributs, vous ne pouvez alors pas modifier cette option, car ATL ne contient pas l'attribut coclass.

  • Type
    Définit la description de l'objet qui s'affiche dans le Registre.

  • Interface
    Définit l'interface que vous créez pour votre objet. Cette interface contient vos méthodes personnalisées.

  • ProgID
    Définit le nom que les conteneurs peuvent utiliser à la place de l'identificateur CLSID de l'objet.

Voir aussi

Tâches

Ajout d'un objet simple ATL