Работа с файлами справки CHM на Ассемблере

Когда речь заходит о работе с файлами справки в формате CHM, то обычно все ссылаются на системный файл hh.exe, который вызывают с различными параметрами. Действительно, с его помощью можно просто открывать файл справки, а также открывать его на нужной странице (при условии, что заранее известно наименование ее HTML-файла в составе скомпилированной справки). Но с помощью hh.exe невозможно воспользоваться таким мощным инструментом, как поиск по ключевым словам. В этом случае мы можем воспользоваться всей мощью WinAPI и задействовать функцию HtmlHelp, которая находится в системной библиотеке HHCtrl.ocx. К сожалению, информации по ее использованию даже на MSDN очень мало, пришлось самостоятельно разбираться с некоторыми моментами. Для работы нам понадобятся определения некоторых констант:Остальные константы вы можете посмотреть в MSDN, но для нормальной работы с файлом справки вполне достаточно этих четырех. Во всех примерах этой статьи я ссылаюсь на файл справки PHP php_manual_ru.chm, его можно скачать здесь (примерно 13 мегабайт). В ваших программах, естественно, вы будете использовать свой файл справки.

Первый пример, самый простой, это открытие файла справки на заранее известной странице.То же самое действие выполняет команда:

hh.exe php_manual_ru.chm::res/function.http-send-data.html
У этого метода есть один большой недостаток. Если в CHM-файле есть индекс, то после выполнения такой команды он останется на самом начале, тогда как правая информационная часть действительно откроется на нужной странице.

Второй пример более сложный. В нем мы будем искать ключевое слово и синхронизировать по нему как информационную часть, так и индекс. Для этого кроме ранее определенных констант нам еще понадобится структура HH_AKLINK:Если файл справки найден и открыт, то функция HtmlHelp в регистре EAX возвращает хэндл его открытого окна. Это позволяет отслеживать момент, когда пользователь закроет окно справки, а также манипулировать окном, например, передвинуть его на самый верх. Обратите внимание на вызов функции HtmlHelp с параметром HH_DISPLAY_INDEX. С его помощью можно устанавливать индекс файла на нужное значение. Так что можно дополнить им первый пример.

Одно приложение через HtmlHelp может открыть одновременно только одно окно справки. Даже если попробовать последовательно открыть разные файлы справки, то все равно сперва будет закрыто предыдущее окно, и только потом открыто новое. С чем связано такое ограничение - не знаю. Также вы можете закрыть окно справки из вашего приложения, для этого воспользуйтесь следующей командой:В приложении пример программы с исходным текстом для работы с файлом справки php_manual_ru.chm, открывающей его на нужном ключевом слове или заранее известной странице. CHM-файл должен находиться в одной папке с программой.

Комментарии

Добавить комментарий

Для вставки цитаты выделите текст и нажмите сюда

Имя*:

Текст комментария (не более 2000 символов)*:

*Все поля обязательны для заполнения.

Комментарии, содержащие рекламу, ненормативную лексику, оскорбления и т.п., а также флуд и сообщения не по теме, будут удаляться. Нарушителям может быть заблокирован доступ к сайту.