Система визуального объектно-ориентированного проектирования C++Builder 123

Если вам нужно найти справку по функциям С, то удобно на странице справки
Содержание открыть книжку «С Runtime Library Reference» (Обзор библиотеки С),
затем раскрыть «Categorical Routines and Types Listing» (Список функций и типов по
категориям) или «Alphabetical Routines and Types Listing» (Список функций и типов
по алфавиту), а затем найти нужную функцию в соответствующем разделе.

Для получения справки по API Windows, по сообщениям Windows и т.п. по-
лезно открыть в окне справки один из файлов ...\program files\Common Files\Borland
Shared\MShelp\95guide.hlp или ...\program  files\Common  Files\Borland Sha-
red\MShelp\mapi.hlp.

А теперь рассмотрим очень интересный инструмент, появившийся в C++Buil-
der 4 и позволяющий проводить настройку справочной системы. Речь идет о про-
грамме Borland OpenHelp, вызываемой в C++Builder 4 командой Help Customize... .
Эта программа предоставляет вам простой путь конфигурирования файлов справки
.Ыр. При этом можно добавлять и убирать файлы справки, которые будут появляться
в таблице содержания и в предметном указателе справки. В частности, можно встро-
ить в систему собственные справочные файлы на русском языке. Диск, прилагаемый
к книге, содержит начальную версию такой справки, которую я создал, включил в
свой C++Builder и сам с удовольствием использую в работе.

OpenHelp хранит информацию о справочной системе в проекте. Файл этого
проекта имеет расширение .ohp и хранится в каталоге /Help. Вы можете изменить
состав справочной системы: таблицы Содержание (Contents), таблицы Предметный
Указатель и контекстной справки, доступ к которой осуществляется клавишей F1.

OpenHelp позволяет также удалить ссылки системного реестра на устаревшие
файлы справки. Дело в том, что нередко системный реестр и файл WINHELP.INI
загромождаются ссылками на устаревшие файлы справок. Вы можете быстро очи-
стить от них реестр, выполнив в окне OpenHelp команду File | Clean Registry.

Ниже изложена методика модификации справочной системы.

Таблица Содержание хранится в файле с расширением .toe, подобном файлам
содержания Windows .cnt (см. главу 8), только без предложений Include. Чтобы
добавить файлы в таблицу Содержание, надо сделать следующее:

1. Перейти в окне OpenHelp на страницу Contents.

2. Выполнить команду Edit | Add Files.

3. Выбрать или написать имена одного или более добавляемых файлов .toe или
.cnt.

4. Щелкнуть на ОК.

5. Вы можете переместить файл на желательное вам место среди других файлов.
Для этого выделите файл и переместите его, пользуясь кнопками со стрелками
на странице Contents.

6. Выполнить команду File | Save Project... или File | Save Project As... .
Для удаления файла из таблицы Содержание надо:

1. Перейти в окне OpenHelp на страницу Contents.

2. Выделить удаляемые файлы.

3. Выполнить команду Edit | Remove.

4. Выполнить команду File Save Project... или File Save Project As...

Таблица Предметный Указатель хранит ссылки на файлы справок .hip. Чтобы
добавить файлы в таблицу Предметный Указатель или удалить файлы из нее надо
произвести те же операции, которые были рассмотрены выше, но только работать
на странице Index и добавлять или удалять файлы .hip.

Контекстно-зависимый поиск справки состоит из файлов .hip, доступных с по-
мощью переходов ALink (см. о них в главе 8). Переходы ALink используются в
C++Builder при нажатии клавиши F1 в Инспекторе Объектов и Редакторе Кодов.