FontHandle - TPdf - PDFium Delphi Component

Componente: TPdf · Unità: PDFium

Restituisce l'handle nativo FPDF_FONT del font usato da un oggetto pagina. L'handle offre ai chiamanti esperti accesso diretto alle API dei font PDFium non incapsulate dal componente

Syntax

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

Description

FontHandle restituisce il puntatore raw del font PDFium (FPDF_FONT) associato all'oggetto di pagina testuale all'indice fornito. Internamente il valore è ciò che PDFium restituisce da FPDFTextObj_GetFont; la maggior parte delle altre proprietà Font* di TPdf — FontAscent, FontDescent, FontFamilyName, FontBaseName, FontIsEmbedded, FontItalicAngle, FontWeight, FontData — sono wrapper di convenienza costruiti sopra di esso

L'indice è un indice dell'oggetto di pagina a base zero nell'intervallo 0..ObjectCount - 1. Solo gli oggetti di tipo testo hanno un font; per oggetti immagine, path o shading la chiamata restituisce nil. Una pagina deve essere attiva prima della lettura della proprietà

L'handle restituito è di proprietà di PDFium e resta valido solo finché la pagina corrente è caricata. Non liberarlo, non memorizzarlo tra cambi di pagina e non chiamare su di esso API PDFium distruttive — trattalo come un token opaco e in sola lettura

Parameters

Index Indice dell'oggetto di pagina a base zero. Usa prima ObjectType per confermare che l'oggetto è testo; gli oggetti non testuali restituiscono nil

Remarks

Il puntatore restituito diventa non valido non appena la pagina viene scaricata (es. quando PageNumber cambia) — non farne mai cache
Verifica sempre nil prima di passare l'handle a un import raw FPDFFont_*
Questa proprietà è il ponte verso le API PDFium che non hanno ancora un wrapper Pascal, es. FPDFFont_GetFlags o FPDFFont_GetBBox
Due oggetti di pagina diversi possono condividere lo stesso handle quando referenziano lo stesso dizionario font nel PDF
La lettura della proprietà blocca il font sottostante per la durata della chiamata; PDFium non fa reference counting dell'handle, quindi pianifica di conseguenza

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 Proprietà