主要内容

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

mlreportgen.ppt.getDefaultNumberFormat

获取 PPT API 数字数据的默认格式

自 R2024b 起

说明

formatSpec = mlreportgen.ppt.getDefaultNumberFormat 将默认数字格式规范作为字符向量返回。要设置默认数字格式规范,请使用 mlreportgen.ppt.setDefaultNumberFormat

示例

示例

全部折叠

使用 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);

输出参量

全部折叠

格式规范,以字符向量形式返回。该规范是 sprintf 函数的有效格式规范,并使用以下运算符之一:

  • %f

  • %e

  • %E

  • %g

  • %G

如果格式规范是一个空字符向量,则 PPT API 将使用准确表示数字所需的最大位数来格式化数字。有关 PPT API 如何选择格式规范的更多信息,请参阅 mlreportgen.ppt.Number

版本历史记录

在 R2024b 中推出