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

Общее количество типов окон, которые вы можете определять, а также общее количество окон, которые вы можете показывать одновременно, ограничено исключительно доступной памятью и системными ресурсами.

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

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

Когда пользователь дважды щелкает на компилированном справочном файле (.chm), исполняемая программа HTML Help (Hh.exe) вызывает HTML Help API и устанавливает появление справочного окна и раздела справки. Подключение справочного окна, используя этот метод, немного отключается от вызова окна через HTML Help API.

По умолчанию, когда пользователь дважды щелкает на справочном файле (.chm), файл открывается в типе окна, определенном в файле справочного проекта (.hhp), и показывает раздел справки, также определенный по умолчанию в файле проекта. В случае, если окно в файле проекта не определено, используется программа просмотра справки с параметрами, заданными по умолчанию. В случае, если в файле проекта отсутствует раздел, определенный по умолчанию, показывается произвольный раздел справки.

Alias - это альтернативная точка входа (иначе называемая псевдоименем), которая используется для переадресовывания на какой-либо из гипертекстовых файлов проекта в случае, если некоторый текст (константа или число), заданный в секции [ALIAS] файла проекта, встречается HtmlHelp API при проходе.

Для того, чтобы работать с секцией [ALIAS] из интерфейса HTML Help Workshop, выберите закладку «Project», нажмите кнопку «HtmlHelp API information» и выберите закладку «Alias». В появившемся диалоговом окне вы можете добавлять (Add), править (Edit) или удалять (Remove) псевдоимена, а также включать (Include) в проект заголовочные файлы. В начале следует добавить какое-либо псевдоимя, поэтому при первой работе с HTML Help API нажмите кнопку «Add». В появившемся окне «Alias» требуется заполнить следующие поля (даны с примерами):

·  Каждый раз, когда эта константа или число проходится HtmlHelp API (index_file)

·  Использовать его для перехода на следующий гипертекстовый файл ($root\index.htm)

·  Комментарий (переход к содержанию проекта)

После заполнения вышеприведенных полей строка в секции [ALIAS] файла проекта .HHP будет выглядеть следующим образом: [ALIAS] index_file=$root\index.htm ; переход к содержанию проекта

ActiveX | технология ActiveX группа технологий, разработанных Microsoft для программирования компонентных объектных приложений на основе модели COM.

API, application programming interface | программный интерфейс приложения набор функций, предоставляемый некоторой программой - в данном случае, HTML Help Workshop.

COM, component object model | модель компонентных объектов стандартный механизм, включающий интерфейсы, с помощью которых одни объекты предоставляют свои сервисы другим, - является основой многих объектных технологий, в том числе OLE и ActiveX.

header file | заголовочный файл внешний исходный файл с расширением .H, помещаемый в начало программы с помощью директивы включения #include и обычно содержащий определения типов и переменных, используемых в программе.

OLE, object linking and embedding | связывание и внедрение объекта технологии на основе COM, используемые для создания составных документов с помощью внедрения и связывания.

[страница «Введение в HTML Help API» является, по большей части, переводом на русский язык статей, взятых из справочной системы по программе Microsoft HTML Help Workshop]