Поделиться через


ATL Macros Alphabetical Reference

В этом разделе, справочные материалы для макросов библиотеки ATL упорядочиватьы в алфавитном порядке. Чтобы найти определенный макрос по категориям см. в разделе Макросы библиотеки ATL.

Макрос

Описание

_ATL_ALL_WARNINGS

Символ, который включает ошибок в проектах преобразовал из предыдущих версий библиотеки ATL.

_ATL_APARTMENT_THREADED

Укажите если один или несколько объектов использующие потоковую модель Подразделение.

_ATL_CSTRING_EXPLICIT_CONSTRUCTORS

Выполняет одну конструкторы CString явным, предотвращение все неумышленные преобразования.

_ATL_DEBUG_INTERFACES

Укажите этот макрос раньше включая все файлы заголовков библиотеки ATL для трассировки все вызовы AddRef и Выпуск в интерфейсах ваших компонентов в окно вывода.

_ATL_DEBUG_QI

Записывает все вызовы QueryInterface в окно вывода.

_ATL_FREE_THREADED

Укажите если один или несколько конкретных свободна использования объектов или нейтрального потоки.

_ATL_MIXED

Сообщает компилятору, что приложение библиотеки ATL состоит из собственного и compilands /clr.

_ATL_MULTI_THREADED

Символ, указывающий проект будет содержать объекты, которые помечены как оба, свободен или neutral. Макрос _ATL_FREE_THREADED должен использоваться в новом коде.

_ATL_NO_COM_SUPPORT

Символ, который предотвращает Модель COM- связанный код из компилированным с проектом.

_ATL_NO_AUTOMATIC_NAMESPACE

Символ, который предотвращает использование пространств имен по умолчанию в виде библиотеки ATL.

_ATL_NO_VARIANT_THROW

Подавляет CComVariant Class из генерирования исключений.

_ATL_SECURE_NO_WARNINGS

Подавляет предупреждения компилятора для использования нерекомендуемых функций библиотеки ATL.

_ATL_STATIC_REGISTRY

Символ, указывающий необходимо, чтобы код регистрации для объекта находиться в объекте, чтобы избежать зависимость от ATL.DLL.

_ATLCATCH

Выписки для обработки ошибки, происходящие в связанном _ATLTRY

_ATLCATCHALL

Выписки для обработки ошибки, происходящие в связанном _ATLTRY.

_ATLTRY

Помечает защищенный раздел кода, где возможно, ошибка могла произойти.

Флаги ATL_ESC

Эти флаги используются для мониторинга расширения функциональности EscapeXML.

ALT_MSG_MAP

Отмечает начало другого сопоставления сообщения.

Макросы преобразования строки библиотеки ATL и MFC

Макросы преобразования строки, допустимые для библиотеки ATL и MFC.

ATLASSERT

Макрос ATLASSERT выполняет одну и ту же функциональность, что обнаружен макрос _ASSERTE в библиотеке времени выполнения языка c.

ATL_NOINLINE

Символ, указывающий функцию не должен быть встроенным.

ATL_NO_VTABLE

Символ, который предотвращает указатель vtable от инициализации в конструкторе и деструкторе типа.

ATL_URL Flags

Эти флаги изменить поведение AtlEscapeUrl и AtlCanonicalizeUrl.

ATL_URL_SCHEME

Члены данного перечисления содержатся константы для схем понятых скручиваемость.

ATL_WORKER_THREAD_WAIT

Этот макрос указывает значение по умолчанию (в миллисекундах), CWorkerThread::Shutdown ожидает рабочий поток для закрытия.

ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT

Этот макрос указывает время по умолчанию (в миллисекундах), CThreadPool ожидает поток для закрытия.

ATLS_DEFAULT_THREADSPERPROC

Этот макрос указывает по умолчанию количество потоков для процессора, используемый CThreadPool.

Флаги ATLSMTP_QPENCODE

Эти флаги описывается закавычить- непечатаемым кодирование, которая должна быть выполнена объектом QPEncode.

Флаги ATLSMTP_UUENCODE

Эти флаги описывается uuencoding выполняться UUEncode.

ATLTRACE

Информирует предупреждений на устройство вывода, как окно отладчика, в соответствии с отображенным флагам и слоями. Включено для обеспечения обратной совместимости.

ATLTRACE2

Информирует предупреждений на устройство вывода, как окно отладчика, в соответствии с отображенным флагам и слоями.

ATLTRACENOTIMPL

