Глава 24. Предоставление справки в приложениях |
753 |
Оба аргумента являются необязательными. Если имя файла справочного руководства не указано, то будет отображаться файл справочного руководства Excel. Если опустить идентификатор раздела, то указанный файл будет отображен с использованием раздела, принятого по умолчанию.
Следующий пример отображает раздел файла m yapp. chm, принятый по умолчанию. Файл должен находиться в той же папке, что и рабочая книга приложения, из которого он вызывается. Обратите внимание: второй аргумент не указан.
Sub |
S how H elpC ontents() |
A p p lic a tio n .H e lp T hisW orkbook. Path & "\m yapp.chm " |
|
End |
Sub |
Представленный далее оператор отображает раздел справочного руководства с иден тификатором 1002. При этом используется файл справочного руководства в формате HTML Help, который называется myapp . chm.
A p p lic a tio n . H elp T hisW orkbook. Path & "\m ya p p .chm ", 1002
Связывание файлов справочного руководства с приложением
Файл справочного руководства можно связать с приложением одним из двух спосо бов: с помощью диалогового окна Project Properties (Свойства проекта) или посредст
вом создания специального кода VBA.
Откройте окно редактора Visual Basic Editor и выберите команду Tools^xxx Properties (Сервис1^Свойства ххх), где ххх соответствует имени проекта. В диалоговом окне Project Properties (Свойства проекта) перейдите на вкладку General (Общие) и укажите ском пилированный файл справки HTML Help для проекта. Этот файл должен иметь расши рение . chm.
Представленный далее оператор связывает приложение с файлом myf u n c s . chm. Этот файл находится в той же папке, что и файл рабочей книги.
T h isW orkbo ok .V B P ro ject. H e lp F ile = T hisW orkbook. Path & " \m y fu n c s . chm"
П р и м еч а н и е
Если в результате выполнения указанного выше оператора появляется со общение об ошибке, следует открыть программный доступ к проектам VBA. В Excel выполните команду РазработчикаКод1^Безопасность макросов (Developer^Code1^Macro Security) для отображения диалогового окна Центр управления безопасностью (Trust Center). Затем отмените установку флажка Доверять доступ к объектной модели проектов VBA (Trust Access to the VBA Project Object Model).
После связывания файла справочного руководства с приложением можно отобразить определенные справочные сведения в следующих ситуациях.
•Когда пользователь нажимает клавишу <F1> при выборе пользовательской функ ции в диалоговом окне Мастер функций (Insert function).
•Когда пользователь нажимает клавишу <F1> при отображенном диалоговом окне U serF orm . В результате отображается раздел справочного руководства, который связан с элементом управления, активным в момент нажатия клавиши <F1>.
Глава 24. Предоставление справки в приложениях |
|
755 |
||||
Sub |
S e tO p tio n sO |
|
функции AddTwo |
|
|
|
' |
У становить параметры |
для |
|
|
||
A p p lic a tio n .M a c ro O p tio n s |
M acro:= "AddTwo", _ |
|
|
|||
|
D e s c r ip tio n := "Сумма двух ч и с е л ", |
_ |
|
_ |
||
|
H e lp F ile : =ThisW orkbook. Path & " \m y fu n c s . chm ", |
|||||
|
H e lp C o n te x tID :=10 00 |
|
|
|
|
|
|
A rg u m e n tD e s c rip tio n s : = A rra y s ( "Первое число |
в сум м е", _ |
||||
|
"В торое число |
в сумме") |
|
|
|
|
1 |
У становка параметров |
для |
функции Squared |
|
|
|
A p p lic a tio n .M a c ro O p tio n s |
M acro:= " S q u a re d ", _ |
|
|
|||
|
D e s c r ip tio n := "Квадрат |
от значения |
аргум ента |
", |
_ |
|
|
H e lp F ile : =ThisW orkbook. Path & " \m y fu n c s . chm ", |
_ |
||||
|
H e lp C o n te x tID :=2000 |
|
|
|
|
|
|
A rg u m e n tD e c rip tio n s : = A rra y ( "Число |
возведено |
в |
кв а д р а т ") |
||
End |
Sub |
|
|
|
|
|
После запуска этих процедур на выполнение пользователь может получить справку непосредственно в диалоговом окне Мастер функций (Insert Function), нажав клавишу <F1> либо щелкнув на ссылке Справка по этой функции (Help on This Function).
Новинка
В предыдущем примере было продемонстрировано использование нового аргумента метода M acroO ptions. В частности, в Excel 2010 поддерживается аргумент A rg u m e n tD e s c rip tio n s . С помощью этого аргумента можно опи сывать все аргументы функции. Эти описания отображаются в диалоговом окне Аргументы функции (Function Arguments), которое вызывается из диа логового окна Мастер функций (Insert Function).
К о м п а к т-д и ск
Демонстрирующая описанную технологию рабочая книга находится на при лагаемом компакт-диске в файле fu n c tio n h e lp \m y fu n c s . xlsm .