Глава 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. Окно созданной справочной системы
Дата добавления: 2016-03-22; просмотров: 649;