CreateItem - metoda objektu PmfLayout

Popis:

Vytvoří jednu podpoložku formuláře v oblasti vymezené rodičovským objektem PmfLayout.

Syntaxe:

Object CreateItem(String sType, [String sId], [String sTitle], [String sProps], [String sPars])

Parametry:

sType	(String) Typ Pmf objektu. Podle tohoto typu se vytvoří příslušný objekt. Tato hodnota lze později zjistit pomocí vlastnosti PmfObject.Type. "string" - Vytvoří objekt PmfString = Zadavatel textu "number" - Vytvoří objekt PmfNumber = Zadavatel celého nebo reálného čísla "bool" - Vytvoří objekt PmfBool = Zadavatel boolean hodnoty (Checkbox) "enum" - Vytvoří objekt PmfEnum = Výběr jeden z několika (Combobox) "button" - Vytvoří objekt PmfButton = Tlačítko "layout" - Vytvoří objekt PmfLayout = Oblast pro jiné Pmf objekty "separ" - Vytvoří objekt PmfSepar = Oddělovač mezi konfigurátory "table" - Vytvoří objekt PmfTable = Tabulka "tree" - Vytvoří objekt PmfTree = Strom "auto" - Typ objektu se určí automaticky podle informací zadaných v parametru sProps. V KeyVal řetězci se nejprve hledá klíč Type, jehož hodnoty jsou stejné jako hodnoty parametru sType a přimo určují typ objektu. Pokud klíč Type není nalezen, pak se hledá klíč Format a typ a podtyp objektu se určí podle typu formátu. Pokud je formát typu Enum a formátovací řetězec obsahuje tabulku řádků Rows:{keyval}, pak se vytvoří objekt PmfEnum a zároveň se naplní všemi řádky uvedenými v tabulce.
sId	[nepovinné] (String) Identifikátor Pmf objektu. Identifikátor lze použít například pro získání Pmf objektu metodou GetItem nebo pro testování v události oExtra.onChange. Pokud identifikátor není zadán nebo má hodnotu null, pak se nelze na tento objekt odkazovat. Tato hodnota lze později zjistit pomocí vlastnosti PmfObject.Id.
sTitle	[nepovinné] (String) Zobrazovaný název Pmf objektu. Název se standardně zobrazuje vlevo od konfigurátoru. Pokud je potřeba, pak systém k tomuto názvu přidá znak "dvojtečka". Pokud název je prázdný řetězec, pak se nezobrazuje, ale vyčlení se pro něj prostor (vlastnost TitlePos se nezmění). Pokud název není zadán nebo má hodnotu null, pak se nezobrazuje a nevyčlení se pro něj oblast (současně vlastnost TitlePos se nastaví na "no"). Tato hodnota lze později zjistit nebo změnit pomocí vlastnosti PmfObject.Title.
sProps	[nepovinné] (String) Počáteční hodnoty vlastností vytvářeného objektu. Tvar tohoto parametru je "NázevVlastnosti:Hodnota;...". Údaje jsou zde ve formátu KeyVal. Například při vytváření objektu PmfNumber lze zadat: "Min:0;Max:100;"
sPars	[nepovinné] (String) Parametry vytvářeného Pmf objektu. Určují kde bude objekt vytvořen. "parent:$sys;pos:after=xy". Údaje jsou zde ve formátu KeyVal. parent:id - Určuje, v kterém objektu PmfLayout bude objekt vytvořen. Výchozí hodnota je $main. pos:before=id - Objekt vytvořit před již dříve vytvořený objekt s identifikátorem id. pos:after=id - Objekt vytvořit za již dříve vytvořený objekt s identifikátorem id. pos:first - Objekt zařadit jako první. pos:last (přednastaveno) - Objekt zařadit jako poslední.

Poznámka:

Tato metoda je funkční i ve Web obrazech.

Viz také:

- PmfLayout.GetItem (metoda)

Příklad1:

JavaScriptVyber a zkopíruj do schránky



var oLayout = oForm.CreateItem("layout", "Lay1", null, "Subtype:horz;");

var oString = oLayout.CreateItem("string", "IdStr", "Řetězec", "Value:text;");

var oInt = oLayout.CreateItem("auto", "IdInt", "Celé číslo", "Type:number;Value:24;");

var oFloat = oLayout.CreateItem("auto", "IdFloat", "Reálné číslo", "Format:{Type:Float;DLen:3;};Value:14.85642;");

var oEnum = oLayout.CreateItem("auto", "IdEnum", "Barva", "Format:{Type:Enum;Rows:{0:{v:1;n:červená};1:{v:2;n:zelená};2:{v:3;n:modrá};};};");