Операционная система Microsoft Windows 3.1 для программиста. Дополнительные главы

4.7. Другие возможности

Возможности приложения winhelp.exe слишком велики, чтобы их можно было описать полностью, к тому же они не все документированы. Авторы этой книги знают о существовании полного описания системы Windows Help, предназначенной только для внутреннего пользования в Microsoft, состоящего из сотен страниц. В этом разделе мы очень кратко расскажем еще о нескольких возможностях.

Глобальные переменные

Если вы создаете собственные макрокоманды (как функции DLL-библиотеки), вам может пригодиться информация о внутренних переменных winhelp.exe. Эти переменные можно передавать как параметры стандартным и созданным вами макрокомандам.

Приведем список внутренних переменных.

Имя переменной	Тип	Описание
hwndApp	U	Идентификатор главного окна приложения winhelp.exe. Можно пользоваться только во время выполнения функции, вызываемой из DLL-библиотеки
hwndContext	U	Идентификатор текущего активного окна приложения winhelp.exe
qchPath	S	Путь к hlp-файлу
qError	S	Дальний указатель на структуру, содержащую информацию об ошибке, возникшей при последнем обращении к winhelp.exe
lTopicNo	U	Номер раздела
hfs	U	Идентификатор файловой системы для текущего hlp-файла
coForeground	U	Основной цвет окна
coBackground	U	Фоновый цвет окна

Секция BAGGAGE

Разработчик справочной системы может добавить в hlp-файл (в его внутреннюю файловую систему) произвольные файлы данных, описав их в секции BAGGAGE файла проекта справочной системы. Это могут быть, например, видео- или звуковые данные, графические изображения и т. п.

Вызов внутренних функций

Разработчик справочной системы может использовать 16 внутренних функций, экспортируемых приложением winhelp.exe. Эти функции позволяют работать с внутренней файловой системой hlp-файла. Их можно использовать для доступа к данным, описанным в секции BAGGAGE.

Определив функцию LDLLHandler, разработчик DLL-библиотеки может получать извещения от приложения winhelp.exe о таких действиях пользователя, как выбор чувствительной точки или передача фокуса ввода другим приложениям.