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 表示明確換行;Tab 字元、其他控制字元與非 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 · 首頁