noncreatable (attributo)

Articolo
06/13/2023

L'attributo [noncreatable] definisce un oggetto che non può essere creato automaticamente.

[
  coclass-attribute-list, 
    noncreatable
]
coclass coclass-name
{
  coclass-interface-list
}

Parametri

coclass-attribute-list: Altri attributi che si applicano alla classe.
coclasse-name: Nome della classe.
coclass-interface-list: Elenco di interfacce per la classe.

Commenti

Usare l'attributo [noncreatable] in un'istruzione coclasse per indicare agli utenti che non possono creare un nuovo oggetto di questa classe a livello superiore, ovvero chiamando CreateInstance o CoCreateInstance. L'istanza di un oggetto di questa classe richiede una chiamata al metodo a un altro oggetto. Ad esempio, in Microsoft Excel l'oggetto "Cell" non è creabile e deve essere ottenuto da un oggetto Foglio di lavoro di Microsoft Excel.

I metodi che restituiscono istanze di classi noncreabili devono restituire il tipo esatto dell'oggetto, anziché i tipi VARIANT o IDispatch*.

Rappresentazione typeflag:

Assenza di TYPEFLAG_FCANCREATE.

Esempi

[
    uuid(12345678-1234-1234-1234-123456789ABC),
    helpstring("This is MyCOClass"),
    noncreatable
]
coclass MyCoClass
{
    [default] interface IMyClass;
    [default, source] dispinterface IMyClassEvents;
}

Vedere anche

coclass
Sintassi del file ODL
Esempio di file ODL
Generazione di una libreria di tipi con MIDL

Condividi tramite