THPDFRTFImportStatus Type
Reports how an RTF import finished, including the guard rail that stopped it
Declaration
THPDFRTFImportStatus= (risSuccess, risInvalidInput,
risDocumentNotReady, risWrongThread, risInputLimit,
risCharacterLimit, risPageLimit, risMetafileLimit,
risCancelled, risNoProgress, risRenderError);Unit
HPDFDoc
Values
| Value | Purpose |
|---|---|
risSuccess | The RTF source was fully converted and the resulting pages were added |
risInvalidInput | The RTF source is empty or cannot be parsed as RTF |
risDocumentNotReady | The target document was not in a state that accepts imported pages |
risWrongThread | The import was called from a thread that cannot run the VCL-based converter |
risInputLimit | The source exceeded MaxInputBytes from THPDFRTFImportOptions |
risCharacterLimit | The source exceeded the MaxCharacters limit |
risPageLimit | The converted output exceeded the MaxPages limit |
risMetafileLimit | A metafile embedded in the RTF exceeded MaxMetafileBytes |
risCancelled | The caller-supplied cancellation token fired during conversion |
risNoProgress | Metafile playback stopped making forward progress and the import aborted |
risRenderError | The metafile-to-page rendering step failed |
Usage notes
- The status lands in
THPDFRTFImportStatistics.Statusnext to counters such asPagesRenderedandMetafileBytes, which stay meaningful for partial results - Limit values (
risInputLimit,risCharacterLimit,risPageLimit,risMetafileLimit) map directly to the matching guard fields ofTHPDFRTFImportOptions - Check
risWrongThreadfirst in service scenarios, because RTF conversion uses VCL facilities that require the main thread