FontDescent - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Retourneert de daling van het lettertype (de afstand van de basislijn naar beneden tot de laagste daler) van het lettertype van een pagina-object, uitgedrukt in PDF-punten en geschaald naar een door de aanroeper opgegeven lettertypegrootte

Syntax

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

Description

FontDescent rapporteert de dalingsmeting van het lettertype waarnaar het pagina-object op de opgegeven index verwijst. Daling is de verticale afstand (doorgaans negatief in PDF-metingen) van de basislijn naar het laagste punt dat door dalers wordt bereikt, zoals de staarten van 'g', 'p' of 'y'. De waarde die PDFium retourneert is reeds geschaald naar het argument FontSize, in PDF-gebruikersruimte-punten.

De indexeerder Index is de op 0 gebaseerde pagina-objectindex (0..ObjectCount - 1). FontSize is de grootte waarvoor u de meting berekend wilt hebben; geef ofwel de grootte door waarop u wilt renderen of, bij het reproduceren van bestaande tekst, de waarde die door CharacterFontSize wordt geretourneerd. Een pagina moet actief zijn voordat de eigenschap wordt gelezen.

Gecombineerd met FontAscent geeft de daling de totale regelhoogte van een lettertype bij een gekozen grootte: LineHeight := FontAscent - FontDescent. PDFium retourneert 0 wanneer het onderliggende lettertype de meting niet beschikbaar maakt (bijvoorbeeld bepaalde Type3-lettertypen) of wanneer het pagina-object geen tekst is.

Parameters

Index	Op 0 gebaseerde pagina-objectindex in het bereik 0..ObjectCount - 1.
FontSize	Lettertypegrootte in PDF-punten gebruikt om de meting te schalen (bijv. `12.0`). Stem deze af op de werkelijke renderinggrootte voor een realistische dalerwaarde.

Remarks

De geretourneerde waarde is doorgaans negatief, overeenkomstig de PostScript-/OpenType-conventie om onder de basislijn te meten.
Retourneert 0 wanneer het pagina-object geen tekst is of wanneer de lettertypebeschrijver geen dalingsvermelding heeft.
Voor meertalige documenten varieert de daling sterk tussen Latijnse en CJK-lettertypen — hergebruik niet één daling over meerdere lussen.
Gebruik Abs(FontDescent[...]) wanneer u de absolute daaling onder de basislijn nodig heeft.
Kies bij tekst van gemengde grootte de grootste FontSize op de regel bij het dimensioneren van een rij.

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 eigenschap