Pdftools SDK
Loading...
Searching...
No Matches
PdfTools_PdfToolsPdfAValidation.h
Go to the documentation of this file.
1/******************************************************************************
2 *
3 * File: PdfTools_PdfToolsPdfAValidation.h
4 *
5 * Description: Sub Header file for Pdftools SDK
6 *
7 * Author: PDF Tools AG
8 *
9 * Copyright: Copyright (C) 2023 - 2024 PDF Tools AG, Switzerland
10 * All rights reserved.
11 *
12 * Notice: By downloading and using this artifact, you accept PDF Tools AG's
13 * [license agreement](https://www.pdf-tools.com/license-agreement/),
14 * [privacy policy](https://www.pdf-tools.com/privacy-policy/),
15 * and allow PDF Tools AG to track your usage data.
16 *
17 *****************************************************************************/
18
19#ifndef PDFTOOLS_PDFTOOLSPDFAVALIDATION_H__
20#define PDFTOOLS_PDFTOOLSPDFAVALIDATION_H__
21
22#ifndef PDFTOOLS_CALL
23#if defined(WIN32)
24#define PDFTOOLS_CALL __stdcall
25#else
26#define PDFTOOLS_CALL
27#endif
28#endif
29
30#include "PdfTools_Types.h"
32
33#ifdef __cplusplus
34extern "C"
35{
36#endif
37
38#ifdef _UNICODE
39#define TPdfToolsPdfAValidation_Validator_Error TPdfToolsPdfAValidation_Validator_ErrorW
40#define PdfToolsPdfAValidation_Validator_AddErrorHandler PdfToolsPdfAValidation_Validator_AddErrorHandlerW
41#define PdfToolsPdfAValidation_Validator_RemoveErrorHandler PdfToolsPdfAValidation_Validator_RemoveErrorHandlerW
42
43#else
44#define TPdfToolsPdfAValidation_Validator_Error TPdfToolsPdfAValidation_Validator_ErrorA
45#define PdfToolsPdfAValidation_Validator_AddErrorHandler PdfToolsPdfAValidation_Validator_AddErrorHandlerA
46#define PdfToolsPdfAValidation_Validator_RemoveErrorHandler PdfToolsPdfAValidation_Validator_RemoveErrorHandlerA
47
48#endif
49
74typedef void(PDFTOOLS_CALL* TPdfToolsPdfAValidation_Validator_ErrorA)(void* pContext, const char* szDataPart,
75 const char* szMessage,
77 const char* szContext, int iPageNo,
78 int iObjectNo);
103typedef void(PDFTOOLS_CALL* TPdfToolsPdfAValidation_Validator_ErrorW)(void* pContext, const WCHAR* szDataPart,
104 const WCHAR* szMessage,
106 const WCHAR* szContext, int iPageNo,
107 int iObjectNo);
108
109/******************************************************************************
110 * Validator
111 *****************************************************************************/
168
178
232
233/******************************************************************************
234 * ValidationOptions
235 *****************************************************************************/
246
299 TPdfToolsPdfAValidation_ValidationOptions* pValidationOptions, const TPdfToolsPdf_Conformance* pConformance);
300
301/******************************************************************************
302 * ValidationResult
303 *****************************************************************************/
339
340/******************************************************************************
341 * AnalysisOptions
342 *****************************************************************************/
352
449 TPdfToolsPdfAValidation_AnalysisOptions* pAnalysisOptions, BOOL bStrictMode);
450
451/******************************************************************************
452 * AnalysisResult
453 *****************************************************************************/
592
593#ifdef __cplusplus
594}
595#endif
596
597#endif /* PDFTOOLS_PDFTOOLSPDFAVALIDATION_H__ */
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisResult_GetHasEmbeddedFiles(TPdfToolsPdfAValidation_AnalysisResult *pAnalysisResult)
Whether the document contains embedded files.
PDFTOOLS_EXPORT TPdfToolsPdf_Conformance PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisResult_GetRecommendedConformance(TPdfToolsPdfAValidation_AnalysisResult *pAnalysisResult)
The recommended conversion conformance The optimal PDF/A conformance for the conversion (i....
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisOptions_SetConformance(TPdfToolsPdfAValidation_AnalysisOptions *pAnalysisOptions, TPdfToolsPdf_Conformance iConformance)
The PDF/A conformance to validate.
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_ValidationOptions_SetConformance(TPdfToolsPdfAValidation_ValidationOptions *pValidationOptions, const TPdfToolsPdf_Conformance *pConformance)
The conformance to be validated.
PDFTOOLS_EXPORT TPdfToolsPdf_Conformance PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisResult_GetConformance(TPdfToolsPdfAValidation_AnalysisResult *pAnalysisResult)
The conformance used for analysis.
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisOptions_GetStrictMode(TPdfToolsPdfAValidation_AnalysisOptions *pAnalysisOptions)
Whether to enable additional, strict validation checks.
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_Validator_AddErrorHandlerA(TPdfToolsPdfAValidation_Validator *pValidator, void *pContext, TPdfToolsPdfAValidation_Validator_ErrorA pFunction)
Adds event handler.
void(PDFTOOLS_CALL * TPdfToolsPdfAValidation_Validator_ErrorW)(void *pContext, const WCHAR *szDataPart, const WCHAR *szMessage, TPdfToolsPdfAValidation_ErrorCategory iCategory, const WCHAR *szContext, int iPageNo, int iObjectNo)
Definition PdfTools_PdfToolsPdfAValidation.h:103
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisResult_IsSigned(TPdfToolsPdfAValidation_AnalysisResult *pAnalysisResult)
Whether the document is digitally signed.
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_Validator_AddErrorHandlerW(TPdfToolsPdfAValidation_Validator *pValidator, void *pContext, TPdfToolsPdfAValidation_Validator_ErrorW pFunction)
Adds event handler.
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisOptions_SetStrictMode(TPdfToolsPdfAValidation_AnalysisOptions *pAnalysisOptions, BOOL bStrictMode)
Whether to enable additional, strict validation checks.
PDFTOOLS_EXPORT TPdfToolsPdfAValidation_AnalysisResult *PDFTOOLS_CALL PdfToolsPdfAValidation_Validator_Analyze(TPdfToolsPdfAValidation_Validator *pValidator, TPdfToolsPdf_Document *pDocument, TPdfToolsPdfAValidation_AnalysisOptions *pOptions)
Analyze a PDF document in preparation for its conversion to PDF/A. This method validates the document...
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_Validator_RemoveErrorHandlerA(TPdfToolsPdfAValidation_Validator *pValidator, void *pContext, TPdfToolsPdfAValidation_Validator_ErrorA pFunction)
Removes event handler.
PDFTOOLS_EXPORT TPdfToolsPdf_Conformance PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisOptions_GetConformance(TPdfToolsPdfAValidation_AnalysisOptions *pAnalysisOptions)
The PDF/A conformance to validate.
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_Validator_RemoveErrorHandlerW(TPdfToolsPdfAValidation_Validator *pValidator, void *pContext, TPdfToolsPdfAValidation_Validator_ErrorW pFunction)
Removes event handler.
PDFTOOLS_EXPORT int PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisResult_GetFontCount(TPdfToolsPdfAValidation_AnalysisResult *pAnalysisResult)
The number of fonts used in the document.
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisResult_IsConversionRecommended(TPdfToolsPdfAValidation_AnalysisResult *pAnalysisResult)
Whether the document should be converted to PDF/A.
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_ValidationResult_IsConforming(TPdfToolsPdfAValidation_ValidationResult *pValidationResult)
Whether the document is conforming Whether the document conforms to all standards referenced to the P...
PDFTOOLS_EXPORT TPdfToolsPdfAValidation_ValidationResult *PDFTOOLS_CALL PdfToolsPdfAValidation_Validator_Validate(TPdfToolsPdfAValidation_Validator *pValidator, TPdfToolsPdf_Document *pDocument, TPdfToolsPdfAValidation_ValidationOptions *pOptions)
Validate the standards conformance of a PDF document.
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_ValidationOptions_GetConformance(TPdfToolsPdfAValidation_ValidationOptions *pValidationOptions, TPdfToolsPdf_Conformance *pConformance)
The conformance to be validated.
PDFTOOLS_EXPORT TPdfToolsPdfAValidation_ValidationOptions *PDFTOOLS_CALL PdfToolsPdfAValidation_ValidationOptions_New(void)
#define PDFTOOLS_CALL
Definition PdfTools_PdfToolsPdfAValidation.h:26
PDFTOOLS_EXPORT BOOL PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisResult_IsConforming(TPdfToolsPdfAValidation_AnalysisResult *pAnalysisResult)
Whether the document is conforming Whether the document conforms to the PdfToolsPdfAValidation_Analys...
PDFTOOLS_EXPORT TPdfToolsPdfAValidation_Validator *PDFTOOLS_CALL PdfToolsPdfAValidation_Validator_New(void)
void(PDFTOOLS_CALL * TPdfToolsPdfAValidation_Validator_ErrorA)(void *pContext, const char *szDataPart, const char *szMessage, TPdfToolsPdfAValidation_ErrorCategory iCategory, const char *szContext, int iPageNo, int iObjectNo)
Definition PdfTools_PdfToolsPdfAValidation.h:74
PDFTOOLS_EXPORT TPdfToolsPdfAValidation_AnalysisOptions *PDFTOOLS_CALL PdfToolsPdfAValidation_AnalysisOptions_New(void)
PDFTOOLS_EXPORT TPdfToolsPdf_Conformance PDFTOOLS_CALL PdfToolsPdfAValidation_ValidationResult_GetConformance(TPdfToolsPdfAValidation_ValidationResult *pValidationResult)
The validated conformance.
#define PDFTOOLS_EXPORT
Definition PdfTools_Platform.h:143
unsigned short WCHAR
Definition PdfTools_Platform.h:95
TPdfToolsPdf_Conformance
Definition PdfTools_Types.h:198
TPdfToolsPdfAValidation_ErrorCategory
The validation error category.
Definition PdfTools_Types.h:532
#define BOOL
Definition PdfTools_Types.h:23
The PDF document PDF documents are either opened using PdfToolsPdf_Document_Open or the result of an ...
The PDF/A analysis options Options for the analysis of documents using the validator's method PdfTool...
The PDF/A analysis result.
The PDF validation options Options to check the quality and standard conformance of documents using t...
The PDF validation result Result of the validator's method PdfToolsPdfAValidation_Validator_Validate.
The class to validate the standard conformance of documents.