Partilhar via


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 atributo restricted subsequente, o que requer que um arquivo tenha um atributo module se houver atributos IDL no arquivo.

  • push permite salvar as configurações atuais de emitidl em uma pilha de emitidl interna e pop 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.

Confira também

Atributos de compilador
Atributos independentes