Partilhar via


Como: criar recursos (C++)

Você pode criar recursos para seu projeto:

  • Usando um arquivo de script de recurso.

    Observação

    Essa etapa é necessária antes de adicionar recursos.

  • Adicionando recursos ao seu projeto e usando o Modo de Exibição de Recursos.

  • Usando um modelo de recurso para criar recursos personalizados.

Usar arquivos de script de recurso

Antes de criar e adicionar novos recursos ao seu projeto, você deve primeiro criar um arquivo de script de recurso (.rc).

Observação

Você só pode adicionar um arquivo de script de recurso a um projeto existente carregado no IDE do Visual Studio. Você não pode criar um script de recurso autônomo fora do projeto, embora arquivos de modelo de recurso (.rct) possam ser criados a qualquer momento.

Para criar um arquivo de script de recurso

  1. Coloque o foco na pasta de projeto existente em Gerenciador de Soluções, por exemplo, MyProject.

    Observação

    Não confunda a pasta do projeto com a pasta da solução em Gerenciador de Soluções. Se você colocar o foco na pasta Solução, não terá as mesmas opções Adicionar Novo Item.

  2. No menu, vá para Projeto>Adicionar novo item.

  3. Selecione a pasta Visual C++ e escolha Arquivo de Recurso (.rc) no painel direito.

  4. Forneça um nome para o arquivo de script de recurso na caixa de texto Nome e selecione Abrir.

Para abrir um arquivo de script de recurso

Você pode exibir recursos em um arquivo de script de recurso sem ter um projeto aberto. O arquivo de script é aberto em uma janela de documento em vez do Modo de Exibição de Recursos.

Observação

Alguns comandos só estarão disponíveis se o arquivo for aberto autônomo, o que significa que fora de um projeto sem primeiro carregar o projeto. Por exemplo, para usar o comando Salvar como e salvar um arquivo com um formato ou nome de arquivo diferente, o arquivo deve ser aberto autônomo.

  • Para abrir um arquivo de script de recurso fora de um projeto, no menu, vá para Arquivo>Abrir e escolha Arquivo. Navegue até o arquivo de script de recurso, realce o arquivo e escolha Abrir.

    Observação

    Pode haver momentos em que você deseja exibir o conteúdo do arquivo de script de recurso do projeto sem usar os editores de recursos para abrir um recurso. Por exemplo, talvez você queira pesquisar uma cadeia de caracteres em todas as caixas de diálogo no arquivo de recurso sem precisar abrir cada uma separadamente. Você pode abrir facilmente o arquivo de recurso no formato de texto para exibir todos os recursos que ele contém e concluir operações globais compatíveis com o editor de texto.

    Para abrir um arquivo de script de recurso no formato de texto, use a seta suspensa no lado direito do botão Abrir na etapa acima e escolha Abrir com. Selecione o Editor de Código-Fonte (Texto) e, na lista suspensa Abrir como, selecione Texto e o recurso será aberto no editor de Código-Fonte.

  • Para abrir vários scripts de recurso, siga a mesma etapa acima para cada arquivo que você deseja abrir, por exemplo, Source1.rc e Source2.rc. Em seguida, quando ambos os arquivos .rc estiverem abertos em janelas de documentos separadas, use o menu Janela ou clique com o botão direito do mouse em um dos arquivos e escolha Novo Grupo de Guias Horizontais ou Novo Grupo de Guias Verticais. As janelas agora estão em bloco para que você possa exibi-las simultaneamente.

Dica

Você pode abrir arquivos de script de recurso clicando com o botão direito do mouse no arquivo .rc em Gerenciador de Soluções, selecionando Abrir com e escolhendo o Editor de Código-Fonte (Texto).

