Вывод справочной информации

Обычно окно справочной системы становится доступным в результате нажатия клавиши <F1> или выбора в меню Справка команды ?.

Для того чтобы во время работы программы пользователь, нажав клавишу <F1>, мог получить справочную информацию, надо чтобы свойство HelpFile главного окна приложения содержало имя файла справочной системы, а свойство Helpcontext — числовой идентификатор нужного раздела (Рисунок 8.14).

Для каждого компонента формы можно задать свой раздел справки. Раздел справки, который появляется, если фокус находится на компоненте и пользователь нажимает клавишу <F1>, определяется значением свойства Helpcontext этого компонента. Если значение свойства Helpcontext элемента управления равно нулю, то при нажатии клавиши <F1> появляется тот раздел справки, который задан для формы^приложения.

Для того чтобы справочная информация появилась на экране в результате выбора в меню ? команды Справка, надо создать функцию обработки события onclick для соответствующей команды меню. Процесс создания функции обработки события для команды меню ничем не отличается от процесса создания функции обработки события для элемента управления, например, для командной кнопки: в списке объектов надо выбрать объект типа TmenuItem, для которого создается функция обработки события, а во вкладке Events — событие.

Вывести справочную информацию, которая находится в chm-файле, можно несколькими способами. Наиболее просто это сделать при помощи утилиты hh.exe, являющейся составной частью Windows. Вызвать утилиту отображения справочной информации и передать ей в качестве параметра имя файла справочной системы можно при помощи функции winExec. У функции winExec два параметра. Первый — имя выполняемого файла программы, которую надо запустить, и командная строка. Второй параметр определяет способ отображения окна запускаемой программы. Окно запускаемой программы может быть развернуто на весть экран (SW_MAXIMIZE), запущенная

программа может работать в свернутом окне (SW_MINIMIZE) или окно программы может иметь размер и положение такие, какими они были в предыдущем сеансе работы (SW_RESTORE). Ниже в качестве примера приведена функция обработки события click на кнопке Справка. Функция обеспечивает вывод справочной информации, которая находится в файле saper.chm.
// Щелчок на кнопке Справка void __fastoall TForml::Button2Click(TObject *Sender) { WinExec("hh saper.chm",SW_RESTORE); }

Содержание раздела