Разработка справочной системы (создание файлов .hip)_______________457

8.2.3.2 Переходы по ключевым словам

Имеется два макроса — KLink и ALink, которые позволяют переходить не к
заранее заданной теме, а к темам, в соответствующих сносках которых имеются
заданные ключевые слова. Если заданные слова встречаются в нескольких темах,
то пользователю показывается окно Найденные разделы (рис. 8.4) и он может сам
определиться, на какую тему ему уходить.

Хороший стиль программирования

В сложных справках лучше во многих случаях использовать макросы KLink и ALink (прежде
всего ALink) вместо непосредственных переходов. Эти макросы позволяют пользователю
при наличии нескольких родственных тем выбрать ту, которая его более интересует в дан-
ный момент).

Хороший стиль программирования

В темы полезно вводить ссылки вида «см. также», в которых с помощью макроса ALink пе-
речислять ключевые слова, связанные с данной темой. Это облегчает пользователю комп-
лексное изучение интересующего его вопроса.

Макросы KLink и ALink имеют одинаковый синтаксис и действуют одинако-
во. Оба они могут использоваться, в частности, вместо рассмотренных выше непо-
средственных ссылок на темы. Различие между этими макросами состоит в том,
что первый из них ищет заданные ключевые слова в К-ссылках, а второй — в
А-ссылках. Приведем синтаксис вызова макроса KLink (синтаксис ALink аналоги-
чен, только надо заменить KLink на ALink):

'^идентификатор темы>",

KLink("<список ключевых слов>"
<имя окна>)

<тип>,

<список ключевых слов> представляет собой одно или несколько ключевых
слов или словосочетаний, разделенных точками с запятой. Если хотя бы одно из
этих словосочетаний содержит запятую, то весь список заключается в двойные ка-
вычки. Поиск ведется в К-ссылках сначала по первому слову. Если нашлось неско-
лько тем, то пользователю показывается окно Найденные разделы. Если же не на-
шлось ни одной темы, начинается поиск по второму ключевому слову и т.д.

Все остальные элементы вызова макроса, кроме списка ключевых слов, явля-
ются не обязательными. <тип> определяет реакцию на найденные или ненайден-
ные ключевые слова и может принимать одно или несколько (разделяемых пробе-
лами) следующих значений:

Символическое	Численное	Описание
JUMP	1	Если найдена только одна тема, соответствующая ключевым словам, то на нее сразу осуществляется переход.
TITLE	2	Если ключевое слово находится более чем в одном файле справки (при справке, состоящей из нескольких файлов), то в окне Найденные разделы после названия темы пишется имя файла так, как оно определено в файле .cnt (см. раздел 8.3.3).
TEST	4	Макрос возвращает величину, указывающую, нашлось, или нет хотя бы одно соответствие ключевым словам.