В отладочные построения библиотеки ATL, отправьте строка "не реализовано"funcname на устройство резервного копирования и не возвращает E_NOTIMPL.

BEGIN_CATEGORY_MAP

Отмечает начало сопоставления категории.

BEGIN_COM_MAP

Сопоставление модели COM - это механизм, который предоставляет интерфейсы в объекте клиенту с помощью QueryInterface.

BEGIN_CONNECTION_POINT_MAP

Отмечает начало записей сопоставления точки подключения.

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP

Отмечает начало сопоставления класса данных расширения оснастки.

BEGIN_MSG_MAP

Отмечает начало по умолчанию сопоставления сообщения.

BEGIN_PROP_MAP

Отмечает начало сопоставления свойства объекта.

BEGIN_RDX_MAP

Отмечает начало сопоставления обмена данными реестра.

BEGIN_SERVICE_MAP

Отмечает начало сопоставления служб.

BEGIN_SINK_MAP

Объявляет начало сопоставления приемника событий для составного элемента управления.

BEGIN_SNAPINTOOLBARID_MAP

Объявляет начало сопоставления идентификатор панели инструментов для объекта оснастки.

CHAIN_MSG_MAP

Определяет запись в сопоставлении сообщений.

CHAIN_MSG_MAP_ALT

Определяет запись в сопоставлении сообщений.

CHAIN_MSG_MAP_ALT_MEMBER

Определяет запись в сопоставлении сообщений.

CHAIN_MSG_MAP_DYNAMIC

Определяет запись в сопоставлении сообщений.

CHAIN_MSG_MAP_MEMBER

Определяет запись в сопоставлении сообщений.

Макросы COM_INTERFACE_ENTRY

Эти макросы входят интерфейсы объекта в его сопоставление модели COM, чтобы они могли быть получить доступ QueryInterface.

COM_INTERFACE_ENTRY

Интерфейсы перейдет в сопоставление интерфейса модели COM.

COM_INTERFACE_ENTRY2

Используйте этот макрос для устранения неоднозначности 2 ветвления наследования.

COM_INTERFACE_ENTRY2_IID

То же, что и COM_INTERFACE_ENTRY2, за исключением того, что можно указать другое ИДЕНТИФИКАТОРА.

COM_INTERFACE_ENTRY_AGGREGATE

Если интерфейс указанный iid запрашивается для COM_INTERFACE_ENTRY_AGGREGATE переадресует к punk.

COM_INTERFACE_ENTRY_AGGREGATE_BLIND

То же, что и COM_INTERFACE_ENTRY_AGGREGATE, за исключением того, что выполнение запроса для получения всех IID приводит к переадресованы запрос к punk.

COM_INTERFACE_ENTRY_AUTOAGGREGATE

То же, что и COM_INTERFACE_ENTRY_AGGREGATE, за исключением если punkNULL, то он автоматически создает статистическое выражение, описанный clsid.

COM_INTERFACE_ENTRY_AUTOAGGREGATE_BLIND

То же, что и COM_INTERFACE_ENTRY_AUTOAGGREGATE, за исключением того, что выполнение запроса для получения всех IID приводит к переадресованы запрос к punk, и если punkNULL, то автоматически создать агрегат, описанный clsid.

COM_INTERFACE_ENTRY_BREAK

Заставляет программу вызвать DebugBreak, если указанный интерфейс запрашивается.

COM_INTERFACE_ENTRY_CACHED_TEAR_OFF

Сохраняет сведения о интерфейс- определенного для каждого экземпляра.

COM_INTERFACE_ENTRY_CHAIN

Обрабатывает сопоставление модели COM базового класса при обработке достигает эту запись в сопоставлении модели COM.

COM_INTERFACE_ENTRY_FUNC

Общий механизм циклический в QueryInterface библиотеки ATL логику.

COM_INTERFACE_ENTRY_FUNC_BLIND

То же, что и COM_INTERFACE_ENTRY_FUNC, за исключением того, что выполнение запроса для получения всех IID, приводят к вызову func.

COM_INTERFACE_ENTRY_IID

Используйте этот макрос, чтобы ввести интерфейс в сопоставление модели COM и задать его ИДЕНТИФИКАТОРА.

COM_INTERFACE_ENTRY_NOINTERFACE

Возвращает E_NOINTERFACE и заканчивается сопоставление модели COM, если указанный интерфейс запрашивается для обработки.

