FontDescent - TPdf

Denna API-post behåller identifierare, signaturer, kodblock och PDF-termer i ursprunglig form.

Komponent: TPdf · Enhet: PDFium

Returnerar teckensnittets descent (avståndet från baslinjen ned till den lägsta nedåtgående delen) för ett sidobjekts teckensnitt, uttryckt i PDF-punkter och skalat till en av anroparen angiven teckenstorlek.

Syntax

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

Beskrivning

FontDescent rapporterar descent-måttet för teckensnittet som refereras av sidobjektet på det angivna indexet. Descent är det vertikala avståndet (vanligtvis negativt i PDF-mått) från baslinjen till den lägsta punkt som nås av nedåtgående delar som svansarna på 'g', 'p' eller 'y'. Värdet som PDFium returnerar är redan skalat till FontSize argument, in PDF user-space points.

The Index indexer is the 0-based page-object index (0..ObjectCount - 1). FontSize är den storlek vid vilken du vill att måttet ska beräknas; skicka antingen den storlek du tänker rendera med eller, när du återger befintlig text, värdet som returneras av CharacterFontSize. En sida måste vara aktiv innan egenskapen läses.

Combined with FontAscent the descent gives the total line height of a font at a chosen size: LineHeight := FontAscent - FontDescent. PDFium returnerar 0 när det underliggande teckensnittet inte exponerar måttet (till exempel vissa Type3-teckensnitt) eller när sidobjektet inte är text.

Parametrar

Index	0-based page-object index in the range 0..ObjectCount - 1.
FontSize	Font size in PDF points used to scale the metric (e.g. `12.0`). Match it to the actual rendering size for a realistic descender value.

Anmärkningar

Det returnerade värdet är normalt negativt och följer PostScript-/OpenType-konventionen att mäta under baslinjen.
Returnerar 0 när sidobjektet inte är text eller när teckensnittsbeskrivningen saknar en descent-post.
For multi-language documents, descent varies sharply between Latin and CJK fonts — do not reuse a single descent across runs.
Use Abs(FontDescent[...]) when you need the absolute drop below the baseline.
For mixed-size text choose the largest FontSize on the line when sizing a row.

Exempel

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;

Se även

FontAscent, FontSize, FontHandle, FontFamilyName

FontDescent Egenskap