Компиляция. Вывод справочной информации.
После того как будут определены файлы, в которых находится справочная информация (сформирован раздел [FILES]) и подготовлена информация для формирования вкладки Содержание (создан файл контекста), можно выполнить компиляцию – преобразовать исходную справочную информацию в файл справочной системы (chm-файл).
Исходной информацией для HTML Help компилятора являются:
- файл проекта (hhp-файл);
- файл контекста (hhc);
- файлы справочной информации (htm-файлы);
- файлы иллюстраций (gif- и jpg-файлы).
Результатом компиляции является файл справочной системы (chm-файл).
Чтобы выполнить компиляцию, надо в меню File выбрать команду Compile, в появившемся диалоговом окне Create a compiled file (рис. 8.29) установить переключатель Automatically display compiled help file when done (после компиляции показать созданный файл справки) и щелкнуть на кнопке Compile. В результате этого будет создан файл справки и на экране появится окно справочной системы, в котором будет выведена информация главного раздела.
Рис. 8.29. Диалоговое окно Create a compiled file
Вывод справочной информации
Вывести справочную информацию, которая находится в 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); }