17.6 Справочная система Delphi и программа её конфигурирования OpenHelp
Справка в Delphi может вызываться из меню Help или с помощью
контекстно-зависимого поиска практически из любого окна Delphi. Вы
можете выделить на форме какой-то компонент, нажать F1 и вам будет
показана тема справки, связанная с этим компонентом. Можете просто
выбрать компонент на какой-то странице библиотеки и, не перенося
его на форму, нажать F1. Результат будет тот же. Если вы в окне
Редактора Кода установите курсор на имени какой-то функции, на
имени свойства или метода какого-то компонента и нажмете F1, то
вам также будет показана справка по интересующему вас вопросу.
Аналогично можно получить контекстную справку о свойстве
компонента из окна Инспектора Объектов, выделив соответствующее
свойство. Раньше говорилось о получении справки из окна Редактора
Кода. Кстати, это самый надежный способ получения справки. Как было сказано, обычно при работе со справками вам
приходится выбирать между темами, относящимися с VCL и CLX. Если
вы, например, никогда не используете CLX, то эта необходимость
каждый раз выбирать тему может раздражать. Несложно избавиться от
тем CLX. Для этого надо из каталога Delphi Help удалить (например,
перенести в другую папку — вдруг еще пригодятся) файлы: d7clx.hlp
и d7clx.cnt (в Delphi 6 — файлы dlx1clx.cnt, dlx1clx.hlp,
dlx1clx.toc). Ссылки на CLX исчезнут. Иногда, к сожалению, бывают ситуации, когда
контекстный поиск из окна Редактора Кода не дает правильный
результат. Тогда в ответ вы получаете сообщение, что такой темы
нет, и совет обратиться к разработчикам программы. В подобных
случаях можно посоветовать, выходить на требуемую тему через
страницу справки Содержание. Раскройте на ней книжку «Delphi
Object and Component Reference». Если вам требуется информация о
компоненте, свойстве, методе, событии, то внутри этой книжки
раскройте книжку «Alphabetical Object and Component Listing» (Алфавитный
список объектов и компонентов) и в этом списке отыщите по алфавиту
требуемый компонент. А из окна справки компонента всегда можно
найти все его свойства, методы и события. Если вам нужно найти
справку по функциям или процедурам Object Pascal, а обычный
контекстный поиск не помогает, то внутри книжки «Delphi Object and
Component Reference» раскройте одну из книжек: «Categorical
Routines Listing» (Список функций по категориям) или «Alphabetical
Routines Listing» (Алфавитный список функций), и в ней найдите
нужную функцию. Перечисленные выше разделы справок имеются в
Delphi 7. В предшествующих версиях расположение разделов несколько
иное, но названия книжек на странице Содержание, которые нужны для
получения сведений по компонентам и функциям, остаются теми же. Для получения справки по функциям API Windows, по
сообщениям Windows и т.п. надо в Delphi 7 выполнить команду Help |
Windows SDK и затем найти нужную тему на странице Указатель.
Другой способ, который, в частности, приходятся применять в
прежних версиях Delphi — выполнить в окне справок команду Файл |
Открыть, перейти в диалоге в каталог ...\program
files\Borland\Borland Shared\MShelp\ и в нем открыть файл
win32.hlp, или mapi.hlp. А теперь рассмотрим очень интересный инструмент,
позволяющий проводить настройку справочной системы. Речь идет о
программе Borland OpenHelp, вызываемой командой Help | Customize. Эта программа предоставляет вам простой путь конфигурирования
файлов справки .hlр. При этом можно добавлять и убирать файлы
справки, которые будут появляться в таблице содержания и в
предметном указателе справки. В частности, можно встроить в
систему собственные справочные файлы на русском.
OpenHelp хранит информацию о справочной системе в
проекте. Файл этого проекта имеет расширение .ohp и хранится в
каталоге /Help. Вы можете изменить состав справочной системы:
таблицы Содержание (Contents), таблицы Предметный Указатель и
контекстной справки, доступ к которой осуществляется клавишей F1.
OpenHelp позволяет также удалить ссылки системного реестра на
устаревшие файлы справки. Дело в том, что нередко системный реестр
и файл WINHELP.INI загромождаются ссылками на устаревшие файлы
справок. Вы можете быстро очистить от них реестр, выполнив в окне
OpenHelp команду File | Clean Registry. Ниже изложена методика
модификации справочной системы. Таблица Содержание хранится в файле с расширением .tос,
подобном файлам содержания Windows .cnt, только без предложений
Include. Чтобы добавить файлы в таблицу Содержание, надо сделать
следующее: 1. Перейти в окне OpenHelp на страницу Contents.
2. Выполнить команду Edit | Add. 3. Выбрать или написать имена одного или более
добавляемых файлов .toc или .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. Таблица Предметный Указатель хранит ссылки на файлы
справок .hlp. Чтобы добавить файлы в таблицу Предметный Указатель
или удалить файлы из нее надо произвести те же операции, которые
были рассмотрены выше, но только работать на странице Index и добавлять или удалять файлы .hlр. Контекстно-зависимый поиск справки состоит из файлов
.hlp, доступных с помощью переходов ALink. Переходы ALink
используются в Delphi при нажатии клавиши F1 в Инспекторе Объектов
и Редакторе Кодов. Чтобы добавить файлы в контекстно-зависимый
поиск, надо произвести те же операции, которые описаны выше, но на
странице Link. При этом надо, чтобы добавляемые файлы использовали
переходы ALink.
Сайт
рассылки http://mydelphi7.narod.ru,
на котором есть архив рассылки, также гостевая книга, переводчик.
Копировать, размещать, продавать представленную информацию
запрещается.