Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Objekt PmForm (Formulář)

Popis:
Objekt představuje formulář pro zadávání hodnot.
Vlastnosti a metody:
CreateItem Vytvoří jednu položku formuláře
GetItem Vrátí existující položku formuláře
Title Zobrazovaný název formuláře v záhlaví okna
BgColor Barva pozadí okna formuláře
SysButtons Volba systémových tlačítek
Close Zavře prohlížečku formuláře
Seznam podobjektů:
PmFormItemString Zadavatel textu
PmFormItemInt Zadavatel celého čísla (Integer)
PmFormItemFloat Zadavatel reálného čísla (Float)
PmFormItemBool Zadavatel boolean hodnoty (Checkbox)
PmFormItemEnum Výběr jeden z několika (Combobox)
PmFormItemButton Tlačítko
PmFormItemSepar Separátor (oddělovač) mezi konfigurátory
PmFormItem Formální objekt - rodič všech položek formuláře
Poznámka:
- Objekt lze vytvořit pomocí metody Pm.CreatePmForm.
- Tento objekt je funkční i pro Web Obrazy. Nefunguje však v prohlížeči InternetExplorer8 a nižší.
- Objekt lze používat v jazyce VBScript a JavaScript.
 
Objektem PmForm lze dynamicky (tzn. pomocí skriptu) vytvořit okno pro zadávání údajů (formulář). Každý "zadávaný údaj" zde představuje jednu položku formuláře.

Formulář lze vytvořit také objektem PmPanel ale objektem PmForm lze toto provést dynamicky a jednodušeji, protože položky formuláře se automaticky pozicují a roztahují tak jak je potřeba.

 
Postup vytvoření formuláře:
Vytvoření modálního okna pro zadávání údajů.
-----------
1. V jednom scriptu (např. při stisku tlačítka v události onButtonUp) se vytvoří, nastaví a otevře formulář:
Příklad pro jazyk JavaScript:
// Vytvoření objektu formuláře:
var oItem, oForm = Pm.CreatePmForm();
oForm.Title = "Zadavatel parametrů uskladnění balíků";
// Vytvoření položek formuláře:
oItem = oForm.CreateItem("int", "i1", "Počet balíků", "Min:0;Max:33;");
oItem.Value = 5;
oItem = oForm.CreateItem("bool", "b1", "Uskladnit");
oItem.Value = true;
oItem = oForm.CreateItem("string", "s1", "Popisek");
oItem.Value = "Balená voda";
oItem = oForm.CreateItem("enum", "e1", "Rychlost zpracování");
oItem.AddRow(0.5, "pomalu");
oItem.AddRow(9.9, "rychle");
oItem.Value = 0.5;
oItem = oForm.CreateItem("button", "reset", "Vynulovat");
// Otevření formuláře v modálním okně:
var oExtra = Pm.CreatePmMap();
oExtra.onChange = Pm.CreatePmAction(1, pMe, "FormChanged");
oExtra.onClose = Pm.CreatePmAction(1, pMe, "FormClosed");
-----------
2. Při zadávání hodnot do formuláře se při jakékoli změně vyvolá uživatelská metoda "FormChanged". Zde lze například zjistit, že došlo ke stisknutí tlačítka "Vynulovat" a provede se vynulování všech položek.

Tato uživatelská metoda se vytváří v záložce Metody a musí mít dva parametry: oSystem a oPrivate.

Příklad pro jazyk JavaScript:
{
  var oForm = oSystem.ViewObject;
  oForm.GetItem("i1").Value = 0;
  oForm.GetItem("b1").Value = false;
  oForm.GetItem("s1").Value = "";
  oForm.GetItem("e1").Value = 0.5;
}
-----------
3. Po zadání údajů a zavření okna se vyvolá uživatelská metoda "FormClosed", ve které lze zjistit všechny nastavené hodnoty.

Tato uživatelská metoda se vytváří v záložce Metody a musí mít dva parametry: oSystem a oPrivate.

Příklad pro jazyk JavaScript:
{
  var oForm = oSystem.ViewObject;
  var val1 = oForm.GetItem("i1").Value;
  var val2 = oForm.GetItem("b1").Value;
  var val3 = oForm.GetItem("s1").Value;
  var val4 = oForm.GetItem("e1").Value;
}
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice