PDFium Delphi Component Docs

FontAscent Proprietà

Componente: TPdf  ·  Unità: PDFium
Restituisce l'ascent del font, cioè la distanza dalla baseline all'ascender più alto, del font di un oggetto pagina, espressa in punti PDF e scalata a una dimensione font fornita dal chiamante

Syntax

property FontAscent[Index: Integer; FontSize: Single]: Single; // read only

Description

FontAscent riporta la metrica di ascent del font referenziato dall'oggetto di pagina all'indice dato. L'ascent è la distanza verticale dalla baseline fino all'estensione più alta raggiunta dai caratteri più alti del font (maiuscole, accenti, ascendenti come 'l', 'h' o 'k'). Il risultato è espresso in punti user-space PDF, già scalato alla FontSize che passi

L'indice Index è l'indice dell'oggetto di pagina a base zero (0..ObjectCount - 1). Il secondo indice, FontSize, è la dimensione in punti PDF a cui la metrica va calcolata. Passa la dimensione a cui intendi fare rendering, oppure usa CharacterFontSize[n] per replicare la dimensione di un run di testo esistente. Una pagina deve essere attiva durante la lettura della proprietà

Insieme a FontDescent questo dà l'altezza totale di riga del font: LineHeight := FontAscent - FontDescent (il descent è tipicamente negativo). PDFium restituisce 0 quando il font non ha la metrica o quando l'oggetto indicizzato non è testo

Parameters

IndexIndice dell'oggetto di pagina a base zero nell'intervallo 0..ObjectCount - 1
FontSizeDimensione del font in punti PDF usata per scalare la metrica. In genere la dimensione a cui il font verrà renderizzato (ad es. 10.0, 12.0)

Remarks

Example

var
  I: Integer;
  Asc: Single;
begin
  Pdf1.PageNumber := 1;
  for I := 0 to Pdf1.ObjectCount - 1 do
  begin
    Asc := Pdf1.FontAscent[I, 12.0];
    if Asc > 0 then
      Memo1.Lines.Add(Format('Object %d: ascent = %.2f pt', [I, Asc]));
  end;
end;

See Also

FontDescent, FontSize, FontHandle, FontFamilyName