atributo noncreatable

  • Artigo

O atributo [nãocreatável] define um objeto que não pode ser instanciado por si só.

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

Parâmetros

coclass-attribute-list

Outros atributos que se aplicam à classe .

coclass-name

O nome da classe.

coclass-interface-list

Uma lista de interfaces para a classe .

Comentários

Use o atributo [nãocreatável] em uma instrução coclass para indicar aos usuários que eles não podem criar um novo objeto dessa classe no nível superior, ou seja, chamando CreateInstance ou CoCreateInstance. A instanciação de um objeto dessa classe requer uma chamada de método para outro objeto. Por exemplo, no Microsoft Excel, o objeto "Cell" não pode sercriável e deve ser obtido de um objeto Worksheet do Microsoft Excel.

Métodos que retornam instâncias de classes nãocretáveis devem retornar o tipo exato do objeto, em vez de tipos VARIANT ou IDispatch*.

Representação de typeflag:

A ausência de TYPEFLAG_FCANCREATE.

Exemplos

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

Confira também

coclass

Sintaxe de arquivo ODL

Exemplo de arquivo ODL

Gerando uma biblioteca de tipos com MIDL