FontDescent - TPdf - PDFium Delphi Component

Composant: TPdf · Unit: PDFium

Renvoie le descent de la police (distance de la ligne de base vers le plus bas descendante) de la police d’un objet de page, exprimée en points PDF et mise à l’échelle selon une taille de police fournie par l’appelant

Syntax

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

Description

FontDescent renvoie la métrique de descente de la police référencée par l’objet de page à l’index donné. La descente est la distance verticale (généralement négative dans les métriques PDF) entre la ligne de base et le point le plus bas atteint par les descendantes comme les queues de 'g', 'p' ou 'y'. La valeur renvoyée par PDFium est déjà mise à l’échelle selon l’argument FontSize, en points de l’espace utilisateur PDF

L’indexeur Index est l’index 0-based de l’objet de page (0..ObjectCount - 1). FontSize est la taille à laquelle vous voulez calculer le métrique ; passez soit la taille à laquelle vous comptez rendre, soit, lorsque vous reproduisez un texte existant, la valeur renvoyée par CharacterFontSize. Une page doit être active avant la lecture de la propriété

Combinée à FontAscent, la descente donne la hauteur de ligne totale d’une police à une taille choisie : LineHeight := FontAscent - FontDescent. PDFium renvoie 0 lorsque la police sous-jacente n’expose pas le métrique (par exemple certaines polices Type3) ou lorsque l’objet de page n’est pas du texte

Parameters

Index	Index d’objet de page de base 0, dans la plage 0..ObjectCount - 1
FontSize	Taille de police en points PDF utilisée pour mettre à l’échelle la métrique (par ex. `12.0`). Faites-la correspondre à la taille de rendu réelle pour une valeur de descendante réaliste

Remarks

La valeur renvoyée est normalement négative, correspondant à la convention PostScript / OpenType de mesurer sous la ligne de base
Renvoie 0 lorsque l’objet de page n’est pas du texte ou lorsque le descripteur de police n’a pas d’entrée de descendante
Pour les documents multilingues, la descente varie fortement entre les polices latines et CJK — ne réutilisez pas une seule descente à travers les passages
Utilisez Abs(FontDescent[...]) lorsque vous avez besoin de la chute absolue sous la ligne de base
Pour un texte de taille mixte, choisissez le plus grand FontSize de la ligne lors du dimensionnement d’une ligne

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 Propriété