|
Часть 2
ГЛАВА 1
ПРЕДОСТАВЛЕНИЕ ПОМОЩИ: СИСТЕМА HELP
Система Help обеспечивает пользователей интерактивной ин-
формацией о программе. Создание системы требует усилий как
разработчиков текстов Help, так и программистов Help. Разра-
ботчик текстов Help планирует, пишет, кодирует, создает и
отслеживает Help тематические файлы, которые являются тексто-
выми файлами, описывающими различные аспекты программы. Разра-
ботчик программы Help гарантирует, что система Help правильно
работает с программой.
В данной главе описываются следующие темы:
- Создание системы Help
- Как Help предоставляется пользователю
- Как Help предоставляется разработчику текста Help
- Как Help предоставляется программисту Help
Эта и последующие главы предполагают, что Вы знакомы с
Microsoft Windows Help. Эти главы используют примеры из учеб-
ных программ (написанных на С и Pascal), которые находятся на
Ваших дисках. Если Вы не знакомы с Windows Help, выберите мо-
мент для прогона примеров программ и используйте Helpex Help.
Создание системы Help : Цикл разработки программ
Создание системы Help для приложения Windows заключает в
себе следующие основные задачи:
1. Сбор информации для тем Help.
2. Планирование системы Help.
В главе 2 "Планирование системы Help" описываются сообра-
жения, необходимые Вам при планировании системы Help.
3. Написание текста для тем Help.
4. Введение всех требуемых кодов управления в текстовые
файлы.
Коды управления определяют, как пользователь может пере-
мещаться по системе Help. В раздел, озаглавленный "Как Help
представляется разработчику текста Help", включен пример из
нескольких управляющих кодов. В главе 3 "Создание Help темати-
ческих файлов" эти коды описываются более подробно.
5. Создание файла проекта для построения.
Help файл проекта обеспечивает информацию, которая необ-
ходима Help Compiler для построения Help файла ресурсов. В
главе 4 "Построение файла Help" описывается Help файл проекта.
6. Построение Help файла ресурсов.
Help файл ресурсов является компилированной версией тема-
тических файлов создаваемых разработчиком текста. В главе 4
"Построение файла Help" описывается как компилировать Help
файл ресурсов.
7. Тестирование и отладка системы Help.
8. Программирование приложения таким образом, чтобы она
могла иметь доступ к Windows Help.
Следующая блок - схема показывает основной рабочий поток
в концепции и разработке системы Help.
Рисунок 1.1 Диаграмма рабочего потока
ЪДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДї
і Соберите данные программного продукта из: і
і - Спецификации программного продукта і
і - Руководства "Справочника команд" или і
і "Справочника пользователя" і
і - Практической работы с программой і
і - Разрабатываемого программного обеспечения і
АДДДДДДДДДДДДДДДДДДДДДДДДВДДДДДДДДДДДДДДДДДДДДДДДДЩ
і
ЪДДДДДДДДДДДДДДДДДДДДДДДДБДДДДДДДДДДДДДДДДДДДДДДДДї
і Перечислите темы и создайте контур Help і
АДДДДДДДДДДДДДДДДДДДДДДДДВДДДДДДДДДДДДДДДДДДДДДДДДЩ
і
ЪДДДДДДДДДДДДДДДДДДДДДДДДБДДДДДДДДДДДДДДДДДДДДДДДДї
і Напишите программу с возможность доступа і
і к Help. Определите контекстно- і
і чувствительные добавочные блоки. і
АДДДДДДДДДДДДДДДДДДДДДДДДВДДДДДДДДДДДДДДДДДДДДДДДДЩ
і
ЪДДДДДДДДДДДДДДДДДДДДДДДДБДДДДДДДДДДДДДДДДДДДДДДДДї
і Напишите и отредактируйте текстовые файлы. і
і Введите управляющие коды для переходов и і
і определений. Определите контекстные строки, і
і заголовки, последовательные номера, і
і ключевые слова и признаки построения. і
АДДДДДДДДДДДДДДДДДДДДДДДДВДДДДДДДДДДДДДДДДДДДДДДДДЩ
і
ЪДДДДДДДДДДДДДДДДДДДДДДДДБДДДДДДДДДДДДДДДДДДДДДДДДї
і Перенесите файлы на ПВМ і
і (если необходимо) і
АДДДДДДДДДДДДДДДДДДДДДДДДВДДДДДДДДДДДДДДДДДДДДДДДДЩ
і
ЪДДДДДДДДДДДДДДДДДДДДДДДДБДДДДДДДДДДДДДДДДДДДДДДДДї
і Создайте Help файл проекта. і
і Установите соответствие контекстно- і
і чувствительных тем с контекстными номерами. і
і Прогоните программу Build. і
АДДДДДДДДДДДДДДДДДДДДДДДДВДДДДДДДДДДДДДДДДДДДДДДДДЩ
і
ЪДДДДДДДДДДДДДДДДДДДДДДДДБДДДДДДДДДДДДДДДДДДДДДДДДї
і Испытайте систему Help. і
і Выполните отладку и повторное испытание. і
АДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЩ
Как Help предоставляется пользователю
Для пользователя система Help представляется частью прог-
раммы, которая создается из текста и графических изображений,
выводимых в окне Help впереди программы.
На рисунке 1.2 показано окно Help, которое появляется на
экране когда пользователь запрашивает подсказку при копирова-
нии текста в Helpex.
Рисунок 1.2 Окно подсказки Helpex
ЙН[ю]НННННННННННННННННННННННННННННННННННННННННННННННН[ш][щ]Н»
є Help Example є
єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДє
є File Edit Help є
єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДє
є є
є є
є ЙН[ю]ННННННННННННННННННННННННННННН[ш][щ]Н» є
є є Help Example Help - helpex.hlp ш є
є єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД± є
є є File Edit Bookmark Help ± є
є єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД± є
є є Index Back Browse Browse Search ± є
є єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД± є
є єCopying Text ю є
є є ± є
є єЭто объясняет как копировать текст в и ± є
є єиз clipboard. ± є
є є(Эта тема связывается с ключевыми слова-± є
є єми "копировать" и "clipboard".) ± є
є є ± є
є є щ є
є И<ю±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±>ДЩ є
є є
є є
ИННННННННННННННННННННННННННННННННННННННННННННННННННННННННННДЩ
Окно Help выводит на экран один пример темы Help, частич-
ное описание того, как выполнить одну задачу. На рисунке 1.2
первое предложение включает определение слова "clipboard" (бу-
фер вырезанного изображения). Посредством нажатия кнопки мышки
в тот момент, когда курсор находится на слове (выделенном
пунктирной линией), пользователь может прочитать определение в
накладываемом окне, которое остается на экране до тех пор, по-
ка нажата кнопка мышки.
Перекрестные ссылки на соответствующие темы называются
операциями перехода.Нажав на кнопку мышки, чтобы выбрать тер-
мин перехода для соответствующей темы (отмеченной пунктирной
линией),пользователь изменяет содержание окна Help на описание
новой темы или команды. Рисунок 1.2 включает просмотр опреде-
ления "clipboard".
Как Help представляется разработчику текста Help
Для разработчика текста система Help является группой те-
матических файлов, которые представляют собой текстовые файлы,
включающие особые коды. На рисунке 1.3 показан исходный текст,
который соответствует теме, показанной на рисунке 1.2.
Рисунок 1.3 Тематический файл
ЙН[ю]НННННННННННННННННННННННННННННННННННННННННННННННН[ш][щ]Н»
є Microsoft Word - \HELP\HELPEX.RTF є
єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДє
єFile Edit Help View Insert Format Macro Window Helpє
єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДє
є Font: Ptr: є
єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДє
є Copying Text є
є є
є Это объясняет как копировать текст в и из clipboard. є
є (Эта тема связывается с ключевыми словами "копировать" иє
є "clipboard".) є
єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДє
є Deleting Text є
є є
є Это объясняет как удалить текст.(Эта тема связывается с є
є с ключевыми словами "копировать" и "clipboard".) є
єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДє
є Exiting є
є є
є Это объясняет как выйти из HelpEx. є
є є
є є
ИННННННННННННННННННННННННННННННННННННННННННННННННННННННННННДЩ
Для того, чтобы раскрыть эту тему, разработчик текста
Help описывает задачу, форматирует текст и вставляет коды,
использующие зачеркнутый и подчеркнутый текст и подстрочные
примечания. Вместо зачеркнутого текста разработчик может
использовать двойное подчеркивание, если текстовый процессор
не выполняет форматирование зачеркнутого текста. Подстрочные
примечания в тексте содержат информацию о редактировании, не-
обходимую для компилятора Help. В главе 2 "Планирование систе-
мы Help" обсуждаются проблемы форматирования.В главе 3 "Созда-
ние Help тематических файлов" описывается то, как создаются
темы и вводятся особые коды, которые использует система Help.
Как Help представляется программисту Help
Для программиста Windows Help автономной программой
Windows, которую пользователь может прогонять подобно любой
другой программе. Ваша программа может вызвать функцию
WinHelp для запроса Windows о выполнении программы Help и оп-
ределить какую тему вывести на дисплей в окно Help.
Смотрите главу 4 "Построение файла Help",где дается более
подробная информация о программном интерфейсе Help программы.
Резюме
Система Help создается из тем, связанных через гипер-
текст. Темы и связи появляются на экране для пользователя в
другом виде, чем для разработчика текста в тематическом файле.
Для программиста Help является автономной программой.
Для получения дополнительной информации относительно
соответствующих тем, смотрите следующие главы:
Тема Ссылка
ДДДДДДДДДДДДДДДДДДДД ДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
Кодируемые в Help Глава 3 "Создание Help
темы тематических файлов"
Компилирование файлов Глава 4 "Построение файла Help"
Help
|