Построение контекстной справки помощи

Размещено на http://www.allbest.ru/

Построение контекстной справки помощи



Содержание

Введение

Разработка файлов справки

Статьи справки и RTF-формат

Файл проекта помощи

Файл оглавления справки

Компиляция справки

Вызов справки из Приложений

Заключение



Введение

Пользователи Windows-приложений ожидают интерфейсы, позволяющие им продуктивно работать, даже если они используют приложение впервые. Длинный период обучения и большие, сложные руководства пользователя - всё это не свойственно современным приложениям.

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

Windows предлагает большое число инструментов, помогающих в разработке контекстно-зависимых файлов справки на профессиональном уровне. Среди них - программа WinHelp, WinHelp API (Applications Programming Interface), а также способность Windows назначать идентификаторы контекстной справки для различных элементов интерфейса пользователя.

Для MFC-приложения, AppWizard (Applications Wizard) можно заставить создать скелет файла-справки. AppWizard-сгенерированная справка может также быть добавлена к приложениям, которые были первоначально созданы без контекстно-зависимой справки.

Разработка файлов справки не намного проще, чем разработка самого приложения под Windows. Система разработчика программного обеспечения Visual C++ сейчас включает в себя Microsoft Help Workshop, интегрированный инструмент, который помогает вам поддерживать и управлять проектами справки.

Сначала мы попытаемся исследовать свойства WinHelp - интерактивную справочную систему Windows. Затем, мы сделаем обзор правил построения статей для файлов справки. Наконец, мы исследуем Help Workshop и коснёмся вопросов формирования содержания и управления справкой. При разработке файла-справки необходимо всегда принимать во внимание аудиторию, для которой разрабатывается справочная система. Несмотря на сложившуюся традицию снабжать справочную систему той же информацией, что и напечатанная документация, справочная система должна более детально подходить к рассмотрению нюансов работы с элементами интерфейса, т.к. документацию всегда читать очень тоскливо. Но все равно, интерактивный текст, использующий гипертекст, всегда трудно воспринимается, поэтому, рекомендуется, проектировать статьи справки так, чтобы информация охватывала все нюансы и излагалась коротко.



Разработка файлов справки

Справочные файлы - это файлы гипертекста, которые поддерживаются специальным приложением Windows - WinHelp.exe. Построение справочного файла - процесс, состоящий из нескольких этапов. Сначала с помощью текстового редактора разрабатываются статьи справки, хранящиеся в RTF-формате (рекомендуется хранить тексты статей в двух форматах, в RTF и, например, в формате Microsoft Word, т.к. этот мощный текстовый процессор предоставляет большие возможности по редактированию и созданию статей, а постоянное преобразование информации в RTF-формат занимает обычно некоторое время). Затем необходимо создать файл-проект справки (HPJ); этот файл идентифицирует тематические разделы справки и другие компоненты, входящие в проект файла справки. После этого создаются дополнительные файлы, например, файлы с растровыми изображениями. В заключение файл проекта необходимо скомпилировать, используя Microsoft Help Compiler.

Окончательная версия справочной системы может включать в себя даже DLL-библиотеки и файл содержания справки. Рисунок 1 иллюстрирует этот процесс, идентифицирует различные элементы проекта справки и инструментов, используемых в процессе разработки.



Рисунок 1. Этапы разработки файла-справки

Файлы-справки могут вызываться из приложений разными способами. Приложения могут вызывать справку в ответ на выбор элементов справочного меню, нажимая клавишу F1, или используя режим справки, нажимая Shift+F1. Во всех этих случаях, справка фактически вызывается при обращении к функции WinHelp.

Статьи справки и RTF-формат

RTF-файлы состоят из печатных символов ASCII; формат файла явно не "дружественен", но, что удивительно, читаем. Редактировать текст в формате RTF можно с помощью любого текстового редактора ASCII.

