Promotic
WikipediaLinkedInYoutubeTwitterFacebook

AddMenu - metoda objektu PmMenu

Popis:
Přidá jednu položku do menu.
Syntaxe:
Empty AddMenu(String sId, String sText, [String sOptions])
Volání:
pEvent.Menu.AddMenu sId, sText, sOptions
Parametry:
sId(String) Identifikátor položky menu.

Pomocí tohoto identifikátoru lze pak v události onMenuSelect zjistit, která položka menu byla vybrána.

Lze zadat prázdný řetězec (""), pokud tato položka není použita v události onMenuSelect (např. oddělovač nebo text, který neslouží pro výběr).

Na položky v podmenu se odkazuje složeným identifikátorem. Identifikátor se skládá z identifikátoru podmenu, oddělovače lomítko (/) a vlastního identifikátoru položky. Položky, které nejsou v podmenu, mají identifikátor jednoduchý bez lomítka.

sText(String) Zobrazovaný text položky menu. Pro zadání lze použít Makro výraz ($.text ..) (vyhodnocuje se při volání metody).
sOptions[nepovinné] (String) Dodatečné parametry přidávané položky. Údaje jsou zde ve formátu KeyVal, například "type:checkedtext;enabled:0;".
"type:sss;" (nepovinné) - Určuje typ přidávané položky.
type:text; (přednastaveno) - Přidávaná položka je text.
type:checkedtext; - Přidávaná položka je text, současně označený jako vybraný (zatržítko vlevo od textu).
type:separator; - Přidávaná položka je oddělovač, tzn. vytvoří se vodorovná čára. Parametr sText nemá význam.
type:menu; - Přidávaná položka je podmenu, tzn. vytvoří se text a značka pro podmenu. Podmenu má svůj identifikátor a položky v něm mají také své identifikátory. Vzniká složený identifikátor s oddělovačem lomítko (/).
"enabled:n;" (nepovinné) - Určuje, zda přidávaná položka je povolena nebo zakázana (1 = povoleno (přednastaveno), 0 = zakázáno).
Poznámka:
Tato vlastnost je funkční i ve Web obrazech. Zatím však není funkční type:checktext;.
Příklad:
Skript - událost onMenuFill: Vytvoří menu se 4 položkami první úrovně (START, STOP, PAUSE, Help) a podmenu se 2 položkami (Index, About).
JavaScriptVBScriptVyber a zkopíruj do schránky

pEvent.Menu.AddMenu("start", "START");
pEvent.Menu.AddMenu("stop", "STOP");
pEvent.Menu.AddMenu("pause", "PAUSE");
pEvent.Menu.AddMenu("", "", "type:separator;");
pEvent.Menu.AddMenu("help", "Help", "type:menu;");
pEvent.Menu.AddMenu("help/index", "Index");
pEvent.Menu.AddMenu("help/about", "About");
 
Skript - událost onMenuSelect: Provedení příslušné akce po aktivaci položky menu uživatelem.
JavaScriptVBScriptVyber a zkopíruj do schránky

switch (pEvent.Name)
{
case "start":
pMe.PmPanel.Methods.Start();
break;
case "stop":
pMe.PmPanel.Methods.Stop(1);
break;
case "pause":
pMe.PmPanel.Methods.Stop(0);
break;
case "help/index":
pMe.PmPanel.Methods.ShowHelpIndex();
break;
case "help/about":
pMe.PmPanel.Methods.ShowAboutDlg();
break;
}

Historie:
Pm8.03.24:
- Nyní lze vytvářet víceúrovňová menu - metodou AddMenu("id", "text", "type:menu;") lze nyní přidat podmenu.
Pm7.03.09: Vytvořeno
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice