|
Контекстные запросы в броузерной справке |
    |
|
Контекстные запросы в броузерной справке |
|
Вы можете создать контекстно-зависимые запросы в Броузерную справку (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
См. также: