PDFium Component Docs

Callbacki hosta formularzy

Component: TPdf  ·  Unit: PDFium
Łączy interakcje formularzy PDFium z nawigacją hosta oraz zachowaniami URI, kursora, zmian, stron i zaznaczenia

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 dokumentu może zażądać strony, którą jeszcze nie otworzył żaden widok, więc host formularzy ładuje ją leniwie, przechowuje jeden uchwyt na każdą żądaną stronę, wysyła natywne powiadomienia o otwarciu strony i zwalnia wszystkie uchwyty przed zamknięciem środowiska formularzy

FormHostCallbacksComplete ma wartość true po zainstalowaniu przez środowisko formularzy wszystkich wymaganych callbacków wersji 1

Navigation and URI actions

OnFormGoToAction otrzymuje numer strony liczony od jedynki, natywny tryb powiększenia oraz ograniczoną kopię tablicy pozycji docelowej

Brak obsługi GoTo zmienia stronę widoku, który zainicjował interakcję formularza, z fallbackiem do TPdf.PageNumber przy pracy bez interfejsu; host może ustawić Handled i samodzielnie zastosować przewijanie lub powiększenie docelowe

OnFormUriAction otrzymuje zdekodowaną i surową wartość URI oraz modyfikatory klawiatury dla akcji AcroForm i XFA, a samo nie uruchamia niczego zewnętrznego, chyba że host zdecyduje inaczej

Cursor, changes, and selected rectangles

OnFormCursor otrzymuje zarówno stabilną wartość TPdfFormCursor, jak i oryginalny natywny kod kursora; wartość stabilna to jedna z pfcUnknown, pfcArrow, pfcSizeNESW, pfcSizeNWSE, pfcVerticalBeam, pfcHorizontalBeam lub pfcHand, a brak obsługi aktualizuje tylko widok, który zainicjował interakcję formularza

OnFormValueChange wykonuje się po unieważnieniu pochodnych pamięci podręcznych strony i scala zagnieżdżone powiadomienia o zmianach

FormSelectionRects zwraca należący do wywołującego zrzut do 4096 prostokątów w przestrzeni strony z natywnego zaznaczenia tekstu formularza; OnFormSelectionRect przekazuje każdy nowy prostokąt na bieżąco, a ClearFormSelectionRects czyści zachowaną geometrię

See Also

FormFieldInfo, FormFieldTypeAtPoint, TPdfView.FormFieldInfoAt