Hlavní navigace

Knihovna ClanLib (21)

Petr Kavánek

V dalším pokračování povídání o multiplatformové knihovně ClanLib se po krátké přestávce opět vrátíme k tvorbě GUI. Zaměříme se na komponentu CL_Menu, která, jak ostatně už její název napovídá, slouží k tvorbě menu. Chybět nebude jednoduchý ukázkový program ani nějaké ty screeshoty ukazující, jak takové menu ve stříbrném stylu ClanLibu může vypadat.

CL_Menu

Asi nikoho z těch, kdo si přečetli předchozí díly věnované tvorbě GUI, nepřekvapí, že CL_Menu je potomkem třídy CL_Component.

Při tvorbě menu zatím není podporována žádná spolupráce s RDF resp. GDF soubory. To znamená, že všechny naše představy budeme muset napsat přímo do zdrojových kódů. Podle mého názoru to je trošku škoda, avšak odhaduji, že se jedná pouze o přechodný stav. Myslím, že se podpora GDF třídou CL_Menu objeví v některé z příštích verzí knihovny, a jestli ne, tak to je myslím docela zajímavý námět, na jehož realizaci bychom si mohli někdy v budoucnu demonstrovat tvorbu vlastní komponenty.

V tomto dílu si tedy popíšeme, jak vytvořit menu dosud podporovanými prostředky. Uvidíte, že to půjde i tak docela dobře.

Než se pustíme do dalšího povídání, můžete se podívat na ukázku z programu, který si můžete stáhnout na konci článku, chcete-li získat názornější představu o tom, o čem vlastně bude řeč:

Na menu se můžeme dívat jako na zakořeněný strom. To znamená, že se skládá z jednotlivých uzlů propojených cestami tak, že mezi každými dvěma uzly existuje právě jedna cesta. Jeden z uzlů nazýváme kořen. Uzly, ze kterých vychází pouze jedna cesta, nazýváme listy.

V takovémto případě je pak každý uzel jednoznačně určen cestou z kořene k sobě samému (z výše uvedeného plyne, že taková cesta je právě jedna). Pojmenujeme-li uzly jednoznačnými jmény (tj. žádné dva uzly nebudou mít stejné jméno), budeme pomocí těchto jmen schopni jednoznačně zadat cestu z kořene do daného uzlu. Takovým pojmenováním cesty z kořene do zvoleného uzlu může být řetězec skládající se ze jmen uzlů, které na této cestě postupně navštívíme, oddělených například znakem / (lomítko se pak pochopitelně nesmí vyskytovat ve jménech uzlů). Takovýto řetězec nejenže jednoznačně popisuje cestu, ale také jednoznačně určuje cílový uzel. Dokonce v něm můžeme vynechat i první část, tj. pojmenování kořenového uzle, které by se zbytečně vyskytovalo v každém takovém řetězci.

Podívejme se na následující obrázek, který snad pomůže vytvořit si názornější představu o právě popisovaném:


Obrázek totiž jednu takovou strukturu menu znázorňuje. Obdelníky představují listy, ostatní uzly jsou elipsy, spojovací čáry odpovídají cestám. Dvojice čísel oddělených čárkou v levé části každého uzlu představuje ono jednoznačné pojmenování všech uzlů sloužící k zápisu cest. Naopak písmena v pravé části uzlů jsou nejednoznačným pojmenováním a představují text, který uvidí uživatel jako popis daného uzlu. Vpravo nad několika uzly je také uvedena cesta z kořene do tohoto uzlu.

S ClanLibovským menu je to přesně takto. Každý uzel obsahuje jednak string, který říká, jak se tento uzel bude jmenovat, jednak string, který říká, jaký text uvidí uživatel. Asi nás tedy nepřekvapí, že metoda třídy CL_Menu sloužící k vytvoření uzlu (obvykle listu) vypadá takto:

CL_MenuNode *create_item( const std::string &path, const std::string &labels=std::string()); 

