Atributos por uso

Este tópico lista atributos de acordo com os elementos da linguagem C++ aos quais eles se aplicam.

Se um atributo precede um elemento que não está no escopo do atributo, o bloco de atributo é tratado como um comentário.

Atributo	Descrição
Atributos do módulo	Aplica-se ao atributo module .
Atributos da interface	Aplica-se à palavra-chave __interface C++.
Atributos de classe	Aplica-se à palavra-chave C++.
Atributos do método	Aplica-se aos métodos em uma classe, coclasse ou interface.
Atributos de parâmetro	Aplica-se a parâmetros de um método em uma classe ou interface.
Atributos do membro de dados	Aplica-se aos membros de dados em uma classe, coclasse ou interface.
Atributos Typedef, Enum, Union e Struct	Aplica-se às palavras-chave C++.
atributos de matriz	Aplica-se a matrizes e aos SAFEARRAYs.
Stand-Alone Atributos	Opera mais como uma linha de código, mas não opera em uma palavra-chave C++. As declarações de atributo autónomas exigem um ponto-e-vírgula no final da linha.
Atributos personalizados	Permite que o usuário estenda metadados.

Atributos do módulo

O atributo a seguir só pode ser aplicado ao atributo module .

Atributo	Descrição
helpstringdll	Especifica o nome da DLL a ser usada para executar a pesquisa de cadeia de caracteres de documento (localização).

Atributos da interface

Os atributos a seguir se aplicam à palavra-chave C++ da interface (ou __interface).

Atributo	Descrição
async_uuid	Especifica o UUID que direciona o compilador MIDL para definir versões síncronas e assíncronas de uma interface COM.
personalizados	Permite definir seus próprios atributos.
Dispinterface	Insere uma interface no arquivo .idl como uma interface de despacho.
duplo	Coloca uma interface no ficheiro .idl como uma interface dupla.
exportação	Faz com que uma estrutura de dados seja colocada no arquivo .idl.
helpcontext	Especifica uma ID de contexto que permite ao usuário exibir informações sobre esse elemento no arquivo de Ajuda.
ficheiro de ajuda	Define o nome do arquivo de Ajuda para uma biblioteca de tipos.
helpstring	Especifica uma cadeia de caracteres usada para descrever o elemento ao qual ela se aplica.
helpstringcontext	Especifica a ID de um tópico de ajuda em um arquivo .hlp ou .chm.
helpstringdll	Especifica o nome da DLL a ser usada para executar a pesquisa de cadeia de caracteres de documento (localização).
escondido	Indica que o item existe, mas não deve ser exibido em um navegador orientado ao usuário.
bloco_da_biblioteca	Coloca um elemento dentro do bloco de biblioteca do ficheiro .idl.
local	Permite que você use o compilador MIDL como um gerador de cabeçalho quando usado no cabeçalho da interface. Quando usado em uma função individual, designa um procedimento local para o qual não são gerados stubs.
não extensível	Especifica que a IDispatch implementação inclui apenas as propriedades e métodos listados na descrição da interface e não pode ser estendida com membros adicionais em tempo de execução. Este atributo só é válido em uma interface dupla .
ODL	Identifica uma interface como uma interface ODL (Object Description Language).
objeto	Identifica uma interface personalizada.
Automação OleAutomation	Indica que uma interface é compatível com automação.
pointer_default	Especifica o atributo de ponteiro padrão para todos os ponteiros, exceto ponteiros de nível superior que aparecem em listas de parâmetros.
ptr	Designa um ponteiro como um ponteiro completo.
restrito	Designa quais membros da biblioteca não podem ser chamados arbitrariamente.
UUID	Fornece a ID exclusiva para a biblioteca

Você deve observar estas regras para definir uma interface:

• A convenção de chamada padrão é __stdcall.

• Um GUID é fornecido para você se você não fornecer um.

• Não são permitidos métodos sobrecarregados.

Quando não se especifica o atributo uuid e se usa o mesmo nome de interface em diferentes projetos de atributo, o mesmo GUID é gerado.

Ver também

Atributos C++ para COM e .NET
Atributos por Grupo
Referência alfabética de atributos