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

mlreportgen.dom.Number 类

命名空间: mlreportgen.dom

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

自 R2021a 起

全页展开

描述

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

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

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

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

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

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

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

类属性

ConstructOnLoad
true
HandleCompatible
true

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

创建对象

描述

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

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

.

示例

numberObj = mlreportgen.dom.Number(value,stylename) 创建一个 Number 对象，其 Value 属性设置为 value，将 StyleName 属性设置为 stylename。

属性

全部展开

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

样式表中定义的样式名称，指定为字符向量或字符串标量。样式名称是此元素所追加到的文档或文档部件的样式表中指定的样式的名称。指定的样式定义了该元素在输出文档中的外观，除非该元素的 Style 属性指定的格式覆盖了该样式。要了解有关使用样式表的更多信息，请参阅 使用样式表样式。

注意

Microsoft® Word 报告会忽略文档模板中未定义的样式名称。有关 Microsoft Word 模板的详细信息，请参阅DOM API 报告程序模板。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

此数字转换为文本时的样式格式，指定为 DOM 格式对象元胞数组。使用 mlreportgen.dom.NumberFormat 对象指定转换数字的精度。这些格式将覆盖由 StyleName 属性指定的样式表样式定义的相应格式。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: cell

文档元素的自定义属性，指定为 mlreportgen.dom.CustomAttribute 对象数组。自定义属性必须被此对象所追加到的文档元素的输出格式支持。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

此对象的父对象，指定为文档元素对象。一个文档元素必须只有一个父元素。

属性：

GetAccess
public
SetAccess
private
NonCopyable
true

该类忽略此属性。

属性：

GetAccess
public
SetAccess
private
NonCopyable
true

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

目标标识符，指定为字符向量或字符串标量。DOM API 在创建文档元素对象时会生成一个会话唯一标识符。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

打开实时脚本

将数字表示为 Number 对象。使用 NumberFormat 对象指定小数点后四位精度。

import mlreportgen.dom.*
  
rpt = Document("Report with NumberFormat","pdf");

n = Number(pi);
n.Style = [n.Style {NumberFormat("%0.4f")}];
append(rpt,n);
  
close(rpt);
rptview(rpt);

版本历史记录

在 R2021a 中推出

另请参阅

类

函数

主题