THPDFPage.WideTextOutBox Method
Unicode/CJK 対応の、複数行自動折り返しテキスト ボックス出力です(v2.217.0)。WideTextOutBox は TextOutBox の Unicode 版で、GetWideTextWidth による幅測定と WideChar インデックスによる WideString の分割により、CJK / サロゲート ペア / マルチバイト テキストも正しく折り返せます。戻り値は実際にボックスへ収まった WideChar の数です。折り返し規則: CJK 文字(漢字/仮名/ハングル/CJK 句読点/全角文字)は任意のグリフ間で折り返し、ラテン文字などはボックスの端より前の最後の空白/タブで折り返し、空白がなければボックスより広いグリフ列は強制切断されます。CR / LF / CRLF の改行はそのまま扱われます
宣言
function WideTextOutBox(X, Y, LineSpacing, BoxWidth, BoxHeight: Integer; Text: WideString; Align: THPDFJustificationType): Integer;ユニット
HPDFDoc
パラメータ
| 名前 | 目的 |
|---|---|
X | テキスト ボックス左上隅の X 座標(ユーザー空間単位) |
Y | テキスト ボックス左上隅の Y 座標(ユーザー空間単位) |
LineSpacing | 行間(ユーザー空間単位) |
BoxWidth | テキスト ボックスの幅(ユーザー空間単位) |
BoxHeight | テキスト ボックスの高さ(ユーザー空間単位) |
Text | 出力する Unicode テキスト |
Align | 配置(jtLeft、jtCenter、jtRight、jtJustified) |
戻り値
実際にテキスト ボックスへ収まった WideChar の数。元のテキスト長と比較して、すべて出力できたかを確認できます
使用上の注意
- 影響を受けるページ、リソース、フィールド、またはカタログオブジェクトが確定する前に、ページジオメトリワークフローでこの API を使用してください
- ドキュメントが確定するまで、オブジェクト名、フィールド名、リソース名、および返されるハンドルを安定させておいてください
- ページ レベルの変更は、同じページ上の後続のオペレーターに影響します。一時的な設定が漏洩しないように、グラフィックスの状態を保存および復元してください