### Kontextová nápověda (editor)

Editor kontextové nápovědy poskytuje úplnou kontrolu nad přiřazením kontextových ID, symbolických ID, zdrojových souborů a komentářů k tématu. Možnost práce v jednoduchém režimu je naopak výhodná pro uživatele, kteří se nechtějí podrobnostmi definice zabývat.

Editor kontextové nápovědy umožňuje také zadání textů stručné nápovědy (Text popups), vizuální označení duplicit a v neposlední řadě kopírování a vkládání vybraných položek do a ze schránky (pro snadnou spolupráci s jinými aplikacemi).

Navigační panel kontextové nápovědy slouží pro filtraci položek, volbu režimu práce a nastavení dalších parametrů editoru. Umožňuje také hromadné přiřazení kontextových identifikátorů všem tématům nápovědy.

Editace samotná pak probíhá na stránce Kontextová nápověda, která zobrazuje přehlednou tabulku témat, identifikátorů kontextové nápovědy, zdrojů umístění a komentářů. Veškeré úpravy lze provádět přímo v tabulce, takže vytváření kontextové nápovědy připomíná práci s tabulkovým procesorem.

Tabulku lze (kromě voleb v navigačním panelu) filtrovat také podle textu, a to pomocí pole Vyhledat (na stránce vpravo nahoře).

Editor nabízí efektní možnosti práce se schránkou, kdy je možné přenášet celé vybrané řádky, nebo jen údaje ve sloupcích, a to jak v rámci aplikace Precision Helper (a jejích instancích), tak mezi Precision Helper a jinými aplikacemi (např. vývojovým nástrojem, tabulkovým procesorem, apod.).

Poznámka:
Tabulka kontextových identifikátorů je vždy předvyplněna všemi tématy definovanými kdekoliv v projektu. Nemusíte tedy (ať už postupně nebo hromadně) přidávat a odebírat témata, ale jen přiřazujete identifikátory. Ukládány jsou pak jen ty řádky tabulky, které mají vyplněny potřebné údaje kontextové nápovědy.

Nápověda k práci s navigačním panelem kontextové nápovědy je uvedena zde.

Možnosti editoru kontextové nápovědy

- Přidat stručnou nápovědu - přidání textu stručné nápovědy (narozdíl od řádku s tématy, která jsou již v tabulce předvyplněna, musíte položky tohoto typu přidávat a odebírat manuálně)
- Přidat téma - jak již bylo uvedeno výše, všechna témata projektu jsou již v tabulce předvyplněna, ale pokud chcete přidat téma, které ještě není uvedeno v obsahu, rejstříku nebo jinde v projektu, tato volba Vám poskytuje tuto možnost
- Odebrat - tato volba odstraní definici kontextové nápovědy z vybraných řádků tabulky. Pro témata to znamená vyčištění definice (řádky s tématy v tabulce zůstanou), pro texty stručné nápovědy to znamená odstranění celého řádku.
- Klávesou F2 (nebo přímým zahájením psaní požadovaného textu) zahájíte editaci vybrané buňky tabulky. Různé buňky poskytují různé podpůrné prvky pro zadání potřebného údaje (např. sloupce "Zdroj" poskytují roletovou nabídku se seznamem všech zdrojů uvedených v daném sloupci, apod.).
- Kopírovat do schránky - vybrané buňky zkopírujete do schránky. Výběr ve sloupci témat můžete realizovat buď myší nebo klávesnicí, výběr v ostatních sloupcích pak ovlivníte klávesami SHIFT a CTRL. Všechny řádky v aktuálním sloupci vyberete pomocí zkratky CTRL+A. Jestliže jsou pro výběr označeny buňky v prvním sloupci (témata), pak se do schránky kopírují celé řádky (všechny sloupce), v opačném případě se do schránky kopírují jen údaje ze sloupce, ve kterém jsou buňky označeny. Kopie celých řádků je účinným pomocníkem pro přenos definice do vývojového nástroje, pokud nevyužívate jako zdroj identifikátorů přímo hlavičkové soubory (.h, .ali).
- Vložit ze schránky - tato volba má velmi rozsáhlé možnosti (i důsledky) v závislosti na tom, jaké údaje jsou ve schránce umístěny a jaká buňka je vybrána (aktivní) při vyvolání této akce.
  - Jestliže jsou ve schránce celé řádky definice - nastavte se při vkládání ze schránky vždy na první sloupec (jinak budou vloženy údaje do irelevantních sloupců). Údaje ze schránky budou vkládány vždy od toho řádku, na kterém stojíte, až do KONCE ÚDAJŮ VE SCHRÁNCE (mohou být tedy přidány i nové řádky definice).
  - Jestliže chcete, aby se údaje ze schránky vložily jako nové řádky - využijte níže popsanou volbu "Vložit jako nové".
  - Jestliže je ve schránce jen jeden "sloupec" údajů (řádky ve schránce jsou odděleny znaky CRLF a sloupce znakem TAB) - nastavte se při vkládání ze schránky na ten sloupec, do kterého chcete údaje vložit. Údaje ze schránky budou vkládány vždy od toho řádku, na kterém stojíte, až do KONCE VAŠÍ DEFINICE (nebo do konce údajů ve schránce, pokud je menší než zbývající řádky Vaší definice).
  - Narozdíl od standardní editace se při vkládání ze schránky žádným způsobem nekontroluje obsah vkládáných údajů. Kontrola je provedena až následně, při ukončení práce s editorem (zavření stránky).
