插件定义

概述

类型

显示正在创建的插件的类型（菜单命令、工具、对象或包含文件）

语言

根据插件脚本部分所使用的语言，显示 Python 或 VectorScript（请参阅指定插件脚本）

名称

指定新插件的名称；此亦为插件文件的名称，自动追加相应的扩展名（.px、 .vsm、.vst或 .vso）。如果重命名插件，请在以后更新工作空间以更新插件名称。

类别

为标题类别指派插件，以便在工作空间编辑器中轻松找到插件

参数

指定插件的默认参数。默认参数在插入时应用于插件。参数按插件的指定顺序列出；通过在 # 列中拖动以更改参数顺序。

参数列表

列出默认对象参数、备用（本地化）名称（如果适用）、格式和默认值。对于线性对象，会显示包含线性对象轴长度的LineLength参数。对于矩形对象，将同时显示linelength（对象实例的初始长度）和boxwidth（对象实例的初始宽度）参数。可以为这些参数指定新的默认值，但不能删除它们。

新建

打开“编辑参数”对话框，为插件新建参数。

指定参数名称、替换（本地化）名称（如果适用）、类型和默认值。

要创建预定义参数选项的弹出列表，选择弹出类型。“编辑选择”对话框打开。列出选项。列表中每一行代表弹出列表中的一个选择；不要留空白行。以后要编辑弹出的选择，单击选择。

编辑

打开“编辑参数”对话框，以编辑所选插件的参数。某些第三方插件和内置插件允许编辑参数。

删除

删除选定的插件参数

字符串

指定插件使用的文本字符串

字符串类别列表

列出插件所用的字符串类别（如对话框参数和按钮名称，或帮助文本字符串）。在每个类别中指定字符串（如对话框参数和按钮名称，或帮助文本字符串）。

添加

打开“添加类别”对话框，将文本字符串类别添加到插件定义中。

自动指派下一个可用资源标识号；指定类别名称。添加类别后，选中并单击编辑，将字符串添加到插件中。

编辑

打开“编辑字符串”对话框以编辑当前选定的字符串类别。单击添加添加新的字符串，或选择字符串并单击编辑或移除。

字符串的值取决于类别；有关信息请参阅 developer.vectorworks.net。

删除

删除当前选定类别及其所有字符串

特性

特性设置允许插件的行为类似于标准的 Vectorworks 菜单命令、工具和对象。这些设置控制插件相对于文件状态（选择状态、视图方向）的行为，并定义要显示的帮助文本。

可用特性取决于插件类型。只能指定自定义插件特性。

命令

可用性选项

针对每个绘图状态，指定条件是否必需（绘图状态条件对于命令的活动必不可少）、禁止（只要该绘图状态条件存在，命令则被停用）或可以忽略（绘图状态不会影响到命令激活）

工具提示帮助

指定菜单命令帮助文本；描述菜单命令的帮助文本，会在光标停留于命令上方时显示（当前仅适用于 Mac）

上下文帮助覆盖

输入 URL（以 http: 开头）以指定包含帮助信息的网页。要相对于 Vectorworks 程序文件夹指定一个文件，指明以 ./ （句点与正斜杠）起始的路径。

版本创建于

指定插件创建时的 Vectorworks 版本号。例如：针对 Vectorworks 2021、2022 和 2023，分别采用 26、27 和 28。

版本修改于

指定插件上一次修改时的 Vectorworks 版本号。例如：针对 Vectorworks 2021、2022 和 2023，分别采用 26、27 和 28。

版本废弃于

指定插件退役时的 Vectorworks 版本号。例如：针对 Vectorworks 2021、2022 和 2023，分别采用 26、27 和 28。

工具

工具栏字符串

指定要在“工具”栏内显示的描述性文本；这通常包括对象的名称，而且可包含指明用户要执行的操作的文本

图标

如果需要，插件的默认图标可以被替换为自定义图标。使用第三方图标编辑器创建两个版本的图标：一个按标准分辨率显示，另一个按高分辨率显示：

标准分辨率：图像位于 26 像素宽 x 20 像素高的区域中心。以 .png 格式保存图标。

