Freigeben über


REQUIRED_CATEGORY

Fügen Sie ein REQUIRED_CATEGORY-Makro Kategorienzuordnung der Komponente hinzu, um anzugeben, dass es als erfordert der Kategorie registriert werden soll, die von den catID-Parameter identifiziert wird.

REQUIRED_CATEGORY( 
   catID  
)

Parameter

  • catID
    [in] Konstante oder Variable eine CATID, die den GUID (Globally Unique Identifier) enthalten für die erforderliche Kategorie. Die Adresse von catID wird zur Zuordnung übernommen und hinzugefügt. finden Sie in der nachstehenden Tabelle eine Auswahl von Aktienkategorien.

Hinweise

Die Teilkategorien, die in der Zuordnung aufgeführt sind, werden automatisch registriert, wenn das Modul registriert wird, wenn die Klasse zugeordnete soll oder OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO Ein Makro verfügt.

Clients können die Kategorieninformationen verwenden, die für die Klasse bestimmt die Funktionen und Anforderungen, ohne zu müssen, eine Instanz davon erstellen registriert werden. Beispielsweise erfordert möglicherweise ein Steuerelement dass eine Containerstützdatenbindung. Der Container kann ermitteln, wenn er die Funktionen verfügt, die erforderlich sind, das Steuerelement zu hosten, indem er den Kategorienmanager für die Kategorien abgefragt werden, die von diesem Steuerelement benötigt werden. Wenn der Container keine erforderliche Funktion unterstützt, kann er ablehnen, das COM-Objekt zu hosten.

Weitere Informationen zu Teilkategorien, einschließlich einer Beispielliste, finden Sie unter Was sind Teilkategorien und deren Funktionsweise? in Windows SDK.

Eine Auswahl von Aktienkategorien

Description

Symbol

Registrierung GUID

Sicher für die Skripterstellung

CATID_SafeForScripting

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

Sicher für Initialisierung

CATID_SafeForInitializing

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

Einfache Frame-Site-Kapselung

CATID_SimpleFrameControl

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

Einfache Datenbindung

CATID_PropertyNotifyControl

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

Erweiterte Datenbindung

CATID_VBDataBound

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

Fensterlose Steuerelemente

CATID_WindowlessObject

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

Internet-Bewusste Objekte

Siehe Internet-bewusste Objekte in Windows SDK für eine Beispielliste.

 

Beispiel

BEGIN_CATEGORY_MAP(CMyWindow)
   REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()

Anforderungen

Header: möchten

Siehe auch

Referenz

BEGIN_CATEGORY_MAP

IMPLEMENTED_CATEGORY

END_CATEGORY_MAP

Weitere Ressourcen

Category Macros

ATL-Makros