文本字段

文本字段是只有文字与标注引线才有的功能,它可以使用一些代码显示特定的资讯,所有的文本字段的语法都是 %<文本字段与选项>%,当无法取得需要的信息时会显示 ####,代表发生错误。

支持数学运算

RH-56819

所有计算为数字的文本字段函数(例如,Area、BlockInstanceCount、CurveLength、NumPages、PageNumber、Volume)都可以通过数学计算公式进行运算。

例如:

%<2*3>% 等于 6

如果模型中有 4 个图纸配置页面,则 %% 计算结果为 3

字符串格式

支持 Python 和 . net 字符串格式。

范例:
在一个数字前面添加前导零

如果模型中有 2 个图纸配置页面,则 %<'{:03}'.format(NumPages())>%将 2 转换为 002

转换字母大小写

%% 可以转换模型单位,例如 millimeters 转换为 MILLIMETERS

Python 和 .NET 中的大小写转换函数

Python:

upper(), lower(), and capitalize()

.NET:

ToUpper() and ToLower()

在 .NET 中没有直接的首字母大写的函数。

[[参考: https://discourse.mcneel.com/t/force-uppercase-in-text-fields/154554/5]]

函数

面积

计算封闭曲线(必须是平面)、剖面线、曲面、多重曲面、网格、细分物件的面积。

语法:

使用注解样式单位。 RH-54673

%%

指定一个单位。 RH-54211

%%

自定义属性文本

物件的 ID 与附加到物件的文字信息的索引的数值。

语法:

%%

用于检索值的自定义文本

选取物件

选取物件以进行自定义属性文本键检索。

  • 此页提供的功能与属性 > 自定义属性文本中的相同。RH-57736

  • 注解可以通过 "(null)"自引用。如何做...RH-57956

  • UserText() returns a string that cannot be used in calculations unless you convert it to a number. How to... RH-62713

图块属性文本

RH-55634 RH-60917

定义要包含在图块实例中的自定义属性文本

语法:

%%

如何设置:

  1. 使用 Text 指令创建一个文本物件。

  2. 点击文本对话框中的 fx 按钮。

  3. 选择左侧图块属性文本

  4. 提示中输入文本字符串。

  5. 创建一个包含图块属性文本的图块定义。

  6. 使用 Insert 指令将图块添加到工作视窗中。

  7. 出现提示时,输入值或者点击 fx 按钮以使用另一个文本字段。

在本案例中,"Data Table"图块定义是从包含名称、年龄和性别的图块属性文本字符串的表单中创建的。

然后将图块插入到下方的工作视窗中。Insert 指令将会提示输入它们的信息。

下载示例模型...

图块描述

通过在工作视窗中选择图块实例来检索图块定义的描述。 RH-65750

语法:

%%

图块引例数量

显示指定的图块定义在模型里的引例的总数。

语法:

%%

图块名称

RH-65750

通过在工作视窗中选择图块实例来检索图块定义的名称。 RH-29344

语法:

%%

%% returns the name of the block definition that directly contains the text field string. RH-75783

曲线长度

一条曲线的长度。

语法:

使用注解样式单位。 RH-54673

%%

指定一个单位。 RH-54211

%%

日期

当前日期和时间。

日期格式:

从列表中选择日期和时间格式。

地区:

从列表中选择一个地区,将为日期选择适当的语言。RH-57361

语法:

%%

范例:

%% = 12/17/2020

%% = 12/17/2020 4:48 PM

%% = Thursday, December 17, 2020

修改的日期

该文件最后保存的日期和时间。

日期格式:

从列表中选择日期和时间格式。

地区:

从列表中选择一个地区,将为日期选择适当的语言。RH-57361

语法:

%%

范例:

%% = 12/17/2020

%% = 12/17/2020 4:48 PM

%% = Thursday, December 17, 2020

子视图缩放 (仅适用于平行子视图)

为选定的子视图显示格式化的比例值。 RH-31361

语法:

%%

格式示例

Noformatting = 0.1

#:1 = 0.1:1

1:# = 1:10

1=# = 1" = 10'

#=1 = 1/8" = 1'

#=1-0 = 1/8" = 1'-0"

使用子视图属性名称

引用子视图时使用在其物件属性中设置的名称而不是其 GUID。RH-57962

自定义文件文本

在模型中的自定义文件文本。

语法:

%%

用于检索值的自定义文件文本

RH-57736

文件名称

这个文件的路径。

语法:

%%

%% - 为模型创建完整的路径

%% - 为模型创建完整的路径

%% - 短文件名 (包括副档名)

%% - 模型的完整路径,不包含副档名

%% - 不包含副档名的短文件名

数字代表的意义:

1 = 不包含路径的文件名称

2 = 不包含副档名

1+2 = 3 = 短文件名 + 不包含副档名

图层名称

返回所选图层的名称。 RH-55633

语法:

%%

RH-56337

自定义图纸配置文本

返回存储在图纸配置中的自定义文本键的值。

语法:

当前图纸配置中的自定义图纸配置文本键的值。

%%

指定的图纸配置中的自定义图纸配置文本键的值。

%%

RH-57736

模型单位

当前的模型单位

语法:

%%

附注

附注的内容。

语法:

%%

总页数

文件里的图纸配置的总页数。

语法:

%%

物件图层

返回所选物件的图层名称。 RH-55664

语法:

%%

物件名称

显示物件或图块的名称。

语法:

%%

ObjectPageName

Return the name of the layout where the selected object exists. RH-72021

If the object is not on a layout, #### returns.

Syntax:

%%

ObjectPageNumber

Return the number of the layout where the selected object exists. RH-72868

If the object is not on a layout, #### returns.

Syntax:

%%

页面高度

此文本字段所在的图纸配置页面的高度。

语法:

%%

页面名称

当前的或已选的图纸配置页面名称。 RH-55225

已选页面

显示已选图纸配置页面的名称。 RH-55061

语法:

目前的图纸配置页面的名称。

%%

已选的图纸配置页面名称。 RH-55225

%%

页码

目前的图纸配置的编号。

语法:

%%

%%

页面宽度

此文本字段所在的图纸配置页面的宽度。

语法:

%%

页码名称

选定纸张大小的名称。

语法:

%%

RH-56140

点坐标

显示所选点物件的世界XYZ坐标。

XYZ 轴可以分别启用。

语法:

%%

体积

检索挤出物件、曲面、多重曲面、网格或细分物件的体积

允许开放性物件

允许测量开放性物件的体积。 RH-61096

语法:

使用注解样式单位。 RH-54673

%%

指定一个单位。 RH-54211

%%

允许开放性物件。 RH-61096

%% RH-61096