Pääteohjaustehtäviä 11 / 20-21.11
Pääteohjaustehtäviä 11 / 20-21.11	1
1.	Avustus	1
2.	Avustus HTML:llä	1

1.	Avustus
1.	Kirjoita avustuksen alkua omaan ohjelmaasi.  Kopioi aluksi tiedosto n:\kurssit\winohj\oop\apf\mfc\vaihtaja\help97.dot omaan hakemistoosi.  Käynnistä sitten Word 97 (jos vanhempi Word, niin käytä help.dot), avaa uusi tiedosto ja valitse malliksi (template) HELP97 (Tools/Templates and Add-Ins../Document template/Attach ja tarkista vielä että Add automatically… on päällä).  
2.	Ennen aloittamista tarkista, että makrossa Testaa (Tools/Macro/Macros ja valitse Testaa ja Edit) rivi
WordBasic.Shell "C:\devel\Delphi5\Help\Tools\hcw /c /m /e " + BaseName$, 1
	todella osoittaa sinne, missä hcw.exe on.
3.	Kirjoita avustustiedosto .doc-nimellä (mieluiten tietysti omaan työhösi liittyen) ja testaa sitä.  (jostain syystä pitää kerran avata ja sulkea .err-tiedosto käsin).
Käyttö:
1) Tee heti ensimmäiseksi File saveAs oikeaan hakemistoon ja .doc-päättellä
2) Jaa avustuksesi "sivuihin".  Kukin sivu erotetaan Sivunvaihdolla (Ctrl-Enter)
3) Kunkin sivun 1. rivi kannattaa merkitä otsikoksi Heading1 tai Heading2-      
   tyylillä.  Älä käytä tyhjiä rivejä!
4) Mene yhden kerran kunkin sivun 1.riville ja paina nappulaa "NimiJaOsoite".
   Tämä macro tekee tarvittavat hyppypaikat ja otsikot sivulle.
5) Jos haluat hypätä johonkin kohti, mene Footnotes-ikkunassa hyppypaikkaa 
   vastaavalle #-riville ja paina OtaHyppy
6) Siirry sille tekstissä siihen paikkaan, josta haluat hypätä tähän kohti,
   maalaa se sena,jonka haluat linkiksi.  Paina 2alleviivaus.  Siirry sanan 
   loppuun ja paina LisaaHyppy
7) Kun haluamasi hypyt on merkitty, paina Testaa.
8) Korjaile ja testaa uudelleen.
4.	Delphissä avustuksen saa auki esimerkiksi suorittamalla komennon
Application.HelpJump('Elaimet'); // Haluttu tunnistemerkkijono .hlp-tiedostosta
	Ensin pitää kuitenkin olla esim..dpr-tiedoston alussa sijoitus:
Application.HelpFile := 'elukat.hlp';
	Voi myös kirjoittaa .hpj-tiedoston [MAP]-osaan:
[Map]
#define kissa 100
#define koira 101
	ja sitten laittamalla halutun Delphi-komponentin HelpContext-kohtaan noita vastaavia numeroita.  Ja avustustiedostossa täytyy tietysti olla sitten nuo mainitut tunnistemerkkijonot.
2.	Avustus HTML:llä
1.	Kirjoita erittäin minimaalinen HTML–tiedosto (yhden valmiin saat esim: n:\kurssit\winohj\delphi\html\oma.html)
2.	Tee Delphillä erittäin minimaalinen WWW–selain, jossa on vain yksi HTML–komponentti (TWebBrowser), Edit–ikkuna ja nappula Hae.
3.	HTML–komponenttiin voit hakea dokumentin komennolla
WebBrowser.Navigate(EditURL.Text);
4.	Edit–ikkunaan pitää kirjoittaa www-linkki tai tiedoston koko polku (?).  Jos halutaan välttää absoluuttisia polkuja – kuten aina pitäisi - ja kuitenkin hakea tiedostoa samasta hakemistosta kuin missä ohjelma on, voidaan nimi selvittää seuraavasti (esim. FormCreatessa)
EditUrl.Text := ExtractFilePath(ParamStr(0)) + 'oma.html'
	Vastaavasti nykyhakemisto asetettaisiin polun eteen (nykyhakemisto voi olla eri kuin se, mistä ohjelma on käynnistetty):
GetDir(0,dir); // dir:string jossakin
EditUrl.Text := dir + '\' + 'oma.html';  // GetDir ei laita loppuun \-merkkiä!