FontAscent - TPdf - PDFiumPas

Component: TPdf · Unit: PDFium

Mengembalikan ascent font (jarak dari baseline ke ascender tertinggi) dari font objek halaman, dinyatakan dalam point PDF dan diskalakan ke ukuran font yang disediakan pemanggil

Syntax

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

Description

FontAscent melaporkan metrik ascent dari font yang direferensikan oleh objek halaman pada indeks yang diberikan. Ascent adalah jarak vertikal dari baseline ke batas tertinggi yang dicapai karakter tertinggi font (kapital, aksen, ascender seperti 'l', 'h', atau 'k'). Hasil dinyatakan dalam points ruang-pengguna PDF, sudah diskalakan ke FontSize yang Anda lewatkan

Indekser Index adalah indeks objek-halaman berbasis-0 (0..ObjectCount - 1). Indekser kedua, FontSize, adalah ukuran dalam points PDF di mana metrik harus dihitung. Lewatkan ukuran yang Anda maksudkan untuk dirender, atau gunakan CharacterFontSize[n] untuk mencerminkan ukuran run teks yang ada. Halaman harus aktif ketika membaca properti

Bersama dengan FontDescent ini memberikan tinggi baris total font: LineHeight := FontAscent - FontDescent (descent biasanya negatif). PDFium mengembalikan 0 ketika font tidak memiliki metrik atau ketika objek yang diindeks bukan teks

Parameters

Index	Indeks objek-halaman berbasis-0 dalam rentang 0..ObjectCount - 1
FontSize	Ukuran font dalam points PDF yang dipakai untuk menskalakan metrik. Biasanya ukuran di mana font akan dirender (mis. `10.0`, `12.0`)

Remarks

Mengembalikan nilai positif — ascent diukur ke atas dari baseline
Untuk tata letak yang setia secara tipografis gabungkan ascent dan descent alih-alih hanya memakai FontSize
Mengembalikan 0 ketika font tidak memiliki entri ascent atau ketika objek bukan teks — selalu lakukan penjagaan terhadap ini
Font CJK sering melaporkan ascent yang lebih tinggi daripada font Barat pada ukuran yang sama; jangan mengasumsikan metrik Latin berlaku
Indekser pertama properti cocok dengan indeks objek-halaman yang dipakai oleh FontHandle, bukan indeks karakter yang dipakai oleh Character

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 property