FontAscent プロパティ

この API エントリでは識別子、シグネチャ、コードブロック、PDF 用語を元の表記のまま保持します。

page object の font の ascent (baseline から最も高い ascender までの距離) を返します。値は PDF point で表され、caller が渡した font size に合わせて scale されます

FontAscent は、指定 index の page object が参照する font の ascent metric を返します。ascent は baseline から font の最も高い文字 (大文字、accent、'l', 'h', 'k' のような ascender) の先端までの垂直距離です。結果は PDF user-space point で返され、FontSize に合わせてすでに scale されています

Index indexer は 0 基準の page-object index です (ObjectCount - 1 まで)。2 つ目の indexer である FontSize は、metric を計算する PDF point の size です。実際に render したい size を渡すか、CharacterFontSize[n] を使って既存の text run に合わせてください。property を読むときは page が active である必要があります

FontDescent と合わせると font の総 line height が分かります。LineHeight := FontAscent - FontDescent です (descent は通常 negative です)。font に metric がないか、index した object が text でないとき、PDFium は 0 を返します

• 正の値を返します。ascent は baseline から上向きに測ります
• typographically faithful な layout には、FontSize だけでなく ascent と descent の両方を使ってください
• font に ascent entry がないか object が text でないときは 0 を返します。必ずこれに備えてください
• CJK font は同じ size でも Western font より高い ascent を返すことがよくあります。Latin の metric がそのまま当てはまるとは限りません
• property の最初の indexer は FontHandle で使う page-object index に対応しており、Character の character index ではありません

FontDescent, FontSize, FontHandle, FontFamilyName