Глава 5. Дополнительные возможности

Создание справочной системы

Справочная система (справка) вызывается нажатием клавиши F1. Ее создание состоит из нескольких этапов.

Создание редактором Word файла типа RTF с текстом справки

Справка делится на разделы. Каждый раздел начинается с новой стра­­ницы (рис. 5.1.1).

Рис. 5.1.1. Исходный текст формируемой справки из двух разделов

 

Перед разделом указывается идентификатор в виде IDH <текст>, а перед ним вставляется символ «#» в режиме сноски (Вставка/Сноска). После идентификатора раздела указывается его заголо­вок после символа «$» в режиме сноски. При необходимости можно добавить управляющие символы (они описаны в файле Delphi5\Help\Tools\ HCW.Hlp). Например, введем ключевые слова, отображаемые на странице Указатель, после ввода символа «K» в режиме сноски (рис. 5.1.1). Опреде­лим в справке тексты гиперссылок на другие разделы справки (они выделяются зеленым цветом). Гиперссылка должна выделяться двойным или одинарным подчеркиванием (содержимое раздела после перехода откры­вается в текущем окне или во всплывающей подсказке). Сразу после ги­перссылки без пробелов указывается идентификатор раздела, на который осуществляется переход (рис. 5.1.1). Далее выделяем эти идентификаторы

и делаем шрифт скрытым. Сохра­ним этот файл под именем Helprtf.rtf.

Создание файла проекта справочной системы

Для создания справочной системы нужно вызвать утилиту Microsoft Help Workshop (файл Delphi5\Help\Tools\Hcw.exe). Далее выполним коман­ду File/New/Help Project и в окне сохранения файла укажем имя фай­ла проекта с расширением.HPJ, например, Help.hpj. В появившемся окне наж­мем кнопку Options и перейдем на страницу Files окна Options. В поле Help File ука­жем имя будущего файла справки (Help.hlp), в поле RTF Files ‑ имена RTF‑файлов с исходными текстами справки (Helprtf.rtf). Закроем окно Options и перейдем на страницу Map и нажмем кнопку Add. В поле Topic ID укажем идентификатор первого раздела (IDH_01), а в поле Mapped numeric value укажем его числовой номер (1) и нажмем клавишу OK. Снова нажмем клавишу Add для установки соответствия идентифика­тора IDH_02 номеру 2. Сохраним и закроем проект.

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

Выполним команду File/New/Help Contents. В поле Default Filename указывается имя файла.HLP, используемого по умолчанию. В поле Default title задается заголовок первого диалогового окна справки («Пример спра­воч­ной системы»). Кнопки Add Above / Add Below служат для добавления нового раздела справки выше/ниже текущего раздела. Нажмем кнопку Add Below, и появится окно Edit Contents Tab Entry. Установим переключатель Topic (Раздел). И заполним поля:

Title ‑ имя раздела в справке («Как сформировать расчетную ведомость «).

Topic ID ‑ идентификатор раздела («IDH_01»).

Help File ‑ имя файла.HLP справочной системы («Help.hlp»)

Процесс добавления раздела должен соответствовать процессу записи заголовков (папок), представленных в виде закрытой книги. Эти заголовки разворачиваются по двойному щелчку, показывая вложенный список разделов (до девяти уровней вложенности). Заголовки добавляются при установке переключателя Heading. Нажмем кнопку ОK. Нажмем кнопку Add Below для добавления второго раздела. Сохраним файл.CNT под именем Help.cnt.

Создание справочного файла для приложения

Откроем файл проекта Help.hpj, нажмем кнопку Files в окне Options и в поле Contents file укажем (выберем кнопкой Browse) файл Help.cnt и нажмем кнопку OK. Нажмем кнопку Compile. В окне компиляции установим переключатель Include.rtf filename and topic ID in Help file и нажмем кнопку Compile. Появится результирующий файл Help.hlp. Для проверки работы созданной справочной системы можно нажать кнопку Run WinHelp.

Корректировка справочного файла

При необходимости можно откорректировать исходный справочный файл.RTF, открыть проект справочной системы и откомпилировать его.

Присоединение справочного файла к приложению

Созданный справочный файл (Help.hlp) скопируйте в папку с приложением. После загрузки приложения выполните команду Project/ Options/Application. В поле Help file укажите имя справочного файла (Help.hlp). В свойствах HelpContext для соответствующих компонентов ука­жи­­те номера нужных разделов справочного файла (1, 2), вызываемых кла­ви­шей F1 (рис. 5.1.2). Полученный справочный файл можно исполь­зо­вать и в приложениях, разработанных с использованием других языков прог­рам­мирования (Visual Basic, С++).

Рис. 5.1.2. Окно созданной справочной системы

⇐ Предыдущая46474849505152535455Следующая ⇒

Поделиться:

Воспользуйтесь поиском по сайту: