Obr. 1111. Informace o tisku aktuálního tématu

 

9. Připojení nápovědného souboru do aplikace

Hotový nápovědný soubor je toeba poipojit k aplikaci, aby mohl být vyvolán po stisku klávasy F1 poi práci s touto aplikací. To je základní funkce nápovidného souboru. Poi tomto zpusobu poipojení je nápovidný soubor otevoen na tématu, které je oznaeeno jako hlavní téma (Contents).

Nikteré aplikace však dokáží obsluhovat nápovidný soubor na vyšší úrovni, obvykle takovou nápovidu oznaeujeme jako kontextovou nebo senzitivní. To znamená, že podle okolností, podle aktuálního objektu apod., je vyvoláno téma odpovídající této okolnosti.

Typickým poedstavitelem aplikací, které podporují kontextovou nápovidu, je databázový systém MS-Access. Proto si poipojení nápovidného souboru k aplikaci ukážeme na nim.

Aplikace vytvooené v systému MS-Access [1] obsahují objekty nikolika toíd. Z nich je možno poipojit nápovidný soubor pouze k objektum dvou toíd. Jsou to formuláoe a sestavy (Forms, Reports). Ty jsou také ureeny k prezentaci dat v aplikaci, objekty jiných toíd by uživateli nemily být poístupny (to se týká poedevším tabulek a dotazu typu Select). Poitom platí, že ke každému objektu z tichto toíd je možno poipojit samostatný nápovidný soubor. Naopak není možno k jednomu objektu poímo poipojit více než jeden nápovidný soubor.

 

9.1. Připojení nápovědného souboru k formuláři

Pokud otevoeme formuláo pro editaci a zobrazíme jeho vlastnosti (Properties), najdeme mezi nimi dvi, pro nás významné vlastnosti :

Help File - sem zapíšeme název nápovidného souboru pro tento formuláo. Pokud se nachází v pracovním adresáoi, pak postaeí jeho název. Pokud se nachází v jiném adresáoi, je toeba zapsat i cestu k souboru, a to bui celou, nebo vztaženou relativni k pracovnímu adresáoi.

Help Context Id - sem zapíšeme kontextové eíslo, které jsme poioadili v sekci [MAP] projektového souboru .HPJ kontextovému oetizci a jeho prostoednictvím tedy konkrétnímu tématu. Toto téma bude zobrazeno poi vyvolání nápovidného souboru u všech položek formuláoe, které nebudou mít vlastní nastavení. Jedná se tedy o obdobu hlavního tématu, tentokrát pro tento konkrétní formuláo.

Poznámka - u databáze MS-Access verze 2.0 jsou vlastnosti každého objektu rozděleny do několika skupin. Vlastnosti týkající se připojení nápovědného souboru patří do skupiny Other Properties, jak to vidíme na obr. 12.

 

Obr. 1212. Vlastnosti formuláoe pro poipojení nápovidného souboru

 

Kromi toho mužeme ve vlastnostech jednotlivých objektu formuláoe nastavit vlastnost :

Help Context Id - sem zapíšeme kontextové eíslo, které jsme poioadili v sekci [MAP] projektového souboru .HPJ kontextovému oetizci a jeho prostoednictvím tedy konkrétnímu tématu. Toto téma bude zobrazeno poi vyvolání nápovidného souboru (F1), pokud byl tento objekt aktivní.

 

Obr. 1313. Soueinnost nápovidného souboru s formuláoem

Tak lze zajistit, aby pro každý objekt bylo vyvoláno téma, které se ho týká. Samozoejmi tuto vlastnost mají pouze datové objekty jako Text Box, Combo Box, List Box, Check Box apod. Vyvolat nápovidu u popisu (Label) není možné. Objekty této toídy nemohou být aktivní (nelze do nich poesunout kurzor). Stejni tak nelze poioadit kontextové eíslo k objektum typu Subform, Subreport apod., nebo? rovniž jako celek nemohou být aktivní.

Na obr. 13 vidíme vyvolání nápovidného souboru s tématem, které bylo poipojeno ke konkrétnímu objektu toídy Combo Box.

Na obr. 13 vidíme, že formuláo má poioazeno také uživatelské menu. Jisti by bylo vhodné k nimu také poipojit nápovidný soubor a jednotlivá kontextová eísla. Bohužel to není možné. Pokud budeme pracovat s menu formuláoe a vyvoláme nápovidu (F1), bude zobrazen standardní nápovidný soubor MS-Accessu.

 

Obr. 1414. Soueinnost nápovidného souboru se sestavou

9.2. Připojení nápovědného souboru k sestavě

