TN023: стандартные ресурсы MFC

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

В этом примечании описываются стандартные ресурсы, предоставляемые и необходимые библиотеке MFC.

Стандартные ресурсы

MFC предлагает две категории предопределенных ресурсов, которые можно использовать в вашем приложении: клипарт и стандартные ресурсы фреймворка.

Ресурсы клип-арта — это дополнительные ресурсы, от которых фреймворк не зависит, но которые вы можете захотеть добавить в пользовательский интерфейс приложения. Следующие ресурсы клип-арта содержатся в общем примере MFC CLIPART:

  • Common.rc: один файл ресурсов, содержащих:

    • Большая коллекция значков, представляющих различные бизнес-задачи и задачи обработки данных.

    • Несколько распространенных курсоров (см. также Afxres.rc).

    • Растровое изображение панели инструментов, содержащее несколько кнопок панели инструментов.

    • Ресурсы растровых изображений и значков, используемые Commdlg.dll.

  • Indicate.rc: содержит строковые ресурсы для индикаторов состояния строки состояния, таких как "CAPS" для Caps Lock.

  • Prompts.rc: содержит ресурсы строк меню для каждой предопределенной команды, например, "Создание нового документа" для ID_FILE_NEW.

  • Commdlg.rc: совместимый с Visual Studio RC-файл, содержащий стандартные шаблоны диалоговых окон COMMDLG.

Стандартные ресурсы платформы — это ресурсы с определяемыми AFX идентификаторами, от которых зависит платформа для внутренних реализаций. Вам редко потребуется изменять эти ресурсы, определенные AFX. При этом следует выполнить процедуру, описанную далее в этом разделе.

Следующие ресурсы платформы содержатся в каталоге MFC\INCLUDE:

  • Afxres.rc: общие ресурсы, используемые платформой.

  • Afxprint.rc: ресурсы, относящиеся к печати.

  • Afxolecl.rc: ресурсы, относящиеся к клиентским приложениям OLE.

  • Afxolev.rc: ресурсы, относящиеся к полным приложениям OLE-сервера.

Использование ресурсов Clip-Art

Использование двоичного ресурса в клип-арте

  1. Откройте файл ресурсов приложения в Visual Studio.

  2. Откройте Common.rc. Этот файл содержит все двоичные ресурсы клип-арта. Это может занять некоторое время, так как файл Common.rc компилируется.

  3. Удерживая клавишу CTRL, перетащите ресурсы, которые вы хотите использовать из Common.rc, в файл ресурсов приложения.

Чтобы использовать другие ресурсы клип-арта, выполните те же действия. Единственное различие заключается в том, что вы откроете соответствующий RC-файл вместо Common.rc.

Замечание

Будьте осторожны, чтобы случайно не переместить ресурсы из Common.rc навсегда. Если при перетаскивании ресурсов удерживается клавиша CTRL, вы создадите копию. Если вы не удерживаете клавиши CTRL во время перетаскивания, ресурсы будут перемещены. Если вы обеспокоены тем, что вы, возможно, случайно внесли изменения в файл Common.rc, нажмите кнопку "Нет", когда вам будет предложено сохранить изменения в Common.rc.

Замечание

В файлах ресурсов .rc есть специальный ресурс TEXTINCLUDE, который предотвратит их случайное перезаписывание поверх стандартных .rc-файлов.

Настройка ресурсов стандартной платформы

Стандартные ресурсы фреймворка обычно включаются в приложение с помощью команды #include в файле ресурсов. AppWizard создаст файл ресурсов. Этот файл включает соответствующие стандартные ресурсы платформы в зависимости от выбранного параметра AppWizard. Вы можете просмотреть, добавить или удалить ресурсы, изменив директивы времени компиляции. Для этого откройте меню "Ресурс" и выберите "Задать включает". Посмотрите элемент редактирования "ДирективаCompile-Time". Рассмотрим пример.

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

Наиболее распространенный случай настройки стандартных ресурсов платформы — добавление или удаление дополнительных компонентов для печати, поддержки OLE Client и OLE Server.

В некоторых редких случаях может потребоваться настроить содержимое стандартных ресурсов платформы для конкретного приложения, а не просто добавить и удалить весь файл. Ниже показано, как ограничить включенные ресурсы:

Настройка содержимого стандартного файла ресурсов
  1. Откройте файл ресурса в Visual Studio.

  2. С помощью команды "Включить набор ресурсов", удалите #include из стандартного .rc-файла, который вы хотите настроить. Например, чтобы настроить панель инструментов предварительного просмотра печати, удалите #include "afxprint.rc" строку.

  3. Откройте соответствующие стандартные файлы ресурсов в MFC\INCLUDE. В соответствии с примером, приведенным ранее в этом разделе, соответствующий файл — MFC\Include\Aafxprint.rc

  4. Скопируйте все ресурсы из стандартного RC-файла в файл ресурса приложения.

  5. Измените копию стандартных ресурсов в файле ресурсов приложения.

Замечание

Не изменяйте ресурсы непосредственно в стандартных RC-файлах. Это приведет к изменению ресурсов, доступных в каждом приложении, а не только в том, над которым вы работаете.

См. также

Технические примечания по номеру
Технические заметки по категориям