requires_category

Статья
10/12/2023

Указывает необходимые категории компонентов целевого класса.

Синтаксис

[ requires_category(
  requires_category) ]

Параметры

requires_category
Идентификатор требуемой категории.

Замечания

Атрибут requires_category C++ указывает категории компонентов, необходимые целевому классу. Дополнительные сведения см. в REQUIRED_CATEGORY.

Этот атрибут требует, чтобы атрибут coclass, progidили vi_progid (или другой атрибут, который подразумевает один из них) также применялся к этому элементу.

Пример

В следующем коде требуется, чтобы объект реализовал категорию Control.

// cpp_attr_ref_requires_category.cpp
// compile with: /LD
#define _ATL_ATTRIBUTES
#include "atlbase.h"
#include "atlcom.h"

[module (name="MyLibrary")];

[ coclass, requires_category("CATID_Control"),
  uuid("1e1a2436-f3ea-4ff3-80bf-5409370e8144")]
class CMyClass {};

Требования

Контекст атрибута	Значение
Относится к	`class`, `struct`
Повторяемый	No
Обязательные атрибуты	Одно или несколько из следующих элементов: `coclass`, `progid`или `vi_progid`.
Недопустимые атрибуты	None

Дополнительные сведения о контекстах атрибутов см. в разделе Контексты атрибутов.

См. также

Атрибуты COM
implements_category

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