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);