|
Форматирование всплывающего контекста в Справке HTML |
    |
|
Форматирование всплывающего контекста в Справке HTML |
|
|
В этом разделе: |
|
Справка двойного режима с всплыванием Winhelp в Справке HTML Объединение всплывания контекста двойного режима с JS всплыванием |
Всплывание Справки HTML - только простой текст, оно не поддерживает графику или форматирование текста, как всплывание в Winhelp. Если Вы хотите отформатированное всплывание, Help & Manual может решить эту проблему для Вас, создавая справку "двойного режима" для Справки HTML, с .CHM файлом для основной справки и .HLP файлом Winhelp для всплывания. (Microsoft также использует этот метод в справке множества собственных приложений.)
| · | Новое JavaScript всплывание Help & Manual 4 не может использоваться для контекстно-зависимой справки, потому что оно не может быть вызвано непосредственно из приложений. Оно может быть вызвано только из ссылок в пределах вашей справки. |
|
|
НОВОСТИ: Winhelp больше не поддерживается в Windows Vista! Пожалуйста заметьте, что поддержка формату Winhelp была полностью прекращена в Microsoft Windows Vista. Даже если ваши приложения работают под Vista, какие-нибудь запросы в справку Winhelp просто произведут сообщение об ошибках. Это также относится к двойному режиму всплывания в Справке HTML. Мы таким образом строго рекомендуем, чтобы Вы начали переходить к альтернативному формату справки как можно скорее. См. здесь для деталей |
Как генерировать справку двойного режима с Winhelp всплыванием в HTML Help:
| 1. | Найдите Проект > Свойства проекта > Справка HTML > Всплывающие разделы и выберите Создать двойной справочный файл. |
| 2. | Заданное по умолчанию имя для .HLP файла, который будет сгенерирован для всплывания, - default_popup.hlp - Вы можете изменить его, если хотите. |
| · | Все остальное сделает Help & Manual. Дополнительный .HLP файл, содержащий ваше всплывание, будет теперь сгенерирован автоматически, когда Вы компилируете ваш вывод Справки HTML. Этот файл должен быть в дистрибутиве с вашим приложением, и это - файл, к которому программист должен обращаться, программируя контекстно-зависимую справку. Запросы в этот файл должны использовать конечно API Winhelp, а не API Справки HTML! |
| · | Помните, что Вы не можете использовать ссылки во всплывание в справке двойного режима. Ссылки между .HLP и .CHM файлами не поддержbdf.ncz. |
|
|
Что случилось? Всплывающий файл .HLP не генерируется!? Из-за неисправленной ошибки в компиляторе Winhelp Вы должны иметь минимальное число всплывающих разделов в вашей секции Невидимых разделов для справки двойного режима. Если ваш .HLP файл не генерируется, когда Вы компилируете, добавьте только два или три пустых фиктивных всплывающих раздела к вашей секции Невидимых разделов. |
Как использовать всплывание контекста двойного режима и JavaScript всплывание:
Новое JavaScript всплывание Help & Manual не может использоваться для контекстной справки, потому что не может быть вызвано из приложений. Если JavaScript всплывание активизировано в вашем проекте, Вы не можете генерировать двурежимный .HLP файл для вашего всплывания из того же проекта. Самое простое решение для этой проблемы состоит в том, чтобы использовать двойной режим всплывания вместо всплывания JavaScript. Потом Вы можете форматировать всплывание и в вашей справке, и в контекстно-зависимом всплывании, вызванном из вашего приложения.
Однако, если Вы хотите использовать особенности всплывания JavaScript в вашем файле справки и форматировать контекстное всплывание, Вы можете сделать это, создавая отдельный проект Winhelp для вашего всплывающего контекста:
| 1. | Сконфигурируйте всплывание JavaScript и используйте его для всплывания в ваших разделах справки. |
| 2. | Создайте отдельный проект Help & Manual для ваших контекстных всплывающих разделов. |
| 3. | В этом проекте не создавайте никаких разделов в секции Содержание. Создайте все ваши всплывающие разделы в секции Невидимые разделы. |
| 4. | Компилируйте этот проект непосредственно как Winhelp. Это генерирует файл .HLP Winhelp, содержащий только ваши отформатированные всплывающие разделы. |
| 5. | Разместите этот .HLP файл вместе с вашим файлом Справки HTML .CHM. Все контекстные всплывающие запросы из вашего приложения должны быть сделаны к .HLP файлу, используя API Winhelp. (Всплывание JavaScript сохранено в .CHM, таким образом Вы разместить только два файла.) |
См. также:
Контекстно-зависимая справка и всплывание
