如何使用Office JS获取Excel活动单元格中的图片数量

因为Office JS没有直接提供“绑定单元格与图片”的API，我们可以通过匹配图片位置坐标和单元格范围的方式统计目标单元格内的图片数量，保存重开后依然有效。

实现步骤与代码 #

async function countImagesInActiveCell() {
  try {
    // 1. 获取活动单元格的位置与尺寸信息
    const activeCellInfo = await Excel.run(async (context) => {
      const activeCell = context.workbook.getActiveCell();
      activeCell.load("top, left, width, height, address");
      await context.sync();
      return {
        top: activeCell.top,
        left: activeCell.left,
        right: activeCell.left + activeCell.width,
        bottom: activeCell.top + activeCell.height,
        address: activeCell.address
      };
    });

    // 2. 获取当前工作表的所有图片形状
    const allShapes = await Excel.run(async (context) => {
      const worksheet = context.workbook.worksheets.getActiveWorksheet();
      const shapes = worksheet.shapes;
      shapes.load("items/top, items/left, items/width, items/height");
      await context.sync();
      return shapes.items;
    });

    // 3. 遍历图片，判断是否位于目标单元格范围内
    let imageCount = 0;
    for (const shape of allShapes) {
      // 仅统计图片类型的形状，排除文本框、图表等
      if (shape.type === Excel.ShapeType.image) {
        // 以图片中心坐标判断是否归属目标单元格
        const shapeCenterX = shape.left + shape.width / 2;
        const shapeCenterY = shape.top + shape.height / 2;

        const isInCell = 
          shapeCenterX >= activeCellInfo.left && 
          shapeCenterX <= activeCellInfo.right && 
          shapeCenterY >= activeCellInfo.top && 
          shapeCenterY <= activeCellInfo.bottom;

        if (isInCell) {
          imageCount++;
        }
      }
    }

    console.log(`活动单元格 ${activeCellInfo.address} 内共有 ${imageCount} 张图片`);
    return imageCount;
  } catch (error) {
    console.error("统计图片数量出错：", error);
  }
}

// 调用统计函数
countImagesInActiveCell();

关键说明 #

• 仅筛选ShapeType.image类型的形状，避免误统计非图片元素
• 采用图片中心坐标判断归属：若你的图片是完全嵌入单元格内，该逻辑足够准确；若存在图片部分超出单元格的场景，可调整为判断图片左上角是否在单元格范围内
• 保存重开后，Excel会保留形状的位置坐标，因此该逻辑依然生效

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