Quando você cria um aplicativo de Classe do Microsoft Foundation (MFC) para Windows usando o assistente de aplicativo MFC, o assistente gera um conjunto básico de arquivos, incluindo um arquivo de script de recurso (.rc) que contém os principais recursos do MFC. No entanto, esses recursos específicos do MFC não estão disponíveis ao editar um arquivo .rc para aplicativos Windows que não se baseiam no MFC. Isso inclui assistentes de código, cadeias de caracteres de prompt de menu, conteúdo de lista para controles de caixa de combinação e hospedagem de controle ActiveX.

  • Para adicionar suporte ao MFC, com o arquivo de script de recurso aberto, no Modo de Exibição de Recursos, realce a pasta de recursos (por exemplo, MFC.rc). Em seguida, no janela Propriedades, defina o Modo MFC como True.

    Observação

    Além de definir o Modo MFC, o arquivo .rc deve fazer parte de um projeto MFC. Apenas a configuração do Modo MFC como True em um arquivo .rc em um projeto Win32 não fornecerá recursos MFC.

Criar recursos

Você pode criar um recurso como um novo recurso padrão, o que significa um recurso que não é baseado em um modelo ou como um recurso padronizado após um modelo.

Use a janela Modo de Exibição de Recursos para exibir arquivos de recursos incluídos em seus projetos. Expandir a pasta superior, por exemplo, Project1.rc, mostra os tipos de recursos dentro desse arquivo. Expanda cada tipo de recurso para mostrar os recursos individuais desse tipo.

Dica

Para abrir a janela Modo de Exibição de Recursos, acesse o menu Exibir> Outro Windows> Modo de Exibição de Recursos ou pressione Ctrl+Shift+E.

Você também pode usar o botão direito do mouse na janela Modo de Exibição de Recursos para iniciar um menu de atalho de comandos ou clicar duas vezes na barra de título para encaixar e desencaixar a janela. Clique com o botão direito do mouse na barra de título para comandos que controlam o comportamento da janela. Para mais informações, confira Gerenciamento do Windows.

As janelas do Modo de Exibição de Recursos incluem a caixa de diálogo Adicionar Recurso com as seguintes propriedades para adicionar recursos a um projeto de aplicativo da área de trabalho do Windows C++:

Propriedade Descrição
Tipo de recurso Especifique o tipo de recurso que você deseja criar.

Você pode expandir as categorias de recurso do cursor e da caixa de diálogo para revelar recursos adicionais, que estão localizados em ..\Microsoft Visual Studio <version>\VC\VCResourceTemplates\<LCID>\mfc.rct. Se você precisar adicionar arquivos .rct, coloque-os aqui ou especifique outro caminho de inclusão. Os recursos mostrados no nível superior no controle de árvore são os recursos padrão fornecidos pelo Visual Studio. Os recursos em arquivos .rct aparecem no segundo nível na categoria apropriada. Não há nenhum limite predefinido para o número de arquivos .rct que você pode adicionar.

Novo Crie um recurso com base no tipo selecionado na caixa Tipo de Recurso e abra o recurso no editor apropriado.

Por exemplo, se você criar um recurso de caixa de diálogo, ele abrirá o recurso no Editor de Caixa de Diálogo.
Importaçãoação Abra a caixa de diálogo Importar para navegar até o recurso que você deseja importar para o projeto atual.

Você pode importar um bitmap, ícone, cursor, HTML, som (. WAV) ou arquivo de recurso personalizado.
Personalizado Abra a caixa de diálogo Novo Recurso Personalizado para criar um recurso personalizado.

Também inclui uma propriedade Tipo de Recurso que fornece uma caixa de texto para você inserir o nome do tipo de recurso personalizado. O Visual C++ capitaliza automaticamente o nome quando você sai. Os recursos personalizados são editados apenas no Editor Binário.

Quando você cria um novo recurso, o Visual C++ atribui um nome exclusivo a ele, por exemplo, IDD_Dialog1. Você pode personalizar essa ID de recurso editando as propriedades do recurso no editor de recursos associado ou na janela Propriedades.

Observação

Não especifique um nome de recurso ou ID reservado pelo Visual Studio. Os nomes reservados são DESIGNINFO, HWB e TEXTINCLUDE, e a ID reservada é 255.

