InsertCol - metoda objektu PmaDataTable
Popis:
Metoda vloží jeden nový sloupec na zadanou pozici. Existující sloupce za touto pozicí se posunou. Odstraní se však všechny řádky tabulky !
Syntaxe:
Long InsertCol(Long Col, String Name, Long Dt)
Parametry:
Col | (Long) Pokud hodnota tohoto parametru je číslo >=0, pak je to index sloupce (indexováno od 0) na který se má nový sloupec vložit.
Hodnota -2 znamená vložení nového sloupce na konec tabulky. |
Name | (String) Název nového sloupce. Tento název nesmí mít již existující sloupce v této tabulce. |
Dt | (Long) Datový typ sloupce. Viz VBScript konstanty datových typů. |
---|
Vrácená hodnota:
Vrací index přidaného sloupce. Vrací záporné číslo pokud nastala chyba (sloupec se nevložil). Tehdy se chyba také zapíše do
INFO systému.
Poznámka:
Maximální počet sloupců závisí na
Runtime licence PROMOTIC a je:
PmRtProf: 65535,
PmRtFree: 30 a
PmRtXX: XX (například
PmRt100: 100).
Upozornění! Vkládat nový sloupec lze až za sloupec s datovým typem
Identifikátor (pokud je definován).
Sloupce "Jen pro čtení" (ReadOnly):
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í".
Příklad:
V objektu
/DataTable (typu
PmaDataTable) se vloží
1 nový sloupec na konec tabulky. sloupec bude mít název
"abc" a datový typ
Long:
JavaScriptVBScriptVyber a zkopíruj do schránky
var oDataTable = pMe.Pm("/DataTable");
oDataTable.InsertCol(-2, "abc", 3);
// 3=Long
Dim oDataTable
Set oDataTable = pMe.Pm("/DataTable")
oDataTable.InsertCol -2, "abc", 3
' 3=Long