Control Object Properties
Loading/Accessing by Row Grid
   
Description The following properties are used to load and access a grid by row:

'LoadList$ Lists column names in the order they appear physically in the grid.
'LoadIOList$$ Same list of variables as 'LoadList$, but in compiled IOList format.
'RowData$ Returns or sets a complete row of data corresponding to the names defined in the 'LoadList$. Each cell value is separated by the defined column separator character, 'Sep$.

'LoadList$ returns a list of column names in the order in which they physically appear within the grid object. When a grid is defined using FMT= in the GRID directive, or columns names are assigned to columns in a grid, 'LoadList$ returns a list of those column names in their current display order. The compiled version, 'LoadIOList$ simplifies the loading of grid rows from direct file contents or other IOList-based items.

For Example:

myGrid.ctl'RowData$=rec(myGrid.ctl'LoadIOList$)
GRID LOAD myGrid.ctl,1,row,rec(myGrid.ctl'LoadIOList$)

The 'RowData$ property returns or sets a complete row of data in accordance to the names defined in 'LoadList$ or 'LoadIOList$. The data returned is for the row currently identified by the 'Row property.

For Example:

            READ DATA FROM X'ROWDATA$ TO IOL=X'LOADIOLIST$
  or 
            X'ROWDATA$=REC(X'LOADIOLIST$)

Because the properties 'LoadList$, 'LoadIOList$ and 'RowData$ use logical column names, column swapping has no impact.

For more information, refer to the GRID Directive.