插件定义

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

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

如要定义自定义插件参数：

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

2. 单击编辑定义。

“编辑插件定义”对话框打开。

单击以显示/隐藏参数。

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

3. 定义插件参数之后，单击确定以返回“插件管理器”。

~~~~~~~~~~~~~~~~~~~~~~~~~

指定插件脚本

指定插件定义

用脚本编写的插件

vectorworks.cn