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

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

Всплывание - миниразделы, используемые, чтобы отобразить небольшое количество информации в маленьком "всплывающем" окне, которое обычно отображается, когда пользователь нажимает на ссылку. Всплываение используется и в тексте справки непосредственно, и в приложениях, где они упоминаются как "контекстно-зависимое всплывание".

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

Для большего количества деталей относительно контекстно-зависимого всплывания смотрите Использование контекстно-зависимой справки и Контекстно-зависимая справка и всплывание.

НОВОСТИ: Winhelp больше не поддерживается в Windows Vista!

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

Как создавать всплывающий раздел:

1.	Нажмите в секции Невидимые разделы (ниже Содержания) в позиции, где Вы хотите вставить ваш раздел.

2.	Используйте любую из стандартных процедур чтобы создать новый раздел.

3.	Новые разделы в секции Невидимые разделы создаются как всплывающие разделы по умолчанию. Проверьте это выбором вкладки Опции раздела нового раздела. Тип справочного окна должен быть Popup в области Окно справки:.

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

Конфигурирование и редактирование всплывающих разделов:

То, как всплывающие разделы обработаны в вашем выводе, зависит от выходного формата, который Вы выбираете, и установки для выходного формата. Эти факторы также влияют на то, какие особенности поддержаны в ваших всплывающих разделах. Некоторые выходные форматы не поддерживают всплывание вообще, другие форматы поддерживают только простой текст ASCII без любого форматирования.

Всплывание поддерживается только в Справке HTML, Winhelp Заметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки., Броузерной справке и eBook. Они игнорируются во всех других форматах. См. ниже для полных деталей относительно поддержки всплывания в выходных форматах Help & Manual.

Справка HTML:

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

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

Вы можете создать форматированное всплывание в Справке HTML со справкой двойного режима, и всплывающим JavaScrip. См. ниже для деталей.

Winhelp:

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

Броузерная справка:

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

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

eBook:

Форматированное всплывание со ссылками и графика поддерживаются в eBook, но оно не конфигурируемо. Ссылки к всплывающим разделам в вашем проекте будут отображены автоматически, как отформатировано всплывание в eBook. Всплывание установлено по размеру автоматически на основе его содержимого, и оно использует установку цвета фона для Popup типа справочного окна в Проект > Свойства проекта > Окна справки.

Создание форматированного всплывания в Справке HTML:

"Родное" всплывание, поддерживаемое Справкой HTML - только простой текст - не поддерживает графику или форматированный текст, как всплывание в WinhelpЗаметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки. Help & Manual теперь предоставляет два других решения для этой проблемы - Справка двойного режима и JavaScrip всплывание:

Справка HTML двойного режима с всплывающим файлом Winhelp:

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

Это решение выводит все ваши всплывающие разделы в отдельный Winhelp .HLP файл, который должен находиться вместе с вашим файлом Справки HTML .CHM. Всплывающие ссылки в ваших разделах автоматически свяжутся с этим файлом. Контекстные всплывающие ссылки из вашего приложения должны обращаться непосредственно к файлу Winhelp .HLP, используя API Winhelp.

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

Гиперссылки раздела не поддерживаются в справке двойного режима – то есть Вы не можете включить ссылки на разделы в вашем основном файле справки во всплывании. (Невозможно связать разделы между файлами Справки HTML и Winhelp.)

Вы можете также использовать форматированный двойной режим всплывания, поскольку всплывающий контекст вызывается непосредственно в вашем приложении. См. Форматирование всплывающего контекста в Справке HTML в секции Дополнительных процедур.

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

·	Найдите Проект > Свойства проекта > Броузерная справка > Всплывающие разделы и выберите JavaScrip всплывающий.

·	Нажмите , чтобы конфигурировать ваше всплывание. (Всплывания JavaScrip настраиваемы!)

Больше деталей смотрите Использование всплывающих JavaScrip.

