noncreatable (attribut)

Article
06/13/2023

L’attribut [noncréable] définit un objet qui ne peut pas être instancié par lui-même.

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

Paramètres

coclass-attribute-list: Autres attributs qui s’appliquent à la classe .
coclass-name: Nom de la classe.
coclass-interface-list: Liste des interfaces pour la classe .

Notes

Utilisez l’attribut [noncreatable] sur une instruction de coclasse pour indiquer aux utilisateurs qu’ils ne peuvent pas créer un objet de cette classe au niveau supérieur, c’est-à-dire en appelant CreateInstance ou CoCreateInstance. L’instanciation d’un objet de cette classe nécessite un appel de méthode à un autre objet. Par exemple, dans Microsoft Excel, l’objet « Cell » n’est pascreatable et doit être obtenu à partir d’un objet Feuille de calcul Microsoft Excel.

Les méthodes qui retournent des instances de classes noncréables doivent retourner le type exact de l’objet, plutôt que les types VARIANT ou IDispatch*.

Représentation typeflag :

Absence de TYPEFLAG_FCANCREATE.

Exemples

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

Voir aussi

coclasse
Syntaxe de fichier ODL
Exemple de fichier ODL
Génération d’une bibliothèque de types avec MIDL

Partager via