Legacy notice!

iText 5 is the previous major version of iText's leading PDF SDK. iText 5 has been EOL, and is no longer developed. Switch your project to iText 7, integrating the latest developments.
Check related iText 7 content!

I am currently using iText to generate PDF reports. I want to set a medium size image as a background in PdfPCell instead of using background color. Is this possible?

Posted on StackOverflow on Jun 11, 2014 by user1283475

You need to create your own implementation of the PdfPCellEvent interface, for instance:

class ImageBackgroundEvent implements PdfPCellEvent {

    protected Image image;

    public ImageBackgroundEvent(Image image) {
        this.image = image;

    public void cellLayout(PdfPCell cell, Rectangle position,
            PdfContentByte[] canvases) {
        try {
            PdfContentByte cb = canvases[PdfPTable.BACKGROUNDCANVAS];
            image.setAbsolutePosition(position.getLeft(), position.getBottom());
        } catch (DocumentException e) {
            throw new ExceptionConverter(e);

Then you need to create an instance of this event and declare it to the cell that needs this background:

Image image = Image.getInstance(IMG1);
cell.setCellEvent(new ImageBackgroundEvent(image));

Take a look at the ImageBackground example for the full code.