文件浏览器控件
文件浏览器控件仅X2、X3、X5系列支持
文件浏览器控件用于显示SD卡中的文件，仅X系列支持，使用前需要提前导入字库（UTF8字库），制作字库请参考 创建字库和导入字库
不建议将文件浏览器控件设置为全局，某些参数无法跨页面设置或者获取，建议仅在需要的页面放一个文件浏览器控件用于获取SD卡中的文件和目录信息
如何修改显示的字体大小：需要提前导入不同大小的字库，需要修改控件显示的字体大小时，通过上位机编辑或者通过指令修改控件的font属性即可，请参考 如何修改控件显示的字体
注意
使用delfile删除文件后，如果当前页面使用了文件浏览器控件，需要重新page到当前页面以重新刷新文件浏览器控件
文件浏览器控件-使用详解
判断当前被选中文件的类型
1 spstr fbrowser0.txt,t0.txt,".",1
2 if(t0.txt=="jpg")
3 {
4 //这是一张jpg图片
5 }else if(t0.txt=="video")
6 {
7 //这是一个video视频
8 }else if(t0.txt=="wav")
9 {
10 //这是一首音乐
11 }else
12 {
13 //这是其他类型
14 }
获取当前被选中文件的完整路径
请注意t1.txt的txt_maxl应配置得足够大，建议配置为200，否则可能因为长度不够导致路径不完整
1 t1.txt=fbrowser0.dir+fbrowser0.txt //获取文件的路径和名称
如何修改文件浏览器控件显示的字体大小和样式
请参考 如何修改控件显示的字体
文件浏览器控件有哪些方法
文件浏览器所有的方法可以点击这里查看
文件浏览器控件有1个方法up
up：跳转到上一级目录(成功返回1,失败返回0)
使用方法：
新建一个按钮控件，txt属性改为返回，在弹起事件中编写以下代码
1 fbrowser0.up()
注意
当文件浏览器处于根目录时，便无法返回上一级目录
文件浏览器控件-常见问题
1.文件浏览器中文件名称显示不正常（乱码）
文件名只建议包含数字和英文，不建议包含其他字符，比如中文日文韩文等，因为文件浏览器需要使用UTF8编码，且目前输入法不支持UTF8拼音输入，因此建议大家使用数字和英文来命名文件夹
文件浏览器控件-样例工程下载
文件浏览器控件-相关链接
文件浏览器控件-属性详解
提示
绿色属性可以通过上位机或者串口屏指令进行修改，黑色属性只能在上位机中修改或者不可修改，可通过上位机进行修改指“选中控件后通过属性栏修改控件的属性”
type属性 -控件类型，固定值，不同类型的控件type值不同，相同类型的控件type值相同，可读，不可通过上位机修改，不可通过指令修改。参考： 控件属性-控件id对照表
id属性 -控件ID，可通过上位机左上角的上下箭头置顶或置底，可读，可通过上位机修改左上角的箭头置顶或置地间接修改，不可通过指令修改。参考： 如何更改控件的前后图层关系
objname属性 -控件名称。不可读，可通过上位机进行修改，不可通过指令更改。
vscope属性 -内存占用(私有占用只能在当前页面被访问，全局占用可以在所有页面被访问)，当设置为私有时，跳转页面后，该控件占用的内存会被释放，重新返回该页面后该控件会恢复到最初的设置。可读，可通过上位机进行修改，不可通过指令更改。参考：跨页面赋值，全局变量操作
drag属性 -是否支持拖动:0-否;1-是。仅x系列支持。可读，可通过上位机修改，可通过指令修改。
aph属性 -不透明度(0-127)，0为完全透明，127为完全不透明。仅x系列支持。可读，可通过上位机修改，可通过指令修改。
effect属性 -加载特效:0-立即加载;1-上边飞入;2-下边飞入;3-左边飞入;4-右边飞入;5-左上角飞入;6-右上角飞入;7-左下角飞入;8-右下角飞入。仅x系列支持，在上位机中设置为立即加载时，无法通过指令变为其他特效，当在上位机中设置为非立即加载的特效时，可以变为立即加载，也可以再改为其他特效
sta属性 -背景填充方式:0-切图;1-单色;2-图片;3-透明（仅x系列支持透明）。可读，可通过上位机修改，不可通过指令修改。
style属性 -显示风格:0-平面;1-边框;2-3D_Down;3-3D_Up;4-3D_Auto，sta为单色时才有这个属性。可读，可通过上位机修改，不可通过指令修改。
borderc属性 -边框颜色。当style设置为边框时可用。可读，可通过上位机修改，x系列可通过指令修改，其他系列不可通过指令修改。
borderw属性 边框粗细。当style设置为边框时可用。最大值:255。可读，可通过上位机修改，x系列可通过指令修改，其他系列不可通过指令修改。
picc属性 -切图背景(必须是全屏图片)，sta为切图时才有这个属性。可读，可通过上位机修改，可通过指令修改。
bco属性 -背景色，sta为单色时才有这个属性。可读，可通过上位机修改，可通过指令修改。
pic属性 -背景图片，sta为图片时才有这个属性。可读，可通过上位机修改，可通过指令修改。
font属性 -控件调用的字库id，调用不同的字库会显示不同的字体或字号。可读，可通过上位机修改，可通过指令修改。参考：1、 创建字库和导入字库 2、 指定字库
pco属性 -字体色。可读，可通过上位机修改，可通过指令修改。
bco2属性 -选中项背景色 ，sta为单色时才有这个属性。可读，可通过上位机修改，可通过指令修改。
pco2属性 -选中项字体色。可读，可通过上位机修改，可通过指令修改。
left属性 -是否显进度条:0-不显示;1-操作时显示;2-持续显示。
ch属性 -滑动惯性力度(0-32,0为无惯性)
dir属性 -需要遍历的目录路径(每设置一次将重新刷新一次文件列表)
filter属性 -文件名关键字过滤(多个关键字使用|分隔,如:”.txt|.data”)
val属性 -当前选中项序号(每改变一次,txt值将重新赋值为新的val值指向的文件名)
txt属性 -当前val值指向的文件名(自动随val值改变,只可获取不可设置),请勿跨页面获取(无法跨页面获取)
qty属性 -遍历结果中的文件总数
dis属性 -文件名显示行数
spax属性 -文件名显示横向间距(最小0,最大255)
spay属性 -文件名显示纵向间距
maxval_y属性 -最大纵向滑动值(运行中根据字符内容自动改变,只可读取不可设置)
val_y属性 -当前纵向滑动值(最小0,最大maxval_y)
psta属性 -是否支持子文件夹:0-否;1-是
pic1属性 -文件夹图标
pic2属性 -默认文件图标
vvs2属性 -自定义文件图标(类型/图片ID,如:”.txt/2.data/3”)
buffsize属性 -储存遍历结果所使用的缓冲区大小(用于储存遍历出来的所有文件名,推荐32000)
fwarning属性 -编译时是否提示非utf-8编码警告(此属性仅用于编译配置,运行中不可访问不可读取):0-不提示;1-提示
x属性 -控件的X坐标。可读，可通过上位机修改，x系列可通过指令修改，其他系列不可通过指令修改。
y属性 -控件的Y坐标。可读，可通过上位机修改，x系列可通过指令修改，其他系列不可通过指令修改。
w属性 -控件的宽度。可读，可通过上位机修改，不可通过指令修改。
h属性 -控件的高度。可读，可通过上位机修改，不可通过指令修改。
文件浏览器控件-方法详解
up方法 - int up() 跳转到上一级目录(成功返回1,失败返回0)