switch按钮

# 一、概述 开关可用于打开/关闭某物,它看起来像一个小滑块。 # 二、控件设置 控件设置包含如下部分,控件标题,尺寸,外观,属性,事件,选中尺寸,会列出尺寸对应设置细节,以下会对各部分功能分别介绍。 ![设置100.png](https://cos.easydoc.net/36623104/files/l31ed8ax.png) ## 控件标题 控件名称为了方便理解和记忆可以修改,如:LvglSwitch1修改为:LvglSwitch1_mytest。 ![设置101.png](https://cos.easydoc.net/36623104/files/l31ekn8v.png) ## 尺寸 包括排列方式,X,Y轴坐标,拖动控件会改变对应X,Y轴坐标,也可以手动设置。屏幕左上角为像素坐标原点(x=0,y=0)。 【排列】:支持。。。。等排列方式,(注:暂时未实现) 【宽度】:switch按钮宽度,可手动设置,也可以直接拖动修改 【高度】:switch按钮高度,可手动设置,也可以直接拖动修改 【X轴】:描述控件在屏幕上的像素X坐标位置,可手动设置,也可以直接拖动修改 【Y轴】:描述控件在屏幕上的像素Y坐标位置,可手动设置,也可以直接拖动修改 ![设置002.png](https://cos.easydoc.net/36623104/files/l31en673.png) ## 外观 外观分为背景,指示器,控制柄3部分。 ### 背景 背景包括背景样式,内边距。 背景样式,可以设置背景颜色,不透明度(0-255)设置为0是表示完全透明,渐变色,渐变开始,渐变结束,渐变方向,混合默认,如下图所示: ![设置003.png](https://cos.easydoc.net/36623104/files/l31erb4m.png) 内边距设置,可以设置上,下,左,右,内的边距。 ![设置004.png](https://cos.easydoc.net/36623104/files/l31et5ly.png) ### 指示器 指示器只可以设置背景样式,背景样式见上述描述。 ![设置005.png](https://cos.easydoc.net/36623104/files/l31eusnr.png) ### 控制柄 控制柄也包括背景样式,内边距,详细描述见上面背景部分描述。 ![设置006.png](https://cos.easydoc.net/36623104/files/l31exw8t.png) ## 属性 属性包含数据(状态:打开或关闭)和动画(打开或关闭,打开状态可设置动画时长)2部分。 ![设置007.png](https://cos.easydoc.net/36623104/files/l32b54h4.png) ## 事件 事件包含键盘上箭头,键盘右箭头,键盘下箭头,键盘左箭头,键盘回车,改变,每种事件包含函数和屏幕2个选项。 ![设置008.png](https://cos.easydoc.net/36623104/files/l32bb5j5.png) # 三、使用详解 ## 打开UI设计器 首先先创建一个UI工程,这个不做说明,参考前面的快速入门新建工程章节,然后点击UI设计器按钮进入UI设计界面。 ![image.png](https://cos.easydoc.net/36623104/files/l311lpxd.png) ## 添加switch按钮 首先点击添加组件按钮,会出现一个下拉菜单,然后选择switch按钮图标,点击确认。 ![image.png](https://cos.easydoc.net/36623104/files/l315ky5h.png) ![使用100.png](https://cos.easydoc.net/36623104/files/l32boykg.png) ## 控件名称修改 控件名称可以修改用户需要的,方便用户理解,同时会自动生成对应的代码。 ![使用101.png](https://cos.easydoc.net/36623104/files/l32cx3r5.png) ## 尺寸设置 可以通过设置X,Y轴坐标设置控件位置,也可以手动拖拽标签放到合适的位置,坐标会自动变化,屏幕左上角为像素坐标原点(x=0,y=0)。宽度和高度都可以设置。 ![使用102.png](https://cos.easydoc.net/36623104/files/l32cr7wk.png) ## 外观设置 外观设置分为背景,指示器,控制柄3部分,点击编辑进入对应设置界面,点击清除删除对应设置。 ### 背景 背景部分包含背景样式,内边距,2部分,点击编辑进入对应设置界面,点击清除删除对应设置。 背景样式,可以设置背景颜色,不透明度,渐变色,渐变开始值,渐变结束值,渐变方向,混合模式。 ![使用103.png](https://cos.easydoc.net/36623104/files/l32n063q.png) 内边距设置,可以设置上,下,左,右,内的边距。 ![使用104.png](https://cos.easydoc.net/36623104/files/l32n0w8j.png) ### 指示器 指示器可以修改背景样式,点击编辑进入对应设置界面,点击清除删除对应设置。 ![使用105.png](https://cos.easydoc.net/36623104/files/l32n1s6b) ### 控制柄 控制柄部分包含背景样式,内边距,2部分,点击编辑进入对应设置界面,点击清除删除对应设置。 背景样式,可以设置背景颜色,不透明度,渐变色,渐变开始值,渐变结束值,渐变方向,混合模式。 ![使用106.png](https://cos.easydoc.net/36623104/files/l32n2hmg) 内边距设置,可以设置上,下,左,右,内的边距。 ![使用107.png](https://cos.easydoc.net/36623104/files/l32n3ala) ## 属性设置 属性包含数据(状态:打开或关闭)和动画(打开或关闭,打开状态可设置动画时长)2部分。 ![使用108.png](https://cos.easydoc.net/36623104/files/l32n4pah) ## 运行效果 通过上面外观和属性设置后,实际运行效果如下所示: ![使用109.png](https://cos.easydoc.net/36623104/files/l32naa9c.png) ## 事件设置 事件包含键盘上箭头,键盘右箭头,键盘下箭头,键盘左箭头,键盘回车,改变,每种事件包含函数和屏幕2个选项。 ![使用110.png](https://cos.easydoc.net/36623104/files/l32ozb07.png) ### 函数控制 改变事件选择函数,输入对应的函数名,在UiDesign.lua会自动生成,注册改变事件的消息回调函数,UiHandle.lua会自动生成对应空函数。用户自已添加需要实现功能,这里添加一个打印当前状态的打印来演示效果。 ![使用111.png](https://cos.easydoc.net/36623104/files/l32p0obb) 运行模拟器后,点击控制柄,修改当前状态,可以看到打印的当前状态值。 ![使用112.png](https://cos.easydoc.net/36623104/files/l32p26jy.png) ### 屏幕切换 首先添加一个新屏幕用来演示用,改变事件选择屏幕,选择新建的mytest屏幕,在UiDesign.lua会自动生成,注册改变事件的消息回调函数,运行模拟器后点击控制柄后,会切换到刚才创建的mytest屏幕。 ![使用113.png](https://cos.easydoc.net/36623104/files/l32ttoq1) # 四、操作视频