RefreshDataFromDD - cDbCJGrid
Refreshes and redisplays a grid based around the current record in your DataDictionary Object and the offset from top by iOffset
Type: Procedure
Parameters
| Parameter | Type | Description |
|---|---|---|
| iOffset | Integer | An offset preference for displaying this row, where 0 or is the first visible row in the grid, 1 is the second visible row, etc. ropBottom, ropCenter and ropTop constants apply. |
Syntax
Procedure RefreshDataFromDD Integer iOffset
Call Example
Send RefreshDataFromDD iOffset
Description
RefreshDataFromDD refreshes your grid based around the current record in your DataDictionary object (DDO).
The current record is based is the DataDictionary's CurrentRowId property. It does this by calling RefreshDataFromMatchingRow.
It places this record iOffset rows from the grid and finds records above and below this record. See SynchronizeGridtoSelectedRow for details.
This will work with dynamic and static (pbStaticData) grids, just that with static grids, all the data is reloaded.
This is rarely used, because finding a record in your DataDictionary will automatically redisplay the grid for you. It can be used to force a refresh in a grid.
It is the developer's responsibility to make sure that the target record for this refresh is a valid record. It must exist and it must be constraint valid. If the record is not valid, the refresh will not succeed and the HandleCacheError method will be called. When HandleCacheError is called, it will handle this condition by refreshing the grid and, if pbSuppressCacheError is False, reporting an error.