PDFium Delphi Component Docs

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

Component: TPdf  ·  Unit: 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 для headless-використання; хост може встановити 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