PDFium Delphi Component Docs

Form host-callbacks

Komponent: TPdf  ·  Enhed: PDFium
Kobler PDFium-formularinteraktion til hostens navigations-, URI-, cursor-, ændrings-, side- og markeringsadfærd

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

Dokument-JavaScript kan bede om en side, som endnu ingen view har åbnet, så form hosten indlæser den lazily, gemmer ét handle pr. anmodet side, sender native page-open-notifikationer og frigiver hvert handle, før formularmiljøet lukkes

FormHostCallbacksComplete er true, efter at formularmiljøet har installeret alle påkrævede version-1-callbacks

Navigation and URI actions

OnFormGoToAction modtager et enbaseret sidenummer, den native zoomtilstand og en afgrænset kopi af destinationspositions-arrayet

Efterlades GoTo ubehandlet, skiftes siden for det view, der startede formularinteraktionen, med fallback til TPdf.PageNumber ved headless-brug; hosten kan sætte Handled og selv anvende destinationsscrolling eller zoom

OnFormUriAction modtager afkodede og rå URI-værdier plus tastaturmodifikatorer for både AcroForm- og XFA-handlinger og starter intet eksternt, medmindre hosten vælger det

Cursor, changes, and selected rectangles

OnFormCursor modtager både en stabil TPdfFormCursor-værdi og den oprindelige native cursor-kode; den stabile værdi er én af pfcUnknown, pfcArrow, pfcSizeNESW, pfcSizeNWSE, pfcVerticalBeam, pfcHorizontalBeam eller pfcHand, og efterlades den ubehandlet, opdateres kun det view, der startede formularinteraktionen

OnFormValueChange kører efter invalidering af afledte side-caches og samler indlejrede ændringsnotifikationer sammen

FormSelectionRects returnerer et snapshot ejet af kalderen med op til 4096 rektangler i siderum fra native formular-tekstmarkering; OnFormSelectionRect streamer hvert nyt rektangel, og ClearFormSelectionRects rydder den gemte geometri

See Also

FormFieldInfo, FormFieldTypeAtPoint, TPdfView.FormFieldInfoAt