Pokud otevoeme sestavu pro editaci a zobrazíme její vlastnosti (Properties), najdeme mezi nimi dvi, pro nás významné vlastnosti :

Help File - sem zapíšeme název nápovidného souboru pro tuto setavu. Pokud se nachází v pracovním adresáoi, pak postaeí jeho název. Pokud se nachází v jiném adresáoi, je toeba zapsat i cestu k souboru, a to bui celou, nebo vztaženou relativni k pracovnímu adresáoi.

Help Context Id - sem zapíšeme kontextové eíslo, které jsme poioadili v sekci [MAP] projektového souboru .HPJ kontextovému oetizci a jeho prostoednictvím tedy konkrétnímu tématu. Toto téma bude zobrazeno poi vyvolání nápovidného souboru, pokud zobrazíme sestavu pomocí Print Preview.

Na obr. 14 vidíme vyvolání nápovidného souboru s ureeným tématem poi pohledu na sestavu. I zde vidíme poipojené uživatelské menu sestavy. Opit platí, že poi práce s menu je vyvolán standardní nápovidný soubor MS-Accessu.

9.3. Volání nápovědného souboru z programu

Pokud chceme využít nápovidný soubor v programové aplikaci (vytvooené v Turbo Pascalu pro Windows nebo Borland C++ pro Windows apod.), pak musíme použít DLL funkci. Její použití v jednotlivých programovacích jazycích je ponikud odlišné, dále uvádíme její popis pro Turbo Pascal for Windows :

WinHelp (Wnd : HWnd; HelpFile : PChar; Command : Word; Data : Longint) : Boolean;

Význam jednotlivých parametru :

Wnd - identifikátor okna Windows, ze kterého je nápovidný soubor otevírán,

HelpFile - název a cesta k nápovidnému souboru,

Command - jedna z konstant definujících požadovanou einnost :

help_Context - otevoení nápovidného souboru na tématu specifikovaném kontextovým eíslem (poioazeným v sekci [MAP] projektového souboru .HPJ) v parametu Data,

help_HelpOnHelp - otevoení nápovidného souboru k nápovidnému souboru,

help_Index - otevoení nápovidného souboru a zobrazení hlavního tématu (Contents),

help_Key - otevoení nápovidného souboru na tématu specifikovaném klíeovým slovem v parametru Data, pokud se klíeové slovo vyskytuje u více témat, je zobrazen dialogový box Seach,

Help_MultiKey - otevoení nápovidného souboru pomocí klíeového slova z tabulky dodateených klíeových slov ureené nastavením MULTIKEY ze sekce [OPTION] projektového souboru .HPJ,

help_Quit - uzavoení okna s nápovidným souborem,

help_SetIndex - ureení, který nápovidný soubor a jeho téma specifikované kontextovým eíslem v parametru Data má být otevoen po stisku klávesy F1,

Data - kontextové eíslo specifikující požadované téma nebo klíeové slovo specifikující požadované téma (v závislosti na poíkaze v položce Command).

 

Návratová hodnota funkce :

jiná než nula - funkce probihla bez závad (hodnota True je kódována hodnotou -1),

0 - funkce hlásí chybu (hodnota False je kódována hodnotou 0).

 

 

 

10. Literatura

 

 

[1] Farana, R. - Vojáeek, M. : Databázové systémy. Microsoft Access 1.10. Ostrava, KAKI 1994.1

[2] Help Compiler Guide. Microsoft Corporation 1993.

[3] Microsoft Access. Developer's Toolkit. Microsoft Corporation 1994.

[4] Víteeková, M. - Vojáeek, M. - Farana, R. : Aplikace poeítaeu v oízení. Zpracování textu na poeítaei. Ostrava, KAKI 1995.

[5] Vojáeek, M. - Farana, R. : Aplikace poeítaeu v oízení. Zpracování dat na poeítaei. Ostrava, KAKI 1995.

11. Rejstřík

A

About, 37

Access, 5; 23; 38

aplikace, 38

externí, 16

atribut

okna, 24

B

Back, 36

bitová mapa, 6; 13; 23

BookMark, 10

box

dialogový, 14

výbirový, 10

Browse Buttons, 9; 10; 37

C

cesta

k souboru, 14

Contents, 35; 38

Č

einnost

Jump, 14

Macro, 14

Pop-up, 14

eíslo

kontextové, 23; 38; 40

D

definiení text, 5; 12

dialogový box, 14

DLL

funkce, 16

knihovna, 16

dotaz

Select, 38

E

editor

horkých ploch, 14

externí

aplikace, 16

F