První parametr path představuje cestu k tomuto uzlu (jména uzlů na cestě ve směru od kořene oddělená lomítkem). Druhý parametr představuje texty zobrazované uživateli (také oddělené lomítkem) v pořadí odpovídajícím uzlům z path. Například je-li Menu objekt třídy CL_Menu, bude mít následující příkaz níže popsaný význam:

Menu.create_item("0/1/2", "Soubor/Nový/Textový dokument"); 

Vytvoříme uzel 0 (uživatelem viděný jako Soubor), který bude přímým poduzlem uzlu root menu, což je kořen (to pro nás může být jakési neviditelné individuum, o jehož existenci se nemusíme starat). Dále vytvoříme uzel 1 (uživatelem viděný pod názvem Nový) jako poduzel uzlu 0 a podobně uzel 2 (Textový dokument) jako poduzel uzlu 1. V tuto chvíli bude uzel 2 listem (CL_Menu to pozná tak, že tento uzel nemá žádné submenu) a jeho chovaní se bude odpovídajícím způsobem lišit.

Listy jsou vlastně tím podstatným, co uživatel potřebuje v menu nalézt, aby nějakým způsobem ovlivnil chování programu. Ostatní uzly slouží k vytvoření požadované hierarchie. List vytvořený takto metodou create_item() se bude chovat tak, že poté, co na něj klikneme, celé menu zmizí a my budeme schopni tuto událost odchytit.

Vraťme se však ještě k metodě create_item(). Jak vidíte, druhý parametr je nepovinný. Pokud ho nezadáme, bude se příkaz chovat tak, jako kdybychom zadali oba dva parametry shodné, tj. vlastně se za druhý parametr doplní parametr první a my se neupíšeme k smrti. Pouze je třeba dát si pozor na to, abychom se v pojmenování resp. v cestách nedopustili nejednoznačností. Ohlídat si to musíme sami, třída CL_Menu to nechává na nás.

Návratová hodnota create_item() je typu CL_MenuNode* a tentokrát ji ještě nebudeme potřebovat. CL_MenuNode je třída, která reprezentuje jeden konkrétní uzel menu (k jejímu podrobnému popisu se dostaneme někdy příště).

Metoda create_item() má sestřičku:

CL_MenuNode *create_toggle_item( const std::string &path, const std::string &labels=std::string()); 

Její funkčnost je obdobná až na to, že vytvořený list se bude chovat jako přepínač.

Podívejme se konečně na to, jaké má CL_Menu konstruktory:

CL_Menu(
    const CL_Point &pos,
    CL_Component *parent,
    CL_StyleManager *style = NULL,
    bool vertical=false);

CL_Menu(
    CL_Component *parent,
    CL_StyleManager *style = NULL,
    bool vertical=false);

CL_Menu(
    const CL_Rect &rect,
    CL_Component *parent,
    CL_StyleManager *style = NULL,
    bool vertical=false);

CL_Menu(
    CL_MenuNode *parent_node,
    CL_Component *parent,
    CL_StyleManager *style = NULL );

Parametr pos slouží k udání pozice levého horního rohu vytvářeného menu vzhledem ke komponentě (CL_Component), na niž odkazuje parametr parent (obvykle je rodičovskou komponentou menu okno, tj. CL_Window). Obdobný význam jako pos má i parametr rect, který však bere v úvahu nejen polohu, ale i rozměry. Pokud polohu nezadáme, bude to, jako bychom zadali CL_Point(0, 0). Nové menu můžeme dokonce přichytit k již existujícímu uzlu danému parametrem parent_node.

Na závěr se můžete podívat na kód, pomocí něhož jsme schopni vytvořit menu odpovídající výše uvedenému obrázku:

// vytvorime okno, do ktereho posleze umistime menu
OknoSMenu = new CL_Window(CL_Rect(0, 0, SirkaHlOkna, VyskaHlOkna), "Okno s menu", SpravceGUI);

