REQUIRED_CATEGORY
Aggiungere una macro REQUIRED_CATEGORY a mapping di categoria del componente per specificare che deve essere registrato come richieste di categoria identificata dal parametro catID.
REQUIRED_CATEGORY(
catID
)
Parametri
- catID
[in] una costante o una variabile CATID che utilizza l'identificatore univoco globale (GUID) per la categoria richiesta.L'indirizzo catID verrà creato e aggiunto al mapping.Nella tabella che segue è una selezione delle categorie predefinite.
Note
Le categorie componenti elencati nel mapping saranno registrate automaticamente quando viene registrato se la classe dispone di una macro collegata OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO o OBJECT_ENTRY_AUTO.
I client possono utilizzare le informazioni di categoria registrate per la classe per determinare le funzionalità e i requisiti senza dover creare un'istanza.Ad esempio, un controllo può richiedere che non supportano l'associazione dati del contenitore.Il contenitore può verificare se contiene le funzionalità necessarie per ospitare il controllo effettuerà una query l'amministratore di categoria per le categorie richieste dal controllo.Se il contenitore non supporta la funzionalità richiesta, può rifiutare di ospitare l'oggetto COM.
Per ulteriori informazioni sulle categorie componenti, incluso un elenco di esempio, vedere Cosa sono categorie componenti e il loro funzionamento? in Windows SDK.
Una selezione delle categorie predefinite
Descrizione |
Simbolo |
Il Registro di sistema GUID |
|---|---|---|
Sicuri per gli script |
CATID_SafeForScripting |
7DD95801-9882-11CF-9FA9-00AA006C42C4 {} |
Sicurezza per l'inizializzazione |
CATID_SafeForInitializing |
7DD95802-9882-11CF-9FA9-00AA006C42C4 {} |
Contenimento semplice del sito del frame |
CATID_SimpleFrameControl |
157083E0-2368-11cf-87B9-00AA006C8166 {} |
Associazione dati semplice |
CATID_PropertyNotifyControl |
157083E1-2368-11cf-87B9-00AA006C8166 {} |
Associazione dati avanzata |
CATID_VBDataBound |
157083E2-2368-11cf-87B9-00AA006C8166 {} |
Controlli privi di finestra |
CATID_WindowlessObject |
1D06B600-3AE3-11cf-87B9-00AA006C8166 {} |
Gli oggetti internet |
Vedere Gli oggetti Internet in Windows SDK per un elenco di esempio. |
|
Esempio
BEGIN_CATEGORY_MAP(CMyWindow)
REQUIRED_CATEGORY(CATID_InternetAware)
END_CATEGORY_MAP()
Requisiti
Header: atlcom.h