Независимо от используемого вами редактора, Windows Help Compiler обрабатывает RTF-файлы точно таким же способом. Он читает вводимый текст, но некоторые текстовые атрибуты трактует по-своему. Например, текст, который отмечен двойным подчёркиванием, интерпретируется как текст, отмечающий переход к другой статье.

Смотрите на пример (Листинг 1), показывающий очень простой файл статьи справки, содержащий только две статьи (текст статей на английском языке, т.к. использование русского ещё более ужасно выглядело бы в RTF-формате).

Листинг 1 Простой файл со статьями справки

{\rtf1\ansi

{\fonttbl\f0\fswiss MS Sans Serif;}

\deff0\fs20

#{\footnote #H_CONTENTS}

${\footnote $Help Contents}

K{\footnote KContents}

\keepn\brdth\fs28

Help Contents

\par\pard\fs20\sb30

This is the Help Contents page/ To see more help? click on

{\uldb Overview}{\v H_OVERVIEW}.

\par\pard

\page

#{\footnote #H_OVERVIEW}

${\footnote $Help Overview}

K{\footnote KOverview}

!{\footnote !PositionWindow(256,256,512,512,1,"main")}

\keepn\brdrb\fs28

Help Overview

\par\pard\fs20\sb30

This is the Help Overview page. To see more help, click on

{\uldb Contents}{\v H_CONTENTS}.

\par

To see the a macro at work, click on {\ul About}{\v !About()}.

}

В начале этого файла, \rtf1\ansi идентифицирует RTF номер версии и ANSI набор символов. Эта часть обязательна для всех статей справки. Следующая строка определяет таблицу шрифтов. Таблица шрифтов в нашем примере состоит только из одного шрифта. Этот шрифт устанавливается как шрифт по умолчанию в 3 строчке.

Инструкция \footnote в следующих трёх строках имеют большое значение в файле статьи. Справочная система использует сноски различных типов, чтобы индексировать текст справки и идентифицировать ключевые слова статьи. Тип информации, определённой сноски зависит от символа сноски. В приведенном примере, знак '#' идентифицирует статью (используя текст сноски можно обратиться к статье). 'К' сноска определяет ключевое слово; '$' сноска определяет заголовок статьи, который будет отображаться справочной системой как заголовок окна.

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

Рисунок 2. Пример статьи справки

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

Эти коды и огромное число других, которые распознаются справочной системой, можно легко сгенерировать с помощью RTF-редактора. Например, команда \ul представляет подчёркнутый текст; \uldb - двойное подчёркивание.

Статьи, которые были приведены в Листинге 1, появляются в Microsoft Word'97 в форме, показанном на рис. 3.

Рисунок 3. Редактирование статьи, используя Word'97

Справочная система распознаёт команды, которые не принадлежат к стандартному формату RTF. Эти команды связаны с точечными рисунками и DLL-библиотеками. Например, команда bmc может использоваться, чтобы внедрить точечный рисунок в текст. Правда, эти спецкоманды имеют особенный синтаксис. Фигурным скобкам, которые обычно включают команды RTF, должен предшествовать обратный слеш (\). Кроме того, обратный слеш (\), который обычно предшествует командам RTF, нужно пропустить. Например:

\{bmc bitmap.bmp\}

Этот специальный синтаксис даёт возможность таким командам быть включенными при использовании RTF текстового процессора. Просто включите команду с фигурными скобками, но без слешей:

{bmc bitmap.bmp}

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

RTF-файл, показанный в Листинге 1, также содержит несколько макросов. Подробнее о макросах мы поговорим ниже.

Файл проекта помощи

Каждый проект справки должен иметь файл проекта-справки. Этот файл необходим компилятору справки. Файл проекта справки обычно имеет расширение HPJ. Типичный файл проекта-справки, используемый для компиляции статей, показанный ранее, приведен в Листинге 2.

Листинг 2 Простой файл проекта справки

CONTENTS=H_CONTENTS

TITLE=Test Help File

COMPRESS=OFF

[WINDOWS]

