主要内容

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

mlreportgen.ppt.Number 类

命名空间: mlreportgen.ppt

文档中要包含的格式化文本编号

自 R2024b 起

描述

使用 mlreportgen.ppt.Number 类的对象将数字转换为可包含在文档中的格式化文本。

转换将使用它找到的第一个格式规范:

  1. Number 对象的 Style 属性中 mlreportgen.ppt.NumberFormat 对象中的规范

  2. 包含 NumberFormat 对象的元素(例如段落、列表或表)的 Style 属性中的 Number 对象中的规范

  3. mlreportgen.ppt.setDefaultNumberFormat 设置的默认规范

如果转换过程中未找到格式规范,则转换将使用准确表示数字所需的最大位数。

mlreportgen.ppt.Number 类是一个 handle 类。

类属性

ConstructOnLoad
true
HandleCompatible
true

有关类属性的信息,请参阅类属性

创建对象

描述

numberObj = mlreportgen.ppt.Number 创建一个空 Number 对象。使用 Value 属性指定要转换为格式化文本的数字。

numberObj = mlreportgen.ppt.Number(value) 创建一个具有指定值的 Number 对象。

示例

属性

全部展开

要转换为格式化文本的数字,指定为标量。不支持复数。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: double

该数字转换为文本时的样式格式,指定为 PPT 格式对象元胞数组。使用 mlreportgen.ppt.NumberFormat 对象指定转换数字的精度。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: cell

此对象的父级,指定为 PPT API 对象。一个 PPT API 对象只能有一个父对象。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

该类忽略此属性。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

标记,指定为字符向量或字符串标量。PPT API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID,其中 CLASS 是对象类,ID 是对象的 Id 属性的值。使用此值来帮助确定在文档生成过程中出现的问题的位置。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

目标标识符,指定为字符向量或字符串标量。PPT API 在创建文档元素对象时会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

使用 mlreportgen.ppt.Numbermlreportgen.ppt.NumberFormat 类向演示文稿添加格式化的数字。使用会话的默认值设置第一个内容幻灯片的数字格式,并将第二个内容幻灯片的数字格式设置为特定 Number 对象的格式样式。

导入 PPT 命名空间,这样您就不必对 PPT API 类使用完全限定名称。

import mlreportgen.ppt.*

设置会话的默认数字格式。

setDefaultNumberFormat("%0.6f");

创建演示文稿并添加标题幻灯片。

ppt = Presentation('myPresentation.pptx');
open(ppt);
slideTitle = add(ppt,"Title Slide");
replace(slideTitle,"Title","Formatted Numbers");

创建第一个标题和内容幻灯片。创建一个 mlreportgen.ppt.Paragraph 对象作为幻灯片的标题。

slide1 = add(ppt,"Title and Content");
p1Title = Paragraph;

使用 Number 创建一个 pi 对象,并使用 toString 方法将其转换为字符串。

number1Obj = Number(pi);
formattedNumber1 = toString(number1Obj);  

将格式化的数字附加到段落。

append(p1Title,string(char(960)) + " in default format: " ...
    + formattedNumber1); % char(960) - Unicode for the pi character

用段落替换第一张标题和内容幻灯片中的标题。

replace(slide1,"Title",p1Title);

在内容文本框中显示默认格式。

numberFormat = getDefaultNumberFormat();
p1Content = Paragraph("Number format is : ");
p1Content.append(numberFormat);
replace(slide1,"Content",p1Content);

创建第二个标题和内容幻灯片。创建一个 mlreportgen.ppt.Paragraph 对象作为幻灯片的标题。

slide2 = add(ppt,"Title and Content");
p2 = Paragraph;

使用 Number 创建一个 pi 对象,并使用 toString 方法将其转换为字符串。通过指定 pi 的格式并覆盖默认数字格式,将此幻灯片上 Number 的小数位限制为小数点后两位。

number2Obj = Number(pi);
number2Obj.Style = NumberFormat("%0.2f");
formattedNumber2 = toString(number2Obj);  

将格式化的数字附加到段落。

append(p2,string(char(960)) + " in individual format: " ...
    + formattedNumber2); % char(960) - Unicode for the pi character

用段落替换第二张标题和内容幻灯片中的标题。

replace(slide2,"Title",p2);

在内容文本框中显示单独的格式。

p2Content = Paragraph("Number format is : ");
p2Content.append("%0.2f");
replace(slide2,"Content",p2Content);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

版本历史记录

在 R2024b 中推出