D O D A T A K D

Dodavanje pomo}i va{oj aplikaciji

Bez obzira na to kako je umje{na aplikacija, u nekom trenutku ve}ina korisnika po-
~inje postavljati pitanja kako ju koristiti. Osim ako niste tamo kako bi osobno odgovo-
rili na pitanja, najbolji na~in rukovanja time je pru`anje datoteke pomo}i za aplikaciju.
Visual Basic pru`a podr{ku za dva razli~ita sustava pomo}i: tradicionalni sustav Win-
dows Help (WinHelp), i noviji sustav HTML Help. Ovaj dodatak pokriva korake po-
trebne za dodavanje pomo}i tipa WinHelp ili HTML Help va{oj aplikaciji, isti~u}i ne-
koliko razlika izme|u ta dva sustava gdje je to primjenjivo. U ovom dodatku ne}ete
prona}i kako napisati pomo} – postoje brojni dostupni alati takve namjene koji vam u
tome mogu pomo}i.

Sadr`aj
• Dodavanje podr{ke za pomo}
• Dodavanje podr{ke za pomo} What’s This
• Distribuiranje pomo}i s va{om aplikacijom

Dodavanje podr{ke za pomo}

Dodavanje podr{ke za pomo} va{oj aplikaciji Visual Basica je stvarno posve jednos-
tavno. Sve {to trebate je postavljanje jednog svojstva, HelpFile (i, naravno, pisanje i
prevo|enje datoteke pomo}i), za prikaz pomo}i kad korisnik pritisne F1 ili zatra`i
pomo} iz izbornika. Dodatno svojstvo, HelpContextID, mo`e biti postavljeno tako da
pru`i sadr`ajnu temu pomo}i za svaki element korisni~kog su~elja u va{oj aplikaciji.
Postupak hvatanja pomo}i je u biti isti za sustave WinHelp i HTML Help.

Svojstvo HelpFile
Svojstvo HelpFile objekta App se koristi za odre|ivanje imena datoteke pomo}i za
va{u aplikaciju. Ovo svojstvo zahtijeva valjanu datoteku tipa WinHelp (.hlp) ili HTML
Help (.chm). Ako datoteka ne postoji, pojavit }e se pogre{ka.

Vodi~ za programere 887

Dodatak D Dodavanje pomo}i va{oj aplikaciji

Kako postaviti svojstvo HelpFile

1. Odaberite Project Properties iz izbornika Project kako bi otvorili dijalo{ki okvir
Project Properties.
2. U polju Help File Name na kartici General, upi{ite stazu i ime datoteke pomo}i za
va{u aplikaciju (.hlp ili .chm).
Svojstvo HelpFile mo`ete postaviti i programski. Sljede}i programski kod }e odrediti
HTML Help datoteku koja se nalazi u istom direktoriju kao i izvr{na datoteka aplikaci-
je:
Private Sub Form_Load()
App.HelpFile = App.Path & “\foo.chm”
End Sub

Objekt ErrObject tako|er ima svojstvo HelpFile, omogu}uju}i vam da odredite druga-
~iju datoteku pomo}i za poruke pogre{aka. Na primjer, ako imate nekoliko aplikacija
koje dijele iste poruke pogre{aka, mo`ete postaviti pomo} za poruke gre{aka u jednu
datoteku pomo}i koja mo`e biti pozvana svojstvom Err.HelpFile u svakoj aplikaciji.

Svojstvo HelpContextID
Svojstvo HelpContextID se koristi za povezivanje elementa korisni~kog su~elja (kao
{to je kontrola, forma ili izbornik) sa srodnom temom u datoteci pomo}i. Svojstvo
HelpContextID mora biti tipa Long koji se podudara s brojem Context ID u temi
datoteke pomo}i tipa WinHelp (.hlp) ili tipa HTML Help (.chm).
Na primjer, mo`ete unijeti broj 10 000 u svojstvo HelpContextID okvira s tekstom.
Kad korisnik odabere taj okvir s tekstom i pritisne F1, Visual Basic tra`i temu s bro-
jem Context ID od 10 000 u datoteci pomo}i odre|enoj u svojstvu HelpFile aplikacije.
Ako je tema prona|ena, otvorit }e se prozor Help i prikazati temu; ako nije, pojavit }e
se pogre{ka i bit }e prikazana podrazumijevana tema datoteke pomo}i.
Trebate upotrebljavati jedinstvene vrijednosti svojstva HelpContextID za podudaranje
sa svakom temom pomo}i u va{oj datoteci pomo}i. U nekim slu~ajevima, mo`ete tre-
bati dodijeliti istu vrijednost svojstvima HelpContextID vi{e objekata ako objekti
dijele zajedni~ku temu pomo}i.
Ne trebate obavezno odrediti svojstvo HelpContextID za svaku kontrolu na formi. Ako
korisnik pritisne F1 na kontroli ~ije je svojstvo HelpContextID postavljeno na 0 (stan-
dardno), Visual Basic }e potra`iti valjan broj pomo}i za spremnik te kontrole.
Kako dodijeliti svojstvo HelpContextID kontroli ili formi
1. Odaberite kontrolu ili formu za koju `elite odrediti svojstvo HelpContextID.
2. Dva puta kliknite svojstvo HelpContextID u prozoru sa svojstvima i upi{ite valjan
cijeli broj tipa Long.
Pratite vrijednosti koje unosite tako da mo`ete upotrijebiti iste vrijednosti za broj
pomo}i u pridru`enoj temi pomo}i.

888 Vodi~ za programere

 Dodatak D Dodavanje pomo}i va{oj aplikaciji

Napomena Za kontrolu CommonDialog te za neke druge kontrole, ime ovog svojst-

va je HelpContext umjesto HelpContextID.
Kako dodijeliti svojstvo HelpContextID izborniku
1. Odaberite Menu Editor iz izbornika Tools.
2. Odaberite stavku izbornika kojoj `elite odrediti svojstvo HelpContextID.
3. Upi{ite valjan broj tipa Long u okvir Select the HelpContextID.
Pratite vrijednosti koje unosite tako da mo`ete upotrijebiti iste vrijednosti za broj
pomo}i u pridru`enoj temi pomo}i.
Svojstvo HelpContextID mo`e tako|er biti odre|eno programski na sljede}i na~in:
Private Sub Form_Load()
Command1.HelpContextID = 12345
MenuHelp.HelpContextID = 23456
Err.HelpContext = 34567
End Sub
Savjet Ako imate vi{e od nekoliko tema pomo}i, moglo bi pomo}i uspostavljanje
sheme obroj~avanja prije nego {to po~nete upisivati vrijednosti svojstava
HelpContextID. Dodijelite druga~ije opsege brojeva svakoj formi ili glavnom ele-
mentu u va{oj aplikaciji, na primjer, 1000 – 1999 za prvu formu, 2000 – 2999 za
drugu i tako dalje.

Dodavanje podr{ke za pomo} What’s This

Visual Basic vam omogu}uje da lako dodate pomo} What’s This svojoj aplikaciji.
Pomo} What’s This pru`a brz pristup tekstu pomo}i u pomo}nom prozoru bez potrebe
za otvaranjem preglednika pomo}i. Ova pomo} se tipi~no koristi za pru`anje jedno-
stavne podr{ke elementima korisni~kog su~elja kao {to su polja za unos podataka.
Visual Basic podr`ava teme pomo}i What’s This u datotekama tipa WinHelp (.hlp) i
tipa HTML Help (.chm).
Postavljanje svojstva WhatsThisHelp forme na True omogu}uje pomo} What’s This.
Kad je omogu}ena pomo} What’s This, pomo} forme osjetljiva na sadr`aj je
onemogu}ena.
Kako omogu}iti pomo} What’s This za formu
1. S odabranom formom, dva puta kliknite na svojstvo WhatsThisHelp u prozoru sa
svojstvima kako bi to svojstvo postavili na True.
2. Postavite sljede}a svojstva kako bi dodali gumb What’s This u naslovnu traku
forme:
svojstvo postavka
BorderStyle 1 – Fixed Single ili 2 – Sizable
MaxButton False
MinButton False
WhatsThisButton True

Vodi~ za programere 889

Dodatak D Dodavanje pomo}i va{oj aplikaciji

Napomena Forma ne mo`e imati gumb What’s This ako ima gumbe Minimize i
Maximize. Kao alternativu prije prikazanim postavkama, mo`ete tako|er postaviti
svojstvo BorderStyle na 3 – Fixed Dialog, budu}i da nepromjenjivi dijalozi nemaju
gumbe Minimize i Maximize.
3. Odaberite svaku kontrolu kojoj `elite pru`iti pomo} What’s This i dodijelite jedin-
stvenu vrijednost svojstvu WhatsThisHelpID te kontrole.
Pratite vrijednosti koje unosite tako da mo`ete upotrijebiti iste vrijednosti za broj
pomo}i u pridru`enoj temi pomo}i.
Va`no Kako bi ostvarili pomo} What’s This u pomo}i tipa HTML Help, sve teme
pomo}i What’s This moraju biti sadr`ane u datoteci Cshelp.txt koja se prevodi u
.chm datoteku. Za vi{e informacija, pogledajte dokumentaciju za va{ alat stvaranja
pomo}i tipa HTML Help.
Pomo} What’s This mo`ete tako|er omogu}iti bez kori{tenja gumba What’s This tako
da postavite svojstvo WhatsThisHelp forme na True i pozovete postupak
WhatsThisMode forme ili postupak ShowWhatsThis kontrole.

Distribuiranje pomo}i s va{om aplikacijom

Posljednji korak dodavanja pomo}i va{oj aplikaciji je osiguravanje da do|e u ruke
krajnjem korisniku. Zahtjevi za distribuiranje pomo}i s va{om aplikacijom se neznatno
razlikuju izme|u pomo}i tipa WinHelp i tipa HTML Help.

