Глава 8

Разработка справочной
системы (создание файлов -hlp)

8.1 Проектирование справочной системы

Разработка справочной системы осуществляется не C+4-Builder, а средствами
Windows. Просмотр ее также осуществляется программой Windows WinHelp.
C++Builder только позволяет встроить справочную систему в приложение (см. раз-
дел 4.1.8). Однако, поскольку полноценное приложение немыслимо без хорошо
разработанной справочной системы, мы коротко рассмотрим некоторые основные
вопросы, связанные с ее созданием.

Разработка справки состоит из двух основных этапов:

• Создание файла или нескольких файлов, содержащих темы справок. Это дела-
ется с помощью любого текстового редактора, например, с помощью Microsoft
Word.

• Компиляция справки в один или несколько файлов .Ыр и отладка всей спра-
вочной системы. Это осуществляется с помощью специальных программ:

HCRTF — Microsoft Help Workshop для Windows 95/98 и NT и программ НС31
или НСР для Windows З.х. При этом создаются вспомогательные файлы про-
екта и некоторые другие.

Рассмотрим указанные этапы работы. В основном будет рассмотрена методика
создания справок для Windows 95/98 и NT с помощью такого инструмента, как
Microsoft Help Workshop 4. Соответствующие программы и файлы, необходимые
для этого, обычно расположены в C++Builder каталоге .../Help/Tools. Особенности
справок для Windows З.х рассмотрены в разделе 8.4.

Прежде, чем создавать тексты справок, надо продумать систему в целом. Надо
решить, как должно выглядеть основное окно, какую информацию выносить в до-
полнительные окна, что выносить во всплывающие окна, как должен выглядеть и
какие разделы включать предметный указатель и окно содержания (это окно в
виде дерева, содержащего изображения книг и документов каждый из вас видел,
работая с какими-нибудь справками). В отношении основного окна надо решить,
какие кнопки в своем заголовке оно должно иметь, нужна ли начальная часть, не
поддающаяся прокрутке, и что в нее должно входить, продумать общий стиль
справки. При решении вопроса о дополнительных окнах и распределении функ-
ций между основным и дополнительными окнами надо иметь в виду, что дополни-
тельное окно не имеет полосы меню и не обеспечивает доступ к истории и содержа-
нию. С другой стороны у основного окна тоже имеется ограничение: оно не может
быть сделано автоматически подстраивающим свои размеры под объем текста в
нем. Не останавливаясь на подробностях процесса составления проекта справки,
следует сказать, что этот процесс, конечно, трудно формализовать и любой перво-
начальный проект подвергнется переделкам в процессе его реализации. Но все-та-
ки помните, что от удачного или неудачного планирования справки во многом за-
висит удобство пользователя, а, значит, и его отношение к вашему приложению,
для которого готовится справка.

15 Зак.764