Para criar um recurso

  • No Modo de Exibição de Recursos, selecione o arquivo .rc e, em seguida, use Editar>Adicionar Recurso e escolha o tipo de recurso a ser adicionado ao seu projeto.

    Dica

    Você também pode clicar com o botão direito do mouse no arquivo .rc no Modo de Exibição de Recursos e escolher Adicionar Recurso no menu de atalho.

  • Em Gerenciador de Soluções, clique com o botão direito do mouse na pasta do projeto, selecione Adicionar>Adicionar Recurso e escolha o tipo de recurso a ser adicionado ao projeto.

    Observação

    Se você ainda não tiver um arquivo .rc em seu projeto, essa etapa criará um. Em seguida, você pode repetir essa etapa para adicionar tipos de recursos específicos ao novo arquivo .rc.

  • No Modo de Exibição de Classe, clique com o botão direito do mouse no projeto, selecione Adicionar>Adicionar Recurso e escolha o tipo de recurso a ser adicionado ao projeto.

  • Use o menu Projeto>Adicionar Recurso.

usar modelos de recursos

Um modelo de recurso é um recurso personalizado que você salvou como um arquivo .rct. Em seguida, um modelo de recurso serve como um ponto de partida para a criação de recursos. Modelos de recurso economizam tempo no desenvolvimento de recursos adicionais ou grupos de recursos que compartilham recursos, como controles padrão ou elementos repetidos. Por exemplo, se você quiser incluir um botão de ajuda com um ícone de logotipo da empresa em várias caixas de diálogo, crie um novo modelo de caixa de diálogo e personalize-o com o botão de ajuda e o logotipo.

Depois de personalizar um modelo de recurso, salve suas alterações na pasta de modelo ou no local especificado no caminho de inclusão, para que o novo modelo de recurso apareça em seu tipo de recurso na caixa de diálogo Adicionar Recurso. Agora você pode usar o novo modelo de recurso sempre que necessário.

Observação

O editor de recursos fornece automaticamente uma ID de recurso exclusiva. Você pode revisar as propriedades do recurso conforme necessário.

Observação

Coloque arquivos de modelo específicos do idioma em subdiretórios do diretório principal do modelo. Por exemplo, os arquivos de modelo somente em inglês entram em .. \<diretório de modelo de recurso>\1033.

O Visual Studio procura novos arquivos .rct em \Program Files\Microsoft Visual Studio <versão>\VC\VCResourceTemplates, \Program Files\Microsoft Visual Studio <versão>\VC\VCResourceTemplates\<LCID> (como um LCID de 1033 para inglês) ou em qualquer lugar no caminho de inclusão. Se você preferir armazenar seus arquivos .rct em outro local, deverá adicionar o local ao caminho de inclusão.

Para criar e usar um modelo de recurso

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Adicionar>Adicionar Novo Item.

  2. No painel Modelos: selecione Arquivo de Modelo de Recurso (.rct).

  3. Forneça um nome e um local para o novo arquivo .rct e escolha Abrir.

    O novo arquivo .rct é adicionado ao seu projeto e aparece em Gerenciador de Soluções na pasta Recursos.

  4. Clique duas vezes no arquivo .rct para abri-lo em uma janela de documento. Para adicionar recursos, clique com o botão direito do mouse no arquivo na janela do documento e escolha Adicionar Recurso.

    Você pode personalizar seus recursos adicionados e salvar o arquivo .rct.

  5. No painel Modo de Exibição de Recursos, clique com o botão direito do mouse no arquivo .rc e escolha Adicionar Recurso.

  6. Selecione o sinal de adição (+) ao lado de um recurso para expandir o nó de recurso e exibir os modelos disponíveis para esse recurso.

  7. Clique duas vezes no modelo que você deseja usar.

    Você pode modificar o recurso adicionado conforme necessário em seu editor de recursos.

Para converter um arquivo de recurso existente para um modelo

Com o arquivo de script de recurso aberto, no menu, vá para Arquivo>Salvar <filename>como. Especifique um local e escolha OK.

Requisitos

Win32

Confira também

Arquivos de recurso
Como: gerenciar recursos
Como incluir recursos em tempo de compilação