FontDescent - TPdf - PDFium Delphi Component

Komponente: TPdf · Unit: PDFium

Gibt den Descent der Schrift eines Seitenobjekts zurück (Abstand von der Grundlinie bis zum niedrigsten Unterlängenzeichen), angegeben in PDF-Punkten und skaliert auf eine vom Aufrufer angegebene Schriftgröße

Syntax

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

Description

FontDescent meldet die Descent-Metrik der Schrift, auf die das Seitenobjekt am gegebenen Index verweist. Descent ist der vertikale Abstand (in PDF-Metriken typischerweise negativ) von der Grundlinie zum tiefsten Punkt der Unterlängen, etwa der Schweife von 'g', 'p' oder 'y'. Der von PDFium gelieferte Wert ist bereits auf das FontSize-Argument skaliert, in PDF-Benutzerraum-Punkten

Der Index-Indexer ist der 0-basierte Seitenobjekt-Index (0..ObjectCount - 1). FontSize ist die Größe, für die die Metrik berechnet werden soll; übergeben Sie entweder die Größe, in der Sie rendern wollen, oder — bei der Reproduktion vorhandenen Texts — den von CharacterFontSize gelieferten Wert. Bevor die Eigenschaft gelesen wird, muss eine Seite aktiv sein

Zusammen mit FontAscent ergibt der Descent die Gesamthöhe der Zeile einer Schrift in der gewählten Größe: LineHeight := FontAscent - FontDescent. PDFium liefert 0, wenn der zugrunde liegende Font die Metrik nicht ausweist (etwa bei manchen Type3-Fonts) oder das Seitenobjekt kein Text ist

Parameters

Index	0-basierter Seitenobjekt-Index im Bereich 0..ObjectCount - 1
FontSize	Schriftgröße in PDF-Punkten, auf die die Metrik skaliert wird (z. B. `12.0`). An die tatsächliche Rendering-Größe anpassen, um einen realistischen Descent-Wert zu bekommen

Remarks

Der zurückgegebene Wert ist normalerweise negativ, gemäß der PostScript-/OpenType-Konvention, unterhalb der Grundlinie zu messen
Liefert 0, wenn das Seitenobjekt kein Text ist oder der Font-Deskriptor keinen Descent-Eintrag hat
In mehrsprachigen Dokumenten variiert der Descent stark zwischen lateinischen und CJK-Fonts — verwenden Sie einen einzelnen Descent-Wert nicht über mehrere Läufe hinweg
Benötigen Sie den absoluten Abfall unter die Grundlinie, verwenden Sie Abs(FontDescent[...])
Bei gemischt großen Texten für die Zeilenhöhe die größte FontSize der Zeile wählen

Example

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

FontDescent Eigenschaft