### Kontextová nápověda

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.
Panel je rozdělen do tří sekcí - Filtr témat, Filtr identifikátorů a Ostatní volby.

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.

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 tabulkou editoru kontextové nápovědy je uvedena zde.

Možnosti panelu Kontextová nápověda

- Filtr témat:
- Témata obsahu - v tabulce zobrazí pouze témata uvedená v obsahu (vynechá např. témata uvedená jen v rejstříku)
- Témata rejstříku - zobrazí pouze témata uvedená v rejstříku (vynechá např. témata uvedená jen v obsahu)
- Témata projektu - zobrazí pouze témata uvedená v seznamu souborů explicitně zařazených do projektu
- Ostatní témata - zobrazí všechna ostatní témata neodpovídající podmínkám pro filtr témat obsahu, rejstříku, projektu a textům stručné nápovědy
- Texty stručné nápovědy - zobrazí pouze texty stručné nápovědy
- Filtr identifikátorů:
- Duplicitní ID - zobrazí pouze ty řádky tabulky, které mají duplicitní kontextový nebo symbolický identifikátor
- Bez kontextového ID - zobrazí pouze řádky bez uvedeného kontextového identifikátoru
- Bez symbolického ID - zobrazí pouze řádky bez uvedeného symbolického identifikátoru
- Komentáře - zobrazí pouze řádky, které mají uvedeny komentáře
- Ostatní volby:
- Označit duplicity - užitečná volba, která pomáhá při identifikaci duplicit v rámci tabulky. Buňky s duplicitními identifikátory budou podrženy červenou vlnovkou (viz. také "Filtr identifikátorů - Duplicitní ID" výše).
- Přiřazovat identifikátory automaticky - jestliže nechcete přiřadit identifikátory automaticky najednou (viz. volba "Přiřadit identifikátory" níže), ale přesto by jste ocenili nějakou formu automatizace této činnosti, můžete využít tuto volbu. Umožní totiž přiřadit identifikátory (a také jejich zdroje) automaticky vždy jen pro ten řádek tabulky, který právě editujete. Stačí Vám tedy vždy vyplnit např. jen kontextový identifikátor a zbytek definice bude doplněn automaticky. Dokonce je možné jen zahájit editaci, zadat mezeru a potvrdit klávesou ENTER a celá definice řádku se vyplní.
- Zobrazit všechny sloupce - toto je volba pro přepínání režimu práce. Jestliže je zapnuta, máte nad definicí plnou kontrolu (vidíte a upravujete témata, identifikátory, zdroje i komentáře). Jestliže je volba vypnuta, vidíte a upravujete jen dva nejdůležitější sloupce definice (téma a kontextový identifikátor) a zbytek definice (symbolický identifikátor, zdroje uložení) se generuje automaticky za Vás (bez ohledu na předchozí popsanou volbu "Přiřazovat identifikátory automaticky").
- Zobrazit vše - tato akce zapne všechny filtry popsané výše v sekcích Filtr témat a Filtr identifikátorů
- Přiřadit identifikátory - tato akce hromadně přiřadí identifikátory a doplní definici kontextové nápovědy tam, kde není úplná. Na nesrovnalosti v definici budete také upozorněni vždy při zavření stránky editoru kontextové 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)
- 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 (označované jako TEXT POPUPS). 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.