Шестая лаба, страница 2

Рисунок 4- Настройка содержания нового проекта справочной системы

1. Для подключения файла справки к приложению запустите C++Builder и начните новый проект. Выберите в меню команду Project - Options и в появившемся окне диалога выберите страницу Application (рис. 5). Щелкните на кнопке Browse... справа от редактора строки Help file и укажите HLP-файл, который вы только что создали. Закройте окно диалога Project Options, щелкнув на кнопке ОК.

Рисунок 5 – Подключение файла справки к приложению C++ Builder

1. Для того, чтобы открыть справочник программным способом, например по нажатию кнопки Help или при выборе команды меню Help | Help Topics, вызывается один из следующих методов объекта Application: HelpCommand, HelpContext, HelpJump. В каждом приложении автоматически создается объект Application типа TApplication — приложение. Этот компонент отсутствует в палитре библиотеки, вероятно, только потому, что он всегда один в приложении. Application имеет ряд свойств, методов, событий, характеризующих приложение в целом.

• Метод HelpContext: вызывает переход в файл справки на тему с идентификатором Context. Это идентификатор, который при проектировании справки поставлен в соответствие некоторой теме.

• Метод HelpJump выполняет аналогичные действия, но его параметр JumpID — не идентификатор темы, а имя соответствующей темы в файле справки, задаваемое в нем сноской #.

• Метод HelpCommand позволяет выполнить указанную параметром Command команду API WinHelp с параметром Data. Метод генерирует событие OnHelp активной формы или приложения, а затем выполняет указанную команду WinHelp.

• Команда HELP_CONTENTS с параметром 0 отображает окно Содержание справки.

• Команда HELP_INDEX с параметром 0 отображает окно Указатель справки.

• Команда HELP_CONTEXT с параметром, равным идентификатору темы, отображает тему с заданным идентификатором (это тождественно рассмотренному ранее методу HelpContext).

• Команда HELP_CONTEXTPOPUP с параметром, равным идентификатору темы, делает то же самое, но отображает тему во всплывающем окне.

Полный список команд WinHelp вы можете найти в теме WinHelp справочного файла win32.hlp, расположенного в каталоге ...\Program Files\Common Files\Borland Shared\MSHelp.

Например, метод обработки команды меню Help | Help Topics может выглядеть так:

void _fastcall TForml::HelpTopicsItemClick(TObject *Sender)
{
Application->HelpCommand(HELP_CONTEXT,0);

}

3 Задание на лабораторную работу

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

4 Порядок выполнения работы

4.1 Создать глоссарий – перечень уникальных понятий, используемых в приложении и его интерфейсе. В качестве примера таковых могут выступать названия элементов меню, окон, режимов, текст командных кнопок и т.д. Работа над созданием глоссария требует контакта с целевой аудиторией. Это нужно, чтобы описания понятий не содержали многозначности при восприятии их потенциальными пользователями. Недопустимо наличие различных терминов для определения одного и того же понятия. Описание понятий должно отвечать промышленному руководству, соответствующему выбранной платформе (MS Microsoft).

4.2 Добавить в глоссарий описания общей концепции приложения, ее функциональности в целом, а также отдельных функций, предоставляемых пользователю для выполнения (обзорная справка).

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

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

4.5 Определить разделы, которые должны быть включены в содержание и предметный указатель справочной системы.

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

4.7 Сформировать файл тем справок в виде файла *.rtf .

4.8 Сформировать файл справочной системы *.hlp, создав файл Проекта справки и откомпилировав его средствами программы MS Help Workshop (HCRTF).

4.9 Используя те же средства создания справочной системы, сформировать файл содержания *.cnt.

4.10 Подключить проект справки к приложению, разработанному на лабораторной работе №5.

5 Требования к оформлению отчета

Отчет по лабораторной работе должен содержать:

• цель работы;

• описание приложения (вариант задания);

• структуру справочной системы;

• комментарии, поясняющие содержание обзорной, предметной и процедурной справок;

• текст файла тем справок в формате rtf (включая скрытый текст);

• обоснования применения использованных в файле сносок;

• выводы по работе.

При защите лабораторной работы необходимо представить электронные версии разработанных файлов *.hlp и *.cnt.