TN023: recursos MFC padrão

Esta nota descreve os recursos padrão fornecidos e necessários pela biblioteca MFC.

Recursos padrão

O MFC oferece duas categorias de recursos predefinidos que você pode usar em seu aplicativo: recursos de clip-art e recursos de estrutura padrão.

Os recursos de clip-art são recursos adicionais dos quais a estrutura não depende, mas que talvez você queira adicionar à interface do usuário do aplicativo. Os seguintes recursos de clip-art estão contidos no CLIPART de exemplo geral do MFC:

• Common.rc: um só arquivo de recursos que contém:

  • Uma grande coleção de ícones que representam uma variedade de tarefas comerciais e de processamento de dados.

  • Vários cursores comuns (confira também Afxres.rc).

  • Um bitmap da barra de ferramentas que contém vários botões da barra de ferramentas.

  • O bitmap e os recursos de ícone usados pelo Commdlg.dll.

• Indicate.rc: contém recursos de cadeia de caracteres para os indicadores de estado-chave da barra de status, como "CAP" para Caps Lock.

• Prompts.rc: contém recursos de cadeia de caracteres de prompt de menu para cada comando predefinido, como "Criar um documento" para ID_FILE_NEW.

• Commdlg.rc: um arquivo .rc compatível com Visual C++ que contém os modelos de diálogo COMMDLG padrão.

Os recursos da estrutura padrão são recursos com IDs definidas por AFX das quais a estrutura depende para implementações internas. Você raramente precisará alterar esses recursos definidos pelo AFX. Se você fizer isso, deverá seguir o procedimento descrito posteriormente neste tópico.

Os seguintes recursos de estrutura estão contidos no diretório MFC\INCLUDE:

• Afxres.rc: recursos comuns usados pela estrutura.

• Afxprint.rc: recursos específicos para impressão.

• Afxolecl.rc: recursos específicos para aplicativos cliente OLE.

• Afxolev.rc: recursos específicos para aplicativos completos do servidor OLE.

Como usar recursos Clip-Art

Para usar um recurso binário clip-art

1. Abra o arquivo de recurso do aplicativo no Visual C++.

2. Abra Common.rc. Esse arquivo contém todos os recursos binários de clip-art. Isso pode levar algum tempo porque o arquivo Common.rc é compilado.

3. Mantenha pressionada a tecla CTRL enquanto arrasta os recursos que deseja usar do Common.rc para o arquivo de recurso do aplicativo.

Para usar outros recursos de clip-art, siga as mesmas etapas. A única diferença é que você abrirá o arquivo .rc apropriado, em vez de Common.rc.

Observação

Tenha cuidado para não mover por engano os recursos para fora do Common.rc permanentemente. Se você segurar a tecla CTRL enquanto arrasta recursos, criará uma cópia. Se você não segurar CTRL enquanto arrasta, os recursos serão movidos. Se você estiver preocupado que possa ter feito alterações por engano no arquivo Common.rc, clique em "Não" quando for perguntado se você deve salvar as alterações no Common.rc.

Observação

Os arquivos de recurso .rc têm um recurso TEXTINCLUDE especial que impedirá que você salve por engano sobre os arquivos .rc padrão.

Como personalizar recursos da Estrutura Padrão

Os recursos de estrutura padrão geralmente são incluídos em um aplicativo usando o comando #include no arquivo de recurso de um aplicativo. O AppWizard gerará um arquivo de recurso. Esse arquivo inclui os recursos de estrutura padrão apropriados, dependendo das opções do AppWizard selecionadas. Você pode examinar, adicionar ou remover os recursos incluídos alterando as diretivas de tempo de compilação. Para fazer isso, abra o menu Recurso e selecione Definir inclusões. Examine o item de edição "Diretivas de Tempo de Compilação". Por exemplo:

#include "afxres.rc"
#include "afxprint.rc"

O caso mais comum de personalização de recursos de estrutura padrão é adicionar ou remover inclusões para impressão, cliente OLE e suporte ao Servidor OLE.

Em alguns casos raros, talvez você queira personalizar o conteúdo dos recursos da estrutura padrão para seu aplicativo específico, não apenas adicionar e remover todo o arquivo. As seguintes etapas mostram como você pode limitar os recursos incluídos:

Para personalizar o conteúdo de um arquivo de recurso padrão

1. Abra o arquivo de recurso no Visual C++.

2. Usando o comando Resource Set Includes, remova o #include para o arquivo .rc padrão que você deseja personalizar. Por exemplo, para personalizar a barra de ferramentas de pré-visualização de impressão, remova a linha #include "afxprint.rc".

3. Abra os arquivos de recursos padrão apropriados no MFC\INCLUDE. Seguindo o exemplo anteriormente neste tópico, o arquivo apropriado é MFC\Include\Aafxprint.rc

4. Copie todos os recursos do arquivo .rc padrão para o arquivo de recurso do aplicativo.

5. Modifique a cópia dos recursos padrão no arquivo de recurso do aplicativo.

Observação

Não modifique os recursos diretamente nos arquivos .rc padrão. Isso modificará os recursos disponíveis em cada aplicativo, não apenas no que você está trabalhando no momento.

Confira também

Observações técnicas por número
Observações técnicas por categoria