COM_INTERFACE_ENTRY_TEAR_OFF

Предоставляет свои перемещаемые интерфейсы.

COMMAND_CODE_HANDLER

Подобно COMMAND_HANDLER, но сопоставляет сообщение WM_COMMAND на основе только в коде уведомления.

COMMAND_HANDLER

Определяет запись в сопоставлении сообщений.

COMMAND_ID_HANDLER

Подобно COMMAND_HANDLER, но сопоставляет сообщение WM_COMMAND на основе только на идентификаторе пункта меню, элемента управления или сочетаний клавиш.

COMMAND_RANGE_CODE_HANDLER

Подобно COMMAND_RANGE_HANDLER, но сообщения WM_COMMAND сопоставления с указанным кодом уведомления от диапазона элементов управления к одному обработчику функция.

COMMAND_RANGE_HANDLER

Подобно COMMAND_HANDLER, но сообщения WM_COMMAND сопоставления из диапазона элементов управления к одному обработчику функция.

CONNECTION_POINT_ENTRY

Добавляет точку подключения для указанного интерфейса в сопоставление точки подключения, чтобы они были доступны.

DECLARE_AGGREGATABLE

Указывает, что объект может быть агрегированными.

DECLARE_CLASSFACTORY

Объявляет CComClassFactory чтобы быть фабрикой класса.

DECLARE_CLASSFACTORY2

Объявляет CComClassFactory2 чтобы быть фабрикой класса.

DECLARE_CLASSFACTORY_AUTO_THREAD

Объявляет CComClassFactoryAutoThread чтобы быть фабрикой класса.

DECLARE_CLASSFACTORY_EX

Объявляет cf чтобы быть фабрикой класса.

DECLARE_CLASSFACTORY_SINGLETON

Объявляет CComClassFactorySingleton чтобы быть фабрикой класса.

DECLARE_EMPTY_MSG_MAP

Объявляет сопоставление пустого сообщения.

DECLARE_GET_CONTROLLING_UNKNOWN

Объявляет виртуальную функцию GetControllingUnknown.

DECLARE_LIBID

Предоставляет способ для библиотеки ATL получить идентификатор libid библиотеки типов.

DECLARE_NO_REGISTRY

Используйте DECLARE_NO_REGISTRY если нужно избежать любой по умолчанию регистрация библиотеки ATL для класса, в который этот макрос.

DECLARE_NOT_AGGREGATABLE

Указывает, что объект не могут быть агрегированными.

DECLARE_OBJECT_DESCRIPTION

Позволяет указать текстовое описание объекта класса.

DECLARE_OLEMISC_STATUS

Используемый в элементах управления ActiveX библиотеки ATL для задания OLEMISC пометит.

DECLARE_ONLY_AGGREGATABLE

Указывает, что объект должен быть агрегированными.

DECLARE_POLY_AGGREGATABLE

Указывает, что создание экземпляра CComPolyObject < x > при создании объекта.

DECLARE_PROTECT_FINAL_CONSTRUCT

Защищает объект из быть удалены, если во время FinalConstruct() внутренний статистическая обработка вычислениеый объекта увеличивает счетчик ссылок затем уменьшает число до 0.

DECLARE_REGISTRY

Вставляет стандартную регистрацию класса в реестре системы или удаляет его из системного реестра.

DECLARE_REGISTRY_APPID_RESOURCEID

Задает сведения, необходимые для регистрации appid автоматически.

DECLARE_REGISTRY_RESOURCE

Возвращает именованный ресурс, содержащий файл реестра и запускает скрипт или объектам входа в реестре системы или удаляет их из системного реестра.

DECLARE_REGISTRY_RESOURCEID

То же, что и DECLARE_REGISTRY_RESOURCE за исключением того, что он использует мастер-, сформированное UINT, чтобы определить ресурс, а не имя строки.

DECLARE_VIEW_STATUS

Поместите этот макрос в классе элемента управления элемента управления ActiveX библиотеки ATL, чтобы задать флаги VIEWSTATUS в контейнер.

DECLARE_WND_CLASS

Позволяет указать имя класса нового окна. Поместите этот макрос в классе элемента управления элемента управления ActiveX библиотеки ATL.

DECLARE_WND_CLASS_EX

Позволяет указать имя существующего класса окна, в котором будет основан класс нового окна. Поместите этот макрос в классе элемента управления элемента управления ActiveX библиотеки ATL.

DECLARE_WND_SUPERCLASS

