PDFium Delphi Component Docs

Колбэки хоста форм

Компонент: TPdf  ·  Модуль: PDFium
Связывает взаимодействие с формами PDFium с навигацией хоста, обработкой URI, курсором, изменениями, страницами и выделением

Properties and events

property FormHostCallbacksComplete: Boolean; // read only

property FormSelectionRects: TPdfFormSelectionRects; // read only

procedure ClearFormSelectionRects;

property OnFormCursor: TPdfFormCursorEvent;

property OnFormValueChange: TPdfFormValueChangeEvent;

property OnFormUriAction: TPdfFormUriActionEvent;

property OnFormGoToAction: TPdfFormGoToActionEvent;

property OnFormSelectionRect: TPdfFormSelectionRectEvent;

Page ownership

JavaScript документа может запросить страницу, которую ещё не открыл ни один просмотрщик, поэтому хост форм загружает её отложенно, удерживает по одному дескриптору на каждую запрошенную страницу, отправляет собственные уведомления об открытии страницы и освобождает все дескрипторы до закрытия среды форм

FormHostCallbacksComplete равен true после того, как среда форм установила все требуемые колбэки версии 1

Navigation and URI actions

OnFormGoToAction получает номер страницы (отсчёт с единицы), собственный режим масштабирования и ограниченную копию массива позиции назначения

Если GoTo остаётся необработанным, меняется страница представления, инициировавшего взаимодействие с формой, с откатом к TPdf.PageNumber для использования без UI; хост может установить Handled и самостоятельно применить прокрутку или масштабирование назначения

OnFormUriAction получает декодированное и исходное значения URI плюс модификаторы клавиатуры как для действий AcroForm, так и для XFA, и сам по себе не выполняет внешний запуск, если хост явно этого не выберет

Cursor, changes, and selected rectangles

OnFormCursor получает и стабильное значение TPdfFormCursor, и исходный собственный код курсора; стабильное значение равно одному из pfcUnknown, pfcArrow, pfcSizeNESW, pfcSizeNWSE, pfcVerticalBeam, pfcHorizontalBeam или pfcHand, а при отсутствии обработки обновляется только представление, инициировавшее взаимодействие с формой

OnFormValueChange выполняется после инвалидации производных кэшей страницы и объединяет вложенные уведомления об изменениях

FormSelectionRects возвращает снимок во владении вызывающего кода — до 4096 прямоугольников в пространстве страницы из собственного выделения текста формы; OnFormSelectionRect передаёт каждый новый прямоугольник по мере появления, а ClearFormSelectionRects очищает удерживаемую геометрию

See Also

FormFieldInfo, FormFieldTypeAtPoint, TPdfView.FormFieldInfoAt