Apache POI设置PPT形状Shrink text on overflow后不生效如何解决

问题原因 #

Apache POI仅负责写入Shrink text on overflow对应的属性标记，本身没有内置PowerPoint的文本排版渲染引擎，不会主动计算文本溢出后的收缩比例。这个缩放计算是PowerPoint客户端的原生逻辑，默认只有在形状被修改触发重排时才会执行，所以会出现属性已勾选但打开时文本溢出的情况。

可行解决方案 #

• 方案一：借助Office客户端的无头模式预处理
  生成PPT文件后，使用LibreOffice/OpenOffice的无头模式打开并重新保存文件，过程中会自动触发所有形状的文本重排逻辑，最终输出的文件打开时就能直接看到收缩后的文本效果。
  Windows下示例命令：

"C:\Program Files\LibreOffice\program\soffice.exe" --headless --convert-to pptx --outdir 输出目录 原文件路径

Linux下示例命令：

libreoffice --headless --convert-to pptx --outdir 输出目录 原文件路径

• 方案二：纯Java手动计算文本缩放比例，主动调整字号
  如果不想依赖外部工具，可以自己实现文本尺寸计算逻辑，在设置文本后判断是否溢出，主动缩小字号到适配大小，参考代码如下：

import java.awt.Font;
import java.awt.FontMetrics;
import java.awt.Graphics2D;
import java.awt.Rectangle;
import java.awt.image.BufferedImage;
import org.apache.poi.xslf.usermodel.*;

private void drawRectWithText(XSLFSlide slide, int x, int y, int width, int height, String text) {
    XSLFAutoShape shape1 = slide.createAutoShape();
    Rectangle rect1 = new Rectangle(x, y, width, height);
    shape1.setAnchor(rect1.getBounds2D());
    shape1.setShapeType(ShapeType.RECT);
    shape1.setTextDirection(TextDirection.HORIZONTAL);
    shape1.setVerticalAlignment(VerticalAlignment.MIDDLE);
    XSLFTextParagraph para = shape1.getTextParagraphs().get(0);
    para.setTextAlign(TextParagraph.TextAlign.CENTER);
    para.setFontAlign(FontAlign.AUTO);
    
    // 手动计算适配字号
    double defaultFontSize = 18; // 初始字号可自行调整
    // 计算形状可用区域（减去内边距，单位转换：磅转像素，默认96DPI）
    double availableWidth = (width - shape1.getPaddingLeft() - shape1.getPaddingRight()) * 96 / 72;
    double availableHeight = (height - shape1.getPaddingTop() - shape1.getPaddingBottom()) * 96 / 72;
    
    BufferedImage img = new BufferedImage(1, 1, BufferedImage.TYPE_INT_RGB);
    Graphics2D g2d = img.createGraphics();
    double currentFontSize = defaultFontSize;
    while (currentFontSize > 6) { // 最小字号限制，避免文本过小
        Font font = new Font("微软雅黑", Font.PLAIN, (int)Math.ceil(currentFontSize));
        FontMetrics metrics = g2d.getFontMetrics(font);
        int textWidth = metrics.stringWidth(text);
        int textHeight = metrics.getHeight();
        if (textWidth <= availableWidth && textHeight <= availableHeight) {
            break;
        }
        currentFontSize -= 0.5; // 每次缩小0.5磅，精度可自行调整
    }
    g2d.dispose();
    
    // 设置文本和适配后的字号
    XSLFTextRun run = para.addNewTextRun();
    run.setText(text);
    run.setFontSize(currentFontSize);
    
    // 保留自动适配属性，方便后续用户在PPT中编辑时自动调整
    shape1.setTextAutofit(TextAutofit.NORMAL);
}

内容的提问来源于stack exchange，提问作者Márk Farkas