文本字段

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

支持数学运算

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

例如:

%<2*3>% 等于 6

如果模型中有 4 个图纸配置页面,则 %<NumPages()-1>% 计算结果为 3

字符串格式

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

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

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

转换字母大小写

%<ModelUnits().upper()>% 可以转换模型单位,例如 millimeters 转换为 MILLIMETERS

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

Python:

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

.NET:

ToUpper() and ToLower()

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

函数

面积

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

语法:

使用注解样式单位。

%<Area("ObjectID")>%

指定一个单位。

%<Area("ObjectID","Unit")>%

自定义属性文本

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

语法:

%<UserText("ObjectID","Key")>%

用于检索值的自定义文本

选取物件

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

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

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

  • UserText() 返回一个不能用于计算的字符串,除非您将其转换为数字。 详情...

图块属性文本

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

语法:

%<UserText("block","Key","Prompt","Value")>%

如何设置:

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

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

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

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

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

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

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

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

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

下载示例模型...

图块描述

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

语法:

%<BlockDescription("Block Instance ID")>%

图块引例数量

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

语法:

%<BlockInstanceCount("BlockName")>%

图块名称

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

语法:

%<BlockName("Block Instance ID")>%

%<BlockName("Block")>% 可以返回直接包含文本字段字符串的图块定义的名称。

曲线长度

一条曲线的长度。

语法:

使用注解样式单位。

%<CurveLength("ObjectID")>%

指定一个单位。

%<CurveLength("ObjectID","Unit")>%

日期

当前日期和时间。

日期格式:

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

地区:

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

语法:

%<Date("Format", "Region")>%

范例:

%<Date("M/d/yyyy", "en-US")>% = 12/17/2020

%<Date("M/d/yyyy h:mm tt", "en-US")>% = 12/17/2020 4:48 PM

%<Date("dddd, MMMM dd, yyyy", "en-US")>% = Thursday, December 17, 2020

修改的日期

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

日期格式:

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

地区:

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

语法:

%<DateModified("Format", "Region")>%

范例:

%<DateModified("M/d/yyyy", "en-US")>% = 12/17/2020

%<DateModified("M/d/yyyy h:mm tt", "en-US")>% = 12/17/2020 4:48 PM

%<DateModified("dddd, MMMM dd, yyyy", "en-US")>% = Thursday, December 17, 2020

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

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

语法:

%<DetailScale("DetailID","Format")>%

格式示例

Noformatting = 0.1

#:1 = 0.1:1

1:# = 1:10

1=# = 1" = 10'

#=1 = 1/8" = 1'

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

使用子视图属性名称

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

自定义文件文本

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

语法:

%<DocumentText("Key")>%

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

文件名称

这个文件的路径。

语法:

%<FileName>%

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

%<FileName("0")>% - 为模型创建完整的路径

%<FileName("1")>% - 短文件名 (包括副档名)

%<FileName("2")>% - 模型的完整路径,不包含副档名

%<FileName("3")>% - 不包含副档名的短文件名

数字代表的意义:

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

2 = 不包含副档名

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

图层名称

返回所选图层的名称。

语法:

%<LayerName("LayerID")>%

自定义图纸配置文本

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

语法:

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

%<LayoutUserText("Key")>%

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

%<LayoutUserText("LayoutID","Key")>%

模型单位

当前的模型单位

语法:

%<ModelUnits()>%

附注

附注的内容。

语法:

%<Notes()>%

总页数

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

语法:

%<NumPages()>%

物件图层

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

语法:

%<ObjectLayer("ObjectID")>%

物件名称

显示物件或图块的名称。

语法:

%<ObjectName("ObjectID")>%

物件页面名称

返回所选物件所在的图纸配置的名称。

如果物件不在图纸配置中,则返回 #### 。

语法:

%<ObjectPageName("ObjectID")>%

物件页面编号

返回所选物件所在的图纸配置的编号。

如果物件不在图纸配置中,则返回 #### 。

语法:

%<ObjectPageNumber("ObjectID")>%

页面高度

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

语法:

%<PageHeight()>%

页面名称

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

已选页面

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

语法:

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

%<PageName()>%

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

%<PageName("PageID")>%

页码

目前的图纸配置的编号。

语法:

%<PageNumber()>%

%<PageNumber() + OffsetNumber>%

页面宽度

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

语法:

%<PageWidth()>%

页码名称

选定纸张大小的名称。

语法:

%<PaperName()>%

点坐标

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

XYZ 轴可以分别启用。

语法:

%<PointCoordinate("ObjectID","Axes")>%

体积

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

允许开放性物件

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

语法:

使用注解样式单位。

%<Volume("ObjectID")>%

指定一个单位。

%<Volume("ObjectID","Unit")>%

允许开放性物件。

%<Volume("ObjectID","True")>%

Explode 与 ExplodeBlock

当炸开包含文本字段的图块实例时,ExplodeExplodeBlock 指令会产生不同的结果。

使用 ExplodeBlock 指令炸开图块实例之后,日期文本字段仍然返回系统日期。

 

 

 

Rhinoceros 8 © 2010-2024 Robert McNeel & Associates. 01-4月-2024