THotPDF.SetLoadedFreeTextPlainText Method

把受支持的已加载 FreeText 注释显式转换为左对齐的纯文本，并重建其正常外观

声明

procedure SetLoadedFreeTextPlainText(PageIndex, AnnotationIndex: Integer;
  const AText: AnsiString; FontSize: Single = 12);

单元：HPDFDoc · 自版本 2.753.0 起可用

参数

• PageIndex：已加载页面的从零开始索引
• AnnotationIndex：该页面上从零开始的注释索引
• AText：可打印 ASCII 字符，用 CR、LF 或 CR/LF 表示显式换行；制表符、其他控制字符和非 ASCII 文本都会被拒绝
• FontSize：以 PDF 点为单位的有效大小，大于零且不超过 10,000，默认 12

外观转换

方法使用黑色 Helvetica 文本和黑色矩形边框，保留受支持的设备颜色背景以及实线或虚线边框几何，并把文本裁剪到注释矩形内缩两点的范围内

行按字体大小的 1.2 倍推进；没有自动换行或缩字适配，落在内缩范围之外的文本会被裁剪

转换会替换 /AP，更新 /Contents 和 /DA，把 /Q 置零，并移除 /RC、/DS 和 /AS；旧的富文本、字体选择、文本颜色、对齐方式和外观状态都会被有意替换

注释、外观和页面变更都会注册为增量保存，页面渲染缓存随之失效；重写保存同样会保留新外观

支持的输入与错误

注释必须存在且子类型为 FreeText，矩形必须为有限值，且宽和高都要大于四点

callout、矩形差异或内缩、边框效果、旋转条目、非 FreeText intent、非不透明注释、圆角边框，以及实线和虚线以外的边框样式都会被拒绝并抛出 EArgumentException

DeviceGray、DeviceRGB 和 DeviceCMYK 背景分量必须落在 0 到 1 之间；边框宽度和 dash pattern 必须有效、有限且非负，非空的全零 dash pattern 会被拒绝

不受支持的输入会在替换注释或其外观之前完成校验

示例

对于已加载的文档，当第 0 页上的第一个注释是受支持的 FreeText 注释时

PDF.SetLoadedFreeTextPlainText(0, 0,
  'Updated review note'#13#10'Second line', 12);

相关 API

SetLoadedAnnotationContents 只修改存储的 contents 字符串，并保留现有外观

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · 首页