main=,,,(255,255,192),(192,192,192)

[FILES]

HLP.RTF

[CONFIG]

CreateButton("about", "About", "About()")

[MAP]

H_CONTENTS 10000

H_OVERVIEW 10100

Наиболее важным элементом файла-проекта является раздел [FILE]. В нём объявлены все RTF-файлы, содержащие статьи. Другие разделы, такие как [OPTIONS] и [WINDOWS], определяют вид справочного файла и его поведение.

Раздел [WINDOWS] можно также использовать, чтобы определить вторичные окна справки. Такие окна могут упоминаться в файлах статей, чтобы отобразить специфические статьи в отдельном окне. Возможно определение, как типа окна, так и его местоположение.

Раздел [CONFIG] содержит определяемые макрокоманды, которые выполняются при запуске справочного файла или конкретного окна. Более детально об этом ниже.

Раздел [MAP] связывает строки контекста ассоциаций раздела с идентификаторами контекста.

Идентификаторы контекста могут передаваться WinHelp приложениям, вызывающим справку.

Отображения могут быть созданы вручную, или, в случае MFC приложений, автоматически, с помощью утилиты makehm.exe. Эта утилита использует resource.h файл MFC проекта, чтобы создать отображение для всех элементов ресурса в проекте.

Файлы проекта справки могут также содержать директивы #include. Например, AppWizard-сгенерированные файлы проекта справки обращаются к отображениям контекста, которые сохранены в отдельных файлах.

Файл оглавления справки

Новая версия WinHelp, версия 4.0, может использовать отдельную вкладку (TabSheet) Оглавление (см. рис. 4).

Оглавление создаётся из отдельного файла, с именем как у файла-справки, но с расширением CNT.

Рисунок 4. Оглавление справки

Файл оглавления, используемый для генерации оглавления (рис. 4) показан в Листинге 3.

Листинг 3 Простой файл оглавления справки

:Base HLP.hlp

1 Help Topics

2 Contents=H_CONTENTS

2 Overview=H_OVERVIEW

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

Компиляция справки

Все ранее описанные элементы собираются вместе, когда вы вызываете Windows Help Compiler, чтобы сгенерировать справочный файл приложения. Имя нового компилятора справки hcrtf.exe. Эта программа может вызываться непосредственно, или как часть Microsoft Help WorkShop. Чтобы скомпилировать справочный файл из командной строки, введите команду: hcrtf -x hlp.hpj

Макросы и библиотеки динамической связи (DLL)

Справочная система Windows предлагает ряд макрокоманд, которые могут использоваться, чтобы расширить возможности справочного файла. Макросы могут использоваться тремя способами: они могут быть выполнены, когда справочный файл загружен, при отображении статьи справки, или когда выбрана "горячая точка" пользователем. Кроме того, некоторые макрокоманды (например, CreateButton, AppendItem) используют другие макрокоманды в качестве параметров, т.е. эти макрокоманды выполняются при активизации элемента.

Для того, чтобы создать макрос, запускающийся при загрузке справки, необходимо добавить в секцию [CONFIG] макрокоманду. Например, следующий раздел [CONFIG] в файле проекта создаёт кнопку, которая вызывает информацию о справке:

[CONFIG]

CreateButton("about", "About", "About()")

Чтобы вызвать макрокоманду, при отображении статьи, необходимо добавить сноску к статье с меткой восклицательный знак (!) как символ сноски. Например, следующая строка, добавленная к статье, заставляет окно справки расположиться по центру экрана, при каждом выводе статьи справки:

!{\footnote !PositionWindow(256,256,512,512,1,"main")}

Третий метод вызова макроса справки - добавление макроссылки к "горячей точке". Следующий пример, выводит справочную информацию о справке, когда "горячая точка" выбрана пользователем:

To see the a macro at work, click on {\ul About}{\v !About()}.

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

