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

Napíšte komentár