When rendering pages in a PDF document, jPDFPrint and jPDFImages may run into errors. In this case, the libraries will render the page with a red X drawn across the page, together with a message explaining what failed, such as “Error Handling Page: Missing Font”.

Customers can choose to throw an exception instead, if they wish to handle errors differently in their application.

The API offers 2 options for error handling:

 
//Display the error in the rendering of the page and continue rendering other pages.
// this is the default option	
PDFErrorHandling.setErrorHandling(PDFErrorHandling.EH_SHOW_ERROR_AND_CONTINUE);
 
// Abort the entire rendering operation and throw an exception to the host application.
PDFErrorHandling.setErrorHandling(PDFErrorHandling.EH_ABORT_RENDERING);

The full path of the class is com.qoppa.pdf.errors.PDFErrorHandling.