THotPDF.SetLoadedFreeTextPlainText Method

把受支援的已載入 FreeText 註解明確轉換為靠左對齊的純文字,並重建其正常外觀

宣告

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

單元:HPDFDoc · 自版本 2.753.0 起可用

參數

外觀轉換

方法使用黑色 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 · 首頁