Разработка справочной системы (создание файлов .hip)_______________473

бок. Поэтому можно рекомендовать при отладках больших справок задавать оп-
цию ERRORLOG.

Из сказанного следует, что раздел [OPTIONS] в простейшем случае может вооб-
ще не задаваться, поскольку он не содержит ни одной обязательной опции.

Не обязательный раздел [CONFIG] может использоваться для указания макро-
сов, которые должны выполняться при открытии файла справки. Например, вы
можете указать макросы, включающие какие-то разделы меню или кнопки, отсут-
ствующие в стандартном окне справочной системы:

[CONFIG]

; Включается для кнопки "История"

CreateButton("History","&История", "History!)")

BrowseButtons ()    ; Включается для появления кнопок "«", "»"

InsertMenu("mexit"," Выход",5) ; Добавляет меню "Выход"

Appendltem("mexit","exit","Выход","exit()");Раздел "Выход"

Раздел [FILES] включает в себя перечень файлов тем .rtf. Это единственный раз-
дел, который обязательно должен присутствовать в файле Проекта справки. Имя
каждого файла .rtf начинается с новой строки. Для простой справки с одним фай-
лом тем это может быть всего один файл.

Раздел [MAP] содержит таблицу соответствия идентификаторов тем, использу-
емых при написании файла .rtf, и номеров контекстной справки, используемых в
вашем приложении для ссылок на эти темы. Например, если в файле .rtf имеется
тема с идентификатором menu, на которую из приложения имеется контекстная
ссылка 2, и тема с идентификатором Содержание, на которую в приложении име-
ется ссылка по номеру 1, то раздел [MAP] может иметь вид:

[MAP]

menu        2 ; обращение к справке по меню
Содержание 1 ; обращение к содержанию

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

Раздел «[WINDOWS]» описывает окна справки — основное (main) и вторичные
(если они используются). Описание каждого окна имеет вид:

<тип> = "<заголовок>", (<х>,<у>,<ширина>,<высота>), <развертывание>,
(<цвет окна>),(<цвет не прокручиваемой части>)

Первый элемент этого описания — заголовок окна. Для главного окна он не
указывается, поскольку задается описанной выше опцией TITLE в разделе
[OPTIONS]. Для вторичных окон заголовок тоже может не задаваться. Следующий
элемент описания — координаты левого верхнего угла окна и его размеры. Следу-
ющий элемент — <развертывание>, может принимать значения 0 (не развертыва-
емое на весь экран) или 1 (развертываемое). Далее следуют два элемента описания,
определяющие цвета прокручиваемой и не прокручиваемой частей окна. Каждый
цвет задается тремя целыми числами, описывающими интенсивность красного, зе-
леного и синего. Максимальная интенсивность — 255, минимальная — 0. Напри-
мер, (255, 255, 255) — белый цвет, (127, 127, 127) — темно серый. Приведем при-
мер раздела [WINDOWS]:

[WINDOWS]

main=,(150,50,800,800),0, (255,255,255), (127,127,127)
Я1="Пояснения", (10,10,400,400),0, (255,255,255), (255,255,255)

Раздел [WINDOWS] может отсутствовать, если справка не использует вторич-
ных окно. Тогда атрибуты главного окна берутся по умолчанию.

Кроме перечисленных, в файле Проекта могут быть еще разделы [ALIAS],
[BUILDTAGS], [BITMAPS], [BAGGAGE]. Эти разделы используются реже, чем описан-
ные выше, и на них мы не будем останавливаться.