Compartilhar via


Atributos da Biblioteca de Tipos

As palavras-chave a seguir especificam informações de biblioteca de tipos dentro do contexto de uma instrução de biblioteca em um arquivo IDL.

Atributo Uso
aggregatable Define a coclasse como objetos de suporte que podem expor diretamente o ponteiro de interface de outro objeto.
appobject Identifica a coclasse como um objeto de aplicativo, que está associado a um aplicativo EXE completo.
bindable Indica que a propriedade dá suporte à associação de dados. Isso permite que o cliente seja notificado sempre que uma propriedade tiver alterado o valor.
coclass Fornece uma listagem das interfaces com suporte para um objeto de componente.
Controle Identifica uma coclasse ou biblioteca como um controle COM, do qual um site de contêiner derivará bibliotecas de tipos adicionais ou classes de objeto de componente.
Personalizado Define um atributo personalizado (um não definido em MIDL).
Padrão Indica que a interface ou dispinterface, definida em uma coclasse, representa a interface padrão.
defaultbind Indica a única propriedade associável que melhor representa o objeto.
defaultcollelem Sinaliza a propriedade como uma função de acessador para um elemento da coleção padrão. Usado para otimização de código do Microsoft Visual Basic.
defaultvalue Permite a especificação de um valor padrão para um parâmetro opcional digitado.
defaultvtable Permite que um objeto tenha duas interfaces de origem diferentes.
dispinterface Define um conjunto de propriedades e métodos nos quais você pode chamar IDispatch::Invoke.
displaybind Indica uma propriedade que deve ser exibida para o usuário como associável.
dllname(str) Define o nome da DLL que contém os pontos de entrada de um módulo.
Dupla Identifica uma interface que expõe propriedades e métodos por meio de IDispatch e diretamente por meio da Vtable.
entry Especifica uma função exportada ou uma constante em um módulo identificando o ponto de entrada na DLL.
Helpcontext Especifica um identificador de contexto que permite que o usuário exiba informações sobre esse elemento no arquivo de Ajuda.
helpfile Define o nome do arquivo de Ajuda para uma biblioteca de tipos.
helpstring Especifica uma cadeia de caracteres que é usada para descrever o elemento ao qual ela se aplica.
helpstringdll Define o nome da DLL a ser usada para executar a pesquisa de cadeia de caracteres do documento.
hidden Indica que o item existe, mas não deve ser exibido em um navegador orientado ao usuário.
id Especifica um DISPID para uma função membro (uma propriedade ou um método, em uma interface ou dispinterface).
immediatebind Indica que o banco de dados será notificado imediatamente de todas as alterações de uma propriedade de um objeto associado a dados.
Lcid Quando aplicado à instrução library , juntamente com um argumento localeID, identifica a localidade de uma biblioteca de tipos ou para um argumento de função e permite que você use caracteres internacionais dentro do bloco de biblioteca. Em uma instrução de biblioteca , a partir do ponto em que o atributo lcid é usado, MIDL aceitará a entrada localizada de acordo com a localidade especificada.
biblioteca Instrui o compilador MIDL a gerar informações de biblioteca de tipos para as interfaces e classes referenciadas dentro da instrução .
Licenciado Indica que a coclasse à qual ela se aplica é licenciada e as instâncias devem ser criadas usando IClassFactory2.
nonbrowsable Indica que a propriedade aparece em um navegador de objetos (que não mostra valores de propriedade), mas não aparece em um navegador de propriedades (que mostra valores de propriedade).
noncreatable Impede que um cliente use a fábrica de classes padrão para criar instâncias de uma interface de objeto.
nonextensible Especifica que a implementação do IDispatch inclui apenas as propriedades e os métodos listados na descrição da interface e não pode ser estendido com membros adicionais em runtime.
oleautomation Indica que uma interface é compatível com a automação.
opcional Especifica um parâmetro opcional para uma função membro.
propget Especifica uma função de acessador de propriedade.
propput Especifica uma função de configuração de propriedade.
propputref Especifica uma função de definição de propriedade que usa uma referência em vez de um valor.
Público Garante que um alias declarado com typedef se torne parte da biblioteca de tipos.
Readonly Proíbe a atribuição de um novo valor a uma variável.
requestedit Indica que a propriedade dá suporte à notificação OnRequestEdit .
restricted Especifica que uma biblioteca ou membro de um módulo, interface ou despinterface não pode ser chamado arbitrariamente.
retval Designa o parâmetro recebe o valor retornado do membro.
Fonte Indica que um membro de uma coclasse, propriedade ou método é uma fonte de eventos.
string Indica que a matriz char unidimensional, wchar_t, byte (ou equivalente) ou o ponteiro para essa matriz deve ser tratado como uma cadeia de caracteres.
uidefault Indica que o tipo de membro de informações de tipo é o membro padrão para exibição na interface do usuário.
usesgetlasterror Especifica que um ponto de entrada de módulo usa SetLastError para retornar códigos de erro e que um chamador pode chamar GetLastError para recuperar o código de erro se houver um erro ao inserir uma função.
uuid Designa um identificador exclusivo para uma biblioteca de tipos, uma coclasse ou uma interface.
vararg Especifica que a função usa um número variável de argumentos.
Versão Identifica uma versão específica de uma biblioteca de tipos.

 

Sintaxe de arquivo ODL

Exemplo de arquivo ODL

Gerando uma biblioteca de tipos com MIDL