colibrio-reader-framework/com.colibrio.readingsystem.base/VisiblePage/fetchBoundingClientRectForContentLocation

fetchBoundingClientRectForContentLocation

abstract fun fetchBoundingClientRectForContentLocation(locator: SimpleLocatorData, onSuccess: (Rect?) -> Unit, onError: (ColibrioException) -> Unit)

abstract suspend fun fetchBoundingClientRectForContentLocation(locator: SimpleLocatorData): ColibrioResult<Rect?>

Fetch one bounding client rect for the specified target locator on this visible page.

The rectangle coordinates are in device independent pixels where (0, 0) is top left of the ColibrioReadingSystemView. This means that any subsequent transform applied to the ReaderView, such as the user pinch-zooming, will make the rectangle out of date.

null is returned when the locator targets non-rendered content.

If the visible page is currently not in ReaderView.visiblePages, the returned result is rejected with an error object with the error type set to VISIBLE_PAGE_OUTDATED.

If the visible page is destroyed before the result could be calculated, the returned result is rejected with an error object with the error type set to ABORTED.

If the passed locator is not intersecting with the visible page, the returned result is rejected with an error object with the error type set to CONTENT_LOCATION_OUTSIDE_VISIBLE_PAGE.