RTEXT (Express Tool)

创建远程文本 (rtext) 对象。

查找

您可以使用 rtext 对象作为文件参照以显示通用于多个图形的文字，如图纸注释或法律免责声明。也可以使用它来显示较大的文本正文，例如规格或部件说明。

远程文字对象也称为反应文字对象，与 AutoCAD 文字和多行文字对象的显示方式相同，但文字的来源为外部文本文件或者 DIESEL 表达式的值。您可以使用 RTEDIT 命令编辑 rtext 对象。

注： 如果包含 rtext 对象的图形在未安装 RTEXT 的计算机上处于打开状态，则生成的代理对象将显示 rtext 对象的边界框。如果要与没有 RTEXT 的其他用户共享您的图形，请使用 EXPLODE 命令将 rtext 对象转换为 mtext 对象。

命令：RTEXT 当前文字样式：标准 文字高度：0.2000 文字旋转：0 Enter an option [Style/Height/Rotation/File/Diesel] <Diesel>: 指定选项

选项

Style	选择文字样式。
Height	指定文字高度。
Rotation	指定旋转值。
File	使用外部文本文件。
Diesel	使用 DIESEL 代码。

提示： 一旦使用“文件”选项创建了 rtext 对象，就可以使用 LIST 命令识别关联的文本文件。

使用 DIESEL 表达式

DIESEL 提供以前只能使用自定义程序访问的选项。下面提供一些样例，说明如何在图形中使用包含 DIESEL 表达式的 rtext 对象。您可以将这些样例粘贴到“DIESEL 表达式”对话框中。

使用 GETVAR 函数

要显示图形名称 102-fp12.dwg，请使用以下表达式：

图形文件: $(getvar "DWGNAME")

生成的 rtext 对象显示如下：

图形文件: 102-fp12.dwg

要包含带有文件名的文件夹路径：

图形名: $(getvar, "dwgprefix")$(getvar, "dwgname")

生成的 rtext 对象显示如下：

图形文件: C:\Projects\97-102\Arch\102-fp12.dwg

注： 如果在标准标题栏中参照图形路径或名称，它将始终显示图形的文件名，即使标题栏显示在外部参照文件中。

使用 EDTIME 函数

打印图形时，您可能希望输出显示创建打印时的日期和时间。以下 DIESEL 表达式将在图形中显示该信息：

$(edtime, 0, MON DD"," YYYY - H:MMam/pm)

生成的 rtext 对象显示如下：

2000 年 3 月 22 日 - 下午 11:12

使用 GETPROP 函数

Rtext 通过本地定义的 $(getprop) DIESEL 函数支持图形特性。使用 $(getprop)，可以提取“图形特性”对话框（DWGPROPS 命令）中选项卡中的值并显示在 rtext 对象中。$(getprop) 函数的语法为：

$(getprop, 特性名称)

其中特性名称可以是对话框中的以下任意字段：

标题 主题 作者 关键字 注释 上次保存时间 保存者 修订号 自定义特性

例如，如果图形的图形特性在“主题”字段中包含文字“挖掘场地”，则 DIESEL 表达式为：

主题: $(getprop, subject)

在 rtext 对象中将显示为：

主题: 挖掘场地

注： $(getprop) 函数仅在 rtext 对象中受支持。与提供给其他 DIESEL 函数的参数不同，$(getprop) 的参数不能带引号。参数不区分大小写。

如果您有一个名为“项目名称”的自定义特性，则以下 DIESEL 表达式将显示该值：

项目: $(getprop, %PROJECT NAME)

注： 在使用 $(getprop) 时发生的错误（如不正确的语法或参数错误）将显示 (GETPROP ERROR)。如果使用了不存在的自定义特性名称，$(getprop) 将显示一个空字符串。

使用 XREFS 函数

Rtext 支持使用 $(xrefs) 函数列出附着到图形的外部参照文件，语法如下：

$(xrefs [, flags [, leader [, trailer]]])

flags	具有以下含义的位标志集合：1 =（默认）包含外部参照的文件名称（不独占使用标志 2），2 = 包含外部参照块名（不独占使用标志 1），4 = 不显示文件扩展名，8 = 不显示路径，16 = 显示具有其他间距的嵌套
leader	在每个外部参照项之前插入的文字字符串。
trailer	附加到每个外部参照项（除最后一个）的文字字符串。

例如，rtext DIESEL 表达式为：

$(xrefs,3)

显示一个外部参照列表，格式如下：

B-ELEC [c:\proj-14\b-elec.dwg] M-ELEC [c:\proj-14\m-elec.dwg] R-ELEC [c:\proj-14\r-elec.dwg] F-ELEC [c:\proj-14\f-elec.dwg]

而表达式为：

$(xrefs,2,Includes: )

如下列出外部参照：

Includes: B-ELEC Includes: M-ELEC Includes: R-ELEC Includes: F-ELEC

使用 IMAGES 函数

Rtext 支持通过 $(images) 函数列出附着到图形的图像。该函数的语法为：

$(images [, flags [, leader [, trailer]]])

flags	具有以下含义的位标志集合：4 = 不显示文件扩展名，8 = 不显示路径
leader	在每个图像项之前插入的文字字符串。
trailer	添加了每个图像项（除最后一个）的文本字符串。

$(images) 函数的行为类似于 $(xrefs) 函数的行为。

使用 GETREC 函数

RText 支持通过 $(getrec) 函数显示 xrecord 数据。该函数的语法为：

$(getrec, key, code)

key	在命名对象词典中的项名称。
code	要提取的组码。

$(getrec) 函数通过在命名对象词典中查找 key 来从 Xrecord 中提取值，然后查找与 code 关联的数据值。当前，只有范围 1-9（字符串）、40-59（实数）、60-79（整数）和 300-309（字符串）中的组码受支持。

文件

rtext.lsp, rtext.arx