Подключение справочного файла к приложению
Существует несколько способов подключения готовых HLP-файлов к приложениям. Вы можете задать справочный файл для всего приложения, установить отдельные справочные файлы для каждой формы или же подготовить контекстную справку для форм и элементов. Чтобы реализовать режим контекстной справки, необходимо установить соответствие между идентификаторами контекста и идентификаторами разделов справочного файла.
Чтобы задать справочный файл для всего приложения, откройте диалоговое окно Project Properties и введите имя справочного файла в поле Help File или задайте значение свойства HelpFile для объекта Арр (объекта приложения) во время выполнения программы.
Для работы со справочными файлами из программы применяется Windows API или элемент стандартного диалогового окна. В нашем примере будет использована вторая возможность. Если вас интересует работа со справочными функциями API, прочитайте урок 19, «Использование DLL и Windows API», в котором изложены основы работы с API, а затем найдите в электронной документации описание нужных функций и команд. А сейчас мы попробуем подключить справочный файл к приложению:
1. Создайте в Visual Basic новый проект типа Standard EXE.
2. Задайте свойству Name формы Forml значение frmMain, а свойству Caption — значение Приложение со справкой.
3. Щелкните правой кнопкой мыши на строке Projectl в окне проекта и выберите из контекстного меню команду Projectl Properties.
4. В диалоговом окне Project Properties занесите в поле Help File имя справочного файла из предыдущего примера, а затем нажмите кнопку ОК.
5. Создайте на форме элемент меню и добавьте следующие меню и команды:
Меню File
| Caption: | Name: |
| &File | nnuFile |
| Команды меню File | |
| Caption: | Name: |
| E&xit | mnuFileExit |
| Меню Help | |
| Caption: | Name: |
| &Help | mnuHelp |
| Команды меню Help | |
| Caption: | Name: |
| &Contents Files | mnuHelpContentsFile |
| &Topic Files | mnuHelpTopicFiles |
| &Project Files | mnuHelpProject |
6. Когда меню будут готовы, закройте редактор кнопкой ОК.
7. Включите в проект элемент стандартного диалогового окна. Задайте его свойству Name значение dlgHelp. Этот элемент будет использоваться для вызова справочного файла.
8. Откройте окно программы и добавьте в процедуру события mnuFileExit_ Click() оператор End.
9. Добавьте в процедуру события Form_Load() следующую строку:
dlgHelp.HelpFile = App.HelpFile
10. Добавьте следующий фрагмент в процедуру события mnuHelpContentsFile, Click():
Private Sub mnuHelpContentsFile_Click()
dlgHelp.HelpContext = "100"
dlgHelp.HelpCommand = cdlHelpContext
dlgHelp.ShowHelp
End Sub
11. Добавьте следующий фрагмент в процедуру события mnuHelpTopicFiles. Click():
Private Sub mnuHelpContentsFile_Click()
dlgHelp.HelpContext = "400"
dlgHelp.HelpCommand = cdlHelpContext
dlgHelp.ShowHelp
End Sub
12. Добавьте следующий фрагмент в процедуру события mnuHelpTopicFiles_Click():
Private Sub mnuHelpProject_Click()
dlgHelp.HelpContext = "700"
dlgHelp.HelpCommand = cdlHelpContext
dlgHelp.ShowHelp
End Sub
13. Сохраните и запустите программу.
Теперь каждая команда меню вызывает некоторый раздел справочного файла, поскольку мы связали идентификаторы разделов с идентификаторами контекста. В стандартном диалоговом окне мы указали, какой контекст следует отображать, задавая свойству HelpContext соответствующий идентификатор контекста справочного файла.
Если вы хотите, чтобы при нажатии клавиши F1 вызывалась контекстная справка, следует задать значение свойства HelpContextID в окне свойств или в программе во время выполнения. Давайте посмотрим, как это делается:
1. Поместите текстовое поле на форму frmMain. Задайте его свойству Name значение txtHelp, а свойству HelpContextID - значение 1200. Очистите свойство Text.
2. Сохраните и запустите программу.
3. Щелкните мышью в текстовом поле, чтобы сделать его активным элементом. Нажмите клавишу F1.
Если все пойдет нормально, вы увидите раздел «Протестировать полученный справочный файл» (рис. 13.10).
Хорошая документация по приложению не менее важна, чем само приложение. К счастью, в Windows предусмотрена система электронной справки, которая по зволяет отображать в приложении собственные справочные файлы, а вам остает ся лишь написать их. Теперь ваших познаний вполне достаточно для разработки справочных систем.
Рис. 13.10. Наш справочный файл