restore method

bool restore(
  1. FdcDataSetBookmark bookmark, {
  2. bool fallbackToNearest = false,
})

Restores the current record from bookmark.

Returns true only when the original bookmarked record is still present in the active view. A bookmark created by another dataset instance is rejected and returns false.

When fallbackToNearest is true and the original record is no longer visible, the cursor moves to the nearest valid position based on the bookmark's former index. That fallback move still returns false because the original record was not restored.

Implementation

bool restore(FdcDataSetBookmark bookmark, {bool fallbackToNearest = false}) =>
    _dataSet._restoreBookmark(bookmark, fallbackToNearest: fallbackToNearest);