Editorial - Vitajte na stránkach www.einsty.hostujem.sk

P R O G R A M U J E M ENa záver tejto èasti ešte spomeniem spôsob, akým program Help Workshop pristupu−je k vzniknutým chybám. Ak program narazí na chybu, jeho logika mu prikáe zobrazisprávu s èíslom a opisom vzniknutej chyby. Všetky chyby majú jednotný zápis v tvareHCxxxx, kde kombinácia xxxx predstavuje èíslo chyby. Program rozpoznáva tri druhy chy−bových správ, ktorých charakteristika je uvedená v tabu¾ke è. 2.Tabu¾ka è. 2Chybová správaNote (Poznámka)Warning (Varovanie)Error (Chyba)CharakteristikaProgram generuje správu s poznámkou v prípade, e sa vyskytne chyba malého významu,ktorá zásadne neovplyvní funkènos systému nápovede. Napr. HC1003: Note: A paragraphmark is formatted as a hidden character.Varovanie sa objaví pri závanejšej chybe. Napr. HC3003: Warning: The macro name [ ] isinvalid.Správa s chybou je generovaná vtedy, ak sa v nápovednom systéme vyskytne takázávaná chyba, e znemoní uskutoènenie plánovanej operácie (napr. zabráni vytvoreniusúboru). Napr. HC5005: Error: The file cannot be found.Pokia¾ program Help Workshop vypíše pri kompilácii súboru s nápoveïou správu s chy−bou, ktorej nebudete rozumie, zadajte èíslo chyby (napr. HC1003) do registra nápovedeprogramu a dozviete sa podrobnejšie informácie o danej chybe.5. FÁZA: FINÁLNA KOMPRESIA A KOMPILÁCIA SYSTÉMU NÁPOVEDE.Poslednou fázou je kompresia a kompilácia výsledného súboru nápovede. Uskutoèneniekompilácie je ve¾mi jednoduché, napokon treba aktivova iba jedno tlaèidlo a programHelp Workshop sa sám postará o všetko ostatné. Rád by som sa však na chví¾u zastavilpráve pri kompresii súboru nápovede. V procese kompresie sú na súbor aplikované opti−malizaèné mechanizmy, ktoré zabezpeèia minimalizáciu jeho ve¾kosti. Help Workshopvám ponúka tri základné typy kompresie, ktoré môete urèi na záloke Compression poklepnutí na tlaèidlo Options. Charakteristiku jednotlivých typov prezentuje tabu¾ka è. 3.Predpokladajme, e máme k dispozícii projektový súbor nápovede (.HPJ) a všetky ostat−né potrebné súèasti, ktoré sa pokúsime komprimova pomocou jednotlivých kompresnýchmetód a namerané výsledky porovnáme (pre lepšie porovnanie je uvedená i ve¾kosnekomprimovaného výsledného súboru s nápoveïou). Viac informácií poskytuje tabu¾kaè. 4 a obr. 6.Tabu¾ka è. 3Metóda kompresieMaximálna kompresiaKompresia HallKompresia ZeckTabu¾ka è. 4Metóda kompresieiadna kompresiaMaximálna kompresiaKompresia HallKompresia ZeckCharakteristikaTáto metóda kompresie je odporúèaná pre väèšinu súborov s nápoveïou. Predstavujekombináciu kompresných metód Hall a Zeck.Túto kompresnú metódu môete poui vtedy, ak viete, e nápovedný súbor budepo kompilácii komprimovaný ešte ïalším programom (napr. aplikáciou WinRAR).Pod¾a oficiálnych informácií je moné poui túto kompresnú metódu, ak chcetekompilova rýchlo a s minimálnou kompresiou. Dovolím si však podotknú, e nie vdytoto tvrdenie platí (pozri nasledujúci príklad).Ve¾kos súboru s nápoveïou540 KB134 KB138 KB133 KBPo vykonaných testoch môem vyhlási, e všetky tri metódy komprimujú súbor snápoveïou ve¾mi dobre (kompresný pomer je pribline 4:1). Pre podstatnú väèšinu súbo−rov môete s pokojným svedomím zvoli maximálnu kompresiu (teda kombináciu kom−presných metód Hall a Zeck). Pokia¾ však chcete dosiahnu èo najlepšie kompresné výsled−ky, bude vhodné, keï budete s jednotlivými kompresnými metódami experimentova a nazáklade empirických pokusov zvolíte tú, ktorá vám najviac vyhovuje. V koneènom dôsled−ku je pomerne ako predvídate¾né, ako sa bude tá−ktorá kompresná metóda správa prikompresii práve vášho súboru s nápoveïou (kompresný pomer závisí od mnohých fakto−rov, napr. od typu, ve¾kosti a mnostva pouitých grafických elementov a pod.).Teším sa na stretnutie pri ïalšej èasti seriálu.Ján HanákAssembler pod Windows25. èas: Systémové informácie IIV predchádzajúcej èasti sme preberali funkcie API na získavanie informácií zo systému.Tentoraz sa pozrieme, aké funkcie API máme k dispozícii na nastavovanie systémovýchinformácií. Praktický príklad opä nájdete na www.pcrevue.sk v sekcii Programujeme –Assembler pod Windows.GetTimeZoneInformationWindows NT Win 95 Win32s Lib IncludeÁno Áno Áno kernel32.lib kernel32.incFunkcia GetTimeZoneInformation vráti štruktúru TIME_ZONE_INFORMATION, ktorá opi−suje èasovú zónu. Obsahuje dve štruktúry SYSTEMTIME, ktoré urèujú zaèiatok a koniecletného èasu, ako aj rôzne pravidlá pre prevod systémového na lokálny èas.Syntax: DWORD GetTimeZoneInformation, LPTIME_ZONE_INFORMATIONlpTimeZoneInformationLPTIME_ZONE_INFORMATION lpTimeZoneInformation: Ukazovate¾ na štruktúru LPTI−ME_ZONE_INFORMATION, do ktorej sa uloia dáta o špecifikovanej èasovej zóne. Štruk−túra má tvar:TIME_ZONE_INFORMATION STRUCTBias DWORD ?StandardName WORD 32 dup(?)StandardDate SYSTEMTIME StandardBias DWORD ?DaylightName WORD 32 dup(?)DaylightDate SYSTEMTIME DaylightBias DWORD ?TIME_ZONE_INFORMATION ENDSBias – prispôsobenie na greenwichský èas UTC (Universal Time Coordination) v minútachStandardName – meno èasovej zónyStandardDate – svetový dátum a èas, keï sa letný èas mení na štandardný èas; ak nie jeletný èas, nastavte prvok wMonth na nuluStandardBias – štandardné prispôsobenie minúty na prevod na štandardný èas;obyèajne nulaDaylightName – meno letného èasu pre túto zónuDaylightDate – dátum a èas UTC (Universal Time Coordination), keï sa štandardný èasmení na letný èas; ak nie je letný èas, nastavte prvok wMonth na nuluDaylightBias – poèet minút, ktoré sa pridajú poèas letného èasuVýsledok funkcie: DWORD: Ak sa funkcia skonèila úspešne, vráti jednu z nasledujúcichhodnôt: TIME_ZONE_ID_UNKNOWN – Windows nemôu nájs aktuálnu èasovú zónu.Toto sa môe objavi, pokia¾ je volaná funkcia SetTimeZoneInformation a štruktúraTIME_ZONE_INFORMATION neobsahuje príslušné dáta. TIME_ZONE_ID_STANDARD –táto hodnota znamená, e Windows našli èasovú zónu, ktorá je v rozsahu štandard−ného èasu. TIME_ZONE_ID_DAYLIGHT – indikuje, e Windows zistili èasovú zónu, ktoráje v rozsahu letného èasu. Ak je vrátená hodnota 0xFFFFFFFF, pouite funkciuGetLastError, aby ste zistili príèinu chyby.GetUserDefaultLangIDWindows NT Win 95 Win32s Lib IncludeÁno Áno Áno kernel32.lib kernel32.incFunkcia GetUserDefaultLangID vráti identifikátor jazyka (LANGID) implicitnej lokalizáciepouívate¾a.Syntax: LANGID GetUserDefaultLangIDTáto funkcia nemá iadne parametre.Výsledok funkcie: LANGID: Ak sa funkcia skonèila úspešne, vráti ID jazyka implicitnejlokalizácie pouívate¾a.GetUserDefaultLCIDWindows NT Win 95 Win32s Lib IncludeÁno Áno Áno kernel32.lib kernel32.incFunkcia GetUserDefaultLCID vráti identifikátor lokalizácie (LCID) implicitnej lokalizáciepouívate¾a. Je to aktuálna lokalizácia okrem lokalizácie threadu, ktorá je nastavená vola−ním funkcie SetThreadLocale.Syntax: LCID GetUserDefaultLCIDTáto funkcia nemá iadne parametre.Výsledok funkcie: LCID: Ak sa funkcia skonèila úspešne, vráti ID lokalizácie implicitnejlokalizácie pouívate¾a.GetVersionWindows NT Win 95 Win32s Lib IncludeÁno Áno Áno kernel32.lib kernel32.inc118 PC REVUE 1/2003