SetDocumentUserText

工具列 功能表

不在工具列上。

不在功能表上。

SetDocumentUserText 可以将文本信息附加到 Rhino .3dm 文件。该信息以键/值的格式存储。使用 GetDocumentUserText 指令可以检索该信息。

向文件添加用户文本键

  1. 输入键。
  2. 输入值。

向文件添加隐藏的用户文本键

  1. 输入一个带有前缀的 "." 的键。
  2. 输入值。

附注: 隐藏的键不会显示在 文件属性 > 用户文件文本中，也不会显示在用户文件文本面板中。

移除文件的用户文本键

  1. 输入已存在的键。
  2. 输入 "" (双引号) 做为值。

查看: Rhino 中的命名规范

GetDocumentUserText

工具列 功能表

不在工具列上。

不在功能表上。

GetDocumentUserText 指令用于读取之前用 SetDocumentUserText 指令写入的文档用户文本。

DocumentText

工具列 功能表

不在工具列上。

窗口

面板 > 用户文件文本

DocumentText 指令打开用户文件文本面板以便您编辑用户文件文本。

用户文件文本

搜索

在搜索框中输入字符，以仅显示在其键或值中包含输入文本的自定义文本。

键

自定义文本的名称。

值

自定义文本的值。

类型

自定义文本类型。

它可以是普通文本、图块属性文本或文本字段。

查看: Rhino 中的命名规范

对列表进行排序

  • 点击键、值、类型的列标题进行排序。

指示符

列表中的指示符提供了用户文本项的一些信息。

键

值

(类型)

模型单位 

数字

5

 
材质黄铜

= 由文本字段函数驱动的键。

  • 双击 图标以编辑文本字段。

= 图块属性文本。

  • 图块属性键（上表中的 “Material”）只能通过BlockEdit 指令进行编辑。

工具列

新建

将自定义文本添加到 3dm 文件中，用前缀符号 "." (句号) 添加隐藏键。

隐藏的键不会显示在 文件属性 > 自定义文件文本中，也不会显示在自定义文件文本面板中。

文本字段

从当前文档或物件中检索信息。

删除

从 3dm 文件中删除选定的自定义文本键。

使用 SetDocumentUserText 指令移除隐藏键。

导入

将 .3dm, .csv 或 .txt 文件中的自定义文本键读取到当前 3dm 文件中。

导出

将当前 3dm 文件中的自定义文本键保存为 .csv 或 .txt 文件。

右键快显功能表

复制键和值

将选定的键和值复制到剪贴板。

粘贴键和值

从剪贴板粘贴键和值。

粘贴键和值到所有配置

将存储在剪贴板中的键和值粘贴到每个配置中。

  • 自定义文本可以在物件、图纸配置和文档属性之间复制和粘贴。
  • 自定义属性文本以<键>:<物件名称>|<值>的格式被粘贴到自定义文件文本或自定义图纸配置文本中。如果物件没有名称，则 <Object Name> 将被替换为物件的 GUID。
  • 粘贴键和值到所有配置不会覆盖现有的键的值。

  • 在高级设置中搜索 ExportDocumentUserText，默认情况下它设置为 false，如果变为 true，自定义文件文本将在导出时保存或通过 Ctrl(CMD)+C 保存到剪贴板。