FontHandle - TPdf - PDFium Delphi Component

컴포넌트: TPdf · 유닛: PDFium

페이지 오브젝트가 사용하는 글꼴의 네이티브 FPDF_FONT 핸들을 반환합니다. 이 핸들은 컴포넌트로 감싸지지 않은 PDFium 글꼴 API에 고급 호출자가 직접 접근할 수 있게 해줍니다

Syntax

property FontHandle[Index: Integer]: FPDF_FONT; // read only

Description

FontHandle는 지정한 인덱스의 텍스트 페이지 객체에 묶인 원본 PDFium 폰트 포인터(FPDF_FONT)를 반환합니다. 내부적으로 이 값은 FPDFTextObj_GetFont가 반환하는 것이며, TPdf의 다른 Font* 프로퍼티 대부분 — FontAscent, FontDescent, FontFamilyName, FontBaseName, FontIsEmbedded, FontItalicAngle, FontWeight, FontData — 는 이 위에 얹은 편의 래퍼입니다

인덱스는 0..ObjectCount - 1 범위의 0 기반 페이지 객체 인덱스입니다. 텍스트 타입 객체만 폰트를 가지며, 이미지, 경로, 셰이딩 객체에 대한 호출은 nil을 반환합니다. 프로퍼티를 읽기 전에 페이지가 활성화되어 있어야 합니다

반환된 핸들의 소유자는 PDFium이며 현재 페이지가 로드되어 있는 동안에만 유효합니다. 해제하지 말고, 페이지가 바뀌어도 보관하지 말고, 파괴적인 PDFium API를 호출하지 마세요 — 불투명한 읽기 전용 토큰으로 취급하세요

Parameters

Index 0 기반 페이지 객체 인덱스입니다. 객체가 텍스트인지 먼저 ObjectType으로 확인하세요. 텍스트가 아닌 객체는 nil을 반환합니다

Remarks

반환된 포인터는 페이지가 언로드되는 즉시 무효가 됩니다(예: PageNumber 변경) — 절대 캐싱하지 마세요
핸들을 원본 FPDFFont_* 임포트에 넘기기 전에 항상 nil 검사를 하세요
이 프로퍼티는 아직 Pascal 래퍼가 없는 PDFium API, 예컨대 FPDFFont_GetFlags나 FPDFFont_GetFontBBox로 가는 다리입니다
서로 다른 두 페이지 객체가 PDF 안에서 같은 폰트 딕셔너리를 참조하면 같은 핸들을 공유할 수 있습니다
프로퍼티를 읽으면 호출이 살아 있는 동안 기반 폰트가 고정됩니다. PDFium은 핸들을 레퍼런스 카운트하지 않으니 작업 계획을 그에 맞게 세우세요

Example

var
  I: Integer;
  H: FPDF_FONT;
begin
  Pdf1.PageNumber := 1;
  for I := 0 to Pdf1.ObjectCount - 1 do
  begin
    H := Pdf1.FontHandle[I];
    if H <> nil then
      Memo1.Lines.Add(Format('Object %d uses font %s',
        [I, Pdf1.FontFamilyName[I]]));
  end;
end;

FontHandle 속성