高分辨率：图像位于 52 像素宽 x 40 像素高的区域中心。以 .png 格式保存图标，名称与标准分辨率图像相同，但在文件名末尾添加 “@2x” 后缀。例如，如果标准分辨率图标命名为 3DModelingToolSet.png，高分辨率图标必须命名为 3DModelingToolSet@2x.png；否则程序将无法定位图标。

单击导入 PNG 图标导入标准分辨率图标；如果高分辨率图标还带有 @2x 名称，则软件也会自动导入该图标。Vectorworks 程序针对设备的分辨率自动显示相应的图像。

投影

确定什么视图投影必须为活动。如果需要三维投影，则视图被更改。如果需要二维投影，则为此工具激活图层平面。组合投影并不会影响到视图投影。

执行脚本

工具被默认设置为选定后立即执行。但在某些情况下，可能需要脚本执行等待鼠标移动（比如基于用户鼠标移动互动式绘制的工具）。

上下文帮助覆盖

输入 URL（以 http: 开头）以指定包含帮助信息的网页。要相对于 Vectorworks 程序文件夹指定一个文件，指明以 ./ （句点与正斜杠）起始的路径。

版本创建于

指定插件创建时的 Vectorworks 版本号。例如：针对 Vectorworks 2021、2022 和 2023，分别采用 26、27 和 28。

版本修改于

指定插件上一次修改时的 Vectorworks 版本号。例如：针对 Vectorworks 2021、2022 和 2023，分别采用 26、27 和 28。

版本废弃于

指定插件退役时的 Vectorworks 版本号。例如：针对 Vectorworks 2021、2022 和 2023，分别采用 26、27 和 28。

工具提示帮助

指定光标停留于面板中对象图标上方时要显示的帮助文本

对象

图标

如果需要，可用一个自定义图标替代默认图标。使用第三方图标编辑器，创建一个 8 位图像，位于 26 像素宽 20 像素高的区域的中心。按 .png 格式保存图标，并单击导入 PNG 图标以将其导入。

投影

确定什么视图投影必须为活动。如果需要三维投影，则视图被更改。如果需要二维投影，则为此工具激活图层平面。组合投影并不会影响到视图投影。

执行脚本

对象被默认设置为选定后立即执行。但在某些情况下，可能需要脚本执行等待鼠标移动（比如基于用户鼠标移动互动式绘制的对象）。

默认类

指定对象插入时的默认类；如果此类在放置对象时不存在，则会自动创建

上下文帮助覆盖

输入 URL（以 http: 开头）以指定包含帮助信息的网页。要相对于 Vectorworks 程序文件夹指定一个文件，指明以 ./ （句点与正斜杠）起始的路径。

版本创建于

指定插件创建时的 Vectorworks 版本号。例如：针对 Vectorworks 2021、2022 和 2023，分别采用 26、27 和 28。

版本修改于

指定插件上一次修改时的 Vectorworks 版本号。例如：针对 Vectorworks 2021、2022 和 2023，分别采用 26、27 和 28。

版本废弃于

指定插件退役时的 Vectorworks 版本号。例如：针对 Vectorworks 2021、2022 和 2023，分别采用 26、27 和 28。

工具提示帮助

指定光标停留于面板中对象图标上方时要显示的帮助文本

选项

（仅限自定义参数对象类型）

执行选项

与符号类似，亦可向对象指派预先定义的文档放置插入选项。这些选项能够让对象妥善地与墙壁或其他高级 Vectorworks 对象类型互动。命令和工具插件没有插入选项设置。

默认情况下，仅当编辑对象参数或控制点时，才会重新计算对象几何图形。重新计算对象几何图形时，字体、文本大小或线条颜色等特性的文件默认设置，都会重新应用于该对象。如果自对象被放置或上一次被编辑起，上述设置有任何修改，则对象的外观也可能发生变动。

只要对象参数发生变动，就会调用该脚本。此外，对于重新计算对象很重要的实例（例如，放入墙中的窗），当对象被旋转（重置旋转）或移动（重置移动）时，该脚本就会导致几何形状被重新计算。

或者，插件脚本可以成为一个事件图柄（基于事件）；然后脚本必须响应一小组应用程序事件。有关事件处理脚本样例和文档，请访问 vectorworks.net 的“支持区”。

插入墙壁中

为对象选择墙壁插入选项设置。请参阅创建符号定义。

对于不需要插入选项的对象，保留选项的默认设置。