REQUIRED_CATEGORY
Agregue una macro de REQUIRED_CATEGORY a mapa de categoría de componente para especificar debería registrarse como requerir la categoría identificada por el parámetro de catID .
REQUIRED_CATEGORY(
catID
)
Parámetros
- catID
[in] una constante o una variable de CATID que contiene el identificador único global (GUID) para la categoría necesaria. Tardarán y se agregará a la dirección de catID al mapa. Vea la tabla siguiente para obtener una selección de categorías comunes.
Comentarios
Las categorías componentes enumeradas en el mapa se registran automáticamente cuando se registra el módulo si la clase tiene una macro asociado de OBJECT_ENTRY_AUTO o de OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO .
Los clientes pueden usar la información de categoría registrada para que la clase determinar sus funciones y requisitos sin tener que crear una instancia de ella. Por ejemplo, un control puede requerir que un enlace de datos de soporte del contenedor. El contenedor puede averiguar si tiene capacidades necesarias hospedar el control consultando el administrador de la categoría de categorías necesarias para ese control. Si el contenedor no admite una característica necesaria, puede rechazar hospedar el objeto COM.
Para obtener más información sobre las categorías componentes, incluida una lista de ejemplo, vea ¿Qué son categorías componentes y cómo ellos funcionan? en Windows SDK.
una selección de categorías comunes
Descripción |
Símbolo |
registro GUID |
|---|---|---|
Safe para el script |
CATID_SafeForScripting |
{7DD95801-9882-11CF-9FA9-00AA006 C42 C4} |
Seguro para la inicialización |
CATID_SafeForInitializing |
{7DD95802-9882-11CF-9FA9-00AA006 C42 C4} |
Contención simple de sitio de cuadro |
CATID_SimpleFrameControl |
{157083E0-2368-11cf-87B9-00AA006 C8166} |
Enlace de datos sencillo |
CATID_PropertyNotifyControl |
{157083E1-2368-11cf-87B9-00AA006 C8166} |
Enlace de datos avanzados |
CATID_VBDataBound |
{157083E2-2368-11cf-87B9-00AA006 C8166} |
Controles sin ventana |
CATID_WindowlessObject |
{1D06B600-3AE3-11cf-87B9-00AA006 C8166} |
objetos Herramienta de creación de HTML-Enterados |
Vea Objetos corriente de internet en Windows SDK para una lista de ejemplo. |
|
Ejemplo
BEGIN_CATEGORY_MAP(CMyWindow)
REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()
Requisitos
encabezado: atlcom.h