Arquivos de recurso (C++)

Artigo
06/16/2023

Observação

Como projetos em linguagens de programação do .NET não usam arquivos de script de recurso, você deve abrir seus recursos por meio do Gerenciador de Soluções. Use o Editor de imagens e o Editor binário para trabalhar com arquivos de recursos em projetos gerenciados.

Todos os recursos gerenciados que você deseja editar devem ser recursos vinculados. Os editores de recursos do Visual Studio não oferecem suporte à edição de recursos inseridos.

O termo arquivo de recurso pode se referir a qualquer um dos vários tipos de arquivo, como:

O arquivo de script de recurso (.rc) de um programa.
Um arquivo de modelo de recurso (.rct).
Um recurso individual como um arquivo autônomo. Esse tipo inclui um arquivo bitmap, um ícone ou um cursor referenciado de um arquivo .rc.
Um arquivo de cabeçalho gerado pelo ambiente de desenvolvimento. Esse tipo inclui Resource.h, que é referenciado por meio de um arquivo .rc.

Outros tipos de arquivo, como .exe, .dll e .res, também podem conter recursos que você pode acessar, embora os dois primeiros normalmente não sejam considerados arquivos de recurso.

Você pode trabalhar com arquivos de recursos e recursos de dentro de seu projeto. Você também pode trabalhar com recursos e arquivos de recursos que não fazem parte do projeto atual ou que foram criados fora do ambiente de desenvolvimento do Visual Studio. Por exemplo, você pode:

Trabalhe com arquivos de recursos aninhados e incluídos condicionalmente.
Atualize os recursos ou converta-os no Visual C++.
Importe ou exporte recursos gráficos de ou para o arquivo de recurso atual.
Inclua identificadores compartilhados ou somente leitura (símbolos) que não podem ser modificados pelo ambiente de desenvolvimento.
Inclua recursos em seu arquivo executável (.exe ou .dll) que não precisam de edição (ou não devem ser editados), como recursos compartilhados entre vários projetos.
Inclua tipos de recursos não compatíveis com o ambiente de desenvolvimento.

Para mais informações sobre recursos, confira Como criar recursos, gerenciar recursos e incluir recursos em tempo de compilação.

Recursos editáveis

Os seguintes tipos de arquivos podem ser abertos para editar os recursos que contêm:

Nome do arquivo	Descrição
`.rc`	Arquivos de script de recurso
`.rct`	Arquivos de modelo de recurso
`.res`	Arquivos de recurso
`.resx`	Arquivos de recursos gerenciados
`.exe`	Arquivos executáveis
`.dll`	Arquivos de biblioteca de vínculo dinâmico
`.bmp`, `.ico`, `.dib`, `.cur`	Bitmap, ícone, barra de ferramentas e arquivos de cursor

O ambiente do Visual Studio funciona e afeta os seguintes arquivos ao editar recursos:

Nome do arquivo	Descrição
`Resource.h`	Arquivo de cabeçalho gerado pelo ambiente de desenvolvimento que contém definições de símbolo. Inclua esse arquivo no controle do código-fonte.
`Filename.aps`	Versão binária do arquivo de script de recurso atual usado para carregamento rápido. Os editores de recursos não leem diretamente arquivos `.rc` ou resource.h. O compilador de recursos os compila em arquivos `.aps` que são consumidos pelos editores de recursos. Esse arquivo é uma etapa de compilação e armazena apenas dados simbólicos. Assim como acontece com um processo de compilação normal, as informações que não são simbólicas, como comentários, são descartadas durante o processo de compilação. Sempre que o arquivo `.aps` está fora de sincronia com o arquivo `.rc`, o arquivo `.rc` é regenerado. Por exemplo, quando você Salva, o editor de recursos substitui o arquivo `.rc` e o arquivo `resource.h`. Todas as alterações aos próprios recursos permanecem incorporadas ao arquivo `.rc`, mas os comentários sempre são perdidos quando o arquivo `.rc` é substituído. Para informações sobre como preservar comentários, confira Incluir recursos em tempo de compilação. Normalmente, você não deve incluir o arquivo `.aps` no controle do código-fonte.
`.rc`	Arquivo de script de recurso que contém script para os recursos em seu projeto atual. Esse arquivo é substituído pelo arquivo `.aps` sempre que você salva. Inclua esse arquivo no controle do código-fonte.

Recursos de manifesto

Em projetos de área de trabalho do C++, os recursos de manifesto são arquivos XML que descrevem as dependências que um aplicativo usa. Por exemplo, no Visual Studio, este arquivo de manifesto gerado pelo assistente MFC define qual versão das DLLs de controle comum do Windows o aplicativo deve usar:

<description>Your app description here</description>
<dependency>
    <dependentAssembly>
        <assemblyIdentity
            type="win32"
            name="Microsoft.Windows.Common-Controls"
            version="6.0.0.0"
            processorArchitecture="X86"
            publicKeyToken="6595b64144ccf1df"
            language="*"
        />
    </dependentAssembly>
</dependency>

Para um aplicativo Windows XP ou Windows Vista, o recurso de manifesto deve especificar a versão mais atual dos controles comuns do Windows para o aplicativo usar. O exemplo acima usa a versão 6.0.0.0, que dá suporte ao controle Syslink.

Observação

Você só pode ter um recurso de manifesto por módulo.

Para exibir as informações de versão e tipo contidas em um recurso de manifesto, abra o arquivo em um visualizador XML ou no editor de texto do Visual Studio. Se você abrir um recurso de manifesto do Modo de Exibição de Recursos, o recurso será aberto em formato binário.

Para abrir um recurso de manifesto

Abra seu projeto no Visual Studio e navegue para Gerenciador de Soluções.
Expanda a pasta Arquivos de Recursos e:
- Para abrir no editor de texto, clique duas vezes no arquivo .manifest.
- Para abrir em outro editor, clique com o botão direito do mouse no arquivo .manifest e selecione Abrir com. Especifique o editor a ser usado e selecione Abrir.

Requisitos

Win32

Confira também

Como trabalhar com arquivos de recurso
Identificadores de recursos (símbolos)
Editores de recursos

Compartilhar via