1.2. Секция files

С помощью секции [FILES] определяются RTF-файлы, содержащие текст справочной системы. Для нормальной работы компилятора необходимо определить хотя бы один файл в этой секции. Содержимое этой секции автоматически изменяется при изменении списка RTF-files па вкладке Files окна Options.

Справочная служба может состоять из множества RTF-файлов. В этом случае все они должны быть перечислены в секции [FILES]. Компилятор разрешает задать в этом списке один или несколько ссылочных ASCII-текстовых файлов, каждая строка которых определяет нужный RTF-файл (то есть содержит маршрут доступа и имя файла).

1.3. Секция windows

Секция [WINDOWS] определяет используемый в справочной службе набор дополнительных окон. Каждое указанное в секции окно характеризуется своим типом, цветом, размерами, заголовком. Только имена перечисленных в секции окон могут указываться в ссылках и сносках > RTF-файлов.

Если в секции не определено ни одного окна, щелчок на кнопке Window вызовет диалоговое окно для задания имени вновь создаваемого окна и его типа (рис. 96).

Рис. 96. Диалоговое окно определения имени и типа дополнительного окна

В поле Create a window named следует задать имя окна. Если указать имя main, установки, производимые далее, будут относиться к основному окну справочной службы. С помощью списка Based on this standard window можно выбрать один из трех возможных стандартных типов окна:

• Procedure — окно предназначено для вывода текстов процедур; оно позиционируется в правом верхнем углу экрана и при значительной ширине может своим правым краем выйти за пределы экрана;

• Reference — обычное справочное окно; позиционируется в левом верхнем углу, занимает приблизительно две трети экрана по высоте и ширине;

• Error message — окно предназначено для вывода сообщений об ошибках, позиционируется по центру экрана, занимает почти всю высоту экрана и три четверти его ширины.

Все три типа создают стандартные Windows-окна с «толстой» рамкой и заголовком, то есть их положение и размеры пользователь может изменять по своему усмотрению, так что выбор типа не носит решающего характера. Кроме того, с помощью кнопки Auto sizer на вкладке Position (см. ниже по тексту) можно визуально настроить положение и размеры окна.

Если хотя бы одно окно в секции [WINDOWS] уже определено или если диалоговое окно определения типа и имени окна, показанное на рис. 96, закрыто щелчком на кнопке QK, на экране появляется многостраничное окно Window Properties, показанное на рис. 97.

Рис. 97 . Диалоговое окно определения параметров дополнительных окон

Ниже перечислены параметры вкладки General.

• Window type — позволяет выбрать одно из ранее определенных окон. Все дальнейшие установки на вкладке General будут осуществляться для выбранного в этом списке окна. Подобные списки есть на всех других вкладках окна Window Properties.

• Add — вызывает диалоговое окно (см. рис. 37), позволяющее добавить новое окно к списку окон.

• Remove — удаляет окно из списка.

• Include — включает текстовый файл в формате ASCII со списком окон.

• Title bar text — определяет заголовок окна.

• Comment — содержит произвольный комментарий. Здесь, например, можно указать функциональность окна. Текст комментария не включается в результирующий файл.

• Auto-size height — если флажок установлен, окно автоматически изменяет высоту в зависимости от разрешения экрана.

• Maximize window — окно разворачивается по размеру экрана.

• Keep Help window on top — окно всегда появляется поверх остальных окон.

Вкладка Position определяет положение и размеры окна в момент его появления на экране.

• Тор — отступ левого верхнего угла от верхнего края экрана.

• Left — отступ левого верхнего угла от левого края экрана.

• Height — высота окна.

• Width — ширина окна.

• Adjust for user screen resolution — если флажок установлен, координаты задаются относительно виртуального экрана с разрешением 1024x1024. Если флажок не установлен, координаты указываются в пикселях.

• Auto-sizer — после щелчка на этой кнопке появляется окно с кнопками ОК и Cancel для визуальной настройки размеров и положения.

• Default Position — после щелчка на этой кнопке окну задаются умалчиваемые размеры.

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

• Contents — кнопка Содержание

• Index — кнопка Индекс

• Find — кнопка Поиск

• Help Topics — кнопка Разделы

• Print — кнопка Печать

• Back — кнопка Назад

• Options — кнопка Параметры

• Brows — кнопки просмотра связанных тем

Вкладка Color позволяет изменять цвет фиксированной (Nonscrolling area) и основной (Topic area) области окна. Изменения становятся доступны после щелчка на соответствующей кнопке Add.

С помощью этой вкладки Macros можно указать макрокоманды, которые будут автоматически выполняться при появлении окна на экране.

Секция BITMAPS

Секция [BITMAPS] определяет список папок, в которых компилятор будет искать графические файлы, встроенные в текст справки директивами bine, bml, bmr. Если ни одна папка не определена, компилятор сможет подключить только те файлы, которые располагаются в том же каталоге, в котором создается Help-файл.