ReadPageObjectsSnapshot Метод

Компонент: TPdf · Модуль: PDFium

Читает владеемый снимок всех объектов одной страницы, свободный от нативных дескрипторов

Syntax

function ReadPageObjectsSnapshot(PageNumber: Integer; const Options: TPdfPageObjectSnapshotOptions; out Status: TPdfPageObjectSnapshotStatus): TPdfPageObjectsSnapshot;

Description

ReadPageObjectsSnapshot копирует сведения о типе, границах, трансформациях, тексте, метках и зависимостях всех объектов одной страницы в самостоятельный TPdfPageObjectsSnapshot, не содержащий нативных дескрипторов FPDF_PAGEOBJECT

PageNumber отсчитывается от единицы; Status сообщает причину возврата пустого снимка, чтобы вызывающий код отличал отсутствующую страницу от ограниченного чтения

Remarks

Поскольку снимок владеет своими строками и массивами, он остаётся действительным после закрытия или перезагрузки документа
Повторные чтения обслуживаются кэшем снимков объектов страниц; см. PageObjectSnapshotCacheCapacity
Используйте PageObjectsSnapshot, чтобы прочитать кэшированный снимок текущей страницы

Example

Осмотрите все объекты страницы вне любого обратного вызова рендеринга

var Snap: TPdfPageObjectsSnapshot; Status: TPdfPageObjectSnapshotStatus;
Doc := Pdf1.ReadPageObjectsSnapshot(1, Default(TPdfPageObjectSnapshotOptions), Status);