> For the complete documentation index, see [llms.txt](https://chaoses-ib.gitbook.io/directory-opus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/getcustomfielddata.zh.md).

# GetCustomFieldData

如果一个 [重命名脚本](/directory-opus/guan-fang-shou-ce/readme.zh-2/readme.zh-1/readme.zh/rename_scripts.zh.md) 实现了 [**OnGetCustomFields**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh-1/ongetcustomfields.zh.md) 事件，该方法会在重命名对话框运行脚本时收到一个 **GetCustomFieldData** 对象。

| 属性名称          | 返回类型                                                                                                                       | 描述                                                                                                                                                                                                                                                                                                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| fields        | *object:*[**CustomFieldData**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/customfielddata.zh.md) | 返回一个 [**CustomFieldData**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/customfielddata.zh.md) 对象，脚本可以使用它将自定义字段添加到 *重命名* 对话框。添加到该对象中的每个属性都将在对话框中创建一个新字段，允许用户向重命名脚本提供更多信息。                                                                                                                 |
| field\_labels | *object:*[**Map**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/map.zh.md)                         | 这允许你为脚本的自定义字段分配标签，这些标签会显示在 *重命名* 对话框中。为此，将此属性设置为一个通过 [**DOpusFactory**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dopusfactory.zh.md)**.Map** 方法创建的 [**Map**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/map.zh.md)，其中包含名称/标签字符串对。                           |
| field\_tips   | *object:*[**Map**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/map.zh.md)                         | 这允许你为脚本创建的任何编辑字段分配 "提示信息"。提示信息会显示在空的编辑字段中，提示用户该字段需要什么类型的数据。要使用它，请将此属性设置为一个通过 [**DOpusFactory**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dopusfactory.zh.md)**.Map** 方法创建的 [**Map**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/map.zh.md)，其中包含名称/提示信息字符串对。 |
| focus         | *string*                                                                                                                   | 你可以使用此字段指定当你的字段第一次出现时哪个控件默认获得输入焦点。将其设置为所需控件的名称。你还可以指定 **!oldname** 或 **!newname** 将焦点分配给标准的旧名称和新名称字段。                                                                                                                                                                                                             |