FormHandle 속성

FormHandle은 현재 로드된 문서를 위해 FPDFDOC_InitFormFillEnvironment로 만들어진 원본 PDFium FPDF_FORMHANDLE을 노출합니다. 이 핸들은 PDFium의 대화형 폼 레이어로 통하는 관문입니다. 모든 FORM_* 및 FPDF_FFL* 함수가 요구하는 파라미터로서, 폼 필드 렌더링, 마우스 / 키보드 이벤트 전달, 포커스 추적, JavaScript / XFA 콜백을 관장합니다(PDFium fpdf_formfill.h)

핸들은 Active가 True가 될 때 만들어지고 Active가 False로 돌아가거나 컴포넌트가 해제될 때 파괴됩니다. 불투명하고 수명이 짧은 것으로 취급하세요 — 값을 한 번의 로드/언로드 주기 너머로 보관하지 말고, FPDFDOC_ExitFormFillEnvironment를 직접 호출하지도 마세요. 수명은 컴포넌트가 소유합니다

FormHandle은 고수준 FormField / FormFieldAt 프로퍼티로는 제어가 부족할 때 저수준 폼 이벤트를 라우팅(커스텀 마우스 / 키보드 전달, 프로그램적 필드 포커스, 스크립트 기반 appearance 재생성, XFA 리프레시)하는 데 유용한 고급 프로퍼티입니다. 폼 렌더링은 VCL TPdfView가 이미 이 핸들을 자신의 페인트 루프에 물려 놓았으므로, 제공된 뷰어를 우회하거나 별도의 이벤트 파이프라인을 구현할 때만 수동 사용이 필요합니다

• 로드된 문서가 없으면 nil을 반환합니다. PDFium 폼필 API를 호출하기 전에 항상 확인하세요
• PDFium 폼필 상태는 스레드에 안전하지 않습니다 — 문서를 로드한 스레드에서만 핸들을 사용하세요
• PDFium이 v8 JavaScript 엔진 없이 빌드되었어도 FormHandle은 정적 필드 렌더링과 기본 상호작용에는 동작하지만 문서 수준 JavaScript 액션은 무반응입니다