Auf Englisch lesen

Freigeben über


noncreatable-Attribut

Das [nicht erstellbare] Attribut definiert ein Objekt, das nicht selbst instanziiert werden kann.

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

Parameter

coclass-attribute-list

Andere Attribute, die für die -Klasse gelten.

coclass-name

Der Name der Klasse.

coclass-interface-list

Eine Liste der Schnittstellen für die -Klasse.

Bemerkungen

Verwenden Sie das Attribut [noncreatable] für eine coclass-Anweisung , um Benutzern mitzuteilen, dass sie kein neues Objekt dieser Klasse auf oberster Ebene erstellen können, d. h. durch Aufrufen von CreateInstance oder CoCreateInstance. Für die Instanziierung eines Objekts dieser Klasse ist ein Methodenaufruf eines anderen Objekts erforderlich. Beispielsweise ist in Microsoft Excel das Objekt "Cell" nicht erstellbar und muss aus einem Microsoft Excel Worksheet-Objekt abgerufen werden.

Methoden, die Instanzen von nicht erstellbaren Klassen zurückgeben, sollten den genauen Typ des Objekts zurückgeben, anstatt VARIANT - oder IDispatch*-Typen.

Typeflag-Darstellung:

Das Fehlen von TYPEFLAG_FCANCREATE.

Beispiele

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

Weitere Informationen

coclass

ODL-Dateisyntax

ODL-Dateibeispiel

Generieren einer Typbibliothek mit MIDL