CreateItem - metoda obiektu PmfLayout

Opis:

Wytworzy jeden podelement formularza w obszarze wydzielonym przez rodzicielski obiekt PmfLayout.

Składnia:

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

Parametry:

sType	(String) Typ Pmf obiektu. Na podstawie tego typu jest wytworzony wymagany obiekt. Wartość ta można później stwierdzić przy pomocy właściwości PmfObject.Type. "string" - Wytworzy obiekt PmfString = Wprowadzanie tekstu "number" - Wytworzy obiekt PmfNumber = Wprowadzanie liczby całkowitej lub rzeczywistej "bool" - Wytworzy obiekt PmfBool = Wprowadzanie wartości logicznej (Checkbox) "enum" - Wytworzy obiekt PmfEnum = Wybór jednego z kilku (Combobox) "button" - Wytworzy obiekt PmfButton = Przycisk "layout" - Wytworzy obiekt PmfLayout = Obszar dla innych Pmf obiektów "separ" - Wytworzy obiekt PmfSepar = Separator pomiędzy konfiguratorami "table" - Wytworzy obiekt PmfTable = Tabela "tree" - Wytworzy obiekt PmfTree = Drzewo "auto" - Typ obiektu zostanie automatycznie określony wg informacji określonych w parametrze sProps. W łańcuchu KeyVal najpierw wyszukiwany jest klucz Type, którego wartości są zgodne z wartościami parametru sType i bezpośrednio określają typ obiektu. Jeżeli klucz Type nie zostanie znaleziony, wtedy wyszukiwany jest klucz Format, a typ i podtyp obiektu są określane przez typ formatu. Jeżeli format jest typu Enum a łańcuch formatowania zawiera tabelę wierszy Rows:{keyval}, wtedy zostanie wytworzony obiekt PmfEnum i jednocześnie zostanie wypełniony wszystkimi wierszami zawartymi w tabeli.
sId	[opcjonalne] (String) Identyfikator Pmf obiektu. Identyfikator można zastosować na przykład do uzyskania Pmf obiektu przy pomocy metody GetItem lub w celu testowania w zdarzeniu oExtra.onChange. Jeżeli identyfikator nie został określony lub posiada wartość null, wtedy nie można się odwoływać do tego obiektu. Wartość ta można później stwierdzić przy pomocy właściwości PmfObject.Id.
sTitle	[opcjonalne] (String) Wyświetlana nazwa Pmf obiektu. Nazwa standardowo jest wyświetlana po lewej od konfiguratora. Jeżeli istnieje wymóg, wtedy system do tej nazwy doda znak "dwukropek". Jeżeli nazwa jest pusty łańcuch, wtedy nie zostanie wyświetlona ale zostanie wydzielony obszar dla niej (właściwość TitlePos nie zostanie zmieniona). Jeżeli nazwa nie została określona lub posiada wartość null, wtedy nie wyświetla się ale zostanie wydzielony obszar dla niej (równocześnie właściwość TitlePos zostanie ustawiona na "no"). Wartość ta można później stwierdzić lub zmienić przy pomocy właściwości PmfObject.Title.
sProps	[opcjonalne] (String) Wartości początkowe właściwości wytwarzanego obiektu. Składnia tego parametru jest "NazwaWłaściwości:Wartość;...". Dane są tutaj w formacie KeyVal. Na przykład podczas wytwarzania obiektu PmfNumber można wprowadzić: "Min:0;Max:100;"
sPars	[opcjonalne] (String) Parametry wytworzonego Pmf obiektu. Określają gdzie zostanie obiekt wytworzony. "parent:$sys;pos:after=xy". Dane są tutaj w formacie KeyVal. parent:id - Określa, w którym obiekcie PmfLayout zostanie obiekt wytworzony. Domyślną wartością jest $main. pos:before=id - Wytworzyć obiekt przed wcześniej wytworzony obiekt o identyfikatorze id. pos:after=id - Wytworzyć obiekt za wcześniej wytworzony obiekt o identyfikatorze id. pos:first - Ustawić obiekt jako pierwszy. pos:last (domyślnie) - Ustawić obiekt jako ostatni.

Notatka:

Metoda ta działa także w Web panelach.

Patrz również:

- PmfLayout.GetItem (metoda)

Przykład1:

JavaScriptWybierz oraz skopiuj do schowka



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

var oString = oLayout.CreateItem("string", "IdStr", "Łańcuch", "Value:tekst;");

var oInt = oLayout.CreateItem("auto", "IdInt", "Liczba całkowita", "Type:number;Value:24;");

var oFloat = oLayout.CreateItem("auto", "IdFloat", "Liczba rzeczywista", "Format:{Type:Float;DLen:3;};Value:14.85642;");

var oEnum = oLayout.CreateItem("auto", "IdEnum", "Kolor", "Format:{Type:Enum;Rows:{0:{v:1;n:czerwony};1:{v:2;n:zielony};2:{v:3;n:niebieski};};};");