PDFium Delphi Component Docs

Zpětná volání hostitele formulářů

Komponenta: TPdf  ·  Jednotka: PDFium
Propojuje interakci s formuláři PDFium s navigací hostitele a chováním URI, kurzoru, změn, stránek a výběru

Vlastnosti a události

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;

Správa stránek

JavaScript dokumentu může vyžádat stránku, kterou ještě neotevřel žádný pohled, takže hostitel formulářů ji načítá líně, drží jeden handle na každou požadovanou stránku, posílá nativní notifikace o otevření stránky a uvolní všechny handly před uzavřením formulářového prostředí

FormHostCallbacksComplete je true poté, co formulářové prostředí nainstalovalo každý požadovaný callback verze 1

Navigace a akce URI

OnFormGoToAction přijímá číslo stránky počítané od jedničky, nativní režim zoom a ohraničenou kopii pole cílové pozice

Pokud GoTo necháte neošetřené, změní se stránka pohledu, který zahájil interakci s formulářem, s pádem na TPdf.PageNumber pro headless použití; hostitel může nastavit Handled a posun na cíl či zoom provést sám

OnFormUriAction přijímá dekódované i surové hodnoty URI plus modifikační klávesy pro akce AcroForm i XFA a sám nespustí žádné externí otevření, pokud se to hostitel nerozhodne udělat

Kurzor, změny a obdélníky výběru

OnFormCursor přijímá současně stabilní hodnotu TPdfFormCursor i původní nativní kód kurzoru; stabilní hodnota je jedna z pfcUnknown, pfcArrow, pfcSizeNESW, pfcSizeNWSE, pfcVerticalBeam, pfcHorizontalBeam nebo pfcHand, a když ji necháte neošetřenou, aktualizuje se jen pohled, který zahájil interakci s formulářem

OnFormValueChange běží po zneplatnění odvozených cache stránek a slučuje vnořené notifikace o změnách

FormSelectionRects vrací snapshot ve vlastnictví volajícího s až 4096 obdélníky v prostoru stránky z nativního výběru textu ve formuláři; OnFormSelectionRect posílá každý nový obdélník a ClearFormSelectionRects vymaže uloženou geometrii

Viz také

FormFieldInfo, FormFieldTypeAtPoint, TPdfView.FormFieldInfoAt