如何使用Apache POI在PPT表格单元格中插入图片？

一、手动操作（Office PowerPoint） #

• 设置单元格背景图：
  1. 右键目标单元格 → 设置形状格式
  2. 在右侧面板选择「填充」→ 「图片或纹理填充」
  3. 点击「文件」选择图片，可调整透明度、平铺选项来适配单元格
• 插入图片到单元格内部：
  1. 选中目标单元格，切换到「插入」选项卡插入图片
  2. 右键图片 → 置于底层 → 「置于单元格下方」
  3. 用「裁剪」功能匹配单元格边界，或通过「图片格式」→「对齐」→「对齐单元格」快速适配

二、VBA自动化批量处理 #

设置单元格背景图 #

Sub SetTableCellBackgroundImage()
    Dim tbl As Table
    Dim cell As Cell
    Dim imgPath As String
    
    Set tbl = ActiveWindow.Selection.ShapeRange(1).Table ' 运行前选中目标表格
    imgPath = "C:\your-image.png" ' 替换为实际图片路径
    
    Set cell = tbl.Cell(2, 3) ' 目标单元格：第2行第3列
    With cell.Shape.Fill
        .UserPicture imgPath
        .TextureTile = msoFalse ' 图片自适应单元格，不平铺
    End With
End Sub

嵌入图片到单元格 #

Sub InsertImageIntoTableCell()
    Dim tbl As Table
    Dim cell As Cell
    Dim img As Shape
    Dim imgPath As String
    
    Set tbl = ActiveWindow.Selection.ShapeRange(1).Table
    imgPath = "C:\your-image.png"
    
    Set cell = tbl.Cell(2, 3)
    ' 在单元格范围内插入尺寸匹配的图片
    Set img = ActivePresentation.Slides(tbl.Parent.Slide.SlideIndex).Shapes.AddPicture( _
        Filename:=imgPath, LinkToFile:=msoFalse, SaveWithDocument:=msoTrue, _
        Left:=cell.Left, Top:=cell.Top, Width:=cell.Width, Height:=cell.Height)
    
    img.ZOrder msoSendBehindText ' 将图片置于单元格下方，避免遮挡内容
End Sub

三、Python自动化（python-pptx库） #

设置单元格背景图 #

from pptx import Presentation

prs = Presentation("your-presentation.pptx")
slide = prs.slides[0]
table = slide.shapes[0].table  # 假设第一个形状是目标表格

# 定位目标单元格（索引从0开始，示例为第2行第3列）
cell = table.cell(1, 2)
fill = cell.fill
fill.user_picture("your-image.png")  # 设置图片填充
fill.tile = False  # 关闭平铺，自适应单元格

prs.save("output.pptx")

嵌入图片到单元格 #

from pptx import Presentation

prs = Presentation("your-presentation.pptx")
slide = prs.slides[0]
table = slide.shapes[0].table

cell = table.cell(1, 2)
# 获取单元格的位置与尺寸参数
left, top, width, height = cell.left, cell.top, cell.width, cell.height

# 插入匹配尺寸的图片
pic = slide.shapes.add_picture(
    "your-image.png", left, top, width=width, height=height
)
pic.zorder = -1  # 将图片置于底层，避免遮挡单元格

prs.save("output.pptx")

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