Кроме этого файлы-справки могут вызывать функции из DLL-библиотек. Функции DLL должны быть зарегистрированы перед использованием; для регистрации, пользуйтесь макрокомандой RegisterRoutine. Обычно, эту макрокоманду вызывают из раздела [CONFIG] вашего проекта справки; таким образом, DLL-функции будут зарегистрироваться при загрузке справочного файла.

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

[CONFIG]

RegisterRoutine("MSVFW32.DLL", "MCIWndCreate", "UUUS");

Затем, вы можете написать, например, вот такой макрос для "горячей точки":

Click {\ul here}{\v !MCIWndCreate(0,0,0,"myvideo.avi")} for video.

DLL может также вызываться в контексте внедрённых ссылок окна, при помощи команд ewc, ewl или ewr, которые должны быть включены в ваш файл статьи справки.

Вызов справки из Приложений

Теперь, когда мы рассмотрели большинство аспектов разработки справочных файлов, остаётся только один вопрос: Как же вызывать справку из приложений C++/C?

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

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

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

Windows'95 помогает в обработке контекстно-зависимых справок. Например, сообщение WM_CONTEXTHELP посылается всякий раз, когда пользователь щёлкает правой кнопкой мыши в окне. В ответ на это сообщение, приложения могут вызвать WinHelp с командой HELP_CONTEXTMENU, что стимулирует вызов контекстного меню с элементом "Что это такое?", при выборе которого отображается справка.

Для обработки режима контекстной помощи, приложениям необходимо устанавливать флажок, указывающий на то, что пользователь нажал клавишу F1 или вызвал контекстную справку с помощью других средств вызова справки, например, выбора кнопки "Спарвка" на панели инструментов. Когда этот флажок устанавливается, приложения должны обрабатывать сообщения команды WinHelp, вместо того, чтобы вызывать саму функцию. Если вы желаете, обеспечить контекстную справку для не клиентских компонентов области вашего приложения, вам необходимо обрабатывать эти сообщения и для не клиентской области.

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

Для MCF приложений, каркас автоматизирует вызов справки с соответствующими параметрами. Если вы не желаете добавлять специальные эффекты, вас не должно волновать каким образом вызывается справка.

Microsoft Help Workshop

Microsoft Help Workshop - базовая утилита Windows для создания и управления файлами проекта справки и файлами содержания справки. Использование этой утилиты вместе с RTF-текстовым процессором значительно упрощает разработку справочного файла.

Редактирование проекта справки

Справа от окна проекта справки ряд кнопок соответствующих разделам файла-проекта справки. Параметры настройки проекта могут изменяться с помощью этих кнопок или при двойном щелчке на нужном разделе. Например, при щелчке на кнопку Options или при двойном щёлчке на разделе [OPTIONS] в файле проекта справки вызывает окно свойств раздела Options.

Кнопка Files может использоваться для подключения или отключение RTF-файлов со статьями помощи . Вы можете добавлять или удалять файлы из списка; также можно определять списки файлов, которые должны быть включены, используя директиву #include. Файл, включённый здесь с помощью этой директивой, должен содержать список файлов статей.

Параметры окон могут устанавливаться или изменяться, при обращении к кнопке Window. Диалоговое окно можно использовать для изменения реквизитов окна: размер, цвет, заголовок, набор стандартных кнопок, и макрокоманд, которые вызываются при выводе окно. Чтобы изменить реквизиты для основного окна справки, используйте тип main; однако, вы можете также определять дополнительные типы окон, с помощью кнопки Add в общей вкладке.

Кнопка Bitmaps может использоваться, чтобы определить расположение растровых рисунков, которые должны быть включены в ваши проекты справки. Эта опция может использоваться как вариант для включения полных имён пути к файлам, содержащим точечные рисунки, используемые в процессе отображения статей справки (речь идёт о тех изображениях, которые хранятся во внешних файлах).

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

Кнопка Alias используется, чтобы установить псевдонимы для статей. Псевдонимы статей особенно полезны, если вы желаете связать несколько элементов интерфейса пользователя с одной и той же статьёй.

