Создание проекта справочной системы

 

После того как создан файл справочной информации системы (RTF-файл), можно приступить к созданию справочной системы (HLP-файла). Для этого удобно воспользоваться программой Microsoft Help Workshop, которая поставляется вместе с Delphi и находится в файле Hcw.exe.

 

Путь к файлу Hcw.exe:

C:\Program Files\Borland\Delphi7\Help\Tools\ Hcw.exe

 

После запуска программы Microsoft Help Workshop на экране появляется главное окно программы.

 

Для того чтобы приступить к созданию справочной системы, нужно из меню «File» выбрать команду «New», затем в открывшемся диалоговом окне тип создаваемого файла – «Help Project». В результате этих действий открывается окно «Project File Name». В этом окне сначала надо выбрать папку, где находится программа, для которой создается справочная система, и где уже должен находиться файл документа справочной системы (RTF-файл). Затем в поле «Имя файла» нужно ввести имя файла проекта справочной системы. После щелчка на кнопке «Сохранить» открывается окно проекта справочной системы.

 

Используя окно проекта справочной системы, можно добавить необходимые компоненты в проект, задать характеристики окна справочной системы, выполнить компиляцию проекта и пробный запуск созданной справочной системы.

 

Включение в проект файла справочной информации (RTF-файла)

 

Для того чтобы добавить в проект файл справочной информации, нужно щелкнуть на кнопке «Files» и в открывшемся диалоговом окне «Topic Files» - кнопку «Add». В результате откроется стандартное окно Открытие файла, используя которое следует выбрать нужный RTF-файл. В результате этих действий в окне проекта появится раздел [FILES], в котором будет указано имя файла справочной информации. Если справочная информация распределена по нескольким файлам, то операцию добавления файла нужно повторить.

 

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

 

Чтобы задать характеристики главного окна справочной системы, надо в окне проекта нажать кнопку «Windows» и в поле «Create a window named» открывшегося окна «Create a window», ввести слово «main».

 

В результате щелчка на ОК появляется окно «Window Properties», в поле «Title bar text» вкладки «General» которого нужно ввести заголовок главного окна создаваемой справочной системы.

 

Используя вкладку «Position» диалогового окна «Window Properties», можно задать положение и размер окна справочной системы.

 

 

 

На вкладке «Position» находится кнопка «Auto-Sizer», при нажатии которой открывается окно «Help Window Auto-Sizer», размер и положение которого определяется содержимым полей вкладки «Position». При помощи мыши можно менять размер и положение этого окна. После нажатия кнопки ОК координаты и размер окна «Help Window Auto-Sizer» будут записаны в поля вкладки «Position».

 

 

 

Используя вкладку «Color», можно задать цвет фона области заголовка раздела справки (Nonscrolling area color) и области текста справки (Topic area color). Для этого надо нажать соответствующую кнопку «Change» и в стандартном окне «Цвет» выбрать нужный цвет.

 

Чтобы отобразить в окне справки кнопки «<<» и «>>» необходимо на вкладке «Buttons» установить флажок «Browse».

 

Назначение числовых значений идентификаторам разделов справки

 

Чтобы программа, использующая справочную систему, могла получить доступ к конкретному разделу справочной информации, нужно определить числовые значения для идентификаторов разделов. Чтобы это сделать, надо в окне проекта справочной системы нажать кнопку «Map», в результате чего откроется диалоговое окно «Map». В этом окне нужно нажать кнопку «Add» и в поле «Topic ID», открывшегося диалогового окна «Add Map Entry», ввести идентификатор раздела справки, а в поле «Mapped numeric value» - соответствующее идентификатору числовое значение. В поле «Comment» можно ввести комментарий – название раздела справочной системы, которому соответствует идентификатор.

 

Отображение кириллических шрифтов

 

Для того чтобы при открытии файла справочной системы нормально отображались кириллические шрифты необходимо произвести ряд настроек:

Щёлкните по кнопке «Options» и в появившемся диалоговом окне выберите вкладку «Fonts». Около поля «Substitute these fonts in Help topics» нажмите кнопку «Add…». Появится диалоговое окно «Edit/Add Font Mapping». На группирующей панели «Replacement font» в раскрывающемся списке «Character set:» необходимо выбрать пункт «RUSSIAN». Затем нажмите кнопку «OK».

 

 

 

Компиляция проекта

 

После того, как будет подготовлен файл проекта, можно выполнить компиляцию, щелкнув на находящейся в окне проекта кнопке «Save and Compile». Однако первый раз компиляцию проекта справочной системы лучше выполнить выбором из меню «File» команды «Compile», в результате выполнения которой открывается диалоговое окно «Compile a Help File».

 

В этом окне следует установить флажок «Automatically display Help file in WinHelp when done» (Автоматически показывать созданную справочную систему по завершении компиляции), а затем нажать кнопку «Compile». По завершении компиляции на экране появляется окно с информационным сообщением о результатах компиляции и, если компиляция выполнена успешно, окно созданной справочной системы. Созданный компилятором файл справочной системы (HLP-файл) будет помещен в ту папку, в которой находится файл проекта.