This method is used to add a Structures_DataGrid_Record object to the DataGrid's Record Set. This is not the only method of getting data into the DataGrid. Commonly, the bind() method is used, unless you need to add individual records to the DataGrid. The Structures_DataGrid_Record object accepts an array of values. This method works best for looping through a result set from a database query or a XML or CSV data file.
The record must be of type Structures_DataGrid_Record to be added to the DataGrid. Currently their are 2 other available record classes, a DB and a DB_DataObject record class, that exist in the package as well. This will allow you to extend the existing record class for a custom record driver.