Позволяет задать параметры класса. Поместите этот макрос в классе элемента управления элемента управления ActiveX библиотеки ATL.

DEFAULT_REFLECTION_HANDLER

Предоставляет используемый по умолчанию обработчик для дочернего окна (элемента управления), обращающееся отраженные сообщения; обработчик будет получен необработанных сообщений в DefWindowProc правильно.

Макросы преобразования строки DEVMODE и TEXTMETRIC

Эти макросы создают копия структуры DEVMODE или TEXTMETRIC и преобразования строки в новую структуру на новый строковый тип.

END_CATEGORY_MAP

Помечает конец сопоставления категории.

END_COM_MAP

Завершает определение пользовательского сопоставления COM-интерфейса.

END_CONNECTION_POINT_MAP

Помечает конец записей сопоставления точки подключения.

END_EXTENSION_SNAPIN_NODEINFO_MAP

Помечает конец сопоставления класса данных расширения оснастки.

END_MSG_MAP

Помечает конец сопоставления сообщения.

END_PROP_MAP

Помечает конец сопоставления свойства объекта.

END_RDX_MAP

Помечает конец сопоставления обмена данными реестра.

END_SERVICE_MAP

Помечает конец сопоставления служб.

END_SINK_MAP

Объявляет конца сопоставления приемника событий для составного элемента управления.

END_SNAPINTOOLBARID_MAP

Объявляет конца сопоставления идентификатор панели инструментов для объекта оснастки.

EXTENSION_SNAPIN_DATACLASS

Добавляет элемент данных, к классу данных для ISnapInItemImpl- производный класс расширения оснастки.

EXTENSION_SNAPIN_NODEINFO_ENTRY

Добавляет класс данных оснастки расширения для сопоставления класса данных расширения оснастки.

FORWARD_NOTIFICATIONS

Переадресует сообщения уведомления родительского окна.

IMPLEMENTED_CATEGORY

Добавить макрос IMPLEMENTED_CATEGORY к сопоставление категории компонента, чтобы указать, что она должна быть реализация категорию, указанную параметром зарегистрировать в качестве catID.

MESSAGE_HANDLER

Определяет запись в сопоставлении сообщений.

MESSAGE_RANGE_HANDLER

Подобно MESSAGE_HANDLER, но сопоставляет диапазон сообщений Windows с одной функции обработчика.

NOTIFY_CODE_HANDLER

Подобно NOTIFY_HANDLER, но сопоставляет сообщение WM_NOTIFY на основе только в коде уведомления.

NOTIFY_HANDLER

Определяет запись в сопоставлении сообщений.

NOTIFY_ID_HANDLER

Подобно NOTIFY_HANDLER, но сопоставляет сообщение WM_NOTIFY на основе только на идентификаторе элемента управления.

NOTIFY_RANGE_CODE_HANDLER

Подобно NOTIFY_RANGE_HANDLER, но сообщения WM_NOTIFY сопоставления с указанным кодом уведомления от диапазона элементов управления к одному обработчику функция.

NOTIFY_RANGE_HANDLER

Подобно NOTIFY_HANDLER, но сообщения WM_NOTIFY сопоставления из диапазона элементов управления к одному обработчику функция.

OBJECT_ENTRY_AUTO

Вставляет объект библиотеки ATL в сопоставление объекта, обновление реестра и создает экземпляр объекта.

OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO

Позволяет указать, что объект должен быть зарегистрирован и инициализации, но он не должен быть создаваемыми с помощью внешнего CoCreateInstance.

PROP_DATA_ENTRY

Указывает область памяти или измерения, элемент управления ActiveX.

PROP_ENTRY_INTERFACE

Используйте этот макрос, чтобы ввести описание свойства выберите свойство DISPID, и список страниц свойств CLSID в сопоставление свойств для объекта.

PROP_ENTRY_INTERFACE_CALLBACK

Используйте этот макрос, чтобы ввести описание свойства выберите свойство DISPID, обеспечивайте функцию обратного вызова для указания если таковая CLSID должно добавлено к сопоставлению свойств.

PROP_ENTRY_INTERFACE_CALLBACK_EX

Подобно PROP_ENTRY_INTERFACE_CALLBACK, но позволяет указать указанного ИДЕНТИФИКАТОРА если объект поддерживает несколько сдвоенные интерфейсы.

PROP_ENTRY_INTERFACE_EX

