按钮控件

## 按钮控件

### 定义
按钮控件是一种交互式控件，用户可以通过点击等操作来触发特定的功能或命令。比如打开新page，运行某一流程等。

### 属性
基本信息，坐标大小，最小宽高，最大宽高以及权限与图像控件一致，请查看[图像控件](/doc/340) 相关介绍。

准易只提供按钮控件的事件类型为单击事件。单击事件有两种状态，点击下去和释放。每一种状态都可以绑定一个事件。

### 事件-单击
当用户鼠标单击下去的时候需要触发的事件。在所有的事件弹出窗口中选择要绑定的事件。准易内置了丰富的事件供客户进行选择。

![](/media/202603//1772529895.9110727.png)

**事件类型分为五种：修改值，打开页面，执行流程，操作工程和界面函数。**

**修改值：** 主要是针对布尔类型的数据（这些数据来源于全局变量模块或者算法模块里的参数），当点击按钮的时候，永远将其值设置为真。例如原本参数值为假，点击后为真；或者原本参数值为真，点击后仍然为真。

![](/media/202603//1772529896.1641493.png)

**打开页面：** 这里的页面主要包括两部分，一部分是系统预设页面，也是全局界面，例如相机配置页，硬件管理页，登录界面等。第二部分是流程内模块参数调整页面，客户可以设置哪些模块需要调试参数。

![](/media/202603//1772529896.4073153.png)

**执行流程：** 工程里所有的流程都可以被按钮的单击事件所控制。控制的类型有6大类，即执行一次普通流程，连续执行普通流程，停止执行普通流程，执行一次全局流程，连续执行全局流程，停止执行全局流程。这些控制对应VG软件的操作如下所示。

![](/media/202603//1772529896.6842275.png)

**操作工程：** 对工程进行相关的操作，准易设置了三种操作，分别是保存工程，开启软键盘和关闭软键盘。如果想要感受到事件的效果，可以结合Lua脚本进行log的记录，然后引入日志模块，即可看到事件日志。

![](/media/202603//1772529896.9126623.png)

**界面函数：** 数据来源有两种，第一种是所有控件定义的事件函数，系统会自动生成，并在此窗口展示出来供客户来进行编辑。比如按钮（pushButton_11）设置了单击事件（buttonPressed），则你可以在另外的控件中通过定义事件的类型为界面函数来触发pushButton_11的buttonPressed事件，如下图所示。

![](/media/202603//1772529897.155496.png)

第二种是自定义的事件函数，可以在脚本编辑器里自己定义函数，需要懂Lua编程技术。具体可以在后面的第3章中进行详细介绍。

### 事件释放
当用户鼠标单击完成后释放鼠标的时候需要触发的事件。在所有的事件弹出窗口中选择要绑定的事件。准易内置了丰富的事件供客户进行选择。具体的事件类型即相应的定义和用法请参照[事件点击](h5-事件-单击)部分。

### 外观属性

![](/media/202603//1772529897.4188168.png)

**外观-文本：** 用户可以自定义按钮的文本，从而让使用者知道该按钮具体的作用。

**外观-选择图标：** 按钮控件支持图标按钮，从而使按钮表达更加丰富，图文结合。图标的大小以及位置也可以自定义，图标可以在文本左边也可以在文本右边。

### 字体属性

![](/media/202603//1772529897.6780648.png)

![](/media/202603//1772529897.928377.png)

### 圆角属性
客户可以自行设置按钮是直角还是圆角。数值越大圆角越大。极限下可以变成椭圆（原本是长方形）或者圆形（原本是正方形）。

![](/media/202603//1772529898.1457713.png)

点击此处跳转到对应的中文说明书文章页:&nbsp;[Button Widget](/doc/628)