Como: incluir recursos no tempo de compilação (C++)

Artigo
06/16/2023

Por padrão, todos os recursos estão localizados em um arquivo de script de recurso (.rc), no entanto, há muitos motivos para colocar recursos em um arquivo diferente do arquivo .rc principal:

Para adicionar comentários a instruções de recurso que não serão excluídas quando você salvar o arquivo .rc.
Para incluir recursos que já foram desenvolvidos e testados e não precisam de modificações adicionais. Todos os arquivos incluídos, mas que não têm uma extensão .rc, não serão editados pelos editores de recursos.
Para incluir recursos que estão sendo usados por projetos diferentes ou que fazem parte de um sistema de controle de versão do código-fonte. Esses recursos devem existir em um local central onde as modificações afetarão todos os projetos.
Para incluir recursos (como recursos RCDATA) que são um formato personalizado. Os recursos RCDATA têm requisitos especiais em que você não pode usar uma expressão como um valor para o campo nameID.

Se você tiver seções em seus arquivos .rc existentes que atendam a qualquer uma dessas condições, coloque essas seções em um ou mais arquivos .rc separados e inclua-os em seu projeto usando a caixa de diálogo Inclui recurso.

Recurso Inclui

Você pode adicionar recursos de outros arquivos ao seu projeto no tempo de compilação listando-os na caixa Diretivas de tempo de compilação na caixa de diálogo Recurso inclui . Use a caixa de diálogo Recurso inclui para modificar a disposição de trabalho normal do ambiente de projeto de armazenar todos os recursos no arquivo .rc do projeto e todos os símbolos em Resource.h.

Para começar, abra a caixa de diálogo Recurso inclui clicando com o botão direito do mouse em um arquivo .rc emModo de Exibição de Recursos, selecione Recurso inclui e anote as seguintes propriedades:

Propriedade	Descrição
Arquivo de cabeçalho do símbolo	Permite alterar o nome do arquivo de cabeçalho em que as definições de símbolo para seus arquivos de recurso são armazenadas. Para obter mais informações, consulte Alterar nomes dos arquivos de cabeçalho de símbolo.
Diretivas de símbolo somente leitura	Permite incluir arquivos de cabeçalho que contêm símbolos que não devem ser modificados. Por exemplo, arquivos de símbolo a serem compartilhados com outros projetos. Isso também pode incluir arquivos .h do MFC. Para obter mais informações, consulte Incluir símbolos compartilhados (somente leitura) ou calculados.
Diretivas de tempo de compilação	Permite incluir arquivos de recurso criados e editados separadamente dos recursos em seu arquivo de recurso principal, que contenham diretivas de tempo de compilação (como as diretivas que incluem condicionalmente recursos) ou que contenham recursos em um formato personalizado. Você também pode usar a Caixa de diretivas de tempo de compilação para incluir arquivos de recurso MFC padrão.

Observação

As entradas nessas caixas de texto aparecem no arquivo .rc marcado por TEXTINCLUDE 1, TEXTINCLUDE 2e TEXTINCLUDE 3 respectivamente. Para mais informações, consulte TN035: usar vários arquivos de recurso e arquivos de cabeçalho com o Visual C++.

Depois que as alterações forem feitas no arquivo de recurso usando a caixa de diálogo Recurso inclui , você deverá fechar e reabrir o arquivo .rc para que as alterações tenham efeito.

Para incluir recursos em seu projeto em tempo de compilação

Coloque os recursos em um arquivo de script de recurso com um nome de arquivo exclusivo. Não use projectname.rc, pois esse é o nome do arquivo usado para o arquivo de script de recurso principal.
Clique com o botão direito do mouse no arquivo .rc em Exibição de recursos e selecione Recurso inclui.
Na caixa Diretivas de tempo de compilação, adicione a diretiva do compilador #include para incluir o novo arquivo de recurso no arquivo de recurso principal no ambiente de desenvolvimento.

Os recursos nos arquivos incluídos dessa forma só fazem parte do executável no momento da compilação e não estão disponíveis para edição ou modificação quando você está trabalhando no arquivo .rc principal do projeto. Os arquivos .rc incluídos precisam ser abertos separadamente e todos os arquivos incluídos sem a extensão .rc não poderão ser editados pelos editores de recursos.

Para especificar diretórios de inclusão para um arquivo (.rc) específico

Clique com o botão direito do mouse no arquivo .rc no Gerenciador de soluções e selecione Propriedades.
Selecione o nó Recursos no painel esquerdo e especifique quaisquer diretórios de inclusão adicionais na propriedade Diretórios de inclusão adicionais.

Para localizar símbolos em recursos

Vá para o menu Editar>Localizar Símbolo.

Dica

Para usar expressões regulares em sua pesquisa, selecione Localizar em Arquivos no menu Editar em vez de Localizar Símbolo. Marque a caixa de seleção Usar: expressões regulares na caixa de diálogo Localizar e, na caixa Localizar o Que , você pode escolher uma expressão de pesquisa regular na lista suspensa. Ao selecionar uma expressão nessa lista, ela será substituída como o texto de pesquisa na caixa Localizar o Que .
Na caixa Localizar o Que, selecione uma cadeia de caracteres de pesquisa anterior na lista suspensa ou digite a chave de acelerador que você deseja encontrar, por exemplo, ID_ACCEL1.
Selecione uma das opções Localizar e selecione Localizar Próximo.

Observação

Não é possível pesquisar símbolos em cadeia de caracteres, acelerador ou recursos binários.

Requisitos

Win32

Confira também

Arquivos de recurso
Como: criar recursos
Como: gerenciar recursos

Compartilhar via