Partager via


Référence alphabétique de macros ATL

Dans cette section, des rubriques de référence pour les macros ATL sont organisées par ordre alphabétique. Pour rechercher une macro particulière par catégorie, consultez Macros ATL.

Macro

Description

_ATL_ALL_WARNINGS

Un symbole qui permet aux erreurs dans les projets a converti des versions antérieures ATL.

_ATL_APARTMENT_THREADED

Définissez si un ou plusieurs de vos objets utilisent le thread cloisonné (STA).

_ATL_CSTRING_EXPLICIT_CONSTRUCTORS

Fournit les constructeurs d' CString explicites, empêchant les conversions involontaires.

_ATL_DEBUG_INTERFACES

Définissez cette macro pour inclure tous les fichiers d'en-tête ATL pour suivre tous les AddRef et appel de Release aux interfaces des composants dans la fenêtre Sortie.

_ATL_DEBUG_QI

Écrit tous les appels à QueryInterface dans la fenêtre Sortie.

_ATL_FREE_THREADED

Définissez si un ou plusieurs de votre utilisation d'objets ou libre de threads neutre.

_ATL_MIXED

Indique au compilateur que votre application ATL est composée de code natif et les modules (compilands) d' /clr .

_ATL_MULTI_THREADED

Un symbole qui indique le projet comportera des objets marqués comme les deux, libre ou neutre. Le _ATL_FREE_THREADED doit être utilisé dans le nouveau code.

_ATL_NO_COM_SUPPORT

Un symbole qui empêché le code lié au COM d'être compilé avec votre projet.

_ATL_NO_AUTOMATIC_NAMESPACE

Un symbole qui empêché l'utilisation par défaut de l'espace de noms comme ATL.

_ATL_NO_VARIANT_THROW

Supprime CComVariant, classe de lever des exceptions.

_ATL_SECURE_NO_WARNINGS

Supprime les avertissements du compilateur pour l'utilisation des fonctions déconseillées ATL.

_ATL_STATIC_REGISTRY

Un symbole indiquant vous souhaitez que le code d'inscription pour que votre objet soit dans l'objet pour éviter une dépendance sur ATL.DLL.

_ATLCATCH

Instructions pour gérer les erreurs qui se produisent dans _ATLTRYassocié

_ATLCATCHALL

Instructions pour gérer les erreurs qui se produisent dans _ATLTRYassocié.

_ATLTRY

Marque une section protégée de code où une erreur peut éventuellement se produire.

Balises d'ATL_ESC

Ces indicateurs sont utilisées pour contrôler le comportement d' EscapeXML.

ALT_MSG_MAP

Marque le début d'une table des messages secondaire.

Macros de conversion de chaînes ATL et MFC

Macros de conversion de chaînes valides pour ATL et MFC.

ATLASSERT

La macro d' ATLASSERT exécute les mêmes fonctionnalités que la macro de _ASSERTE recherchée dans la bibliothèque Runtime C.

ATL_NOINLINE

Un symbole qui pointe vers une fonction ne doit pas être inline.

ATL_NO_VTABLE

Un symbole qui empêché le pointeur vtable d'être initialisé dans le constructeur et le destructeur de la classe.

Balises d'ATL_URL

Ces indicateurs modifient le comportement d' AtlEscapeUrl et d' AtlCanonicalizeUrl.

ATL_URL_SCHEME

Les membres de cette énumération fournissent des constantes pour les modèles inclus par Aller-retour.

ATL_WORKER_THREAD_WAIT

Cette macro définit la valeur par défaut en millisecondes que CWorkerThread::Shutdown attendra le thread de travail pour désactiver.

ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT

Cette macro définit le temps par défaut en millisecondes que CThreadPool attend un thread s'arrête.

ATLS_DEFAULT_THREADSPERPROC

Cette macro définit le nombre par défaut de threads par processeur utilisé par CThreadPool.

Balises d'ATLSMTP_QPENCODE

Ces indicateurs indiquent dans quelle mesure l'encodage entre guillemets- imprimable doit être effectué par QPEncode.

Balises d'ATLSMTP_UUENCODE

Ces indicateurs décrivent comment uuencoding doit être effectué par uuencode.

ATLTRACE

Stocke des avertissements à un périphérique de sortie, telles que la fenêtre du débogueur, en fonction de les balises et les niveaux indiqués. Inclus pour la compatibilité descendante.

ATLTRACE2

Stocke des avertissements à un périphérique de sortie, telles que la fenêtre du débogueur, en fonction de les balises et les niveaux indiqués.