- Vložit jako nové ... - tato volba vloží údaje ze schránky coby nové řádky definice a je k dispozici jen na prvním sloupci tabulky. Řádky se vkládají buď jako texty krátké nápovědy, a nebo jako témata v případě, že daný údaj má charakter názvu souboru.
- Přiřadit ID vybraným - tato volba je variantou akce "Přiřadit identifikátory", která přiřadí identifikátory jen pro vybrané řádky tabulky
- Přejít na ... - přejde na téma (z aktuálního řádku tabulky) do obsahu, rejstříku nebo seznamu souborů projektu (jinými slovy tam, kde je téma v projektu uvedeno). Volba kontextové nabídky přejde na první uvedený výskyt tématu, pomocí tlačítka "Přejít na ..." si můžete vybrat, zda chcete přejít na obsah, rejstřík, apod.
- Duplicitní položka - v případě, že existuje duplicita k vybrané položce, pak se pomocí této akce na duplicitní položku můžete nastavit (pokud je odpovídajících duplicit více, probíhá nastavení se v rámci tabulky odshora dolů)
- API Tester - otevře nástroj API Tester (pro rychlé ověření správnosti definice kontextové nápovědy nebo rejstříku)
- Vlastnosti - zobrazí kartu Editoru vlastností, kde se v tomto kontextu zobrazuje náhled na vybrané téma nebo text stručné nápovědy

Použitá terminologie

- kontextový identifikátor - celočíselný identifikátor (označovaný někdy také jako "MAP ID" nebo "HelpContext") používaný k propojení nápovědy a aplikace, pro kterou je nápověda určena. Pro téma, které má přiřazen kontextový identifikátor, můžete zobrazit nápovědu přímo z Vaší aplikace (Váš vývojový prostředek musí podporovat propojení nápovědy aplikace - viz. také API Tester).
- symbolický identifikátor - symbolické označení (alfanumerický identifikátor označovaný většinou jako "ALIAS ID") používané jako prostředník mezi kontextovým identifikátorem a tématem v případě potřeby (např. když soubor tématu obsahuje mezery, apod.).
- zdroj - zdrojem je označeno fyzické umístění kontextového nebo symbolického identifikátoru v rámci projektu. Tyto identifikátory mohou být umístěny buď přímo v souboru projektu, nebo v samostatných definičních souborech (viz. také Nastavení - Externí nástroje - MS Html Help).
- text stručné nápovědy - texty nápovědy zobrazované při výběru funkce stručné nápovědy a najetí myší na vybraný prvek aplikace. Tyto položky kontextové nápovědy jsou vždy ukládány mimo soubor projektu, a proto mají vždy přiřazeny zdrojové soubory (resp. alespoň zdroj pro symbolické ID).

Copyright © 2008-2010 Precision software & consulting. Všechna práva vyhrazena.