如何用Apache POI向PPT模板的图片占位符添加图片？

你可以直接替换现有XSLFPictureShape的图片数据，无需删除原形状再重新创建，大幅简化代码流程：

核心实现思路 #

找到目标图片占位符形状后，直接调用XSLFPictureShape.setPictureData()方法替换其关联的图片数据，原形状的锚点、大小、样式等格式属性会自动保留，省去收集锚点、删除旧形状、创建新形状的冗余步骤。

简化后的代码示例 #

// 遍历幻灯片形状，定位目标图片占位符
for (XSLFShape sh : slide.getShapes()) {
    String name = sh.getShapeName();
    String placeholderName = export.getPlaceholderName();
    if (sh instanceof XSLFPictureShape && name.equalsIgnoreCase(placeholderName)) {
        XSLFPictureShape targetPicShape = (XSLFPictureShape) sh;
        // 加载新图片并获取PPT可识别的PictureData
        XSLFPictureData newPicData = ppt.addPicture(
            new FileInputStream("你的新图片路径.png"), 
            PictureData.PictureType.PNG
        );
        // 直接替换占位符的图片数据
        targetPicShape.setPictureData(newPicData);
    }
}

该方法的优势 #

• 代码更简洁：无需额外存储锚点、形状信息，减少中间变量和操作步骤
• 格式更稳定：完全保留原占位符的位置、大小、样式，避免重建形状时出现格式偏差
• 效率更高：减少幻灯片形状的增删操作，降低性能开销

注意：请确保使用Apache POI 4.1.0及以上版本，该版本开始支持XSLFPictureShape.setPictureData()方法。

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