iText 7：添加页眉Div/Paragraph如何避免与页面内容重叠？

Hi Michail, let's tackle this problem step by step! I've worked with iText 7 on similar dynamic header scenarios, so I can help you fix the overlap issue and optimize your implementation.

Why the Content Overlap Happens #

Your current code correctly handles drawing different headers for page 1 vs. other pages, but it misses a critical piece: dynamic page margin adjustment. iText uses a default set of margins for all pages by default, so content on pages 2+ still flows into the top area where you're drawing the custom header—hence the overlap.

Step-by-Step Solutions #

1. Add Dynamic Page Margin Handling #

First, we'll create an event handler to set different margins for page 1 vs. subsequent pages. This ensures content stays within a safe area below your header.

public class PageMarginEventHandler implements IEventHandler {
    @Override
    public void handleEvent(Event event) {
        PdfDocumentEvent docEvent = (PdfDocumentEvent) event;
        PdfDocument pdfDoc = docEvent.getDocument();
        PdfPage page = docEvent.getPage();
        int pageNumber = pdfDoc.getPageNumber(page);
        
        // Get or initialize the margin-aware renderer
        MarginDocumentRenderer renderer = (MarginDocumentRenderer) pdfDoc.getRenderer();
        if (renderer == null) {
            renderer = new MarginDocumentRenderer(new Document(pdfDoc));
            pdfDoc.setRenderer(renderer);
        }
        
        if (pageNumber == 1) {
            // Adjust first page margins to fit your custom starting table
            renderer.setMargins(50, 30, 30, 30);
        } else {
            // Reserve enough top margin for your 200px tall header + extra spacing
            renderer.setMargins(250, 30, 30, 30);
        }
        
        // Update the page crop box to enforce margins
        Rectangle pageSize = page.getPageSize();
        Rectangle cropBox = pageSize.applyMargins(
            renderer.getTopMargin(),
            renderer.getRightMargin(),
            renderer.getBottomMargin(),
            renderer.getLeftMargin(),
            false
        );
        page.setCropBox(cropBox);
    }
}

2. Adjust Header Position to Match Margins #

Modify your existing VariableHeaderEventHandler to draw the header exactly within the reserved top margin area. This ensures no overlap with the main content.

public class VariableHeaderEventHandler implements IEventHandler {
    @Override
    public void handleEvent(Event event) {
        PdfDocumentEvent documentEvent = (PdfDocumentEvent) event;
        PdfDocument pdfDoc = documentEvent.getDocument();
        PdfPage page = documentEvent.getPage();
        int pageNumber = pdfDoc.getPageNumber(page);
        
        if (pageNumber == 1) return;
        
        Rectangle pageSize = page.getPageSize();
        // Calculate header position to fit within the 250px top margin
        // (30px top padding + 200px header height = 230px from page top)
        Rectangle rectangle = new Rectangle(
            pageSize.getLeft() + 30,
            pageSize.getHeight() - 230,
            pageSize.getWidth() - 60,
            200
        );
        
        PdfCanvas pdfCanvas = new PdfCanvas(page.newContentStreamBefore(), page.getResources(), pdfDoc);
        pdfCanvas.rectangle(rectangle);
        pdfCanvas.setFontAndSize(FontsAndStyles.getRegularFont(), 10);
        
        Canvas canvas = new Canvas(pdfCanvas, pdfDoc, rectangle);
        Div header = new Div();
        
        // Build your header content (reusing your original text)
        Paragraph paragraph = new Paragraph();
        Text text = new Text("Διαγνωστικό Εργαστήριο Ιστοπαθολογίας και Μοριακής Παθολογοανατομικής")
            .addStyle(FontsAndStyles.getBoldStyle());
        paragraph.add(text);
        paragraph.add("\n");
        
        text = new Text("Μοριακή Διάγνωση σε Συνεργασία με").addStyle(FontsAndStyles.getBoldStyle());
        paragraph.add(text);
        paragraph.add("\n");
        
        text = new Text("Γκούρβας Βίκτωρας, M.D., Ph.D.").addStyle(FontsAndStyles.getBoldStyle());
        paragraph.add(text);
        paragraph.add("\n");
        
        text = new Text("Τσιμισκή 33, Τ.Κ. 54624, ΘΕΣΣΑΛΟΝΙΚΗ").addStyle(FontsAndStyles.getNormalStyle());
        paragraph.add(text);
        paragraph.add("\n");
        
        text = new Text("Τήλ/Φάξ: 2311292924 Κιν.: 6932104909 e-mail: vgourvas@gmail.com").addStyle(FontsAndStyles.getNormalStyle());
        paragraph.add(text);
        
        header.add(paragraph);
        
        // Add bold horizontal line
        SolidLine solidLine = new SolidLine((float) 1.5);
        header.add(new LineSeparator(solidLine));
        
        // Add final header text
        text = new Text("ΠΑΘΟΛΟΓΟΑΝΑΤΟΜΙΚΗ ΕΞΕΤΑΣΗ").addStyle(FontsAndStyles.getBoldStyle());
        paragraph = new Paragraph().add(text);
        header.add(paragraph);
        
        header.setTextAlignment(TextAlignment.CENTER);
        canvas.add(header);
        canvas.close();
    }
}

3. Register Both Event Handlers #

Finally, hook up both event handlers when initializing your PDF document:

PdfWriter writer = new PdfWriter("lab_report.pdf");
PdfDocument pdfDoc = new PdfDocument(writer);
Document doc = new Document(pdfDoc);

// Register margin handler (runs when a page starts)
pdfDoc.addEventHandler(PdfDocumentEvent.START_PAGE, new PageMarginEventHandler());
// Register header handler (runs when a page ends)
pdfDoc.addEventHandler(PdfDocumentEvent.END_PAGE, new VariableHeaderEventHandler());

// Add your first page's custom table content here
// ...

// Add remaining report content here
// ...

doc.close();

Quick Answers to Your Questions #

• Is my implementation correct? Your core logic (using event handlers to draw different headers per page) is solid, but you missed adjusting margins to reserve space for the header—this was the root cause of overlap.
• Is there a better way? This event-based approach is the most flexible for dynamic headers in iText 7. For even cleaner code, you could:
  • Extract header content into a reusable method or component
  • Pre-render the header as a PdfFormXObject template to improve performance for multi-page reports

内容的提问来源于stack exchange，提问作者mixtou