PDFiumPas 文件

FontAscent 屬性

此 API 條目保留識別符號、簽名、程式碼塊和 PDF 術語的原始形式。
元件: TPdf  ·  單元: PDFium
傳回頁面物件字型的字型上緣（從基線到最高上升部的距離），以 PDF 點為單位並按呼叫端提供的字型大小縮放

語法

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

說明

FontAscent 會回報頁面物件在指定索引所參照字型的上緣量測值。上緣是從基線往上到字型最高字元所達到的最高位置之垂直距離（大寫字母、重音符號、以及像 'l'、'h'、'k' 這類上升部字元）。結果會以 PDF user-space 點表示，並已依你傳入的 FontSize 縮放

Index 索引器是 0 起算的頁面物件索引（0..ObjectCount - 1）。第二個索引器 FontSize 是要計算量測值時使用的 PDF 點大小。可傳入你預計實際繪製時的大小，或使用 CharacterFontSize[n] 來對應既有文字區段的大小。讀取此屬性時頁面必須為作用中狀態

搭配 FontDescent 可得出字型的總行高：LineHeight := FontAscent - FontDescent（descent 通常是負值）。當字型沒有這個量測值，或索引到的物件不是文字時，PDFium 會回傳 0

參數

Index0 起算的頁面物件索引，範圍為 0..ObjectCount - 1
FontSize用來縮放量測值的 PDF 點字型大小。通常是字型實際繪製時的大小，例如 10.0、12.0

備註

範例

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;

另請參閱

FontDescent, FontSize, FontHandle, FontFamilyName