按钮控件

1. 属性

属性	说明
id	控件ID号，不可更改
global	勾选：作用于全局，不勾选：作用于所在页； 不可脚本读写
name	控件名称，可改，默认名称，button+序号
x	控件起始点x坐标
y	控件起始点y坐标
width	控件宽度，可读写
height	控件高度，可读写
locked	勾选后锁定控件位置，但不影响脚本操作控件属性
visible	控件是否可见，脚本:button7_3.visible=1，可见，button7_3.visible=0，不可见
opacity	不透明度，opacity=0，完全透明，opacity=100，完全不透明。值介于0~100之间。默认100，非必要不建议修改此项。 注：仅S系列支持调整透明度
enable	功能使能。按钮类支持不可用状态，方便客户有条件的启动按钮。enable=0;不可用 enable=1;可用
maxTxtLen	按钮上文本的最大长度。
txt	按钮上显示的文本。
font	按钮文本使用的字库。
fontColor	按钮文本使用的颜色。
bgType	背景类型，分为四种： 颜色，选中此项，则指定只需指定一个颜色，按下时不会切换。 颜色切换，选中此项，需要指定，默认颜色，和按下去切换的颜色。 图片，选中此项，则指定只需指定一个背景图片，按下时不会切换。 图片切换，选中此项，需要指定，默认背景图片，和按下去切换的背景图片。
bgColor	如果背景为颜色，此处设置默认的背景颜色。
dbgColor	禁用时所使用的背景颜色。
bgImg	选择背景图片。根据图片资源名称和顺序号选择。
bgImgMd	默认背景图片的对齐模式。 控件对齐：图片左上角对齐控件左上角。 页面对齐：图片左上角对齐页面的左上角
dbgImg	选择禁用时的背景图片。根据图片资源名称和顺序号选择
dbgImgMd	禁用时的背景图片的对齐模式。 控件对齐：图片左上角对齐控件左上角。 页面对齐：图片左上角对齐页面的左上角
bgColor	如果背景为颜色，此处设置默认的背景颜色。
pbgColor	如果背景为颜色，此处设置按下时背景颜色
dbgColor	禁用时所使用的背景颜色。
bgImg	选择背景图片。根据图片资源名称和顺序号选择。
bgImgMd	默认背景图片的对齐模式。 控件对齐：图片左上角对齐控件左上角。 页面对齐：图片左上角对齐页面的左上角
pbgImg	选择按下时的背景图片。根据图片资源名称和顺序号选择。
pbgImgMd	按下时背景图片的对齐模式。 控件对齐：图片左上角对齐控件左上角。 页面对齐：图片左上角对齐页面的左上角
dbgImg	选择禁用时的背景图片。根据图片资源名称和顺序号选择
dbgImgMd	禁用时的背景图片的对齐模式。 控件对齐：图片左上角对齐控件左上角。 页面对齐：图片左上角对齐页面的左上角

2. 示例

2.1. 在脚本中访问属性（控件名以button0为例）

2.1.1. 获取控件背景类型（button0.bgType）

例如 定义一个整数，获取控件背景类型

int type;
type = button0.bgType;//返回值为0背景类型为颜色，返回值1背景类型颜色切换，返回值2背景类型图片，返回值3背景类型图片切换

2.1.2. 设置按钮背景颜色（button.bgColor）

例如 设置按钮背景颜色为红色

button0.bgColor=0xffff0000;//十六进制颜色格式

2.1.3. 设置按钮按下时背景颜色（button0.pbgColor）

例如 设置按钮按下时背景颜色为绿色

button0.pbgColor=0xff00ff00;

2.1.4. 设置按钮禁用时背景颜色（button0.dbgColor）

例如 设置按钮经用时背景颜色为蓝色

button0.dbgColor=0xff0000ff;

应用技巧：脚本改变控件背景颜色，按下背景颜色，禁用时的背景颜色，

通过对这三种状态的颜色改变，可以设计出丰富多彩的ui界面，也可以通过背景颜色改变来体现某些功能的状态变化，比如串口屏控制很多灯，可以用绿色表示灯开，红色表示灯关，可以用函数根据控件ID批量设置控件背景颜色。

2.1.5. 设置按钮背景图片（button0.bgImg）

例如 设置按钮背景图片为图片素材库第一张图片

