FontHandle - TPdf - PDFium Delphi Component

Komponente: TPdf · Unit: PDFium

Gibt den nativen FPDF_FONT-Handle der von einem Seitenobjekt verwendeten Schrift zurück. Der Handle gibt fortgeschrittenen Aufrufern direkten Zugriff auf PDFium-Schrift-APIs, die von der Komponente nicht umschlossen werden

Syntax

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

Description

FontHandle liefert den rohen PDFium-Font-Zeiger (FPDF_FONT), der zum Text-Seitenobjekt am übergebenen Index gehört. Intern ist der Wert genau das, was PDFium aus FPDFTextObj_GetFont zurückgibt; die meisten anderen Font*-Eigenschaften an TPdf — FontAscent, FontDescent, FontFamilyName, FontBaseName, FontIsEmbedded, FontItalicAngle, FontWeight, FontData — sind Komfort-Wrapper, die darauf aufbauen

Der Index ist ein 0-basierter Seitenobjekt-Index im Bereich 0..ObjectCount - 1. Nur Objekte vom Typ Text tragen eine Schrift; bei Bild-, Pfad- oder Shading-Objekten liefert der Aufruf nil. Bevor die Eigenschaft gelesen wird, muss eine Seite aktiv sein

Das zurückgegebene Handle gehört PDFium und bleibt nur gültig, solange die aktuelle Seite geladen ist. Geben Sie es nicht frei, speichern Sie es nicht über Seitenwechsel hinweg und rufen Sie keine destruktiven PDFium-APIs darauf auf — behandeln Sie es als opakes, Read-only-Token

Parameters

Index 0-basierter Seitenobjekt-Index. Zuerst mit ObjectType bestätigen, dass das Objekt Text ist; Nicht-Text-Objekte liefern nil

Remarks

Der zurückgegebene Zeiger wird ungültig, sobald die Seite entladen wird (etwa bei einem Wechsel von PageNumber) — niemals cachen
Immer auf nil prüfen, bevor das Handle an einen rohen FPDFFont_*-Import durchgereicht wird
Diese Eigenschaft ist die Brücke zu PDFium-APIs, für die es noch keinen Pascal-Wrapper gibt, etwa FPDFFont_GetFlags oder FPDFFont_GetFontBBox
Zwei verschiedene Seitenobjekte dürfen dasselbe Handle teilen, wenn sie auf dasselbe Font-Dictionary im PDF verweisen
Das Lesen der Eigenschaft fixiert die zugrunde liegende Schrift für die Dauer des Aufrufs; PDFium referenzzählt das Handle nicht, planen Sie Ihre Arbeit entsprechend

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 Eigenschaft