ATLTRACENOTIMPL

Dans les versions debug ATL, envoie la chaîne « funcname n'est pas implémenté » à l'unité de vidage et ne retourne pas E_NOTIMPL.

BEGIN_CATEGORY_MAP

Marque le début du mappage de catégorie.

BEGIN_COM_MAP

Le mappage COM est le mécanisme qui expose des interfaces sur un objet à un client via QueryInterface.

BEGIN_CONNECTION_POINT_MAP

Marque le début des entrées de mappage des points de connexion.

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP

Marque le début du mappage de classes de données d'extensions de composants logiciels enfichables.

BEGIN_MSG_MAP

Marque le début de la table des messages par défaut.

BEGIN_PROP_MAP

Marque le début du mappage de propriété de l'objet.

BEGIN_RDX_MAP

Marque le début du mappage d'échange de données de Registre.

BEGIN_SERVICE_MAP

Marque le début du mappage de service.

BEGIN_SINK_MAP

Déclare le début de la table de récepteurs d'événements pour le contrôle composite.

BEGIN_SNAPINTOOLBARID_MAP

Déclare le début du mappage d'ID de barre d'outils pour l'objet enfichable.

CHAIN_MSG_MAP

Définit une entrée dans une table des messages.

CHAIN_MSG_MAP_ALT

Définit une entrée dans une table des messages.

CHAIN_MSG_MAP_ALT_MEMBER

Définit une entrée dans une table des messages.

CHAIN_MSG_MAP_DYNAMIC

Définit une entrée dans une table des messages.

CHAIN_MSG_MAP_MEMBER

Définit une entrée dans une table des messages.

De macros COM_INTERFACE_ENTRY

Ces macros entrez les interfaces d'un objet dans son mappage COM afin qu'elles puissent être accessibles par QueryInterface.

COM_INTERFACE_ENTRY

Écrit des interfaces dans le mappage d'interfaces COM.

COM_INTERFACE_ENTRY2

Utilisez cette macro pour supprimer l'ambiguïté deux branches d'héritage.

COM_INTERFACE_ENTRY2_IID

Mêmes que COM_INTERFACE_ENTRY2, à moins que vous puissiez spécifier un IID différent.

COM_INTERFACE_ENTRY_AGGREGATE

Lorsque l'interface identifiée par iid est interrogé pour, COM_INTERFACE_ENTRY_AGGREGATE transféré à punk.

COM_INTERFACE_ENTRY_AGGREGATE_BLIND

Même que COM_INTERFACE_ENTRY_AGGREGATE, sauf que recherchant tout IID une en effectuant le suivi de la requête à punk.

COM_INTERFACE_ENTRY_AUTOAGGREGATE

Mêmes que COM_INTERFACE_ENTRY_AGGREGATE, sauf si punk est NULL, il crée automatiquement l'agrégat décrit par clsid.

COM_INTERFACE_ENTRY_AUTOAGGREGATE_BLIND

Même que COM_INTERFACE_ENTRY_AUTOAGGREGATE, sauf que recherchant tout IID une en effectuant le suivi de la requête à punk, et si punk est NULL, créant automatiquement l'agrégat décrit par clsid.

COM_INTERFACE_ENTRY_BREAK

Faite pour appeler votre programme DebugBreak lorsque l'interface spécifiée est interrogé pour.

COM_INTERFACE_ENTRY_CACHED_TEAR_OFF

Enregistre les données d'interface spécifique pour chaque instance.

COM_INTERFACE_ENTRY_CHAIN

Traite le mappage COM de la classe de base lorsque le traitement atteint cette entrée dans le mappage COM.

COM_INTERFACE_ENTRY_FUNC

Un mécanisme général pour raccorder dans QueryInterface ATL la logique.

COM_INTERFACE_ENTRY_FUNC_BLIND

Mêmes que COM_INTERFACE_ENTRY_FUNC, sauf que recherchant tous résultats de l'IID dans un appel à func.

COM_INTERFACE_ENTRY_IID

Utilisez cette macro pour écrire l'interface dans le mappage COM et pour spécifier son IID.

COM_INTERFACE_ENTRY_NOINTERFACE

Retourne E_NOINTERFACE et se termine le mappage COM traitement lorsque l'interface spécifiée est interrogé pour.

COM_INTERFACE_ENTRY_TEAR_OFF

Expose les interfaces volantes.

COMMAND_CODE_HANDLER

Semblable à COMMAND_HANDLER, mais mappe un message de WM_COMMAND basé uniquement sur le code de notification.

