Partilhar via

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

  • Last updated on