Формирование файла проекта справочной системы
Файл проекта справочной системы содержит параметры ее компиляции и может включать до шести разделов, выполняющих функции, описанные в табл. 12.5.
Таблица 12.5. Разделы файла проекта справочной системы.
| Раздел | Функция |
|---|---|
| [Files] | Определяет список файлов с описанием тем |
| [Options ] | Определяет заголовок справочной системы, а также некоторые другие параметры компиляции |
| [BuildTags] | Определяет список тем, включаемых в справочную систему |
| [Alias] | Определяет псевдонимы тем |
| [Map] | Назначает числовой индекс идентификатору темы |
| [Bitmaps] | Определяет список графических файлов, включаемых в справочную систему |
Раздел [Files]
В разделе [Files] перечисляются файлы в формате RTF, которые включаются в состав справочной системы. Например:
[Files] SALES.RTF; инструкция пользователя EDIT.RTF; инструкция по общим правилам ввода данных
Определение параметров компиляции
Раздел [Options] файла проекта справочной системы содержит описание параметров компиляции. Основные из них следующие:
- TITLE – определяет заголовок окна справочной системы, который должен содержать не более 32 символов;
- COMPRESS – используется для сжатия справочного файла, создаваемого компилятором. Параметр может принимать значение True или False;
- WARNING – определяет количество сообщений об ошибках и предупреждениях, выводимых при компиляции;
- FORCEFONT – данный параметр используется в том случае, если в описании справочной системы использовались шрифты, отсутствующие на компьютере, где будет выполняться приложение. Параметр указывает компилятору на необходимость преобразования всех используемых в описании шрифтов к типу, введенному с параметром FORCEFONT.
Замечание
Наименование шрифта, заданного параметром FORCEFONT, должно совпадать с его именем, которое отображается в папке Панель управления Windows. Пробелы в наименовании типа шрифта не допускаются.
Синтаксис параметра TITLE следующий:
TITLE = имяЗагчэловка
Параметр WARNING имеет следующий синтаксис:
WARNING = уровень
Где параметр уровень имеет одно из трех значений, приведенных в табл. 12.6.
Таблица 12.6. Уровни параметра WARNING.
| Уровень | Выводимая информация |
|---|---|
| 1 | Только наиболее серьезные ошибки |
| 2 | Все ошибки |
| 3 | Все ошибки и предупреждения |
Раздел [Map]
Раздел [Map] является обязательным в том случае, если при организации файла справочной системы использовались контекстные ссылки или использовалось свойство HelpContextiD для вызова темы справочной системы.
Данный раздел содержит описание связи между идентификаторами тем и соответствующими им целыми значениями индекса тем. При использовании в приложении контекстного вызова справочной системы в разделе необходимо описать все идентификаторы, по которым будет осуществляться контекстный вызов.