THPDFPage.GetWideTextWidth Method
回傳 Unicode 字串以目前字型 render 後的寬度,單位是 THotPDF.Resolution 的頁面單位(1/Resolution 英吋),與繪圖座標同一套單位。可用來對齊或折行 CJK、西里爾文或 surrogate pair 文字
寬度會計入目前的水平縮放、字元間距(SetCharacterSpacing,每個 glyph 計一次)與字間距(SetWordSpacing,每個空格計一次),因此與實際繪出的文字步進一致
宣告
function GetWideTextWidth(Text: WideString): Single;
單元
HPDFDoc
參數
| 名稱 | 說明 |
|---|---|
Text | 要測量的 Unicode 文字 |
回傳值
回傳以頁面單位表示的寬度
使用說明
- 在受影響的頁面、資源、欄位或目錄物件最終定案之前,請於頁面繪製工作流程中使用此 API
- 在檔案最終定案之前,請保持物件名稱、欄位名稱、資源名稱與傳回的控制代碼穩定不變
- 頁面層級的變更會影響同一頁面上後續的 operator;暫時性設定不應外溢時,請儲存並還原 graphics state