如何在PowerPoint Office JS插件中复制形状对象？

核心问题解答 #

• 是否存在创建选中形状副本的API？
  有，PowerPoint Office-JS API 提供了 Shape.duplicate() 方法直接生成单个形状的副本，同时可通过 context.presentation.getSelectedShapes() 获取当前选中的所有形状集合。

• 如何复制形状对象？
  单个形状调用自身的 duplicate() 方法即可生成副本，副本默认会放置在原形状相邻位置；批量选中的形状，遍历选中集合逐个调用该方法即可完成批量复制。

• 任务窗格按钮触发复制的实现代码
  以下是点击任务窗格按钮复制选中形状（支持批量生成多份副本）的示例代码：

// 绑定任务窗格按钮点击事件
document.getElementById('copySelectedBtn').addEventListener('click', async () => {
  try {
    await Office.onReady();
    const pptCtx = Office.context;
    const selectedShapes = pptCtx.presentation.getSelectedShapes();
    
    pptCtx.load(selectedShapes);
    await pptCtx.sync();

    // 自定义需要复制的份数
    const copyTimes = 3;
    for (let i = 0; i < copyTimes; i++) {
      // 遍历所有选中形状逐个复制
      selectedShapes.items.forEach(shape => {
        shape.duplicate();
      });
      await pptCtx.sync();
    }

    console.log("形状复制完成");
  } catch (err) {
    console.error("复制失败：", err);
  }
});

额外说明 #

• 调用API前必须确保完成 Office.onReady() 初始化
• 复制后可通过返回的新Shape对象调整位置（left/top属性）、样式（填充、线条等）
• 组合形状（GroupShape）也支持 duplicate() 方法，会完整复制整个组合

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