Работа с HTML Work Shop, страница 7

Основной особенностью HTML Help API является справочное окно. С помошью команд API вы можете создавать окно, которое управляется DLL-библиотекой Microsoft Internet Explorer (Shdocvw.dll) и показывает гипертекстовый файл, указанный вами. Справочное окно принадлежит окну, также указанному вами. В качестве принадлежащего окна справочное окно автоматически остается поверх своего владельца и закрывается, когда закрывается окно-владелец.

Вы определяете стили, координаты и заголовки, а также показываете состояние справочного окна. Этот уровень управления позволяет вам внедрять справочное окно в программу под управлением Windows, не активированную OLE.

Кроме создания справочных окон, команды HTML Help API также позволяют вам предоставлять:

·  Контексно-зависимую справку.

·  Блокировку ключевых слов.

·  Взаимодействие между программой и компилированным файлом справки (.chm).

·  Управление навигационной панелью в стандартной программе просмотра HTML Help.

Примечание

·  Функция HTML Help API моделируется после функции WinHelp API для упрощения процесса обновления существующих программ со справочной технологии WinHelp на HTML Help. Однако имена и параметры команд HTML Help API не такие же, как в WinHelp API, а форматы выходных файлов сильно различаются между собой.

Тип окна используется для отображения раздела справочной системы и предоставления пользователям возможности управления компилированным файлом справки (.chm). Справочное окно основано на структуре HH_WINTYPE и управляется DLL-библиотекой Microsoft Internet Explorer (Shdocvw.dll) для отображения справочного раздела.

Любое справочное окно, создаваемое вами с помощью HTML Help API, принадлежит вызывающей, или родительской программе. Это обстоятельство позволяет справочному окну оставаться поверх вызывающего, но не быть поверх любой другой программы, которая находится в фокусе (активном состоянии).

Кроме того, любое справочное окно, создаваемое вами с помошью API, ограничивается действиями своего окна-владельца. Например, если пользователь сворачивает вызывающую программу, справочное окно исчезает до тех пор, пока окно-владелец не будет восстановлено. Если пользователь выходит из вызывающей программы, справочное окно также закрывается без необходимости любого действия со стороны своего владельца. Так как вызывающая программа сама создает справочное окно, она может изменять позицию и свойства этого окна без воздействия процедурной помощи любой другой программы.

Любой автор справочных систем может определять типы окон в файле проекта (.hhp), используя HTML Help Workshop, разработчик же может определять типы окон программно, испольуя HTML Help API.

Определение типа окна, такое, как стандартная программа просмотра HTML Help, включает всю необходимую информацию об окне, а именно: атрибуты стиля окна и любые навигационные элементы (такие, как таблица содержания, указатель или полнотекстовый поиск). Когда тип окна создан, частью его определения являются места размещения файлов его навигационных элементов. Эти навигационные элементы не изменяются в течение периода «жизни» типа окна.

Типы окон являются индивидуальными для компилированного файла справки (.chm), в котором они созданы, за исключением типа окна, который называется «глобальным окном». Привязка типа окна к одному компилированному файлу справки позволяет вам создавать составные справочные файлы, которые все содержат тип окна с одинаковым именем. Например, вы могли бы создать пятьдесят компилированных справочных файлов и определить тип окна, названный «Main», к каждому из файлов, без возникновения конфликтов различных типов файлов по отношению ко всем остальным.