Page 속성

Page는 현재 활성 페이지에 묶인 원본 PDFium FPDF_PAGE 핸들을 노출합니다. 핸들은 PageNumber가 설정될 때(또는 Active가 True로 바뀔 때) 할당되어 그 페이지 바인딩이 살아 있는 동안 유지됩니다. 모든 FPDFPage_*, FPDF_RenderPage*, 주석, 콘텐츠 스트림, 폼 위젯 호출에서 PDFium C API가 기대하는 바로 그 핸들입니다

핸들은 Active가 True이고 유효한 PageNumber가 설정된 동안에만 유효합니다. 새 PageNumber를 대입하거나 ReloadPage를 호출하거나 Active를 False로 되돌리면 기존 핸들이 파괴되고(앞의 두 경우) 새 핸들이 만들어집니다. 이 핸들에 FPDF_ClosePage를 호출하지 마세요 — 수명은 컴포넌트가 소유하며 자동으로 정리합니다

Page는 PDFium Delphi Component가 아직 감싸지 않은 PDFium API를 호출할 때 유용한 고급 프로퍼티입니다 — 예컨대 커스텀 appearance stream 재생성, 페이지 객체 관리, 저수준 텍스트 추출 조정 같은 용도입니다. 대부분의 호출자는 핸들을 이미 올바르게 관리하는 고수준 프로퍼티(PageWidth, PageHeight, RenderToBitmap, Annotation 등)를 쓰는 편이 좋습니다

• 활성 페이지가 없으면 nil을 반환합니다. 핸들을 PDFium 함수에 넘기기 전에 항상 확인하세요
• PDFium에서 페이지 핸들은 스레드에 안전하지 않습니다. 페이지는 부모 Document를 소유한 스레드에서만 사용하세요
• 문서 핸들과 페이지 핸들을 둘 다 받는 PDFium API를 호출할 때는 Document와 조합하세요 — 예: FPDFPage_Delete(Pdf.Document, Pdf.PageNumber - 1)