iText 2中PdfPCell内图片与文本的垂直居中对齐问题

我来帮你搞定这个iText里PdfPCell图片和文本垂直居中的问题！你遇到的核心问题是：当图片尺寸大于文本字体时，iText默认会把文本放在基线底部，单纯调整单元格的垂直对齐不会生效——因为单元格对齐是针对整个内容块，而内容块里的图片和文本是默认按基线对齐的，得从元素组合的层面来调整。

下面给你两种实用的解决方案：

方法一：通过Chunk文本偏移实现精准对齐 #

这种方法适合布局简单的场景，通过计算图片和文本的高度差，调整文本的偏移量让它和图片垂直居中：

PdfPCell getImageAndText(byte[] image, String text, int originalDimension) {
    // 处理图片并调整尺寸
    Image img = Image.getInstance(image);
    img.scaleToFit(originalDimension, originalDimension);
    float imgHeight = img.getScaledHeight();
    
    // 计算文本的高度和偏移量
    Font font = new Font(Font.FontFamily.HELVETICA, 12); // 可根据实际需求修改字体大小
    float textAscent = font.getBaseFont().getAscentPoint(text, font.getSize());
    float textDescent = font.getBaseFont().getDescentPoint(text, font.getSize());
    float textHeight = textAscent - textDescent;
    // 计算文本需要向上偏移的距离，让它和图片垂直居中
    float offsetY = (imgHeight - textHeight) / 2 - textDescent;
    
    // 创建图片和文本的Chunk对象
    Chunk imgChunk = new Chunk(img, 0, 0);
    Chunk textChunk = new Chunk(text, font);
    textChunk.setTextRise(offsetY); // 设置文本上升偏移
    
    // 组合成Phrase并放入单元格
    Phrase phrase = new Phrase();
    phrase.add(imgChunk);
    phrase.add(new Chunk(" ")); // 图片和文本之间添加空格分隔
    phrase.add(textChunk);
    
    PdfPCell cell = new PdfPCell(phrase);
    cell.setVerticalAlignment(Element.ALIGN_MIDDLE);
    cell.setHorizontalAlignment(Element.ALIGN_LEFT); // 可根据需求调整水平对齐方式
    return cell;
}

关键说明： #

• 这里利用setTextRise()方法调整文本相对于基线的位置，通过计算图片高度与文本高度的差值，让文本刚好和图片垂直居中。
• 要注意字体的Ascent（基线到文本顶部的距离）和Descent（基线到文本底部的距离），偏移量需要减去Descent才能让文本真正居中。

方法二：嵌套PdfPTable实现灵活布局 #

如果需要更灵活的布局控制（比如调整图片和文本的宽度比例），推荐用嵌套小表格的方式，把图片和文本分别放在独立的单元格里，直接设置单元格垂直对齐即可：

PdfPCell getImageAndText(byte[] image, String text, int originalDimension) {
    // 创建1行2列的嵌套表格
    PdfPTable nestedTable = new PdfPTable(2);
    nestedTable.setWidths(new float[]{1, 3}); // 调整列宽比例，可根据需求修改
    nestedTable.setSpacingBefore(0);
    nestedTable.setSpacingAfter(0);
    nestedTable.setWidthPercentage(100);
    
    // 图片单元格
    Image img = Image.getInstance(image);
    img.scaleToFit(originalDimension, originalDimension);
    PdfPCell imgCell = new PdfPCell(img);
    imgCell.setVerticalAlignment(Element.ALIGN_MIDDLE);
    imgCell.setBorder(Rectangle.NO_BORDER); // 去掉边框避免和外层单元格冲突
    nestedTable.addCell(imgCell);
    
    // 文本单元格
    PdfPCell textCell = new PdfPCell(new Phrase(text));
    textCell.setVerticalAlignment(Element.ALIGN_MIDDLE);
    textCell.setBorder(Rectangle.NO_BORDER);
    nestedTable.addCell(textCell);
    
    // 外层单元格
    PdfPCell outerCell = new PdfPCell(nestedTable);
    outerCell.setVerticalAlignment(Element.ALIGN_MIDDLE);
    return outerCell;
}

关键说明： #

• 嵌套表格的方式把图片和文本隔离在各自的单元格中，每个单元格的setVerticalAlignment(Element.ALIGN_MIDDLE)可以直接生效，不需要复杂的计算。
• 通过setWidths()可以轻松调整图片和文本的宽度占比，布局更灵活。

这两种方法都能解决你遇到的问题，你可以根据实际需求选择适合的方案~

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