Help…как же я ненавижу всю работу, связанную с созданием всякого рода хелпов. И ведь никуда от это работы не деться. Без полноценного, качественного help’a, контекстных справок, hint’ов и т.д. любая сколь угодно функциональная программа с «интуитивно понятным» интерфейсом может превратиться в нечто непостижимое для пользователя. Понятно, что редко кто читает Help к медиаплееру или текстовому редактору. Но совсем другое дело, когда пишется какая-то специализированная программа, например, ГИС или, как приходилось писать мне — программы расчёта приземных концентраций загрязняющих веществ — тут хочешь-не хочешь, а на пальцах всё объяснить пользователю за пять минут не получится — большое количество переменных, задаваемых пользователем, работа с БД — все эти моменты приходится прописывать в справку. До сих пор я обходился в работе простыми html-файлами, но рано или поздно надо было переходить на использование возможностей Windows. И видимо сегодня этот день настал :).

Как Вы знаете, для хранения справочной информации Windows активно использует chm-файлы. Достаточно удобный и легкий в плане работы формат. Именно такую справку мы и будем писать сегодня.
Для компиляции и работы с chm-файлами воспользуемся тем, что предлагает нам Microsoft — программой «HTML Help Workshop» скачать которую можно, перейдя по ссылке. Там же скачайте и всю документацию по API работы со справочной системой — она нам пригодиться на будущее.
И первое, что мы сделаем — это установим «HTML Help Workshop» (HHW) и создадим новый проект, содержащий всего один файл.
Жмем в главном меню HHW File—>New и в открывшемся окне выбираем «Project» — запустится мастер создания нового проекта.

Первый шаг можно пропустить т.к. мы ничего не конвертируем. Далее нас попросят задать расположение файла проекта на диске — указываем и остальные шаги пропускаем. В конце жмем «Готово» и hhw сгенерирует нам новый пустой проект справки:

Можете установить новые свойства вашего проекта — для этого надо сделать двойной щелчок по секции «Options» или нажать одноименную кнопку в левой части окна.
Теперь создадим наш первый (и единственный) в проекте файл справки. Для этого жмем в главном меню File—>New—>HTML File. В открывшемся окне пишем название нового раздела справки, например, «Hello World!» и HHW создаст для нас «скелет» нового документа:

Так как никаких визуальных средств для разработки hhw не использует, кроме редактора в стиле «а-ля блокнот», то будем писать весь HTML-код ручками.
Для начала запишем следующее:

Заголовок первого уровня

Заголовок второго уровня

Это наш первый html-файл для супер-спраки для супер-программы Hello World!

Жмем кнопку Save в верхнем тулбаре, задаем имя файла, например, index и сохраняем файл на диск.
Теперь прицепим этот файл к проекту. Для нажимаем кнопку «Add/Remove topic files», затем в открвшемся окне кнопку «Add» и добавляем наш файл index.html к проекту:

Теперь надо наш проект скомпилировать. Для этого в главном меню программы необходимо выбрать File—>Compile и в открывшемся окне указать путь к файлу проекта (по умолчанию поле ввода содержит путь к текущему файлу проекта). В результате компиляции hhw выдаст нам в главном окне лог компиляции и создаст chm-файл справки.
Если Вы делали все как написано в посте, то Вы должны были получить в результате работы три файла: *.chm, *.hhp и *.html. Теперь можете открыть получившийся chm-файл и убедиться, что наш текст из index.htm в нем присутствует:
.
Теперь нам остается научиться вызывать этот файл из своей Delphi-программы.
В Сети вы можете встретить массу статей, касающихся запуска chm-фалов из своих программ. Обчно в этих статьях Вам сначала предлагают импортировать библиотеку, обявить вызов функции HtmlHelp и уж потом работать со справкой. Но дело в том, что модуль Windows.pas в Delphi 2010 уже содержит все необходимые типы данных и функции для работы с chm.
Создайте новый проект Delphi и поместите на главную форму всего одну кнопку. Убедитесь, что в uses подключен модуль windows и в событии onClick кнопки напишите всего одну строку:

HtmlHelp(handle,'Путь_к_файлу/help.chm',HH_DISPLAY_TOPIC,0);

Убедитесь, что файл справки запускается корректно. Теперь разберемся, что мы написали.
handle — первый параметр функции содержит всегда HWND окна вызывающего приложения.
Второй параметр — путь к файлу справки. В этом же параметре можно указать конкретный раздел справки, который необходимо открыть, название окна и т.д.
Третий параметр (HH_DISPLAY_TOPIC) — команда API. В конкретно нашем случае мы попросили открыть топик справки.
И последний параметр — ноль. Этот параметр используется, например, для команды вызова pop-up окна справки (об этом поговорим позже), в остальных случаях четвертый параметр должен быть равен нулю.
В следующий раз поговорим более подробно о структуре справочной системы и попробуем использовать другие возможности для работы со справкой, используя всё туже единственную функцию HtmlHelp.