An entire record's data.

Usage

Set_Property(OLECtrlEntID, "OLE.RecordData[record]", Array)

Values

Array has the following structure:

PosNameTypeDescriptionDefault
<1>RecordTextThe record's text""
<1, 1>CellTextThe cell's text""

Indices

IndexDescription
recordIndex to an existing record

Remarks

The RecordData property is useful for getting or setting individual records in the edit table without having to use the Array or List properties, which apply only to the whole table.

Like all indexed properties, you can specify a single record (e.g. "1"), a range or records (e.g. "1-3"), or all records (e.g. "All"). Each record is delimited by a field mark (@FM), which is why the cells are @VM delimited to begin with.

Setting the RecordData property is just like setting the LIST property. For example, if you intend to set 3 records, then you need to pass three records worth of data. You may observe then that using the "All" index is equivalent to using the List property. Unlike the List property however, this property does not add or remove records when being set.

If there is less data than records being set, then the remaining cells become blank. If there is more data then records being set, then the extra data is ignored.

Example

// Read the 3rd record 
Data = Get_Property(@Window:".OLE_EDITTABLE", "OLE.RecordData[3]") 

// Set records 5 through 7 
Set_Property(@Window:".OLE_EDITTABLE", "OLE.RecordData[5-7]", Data)

See Also

ColumnDataLIST

  • No labels