Подобно PROP_ENTRY_INTERFACE, но позволяет указать указанного ИДЕНТИФИКАТОРА если объект поддерживает несколько сдвоенные интерфейсы.

PROP_ENTRY_TYPE

Используйте этот макрос, чтобы ввести описание свойства выберите свойство DISPID, и страницы свойств CLSID в сопоставление свойств объекта.

PROP_ENTRY_TYPE_EX

Подобно PROP_ENTRY_TYPE, но позволяет указать указанного ИДЕНТИФИКАТОРА если объект поддерживает несколько сдвоенные интерфейсы.

PROP_PAGE

Используйте этот макрос, чтобы ввести страницу свойств CLSID в сопоставление свойств объекта.

RDX_BINARY

Связывает указанную запись реестра с заданной переменной члена типа в байтах.

RDX_CSTRING_TEXT

Связывает указанную запись реестра с указанной переменной члена типа CString.

RDX_DWORD

Связывает указанную запись реестра с заданной переменной члена типа DWORD.

RDX_TEXT

Связывает указанную запись реестра с указанной переменной члена типа TCHAR.

REFLECT_NOTIFICATIONS

Отражает сообщения уведомления обратно к дочернему окну (элементу управления), который отправил их.

REFLECTED_COMMAND_CODE_HANDLER

Подобно COMMAND_CODE_HANDLER, но сопоставляет команды отраженные из родительского окна.

REFLECTED_COMMAND_HANDLER

Подобно COMMAND_HANDLER, но сопоставляет команды отраженные из родительского окна.

REFLECTED_COMMAND_ID_HANDLER

Подобно COMMAND_ID_HANDLER, но сопоставляет команды отраженные из родительского окна.

REFLECTED_COMMAND_RANGE_CODE_HANDLER

Подобно COMMAND_RANGE_CODE_HANDLER, но сопоставляет команды отраженные из родительского окна.

REFLECTED_COMMAND_RANGE_HANDLER

Подобно COMMAND_RANGE_HANDLER, но сопоставляет команды отраженные из родительского окна.

REFLECTED_NOTIFY_CODE_HANDLER

Подобно NOTIFY_CODE_HANDLER, но сопоставляет уведомления отраженные из родительского окна.

REFLECTED_NOTIFY_HANDLER

Подобно NOTIFY_HANDLER, но сопоставляет уведомления отраженные из родительского окна.

REFLECTED_NOTIFY_ID_HANDLER

Подобно NOTIFY_ID_HANDLER, но уведомления сопоставления автоматически устанавленным из родительского окна.

REFLECTED_NOTIFY_RANGE_CODE_HANDLER

Подобно NOTIFY_RANGE_CODE_HANDLER, но сопоставляет уведомления отраженные из родительского окна.

REFLECTED_NOTIFY_RANGE_HANDLER

Подобно NOTIFY_RANGE_HANDLER, но сопоставляет уведомления отраженные из родительского окна.

REQUIRED_CATEGORY

Добавить макрос REQUIRED_CATEGORY к сопоставление категории компонента для указания того, что он должен быть зарегистрирован как требующие включения категории, указанной параметром catID.

SERVICE_ENTRY

Указывает, что объект поддерживает идентификатор службы указанный идентификатор безопасности.

SERVICE_ENTRY_CHAIN

Указывает IServiceProviderImpl::QueryService для привязан к объекту, заданному punk.

SINK_ENTRY

Объявляется функция обработчика (fn) для заданного события (dispid) элемента управления, указанного id.

SINK_ENTRY_EX

Объявляется функция обработчика (fn) для заданного события (dispid) интерфейса диспетчеризации (iid), для элемента управления, указанный id.

SINK_ENTRY_INFORMATION

Используйте макрос SINK_ENTRY_INFO в сопоставление приемника событий, чтобы обеспечить необходимую информацию IDispEventSimpleImpl для направления события в соответствующей функции обработчика.

SNAPINMENUID

Используйте этот макрос для объявления ресурс контекстного меню объекта оснастки.

SNAPINTOOLBARID_ENTRY

Используйте этот макрос, чтобы ввести идентификатор панели инструментов на панели инструментов сопоставление идентификатор объекта оснастки.

WM_FORWARDMSG

Этот макрос переадресует сообщение, полученное окном к другому окну для обработки.

См. также

Другие ресурсы

Макросы ATL

ATL COM Desktop Components

ATL Functions

ATL Global Variables

ATL Structures

ATL Typedefs

ATL Class Overview