Практическое руководство. Включение ресурсов во время компиляции (C++)

Статья
10/12/2023

По умолчанию все ресурсы находятся в одном файле скрипта ресурсов (RC), однако существует множество причин размещения ресурсов в файле, отличном от основного RC-файла:

Добавление комментариев в инструкции ресурсов, которые не будут удалены при сохранении RC-файла.
Для включения ресурсов, которые уже разработаны и протестированы, и не требуются дальнейшие изменения. Все файлы, включенные, но не имеющие расширения RC, не будут изменяться редакторами ресурсов.
Для включения ресурсов, используемых различными проектами, или которые являются частью системы управления версиями исходного кода. Эти ресурсы должны существовать в центральном расположении, где изменения будут влиять на все проекты.
Чтобы включить ресурсы (например, ресурсы RCDATA), которые являются пользовательским форматом. Ресурсы RCDATA имеют особые требования, в которых нельзя использовать выражение в качестве значения для nameID поля.

Если у вас есть разделы в существующих RC-файлах, которые соответствуют любому из этих условий, поместите эти разделы в один или несколько отдельных RC-файлов и включите их в проект с помощью диалогового окна "Включение ресурсов".

Включаемая в ресурс

Вы можете добавлять ресурсы из других файлов в проект во время компиляции, перечисляя их в поле директив времени компиляции в диалоговом окне "Включение ресурсов". Используйте диалоговое окно "Включить ресурсы", чтобы изменить нормальное рабочее расположение среды проекта для хранения всех ресурсов в файле RC-файла проекта и всех символов.Resource.h

Чтобы приступить к работе, откройте диалоговое окно "Включает ресурсы", щелкнув правой кнопкой мыши RC-файл в представлении ресурсов, выберите "Включить ресурс" и запишите следующие свойства:

Свойство	Description
Файл заголовка символов	Позволяет изменить имя файла заголовка, в котором хранятся определения символов для файлов ресурсов. Дополнительные сведения см. в разделе "Изменение имен файлов заголовков символов".
Директивы символов только для чтения	Позволяет включать файлы заголовков, содержащие символы, которые не должны быть изменены. Например, файлы символов для совместного использования с другими проектами. Это также может включать H-файлы MFC. Дополнительные сведения см. в разделе "Включение общих (только для чтения) или вычисляемых символов.
Директивы времени компиляции	Позволяет включать файлы ресурсов, которые создаются и редактируются отдельно от ресурсов в основном файле ресурсов, содержат директивы времени компиляции (например, те директивы, которые условно включают ресурсы) или содержат ресурсы в пользовательском формате. Можно также использовать поле директив времени компиляции для включения стандартных файлов ресурсов MFC.

Примечание.

Записи в этих текстовых полях отображаются в RC-файле, TEXTINCLUDE 1TEXTINCLUDE 2помеченном ,и TEXTINCLUDE 3 соответственно. Дополнительные сведения см. в разделе TN035: использование нескольких файлов ресурсов и файлов заголовков с Помощью Visual C++.

После внесения изменений в файл ресурса с помощью диалогового окна "Включает ресурсы" необходимо закрыть и повторно открыть RC-файл , чтобы изменения вступили в силу.

Включение ресурсов в проект во время компиляции

Поместите ресурсы в файл описания ресурсов с уникальным именем. Не используйте projectname.rc, так как это имя файла, используемого для файла скрипта основного ресурса.
Щелкните правой кнопкой мыши RC-файл в представлении ресурсов и выберите "Включает ресурс".
В поле директив времени компиляции добавьте директиву компилятора #include, чтобы включить новый файл ресурсов в основной файл ресурсов в среду разработки.

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

Указание каталогов для определенного файла ресурса (RC)

Щелкните правой кнопкой мыши RC-файл в Обозреватель решений и выберите "Свойства".
Выберите узел Resources в левой области и укажите дополнительные каталоги включения в свойство "Дополнительно включить каталоги".

Поиск символов в ресурсах

Перейдите в меню "Изменить>символ поиска".

Совет

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

Примечание.

Нельзя выполнять поиск символов в строках, сочетаниях клавиш и двоичных ресурсах.

Требования

Win32

См. также

Файлы ресурсов
Практическое руководство. Создание ресурсов
Практическое руководство. Управление ресурсами

Поделиться через