procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single。字型大小,以點為單位(例如 12.0 表示 12 pt 文字) |
| 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 字型的形式每份文件內嵌一次,並以碼點作為索引:字型涵蓋的每個 Unicode 字元都取得自己的 CID,帶有明確的 CIDToGIDMap 與一對一的 ToUnicode 項目,因此共用同一個字形的字元(空白與 U+00A0、連字號與 U+00AD、Omega 與歐姆符號)無論從活動中的文件還是儲存後的檔案擷取,都能得到當初寫入的字元。沒有 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);