FontAscent - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Retourneert de stijging van het lettertype (afstand van de basislijn tot de hoogste stijger) van het lettertype van een pagina-object, uitgedrukt in PDF-punten en geschaald naar een door de aanroeper opgegeven lettertypegrootte

Syntax

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

Description

FontAscent rapporteert de stijgingsmeting van het lettertype waarnaar het pagina-object op de opgegeven index verwijst. De stijging is de verticale afstand van de basislijn omhoog tot de hoogste reikwijdte van de hoogste tekens van het lettertype (hoofdletters, accenten, stijgers zoals 'l', 'h' of 'k'). Het resultaat wordt uitgedrukt in PDF-gebruikersruimte-punten, reeds geschaald naar de FontSize die u doorgeeft.

De indexeerder Index is de op 0 gebaseerde pagina-objectindex (0..ObjectCount - 1). De tweede indexeerder, FontSize, is de grootte in PDF-punten waarvoor de meting moet worden berekend. Geef de grootte door waarop u wilt renderen, of gebruik CharacterFontSize[n] om de grootte van een bestaande tekstloop te spiegelen. Een pagina moet actief zijn bij het lezen van de eigenschap.

Samen met FontDescent geeft dit de totale regelhoogte van het lettertype: LineHeight := FontAscent - FontDescent (daling is doorgaans negatief). PDFium retourneert 0 wanneer het lettertype de meting niet bevat of wanneer het geïndexeerde 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. Doorgaans de grootte waarop het lettertype wordt gerenderd (bijv. `10.0`, `12.0`).

Remarks

Retourneert een positieve waarde — de stijging wordt opwaarts gemeten vanaf de basislijn.
Voor een typografisch getrouwe lay-out combineert u stijging en daling in plaats van uitsluitend FontSize te gebruiken.
Retourneert 0 wanneer het lettertype geen stijgingsvermelding heeft of wanneer het object geen tekst is — houd hier altijd rekening mee.
CJK-lettertypen rapporteren vaak hogere stijgingen dan westerse lettertypen bij dezelfde grootte; ga er niet van uit dat Latijnse metingen overeenkomen.
De eerste indexeerder van de eigenschap komt overeen met de pagina-objectindex die door FontHandle wordt gebruikt, niet met de tekenindex die door Character wordt gebruikt.

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;

FontAscent eigenschap