Г.Тяпичев
«Начальный курс быстрого программирования на СИ++». Глава 4.
Часть 2. Оформление
готового проекта программы
Часть 2. Оформление готового проекта программы
Глава 4. Разработка справочной системы
Коротко о справочной системе Microsoft
Написание файла с малыми текстами тем
Как приучить Windows к русскому алфавиту
Написание файла с большими текстами тем
Создание файла Проекта справки
Подключение справочника к приложению
Еще один вариант разработки справочника
Как сделать простейший справочник
Глава 4.
Разработка справочной системы
Коротко о справочной системе Microsoft
Если наиболее простые
программы или Windows – приложения могут
довольствоваться справкой, размещенной в файле README, то для более серьезной программы нужно создавать
справочную систему.
Для достаточно простых
приложений эта система может представлять собой один единственный текстовый
файл, содержащий в себе объяснения нескольких простых тем. При этом все темы
просматриваются подряд, одна за другой за счет возможностей скроллинга экрана.
Если отдельные темы справочного файла большие по объему, то такой способ
получения информации становится неудобным и
каждой теме нужно выделять отдельное экранное окно. Некоторые сложнейшие
приложения имеют справочные системы, которые состоят из нескольких
информационных файлов, содержат в себе различные схемы и таблицы.
Фирмой Microsoft разработана методика создания справок для Windows 95/98 (и выше) с помощью специального инструмента Microsoft Help Workshop 4. C++ Builder
как раз и предполагает использование этого инструмента для разработки
справочных систем к разрабатываемым в этой среде приложениям для Windows.
Все необходимые файлы Workshop 4 находятся в составе комплекта C++ Builder и
располагаются в каталоге …/Help/Tools. Основным является
исполняемый файл HCRTF.exe (или HCW.exe).
Создание справочной системы любого приложения
можно разделить на два этапа:
q
Написание
текстового файла (или файлов), содержащего описания различных тем. При этом, если описания каждой отдельной темы составляет несколько
строк, то можно создать один текстовый файл, информация из которого будет
выводиться на экран методом скроллинга экрана. Если описания отдельных
тем достаточно большие, то этот текстовый файл следует заранее разбить на
отдельные участки, и каждой теме назначить свое отдельное экранное окно. О том,
какими методами достигается подобное разграничение, будет подробно описано
далее.
q
Заключительным
этапом является компиляция готового текстового файла при помощи программы HCRTF.exe (или HCW.exe),
исправление допущенных в процессе
создания текстового файла ошибок и тестирование созданного в процессе
компиляции исполняемого файла – справочника с расширением *.hlp.
Создание файла тем справок
Написание файла с малыми текстами тем
Файл, содержащий темы
справок, создается с помощью текстового редактора, способного создавать
текстовые файлы в формате *.rtf,
например, с помощью Microsoft Word.
При написании темы можно использовать многие
возможности Word:
выбор атрибутов шрифта (полужирный, курсив), цвет шрифта. Табуляцию,
подчеркивание, включение в текст таблиц (правда, без сетки и без разноцветной
заливки) и т. п. Шрифты тоже можно использовать различные. Но увлекаться этим
не стоит, так как если у пользователя на компьютере не окажется
соответствующего шрифта, он не сможет прочесть ваших текстов. Так что лучше всего использовать обычные системны шрифты (для Windows 95/98 (и выше) это MS Sans Serif).
Текстовый файл с описаниями
небольших тем может иметь только одну «точку входа» - это заголовок, снабженный
специальными символами, устанавливаемыми методом создания сносок.
Такой точкой входа может
служить первый заголовок первой темы. Этот заголовок должен быть напечатан
стилем «Заголовок 1». Функции точки входа придаются этому заголовку привязкой к
нему нескольких сносок.
Сноски в Word делаются командой ВставкаèСноска, после чего открывается диалоговое окно Сноски,
изображенное на рис. 4.1.
Рис. 4.1 Вставка сноски в текстовый файл редактором Word
При создании справочных
систем используется большое число различных сносок. В данном
случае будут кратко описаны только две из них, без которых невозможно создание
методами Microsoft даже
простейшего справочника.
Сноска с символом '$'
определяет заголовок данной темы. Этот заголовок используется в системе поиска,
позволяющей вернуться к ранее просмотренной теме и в некоторых других случаях.
Сноска с символом ‘#’
обозначает уникальный идентификатор темы, по
которому могут ссылаться другие темы. Любая отдельная тема, составляющая
отдельный кадр, должна снабжаться меткой #.
Процесс установки сноски заключается в
следующем. Курсор устанавливается непосредственно перед первой буквой заголовка
и в главном меню выбирается команда ВставкаèСноска.
Появляется окно сноски, изображенное на рис. 1. В
нижней части этого окна в разделе «Нумерация» выбираем пункт «другая». После
этих действий курсор появляется в окошечке для ввода символа, определяющего
сноску. Сначала можно выбрать символ ‘$’, ввести его в окно редактирования и
нажать «ОК». После этих действий курсор печатает символ сноски возле первой
буквы заголовка, а затем быстро перемещается в конец текста, печатает там также
этот символ и предлагает ввести текст сноски. Если вы в качестве символа сноски
выбрали символ ‘$’, то должны напечатать название заголовка, к которому эта
сноска имеет отношение.
Если вы в
качестве символа сноски выбрали символ ‘#’, то в данном случае нужно напечатать
какой-то идентификатор темы, который будет отличать именно эту тему от
остальных тем. Мною в качестве идентификаторов используются сочетания двух букв
и цифры. Так для первой темы ставится идентификатор ID_1, для второй темы - ID_2 и так далее.
Итак, мы имеем перед заголовком установленную
сноску с символом ‘$’. Теперь ставим курсор между символом $ и первой буквой
заголовки и нажимаем клавишу <Пробел>. После этого снова выполняем ВставкаèСноска,
выбираем в качестве символа сноски ‘#’ и в нижней части текстового файла, куда
переместился курсор, печатаем название идентификатора ID_1.
На этом процесс создания простейшего файла
практически закончен. Но очень часто возникают непредвиденные проблемы. Дело в
том, что многие из Управляющих систем нетерпимо относятся к буквам русского
алфавита. Так что в итоговом справочнике вместо нормального текста перед вами
могут встать ровные ряды строк из всевозможнейших символов. Например, на моем
компьютере установлены и Windows ME и Windows XP. Так Windows ME терпимо относится к
русским буквам, а XP
категорически их отвергает. В подобных случаях приходится идти на обман XP.
Для этого перед главным заголовком темы, написанном русскими буквами, т.е. выше этого заголовка, размещается
другой заголовок, написанный латинскими буквами. Ниже этого заголовка можно,
для большей убедительности, напечатать на латинице какой-либо текст.
Отвлекающий заголовок должен быть также напечатан в стиле «Заголовок 1» и перед
этим заголовком следует описанным выше способом установить сноски с символами
‘$’ и ‘#’. При этом сноске по $ дать название нового,
отвлекающего, заголовка, а сноске ‘#’ присвоить идентификатор ID_0.
В заключении следует установить курсор между
текстом на латинском языке и главным заголовком, затем выбрать ВставкаèРазрыв. В
появившемся окне нажать <OK>
и отвлекающий текст будет отделен от текста основного линией разрыва страницы.
Полученный файл нужно сохранить в формате *.rtf в специальной, заранее
подготовленной, директории, в которой затем будут происходить все остальные
превращения этого текста в справочный файл *.hlp.
Как приучить Windows к русскому
алфавиту
Если ваша
операционная система не хочет признавать русский алфавит в программах Photoshop 6, в Corel DRAW 10 или в других программах и случаях, то зачастую
используется следующий метод насильственного «приручения».
1. Посредством файлового менеджера «Мой компьютер» или Windows Commander нужно войти в директорию Windows.
2.
В этой директории
выбираем WindowsèRegedit.exe и открываем этот файл – регистр.
3. Открываем файл по следующему пути: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage.
4.
В этом файле
следует заменить значение 1252. Если
у вас установлена система Windows NT, то новое значение должно быть написано как «C_1251.NLS». Если у вас установлен
просто Windows 95/98/ME, то новое значение должно быть «cp_1251.nls».
5.
После выполнения
этой процедуры компьютер следует перезапустить.
В своей
практике мне дважды приходилось пользоваться этой процедурой
и каждый раз все было ОК.
Написание файла с большими
текстами тем
В этом разделе ко всему
написанному выше следует добавить еще один символ для сноски, который
представляет собой символ ‘+’. Тексты таких сносок представляют собой
идентификаторы, аналогичные описанным выше идентификаторам ID_1, служат примерно таким же целям, но имеют цифровое
обозначение, например, 001. У меня обычно идентификатору ID_1 соответствует второй идентификатор (для ‘+’), обозначаемый как 001. Для ID_2,
соответственно - 002 и т.д.
Итак, основные особенности
файла с большими по размеру текстами.
q
Перед заголовком
каждой новой темы поочередно устанавливаются три сноски:
1.
Сноска с символом
‘$’;
2.
Сноска с символом
‘#’;
3.
Сноска с символом
‘+’.
q
Одна тема от
другой отделяется вставкой символа разрыва
страницы.
Для этого следует установить курсор между
текстом предыдущей темы и заголовком новой темы, затем выбрать ВставкаèРазрыв. В
появившемся окне нажать <OK>
и текст одной темы будет отделен от текста следующей темы линией разрыва
страницы.
Полученный файл нужно сохранить в формате *.rtf в специальной, заранее
подготовленной, директории, в которой затем будут происходить все остальные
превращения этого текста в справочный файл *.hlp.
Создание файла Проекта справки
Для
создания файла проекта *.hpj простой справки необходимо выполнить ряд
последовательных действий. Сначала входим в директорию расположения комплекта
файлов C++ Builder и выбираем
поддиректорию HelpèTools, в которой размещены файлы комплекта Help Workshop 4.
Рис. 4.2.
Окно Проекта
Далее выполняем следующие действия:
1. Запускаем
исполняемый файл HCW.exe. В меню File выполняем команду New
и в открывшемся окне выбрать опцию Help Project (см.
рис. 4.2).
Далее в окне Project File Name надо
задать имя и каталог файла проекта справки (каталог выбирать тот, в котором
лежит файл текстов тем *.rtf). Обычно имя проекта совпадает с именем
заготовленного ранее файла текстов тем.
Рис. 4.3 Окно
выбора имени файла проекта
2. В
открывшемся окне Проекта (рис. 4.3) нажать кнопку Files и в
окне Topic Files (рис. 4.4)
щелкнуть на кнопке Add и выбрать среди файлов подготовленный файл
текстов справки. После этого щелкнуть на ОК. При этом в окне Проекта
(рис. 4.2) дополнительно к рубрике [OPTIONS] добавляется рубрика [FILES], в которой напечатано
имя подготовленного нами ранее и выбранного в этом пункте файла *.rtf.
Рис. 4.4.
Ввод имени файла с текстами тем (*.rtf)
3.
В окне Проекта выбираем
кнопку Windows,
в результате чего открывается окно (рис. 4.5) Window Properties, содержащее
целый ряд страниц. Пока не будем рассматривать подробности этих страниц,
ограничимся только тем, что заполним страницу General (общие
характеристики). В окне
редактирования Window type
записываем идентификатор окна «main». Это название принято для главного окна.
Если будут и другие окна, то им можно будет давать иные, надуманные названия. В
окне редактирования Titlebar
text
(текст заголовка) пишем «Вспомогательное окно справки», в окне редактирования Comment
(комментарии) пишем «Дополнительное окно» ( для случая
с дополнительным окном). Индикаторы
Auto-size height и
Keep Help window on top оставляем установленными.
Рис. 4.5.
Окно основных свойств
4. В
окне проекта выбираем кнопку Map. В открывшемся диалоговом окне (рис. 4.6)
выбрать Add и в новом диалоговом окне напечатать в верхнем
окне редактора текста идентификатор первой темы (ID_1), которая должна
появляться первой на экране, во втором окне редактора текста напечатать цифру 1
(единицу). Затем нажать ОК на каждом
их появлявшихся всплываемых окнах и выйти в окно
Проекта.
Рис. 4.6.
Окно назначения первой открытой темы
5. В
окне Проекта выбираем кнопку Config. В появившемся окне
(рис. 4.7) пишем фразу «BrowseButtons()», которая в дальнейшем позволит
перемещаться по темам с помощью кнопок ”<<” и “>>”. Нажимаем ОК.
Рис. 4.7. Окно
кнопки Config
Все процедуры, необходимые для создания файла
проекта выполнены. Остается Щелкнуть на кнопке Save and Compile,
расположенной в нижнем правом углу окна Проекта. В результате этих действий
будет сохранен вновь образованный файл проекта *.hpj и будет создан файл
справки *.hlp с
таким же именем, какое имеет файл проекта. На рис. 4.8 изображено окно
начала компиляции.
Рис. 4.8.
Окно начала компиляции
Во вновь созданный файл проекта теперь можно
неоднократно вносить различные поправки, не забывая после этого выполнить его
перекомпиляцию.
Компиляция
и отладка справки
В результате выполненных действий файл
проекта сохранен и откомпилирован, в
результате чего создан файл справки .hlp с тем же именем, что и файл проекта, или с
именем, указанным вами на странице Files окна
Options.
Кнопкой Save and Compile надо пользоваться каждый раз, когда
изменяется файл проекта. Если же в дальнейшем вы меняете только тексты в файле
тем, то компиляцию удобнее производить запустив в
работу программу HCW.exe и
далее командой FileèCompile или проще – нажав соответствующую быструю кнопку с
пиктограммой мясорубки. Причем вы можете это делать, даже не открывая
предварительно файла Проекта. В результате выполнения этой команды откроется
окно Compile a Help File (см. рис. 4.8), в котором вы можете
выбрать нужный файл проекта и затем щелкнуть на кнопке Compile.
Предварительно удобно установить флаг опции Automatically display Help file in WinHelp when done,
которая обеспечивает сразу после компиляции просмотр скомпилированного файла
справки. Если вы не установили опцию Minimize window while compiling, то
во время компиляции вы будете видеть окно, с работающей мясорубкой, отражающей
процесс компиляции. Установка указанной опции минимизирует это окно. Опция Turn off compression
(reduces compile time)
позволяет временно отключить сжатие файла. Это приведет к увеличению размера
файла справки, но заметно уменьшит время компиляции больших справок. Опция Include
.rtf filename and topic ID in Help file включит
в файл справки имена файлов текстов тем и идентификаторы тем. Это позволит вам
в процессе отладки. Установив в меню File опцию
help Author, получать при просмотр справки оперативную информацию о каждом кадре справки.
После компиляции вы увидите в окне Help Workshop содержимое
текстового файла Compilation, в котором содержатся сведения о
результатах компиляции. Здесь же будут замечания и сообщения об ошибках,
которые возникнут при неправильном исходном файле .rtf. Чаще всего, несмотря
на замечания и ошибки, файл справки все-таки компилируется
и вы можете его посмотреть. В процессе этого просмотра и отладки вы скорее
найдете ошибки, чем просто отыскивая их в исходном тексте.
После компиляции при включенной указанной выше
опции Automatically display Help file in WinHelp when done вы сразу же можете поработать с
откомпилированным файлом справки.
Файл
содержания -- *.cnt
Файл
Содержания (Contents file), имеющий расширение *.cnt,
является текстовым файлом, который можно проектировать с помощью Microsoft Help Workshop и присоединять его к
файлу Проекта справки. Этот файл обеспечивает при работе со справкой страницу Содержание
в окне справочной системы, в которой в виде пиктограмм
открытых и закрытых книг и пиктограмм тем отражается структура справки. Чтобы
создать новый файл содержания, надо после запуска в работу Help Workshop (файл
HCW.exe)
выполнить команду FileèNew и в окне New выбрать опцию Help Contens. Откроется окно с
загруженным в него файлом содержания. Вид этого окна можно видеть на рис. 4.9;
только в первый момент все его окна редактирования будут пустыми.
Рис. 4.9. Окно
создания файла содержания (*.cnt)
В верхних окнах надо
задать: в левом – имя файла .hlp и окно по умолчанию
(если оно определено в файле .hpj), отделив имя окна символом >, в правом –заголовок,
который будет появляться в окне Содержание при
работе справочной системы. Заносить информацию в эти окна можно
непосредственно, но проще щелкнуть на верхней кнопке Edit и
работать в открывающемся при этом диалоговом окне.
Нижнее окно заполняется
с помощью кнопок Add Above и Add Below.
Первая из этих кнопок вставляет новую строку выше той, в которой находится в
данный момент курсор, а вторая – ниже этой строки. При нажатии любой из этих
кнопок открывается окно Edit Contents Tab Entry
(см. рис. 4.10), в котором вы можете задать тему (Topic).
Рис. 4.10. Задание
очередной темы в файле *.cnt
Создание файла
содержания выполняется следующим образом.
q В
верхнем слева окне редактирования нужно написать полное имя *.hlp файла, затем напечатать
символ ‘>’ и затем идентификатор окна main.
Эта строка имеет значение Base и должна быть напечатана без пробелов. Если
появляется сообщение об ошибке в Base, то следует искать ошибку в окне этого
редактора текста.
q При
создании оглавления сначала назначается название заголовку, например
«Содержание справки». Выполнение этой
операции начинается с нажатия кнопки Add
Above…. В открывшемся окне
(рис. 4.10) выбираем в верхней строке название Heading, и в
окне редактора текста Title
вводим название
«Содержание справки». Оставляем все остальные окна пустыми и нажимаем ОК.
q Для
ввода названия первой темы нажимаем кнопку Add
Below… В
открывшемся окне (рис. 3.10а)
выбираем в верхней строке название Topic –
это «тема». В окне редактирования Title
вводим название первой темы справочника. Во втором окне
редактирования – Topic
ID – вводим идентификатор, соответствующий этой теме, для
первой темы это будет ID_1. Расположенные
ниже окна редактирования заполняем только тогда, когда описываемая тема
располагается в другом файле или должна выводиться в другом окне.
q Далее
снова нажимаем поочередно кнопку Add
Below… и точно так же вводим
названия и идентификаторы всех последующих тем.
q Созданный текст файла содержания следует
сохранить командой FileèSave.
q Заключение
всего процесса создания справочника является выход в окно Проекта и ввод
команды FileèCompile.
Вернемся к рис. 4.10 и рассмотрим еще две кнопки окна
редактирования файла Содержания. Кнопки Move Right и Move Left позволяют сдвигать вправо и влево
выделенные строки заголовков и тем, обеспечивая нужные отступы, характеризующие
многоуровневую структуру.
Для более надежной работы справочника иногда
бывает полезно в разделе [MAP]
строку ID_1=1
заменить строкой #define ID_1 1 (смотрите рис. 4.11).
Рис. 4.11.
Вариант ввода в раздел [MAP]
Подключение справочника к
приложению
q Запустить C++ Builder. В главном меню выбрать ProektèOptionsèApplication.
Нажать клавишу Browse… и
выбрать путь к нужному *.hlp файлу. Разумеется, он должен находиться рядом с
основным файлом приложения.
q В
описании функции создания формы сделать следующую запись
void __fastcall
Tform1::FormCreate(TObject *Sender)
{
HelpContext
= 1;
}
Эта
запись будет способствовать вызову справки по нажатию клавиши F1.
q Если
необходимо открыть справочник программным способом, например, по выбору пункта
меню Help, то
метод обработки команды меню HelpèHelp Topics может выглядеть
следующим образом.
void __fastcall
Tform1::HelpTopicsItemClic(TObject *Sender)
{
Application->HelpCommand(HELP_CONTENTS,
0);
}
Как
показал опыт, для начального периода создания Windows приложений, этой
методики вполне достаточно. Кроме того, в Интернете можно найти большое
количество самых разнообразных программ для создания справочных систем.
Пример создания справочника
Для демонстрации описанного
выше варианта создания простой справочной системы сделаем справочник на базе
текстового файла Probhelp.rtf, расположенного в предполагаемой директории Help_prob.
Полностью текст файла
приводить нет необходимости. Все понятно из
рис. 4.12.
Рис. 4.12. Текст файла с описаниями тем
На рис. 4.13 показан
тот же файл в процессе вставки сносок. В нижней части экрана как раз и показаны
сноски, относящиеся к теме «Заголовок№1». Точно таким же образом оформляются
сноски и к заголовкам других тем.
Рис. 4.13. Пример оформления сносок
Запускаем программу HCW и выбираем пункт меню New, который предлагает начать создание проекта справки.
На рис. 4.14 изображено основное окно программы, внутри которого показано
всплывающее окно выбора действия.
Рис. 4.14. Начало создания проекта
На следующем этапе
программа HCW запрашивает имя файла проекта
справки. Вводим имя, совпадающее с именем файла, в котором описаны темы
справок. На рис. 4.15 изображено окно программы HCW после проведения всех операций, необходимых для
создания файла проекта. Текст файла проекта показан внутри окна.
Рис. 4.15. Создание файла проекта
Нажимаем клавишу Save and Compile в правом нижнем углу окна и выполняем компиляцию
файла проекта.
Для создания файла
управления справочником (*.cnt),
выбираем в главном меню FileèNew, в
появившемся окне выбираем Help
Contens (рис. 4.16).
Рис. 4.16. Выбор для создания файла управления
Используя указания
вышеприведенного раздела, создаем файл управления в соответствии с
изображениями на рис. 4.9 и рис. 4.10. Сохраняем созданный файл через
пункты главного меню FileèSave,
вводим при этом на запрос программы имя нового файла, которое должно быть
одинаково с именем файла *.help.
Выполняем завершающую
команду FileèCompile
– и справочная система готова.
На рис. 4.17 и
рис. 4.18 приведены изображения окон справочника.
Рис. 4.17. Главное окно справочника
Рис. 4.18. Окно одной из тем
Еще один вариант разработки справочника
В компакт–диске, приложенном к [2], была представлена программа (утилита) под
названием Instant Help, позволяющая очень даже просто изготавливать
справочники очень высокого класса. Позднее я встречал эту программу еще на
одном из сайтов в Интернете. Если у вас
будет возможность, то постарайтесь приобрести эту программу. Не пожалеете.
Программа инсталлируется
обычным образом в заранее определенную директорию. После инсталляции в этой
директории среди прочих будут два самых важных файла:
q
Файл INSTHELP.EXE
q
И файл INSTHELP.DOT, который
расположен в поддиректории Template.
Первый из этих файлов является как бы
конфигурационным файлом и позволяет изменять цвета раскраски страниц будущего
справочника, а также выполнить компиляцию подготовленного для справочника
текста.
Второй файл является шаблоном для
создания текста нового справочника. Этот файл следует скопировать в ту
поддиректорию вашего текстового редактора Microsoft Word, в
которой находятся и другие шаблоны, (например, шаблон Normal),
принадлежащие этой программе.
Задействовать программу разработки
справочника можно следующим образом.
q
Запустить в
работу текстовый редактор, в котором установлен шаблон INSTHELP.DOT. Это может
быть Microsoft Word 97
(и выше).
q
Выбрать Сервисè|Шаблоны и
надстройки, в результате чего
появится окно, изображенное на рис. 4.19.
Рис. 4.19. Окно Шаблоны и надстройки
q
Нажимаем кнопку Присоединить. В возникшем окне выбора
файла выполняем двойной щелчок кнопкой мышки на имени файла INSTHELP.DOT. В
результате этого действия название нового шаблона вводится в окно Шаблоны и надстройки, как это показано
на рис. 4.20. В малом окошке
напротив имени нового шаблона ставим знак выбора.
Рис. 4.20. Добавление нового шаблона
q
Затем нажимаем
кнопку Добавить, в появившемся окне выбора файла снова нужно сделать
двойной щелчок на имени нового шаблона. В появившемся окне Шаблоны и надстройки нажимаем кнопку ОК. Процесс ввода в действие
нового шаблона завершен. На экране появляется окно редактора уже подготовленное
для создания текстового файла нового справочника. Верхняя часть окна изображена
на рис. 4.21.
Рис. 4.21. Окно редактора с установленным новым
шаблоном
На этом рисунке
пронумерованы кнопки новой инструментальной панели Instant Help, названия
которых привожу ниже.
1 – кнопка под этим номером
служит для определения некоторого текста как заголовок программы. Если нажать
на эту кнопку, то введенная после этого строка текста будет считаться
заголовком программы.
2 – кнопка под этим номером
служит для определения собственника программы. Введенная после нажатия этой
кнопки строка текста будет затем отображаться в справочнике как название версии
и собственника программы.
3 – кнопки под этим номером
служат для написания различных заголовков. Заголовки различаются размерами букв
и значимостью. Например: главный заголовок справочника должен печататься
буквами Заголовка 1, Название темы должно печататься буквами Заголовка 2, название подтемы – буквами Заголовка
3 и так далее … .
4 – кнопка под этим номером
имеет название Заголовок Темы. Перед
тем, как начать печатание названия темы, следует нажать эту кнопку.
5 – кнопка под этим номером
имеет название Заголовок Подтемы. Её назначение понятно из названия.
6 – кнопка под этим номером
имеет название Конец Темы. Перед
началом новой темы следует выделить одно или несколько слов законченной темы и
нажать эту кнопку. Выделенные слова становятся подчеркнутыми и программа готова
к вводу заголовка новой темы.
7 – кнопка под этим номером
имеет название Конец Подтемы.
Её назначение и применение аналогично применению предыдущей кнопки.
8 – кнопка под этим номером
имеет название Скрытое
Имя. Назначение понятно из названия.
9 – кнопка под этим номером
имеет название Абзац.
10 – кнопка под этим именем
называется Генератор. Эта кнопка нажимается после того, как будет полностью подготовлен
текстовый файл справочника, который
должен быть предварительно сохранен в какой-то поддиректории.
После нажатия кнопки Генератор начинается процесс
превращения текстового файла в файл справочника.
Первым признаком начала
компиляции текстового файла является появление на экране диалогового окна Instant Help Generator, изображение которого представлено на рис. 4.22.
Рис. 4.22. Окно Instant Help Generator
В этом окне сначала следует
установить пути к расположению подготовленного текстового файла справочника с
расширением .rtf и
вновь создаваемого файла справочника
с расширением .hlp, который будет задействован в создаваемой программе. Затем можно выбрать цвет фона справочного
текста и цвет фона заголовка. Нажатием клавиши Start включается процесс
компиляции, после завершения которого на экране
возникает окно справочника.
Теперь следует подключить
справочник к создаваемой программе по методике, описанной выше, в разделе
«Подключение справочника к приложению».
Как
сделать простейший справочник
Сделать простейший
справочник можно с помощью редактора Microsoft Word 97 (или
выше). При этом текст справочника должен создаваться с
использованием встроенного в редактор шаблона, например, шаблона Normal.
Основной особенностью
создания такого справочника является то, что все заголовки, включая заголовки
тем и подтем, должны печататься шрифтами только
специальных заголовков, имеющихся в используемом шаблоне.
Так текст основного
заголовка должен печататься стилем Заголовок
1, текст заголовков различных тем должен печататься стилем Заголовок 2, текст заголовков подтем должен печататься стилем Заголовок 3. Это условие ставится с той целью, чтобы впоследствии
программа редактора смогла самостоятельно сгенерировать оглавление справочника.
Создадим с использованием
шаблона Normal текстовый файл предполагаемого справочника. Текст
изображен на рис. 4.23.
Рис. 4.23. Текст справочника
Устанавливаем курсор в начало созданного
текста и выбираем из меню команду Вставка
è Ссылка è Оглавление
и указатели. В меню появившегося
диалогового окна выбираем пункт Оглавление
и нажимаем клавишу ОК. В верхней части текста возникает
оглавление приготовленного нами текста. На рис. 4.24 показано окно
редактора, в котором изображено оглавление и начало текста.
Рис. 4.24. Текст с оглавлением
Если установить курсор на
любую из строчек оглавления, то сразу всплывает подсказка «Для перехода
щелкните ссылку, удерживая нажатой клавишу <CTRL>». Под словом «ссылка» подразумевается любая
строка оглавления. Если нам нужно прочитать раздел «Заключение», то нужно держа нажатой клавишу <Ctrl> щелкнуть клавишей мышки на слове «Заключение». На
экране появится нужный раздел текста.
Текст можно очень красочно
оформить и такое простейшее справочное пособие будет выглядеть приятно для глаз
пользователя. Но прибегать к такому методу следует только в крайнем случае.