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

toString

类: mlreportgen.ppt.Number
命名空间: mlreportgen.ppt

将数字转换为格式化文本

自 R2024b 起

全页展开

语法

formattedNumber = toString(numberObj)

说明

formattedNumber = toString(numberObj) 将 numberObj 指定的数字转换为格式化文本。

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

  1. numberObj 指定的对象的 Style 属性中的 mlreportgen.ppt.NumberFormat 对象中的规范

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

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

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

您可以使用此方法查看将 mlreportgen.ppt.Number 对象添加到报告后生成的格式化文本。

输入参数

全部展开

要转换的数字，指定为 mlreportgen.ppt.Number 对象。

输出参量

全部展开

格式化的数字，以字符向量形式返回。

示例

全部展开

打开实时脚本

使用 mlreportgen.ppt.Number 和 mlreportgen.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 中推出

另请参阅

| | | |

主题