主要内容

克隆

类:mlreportgen.ppt.Paragraph
包:mlreportgen.ppt

复制PPT API段落

语法

objCopy =克隆(obj)

描述

objCopy=克隆(obj)返回一个副本mlreportgen.ppt.Paragraph指定的对象obj。源的副本包括儿童段落,而不是父母。

输入参数

全部展开

段反对克隆,指定为一个mlreportgen.ppt.Paragraph对象。

输出参数

全部展开

段对象副本,作为一个返回mlreportgen.ppt.Paragraph对象。

例子

全部展开

在本例中,您使用相同的段落内容复制两张幻灯片的段落用在第一张幻灯片和附加的拷贝到第二张幻灯片。

导入PPT API包,所以你不需要使用长,完全限定类名。

进口mlreportgen.ppt。*;

创建和打开一个演示。添加一个幻灯片演示。

ppt =表示(“myPresentation.pptx”);打开(ppt);slide1 =添加(ppt,“标题和内容”);

创建一个对象和设置大胆的斜体属性真正的。替换的内容slide1对象。

p =段(“我的幻灯片内容”);p.Bold= true; p.Italic = true; replace(slide1,“内容”,p);

将第二张幻灯片添加到演示。

slide2 =添加(ppt,“标题和内容”);

做的一个副本您所添加的对象slide1。复制的属性值具有相同的值作为源对象。

pcopy =克隆(p)
pcopy =段的属性:大胆:1字体:[]ComplexScriptFont: [] FontColor:[]字形大小:[]斜体:1罢工:[]下标:[]上标:[]强调:[]HAlign:[]水平:[]风格:{[1×1 mlreportgen.ppt。大胆的][1×1 mlreportgen.ppt。斜体]} Children: [1×1 mlreportgen.ppt.Text] Parent: [] Tag: 'ppt.Paragraph:66' Id: '66'

添加额外的副本的内容对象。

追加(pcopy“第二张幻灯片”);

第二张幻灯片的内容替换为副本。

替换(slide2“内容”,pcopy);

关闭和视图表示。

关闭(ppt);rptview (ppt);

这个例子显示了一个段落的格式和之间的关系的一个副本。

当你在设置格式属性mlreportgen.ppt.Paragraph对象,PPT API增加一个相应的对象格式风格财产的对象。当你克隆一个对象,复制属性值具有相同的格式,包括相同的格式作为源对象对象。如果你改变设置在一个共享的对象格式,格式对象和复制反映这一变化。如果你改变格式属性的源对象或复制,PPT API添加一个新的对象格式风格改变对象的属性。因为源对象和副本不再共享相同的对象格式,格式属性的变化之一对象并不影响其他对象。

创建一个mlreportgen.ppt.Paragraph对象的大胆的斜体属性设置为真正的

进口mlreportgen.ppt。*;p =段(“我的幻灯片内容”);p.Bold= true; p.Italic = true;

PPT API集风格财产的一个单元阵列,其中包含一个对象mlreportgen.ppt.Bold对象与价值设置为真正的和一个mlreportgen.ppt.Italic对象与价值设置为真正的

p.Style
ans =1×2单元阵列{1 x1 mlreportgen.ppt。大胆的} {1x1 mlreportgen.ppt.Italic}

克隆的对象。的大胆的,斜体,风格属性值相同的来源对象。

pClone =克隆(p);pClone.Bold
ans =逻辑1
pClone.Italic
ans =逻辑1
pClone.Style
ans =1×2单元阵列{1 x1 mlreportgen.ppt。大胆的} {1x1 mlreportgen.ppt.Italic}

风格财产的来源对象,设置价值财产的斜体对象。这种变化影响的副本因为它的对象风格财产包括相同的斜体对象作为源对象。PPT API集的值斜体财产的复制到所以它的值相匹配斜体对象包含在风格财产。

p.Style {2}。价值= false; pClone.Italic
ans =逻辑0

的副本对象,设置大胆的财产。这个改变不影响源段对象。在源对象,大胆的房地产仍然是真正的

pClone.Bold= false; p.Bold
ans =逻辑1

提示

  • 使用克隆方法包括相同的段落内容不止一次的表示。

  • 当你克隆一个段落,PPT API拷贝源段落的所有孩子的对象,而不是家长的段落。

  • 段落复制包括源段落格式设置。段落的格式复制对象作为源段落使用相同的格式。如果你改变格式设置在共享对象格式,源和复制反映这种变化。

    如果你改变段落的格式设置复制,PPT API创建一个新的对象格式的复制,使用新的格式设置。格式,源段和复制对象不再共享相同的格式。

版本历史

介绍了R2021b