О контекстно-зависимом всплывании

Контекстно-зависимое всплывание отображается непосредственно из вашего приложения (щелкните правой кнопкой мыши на каком-нибудь управлении в Help & Manual и выберите Что это?, чтобы увидеть пример).

Первая вещь, которую нужно понять, что контекстно-зависимое всплывание - фактически такие же разделы, как обычные всплывающие разделы, отображенные в пределах вашей справки. В вашем проекте Help & Manual те же всплывающие разделы в секции Невидимые разделы могут использоваться в обеих целях. Основное различие - то, как они вызваны:

·	Обычные всплывающие разделы отображены в пределах справки, когда пользователь нажимает на ссылку в разделе - например, чтобы отобразить определение или объяснение.

·	Контекстно-зависимые всплывающие разделы вызваны непосредственно приложением и отображены в небольших собственных окнах. Это сделано, не отображая остальную часть справки вообще. Отображается только небольшое всплывающее окно, и оно закрывается, как только пользователь нажимает на нем.

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

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

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

Пример слева показывает всплывающий раздел, отображенный в приложении. Он отображен самостоятельно, без основного файла справки.

Точно то же всплывание могло также быть отображено в пределах справки со всплывающей ссылкой. Это выглядело бы почти идентично - только в справке это обычно будет белым вместо желтого. (Это диктует средство просмотра справки и не управляется изнутри Help & Manual.)

Пример выше использует справку двойного режима, которая позволяет использовать всплывание с форматированным текстом в Справке HTML. Поэтому возможно для всплывания иметь заголовок с полужирным текстом. Однако, отметьте, что Windows Vista не включает поддержку Winhelp, так, если Vista важна для Вас, не используйте справку двойного режима больше.

·	Help & Manual 4 также поддерживает новую технологию по имени JavaScript всплывание для отформатированного всплывания в Справке HTML и Броузерной справке. JavaScript всплывание не может использоваться для контекстно-зависимой справки.

О создании контекстно-зависимого всплывания:

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

Также важно понять, что только Winhelp и Справка HTML могут использоваться для контекстно-зависимого всплывания, вызванного непосредственно из приложений и отображенного в приложениях. См. Всплывание в Winhelp и Справке HTML для большего количества деталей относительно того, как всплывание обработано в этих выходных форматах.

Наконец, если Вы пишете контекстно-зависимое всплывание для приложения, Вам, вероятно, придется произвести много всплываний. Вы можете сэкономить себе много работы, генерируя ваше контекстно-зависимое всплывание автоматически.

В Winhelp:

В WinhelpЗаметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. Вы не должны конфигурировать что - нибудь, чтобы генерировать контекстно-зависимое всплывание. Всплывающие разделы в секции Невидимые разделы будут объединены в основном файле справки и поддерживают форматированный текст, графику и ссылки. Контекстно-зависимые запросы делаются непосредственно к разделам в основном файле справки.

В Справке HTML:

В Справке HTML Вы можете выбрать из четырех разных всплывающих режимов. Только два из этих режимов могут использоваться для контекстно-зависимого всплывания, вызванного из приложений, таким образом Вы должны выбрать один из этих режимов:

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

Режимы, поддерживающие контекстно-зависимое всплывание:

Всплывающий текст:

Это - "родной" всплывающий режим Справки HTML. Всплывание сохранено в основном файле справки во внутреннем простом текстовом файле, который называется CSHelp.txt по умолчанию (Вы можете изменить это). Запросы сделаны к этому файлу, используя стандартный синтаксис API Справки HTML всплывающих запросов. Никакая графика, ссылки или форматированный текст (полужирный, курсив и т.д.) не поддерживается.

Справка двойного режима:

Если Вы выбираете этот режим, Help & Manual экспортирует все всплывающие разделы из секции Невидимые разделы в отдельный файл WinhelpЗаметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. .HLP. Разделы в Невидимых разделах с другими типами справочного окна (установлены в их вкладках Опции раздела) не включены в этот файл. Запросы в разделы сделаны к этому .HLP файлу, используя стандартный Winhelp синтаксис всплывающих запросов.

Подсказка:
Вы можете достигнуть точно того же результата, создавая отдельный проект Winhelp для ваших всплывающих разделов. Просто создайте ваши всплывающие разделы в секции Невидимые разделы, оставьте секцию Содержания пустой и компилируйте как Winhelp. Здесь также, запросы в .HLP файл из вашего приложения сделаны, используя стандартный Winhelp синтаксис всплывающих запросов.

Вы можете использовать этот подход, чтобы использовать JavaScript всплывание в вашей справке, и Winhelp всплывание для контекстных запросов из вашего приложения. См. здесь для деталей.

Режимы, не поддерживающие контекстно-зависимое всплывание:

Закодированный HTML всплывает:

Этот режим выводит всплывающие разделы как нормальные разделы, которые отображены в основном окне средства просмотра Справки HTML. Они - в основном только невидимые разделы, использующие шаблон типа окна Popup. Этот режим не может использоваться для контекстно-зависимого всплывания, вызванного из приложений, потому что разделы не всплывают в действительности, они - обычные разделы.

JavaScript всплывание:

Этот новый всплывающий режим использует кодирование JavaScript, чтобы генерировать всплывание, которое может содержать форматированный текст, ссылки, графику и даже видео и анимацию. Оно также поддерживает графические эффекты и переходы (постепенное появление изображения и т.д.), и могут использоваться и в Справке HTML, и в Броузерной справке. Однако, JavaScript всплывание также не может использоваться, как контекстно-зависимое всплывание, вызванное из приложений. См. Использование JavaScript всплывания для деталей.

См. также:

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

Использование контекстно-зависимой справки

ID, контекстные числа и ключевые слова