Підключаємо до додатка довідку у форматі. CHM, MS Office, Програмні керівництва, статті

 

Я думаю не треба доводити, що значить для серйозного додатка довідкова система? Без неї продукт взагалі не можна позиціонувати продукт як комерційний …


Хороша інтерактивна дружелюбна довідка має для користувача вирішальне значення при виборі продукту! Також в довідці можна детально розписати безліч нюансів і підказок по певної дії в програмі, що знову ж таки дозволить користувачам повною мірою використовувати всі можливості Вашого застосування, тобто Ваше додаток стає більш ефективним в руках просвітлених користувачів і легко виграє тендер в чесній конкурентній боротьбі ;).


Спочатку треба створити довідкову систему 😉 Особисто я використовую для підготовки Help & Manual 3 версії (не безкоштовний!). в принципі, технічно нічого складного в підготовці довідкової системи немає. Пишеш як в Word “e нові сторінки, об’єднує їх в папки, папки. Набагато складніше наповнити довідку інтелектуальної складової 😉


Так, ще акуратно нумерувати Help Contex Numbers, за яким можна буде згодом викликати потрібну сторінку (ми ж хочемо не просто відкривати файл довідки, а відразу вибирати потрібне місце в довідці, відповідно виконуваному дії або відкритій формі, що цілком логічно).


В Help & Manual є різні заготовки, які потрібно тільки заповнити своїм змістом і, вважайте, довідка до програми готова! Маленький секрет – зайдіть у властивості проекту та виставте російські настройки, інакше після компіляції отримаєте кракозябри 😉 В Інтернеті є русифікація з ліками для цього пакета, хороша російська довідка про програму, так, що думаю ніяких проблем при підготовці стандартної довідкової системи виникнути не повинно.


З іншого боку, довідку можна готувати в будь-якому текстовому редакторі, а потім скомпілювати безкоштовним компілятором від Microsoft (htmlhelp.exe). Але цей шлях досить трудомісткий – набагато легше використовувати спеціалізовані пакети.


Ну все, будемо вважати, що довідка у нас написана, Help Contex Numbers розставлені, і файл. CHM успішно скомпільований.


створимо в програмі модуль mdlHelp і вставимо в нього цей код:


Option Compare Database
Option Explicit

Private Const HH_DISPLAY_TOPIC = &H0
Private Const HH_HELP_CONTEXT = &HF

Private Declare Function HtmlHelp Lib “Hhctrl.ocx” Alias “HtmlHelpA” _
(ByVal hWndCaller As Long, ByVal pszFile As String, ByVal uCommand As Long, _
ByVal dwData As Long) As Long

Private Function LaunchHTMLHelp(HelpFile As String, Optional WindowHandle As Long, _
Optional Topic As Long) As Boolean


Dim lngReturn As Long

On Error Resume Next

If VBA.Len(VBA.Dir$(HelpFile)) > 0 Then
    If Topic = 0 Then
        lngReturn = HtmlHelp(WindowHandle, HelpFile, HH_DISPLAY_TOPIC, 0)
    Else
        lngReturn = HtmlHelp(WindowHandle, HelpFile, HH_HELP_CONTEXT, Topic)
    End If
    LaunchHTMLHelp = VBA.CBool(lngReturn)
End If

End Function

Public Function getHelp(intTopic As Long) As Boolean
Dim strAppPath As String

On Error Resume Next

strAppPath = Application.CurrentProject.Path & “”
getHelp = LaunchHTMLHelp (strAppPath & “AddOnsСправка_УНПДД.chm”, 0, intTopic)

End Function
 


в принципі це все, що потрібно для нормальної роботи з довідкою у форматі. CHM 😉


викликаємо з будь-якого місця програми так:


getHelp (100)


“Де 100 і є те самий Help Contex Numbers, вказаний при підготовці потрібної сторінки


“Довідка відкриється і автоматично вибереться сторінка з Help Contex Numbers рівним 100


якщо хочемо просто показати файл довідки з початкової сторінки:


getHelp (0)


Так як це функція, то викликати її необов’язково з програмного коду модуля форми – досить просто написати у події відповідного контрола “Натискання кнопки” = getHelp (100)


Автор коду Jamie Czernik. Я взяв на себе сміливість спростити код без видимої втрати функціональності.


Особисто моя думка після практичної роботи щодо створення довідкової системи – для Access виправдане застосування довідки у форматі WinHelp. Це дозволяє обійтися взагалі без якого-небудь кодування (використовуємо клавішу F1 і кнопку контекстної довідки – знак питання на панелі заголовка форми). Точно також при створенні довідки акуратно розставляємо Help Contex Numbers, а потім у властивостях форм і контролів вказуємо їх як ідентифікаторів довідки для виклику конкретної сторінки. Help & Manual3 прекрасно компілює довідку і в. HLP форматі, який все ще є “рідним” для Access.

Схожі статті:


Сподобалася стаття? Ви можете залишити відгук або підписатися на RSS , щоб автоматично отримувати інформацію про нові статтях.

Коментарів поки що немає.

Ваш отзыв

Поділ на параграфи відбувається автоматично, адреса електронної пошти ніколи не буде опублікований, допустимий HTML: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

*

*