Field Code, 14

Footnote, 9

formuláo, 38

menu, 40

objekt, 39

vlastnost, 38

funkce DLL, 16

G

grafické

reference, 13

grafický objekt, 13

H

hidden text, 5

History, 36

hlavní téma, 21; 35; 38

horká plocha, 6; 14; 34

editor, 14

hypergrafika, 14

I

identifikátor

tématu, 9

informace

relaení, 6

J

jméno

souboru, 14

K

klíeové slovo, 6; 9; 10; 36

kód pole, 14

konec

tvrdý, 9

kontextová

nápovida, 23; 38

kontextové

eíslo, 23; 38; 40

kontextový

oetizec, 9; 12; 14; 38; 40

L

List box, 10

M

makro, 16

nápovidné, 6; 16

pravidla, 16

seznam, 16

mapa

bitová, 6; 13; 23

menu, 8; 15

uživatelské, 40

N

nadpis, 9

tématu, 9

nápovida

kontextová, 23; 38

senzitivní, 23; 38

vytvooení, 24

vyvolání, 23; 38

nápovidné

makro, 6; 16

okno, 9

nápovidný

poekladae, 6

soubor, 5; 6; 35

systém, 5

návaznost eástí, 7

neviditelný text, 10; 12

O

objekt

datový, 40

dotaz, 38

formuláo, 38; 39

grafický, 13

sestava, 38

tabulka, 38

toída, 38

uživatelský, 24

vlastní, 24

vlastnost, 38

obrázek, 13; 34

obslužné tlaeítko, 8; 15

okénko

vyskakovací, 5; 12

okno

atributy, 24

nápovidné, 9

sekundární, 6

vyskakovací, 6

P

plocha

horká, 6; 14; 34

nerolovací, 9

poeklad, 11

poekladae

nápovidný, 6

poíkaz, 13

poíklad, 25

poíznaky

tvooící, 11; 23

postup práce, 7

poznámka, 9

pravítko

rolovací, 9

Print, 37

Print Preview, 40

prohlížecí sekvence, 9; 10; 37

projektový

soubor, 10; 21; 25

R

reference

grafické, 13

Rich Text Format, 6

rolovací

pravítko, 9

RTF, 6

Ř

oetizec

alias, 23

kontextový, 9; 12; 14; 38; 40

oídicí znak, 9

S

Search, 10; 35

sekce, 21

sekvence

prohlížecí, 9; 10; 37

témat, 10

senzitivní

nápovida, 23; 38

vyhledávání, 8

sestava, 38; 40

menu, 40

vlastnost, 40

zobrazení, 40

skokový text, 5; 11

slovo

klíeové, 6; 9; 10; 36

soubor

cesta, 14

jméno, 14

nápovidný, 5; 6; 7; 8; 35

projektový, 10; 21; 25

zdrojový, 6; 9; 25

systém

nápovidný, 5

T

tabulka, 38

téma, 5; 6; 8; 9; 40

hlavní, 21; 35; 38

identifikátor, 9

klíeové slovo, 10

kontextový oetizec, 9

nadpis, 9

sekvence, 10

titulek, 9; 10

text

definiení, 5; 12

hidden, 5

neviditelný, 5; 10; 12

skokový, 5; 11

skrytý, 5

zdrojový, 8

titulek, 9; 10

tlaeítko

About, 37

Back, 36

Contents, 35

History, 36

obslužné, 8; 15

Print, 37

Search, 35

v textu, 15

tvooící poíznaky, 11; 23

tvrdý konec, 9

U

uživatelský objekt, 24

V

vyhledávání, 10

senzitivní, 8

vyskakovací

okénko, 12

vytvooení

nápovidy, 24

vyvolání

nápovidy, 23; 38

W

Windows, 5

WINHELP, 5; 35

Z

zdrojový

soubor, 6; 9; 25

znak

oídicí, 9

 

Název

 

Autooi

 

Lektoroval

Vydání

Stran

Obrázku

Náklad

Vyšlo

Vydavatel

Aplikace poeítaeu v oízení

Tvorba nápovidných souboru

Ing. Radim Farana, CSc.

Vladimír Satek

Prof. Ing. Antonín Víteeek, CSc.

první

46

14

50

leden 1995

Slezskomoravský svaz VTSaP

poboeka e. 159

Komitét aplikované kybernetiky a informatiky,

Katedra automatizaení techniky a oízení

VŠB - Technická univerzita

to. 17. listopadu 15

Ostrava - Poruba, 708 33

Tato publikace neprošla jazykovou úpravou

 

 

 

 

ISBN 80-02-01037-X