Vážení čtenáři,

 

rád bych vás přivítal u již patnáctého dílu seriálu o nápovědě. Dnes budeme pokračovat tím, čím jsme minule začali, a sice odpověděmi na vaše dotazy a problémy, se kterými jste se při experimentování s nápovědou střetli. Připravte se, druhá dávka otázek a odpovědí na vás již netrpělivě čeká.

 

 

 

 

Protože dotazů, které se zabývají použitím makra ALink přišlo poněkud více, rozhodl jsem se, že celou problematiku si vysvětlíme podrobněji a uvedenou teorii posléze aplikujeme na příkladu. Nuže, makro ALink se používá při práci s A-klíčovými slovy, která do souboru s tématy (.RTF) vkládá autor nápovědy. Jestliže chceme opatřit patřičné téma (případně témata) nápovědy A-klíčovými slovy, postupujeme takto:

 

1. Vložíme do oblasti poznámky pod čarou tématu symbol A.
2. Za uvedený symbol napíšeme textový řetězec, který představuje A-klíčové slovo.

 

Zapsané A-klíčové slovo bude od nyní jednoznačně identifikovat dané téma pro potřeby makra ALink. Jestliže v budoucnu zavoláte makro ALink, kterému předáte jako vstupní parametr zadané A-klíčové slovo, bude moci makro správně nalézt téma a zobrazit jej. V případě, že bude nalezeno více témat, která odpovídají zadaným kriteriím, zobrazí systém WinHelp dialogové okno se seznamem dostupných témat. Uživatel pak může poklepat na to téma, které si přeje zobrazit.

 

Celý postup je tedy jednoduchý: Nejdříve opatříte všechna témata příslušnými A-klíčovými slovy a poté zavoláte makro ALink, jemuž předáte jako parametr to A-klíčové slovo, které se má vyhledat.

 

 

Kromě A-klíčových slov poznáme ještě K-klíčová slova. Tyto dvě skupiny klíčových slov se od sebe liší uživatelskou „viditelností“. A-klíčová slova, která jsou vkládána do tématu, se nikdy nezobrazí koncovému uživateli. Na druhé straně, K-klíčová slova se standardně zobrazují v rejstříku nápovědy a jsou tedy uživateli snadno dostupná. Při vkládání K-klíčových slov se do poznámky pod čarou umísťuje symbol K, za kterým následuje patřičné K-klíčové slovo. Když budeme chtít vyhledat jisté K-klíčové slovo, použijeme za tímto účelem makro KLink.

 

V následujícím příkladu si ukážeme, jak sestavit jednoduchý systém nápovědy, který bude obsahovat tři témata. Tato témata opatříme symbolem A a A-klíčovými slovy v poznámce pod čarou. Dále přidáme do prvního tématu tlačítko pro vyhledání příbuzných témat.

 

 