Кнопка Config может использоваться, чтобы добавлять или изменять макрокоманды конфигурации. Эти макрокоманды, добавленные в раздел [CONFIG] вашего файла проекта справки, вызываются, когда справочный файл загружается. приложение windows редактирование файл

Кнопка Data Files используется, чтобы добавлять сопровождающие файлы, которые описаны в разделе [BAGGAGE]. Файлы, перечисленные в этом разделе, добавляются к внутренней справочной системе справочного файла. WinHelp пытается в этих файлах искать внешние вызываемые функции, а потом уже поиск ведётся с помощью обычной файловой системы. Использование "багажа" значительно ускоряет работу файла помощи при чтении с медленных носителей, например, CD-ROM. Обычно в багаже хранятся данные мультимедиа, которые позже отыскиваются и воспроизводятся с помощью DLL-библиотек.

Для компиляции справочного файла используёте кнопку Save and Compile. Щелчок по этой кнопке сначала сохраняет ваш файл-проект, а затем запускает компиляцию справочного файла с помощью hcrtf.exe. Так как Microsoft Help Workshop отображает все сообщения компилятора, которые генерируются в процессе компиляции справочного файла, таким образом его очень удобно использовать для этой цели (при работе в командной строке, зачастую невозможно уследить за всей информацией выводимой компилятором, а порой компилятор просто ничего не выводит).

Редактирование файла-содержания

Вторая функция Microsoft Help Workshop - поддержка файлов содержания.

Эти файлы определяют вид и содержание закладки Содержание, когда файл-содержание доступен, и пользователь выбирает закладку Содержание. Кнопки Edit (Редактировать), Remove (Удалить), Add Above (Вставить перед), Add Below (Вставить после), Move Right (Переместить вправо), Move Left (Переместить влево) могут использоваться для добавления, изменения элементов, а также построение иерархии элементов в содержании.

Файлы связей и кнопки Index Files определяют дополнительные справочные файлы, которые должны быть включены в индексные списки. Возможно, добавление новых закладок к окну свойств Индекса справки, используя кнопку Tabs.

Новая закладка содержится в DLL, которая экспортирует следующую функцию:

HWND WINAPI OpenTabDialog(HWND, DWORD, DWORD);

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

Диалог должен быть основан на шаблоне, который является видимым, не имеет никаких рамок и имеет атрибуты WS_CHILD и DS_CONTROL.

Вы можете использовать AppWizard, чтобы создать такую DLL-библиотеку. Создайте DLL, которая статически связана с MFC библиотекой (DLL AppWizard - шаг 1). Создайте новый диалог, и добавьте класс для диалога. Затем добавьте функцию OpenTabDialog в отдельном файле, (например, opentab.cpp) который чем-то будет похож на файл приведённый в Листинге 4.

Распечатка 4 Возможная реализация OpenTabDialog

#include "stdafx.h"

#include "resource.h"

#include "HlpDlg.h"

__declspec(dllexport)

HWND WINAPI OpenTabDialog(HWND hwnd, DWORD, DWORD)

{

CHlpDlg *pDlg = new CHlpDlg;

pDlg->Create(CHlpDlg::IDD, CWnd::FromHandle(hwnd));

return pDlg->m_hWnd;

}

Если ваша DLL-библиотека правильно работает, новая закладка добавится к окну Свойств разделов справки.

Вы можете связываться с WinHelp из вашей DLL-библиотеки, посылая ему сообщения.

Тестирование и запуск справки

Microsoft Help Workshop можно также использовать для проверки справочного файла. Чтобы запустить WinHelp со специфическим справочным файлом используйте команду Run WinHelp из меню File. Если вы выбираете эту команду, отображается диалог (рис.17), в котором необходимо выбрать несколько параметров.

Меню File содержит также специальную опцию Help Author. Когда этот флажок установлен, справочные файлы запускаются в режиме отладки. В процессе отладки WinHelp отображает дополнительные сведения об ошибках; также отображается идентификатор статьи в заголовке окна вместо заголовка раздела.

