PDFiumPas 文件

FontHandle 屬性

此 API 條目保留識別符號、簽名、程式碼塊和 PDF 術語的原始形式。
元件: TPdf  ·  單元: PDFium
傳回頁面物件所使用字型的原生 FPDF_FONT 控制代碼。此控制代碼可讓進階呼叫端直接存取元件未包裝的 PDFium 字型 API

語法

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

說明

FontHandle 會傳回與指定索引處文字頁物件相關聯的原始 PDFium 字型指標（FPDF_FONT）。此值內部就是 PDFium 從 FPDFTextObj_GetFont 傳回的結果；TPdf 上其他多數 Font* 屬性（FontAscent、FontDescent、FontFamilyName、FontBaseName、FontIsEmbedded、FontItalicAngle、FontWeight、FontData）都是建立在它之上的便利包裝

索引是 0 起算的頁面物件索引，範圍為 0..ObjectCount - 1。只有文字型物件才會帶有字型；影像、路徑或陰影物件會傳回 nil。讀取屬性前頁面必須先啟用

傳回的控制代碼由 PDFium 擁有，只有在目前頁面載入期間才有效。不要釋放它，不要跨頁面變更保存它，也不要對它呼叫會破壞狀態的 PDFium API，請把它視為不透明且唯讀的代碼

參數

Index0 起算的頁面物件索引。請先用 ObjectType 確認物件是文字；非文字物件會傳回 nil

備註

範例

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;

另請參閱

FontFamilyName, FontBaseName, FontIsEmbedded, FontData, ObjectCount, ObjectType