FontWeight プロパティ

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

現在 page の page object で使われている font の CSS-style weight (boldness) を返します。典型値は regular が 400、bold が 700 です

FontWeight は、指定した index の page object が参照する font の weight class を返します。CSS / OpenType の convention に合わせて、100 (Thin) から 900 (Black) までを扱い、400 は Regular、700 は Bold です。値は embedded font descriptor から、non-embedded font では PDFium の substitution table から導かれます

index は 0-based の page object index で、範囲は 0 から ObjectCount - 1 です。意味のある weight を持つのは text object だけで、non-text object を問い合わせると 0 を返します。page object の font dictionary ではなく抽出した個々の character に結びつく weight が必要な場合は CharacterFontWeight を使ってください

page は active (PageNumber が設定済み) でなければなりません。weight は FontHandle で得た font handle から decode され、font 自体が weight を宣言していない場合は PDFium も 0 を返し、この property も同じです

• Standard mapping: 100 Thin, 200 ExtraLight, 300 Light, 400 Regular, 500 Medium, 600 SemiBold, 700 Bold, 800 ExtraBold, 900 Black.
• page object が text でないとき、font handle が無効なとき、または weight が encode されていないときは 0 を返します
• The visual boldness ultimately seen on screen also depends on synthesized bolding flags inside the font dictionary — weight alone is not always the full story.
• Many embedded subset fonts encode a single weight even though the source family ships several — do not assume the document includes 100/200/etc. just because a 700 was reported.
• For the weight associated with a specific extracted character (text-page index), call CharacterFontWeight instead.

CharacterFontWeight, FontFamilyName, FontItalicAngle, FontHandle, ObjectCount