О числах справочного контекста

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

Введение:

Как ID раздела, числа контекста могут быть рассмотрены и отредактированы во вкладке Опции раздела каждого раздела. Они отображены в области Номер контекстной справки:. Вы можете ввести и редактировать их там, но они могут также быть назначены автоматически. См. Назначение чисел справочного контекста для деталей.

Числа контекста справки были начаты в WinhelpЗаметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. как основной способ сделать запросы приложения к разделам справки. Много программистов и языков программирования используют их, но они фактически стали менее популярными в последние годы. Так как они являются числами, они не "очень благоприятны для человека", и весьма просто для программиста сделать запрос в неправильное число справочного контекста и не обратить внимание на это.

Самые современные языки программирования могут сделать запросы непосредственно к ID раздела и в Справке HTML, и в Winhelp, не используя контекстные числа вообще. ID раздела являются полностью алфавитно-цифровыми и могут быть до 256 символов длиной, что означает, что они могут быть описательными и удобочитаемыми.

Диапазон числел контекста справки:

Числа контекста справки сохранены как 4-байтовые целые числа без знака. Это означает, что Вы можете ввести значения между 0 и 4294967295. Это дает Вам почти 4.3 миллиарда уникальных чисел, чего должно быть достаточно для большинства проектов справки.

Форматы справки, которые используют контекстные числа:

Числа контекста справки используются только для запросов из приложений к разделам в вашей справке в Winhelp и Справке HTML. Они не используются для внутренних гиперссылок в пределах вашего проекта справки.

Контекстные числа в якорях:

В дополнение к контекстным числам разделов, Help & Manual также позволяет Вам назначать числа справочного контекста на якоря. Это позволяет сделать прямые контекстные запросы приложения в определенные пункты в пределах разделов вместо того, чтобы только открыть раздел наверху.

Совместимость и синтаксис запроса:

Вывод Справки HTML и Winhelp Help & Manual сгенерирован непосредственно компиляторами Microsoft и на 100 % совместим со всеми стандартами Справки HTML и Winhelp. Это также включает формат и синтаксис чисел справочного контекста. Если ваш проект содержит числа справочного контекста, Вы можете сделать запросы к ним со стандартным синтаксисом API Справки HTML и Winhelp.

Для деталей относительно создания запросов к числам справочного контекста см. документацию Microsoft Help Workshop для Winhelp и Microsoft HTML Help Workshop для Справки HTML. В дополнение к этому Вы можете также найти некоторые полезные обучающие программы для программистов на web сайте EC Software, которые объясняют, как связать с помощью интерфейса Winhelp и Справку HTML с диапазоном общих языков программирования.

См. также:

Назначение чисел справочного контекста

Изменение ID раздела и чисел справочного контекста