Add

IGlobalLayoutSlideCollection.Add 方法

向演示文稿添加一个新的布局幻灯片。

public ILayoutSlide Add(IMasterSlide master, SlideLayoutType layoutType, string layoutName)
参数类型描述
masterIMasterSlide新布局的母版幻灯片。
layoutTypeSlideLayoutType新布局的布局类型。支持的布局类型：标题、仅标题、空白、标题和对象、垂直文本、垂直标题和文本、两个对象、节标题、两个文本和两个对象、标题对象和标题、图片和标题、自定义。其他不支持的布局类型包括：文本、双列文本、表格、文本和图表、图表和文本、图示、图表、文本和剪贴画、剪贴画和文本、文本和对象、对象和文本、对象、文本和媒体、媒体和文本、对象覆盖文本、文本覆盖对象、文本和两个对象、两个对象和文本、两个对象覆盖文本、四个对象、剪贴画和垂直文本、垂直标题和文本覆盖图表、对象和两个对象、两个对象和对象。
layoutNameString新布局的名称。如果传入的名称已经在使用中，将抛出 ArgumentException。如果传入的参数为 null，则会根据传入的布局类型自动生成名称（例如“标题幻灯片”或“1_标题幻灯片”、“2_..”等）。

返回值

添加的幻灯片。

异常

异常条件
NotImplementedException如果传入不支持的 layoutType 参数值，将抛出此异常。当前不支持的布局类型包括：文本、双列文本、表格、文本和图表、图表和文本、图示、图表、文本和剪贴画、剪贴画和文本、文本和对象、对象和文本、对象、文本和媒体、媒体和文本、对象覆盖文本、文本覆盖对象、文本和两个对象、两个对象和文本、两个对象覆盖文本、四个对象、剪贴画和垂直文本、垂直标题和文本覆盖图表、对象和两个对象、两个对象和对象。
ArgumentNullException如果 master 为 null，将抛出此异常。
ArgumentException如果 master 属于其他演示文稿，将抛出此异常。
ArgumentException如果布局名称值 layoutName 在 master 的布局集合中已经在使用，将抛出此异常。

备注

  1. 为 layoutType 的值 SlideLayoutType.Custom 添加的布局不包含占位符和形状。2) 此方法的类似方法是通过 LayoutSlides 属性访问的 Add 方法。

另请参见

AsILayoutSlideCollection AddClone