Distribuiranje pomo}i tipa WinHelp

Budu}i da svaki sustav Windowsa ve} ima instaliranog preglednika pomo}i tipa
WinHelp, jedina stvar koju trebate distribuirati je sama datoteka pomo}i (.hlp). ^arob-
njak za pakiranje i raspore|ivanje }e automatski dodati ovisnost za datoteku pomo}i na
koju upu}uje va{a aplikacija. Ako stvarate pode{avanje drugim sredstvima, morate
osigurati da .hlp datoteka bude uklju~ena i instalirana na pravo mjesto (obi~no u isti
direktorij gdje je aplikacija ili u direktorij \Windows\Help).

Distribuiranje pomo}i tipa HTML Help

Pomo} tipa HTML Help je relativno nova tehnologija, i zbog toga ne mo`ete pret-
postaviti da }e svaki korisnik imati datoteke potrebne za pregled pomo}i tipa HTML
Help. ^arobnjak za pakiranje i raspore|ivanje }e dodati ovisnost za datoteku pomo}i
tipa HTML Help (.chm) na koju upu}uje va{a aplikacija; me|utim, mo`da ne}e dodati
sve ovisnosti za datoteke pregledavanja pomo}i tipa HTML Help. Trebate promijeniti
svoje pode{avanje tako da uklju~uje te datoteke. Potra`ite upute u dokumentaciji va{eg
alata za stvaranje pomo}i tipa HTML Help za vi{e informacija o tome koje su datoteke
potrebne u danoj situaciji.

890 Vodi~ za programere