emitidl
Especifica se todos os atributos IDL subsequentes são processados e colocados no arquivo .idl gerado.
Sintaxe
[ emitidl(state, defaultimports=boolean) ];
Parâmetros
state
Um destes valores possíveis: true
, false
, forced
, restricted
, push
ou pop
.
Se for
true
, todo atributo de categoria IDL encontrado em um arquivo de código-fonte é colocado no arquivo .idl gerado. Essa é a configuração padrão para emitidl.Se for
false
, todo atributo de categoria IDL encontrado em um arquivo de código-fonte não é colocado no arquivo .idl gerado.Se for
restricted
, permite que os atributos IDL estejam no arquivo sem um atributo de módulo. O compilador não gera um arquivo .idl.Se for
forced
, substitui um atributorestricted
subsequente, o que requer que um arquivo tenha um atributomodule
se houver atributos IDL no arquivo.push
permite salvar as configurações atuais de emitidl em uma pilha de emitidl interna epop
permite que você defina emitidl como o valor que estiver na parte superior da pilha emitidl interna.
defaultimports=
booliano (opcional)
Se booleano for
true
, docobj.idl será importado para o arquivo .idl gerado. Além disso, se um arquivo .idl com o mesmo nome de um arquivo .h que você#include
no código-fonte for encontrado no mesmo diretório que o arquivo .h, o arquivo .idl gerado conterá uma instrução de importação para esse arquivo .idl.Se booleano for
false
, docobj.idl será importado para o arquivo .idl gerado. Você deve importar explicitamente arquivos .idl com importação.
Comentários
Depois que o atributo C++ emitidl é encontrado em um arquivo de código-fonte, os atributos de categoria IDL são colocados no arquivo .idl gerado. Se não houver nenhum atributo emitidl, os atributos IDL no arquivo de código-fonte serão gerados para o arquivo .idl gerado.
É possível ter vários atributos emitidis em um arquivo de código-fonte. Se [emitidl(false)];
for encontrado em um arquivo sem um subsequente [emitidl(true)];
, nenhum atributo será processado no arquivo .idl gerado.
Sempre que o compilador encontra um arquivo novo, o emitidl é implicitamente definido como true
.
Requisitos
Contexto do atributo | Valor |
---|---|
Aplicável ao | Anywhere |
Repetível | Não |
Atributos obrigatórios | Nenhum |
Atributos inválidos | Nenhum |
Para obter mais informações, confira Contextos de Atributo.