iText v5.6.xx中如何将签名的图形与描述改为上下布局？

算力阿峰

2026-7-26

实现数字签名的图片+描述上下布局方案

默认的RenderingMode.GRAPHIC_AND_DESCRIPTION预设模式确实是固定的左右分栏布局，要改成上下布局，你需要自定义签名外观的绘制逻辑，具体步骤如下：

放弃使用预设的GRAPHIC_AND_DESCRIPTION模式，将签名外观的渲染模式设置为RenderingMode.CUSTOM
手动控制签名区域内图片和描述文本的绘制位置，把图片放在签名区域上半部分，描述文本放在下半部分

以下是Java环境下的示例代码：

// 假设已初始化PdfSigner实例signer、签名图片文件路径imagePath、描述文本description
PdfSignatureAppearance appearance = signer.getSignatureAppearance();
// 设置为自定义渲染模式
appearance.setRenderingMode(RenderingMode.CUSTOM);

// 获取签名矩形区域参数
Rectangle signRect = appearance.getRect();
float rectWidth = signRect.getWidth();
float rectHeight = signRect.getHeight();
float rectLeft = signRect.getLeft();
float rectBottom = signRect.getBottom();

// 加载签名图片并绘制到区域上半部分（居中对齐）
ImageData imageData = ImageDataFactory.create(imagePath);
float imgWidth = imageData.getWidth();
float imgHeight = imageData.getHeight();
// 计算图片居中位置
float imgX = rectLeft + (rectWidth - imgWidth) / 2;
float imgY = rectBottom + rectHeight / 2;
// 获取签名外观画布并添加图片
PdfCanvas canvas = appearance.getLayer2();
canvas.addImage(imageData, imgX, imgY, imgWidth, false);

// 绘制描述文本到区域下半部分（居中对齐）
// 创建文本画布，限定在签名区域下半部分
Canvas textCanvas = new Canvas(canvas, new Rectangle(rectLeft, rectBottom, rectWidth, rectHeight / 2));
// 配置文本样式
Paragraph descPara = new Paragraph(description)
        .setTextAlignment(TextAlignment.CENTER)
        .setFontSize(10);
textCanvas.add(descPara);