Навигация:  Дополнительные процедуры> Использование контекстно-зависимой справки>

Контекстные запросы в броузерной справке

Печать этого раздела Предыдущая страницаВернуться к краткому обзору главыСледующая страница

В этом разделе:

Вы можете создать контекстно-зависимые запросы в Броузерную справку (web HTML) из вашего приложения или web страниц с нормальными URL, используя синтаксис, объясненный ниже. Эти запросы могут быть сделаны локально, через сети или через Интернет.

Однако, отметьте, что Вы не можете использовать всплывающий контекст самостоятельно, как в Winhelp или Справке HTML, потому что их всплывание - технология Microsoft, которая является неотъемлемой частью средств просмотра Справки HTML и справки Winhelp. JavaScript всплывание, поддерживаемое в Броузерной справке, может использоваться только в пределах вашей справки, Вы не можете сделать запрос к нему из вашего приложения или web страниц.

Как сделать запросы в разделы броузерной справки:

Запросы в броузерную справку должны быть нормальными запросами HTML, сделанными таким же образом, как любая другая ссылка URL, которая открывает броузер с определенным web местоположением или локальным файлом HTML, используя точно тот же синтаксис:

Синтаксис:

index.html?topicname.htm#anchorname

· Заметьте, что Help & Manual 4 использует стандартный символ #, чтобы отделить имя файла раздела и именованный якорь в ссылках к якорям (иногда также известным как закладки). Это отличается от HTML-броузерного вывода Help & Manual 3, где требовалась запятая!

Примеры:

Этот пример использует стандартные имена файлов и расширения и обращается к якорю в разделе, на который ссылаются:

index.html?introduction.htm#gettingstarted

Следующий пример показывает запрос в проект, который был компилирован с нестандартным именем индексного файла (см. Компиляция файла справки), и нестандартным расширением для файлов раздела (см. ниже). Нет никакой ссылки на якорь в этом примере.

help.html?new_features.html

Элементы запросов:

index.html

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

?topicname.htm

Это - имя раздела, который Вы хотите отобразить. Оно создано комбинацией ID раздела с расширением .htm.

Это - заданное по умолчанию расширение раздела, Вы можете изменить его в Проекте > Свойства проекта > Броузерная справка > Параметры экспорта HTML. (Эти установки разделены с другими HTML-основанными выходными форматами и можно также обратиться в разделы Справка HTML и Справка Visual Studio.)

#anchorname

(дополнительный) Это - имя якоря в разделе, куда Вы хотите перейти. Заметьте, что стандартный символ # теперь используется как разделитель вместо запятой, требуемой в Help & Manual 3!

Прямые запросы в файл topic.htm:

Теоретически Вы не должны включать файл index.html в запрос - если Вы делаете прямой запрос с форматом topicname.htm, или topicname.htm#anchorname, это автоматически отобразит всю систему справки с Содержанием.

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

Таким образом, всегда желательно использовать полный запрос, включая индексный файл, используя стандартный синтаксис:

index.html?introduction.htm#gettingstarted

См. также:

Создание всплывающих разделов

Контекстно-зависимая справка и всплывание

Организация невидимых разделов