Добавил:
Upload Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
Плещёв ВУМИП 2012-07-06.doc
Скачиваний:
66
Добавлен:
13.05.2015
Размер:
9.35 Mб
Скачать

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

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

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

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

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

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

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

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

Для создания справочной системы нужно вызвать утилиту MicrosoftHelpWorkshop(файл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). Полученный справочный файл можно исполь­зо­вать и в приложениях, разработанных с использованием других языков прог­рам­мирования (VisualBasic, С++).

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