Создание файла содержания справочной системы
Файл содержания справочной системы также удобно создавать в HelpWorkshop. Для этого необходимо выбрать в меню HelpWorkshop:
File -> New -> Help Contents
В верхней части окна нужно вписать имя главного файла справочной системы и заголовок (title) для оглавления справки. То же можно сделать в диалоговом окне, которое открывается при нажатии кнопки «Edit...».
Содержание справочной системы состоит из:
разделов справки, которые включают в себя несколько тем и представлены в содержании значком книжки;
тем, содержащих текст и изображения, они представлены в содержании значком листа с вопросом.
Для добавления и изменения параметров разделов справни предназначены следующие кнопки:
Add Above…– добавить выше;
Add Below… – добавить ниже;
Move Right – сдвинуть вправо;
Move Left – сдвинуть влево;
Edit – редактировать;
Remove – удалить.
При этих кнопок можно создать нужную структуру содержания. При добавлении раздела в диалоговом окне необходимо указать только его название, при добавлении темы – название, идентификатор (тот, который был задан ей в RTF-файле при вставке сноски), имя HLP-файла и имя окна. Если тема находится в том же HLP-файле, который указан как главный, то имя HLP-файла указывать не нужно. Имя окна указывать тоже не обязательно, если оно не указано, то тема откроется в окне по-умолчанию. Нужно сохранить файл оглавления (он будет иметь расширение .cnt) в той же директории, где находится HLP-файл лучше с тем же именем, что и HLP-файл. Теперь нужно снова открыть файл проекта .hpj и, нажав кнопку «Options», в открывшемся диалоговом окне на закладке «Files» указать файл содержания (Contents file). Далее надо закрыть диалоговое окно и нажать «Save and Compile». Теперь при двойном щелчке мышью по значку файла справки должно открыться ее оглавление, из которого можно получить доступ ко всем темам.
Прикрепление справочной системы к программе
Для того чтобы во время работы программы пользователь, нажав клавишу <F1>, мог получить справочную информацию, надо чтобы свойство «HelpFile» главного окна приложения содержало имя файла справочной системы, а свойство «HelpContext» числовой идентификатор нужного раздела. Идентификаторы разделов справочной системы перечислены в разделе [MAP] файла проекта справочной системы.
Файл справочной системы приложения лучше поместить в ту папку, в которой находится файл исполняемой программы.
Для каждого компонента формы, например, поля ввода, можно задать свой раздел справки. Раздел справки, который появляется, если фокус находится на компоненте, и пользователь нажимает клавишу <F1>, определяется значением свойства «Helpcontext» этого компонента. Если значение свойства «HelpContext» элемента управления равно нулю, то при нажатии клавиши <F1> появляется тот раздел справки, который задан для формы приложения.
Если в диалоговом окне есть кнопка «Справка», то для отображения справочной информации нужно создать процедуру обработки события onclick для кнопки, которая обращением к функции winhelp запускает программу Windows Help (файл Winhlp32.exe). При вызове функции winhelp в качестве параметров указываются: идентификатор окна, которое запрашивает справочную информацию; имя файла справочной системы, константа, определяющая действие, которое должна выполнить программа Windows Help и уточняющий параметр.
Процедура обработки события Onclick для кнопки вызывающая файл вправки:
procedure TForm1.Button1Click(Sender: TObject);
begin
winhelp(Form1.Handle,'1.hlp',HELP_CONTEXT,2);
end;