// vytvorime menu
Menu = new CL_Menu(OknoSMenu->get_client_area());

// odpovida leve casti obrazku
Menu->create_toggle_item("0,1/0,2/0,4/0,7", "K/B/C/D");
Menu->create_item("0,1/0,2/0,5", "K/B/E");
Menu->create_item("0,1/0,2/0,6", "K/B/F");
Menu->create_item("0,1/0,3", "K/G");

// odpovida prave casti obrazku
Menu->create_item("1,1/1,2/1,8/1,11", "R/B/H/E");
Menu->create_toggle_item("1,1/1,2/1,8/1,12", "R/B/H/F");
Menu->create_item("1,1/1,3", "R/E");
Menu->create_item("1,1/1,2/1,9", "R/B/C");
Menu->create_item("1,1/1,4", "R/G");
Menu->create_item("1,1/1,5", "R/D");
Menu->create_item("1,1/1,6/1,10", "R/B/C");
Menu->create_item("1,1/1,7", "R/D"); 

Závěr

K tvorbě menu je toho ještě mnoho co povědět, a proto budeme v tomto tématu pokračovat i příště (a nejspíš nejen příště).

Zde si můžete stáhnout ukázkový příklad obsahující výše uvedený kód.

Našli jste v článku chybu?
120na80.cz: 5 nejčastějších mýtů o kondomech

5 nejčastějších mýtů o kondomech

Vitalia.cz: Taky věříte na pravidlo 5 sekund?

Taky věříte na pravidlo 5 sekund?

Podnikatel.cz: K EET. Štamgast už peníze na stole nenechá

K EET. Štamgast už peníze na stole nenechá

Vitalia.cz: Cena stejného léku se liší i o tisíce

Cena stejného léku se liší i o tisíce

Lupa.cz: Kdo pochopí vtip, může jít do ČT vyvíjet weby

Kdo pochopí vtip, může jít do ČT vyvíjet weby

Měšec.cz: Zdravotní a sociální pojištění 2017: Připlatíte

Zdravotní a sociální pojištění 2017: Připlatíte

Měšec.cz: Air Bank zruší TOP3 garanci a zdražuje kurzy

Air Bank zruší TOP3 garanci a zdražuje kurzy

Lupa.cz: Proč firmy málo chrání data? Chovají se logicky

Proč firmy málo chrání data? Chovají se logicky

Měšec.cz: Jak vymáhat výživné zadarmo?

Jak vymáhat výživné zadarmo?

DigiZone.cz: Rádio Šlágr má licenci pro digi vysílání

Rádio Šlágr má licenci pro digi vysílání

Měšec.cz: U levneELEKTRO.cz už reklamaci nevyřídíte

U levneELEKTRO.cz už reklamaci nevyřídíte

Vitalia.cz: Jmenuje se Janina a žije bez cukru

Jmenuje se Janina a žije bez cukru

Podnikatel.cz: Chaos u EET pokračuje. Jsou tu další návrhy

Chaos u EET pokračuje. Jsou tu další návrhy

120na80.cz: Pánové, pečujte o svoje přirození a prostatu

Pánové, pečujte o svoje přirození a prostatu

Vitalia.cz: 4 příčiny zápachu z úst a jak s ním zatočit

4 příčiny zápachu z úst a jak s ním zatočit

Vitalia.cz: Proč vás každý zubař posílá na dentální hygienu

Proč vás každý zubař posílá na dentální hygienu

Vitalia.cz: Spor o mortadelu: podle Lidlu falšovaná nebyla

Spor o mortadelu: podle Lidlu falšovaná nebyla

120na80.cz: Co všechno ovlivňuje ženskou plodnost?

Co všechno ovlivňuje ženskou plodnost?

Vitalia.cz: Když přijdete o oko, přijdete na rok o řidičák

Když přijdete o oko, přijdete na rok o řidičák

Vitalia.cz: Paštiky plné masa ho zatím neuživí

Paštiky plné masa ho zatím neuživí