Глава 12. Создание справочной системы приложения

Глава 12. Создание справочной системы приложения Строка состояния Использование диалоговых окон Создание справочной системы в формате WinHelp Темы справочной системы Ключи для поиска тем Пояснения...

Строка состояния Разработанное вами приложение должно быть интуитивно понятным и дружественным к пользователю. Если у пользователя возникнут затруднения, он должен быстро получить справку о возмож...

Рис. 12.1. Определение пояснений для элемента управления...

Создание справочной системы в формате HTML Для создания справочной системы в формате HTML можно использовать HTML Help Workshop. Для этого выполните следующие действия: Создайте темы справочной си...

Окно HTML Help Workshop Окно программы HTML Help Workshop (рис. 12.17) состоит из двух областей. В левой области находятся вкладки Project (Проект), Contents (Содержание), Index (Указатель) и Help...

Рис. 12.17. Окно программы HTML Help Workshop...

Рис. 12.18. Просмотр темы справочной системы в Web-браузере...

Определение параметров проекта справочной системы Параметры проекта отображаются в разделе [options] вкладки Project (Проект). Для их редактирования нажмите кнопку Change Project Options (Изменить...

Рис. 12.19. Определение параметров проекта На вкладке General (Общие) вы определяете: заголовок окна справочной системы; файл темы и окно, которые выбираются при открытии справочной системы; язык...

Определение псевдонимов тем Чтобы в приложениях можно было использовать справочную систему, вы должны определить псевдоним каждой темы. Для этого откройте диалоговое окно HtmlHelp API information...

Рис. 12.20. Список псевдонимов тем...

Рис. 12.21. Определение псевдонимов тем...

Определение связи между псевдонимами и индексами тем Для открытия определенной темы справочной системы используются индексы тем. Связь между псевдонимами тем и соответствующими им целочисленными з...

Создание содержания справочной системы Для создания содержания справочной системы в иерархическом виде перейдите на вкладку Contents (Содержание). В области содержания справочной системы (рис. 12....

Рис. 12.22. Вкладка Contents...

Рис. 12.23. Определение элемента содержания справочной системы Вы можете создать многоуровневое содержание справочной системы. Для изменения уровня заголовка используйте кнопки Move selection righ...

Создание ключей для поиска тем Для создания ключей поиска перейдите на вкладку Index (Указатель). Используя кнопки панели инструментов вкладки, вы можете создать новый ключ, редактировать ранее со...

Рис. 12.24. Определение ключей для поиска тем...

Рис. 12.25. Определение тем для ключа...

Компиляция и тестирование справочной системы После того как вы подготовили проект справочной системы, его необходимо сохранить и скомпилировать. Используя кнопку Save project, contents and index f...

Рис. 12.26. Просмотр справочной системы...

Использование справочной системы в приложениях Мы рассмотрели создание справочных систем двух типов. Однако обращение к ним из приложения, созданного в Visual FoxPro, осуществляется одинаково. Рас...

Команды Visual FoxPro для управления справочной системой Для определения файла, содержащего справочную систему, а также для вывода на экран содержания или указанной темы из справочной системы испо...

Таблица 12.7. Назначение команд для управления справочной системой Команда Назначение SET HELP Запрещает или разрешает вывод справочной системы или определяет имя используемой справочной системы H...

SET HELP Команда set help управляет выводом справочной системы и определяет ее имя. Она имеет два варианта синтаксиса: SET HELP ON | OFF Предназначена для разрешения или запрета активизации станда...

HELP Для вывода на экран содержания справочной системы или указанной темы в окне справочной системы предназначена команда help, имеющая следующий синтаксис: HELP [идентификатор'Гемы | ID индексТем...

SET TOPIC По умолчанию содержанием справочной системы является первая по порядку тема. Для изменения содержания используется команда set topic, позволяющая определить тему, которая в дальнейшем бу...

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

Таблица 12.1. Кнопки, отображаемые в диалоговом окне Значение Кнопки 0 ОК 1 ОК и Cancel 2 Abort, Retry, Ignore <...

Таблица 12.2. Значки, отображаемые в диалоговом окне Значение Значок 16 Знак Stop 32 Вопросительный знак 48 Восклицательный знак ...

Таблица 12.3. Кнопка, выбираемая по умолчанию Значение Кнопка по умолчанию 0 Первая кнопка 256 Вторая кнопка 512 Третья кнопка <...

Таблица 12.4. Значения, возвращаемые функцией messagebo:-. Значение Кнопка 1 ОК 2 Cancel 3 Abort...

Рис. 12.2. Определение процедуры для события Valid Выберите поле ввода значения кредита и для события Valid определите процедуру (рис. 12.2), которая проверяет введенное значение и при необходимос...

Рис. 12.3. Диалоговое окно с сообщением об ошибке...

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

Рис. 12.27. Определение свойства HELPContextlD Если вы установили это свойство, то во время просмотра формы нажатие клавиши Fl приведет к открытию указанной темы справочной системы. На рис. 12.28...

Рис. 12.28. Вид темы справочной системы в формате WinHelp...

Рис. 12.29. Вид темы справочной системы в формате HTML...

Справка типа What's This? Для краткого описания отдельных объектов формы можно использовать справку типа What's This?, которая аналогична контекстно зависимой справке, выводимой для объекта, на ко...

Таблица 12.8. Свойства справки типа What's This? Свойство Описание WhatsThisHelp Установка этого свойства для формы позволяет использовать справку типа What's This? как для формы, так и для входящ...

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

Темы справочной системы Создание тем справочной системы начинается с создания файла описания в формате RTF. Проще всего для этого использовать редактор Microsoft Word. Создайте с помощью него новы...

Рис. 12.4. Тексты тем с рисунками...

Рис. 12.5. Определение заголовка темы Предупреждение Будьте внимательны. Между маркером сноски и текстом заголовка должен быть только один пробел. Заголовок должен содержать не более 128 символов....

Ключи для поиска тем При определении ключей необходимо иметь в виду следующее: в качестве маркера сноски используется латинский символ к;...

Рис. 12.6. Определение ключей для поиска тем справочной системы...

Рис. 12.7. Поиск темы по ключам справочной системы в тексте сноски можно определить сразу несколько ключей поиска, разделив их знаком (;); длина строки с ключами поиска должна быть не более 255 си...

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

Рис. 12.8. Создание перекрестной ссылки Замечание Замечание По умолчанию скрытый текст не отображается на экране, что довольно неудоб но при создании описания справочной системы. Чтобы скрытый тек...

Пояснения к терминам В справочной системе помимо перекрестных ссылок можно создать пояснения к отдельным терминам. Пояснение создается аналогично отдельной теме. Для него определяется идентификато...

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

Таблица 12.5. Разделы файла проекта справочной системы Раздел Функция [Files] Определяет список файлов с описанием тем [Options] Определяет заголовок справочной системы, а также некоторые другие п...

Раздел [Files] В разделе [Files] перечисляются файлы в формате RTF, которые включаются в состав справочной системы. Например: [Files] SALES.RTF; инструкция пользователя EDIT.RTF; инструкция по общ...

Определение параметров компиляции Раздел [options] файла проекта справочной системы содержит описание параметров компиляции. Ниже перечислены основные из них. title - определяет заголовок окна спр...

Таблица 12.6. Уровни параметра warning Уровень Выводимая информация 1 Только наиболее серьезные ошибки 2 Все ошибки 3 Все ошибки и предупреждения...

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

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

Рис. 12.9. Окно файла проекта справочной системы...

Рис. 12.10. Диалоговое окно настройки раздела [OPTIONS]...

Рис. 12.11. Выбор файла справки и темы...

Содержание справочной системы Обычно окно справочной системы содержит три вкладки: Содержание, Указатель и Поиск. Для того чтобы в диалоговом окне присутствовала вкладка Содержание, необходимо соз...

Рис. 12.12. Выбор режима создания содержания справочной системы...

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

Рис. 12.14. Ввод заголовка содержания справочной системы Для ввода заголовка следующего уровня опять нажмите кнопку Add Below (Добавить ниже) и создайте следующий заголовок. Созданный заголовок яв...

Рис. 12.15. Определение ссылки на тему справочной системы После ввода содержания справочной системы сохраните его. На рис. 12.16 приведен пример содержания справочной системы. Обратите внимание, ч...

Рис. 12.16. Содержание справочной системы Чтобы подключить содержание к файлу справки откройте окно файла проекта и в разделе [options] укажите имя файла с содержанием справочной системы....