插件定义

定义脚本命令、工具或对象插件的外观的参数被存储在参数记录中，该记录与文件中的每个对象实例关联。这些记录会存储各次使用之间的持久性数据，并提供默认参数值。会显示一个对话框的一个菜单命令，例如：可能需要存储某用户输入的值以备后用。一种可能在弹出列表中提供多种模式选项的工具。如果用户想要选择不同的工具模式，则新设置可以在工具项的后续使用中被保存且重复使用。这些值都可以存储到菜单或工具的参数记录中，且之后在该命令或工具被再次选定时接受检索。切换文件将显示与新文件关联的存储值，或者，如果不存在参数记录，则将显示由插件项创建的参数记录的默认值。

通过使用“对象信息”面板访问对象参数记录中的值，以修改每个对象实例的参数。文件中创建第一个对象（或工具）实例后，也会创建一个默认参数记录。与对象实例关联参数记录截然不同的是，此默认参数记录会利用该文件存储对象默认设置。在放置后续对象实例时，会用它来定义每个新对象实例的默认值。

1. 从“插件管理器自定义插件”选项卡中，选择要定义或编辑的插件。

参数	说明
常规
类型	显示正在创建的插件的类型（菜单命令、工具、对象或包含文件）
语言	根据插件脚本部分所使用的语言，显示 Python 或 VectorScript（请参见指定插件脚本）
名称	指定新插件的名称；此亦为插件文件的名称，自动追加相应的扩展名（.px、 .vsm、.vst 或 .vso）如果重命名插件，请在以后更新工作空间以更新插件名称。
类别	为标题类别指派插件，以便在工作空间编辑器中轻松找到插件
参数	指定插件的默认参数。默认参数在插入时应用于插件。参数按插件的指定顺序列出；通过在 # 列中拖动以更改参数顺序。
参数列表	列出默认对象参数、备用（本地化）名称（如果适用）、格式和默认值。对于线性对象，会显示包含线性对象轴长度的 LineLength 参数。对于矩形对象，将同时显示linelength（对象实例的初始长度）和boxwidth（对象实例的初始宽度）参数。可以为这些参数指定新的默认值，但不能删除它们。
新建	为插件创建新参数。“编辑参数”对话框打开。指定参数名称、替换（本地化）名称（如果适用）、类型和默认值。要创建预定义参数选项的弹出列表，选择弹出类型。“编辑选择”对话框打开。列出选项。列表中每一行代表弹出列表中的一个选择；不要留空白行。以后要编辑弹出的选择，单击选项。
编辑	编辑选定的插件参数。某些第三方插件和内置插件允许编辑参数。
删除	删除选定的插件参数
字符串	指定插件使用的文本字符串
字符串列表	列出插件使用的字符串（例如，颜色选择器值，用于指定插件要使用的特定颜色）
添加	将文本字符串添加到插件定义中。“添加类别”对话框打开。自动指派下一个可用资源标识号；指定类别名称。
编辑	编辑当前选定的字符串。“编辑字符串”对话框打开。选择单个字符串值并单击编辑以打开“编辑字符串”对话框。指定字符串值；值取决于类别；有关信息，请参阅developer.vectorworks.net。
删除	删除当前选定的字符串
特性	特性设置允许插件的行为类似于标准的 Vectorworks 菜单命令、工具和对象。这些设置控制插件相对于文件状态（选择状态、视图方向）的行为，并定义要显示的帮助文本。可用特性取决于插件类型。只能指定自定义插件特性。
命令
可用性选项	针对每个绘图状态，指定条件是否必需（绘图状态条件对于命令的活动必不可少）、禁止（只要该绘图状态条件存在，命令则被停用）或可以忽略（绘图状态不会影响到命令激活）
工具提示帮助	指定菜单命令帮助文本；描述菜单命令的帮助文本，会在光标停留于命令上方时显示（当前仅适用于 Mac）
上下文帮助覆盖	输入 URL（以 http: 开始）以指定包含帮助信息的网页。要相对于 Vectorworks 程序文件夹指定一个文件，指明以 ./ （句点与右斜杠）起始的路径。
版本创建于	指定插件创建时的 Vectorworks 版本号。例如：针对 Vectorworks 2019、2020 和 2021，分别采用 24、25 和 26。
版本修改于	指定插件上一次修改时的 Vectorworks 版本号。例如：针对 Vectorworks 2019、2020 和 2021，分别采用 24、25 和 26。
版本废弃于	指定插件退役时的 Vectorworks 版本号。例如：针对 Vectorworks 2019、2020 和 2021，分别采用 24、25 和 26。
工具
工具栏字符串	指定要在工具栏内显示的描述性文本；这通常包括对象的名称，而且可包含指明用户要执行的操作的文本
图标	如果需要，插件的默认图标可以被替换为自定义图标。使用第三方图标编辑器，创建两个版本的图标：一个用于标准分辨率显示，另一个用于高分辨率显示： ● 标准分辨率：图像位于 26 像素宽 20 像素高的区域中心。以 .png 格式保存图标。 ● 高分辨率：图像位于 52 像素宽 x 40 像素高的区域中心。以 .png 格式保存图标，名称与标准分辨率图像相同，但在文件名末尾添加 “@2x” 后缀。例如，如果标准分辨率图标命名为 3DModelingToolSet.png，高分辨率图标必须命名为 3DModelingToolSet@2x.png；否则程序将无法定位图标。单击导入 PNG 图标导入标准分辨率图标；如果高分辨率图标还带有 @2x 名称，则软件也会自动导入该图标。Vectorworks 程序针对设备的分辨率自动显示相应的图像。
投影	确定什么视图投影必须为活动。如果需要三维投影，则视图被更改。如果需要二维投影，则为此工具激活“屏幕平面”。组合投影并不会影响到视图投影。
执行脚本	工具被默认设置为选定后立即执行。但在某些情况下，可能需要脚本执行等待鼠标移动（比如基于用户鼠标移动互动式绘制的工具）。
上下文帮助覆盖	输入 URL（以 http: 开始）以指定包含帮助信息的网页。要相对于 Vectorworks 程序文件夹指定一个文件，指明以 ./ （句点与右斜杠）起始的路径。
版本创建于	指定插件创建时的 Vectorworks 版本号。例如：针对 Vectorworks 2019、2020 和 2021，分别采用 24、25 和 26。
版本修改于	指定插件上一次修改时的 Vectorworks 版本号。例如：针对 Vectorworks 2019、2020 和 2021，分别采用 24、25 和 26。
版本废弃于	指定插件退役时的 Vectorworks 版本号。例如：针对 Vectorworks 2019、2020 和 2021，分别采用 24、25 和 26。
工具提示帮助	指定光标停留于面板中对象图标上方时要显示的帮助文本
对象
图标	如果需要，可用一个自定义图标替代默认图标。使用第三方图标编辑器，创建一个 8 位图像，位于 26 像素宽 20 像素高的区域的中心。按 .png 格式保存图标，并单击导入 PNG 图标以将其导入。
投影	确定什么视图投影必须为活动。如果需要三维投影，则视图被更改。如果需要二维投影，则为此工具激活“屏幕平面”。组合投影并不会影响到视图投影。
执行脚本	对象被默认设置为选定后立即执行。但在某些情况下，可能需要脚本执行等待鼠标移动（比如基于用户鼠标移动互动式绘制的对象）。
默认类	指定对象插入时的默认类；如果此类在放置对象时不存在，则会自动创建
上下文帮助覆盖	输入 URL（以 http: 开始）以指定包含帮助信息的网页。要相对于 Vectorworks 程序文件夹指定一个文件，指明以 ./ （句点与右斜杠）起始的路径。
版本创建于	指定插件创建时的 Vectorworks 版本号。例如：针对 Vectorworks 2019、2020 和 2021，分别采用 24、25 和 26。
版本修改于	指定插件上一次修改时的 Vectorworks 版本号。例如：针对 Vectorworks 2019、2020 和 2021，分别采用 24、25 和 26。
版本废弃于	指定插件退役时的 Vectorworks 版本号。例如：针对 Vectorworks 2019、2020 和 2021，分别采用 24、25 和 26。
工具提示帮助	指定光标停留于面板中对象图标上方时要显示的帮助文本
选项（仅限自定义参数对象类型）
执行选项	与符号类似，亦可向对象指派预先定义的文档放置插入选项。这些选项能够让对象妥善地与墙壁或其他高级 Vectorworks 对象类型互动。命令和工具插件没有插入选项设置。默认情况下，仅当编辑对象参数或控制点时，才会重新计算对象几何图形。重新计算对象几何图形时，字体、文本大小或线条颜色等特性的文件默认设置，都会重新应用于该对象。如果自对象被放置或上一次被编辑起，上述设置有任何修改，则对象的外观也可能发生变动。只要对象参数发生变动，就会调用该脚本。此外，对于重新计算对象很重要的实例（例如，放入墙中的窗），当对象被旋转（重置旋转）或移动（重置移动）时，该脚本就会导致几何形状被重新计算。或者，插件脚本可以成为一个事件图柄（基于事件）；然后脚本必须响应一小组应用程序事件。对于事件处理脚本相关的样本和文档，请访问 vectorworks.net 的“支持区域”。
插入墙壁中	为对象选择墙壁插入选项设置。请参阅创建符号定义。对于不需要插入选项的对象，保留选项的默认设置。