component pragma

Controla a coleta de informações de navegação ou informações de dependência de dentro de arquivos de origem.

Sintaxe

#pragma component( browser, { on | off } [ ,references [ ,nome ] ] )
#pragma component( minrebuild, { on | off } )
#pragma component( mintypeinfo, { on | off } )

Comentários

Navegador

Você pode ativar ou desativar a coleta e especificar nomes específicos a serem ignorados à medida que as informações são coletadas.

Usar ativado ou desativado controla a coleta de informações de navegação do pragma em diante. Por exemplo:

#pragma component(browser, off)

Impede que o compilador colete informações de navegação.

A opção references pode ser usada com ou sem o nome argumento. O uso de references sem nome ativa ou desativa a coleta de referências (outras informações de navegação continuam a ser coletadas, no entanto). Por exemplo:

#pragma component(browser, off, references)

Impede que o compilador colete informações de referência.

O uso do references com nome e off impede que referências a nome apareçam na janela de informações de navegação. Use essa sintaxe para ignorar nomes e tipos nos quais você não está interessado e para reduzir o tamanho dos arquivos de informações de navegação. Por exemplo:

#pragma component(browser, off, references, DWORD)

ignora as referências ao DWORD a partir desse ponto. Você pode ativar novamente a coleta de referências ao DWORD usando on:

#pragma component(browser, on, references, DWORD)

Esta é a única forma de voltar a recolher referências a nome; Você deve ativar explicitamente qualquer nome que tenha desativado.

Para evitar que o pré-processador expanda nome (como expandir NULL para 0), coloque aspas em torno dele:

#pragma component(browser, off, references, "NULL")

Reconstrução mínima

O recurso preterido (Enable Minimal Rebuild) requer que o compilador crie e armazene informações de dependência de classe C++, o que ocupa espaço em disco. Para economizar espaço em disco, você pode usá#pragma component( minrebuild, off ) sempre que não precisar coletar informações de dependência, por exemplo, em arquivos de cabeçalho inalterados. Insira #pragma component( minrebuild, on ) depois de desalterar as classes para ativar novamente a coleta de dependência.

Reduzir informações de tipo

A opção mintypeinfo reduz as informações de depuração para a região especificada. O volume dessas informações é considerável, afetando os arquivos .pdb e .obj. Não é possível depurar classes e estruturas na região mintypeinfo. O uso da opção mintypeinfo pode ser útil para evitar o seguinte aviso:

LINK : warning LNK4018: too many type indexes in PDB "filename", discarding subsequent type information

Para obter mais informações, consulte a opção /Gm (Enable Minimal Rebuild) compilador.

Ver também

diretivas Pragma e as palavras-chave __pragma e _Pragma