如何在OpenXML的POTX中存储PowerPoint形状并从VSTO加载项调用

一、POTX中存储自定义形状的正确姿势 #

别用CustomXMLPart存形状本身——形状是OpenXML的原生元素，直接放到POTX的隐藏幻灯片或者母版自定义布局里更靠谱：

• 隐藏幻灯片方案：在POTX里新增一张隐藏幻灯片，把要保存的手动创建形状复制到这张幻灯片上，后续直接读取这张幻灯片的形状节点。
• 母版布局方案：把形状添加到母版的某个自定义布局中，给形状加唯一标识（比如Name属性或自定义扩展节点），方便后续精准查找。

二、用OpenXML写入形状到POTX的核心代码 #

// 打开POTX模板文件
using (var presentationDoc = PresentationDocument.Open("your-template.potx", true))
{
    var presentationPart = presentationDoc.PresentationPart;
    
    // 1. 新建隐藏幻灯片
    var slidePart = presentationPart.AddNewSlidePart();
    var slide = new Slide(new CommonSlideData(new ShapeTree()));
    // 设置幻灯片为隐藏状态
    slide.Show = new Show(false);
    slidePart.Slide = slide;

    // 2. 从当前活动PPT获取选中的手动形状，转成OpenXML节点
    var selectedShape = Globals.ThisAddIn.Application.ActiveWindow.Selection.ShapeRange[1];
    var shapeXml = selectedShape.OpenXmlElement.OuterXml;
    
    // 3. 将形状插入到隐藏幻灯片的ShapeTree容器中
    var shapeTree = slidePart.Slide.CommonSlideData.ShapeTree;
    shapeTree.InnerXml += shapeXml;

    // 4. 给形状加唯一标识，方便后续查找匹配
    var targetShape = (Shape)shapeTree.Elements<Shape>().Last();
    targetShape.Name = "CustomShape_Template_001";

    // 保存模板修改
    presentationDoc.Save();
}

注意：如果形状包含图片、渐变等关联资源，需要同步复制对应的ImagePart等部件，避免插入时丢失样式。

三、VSTO加载项读取并插入形状到PPTX #

// 获取当前活动幻灯片的OpenXML部件
var currentSlide = Globals.ThisAddIn.Application.ActiveWindow.View.Slide;
var currentSlidePart = currentSlide.SlidePart;

// 打开POTX模板读取目标形状
using (var templateDoc = PresentationDocument.Open("your-template.potx", false))
{
    var templatePresentationPart = templateDoc.PresentationPart;
    // 定位到存储形状的隐藏幻灯片
    var templateSlidePart = templatePresentationPart.SlideParts.FirstOrDefault(sp => 
        sp.Slide.Show != null && sp.Slide.Show.Value == false);
    
    if (templateSlidePart != null)
    {
        // 根据标识查找目标形状
        var targetShape = templateSlidePart.Slide.CommonSlideData.ShapeTree.Elements<Shape>()
            .First(s => s.Name == "CustomShape_Template_001");
        
        // 复制形状节点到当前幻灯片
        currentSlidePart.Slide.CommonSlideData.ShapeTree.Append(targetShape.CloneNode(true));
        // 保存当前PPT的修改
        currentSlidePart.Slide.Save();
    }
}

四、让POTX形状在新建PPTX中直接可用 #

如果希望用户除了通过加载项调用，还能手动插入这些形状，可以把形状添加到POTX的母版布局中：

• 将形状存入母版的某个自定义SlideLayoutPart，标记好唯一标识；
• 当用户基于该POTX新建PPT时，母版布局会被继承，形状既可以从PPT的“布局”面板手动调用，也能被加载项读取插入。

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