| aOptions | (Array) 2-rozměrné pole s volbami, kde řádky představují jednotlivé volby a sloupce představují položky volby. Viz (Col,Row) - 2-rozměrné pole s významem pole řádků.
První sloupec (indexováno od 0) není nabídkou zobrazen (je neviditelný) a obsahuje identifikátory jednotlivých voleb. Další sloupce jsou již v nabídce zobrazeny. Nabídka je zobrazena v tabulkové podobě a má o jeden sloupec méně, než dodané 2-rozměrné pole.
První řádek může (ale nemusí) obsahovat záhlaví s nadpisy sloupců (lokalizované uživatelské názvy) v nabídce. Pokud první řádek má obsahovat záhlaví, pak v prvním sloupci (neviditelný, vyhrazený pro identifikátory) musí být uveden řetězec s hodnotou $title. |
|---|---|
| vSelected | (Variant) Identifikátor volby, která bude vybrána při počátečním zobrazení.
Hodnota null pro JavaScript nebo Empty pro VBScript znamená, že při počátečním zobrazení nemá být vybrána žádna volba.
Hodnota typu String představuje identifikátor volby, která bude vybrána při počátečním zobrazení. Pokud taková volba v nabídce není (např. prázdný řetězec "" nebo neexistující identifikátor), pak nebude při počátečním zobrazení vybrána žádna volba. |
| sDlgTitle | (String) Nadpis zadávacího okna. Pro zadání lze použít Makro výraz ($.text ..) (vyhodnocuje se při volání metody). |
| sStyle | (String) Dodatečné parametry pro zobrazení okna s nabídkou. Údaje jsou zde ve formátu KeyVal, například "ontop:1;grid:1;size:350,250;".
Výchozí hodnota je "ontop:0;grid:0;". ontop:nn (nepovinné) - Určuje, zda okno bude "Vždy nahoře".
0 (přednastaveno) - Okno nebude "Vždy nahoře".
1 - Okno bude "Vždy nahoře". grid:nn (nepovinné) - Určuje, zda buňky zobrazené tabulky budou s ohraničením.
0 (přednastaveno) - nebudou s ohraničením.
1 - budou s ohraničením. size:dx,dy (nepovinné) - Rozměry okna (v pixelech).
autoselect:nn (nepovinné) - Umožňuje režim, kdy se nečeká na výběr uživatelem v těch případech, kdy to není nutné. Nedojde tak ani k zobrazení okna.
0 (přednastaveno) - okno bude zobrazeno vždy.
1 - Okno bude zobrazeno pouze pokud jsou k zobrazení alespoň dvě volby.
Pokud je k dispozici pouze jediná volba, pak je tato automaticky zvolena a metoda vrací hodnotu typu String (identifikátor vybrané volby).
Pokud není k dispozici žádná volba, pak metoda vrací: null pro JavaScript nebo Empty pro VBScript (lze testovat metodou Pm.IsValid). |
| oExtra | [nepovinné] (Object) Dodatečný údaj v podobě objektu PmMap.
Pokud je údaj zadán (doporučeno), pak se metoda volá asynchronně, v jiném případě se metoda volá synchronně (viz Synchronní nebo asynchronní volání). Objekt se vytvoří metodou Pm.CreatePmMap. Tento parametr má podobnou funkci jako parametr oExtra metody OpenView. oExtra.onClose (povinné) - (objekt typu PmAction) Zadává se zde metoda projektanta, která se volá, když se obraz zavře.
Objekt pro tuto vlastnost se vytvoří metodou Pm.CreatePmAction. Tato metoda projektanta musí mít dva parametry: - oSystem: Objekt typu PmMap. Vlastnosti tohoto objektu nastavuje systém podle toho odkud tuto akci volá. V tom případě systém nastaví vlastnosti:
- oPrivate: Objekt typu PmMap. Vlastnosti tohoto objektu nastavuje projektant v objektu PmAction.PrivateData. Projektant v tomto objektu nemusí nastavit žádnou vlastnost. Nastavením nějaké vlastnosti lze však dosáhnout například toho, že jedna metoda projektanta může sloužit více účelům a pouze podle hodnoty vlastnosti v PrivateData se v této metodě rozpozná, odkud se metoda volá. |
var oExtra = Pm.CreatePmMap();
oExtra.onClose = Pm.CreatePmAction(1, pMe, "ClosePanel");
var aOptions = Pm.FindViewers("groups:menu;viewers:panel;", "", "");
Pm.SelectionDialog(aOptions, "", "Obrazy", "size:400,300;", oExtra);
if ("ok" == oSystem.CloseReason)
{
pMe.PmPanel.OpenView(oSystem.ReturnValue, "", "");
}
var oExtra = Pm.CreatePmMap();
oExtra.onClose = Pm.CreatePmAction(1, pMe, "ClosePanel");
var aOptions = Pm.FindViewers("groups:menu;viewers:alarm_state;", "", "columns:path,title,alstate3,alstate2,alstate1,alhoot;");
Pm.SelectionDialog(aOptions, "", "Alarmy", "size:400,300;", oExtra);
Dim aOptions
aOptions = Pm.FindViewers("groups:menu;viewers:panel;", "", "")
Dim sViewer
sViewer = Pm.SelectionDialog(aOptions, "", "Obrazy", "size:400,300;")
If Pm.IsValid(sViewer) Then
pMe.PmPanel.OpenView sViewer, "", ""
End If
var sId;
var oExtra = Pm.CreatePmMap();
oExtra.onClose = Pm.CreatePmAction(1, pMe, "ClosePanel");
var aOptions = Pm.CreatePmArray().Create(3,4);
aOptions.SetItem("$title", 0, 0);
aOptions.SetItem("Název", 1, 0);
aOptions.SetItem("Popis", 2, 0);
aOptions.SetItem("id0", 0, 1);
aOptions.SetItem("T1", 1, 1);
aOptions.SetItem("Teplota 1", 2, 1);
aOptions.SetItem("id1", 0, 2);
aOptions.SetItem("T2", 1, 2);
aOptions.SetItem("Teplota 2", 2, 2);
aOptions.SetItem("id2", 0, 3);
aOptions.SetItem("T3", 1, 3);
aOptions.SetItem("Teplota 3", 2, 3);
sId = Pm.SelectionDialog(aOptions, "id1", "Výběr teploty", "ontop:1;grid:1;size:350,250;", oExtra);
if ("ok" == oSystem.CloseReason)
{
Pm.MessageBox("Nadpis", oSystem.ReturnValue);
}