COMMAND_HANDLER

Définit une entrée dans une table des messages.

COMMAND_ID_HANDLER

Semblable à COMMAND_HANDLER, mais mappe un message de WM_COMMAND basé uniquement sur l'identificateur de l'élément de menu, le contrôle, ou de l'accélérateur.

COMMAND_RANGE_CODE_HANDLER

Semblable à COMMAND_RANGE_HANDLER, mais mappe les messages de WM_COMMAND au code de notification spécifique d'une plage des contrôles à une fonction gestionnaire unique.

COMMAND_RANGE_HANDLER

Semblable à COMMAND_HANDLER, mais mappe les messages de WM_COMMAND d'une plage des contrôles à une fonction gestionnaire unique.

CONNECTION_POINT_ENTRY

Entre dans un point de connexion pour l'interface spécifiée dans la table des points de connexion afin qu'il puisse y accéder.

DECLARE_AGGREGATABLE

Spécifie que votre objet peut être regroupé.

DECLARE_CLASSFACTORY

Déclare CComClassFactory pour être la fabrique de classe.

DECLARE_CLASSFACTORY2

Déclare CComClassFactory2 pour être la fabrique de classe.

DECLARE_CLASSFACTORY_AUTO_THREAD

Déclare CComClassFactoryAutoThread pour être la fabrique de classe.

DECLARE_CLASSFACTORY_EX

Déclare cf pour être la fabrique de classe.

DECLARE_CLASSFACTORY_SINGLETON

Déclare CComClassFactorySingleton pour être la fabrique de classe.

DECLARE_EMPTY_MSG_MAP

Déclare une table des messages vide.

DECLARE_GET_CONTROLLING_UNKNOWN

Déclare une fonction virtuelle GetControllingUnknown.

DECLARE_LIBID

Offre un moyen pour qu'ATL obtenir le libid de la bibliothèque de types.

DECLARE_NO_REGISTRY

Utilisation DECLARE_NO_REGISTRY si vous souhaitez éviter toute inscription par défaut ATL à la classe dans laquelle cette macro apparaît.

DECLARE_NOT_AGGREGATABLE

Spécifie que votre objet ne peut pas être regroupé.

DECLARE_OBJECT_DESCRIPTION

Vous permet de spécifier une description textuelle de votre objet de classe.

DECLARE_OLEMISC_STATUS

Utilisé dans les contrôles ActiveX ATL pour définir les balises d'OLEMISC.

DECLARE_ONLY_AGGREGATABLE

Spécifie que votre objet doit être regroupé.

DECLARE_POLY_AGGREGATABLE

Spécifie qu'une instance de CComPolyObject < X > est créée lorsque l'objet est créé.

DECLARE_PROTECT_FINAL_CONSTRUCT

Protège votre objet d'être supprimé si (pendant le FinalConstruct) l'objet regroupé en agrégats interne incrémente le décompte de références ensuite décrémente le décompte à 0.

DECLARE_REGISTRY

Écrit l'inscription standard de classe dans la base de registres ou le supprimer de la base de registres.

DECLARE_REGISTRY_APPID_RESOURCEID

Spécifie les informations requises pour enregistrer automatiquement l' appid.

DECLARE_REGISTRY_RESOURCE

Obtient la ressource nommée qui contient le fichier du registre et exécute le script à écrire des objets dans la base de registres ou les supprimer de la base de registres.

DECLARE_REGISTRY_RESOURCEID

Même que DECLARE_REGISTRY_RESOURCE sauf qu'il utilise uint généré par l'Assistant pour identifier la ressource, plutôt qu'un nom de chaîne.

DECLARE_VIEW_STATUS

Définissez cette macro dans une classe de contrôle du contrôle ATL ActiveX pour spécifier les balises de VIEWSTATUS au conteneur.

DECLARE_WND_CLASS

Vous permet de spécifier le nom d'une nouvelle classe de fenêtre. Définissez cette macro dans une classe de contrôle du contrôle ATL ActiveX.

DECLARE_WND_CLASS_EX

Vous permet de spécifier le nom d'une classe de fenêtre existante sur laquelle une nouvelle classe de fenêtre est basée. Définissez cette macro dans une classe de contrôle du contrôle ATL ActiveX.

DECLARE_WND_SUPERCLASS

Permet de spécifier des paramètres d'une classe. Définissez cette macro dans une classe de contrôle du contrôle ATL ActiveX.

DEFAULT_REFLECTION_HANDLER

Fournit un gestionnaire par défaut de la fenêtre enfant (contrôle) qui recevra les messages réfléchis ; le gestionnaire passe correctement les messages non managée à DefWindowProc.

Macros de conversion de chaînes de DEVMODE et de TEXTMETRIC

Ces macros créent une copie d'une structure de DEVMODE ou de TEXTMETRIC et convertissent les chaînes dans la nouvelle structure en un nouveau type chaîne.

END_CATEGORY_MAP

Marque la fin du mappage de catégorie.

END_COM_MAP

Termine la définition de mappage d'interfaces COM.

END_CONNECTION_POINT_MAP

Marque la fin des entrées de mappage des points de connexion.

END_EXTENSION_SNAPIN_NODEINFO_MAP

Marque la fin du mappage de classes de données d'extensions de composants logiciels enfichables.

END_MSG_MAP

Marque la fin d'une table des messages.

END_PROP_MAP

Marque la fin du mappage de propriété de l'objet.

END_RDX_MAP

Marque la fin du mappage d'échange de données de Registre.

END_SERVICE_MAP

Marque la fin du mappage de service.

END_SINK_MAP

Déclare la fin de la table de récepteurs d'événements pour le contrôle composite.

END_SNAPINTOOLBARID_MAP

Déclare la fin de la carte d'ID de barre d'outils pour l'objet enfichable.

EXTENSION_SNAPIN_DATACLASS

Ajoute une donnée membre à la classe de données d'extension de composant logiciel enfichable pour ISnapInItemImplclasse dérivée.

EXTENSION_SNAPIN_NODEINFO_ENTRY

Ajoute une classe de données d'extension de composant logiciel enfichable au mappage de classes de données d'extensions de composants logiciels enfichables.

FORWARD_NOTIFICATIONS

Transféré à des messages de notification la fenêtre parente.

IMPLEMENTED_CATEGORY

Ajoutez une macro d' IMPLEMENTED_CATEGORY à mappage de catégorie de votre composant pour spécifier qu'il doit être inscrit en tant qu'implémentation de la catégorie reconnue par le paramètre d' catID .

MESSAGE_HANDLER

Définit une entrée dans une table des messages.

MESSAGE_RANGE_HANDLER

Semblable à MESSAGE_HANDLER, mais mappe une plage des messages windows à une fonction gestionnaire unique.

NOTIFY_CODE_HANDLER

Semblable à NOTIFY_HANDLER, mais mappe un message de WM_NOTIFY basé uniquement sur le code de notification.

NOTIFY_HANDLER

Définit une entrée dans une table des messages.

NOTIFY_ID_HANDLER

Semblable à NOTIFY_HANDLER, mais mappe un message de WM_NOTIFY basé uniquement sur l'identificateur de contrôle.

NOTIFY_RANGE_CODE_HANDLER

Semblable à NOTIFY_RANGE_HANDLER, mais mappe les messages de WM_NOTIFY au code de notification spécifique d'une plage des contrôles à une fonction gestionnaire unique.

NOTIFY_RANGE_HANDLER

Semblable à NOTIFY_HANDLER, mais mappe les messages de WM_NOTIFY d'une plage des contrôles à une fonction gestionnaire unique.

OBJECT_ENTRY_AUTO

Écrit un objet ATL dans la table d'objets, met à jour le Registre, et crée une instance de l'objet.

OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO

Vous permet de spécifier que l'objet doit être stocké et initialisé, mais il ne doit pas être être créés de l'extérieur via CoCreateInstance.

PROP_DATA_ENTRY

Indique l'étendue, ou des dimensions, d'un contrôle ActiveX.

PROP_ENTRY_INTERFACE

Utilisez cette macro pour écrire une description de la propriété, une propriété DISPID, et une liste de page de propriétés CLSID dans le mappage des propriétés pour l'objet.

PROP_ENTRY_INTERFACE_CALLBACK

Utilisez cette macro pour écrire une description de la propriété, la propriété DISPID, et fournissez une fonction de rappel pour déterminer si tout le CLSID est ajouté au mappage de propriété.

PROP_ENTRY_INTERFACE_CALLBACK_EX

Semblable à PROP_ENTRY_INTERFACE_CALLBACK, mais vous permet de spécifier un IID particulier si votre objet prend en charge plusieurs interfaces doubles.

PROP_ENTRY_INTERFACE_EX

Semblable à PROP_ENTRY_INTERFACE, mais vous permet de spécifier un IID particulier si votre objet prend en charge plusieurs interfaces doubles.

PROP_ENTRY_TYPE

