Программирование с C++ Builder



Проект справочной системы



Преобразование файла справочной информации в файл справочной системы выполняет входящий в состав Microsoft Help Workshop компилятор. Исходными данными для компилятора является справочная информация, представленная в виде rtf-файлов, и файл проекта справочной системы.

Для того чтобы преобразовать справочную информацию, подготовленную в редакторе текста, в справочную систему, сначала надо создать файл проекта справочной системы. Для этого нужно запустить Microsoft Help Workshop и в меню File выбрать команду New | Help Project (рис. 8.5). На экране появится диалоговое окно Project File Name. В этом окне (рис. 8.6) надо открыть папку, в которой находится файл справочной информации (rtf-файл), задать имя проекта и щелкнуть на кнопке Сохранить. В результате этих действий будет создан файл проекта (hpj-файл) и станет доступным окно проекта справочной системы (рис. 8.7).



Рис. 8.5. Начало работы над новым проектом


Первое, что надо сделать, — это добавить в проект rtf-файл, в котором находится справочная информация. Для этого нужно сначала щелкнуть на кнопке Files, затем в открывшемся окне Topic Files — на кнопке Add (рис. 8.8).

На экране появится стандартное диалоговое окно Открытие файла, используя которое можно выбрать нужный rtf-файл. Если справочная информация распределена по нескольким файлам, то операцию добавления файла нужно повторить.



Рис. 8.6. В поле Имя файла надо ввести название проекта



Рис. 8.7. Окно проекта справочной системы


После того как все нужные файлы будут выбраны, надо в окне Topic Files щелкнуть на кнопке ОК. В результате этих действий вновь станет доступным окно проекта, в разделе [FILES] которого будут перечислены файлы, в которых находится справочная информация.

Следующее, что надо сделать, — это назначить числовые значения идентификаторам разделов справочной информации. Для этого в окне проекта надо сначала щелкнуть на кнопке Map, затем, в открывшемся окне Map, — на кнопке Add (рис. 8.8). На экране появится окно Add Map Entry (рис. 8.9). В поле Topic ID этого окна надо ввести идентификатор раздела справки (идентификаторы были назначены разделам во время создания rtf-файла), в поле Mapped numeric value — число, идентифицирующее раздел. В поле Comment можно ввести комментарий — название раздела справки. После того как будут назначены числовые значения идентификаторам разделов справки, окно Map можно закрыть.



Рис. 8.8. Чтобы добавить в проект rtf-файл, щелкните на кнопке Add



Рис. 8.9. Назначение идентификатору раздела числового значения


Последнее, что надо сделать, — это настроить вид окна справочной информации. Для этого надо в окне проекта щелкнуть на кнопке Windows, в поле Create a window named открывшегося окна Create a window (рис. 8.10) ввести слово main и щелкнуть на кнопке ОК.



Рис. 8.10. Диалоговое окно Create a window



Рис. 8.11. В поле Title bar text надо ввести заголовок окна справочной системы


На экране появится окно Window Properties, в поле Title bar text вкладки General которого нужно ввести заголовок главного окна создаваемой справочной системы (рис. 8.11).



Рис. 8.12. Работа над проектом простой справочной системы завершена; можно выполнить компиляцию


На этом процесс создания проекта простой справочной системы можно считать завершенным (рис. 8.12). Теперь можно выполнить компиляцию. Для этого надо в меню File выбрать команду Compile, в появившемся диалоговом окне Compile a Help File установить флажок Automatically display Help file in WinHelp when done (Автоматически показывать созданную справочную систему по завершении компиляции) и щелкнуть на кнопке Compile (рис. 8.13).



Рис. 8.13. Чтобы выполнить компиляцию, надо щелкнуть на кнопке Compile


По завершении компиляции на экране появится окно с информационным сообщением о результатах компиляции и, если компиляция выполнена успешно, окно созданной справочной системы. Файл справочной системы (HLP-файл) компилятор поместит в ту папку, в которой находится файл проекта.


Книжный магазин