procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single。ポイント単位のフォントサイズ (12 pt のテキストなら 12.0 など) |
| Color | TColor。テキストの塗りつぶし色。デフォルトは clBlack |
| Alpha | Byte。テキストの不透明度。$00 が完全な透明、$FF が完全な不透明です。デフォルトは $FF |
| Angle | Double。度単位の回転角。正の X 軸から反時計回りに測ります。デフォルトは 0.0 (水平) |
AddText は、指定されたフォントとサイズで Unicode テキスト文字列を現在の PDF ページに描画します。位置 (X, Y) は最初の文字のベースライン原点で、ページの左下コーナーを原点として PDF ユーザー単位 (左下原点、Y は上向きに増加) で測られます
フォントは PostScript 名またはファミリー名 (例: 'Arial'、'Times New Roman') で指定します。フォントはシステムで利用可能か、ドキュメントに埋め込まれている必要があります。PDFium が要求されたフォントを見つけられない場合は、デフォルトのフォントに置き換えられます
Color と Alpha パラメーターでテキストの塗りつぶしの外観を制御します。Alpha を $FF 未満にすると半透明のテキストを描画できます。Angle パラメーターは、テキスト文字列全体をベースライン原点の周りで反時計回りに回転します
このメソッドはテキストを新しいページオブジェクトとして追加します。追加済みの既存テキストオブジェクトの内容を変更するには、SetText を使用します
システムフォントは、コードポイントをキーにした CID フォントとしてドキュメントごとに 1 回埋め込まれます。フォントがカバーするすべての Unicode 文字に固有の CID が割り当てられ、明示的な CIDToGIDMap と 1 対 1 の ToUnicode エントリが付くため、同じグリフを共有する文字（スペースと U+00A0、ハイフンと U+00AD、オメガとオーム記号）でも、書き込まれた文字そのままが抜き取れます。表示中のドキュメントでも保存後のファイルでも同様です。Unicode の cmap サブテーブルを持たないフォントは、従来のグリフキー方式の埋め込みにフォールバックします
ネイティブ Free Pascal/LCL は Linux の fontconfig、macOS の CoreText でシステムのフォントファイルを解決します。ファイルの上限は 64 MiB です。要求したフォントファミリーがない場合はプラットフォームの代替ファミリーを選ぶことがあります。検索の成功は、すべての Unicode 文字に対応する保証にはなりません
// Add a title string near the top of an A4 page
// A4 page height = 841.89 pt; place text 50 pt from the top
Pdf1.NewPage(595, 842);
Pdf1.AddText('Hello, PDFium Delphi Component!', 'Arial', 24, 72, 768);
// Red text at 45 degrees with 50% opacity
Pdf1.AddText('Rotated', 'Arial', 18, 200, 400, clRed, $80, 45);