Utilisez cette macro pour écrire une description de la propriété, une propriété DISPID, et une page de propriétés CLSID dans le mappage de propriété de l'objet.

PROP_ENTRY_TYPE_EX

Semblable à PROP_ENTRY_TYPE, mais vous permet de spécifier un IID particulier si votre objet prend en charge plusieurs interfaces doubles.

PROP_PAGE

Utilisez cette macro pour écrire une page de propriétés CLSID dans le mappage de propriété de l'objet.

RDX_BINARY

Associe l'entrée de registre spécifiée avec une variable membre spécifiée de type OCTET.

RDX_CSTRING_TEXT

Associe l'entrée de registre spécifiée avec une variable membre spécifiée de CString type.

RDX_DWORD

Associe l'entrée de registre spécifiée avec une variable membre spécifiée du type DWORD.

RDX_TEXT

Associe l'entrée de registre spécifiée avec une variable membre spécifiée du type TCHAR.

REFLECT_NOTIFICATIONS

Reflète les messages de notification dans la fenêtre enfant (contrôle) qui les a envoyés.

REFLECTED_COMMAND_CODE_HANDLER

Semblable à COMMAND_CODE_HANDLER, mais mappe les commandes reflétées de la fenêtre parente.

REFLECTED_COMMAND_HANDLER

Semblable à COMMAND_HANDLER, mais mappe les commandes reflétées de la fenêtre parente.

REFLECTED_COMMAND_ID_HANDLER

Semblable à COMMAND_ID_HANDLER, mais mappe les commandes reflétées de la fenêtre parente.

REFLECTED_COMMAND_RANGE_CODE_HANDLER

Semblable à COMMAND_RANGE_CODE_HANDLER, mais mappe les commandes reflétées de la fenêtre parente.

REFLECTED_COMMAND_RANGE_HANDLER

Semblable à COMMAND_RANGE_HANDLER, mais mappe les commandes reflétées de la fenêtre parente.

REFLECTED_NOTIFY_CODE_HANDLER

Semblable à NOTIFY_CODE_HANDLER, mais mappe les notifications reflétées de la fenêtre parente.

REFLECTED_NOTIFY_HANDLER

Semblable à NOTIFY_HANDLER, mais mappe les notifications reflétées de la fenêtre parente.

REFLECTED_NOTIFY_ID_HANDLER

Semblable à NOTIFY_ID_HANDLER, mais mappe les notifications reflétées de la fenêtre parente.

REFLECTED_NOTIFY_RANGE_CODE_HANDLER

Semblable à NOTIFY_RANGE_CODE_HANDLER, mais mappe les notifications reflétées de la fenêtre parente.

REFLECTED_NOTIFY_RANGE_HANDLER

Semblable à NOTIFY_RANGE_HANDLER, mais mappe les notifications reflétées de la fenêtre parente.

REQUIRED_CATEGORY

Ajoutez une macro d' REQUIRED_CATEGORY à mappage de catégorie de votre composant pour spécifier qu'il doit être enregistré en tant que spécification de la catégorie reconnue par le paramètre d' catID .

SERVICE_ENTRY

Indique que l'objet prend en charge l'identificateur de service spécifié par SID.

SERVICE_ENTRY_CHAIN

Demande à IServiceProviderImpl::QueryService de chaînage à l'objet spécifié par punk.

SINK_ENTRY

Déclare une fonction gestionnaire (fn) pour l'événement spécifié (dispid), du contrôle marqué par id.

SINK_ENTRY_EX

Déclare une fonction gestionnaire (fn) pour l'événement spécifié (dispid), l'interface de dispatch (iid), parce que le contrôle identifié par id.

SINK_ENTRY_INFORMATION

Utilisez la macro d' SINK_ENTRY_INFO dans une table de récepteurs d'événements pour fournir les informations requises par IDispEventSimpleImpl aux événements d'itinéraire à la fonction gestionnaire appropriée.

SNAPINMENUID

Utilisez cette macro pour déclarer la ressource menu contextuel de l'objet enfichable.

SNAPINTOOLBARID_ENTRY

Utilisez cette macro pour écrire un ID de barre d'outils dans le mappage d'ID de la barre d'outils de l'objet enfichable.

WM_FORWARDMSG

Cette macro transféré un message reçu par une fenêtre vers une autre fenêtre pour traiter.

Voir aussi

Autres ressources

Macros ATL

Composants de Bureau COM ATL

Fonctions ATL

Variables globales ATL

Structures ATL

Typedefs ATL

Vue d'ensemble de la classe ATL