SavePreflightReport
合規性、文件檢查
描述
以 CreatePreflightReport 建立純文字預檢報告,並寫入 UTF-8 文字檔。輸出目錄不存在時會自動建立。
語法
Delphi
Function TPDFlib.SavePreflightReport(Const InputFileName, Password, ReportFileName: WideString; ComplianceTests, Options: Integer): Integer;
參數
| InputFileName | 要驗證的 PDF 檔案完整路徑。 |
|---|---|
| Password | 開檔用的密碼。未加密文件請傳空字串。 |
| ReportFileName | 目的地文字報告路徑。上層目錄會自動建立;傳入空值會傳回 0。 |
| ComplianceTests | 選擇納入哪些檢查的位元遮罩:1 為 PDF/A,2 為 PDF/UA-1,3 或 0 為兩者。 |
| Options | 位元旗標,原樣傳給每個所選符合性檢查。傳 1 可讓每項檢查在第一個問題後停止。 |
傳回值
| 0 | 報告檔名為空。 |
|---|---|
| 1 | 報告產生並寫出成功。 |
備註
輸出需要 JSON、HTML 或 CSV 時,請用 SavePreflightReportEx。開檔、驗證或寫入錯誤會以例外形式從底層的檔案與符合性檢查路徑浮上來;命令列工具或服務需要行程層級結束代碼時,請包一層再呼叫。
範例
if PDF.SavePreflightReport('output.pdf', '', 'output-preflight.txt', 1 or 2, 0) = 1 then
WriteLn('Preflight report saved.');另見
Preflight Reports, SavePreflightReportEx, CreatePreflightReport, ComparePreflightReports, CheckFileCompliance, ReleaseStringList