下拉菜单
# 一、概述
在显示选项过多时,可以通过下拉框收起多余选项。只为用户展示列表中的一项。
# 二、控件设置
控件设置包含如下部分,控件标题,尺寸,外观,属性,事件,选中尺寸,会列出尺寸对应设置细节,以下会对各部分功能分别介绍。
![设置100.png](https://cos.easydoc.net/36623104/files/l25wbfap.png)
## 控件标题
控件名称为了方便理解和记忆可以修改,如:LvglDropdown1修改为:LvglDropdown1_mytest
![image.png](https://cos.easydoc.net/36623104/files/l25wh5k9.png)
## 尺寸
包括排列方式,X,Y轴坐标,拖动控件会改变对应X,Y轴坐标,也可以手动设置。屏幕左上角为像素坐标原点(x=0,y=0)。宽度可以设置,高度根据字体大小自动调节。
![设置001.png](https://cos.easydoc.net/36623104/files/l25xidkf.png)
## 外观
外观分为主体,下拉列表,滚动条,选中内容4部分。
![设置002.png](https://cos.easydoc.net/36623104/files/l25xjw09.png)
主体部分可以设置背景样式,边框,内边距,文本样式如上图所示。
背景样式可以设置背景颜色,不透明度(0-255)设置为0是表示完全透明,渐变色如下图所示。
![设置005.png](https://cos.easydoc.net/36623104/files/l25xu9pb.png)
文字样式,可以设置字体颜色,字体可以设置为宋体和黑体(可以设置字体大小,真机需要带矢量字库芯片才支持)。
![设置006.png](https://cos.easydoc.net/36623104/files/l25y3987.png)
下拉列表,可以设置背景样式和文字样式,背景样式见上图。
![设置003.png](https://cos.easydoc.net/36623104/files/l25xp94h.png)
滚动条和选中内容,仅有背景样式可以设置,背景样式见上图。
![设置004.png](https://cos.easydoc.net/36623104/files/l25xr3k0.png)
## 属性
包含候选内容(候选值一行一个),选择下标(下标起始从0开始),列表方位(左,右,上,下),列表最大高度(默认为3/4屏幕垂直高度),动画时长(单位ms)。
![设置007.png](https://cos.easydoc.net/36623104/files/l25ydlpk.png)
## 事件
包含键盘上箭头,键盘右箭头,键盘下箭头,键盘左箭头,键盘回车,改变,每种事件包含函数和屏幕2个选项。
![设置008.png](https://cos.easydoc.net/36623104/files/l25ylsfp.png)
# 三、使用详解
## 打开UI设计器
首先先创建一个UI工程,这个不做说明,参考前面的快速入门新建工程章节,然后点击UI设计器按钮进入UI设计界面。
![设置101.png](https://cos.easydoc.net/36623104/files/l25yvbaq.png)
## 添加下拉框
首先点击添加组件按钮,会出现一个下拉菜单,然后选择下拉框图标,点击确认。
![使用100.png](https://cos.easydoc.net/36623104/files/l25z0scl.png)
![使用101.png](https://cos.easydoc.net/36623104/files/l25z5kia.png)
## 控件名称修改
控件名称可以修改自己需要的,方便自已理解,同时会自动生成对应的代码。
![使用102.png](https://cos.easydoc.net/36623104/files/l25zeswe)
## 尺寸设置
可以通过设置X,Y轴坐标设置控件位置,也可以手动拖拽标签放到合适的位置,坐标会自动变化,屏幕左上角为像素坐标原点(x=0,y=0)。宽度可以设置,高度根据字体大小自动调节。
![使用103.png](https://cos.easydoc.net/36623104/files/l26vsso9)
## 外观设置
外观设置分为主体,下拉列表,滚动条,选中内容4部分,点击编辑进入对应设置界面,点击清除删除对应设置。
### 主体
主体部分包含背景样式,边框,内边距,文字样式4部分,点击编辑进入对应设置界面,点击清除删除对应设置。
背景设置,可以设置背景颜色,不透明度,渐变色,渐变开始值,渐变结束值,渐变方向,混合模式。
![使用108.png](https://cos.easydoc.net/36623104/files/l26x8x23)
边框设置,可以设置边框颜色,不透明度,边框宽度,绘制边,最后绘制,混合模式。
![使用105.png](https://cos.easydoc.net/36623104/files/l26xff8o)
内边距设置,可以设置上,下,左,右,内的边距。
![使用106.png](https://cos.easydoc.net/36623104/files/l26xke0v)
文本样式设置,包含文本颜色,不透明度,字体,字号,粗细度,字间距,行间距,修饰符,选中文字颜色,选中背景颜色,混合模式。
![使用107.png](https://cos.easydoc.net/36623104/files/l26xuyta)
### 下拉列表
下拉列表设置包含背景样式和文字样式,点击编辑进入对应设置界面,点击清除删除对应设置
背景样式设置,可以设置背景颜色,不透明度,渐变色,渐变开始值,渐变结束值,渐变方向,混合模式。
![使用109.png](https://cos.easydoc.net/36623104/files/l26ydm4m)
文字样式设置,包含文本颜色,不透明度,字体,字号,粗细度,字间距,行间距,修饰符,选中文字颜色,选中背景颜色,混合模式。
![使用110.png](https://cos.easydoc.net/36623104/files/l26yl8rp)
### 滚动条
滚动条设置,可以设置背景样式,点击编辑进入对应设置界面,点击清除删除对应设置。
背景样式设置,可以设置背景颜色,不透明度,渐变色,渐变开始值,渐变结束值,渐变方向,混合模式。
![使用114.png](https://cos.easydoc.net/36623104/files/l26yxuc6)
### 选中内容
选中内容设置,可以设置背景样式,点击编辑进入对应设置界面,点击清除删除对应设置。
背景样式设置,可以设置背景颜色,不透明度,渐变色,渐变开始值,渐变结束值,渐变方向,混合模式。
![使用112.png](https://cos.easydoc.net/36623104/files/l26z1mx2)
## 属性设置
属性设置,包含候选内容(候选值一行一个),选择下标(下标起始从0开始),列表方位(左,右,上,下),列表最大高度(默认为3/4屏幕垂直高度)这个设置为80,动画时长(单位ms)。
![使用115.png](https://cos.easydoc.net/36623104/files/l26zejes)
## 运行效果
通过上面外观和属性设置后,实际运行效果如下所示:
![使用116.png](https://cos.easydoc.net/36623104/files/l26zjssw.png)
## 事件设置
包含键盘上箭头,键盘右箭头,键盘下箭头,键盘左箭头,键盘回车,改变,每种事件包含函数和屏幕2个选项。
![使用117.png](https://cos.easydoc.net/36623104/files/l270zew2.png)
### 函数控制
改变事件选择函数,输入对应的函数名,在UiDesign.lua会自动生成,注册改变事件的消息回调函数,UiHandle.lua会自动生成对应空函数。用户自已添加需要实现功能,这里添加一个打印当前选择的打印来演示效果。
![使用118.png](https://cos.easydoc.net/36623104/files/l270zt96)
![使用119.png](https://cos.easydoc.net/36623104/files/l2716svr.png)
### 屏幕切换
首先添加一个新屏幕用来演示用,改变事件选择屏幕,选择新建的mytest屏幕,在UiDesign.lua会自动生成,注册改变事件的消息回调函数,运行模拟器后切换不同选项,会切换到刚才创建的mytest屏幕。
![使用120.png](https://cos.easydoc.net/36623104/files/l277njkq.png)
# 四、操作视频