button0.bgImg=1;

2.1.6. 设置按钮按下时背景图片（button0.pbgImg）

例如 设置按钮按下背景图片为图片素材库第二张图片

button0.pbgImg=2;

2.1.7. 设置按钮禁用时背景图片（button0.dbgImg）

例如 设置按钮禁用背景图片为图片素材库第三张图片

button0.pbgImg=3;

应用技巧：通过设置不同状态的背景图片，设计不同效果的ui效果，设计ui时，尽量将显示的背景素材放置到一张图片上，这样控件设置背景图片时，对齐方式选择页面对齐，就能利用最少的图片达到最绚烂的效果，图片尽量用jpg格式，png格式解码较慢，会影响屏幕反应速度。

2.1.8. 设置按钮的使能（button0.enable）

例如 设置按钮使能失效，即禁用状态

button0.enable=0;//0 失效  1有效

应用技巧 当功能需求需要锁定控件时，此脚本可以使控件使能失效，背景颜色或图片为禁用时背景图片或颜色，比如控制设备在运行过程中，不能进入调试界面，此时通过脚本设置当设备运行时，让控件使能失效，无法触发控件的脚本翻页，也无法点击

2.1.9. 设置按钮的文本内容（button0.txt）

例如 设置按钮内容为“start”。

button0.txt="start";

应用技巧：控件的文本内容可以通过脚本设置，可以通过改变控件显示的文本，来显示实时状态或者功能效果，方便直观。

2.1.10. 设置按钮文本内容的字体（button0.font）

例如 设置按钮内容为第二个字库的字体格式

button0.font=2;

应用技巧：不同的字库，大小、字体，清晰度，包含的字符都可以不同，通过改变字库，可以让文本内容变换不同风格，显示效果丰富

2.1.11. 设置按钮文本内容的字体颜色（button0.fontColor）

例如 设置按钮内容颜色为红色

button0.fontColor=0xffff0000;

2.1.12. 设置按钮的高度（button0.height）

例如 设置按钮高度为100

button0.height=100;

2.1.13. 设置按钮的宽度（button0.width）

例如 设置按钮宽度为150

button0.height=150;

2.1.14. 设置按钮位置的x坐标（button0.x）

例如 设置按钮x坐标为100

button0.x=100;//坐标原点x=0为页面左上角顶点

2.1.15. 设置按钮位置的y坐标（button0.y）

例如 设置按钮y坐标为100

button0.y=100;//坐标原点y=0为页面左上角顶点

2.1.16. 设置按钮可见性（button0.visible）

例如 设置按钮控件不可见，即隐藏

button0.visible=0;//0隐藏  1可见

2.1.17. 设置按钮透明度（button0.opacity）

例如 设置按钮控件透明度0-100 0完全透明不可见 仅S系列支持调整

button0.opacity=50;//0完全透明  100完全不透明

3. 常见问题

3.1. 系统指令设置控件属性

wset button0.txt "你好"  //设置按钮文本内容为你好

注：串口屏系统命令是以\r\n 结尾的，所以发送数据时需要勾选”发送新行” ，或者输入是手动敲入换行

3.2. 在其他事件脚本中模拟点击按钮触发按钮的脚本（click函数）

例如 模拟点击按钮

click(button0.x,button0.y);//括号内为坐标参数

click函数可以模拟点击屏上某个坐标，并触发该坐标下的可见控件的按下弹起事件的脚本。

3.3 用户发送click命令

当客户主机发送 click系统命令时，如果按钮控件名是唯一的，可以使用click name 命令。如果不唯一，要加页面名称,例如：

click page1.button1

3.4. 颜色与图片

设计按钮ui时可以设计按钮背景颜色，和按下时背景颜色不一样，这样在点击按下时颜色的改变直观看到按钮被按下。

设计按钮背景为图片时效果更好，背景图片和按下时背景图片不一致，可以通过图片的设计，使按钮被按下或弹起时显示立体的效果。图片尽量选用jpg格式。

设置工程ui时最好将直接显示的素材设计成页面背景图，按钮或者其他控件都可以应用背景图素材，图片对齐方式选择页面对齐，这样按钮的背景显示的效果就是与页面背景图片一致。

按钮属性，选择图片切换时，有个稍微难以理解的地方：

具体请查看：图片的对齐模式