Кент Рейсдорф. BORLAND C++BUILDER. Раздел 4
Кент Рейсдорф. BORLAND C++BUILDER. Страница 398
4. Создать пункты для меню Help, чтобы ваши пользователи могли вызывать справку из меню.
Сейчас мы последовательно рассмотрим каждый из этих шагов.
Создание справочных файлов — это рутинная работа. Нельзя сказать, что я ненавижу ее, но и не жду с нетерпением. Вам повезло, если у вас есть свой отдел документации, который создает справочные файлы.
Независимо от того, кто пишет справочный файл, должна существовать некоторая координация действий между автором справочного файла и программистом. Идентификаторы контекста в справочном файле должны соответствовать заданным непосредственно в программе.
Справочный файл Windows может конструироваться из нескольких отдельных файлов. Исходный текст для справочного файла Windows называется тематическим файлом (topic file). Тематический файл — это файл в формате .RTF (rich text format), содержащий большое количество специального кода, который понимает компилятор справки. Если ваш справочный файл включает графику, вы можете иметь один или более графических файлов. Графические файлы, использующиеся при создании справочного файла, включают растровые изображения (.BMP), метафайлы Windows (.WMF) и некоторые другие специальные графические файлы. Наконец, у вас должен быть файл проекта справки (.HPJ). Файл проекта содержит описание того, как компилятор справки должен объединить тематический файл с графическими файлами и любыми другими специальными файлами, которые требуются для создания результирующего справочного файла. Он также включает раздел [MAP] (карта), который сопоставляет номера идентификаторов контекста определенным темам справки. После того, как файл проекта создан, он обрабатывается компилятором справки, таким как Microsoft Help Workshop (вы можете найти этот компилятор в каталоге \CBuilder\Help\Tools). Help Workshop загружает файл проекта и компилирует его для создания результирующего справочного файла (.HLP).