# LVGL文件浏览器_多文件选择器-自定义控件

**Repository Path**: panlin_code/lvgl_file_select

## Basic Information

- **Project Name**: LVGL文件浏览器_多文件选择器-自定义控件
- **Description**: 基于LVGL的自定义控件文件浏览器，类似windos可以打开指定的路径并选择多个文件或多个路径。
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-10-14
- **Last Updated**: 2023-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LVGL自定义控件-文件浏览器_多文件选择器

#### 介绍
基于LVGL的自定义组件文件浏览器，类似windos可以打开指定的路径并选择多个文件或多个路径，接口简单只有6个。

#### 支持  
1. LVGL的文件系统/stdio标准文件系统系统接口,可同时使用(单片机请注释m_lv_file_select.h文件的M_FILE_SELECT_SUPPORT_STDIO_FS)。  
2. 可选择单/多个文件或目录。 
3. 可自定义排序规则，默认以文件名排序。
4. 支持后缀筛选,例如 ".jpg .bmp .png",参数是m_lv_file_select_open的*filter。 
5. 可设置升降序(事件中设置/创建后设置)。  
6. 自定义选中颜色/界面图标(需要字库有)。   


#### 事件    
1. LV_EVENT_VALUE_CHANGED     
        打开一个目录时产生此事件，可通过m_lv_file_select_get_dir获取当前路径。    
2. LV_EVENT_READY      
	2.1 FILE_SELECT_MODE_ALL:      
    文件浏览模式 可通过m_lv_file_select_read获取当前点击的文件，点击目录不产生此事件（不会关闭窗口）。   
	2.2 FILE_SELECT_MODE_XXX|FILE_SELECT_MODE_ONE/MULTI   
    单选/多选模式 可通过m_lv_file_select_read获取选中的文件或路径列表，以'\n'分隔（自动关闭窗口）。   
	
	
#### 操作方法   
1. 单选模式：长按选中，自动关闭窗口，通过LV_EVENT_READY事件读取当前路径和文件列表。  
2. 多选模式：长按进入多选模式，点击选中，再次点击取选，最后点击右上角✔完成选中，通过LV_EVENT_READY事件读取当前路径和文件列表。 

#### 界面   
![输入图片说明](https://gitee.com/panlin_code/lvgl_file_select/blob/master/1.png "在这里输入图片标题")
![输入图片说明](https://gitee.com/panlin_code/lvgl_file_select/blob/master/2.png "在这里输入图片标题")