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


REQUIRED_CATEGORY

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

REQUIRED_CATEGORY( 
   catID  
)

Параметры

  • catID
    [in] Константа или переменная, а CATID глобальный уникальный идентификатор (GUID) для необходимой категории. Адрес catID будет принят и будет добавлять в сопоставление. См. таблицу далее для выбора категорий стандартное.

Заметки

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

Клиенты могут использовать данные по категории, зарегистрированные для класса, чтобы определить его возможностей и требований без создать его экземпляр. Например, элемент управления может потребовать привязки данных поддержки контейнера. Контейнер может распознать, если он имеет возможности, необходимые для размещенные элемент управления, запросив диспетчер категории для категорий требуется этим элементом управления. Если контейнер не поддерживает необходимую функцию, он может размещение отказ от com-объекта.

Дополнительные сведения о категориях список компонентов, включая образцы, см. в разделе Категории компонентов, и принципы их работы? в Windows SDK.

Выделение категорий ticker

Описание

Символ

Идентификатор GUID реестра

Safe скриптов

CATID_SafeForScripting

{7DD95801-9882-11CF-9FA9-00AA006C42C4}

Safe для инициализации

CATID_SafeForInitializing

{7DD95802-9882-11CF-9FA9-00AA006C42C4}

Простое вложенность сайта кадра

CATID_SimpleFrameControl

{157083E0-2368-11cf-87B9-00AA006C8166}

Простая привязка данных

CATID_PropertyNotifyControl

{157083E1-2368-11cf-87B9-00AA006C8166}

Дополнительная привязка данных

CATID_VBDataBound

{157083E2-2368-11cf-87B9-00AA006C8166}

Безоконные элементы управления

CATID_WindowlessObject

{1D06B600-3AE3-11cf-87B9-00AA006C8166}

Интернет-Осведомленные объекты

См. раздел объекты Интернета осведомленные в Windows SDK список выборки.

 

Пример

BEGIN_CATEGORY_MAP(CMyWindow)
   REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()

Требования

Header: atlcom.h

См. также

Ссылки

BEGIN_CATEGORY_MAP

IMPLEMENTED_CATEGORY

END_CATEGORY_MAP

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

Category Macros

Макросы ATL