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는 폼 환경이 필요한 버전 1 콜백을 모두 설치한 뒤 true가 됩니다

Navigation and URI actions

OnFormGoToAction은 1부터 시작하는 페이지 번호, 네이티브 줌 모드, 대상 위치 배열의 크기가 제한된 복사본을 받습니다

GoTo를 처리하지 않고 두면 폼 상호작용을 시작한 뷰의 페이지가 바뀌고, 헤드리스 사용 시에는 TPdf.PageNumber로 폴백합니다. 호스트는 Handled를 설정하고 대상 스크롤이나 줌을 직접 적용할 수도 있습니다

OnFormUriAction은 AcroForm과 XFA 액션 모두에 대해 디코딩된 URI 값과 원본 URI, 키보드 수정키를 받으며, 호스트가 직접 선택하지 않는 한 외부 실행을 하지 않습니다

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