Задание3_Справочная_система (Лабораторная работа №3), страница 2

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

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

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

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

Рис. 19. Диалоговое окно Compile a Help File

Доступ к справочной информации

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

Рис. 20. Свойство HelpFile должно содержать имя файла справки

Файл справочной системы приложения лучше поместить в ту папку, в кото­рой находится файл исполняемой программы.

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

Если в диалоговом окне есть кнопка Справка, то справочная информация выводится по-другому — для кнопки создается процедура обработки события OnClick, которая обращением к функции winhelp запускает программу Windows Help (файл Winhlp32.exe). При вызове функции winhelp в качестве параметров указываются: идентификатор окна, которое запрашивает спра­вочную информацию; имя файла справочной системы; константа, определяющая действие, которое должна выполнить программа Windows Help и уточняющий параметр.

_________________________________________________________________________

Примечание

Идентификатор окна — это свойство Handle формы приложения. Свойство Handle доступно только во время работы программы, поэтому в списке свойств в окне Object Inspector его нет.

_________________________________________________________________________

Если необходимо вывести конкретный раздел справки, то в качестве параметра, определяющего действие, используется константа help_context. Уточняющий параметр в этом случае задает раздел справки, который будет выведен на экран.

Ниже, в качестве примера, приведена процедура обработки события OnClick для кнопки Справка (Button4) диалогового окна программы решения квадратного уравнения.

// щелчок на кнопке Справка

procedure Tform1.Button4Click(Sender: TObject);

begin

winhelp(Form1.Handle, 'sqroot.hlp' ,HELP_CONTEXT, 1) ;

end;

____________________________________________________________________

Примечание. Turbo Delphi 2006 не поддерживает вывод контекстной справки для выделенного компонента по кнопке F1. Для вывода контекстной справки можно использовать какое-нибудь событие компонента, например, DblClick. Процедура обработки этого события будет аналогична приведенной выше процедуре для кнопки Справка, но значение параметра HELP_CONTEXT должно быть равно номеру соответствующего раздела справки (в примере равно 1).

______________________________________________________________________

_______________________