PDFium Delphi Component Docs

TextPage 속성

컴포넌트: TPdf  ·  유닛: PDFium
현재 활성 페이지의 네이티브 PDFium 텍스트 페이지 핸들

Syntax

property TextPage: FPDF_TEXTPAGE; // read only

Description

TextPage는 현재 로드된 페이지와 연결된 원시 PDFium FPDF_TEXTPAGE 핸들을 노출합니다. 핸들은 페이지가 활성화될 때 지연 생성되어 해당 페이지 바인딩 수명 동안 유지됩니다. 상위 수준 TPdf 속성이 노출하지 않는 연산이 필요한 호출자에게 PDFium의 텍스트 추출 API(FPDFText_*)에 대한 직접 접근을 제공합니다 — 예를 들어 글리프 수준 텍스트 run, 커닝 데이터, 사용자 지정 검색 의미론, 원시 문자 인덱스에서 경계 상자로의 매핑이 있습니다

핸들은 Active가 True이고 유효한 페이지가 선택되어 있을 때만 유효합니다. 페이지를 전환(새 PageNumber 할당 또는 ReloadPage 호출)하면 이전 핸들이 파괴되고 새 핸들이 생성되므로 페이지 변경에 걸쳐 핸들을 저장하지 마세요. 컴포넌트가 핸들을 소유하고 페이지 해체 중에 해제합니다 — 직접 FPDFText_ClosePage를 호출하지 마세요

이것은 고급 속성입니다. 대부분의 호출자는 상위 수준 래퍼 CharacterCount, Character[I], CharacterRectangle[I], Find / FindNext를 사용해야 합니다 — 이들은 이미 FPDF_TEXTPAGE 수명 주기를 내부적으로 관리합니다. PDFium Delphi Component가 아직 노출하지 않은 PDFium API가 필요할 때만 원시 핸들로 내려가세요

Remarks

Example

var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
  ShowMessage(Format('PDFium reports %d chars',
    [FPDFText_CountChars(TP)]));

See Also

CharacterCount, Character, Page, Find