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

mlreportgen.ppt.NumberFormat 类

命名空间: mlreportgen.ppt

数字格式

自 R2024b 起

全页展开

描述

使用 mlreportgen.ppt.NumberFormat 类的对象来指定演示文稿中数字的格式。要指定一个数字的格式，请将该数字表示为 mlreportgen.ppt.Number 类的对象，并将 NumberFormat 对象包含在 Number 对象的 Style 属性中。要设置文档元素（例如段落、列表或表）中所有数字的格式，请将 NumberFormat 对象包含在代表该元素的对象的 Style 属性中。

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

类属性

ConstructOnLoad
true
HandleCompatible
true

有关类属性的信息，请参阅类属性。

创建对象

描述

numberFormatObj = mlreportgen.ppt.NumberFormat 创建一个 NumberFormat 对象。将 Value 属性设置为格式规范。

numberFormatObj = mlreportgen.ppt.NumberFormat(value) 创建 NumberFormat 对象并将 Value 属性设置为 value 指定的格式。

示例

属性

全部展开

格式规范，指定为字符向量或字符串标量。该规范必须是 sprintf 函数的有效格式规范，并使用以下运算符之一：

  • %f

  • %e

  • %E

  • %g

  • %G

示例: "%0.2f"

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

将 Value 属性应用于整数的选项，指定为数值或逻辑值 1 (true) 或 0 (false)。如果为真，则指定的格式将应用于整数。如果为假，则指定的格式将不适用于整数。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

标记，指定为字符向量或字符串标量。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.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 中推出

另请参阅

| | |