Help

Objekt Help slou₧φ k volßnφ HTML nßpovědy. Poskytuje nßsledujφcφ metody:

• procedure HTMLHelpIndex (FileName: string) - otevře HTML nßpovědu, hlavnφ okno bude obsahovat index.

• procedure HTMLHelpTOC (FileName: string) - otevře HTML nßpovědu, hlavnφ okno bude obsahovat obsah.

• procedure HTMLHelpSearch (FileName: string) - otevře HTML nßpovědu, hlavnφ okno bude obsahovat vyhledßvacφ formulßř.

• procedure HTMLHelpTopic (FileName: string; Topic: string) - otevře HTML nßpovědu, hlavnφ okno bude obsahovat rejstřφk.

Přφklad:

V nßsledujφcφm přφkladě je ukßzka, jak volat tuto nßpovědu v zßvislosti na tom, na jakΘm slově stojφ kurzor.

V inicializačnφm skriptu v hlavnφ funkci nechejte vytvořit akci pro volßnφ nßpovědy na stisk klßves Ctrl+F1 a vlo₧te jej do menu Help:

  Actions.NewAction ("actContextHelp", "Context help", "", "Ctrl+F1", -1,

                     System.ScriptPath+"help.js", "ContextHelp",

                     System.ScriptPath+"help.js", "ContextHelpUpdate");

  Menu.InsertActionItem ("miContextHelp", "miHelp", "actContextHelp", 4);

V souboru help.js budou dvě funkce. ContextHelp je ta, kterΘ bude na stisk tlačφtka volßna, ContextHelpUpdate určuje, kdy je mo₧nΘ prvnφ uvedenou funkci volat (zde pouze v přφpadě, je-li otevřen nějak² soubor). Funkce mohou tedy vypadat např. takto:

function ContextHelp()

{

  Help.HTMLHelpTopic (System.ApplicationPath+"rkScripting.chm",

                      Editor.ActiveEdit.WordAtCursorPos+".htm");

}

function ContextHelpUpdate()

{

  Actions.SetActionEnabled (Actions.UpdatedAction,

                            Editor.IsSomeFileOpened());

}

Pokud nynφ bude kursor např. na slově Help, zobrazφ se tento text. Je nutnΘ si uvědomit, ₧e kontextovß nßpověda je napsßna pouze pro znßmΘ objekty.

Funkci ContextHelp je mo₧nΘ upravit např. pro různΘ zv²razňovače apod.