本页采用了机器翻译。点击此处可查看最新英文版本。

clone

类: mlreportgen.dom.Paragraph
命名空间: mlreportgen.dom

复制段落对象

全页展开

语法

clonedPara = clone(sourcePara)

说明

clonedPara = clone(sourcePara) 复制（克隆）指定段落。生成的克隆段落包含源段落的子段落，但不包括父段落。

示例

示例

全部展开

打开实时脚本
import mlreportgen.dom.*;
d = Document('myDoc','html');

para1 = Paragraph('This is a paragraph');
para1.Bold = true;
append(d,para1);
para1Copy = clone(para1);
para1Copy
para1Copy = 
  Paragraph with properties:

        OutlineLevel: []
                Bold: 1
              Italic: []
               Color: []
     BackgroundColor: []
           Underline: []
          WhiteSpace: []
      FontFamilyName: []
            FontSize: []
              Strike: []
              HAlign: []
     OuterLeftMargin: []
     FirstLineIndent: []
           StyleName: []
               Style: {[1×1 mlreportgen.dom.Bold]}
    CustomAttributes: []
              Parent: []
            Children: [1×1 mlreportgen.dom.Text]
                 Tag: 'dom.Paragraph:587'
                  Id: '587'

输入参数

全部展开

要复制的段落对象，指定为 mlreportgen.dom.Paragraph 对象。

输出参量

全部展开

复制的段落对象，由 mlreportgen.dom.Paragraph 对象表示。

提示

  • 使用 clone 方法在文档中多次追加相同的段落内容。

  • 当您克隆一个段落时，DOM 会复制源段落的所有子对象，但不会复制该段落的父对象。

  • 克隆的段落包含您在源段落中设置的格式。克隆的段落格式使用与源段落相同的格式对象。如果您更改共享格式对象中的格式设置，则源段落和克隆的段落将反映该更改。

    如果您更改克隆段落中的格式设置，那么 DOM 将使用新的格式设置为克隆段落创建一个新的格式对象。对于该格式，源段落和克隆段落不再共享相同的格式对象。

    此示例显示了源段落和克隆段落的格式之间的关系。

    1. 创建一个段落，使用将 Bold 和 Italic 格式设置为 true 的样式。

      import mlreportgen.dom.*;
myReport = Document("myDoc","html");
p = Paragraph("This is a paragraph");
append(myReport,p);
MyStyle = {Bold,Italic};
p.Style = MyStyle;
p.Bold
      ans =

     1
      p.Italic
      ans =

     1

    2. 克隆该段落。Bold 和 Italic 格式与源段落相同。

      pClone = clone(p);
pClone.Bold
      ans =

     1
      p.Italic
      ans =

     1

    3. 对于克隆的段落，关闭粗体文本。克隆段落中对 Bold 格式的更改不会影响源段落的文本。源段落文本仍为粗体。 

      pClone.Bold = false;
p.Bold
      ans =

     1

    4. 在源段落的样式对象 (MyStyle) 中，关闭斜体。现在克隆的段落不使用斜体，因为它与 MyStyle 格式共享 Italics 设置。

      MyStyle(2).Value = false
pClone.Italic
      ans =

     0

版本历史记录

在 R2014b 中推出

另请参阅

| |

主题