Po otevření přiloženého souboru s tématy (.RTF) si všimněte, že dokument obsahuje tři témata. Každé téma je jedinečně pojmenováno použitím symbolu mřížky (#). Všechna témata jsou dále opatřena symbolem dolaru ($), za kterým následuje textový řetězec (uživatelsky přívětivý název tématu), jenž se bude později objevovat ve vyhledávacím dialogovém okně makra ALink.

 

 

Abyste přidali prvnímu tématu symbol A do poznámky pod čarou, udělejte následovní:

 

1. Umístěte kurzor za symbol dolaru ($), jenž se nachází před textem „Toto je téma č. 1.“ (obr. 1).

 

 

Obr. 1 – Umístění kurzoru za symbol dolaru

 

2. Vyberte nabídku Insert, ukažte na Reference a klikněte na položku Footnote. Objeví se dialogové okno pro vložení poznámky pod čarou. Do textového pole Custom mark zadejte znak A a následně aktivujte tlačítko OK.
3. Word vás automaticky přemístí do oblasti poznámky pod čarou. Za symbol A zadejte řetězec makro. Zadaný řetězec je A-klíčovým slovem pro první téma nápovědy. Výslednou podobu oblasti poznámky pod čarou zachycuje obr. 2.

 

 

Obr. 2 – Zadání A-klíčového slova v poznámce pod čarou

 

4. Uvedený postup opakujte i pro další dvě témata, do kterých vložte symbol A a A-klíčové slovo makro.
5. Dále budeme pokračovat tím, že do textu prvního tématu umístíme zápis pro vytvoření tlačítka, které bude asociované s makrem ALink. Přemístěte se proto na první téma dokumentu. Vložte pod úvodní text několik prázdných řádků a posléze zadejte tento text:

 

{button, ALINK(makro)}

 

6. Uložte soubor s tématy (.RTF).
7. Spusťte program Help Workshop, vytvořte nový projekt a přidejte do projektu právě vytvořený subor s tématy (.RTF).
8. Uskutečněte kompilaci projektového souboru nápovědy (.HPJ) a spusťte vytvořený soubor nápovědy (.HLP).

 

Klepnete-li na tlačítko, provede se několik operací. Předně, zavolá se makro ALink, kterému se jako vstupní parametr předá hledané A-klíčové slovo makro. Makro ALink následně prohledá všechna témata, která obsahují A-klíčová slova a vybere ta, jež odpovídají zadaným kriteriím. Nalezená témata se zobrazí v dialogovém okně. Vybere-li uživatel jakékoliv téma nápovědy, to se zobrazí v hlavním nápovědním okně. Popisovanou situaci znázorňuje obr. 3.

 

   

Obr. 3 – Proces zobrazení příbuzných témat pomocí makra ALink

 

 

 

Použijte makro ControlPanel v podobě uvedené na obr. 4. 

 

 

Obr. 4 – Použití makra ControlPanel

 

 

 

Jistě budete potěšeni, když vám povím, že zobrazovat popup okna WinHelpu 4.0 v prostředí HTML nápovědy doopravdy lze. Váš problém zcela jistě vyřeší ovládací prvek HTML Help Control. Pomocí následujícího postupu vytvoříte tlačítko, po jehož stisknutí se objeví popup okno typu WinHelp 4.0. Postupujte dle uvedených instrukcí:

 

1. V programu HTML Help Workshop otevřete váš projektový soubor HTML nápovědy (.HHP).
2. Označte záložku Contents a poklepejte na název té položky, kterou si přejete modifikovat. V pravé části se zobrazí HTML kód souboru, jenž je asociován s danou položkou.
3. Umístěte kurzor na to místo .HTM dokumentu, kde chcete vložit instanci ovládacího prvku HTML Help Control.
4. Z nabídky Tags vyberte položku HTML Help Control. Objeví se průvodce vložením uvedeného prvku.
5. V poli Specify the command vyberte položku WinHelp topic, jak je uvedeno na obr. 5.

 

 

Obr. 5 – Výběr příkazu v prvním kroku průvodce vložením prvku HTML Help Control

 

6. Ve druhém kroku vyberte možnost vytvoření tlačítka (As a button).
7. Ve třetím kroku vyberte možnost Display text on the button a poté zadejte text, který se má objevovat na vytvořeném tlačítku.
8. Čtvrté okno průvodce upravte do podoby zobrazené na obr. 6 (cestu k vašemu souboru nápovědy stylu Windows 95 upravte podle potřeby a rovněž tak i kontextový řetězec (Topic ID) pro téma, jenž se má zobrazit v popup okně).

 

 

Obr. 6 – Čtvrtý krok průvodce vložením prvku HTML Help Control

 

9. Následujte pokyny průvodce až do konce. Pokračujte uložením projektu a kompilací souboru HTML nápovědy.

 

Příklad zobrazení tématu typu WinHelp 4.0 v popup okně HTML nápovědy můžete vidět na obr. 7.

 

 

Obr. 7 - Zobrazení popup okna stylu WinHelp 4.0 v HTML nápovědě

 

 

 

Odpověď na vaší otázku je nasnadě: Využijte možností třídy Help, která zapouzdruje možnosti HTML nápovědy. Předpokládejme, že na formuláři se nachází jedno tlačítko s názvem Button1. Chcete-li zobrazit .HTM soubor, vyplňte obsluhu události Click tlačítka takto (cestu k vašemu .HTM souboru upravte, jak je libo):

 

    Private Sub Button1_Click(ByVal sender As System.Object, _

    ByVal e As System.EventArgs) Handles Button1.Click

 

        Help.ShowHelp(Me, "c:\Soubor1.htm")

 

    End Sub  

 

 

Ján Hanák