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



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



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

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

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

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



Рис. 8.14. Свойство HelpFile должно содержать имя файла справки, а свойство HelpContext — идентификатор раздела


Ниже приведена функция обработки события onclick для команды Справка меню ?.

// выбор в меню ? команды Справка
void__fastoall TForml::N3Click(TObject *Sender)
{
WinHelp(Forml->Handle,"saper.hip",HELP_CONTEXT,1);
 }

Вывод справочной информации выполняет функция winHelp, которой в качестве параметра передается идентификатор окна программы, которая запрашивает вывод справочной информации, файл справки, константу HELP_CONTEXT и идентификатор раздела, содержимое которого должно быть отражено.