Другое полезное свойство - команда WinHelp Messages в меню View. Эта команда отображает ряд отладочных сообщений, сгенерированных WinHelp при выполнении справочного файла.

В заключение, несколько полезных тестирующих команд, находящихся в меню Test. Команда Contents File проверяет справку на целостность связей. Команда Close All Help закрывает все образцы WinHelp. Send - посылает макрокоманду в контекст любого справочного файла. И наконец, команды WinHelp API могут использоваться при вызове функции WinHelp с рядом параметров настройки.

AppWizard-сгенерированные скелеты файла-справки

Для MFC-проектов, созданных при помощи AppWizard с поддержкой справки, AppWizard попытается создать набор скелетов справочных файлов. Созданные файлы включают afxcore.rtf, afxprint.rtf, и ряд растровых рисунков. Растровые файлы представляют собой кнопки панели, части окна, и другие графические иллюстрации, используемые в файлах статей справки.

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

Также AppWizard создаёт файл-проект справки и файл содержания справки для вашего приложения. Кроме того, создаётся пакетный файл, makehelp.bat, который может использоваться, чтобы перекомпилировать проект справки. Этот пакетный файл автоматически вызывается из файла, типа "make" вашего приложения. Однако, makehelp.bat не будет сообщать об ошибках; если вы внесли много изменений в статьи справки, то, рекомендуется, для компиляции пользоваться Microsoft Help Workshop.



Заключение

Интерактивная контекстно-зависимая справка - обязательный атрибут современных приложений под Windows. Контекстно-зависимая справка разрабатывается, используя ряд инструментальных средств и отображается в помощью утилиты WinHelp.exe.

Файлы, которые составляют проект-справки Windows, включают файл проекта справки, файлы статей справки, и другие сопровождающие файлы.

Файлы статей хранятся в Microsoft RTF-формате. Так как RTF-файлы состоят из печатных символов ASCII, они могут быть отредактированы большинством редакторов ASCII; в качестве альтернативы, можно использовать текстовый процессор Microsoft Word. Система справки интерпретирует специфическую RTF-кодировку. Например, подчёркнутый текст представляет "горячую точку", связь гипертекста с другим разделом справки. В дополнение к RTF стандарту форматирования кодов, система справки использует несколько своих определений.

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

Другой компонент проекта справки - файл оглавления. Если такой файл существует, система справки использует специальную закладку для отображения оглавления справочного файла.

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

Приложения вызывают справку, используя функцию WinHelp Windows. Эта функция вызывается, когда пользователь выбирает команду в меню Помощь, клавишу F1 или когда режим справки выбран с помощью Shift+F1. Из них, для обработки нажатия на клавишу F1 требуется перехватывать обработчик прерываний или полностью полагаться на сообщение WM_HELP, которое посылается вашему приложению.

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

Новый инструмент, поставляющийся с Visual C++ v.4.0 и более поздними версиями, а также входящий в поставку Borland (Delphi v.2.0 и более поздние версии, С++Builder v.2.0 и более поздние версии) - Microsoft Help Workshop. Это приложение позволяет удобно редактировать как проекты справок, так и файлы содержания. Использование этого приложения вместе с RTF-совместимым текстовым процессором значительно упрощает задачу разработки справочного файла.

Для скелетов приложений MFC, созданных с поддержкой справки, AppWizard создаёт ряд связанных файлов справки. Эти файлы содержат много полных статей и несколько других статей, которые требуют завершения в соответствии со специфическими запросами вашего приложения. AppWizard также создаёт файл, makehelp.bat, который вызывается из файла типа "make" вашего приложения. Но, так как makehelp.bat не сообщает об ошибках, может быть полезно компилировать ваш проект справки с помощью Microsoft Help Workshop (при внесении существенных изменений в статьи справки).

Размещено на Allbest.ru