首页/文章/ 详情

ACT开发指南：如何自定义属性控件

小田老师

2年前浏览5034

在前期文章中，给大家介绍过：在ACT向导中开发中，可以使用<property />元素定义属性控件，通过control属性定义控件类型，基础控件类型列举如下：

text：文本属性输入
integer：整型属性输入
float：数字属性输入
select：选择输入框，通过presentation特性(Attributes)指定是否为单选框
boolean：复选框
custom：自定义属性
applycancel：确认/取消属性

上述各基础控件类型在XML中定义和在界面中显示样式如下所示：

在日常使用场景中，基础属性控件能满足参数输入的需要，但是在某些使用场景中，例如，在实现图形中几何对象交互选择、集成调用外置界面时，往往都满足不了需求，这个时候就需要自定义属性控件。

那么应该如何自定义属性控件呢？答案是：基于上述基础属性控件类型，再加上Python代码，就可以实现复杂的属性控件交互功能。

例如，官方提供的属性控件`fileopen`类型，就是基于`custom`类型属性定义的；Mechanical中几何交互选择的属性控件`geometry_selection`是基于`applycancel`类型属性定义的，详情可以查看Addins\ACT\templates和Addins\ACT\libraries下的源文件。

在通过对官方提供的源文件分析后，小田老师总结出两种可行的自定义属性控件的方法，即通过定义回调函数(callbacks)或属性控制类(controller class)。

（1）回调函数定义

在帮助文档中《ACT XML Reference - ACT XML Tags》中，可以找到<property>标签，其中列举了<property />元素中可以定义的属性及回调函数，在此为了方便朋友们日后查阅，小田老师已将常用的回调汇总如下，后期可以根据功能需求合理选用。

在XML文件中定义了回调标签之后，需要在对应的Python文件中实现回调函数；属性的回调函数都是带着默认参数，通常约定为step和prop，参数说明如下：

step表示当前的仿真步骤，对应类型为UserStep，实现IUserObject接口。
prop表示当前属性控件，对应类型为SimProperty，实现ISimProperty接口。

XML中定义的属性回调函数的说明列举如下，前后名称需保持一致：

（2）属性控制类

ACT采用MVC框架，前端界面(View)是采用html编写的，通过更改属性控件的控制器(Controller)，即可自定义属性的交互功能。

在XML文件中，可以在<property />元素标签中，将controller的类名赋给class属性，可以更改控制器类，如下：

然后，需要在对应的Python文件中，实现属性控制器类，通常的控制器类定义模板如下，可以理解为将回调以面向对象的方式进行定义。

后续控件自定义过程中，根据实际的需求选择回调函数，然后实现控制类中相应的回调函数即可。

接下来，我们采用上述两种方法自定义`文件保存`属性控件，因为在预定义的属性模板库中，官方只提供了文件打开：`fileopen`和文件夹打开：`folderopen`两种属性控件，都无法适用文件保存的场景。

所以，这次我们自己动手DIY一个

，最终`文件保存`属性控件实现的效果如下：

首先，我们在XML中通过<property />标签定义两个属性`fileSave1`和`fileSave2`；其中`fileSave1`通过定义在main.py中的控制器类`FileSaveObj`实现，`fileSave2`通过定义在main.py中的回调函数`onFileSaveActive`和`onFileSaveShow`实现。