Viz: Objekt
PmaDataTable
Nad hodnotami objektu
PmaDataTable lze provádět různé operace. Například:
- Nabízení hodnot (pro čtení i zápis) do
Webu pomocí formátu
XML. Z hlediska licence je klient požadující data z této Web komponenty typu
PmDataClient.
- Třídění řádků metodou
Sort.
- atd.
Objekt PmaDataTable lze použít různými způsoby:
Lze například definovat sloupce ve vývojovém prostředí (viz karta "
Sloupce"), definovat kolik řádků má mít tabulka (viz karta "
DataTable") a pak ve spuštěné aplikaci pouze číst a zapisovat hodnoty (viz metody
GetCellValue a
SetCellValue) z této tabulky.
Lze také nedefinovat ani sloupce ani řádky a ve spuštěné aplikaci je dynamicky vytvářet a mazat (viz metody
InsertRow,
RemoveRow,
InsertCol,
RemoveCol). Přidávání a mazání sloupců je však omezeno tím, že se přitom smažou i všechny řádky tabulky.
Lze i ve vývojovém prostředí definovat sloupce i řádky a pak je dynamicky měnit.
Maximální počet řádků závisí na
Runtime licence PROMOTIC a je:
PmRtProf: 65535,
PmRtFree: 30 a
PmRtXX: XX (například
PmRt100: 100).
Maximální počet sloupců závisí na
Runtime licence PROMOTIC a je:
PmRtProf: 65535,
PmRtFree: 30 a
PmRtXX: XX (například
PmRt100: 100).
Sloupce "Jen pro čtení" (ReadOnly):
Každá buňka tabulky se standardně přidává do výpočtu velikosti aplikace z důvodu licencování. Pokud se však v objektu
PmaDataTable označí sloupec jako
"Jen pro čtení", pak buňky v tomto sloupci se nebudou započítavat do výsledné velikosti aplikace. To umožňuje i v aplikacích s menším počtem bodů tento objekt používat pro ukládání konfiguračních hodnot, které se po celou dobu běhu aplikace nemění. Je to zajištěno tak, že do sloupců "Jen pro čtení" lze zapsat hodnotu pouze jednou. Omezení u jednotlivých metod objektu
PmaDataTable z důvodu sloupců "Jen pro čtení" jsou uvedena v poznámce této metody.
Každá buňka je na začátku prázdná. Za prázdnou se považuje i buňka která obsahuje číselnou hodnotu
0 nebo prázdný řetězec
"". Do takové buňky lze zapsat novou hodnotu. Po zápisu neprázdné nenulové hodnoty ve sloupci "Jen pro čtení" dochází k "zamčení buňky". "Zamčená buňka" se stane konstantou, nelze už do ní psát. Do ostatních "nezamčených" buňek však lze dále psát. U metod, které zapisují do více buňek současně, se zapíše pouze do "nezamčených buňek", obsah "zamčených buňek" zůstane beze změny.
Pokud je v kterémkoliv sloupci "Jen pro čtení" zamčena alespoň jedna buňka zapisem neprázdné hodnoty, pak dochází k "zamčení struktury" celé tabulky. Nelze dále přidávat a rušit sloupce nebo řádky, měnit strukturu tabulky. Strukturu, rozměry tabulky je proto nutno měnit před zápisem první neprázdné hodnoty do sloupce "Jen pro čtení".
Zobrazování dat v obrazu:
Na hodnoty tabulky se lze napojit přímo v
Pmg objektech datovou vazbou "
PP - Vlastnost Pma objektu". V zadavateli
vlastnost objektu v této vazbě se musí ručně zadat:
Item(row,col), kde
row a
col jsou indexy požadovaného řádku a sloupce.
Pro zobrazování celé tabulky viz příklady: