Лекция 7.1 Создание файла справки в формате WinHelp4

Утилита Winhelp.exe предназначена для просмотра справочных файлов имеющих расширение *.hlp. Данная система используется начиная с Windows 3.0 и несмотря на то, что является устаревшей поддерживается до сих пор.

Основные элементы справочной системы WinHelp 4

Файл справки в формате WinHelp состоит из нескольких элементов, которые создаются во время разработки справочной системы. Рассмотрим их более подробно:

· Тема (topic) – основной элемент справочной системы представляющая собой ее фрагмент и отображаемая в окне winhelp.exe. Тема может содержать текст, таблицы, графические изображения и кнопки. Темы могут быть связаны между собой перекрестными ссылками. Каждая тема, кроме строкового идентификатора, может иметь числовой идентификатор, набор ключевых слов, по которым ее можно найти, а также ссылки на другие темы.

· Раздел (heading) представляет собой группу тем или вложенных разделов.

· Перекрестные ссылки. При разработке справочной системы можно создать ссылку на другую тему либо на временное окно. Временное окно обычно используется для пояснения термина. Можно также создавать ссылки, отображающие тему во вторичном окне.

· Содержание – представляет собой обычную тему, но содержит прямые или косвенные ссылки на остальные темы и обычно помещается в отдельный файл с расширением .cnt, имеющий такое же имя, как и файл справки. Содержание отображается в специальном окне Help Topics и представляет собой дерево тем.

· Окна. Поясняющий текст в системе WinHelp 4 может отображаться в окнах нескольких видов. Наиболее часто применяются три типа окон:

ü основное окно – служит для отображения текста выбранной темы;

ü вторичное окно – используется для показа дополнительной информации, например, перекрестных ссылок.

ü всплывающее (pop-up) окно - используется для вывода пояснений к терминам и для организации контекстно-зависимой справки. Возможно создание до 255 различных классов вторичных окон, а отдельные темы можно связывать с определенным стилем окна.

· Кнопки и макрокоманды. В тексте справки справочной системы можно определить кнопки нескольких типов, предназначенные для выполнения перехода, вызова всплывающего меню или макрокоманды.

Основные макрокоманды WinHelp 4:

ü Link – переход к теме, соответствующей обычным ключевым словам. Если таких тем несколько, то открывается окно найденных разделов, где пользователь может выбрать тему для просмотра;

ü ALink – переход к теме, соответствующей скрытым ключевым словам. Если таких тем несколько, то открывается окно найденных разделов…

ü Find – открывает окно диалога Help Topics с вкладкой Поиск;

ü ExecFile – запускает указанную программу;

ü ShellExecute – запускает указанную программу, печатает файл или открывает файл с помощью связанной с ним программы;

ü Shortcut – запускает указанную программу, если она не запущена, или делает ее активной и передает ей сообщение WM_COMMAND, если программа запущена;

ü MPrintID – печатает тему;

ü BrowseButtons – добавляет к окну справки кнопки просмотра вперед и назад (>> и и » и имя окна. Окно с указанным именем необходимо будет создать на этапе компиляции справочной системы.

Имеется возможность выполнения ссылки на раздел другого справочного файла, для этого после идентификатора темы указывается символ «@», а затем имя справочного файла. Раздел другого справочного файла также может быть показан во временном или вторичном окне.

Примеры реализации ссылок:

1. Описание работы приложенияDescription – ссылка на обычную тему с идентификатором Description.

2. Описание работы приложенияDescription – ссылка открывает тему с идентификатором Description во временном окне справки.

3.

4. Описание работы приложенияDescription>@MyProgramm.hlp – ссылка открывает тему с идентификатором Description расположенную в другом файле справки с именем MyProgramm.hlp

В вышеуказанных примерах правая часть (идентификатор темы и т.д.) оформляется как скрытый текст. Идентификатор темы должен существовать, т.е. должен быть задан сноской #.

Для задания создания переходов по ключевым словам следует использовать макросы KLink и ALink. Оба этих макроса действуют одинаково и имеют одинаковый синтаксис. Различие заключается только в том, что они производят поиск по разным ключевым словам: KLink – по ключевым словам, заданным с помощью сносок К, а ALink – ключевым словам, заданным с помощью сносок А. Рассмотрим пример использования макроса KLink:

! Klink (, тип>, идентификатор темы>,)

· разделяются точкой с запятой (обязательный параметр). Если одно из ключевых слов содержит запятую, то весь список заключается в кавычки. Если при поиске будет найдено несколько тем, то откроется окно Найденные разделы;

· определяет вид действия макроса при обнаружении одного или нескольких ключевых слов. Этот параметр может принимать одно или несколько (разделенных пробелами) следующих значений (можно использовать как символьные, так и числовые значения):

ü JUMP (1) - если найдена только одна тема, то на нее сразу производится переход;

ü TITLE (2) - если ключевые слова найдены более чем в одном файле, то отображается окно Найденные разделы;

ü TEST (4) - возвращает значение, показывающее, нашлось ли хотя бы одно соответствие заданным ключевым словам.

· определяет тему, на которую будет осуществлен переход, если ни одно из ключевых слов не найдено;

· определяет окно для отображения темы. Если параметр не указан, то используется окно, заданное при описании темы или по умолчанию.

При использовании макросов ссылка создается точно так же, как и при прямом переходе, только вместо идентификатора темы задается вызов макроса.

Пример простого rtf-документа содержащего тексты тем:

-------------------------------------- начало документа rtf ---------------------------

^{# $ K} Общие сведения о программе

Эта программа представляет собой несложный текстовый редактор для работы с файлами формата ТХТ и подходит для создания простых документов.

Программа не поддерживает форматирования документов.

ДалееTopic2 ---------2 – оформляется скрытым текстом---------

------------ сноска ----------

^# Topic1

^$ Общие сведения о программе

^K Общие сведения о программе

-------------------------------------- разрыв страницы --------------------------------

^{# $ K} Поиск и замена

Для реализации поиска необходимо выполнить команду главного меню приложения Правка – Поиск и в раскрывшемся окне «Поиск» ввести искомое выражения и установить параметры и направление поиска.

Для реализации замены необходимо выполнить команду главного меню приложения Правка – Заменить. В раскрывшемся окне диалога введите искомое выражение и выражение замены. Нажмите кнопку ОК.

НазадTopic1 --------1 – оформляется скрытым текстом--------

------------ сноска ----------

^# Topic2

^$ Поиск и замена

^K Поиск и замена

-------------------------------------- конец документа rtf -----------------------------

Вопросы для самоконтроля

1. Какие средства создания справочной системы вызнаете?

2. Какие основные элементы справочной системы вы знаете?

3. Какие типы окон поддерживает WinHelp4?

4. Для чего необходимы атрибуты тем?

5. Из каких частей состоит ссылка и как она оформляется?