THPDFRTFImportStatus 型
RTF インポートがどのように終わったかを報告します。停止させたガードレールも含みます
宣言
THPDFRTFImportStatus= (risSuccess, risInvalidInput,
risDocumentNotReady, risWrongThread, risInputLimit,
risCharacterLimit, risPageLimit, risMetafileLimit,
risCancelled, risNoProgress, risRenderError);ユニット
HPDFDoc
値
| 値 | 目的 |
|---|---|
risSuccess | RTF ソースが完全に変換され、結果のページが追加されました |
risInvalidInput | RTF ソースが空か、RTF として解析できません |
risDocumentNotReady | ターゲットドキュメントが、インポートページを受け付けられる状態ではありませんでした |
risWrongThread | VCL ベースのコンバータを実行できないスレッドから、インポートが呼ばれました |
risInputLimit | ソースが THPDFRTFImportOptions の MaxInputBytes を超えました |
risCharacterLimit | ソースが MaxCharacters 上限を超えました |
risPageLimit | 変換された出力が MaxPages 上限を超えました |
risMetafileLimit | RTF に埋め込まれたメタファイルが MaxMetafileBytes を超えました |
risCancelled | 呼び出し側が渡したキャンセルトークンが、変換中に発火しました |
risNoProgress | メタファイルの再生が前進しなくなり、インポートが中断されました |
risRenderError | メタファイルからページへの描画ステップが失敗しました |
使用上の注意
- ステータスは
THPDFRTFImportStatistics.Statusに入り、PagesRenderedやMetafileBytesといったカウンタと並びます。これらのカウンタは部分結果でも意味を保ちます - 上限系の値（
risInputLimit、risCharacterLimit、risPageLimit、risMetafileLimit）は、THPDFRTFImportOptionsの対応するガードフィールドに直接対応します - サービス系のシナリオではまず
risWrongThreadを確認してください。RTF 変換はメインスレッドを要求する VCL の機能を使うためです