Partilhar via


Como criar recursos (C++)

Você pode criar recursos para seu projeto:

  • Usando um arquivo de script de recurso.

    Observação

    Esta etapa é necessária antes de adicionar recursos.

  • Adicionar recursos ao seu projeto e usar 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. Não é possível criar um script de recurso autônomo fora do projeto, embora os arquivos de modelo de recurso (.rct) possam ser criados a qualquer momento.

Para criar um arquivo de script de recurso

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

    Observação

    Não confunda a pasta do projeto com a pasta da solução no 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 Project>Add New 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 ficheiro de script de recursos

Você pode exibir recursos em um arquivo de script de recurso sem ter um projeto aberto. O ficheiro de script é aberto numa janela de documentos, em vez de na Vista de Recursos.

Observação

Alguns comandos só estão disponíveis se o arquivo for aberto de forma autônoma, ou seja, 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 de forma autônoma.

  • Para abrir um arquivo de script de recurso fora de um projeto, no menu, vá para Arquivo> 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ê queira exibir o conteúdo do arquivo de script de recurso do seu projeto sem usar os editores de recursos para abrir um recurso. Por exemplo, talvez você queira procurar uma cadeia de caracteres em todas as caixas de diálogo no arquivo de recurso sem precisar abrir cada uma separadamente. Você pode facilmente abrir o arquivo de recurso em formato de texto para visualizar todos os recursos que ele contém e concluir as operações globais suportadas pelo editor de texto.

    Para abrir um arquivo de script de recurso em formato de texto, use a seta suspensa no lado direito do botão Abrir na etapa acima e escolha Abrir com. Selecione 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 recursos, 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 Horizontal ou Novo Grupo de Guias Verticais. As janelas agora estão em mosaico para que possas visualizá-las simultaneamente.

Sugestão

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

Quando você cria um aplicativo Microsoft Foundation Class (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 do Windows não baseados no MFC. Isso inclui assistentes de código, cadeias de caracteres para sugestões de menu, conteúdos de lista para controlos de caixa de combinação e hospedagem de controlos ActiveX.

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

    Observação

    Além de definir o modo MFC, o arquivo .rc deve fazer parte de um projeto MFC. Somente definir o 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, ou seja, um recurso que não se baseia 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.

Sugestão

Para abrir a janela Vista de Recursos, vá ao menu Vista>Outras Janelas>Vista de Recursos ou pressione Ctrl+Shift+E.

Você também pode clicar com 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 obter mais informações, consulte Gerenciamento do Windows.

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

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

Você pode expandir as categorias de recursos do cursor e da caixa de diálogo para revelar recursos adicionais, que estão localizados em ..\Microsoft Visual Studio <versão>\VC\VCResourceTemplates\<LCID>\mfc.rct. Se você precisar adicionar arquivos .rct, coloque-os aqui ou especifique outro caminho de inclusão. Recursos mostrados no nível superior no controle de árvore são os recursos padrão fornecidos pelo Visual Studio. Recursos em arquivos .rct aparecem no segundo nível sob a categoria apropriada. Não há 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 diálogo, ele abrirá o recurso no Editor de diálogo.
Importação Abra a caixa de diálogo Importar para navegar até o recurso que você deseja importar para seu 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 Resource Type que fornece uma caixa de texto para você inserir o nome do tipo de recurso personalizado. Visual C++ automaticamente capitaliza o nome quando você sair. Os recursos personalizados só são editados 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 esse 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, HWBe , e TEXTINCLUDEo ID reservado é 255.

Para criar um recurso

  • Na Vista de Recurso, selecione o ficheiro .rc e, em seguida, utilize Editar>Adicionar Recurso e escolha o tipo de recurso a adicionar ao seu projeto.

    Sugestão

    Também pode clicar com o botão direito do rato no ficheiro .rc na Vista de Recursos e escolher Adicionar Recurso no menu de atalho.

  • No 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 seu projeto.

    Observação

    Se você ainda não tiver um arquivo .rc em seu projeto, esta etapa criará um. Em seguida, você pode repetir esta 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 seu 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. Um modelo de recurso serve como ponto de partida para a criação de recursos. Os modelos de recursos 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 as alterações na pasta do modelo ou no local especificado no caminho de inclusão, para que o novo modelo de recurso apareça sob 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 um ID de recurso exclusivo. 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 de modelos principal. Por exemplo, os arquivos de modelo somente em inglês vão no .. \<diretório de modelos de recursos>\1033.

O Visual Studio procura novos arquivos .rct em \Arquivos de Programas\Microsoft Visual Studio <version>\VC\VCResourceTemplates, \Program Files\Microsoft Visual Studio <version>\VC\VCResourceTemplates\<LCID> (como um LCID de 1033 para inglês) ou em qualquer lugar no caminho de inclusão. Se preferir armazenar seus arquivos .rct em outro local, você deve 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 em seu projeto e selecione Adicionar>Novo Item.

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

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

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

  4. Clique duas vezes no arquivo .rct para abri-lo em uma janela do 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 Recurso , 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ó do recurso e exibir os modelos disponíveis para esse recurso.

  7. Clique duas vezes no modelo que deseja usar.

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

Para converter um arquivo de recurso existente em um modelo

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

Requerimentos

Win32

Ver também

Arquivos de recursos
Como: Gerenciar recursos
Como: Incluir recursos em tempo de compilação