Управление шириной всплывающих разделов:

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

Управление шириной всплывания в Справке HTML:

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

Управление шириной всплывания в Winhelp, двойном режиме Справки HTML и JavaScrip всплывании:

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

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

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

Ссылка к всплывающему разделу из вашей справки:

Любая ссылка в пределах проекта к разделу с типом окна Popup будет автоматически отображена как всплывающее в любом из выходных форматов, где всплывание поддерживается ( Winhelp Заметьте, что Windows Vista не поддерживает Winhelp. Если Вы хотите быть совместимым с Vista, Вы должны перейти к другому формату справки., Справка HTML, eBook и Броузерная справка с активизированным JavaScrip всплыванием). Просто создайте нормальную ссылку к разделу. Вы больше не должны определять, что это всплывающая ссылка, как было необходимо в Help & Manual 3 и ранее.

Ссылка к всплывающему разделу из вашего приложения:

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

Всплывание простого текста Справки HTML:

·	Когда Вы экспортируете в Справку HTML с всплывающим простым текстом, Help & Manua, хранит текст всплывающих разделов во внутреннем текстовом файле в файле Справки HTML .CHM .

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

·	Запросы из вашего приложения к простому всплывающему тексту должны быть сделаны к этому файлу в пределах .CHM файла, используя стандартный синтаксис всплывания API Справки HTML.

Winhelp всплывание, и всплывание двойного режима Справки HTML:

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

·	Когда Вы создаете двойной режим всплывания в Справке HTML, всплывающие разделы сохранены в отдельном .HLP файле. Этот файл - стандартный файл Winhelp .HLP.

·	В обоих случаях всплывающие запросы из вашего приложения должны быть сделаны непосредственно к .HLP файлу, используя стандартный синтаксис всплывания API Winhelp (не API Справки HTML!).

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

странице обучающих программ на web сайте EC Software. Бесплатный набор инструментов для интерфейса справки и контекстно-зависимой справки Delphi Borland и Borland C++ также доступен на web сайте, на

странице ресурсов Delphi.

Где всплывание поддерживается:

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

Выходной формат

Поддерживаемые типы всплывания

Где поддерживается

Справка HTML (.CHM):

·	Простой всплывающий текст, интегрированный в основной файл справки.

·	Двойной режим форматированного всплывания, сохраненного во внешнем Winhelp .HLP файле.

·	Форматированное JavaScrip всплывание, сохраненное в основном файле справки.

Простой текст и форматированный двойной режим Winhelp всплывания поддерживаются и в тексте справки, и как контекстно-зависимое всплывание в приложениях.

Форматированное JavaScrip всплывание может использоваться только в тексте справки. Оно не поддерживается для контекстно-зависимой справки.

Winhelp (.HLP):

·	Полностью отформатированное Winhelp всплывание сохранено в основном файле справки.

Winhelp всплывание поддерживается и в тексте справки, и как контекстно-зависимое всплывание в приложениях.

HTML на основе броузера
(.HTM):

·	Полностью отформатированное JavaScrip всплывание интегрировано в отдельные файлы HTML.

JavaScrip всплывание может использоваться только в разделах справки. Вы не можете связаться с ними из вашего приложения.

Help & Manual eBook:

·	Полностью форматированное всплывание с графикой, шрифтами, акцентами (полужирный, курсивы и т.д.) и гиперссылками (на раздел и интернет-ссылки).

Доступно только в пределах eBook. eBook не поддерживают контекстные запросы любого вида из приложений.

Adobe PDF и печатные пользовательские руководства:

·	Всплывание не поддерживается. Всплывающие ссылки автоматически преобразуются в простой текст.

Word RTF:

·	Всплывание не поддерживается. Всплывающие ссылки автоматически преобразуются в простой текст.

См. также:

Использование JavaScrip всплывания

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

Контекстно-зависимая справка и всплывание (Справочная информация)