Akcia GETROWDESC

Funkcia

Akcia zistí popis zadaného riadku alebo všetkých riadkov štruktúrovanej premennej.

Deklarácia

GETROWDESC structIdent, rowIdent, descIDent

Parametre

structIdent	in	Odkaz na objekt typu Štruktúrovaná premenná.
rowIdent	in	Parameter typu Int - číslo riadku, pre ktorý sa zisťuje popis.
descIDent	out	Lokálna premenná typu Text alebo odkaz na položku lokálnej štruktúrovanej premennej typu Text.

Popis

Ak parameter structIdent reprezentuje neexistujúci objekt alebo objekt, ktorý nie je typu Štruktúrovaná premenná, akcia generuje chybu ERR_OBJECT_NFOUND.

Ak je parameter rowIDent rôzny od nuly, akcia zistí popis daného riadku a vloží ho do parametra descIDent.
V prípade, že popis riadku nie je definovaný, alebo číslo riadku (parameter rowIDent) je väčšie ako počet riadkov štruktúrovanej premennej, parameter descIdent nadobudne neplatnú hodnotu.

Ak je parameter rowIdent rovný 0, akcia zistí popisy všetkých riadkov danej štruktúrovanej premennej. Potom parameter descIdent ,musí byť odkaz na položku typu Text lokálnej premennej. Akcia túto lokálnu premennú predimenzuje na potrebnú veľkosť (veľkosť je daná počtom riadkov štruktúry structIdent) a jednotlivé položky v stĺpci naplní príslušným popisom. Pre riadky, ktoré nemajú definovaný popis, vráti neplatnú hodnotu.

Príklad

 RECORD (SD.RecordDef) _desc
 
 ; Získanie popisu prvého riadku štruktúrovanej premennej SV.Struktura
 GETROWDESC SV.Struktura, 1, _desc^Text
 
 ; Získanie popisu všetkych riadkov štrúkturovanej premennej SV.Struktura
 GETROWDESC SV.Struktura, 0, _desc^Text
 ; akcia interne vykoná REDIM desc[SV.Struktura\DIM]

Súvisiace stránky:

Akcie v skriptoch