一、Bar简介

1.1 Overview（概述）

进度条指示器的宽度根据进度条的当前值自动设置。如果设置进度条的宽度小于其高度，就可以创建出垂直摆放的进度条。可以通过设置进度条的值，从而改变指标的开始位置。
进度条的PART与style都比较简单和明确，本文重点在于对进度条模式mode的理解。

1.2 Parts and Styles（部分和风格）

LV_PART_MAIN 进度条的背景，它使用典型的背景样式属性。添加填充会让指示器变小或变大。如果值设置为 LV_ANIM_ON
，则可以继续通过设置 anim_time 样式属性设置动画的时间。
LV_PART_INDICATOR 指示器本身；也是使用所有典型的背景属性。

如图，绿色部分是LV_PART_INDICATOR ，暗红色是LV_PART_MAIN 。

二、Bar 使用

2.1 Value and range（值和范围）

设置进度条的范围：

1	void lv_bar_set_range(lv_obj_t* obj, int32_t min, int32_t max);

设置进度条起始值，可选择是否开启动画LV_ANIM_ON\OFF

1	void lv_bar_set_start_value(lv_obj_t* obj, int32_t start_value, lv_anim_enable_t anim);

设置进度条新值，可选择是否开启动画LV_ANIM_ON\OFF

1	void lv_bar_set_value(lv_obj_t* obj, int32_t value, lv_anim_enable_t anim);

涉及到动画，直接LV_ANIM_ON，并不会完全生效，因为动画时间默认设置为 0 ，这里还需要调一下样式的接口函数

1	void lv_obj_set_style_anim_time(struct _lv_obj_t* obj, uint32_t value, lv_style_selector_t selector);

Bar控件提供的API接口并不多，但是使用的时候还是有些小技巧，初次使用设置bar的值可能会遇到lv_bar_set_start_value这个接口不生效的情况，这是为什么呢？

上图是lv_bar_set_start_value函数的实现，一眼就能发现关键点，bar控件的默认mode是LV_BAR_MODE_NORMAL(普通模式)，只有在LV_BAR_MODE_RANGE(范围模式下该函数才能生效)

2.1 Modes（模式）

bar控件一共有三个模式：

LV_BAR_MODE_NORMAL 像上文所说的普通进度条(默认)
LV_BAR_MODE_SYMMETRICAL 这个模式下可以指定负的最小范围。但是只能从零值到当前值绘制指示器。
LV_BAR_MODE_RANGE 这个模式下也可以指定负的最小范围。这样进度条的起始值可以不是0，而是你指定的数值，但是这样设置的起始值(lv_bar_set_start_value)必须小于结束值

设置bar模式接口

1	void lv_bar_set_mode(lv_obj_t* obj, lv_bar_mode_t mode);

普通模式：LV_BAR_MODE_NORMAL
可以指定负的最小范围，只能从最左边当前值绘制指示器。下图范围(-100,100)

对称模式：LV_BAR_MODE_NORMAL
可以指定负的最小范围，但是只能从零值到当前值绘制指示器。下图范围(-100,100)

0点会根据开始值和结束值计算位置下图范围(-20,100)

范围模式：LV_BAR_MODE_RANGE
和对称模式类似，可以指定负的最小范围，注意这里默认的起始位置start_value 是0；这里可以通过设置起始值来设置。下图范围(-100,100) ，起始值是-50，结束值是20

可以通过图片看出，设置了开始值，指示器就会从设置的值开始向右开始绘制，范围模式下结束值不能小于开始值，也就是说范围设置是(-100,100)，但是我设置了开始值为-50，那么进度条的背景是已经绘制(-100,100)，但是(-100,-50)这个区间的指示器是不能被绘制的，因为已经限定了开始值为-50，只能从-50 的位置开始绘制指示器

三、Bar API

lv_obj_t * lv_bar_create(lv_obj_t * parent);								//创建一个bar对象

void lv_bar_set_value(lv_obj_t * obj, int32_t value, lv_anim_enable_t anim);//在栏上设置一个新值
void lv_bar_set_start_value(lv_obj_t * obj, int32_t start_value, lv_anim_enable_t anim);//在工具条上设置一个新的起始值
void lv_bar_set_range(lv_obj_t * obj, int32_t min, int32_t max);			//设置一个bar的最小值和最大值
void lv_bar_set_mode(lv_obj_t * obj, lv_bar_mode_t mode);					//设置栏的类型。

int32_t lv_bar_get_value(const lv_obj_t * obj);								//获取一个bar的值
int32_t lv_bar_get_start_value(const lv_obj_t * obj);						//获取一个条的起始值
int32_t lv_bar_get_min_value(const lv_obj_t * obj);							//获取一个条形图的最小值
int32_t lv_bar_get_max_value(const lv_obj_t * obj);							//获取一个bar的最大值
lv_bar_mode_t lv_bar_get_mode(lv_obj_t * obj);								//获取bar的类型。

LVGL–进度条部件（lv_bar)

进度条部件（lv_bar)

1	进度条部件常用于显示当前任务的完成进度。

进度条部件组成部分：
主体：LV_PART_MAIN
指示器：LV_PART_INDICATOR

进度条部件的相关API函数

	//知识点1：创建一个进度条部件
    lv_obj_t *bar = lv_bar_create(lv_scr_act());	//创建一个进度条部件
    lv_obj_set_size(bar, 200,20);	//设置尺寸大小
    lv_obj_set_align(bar,LV_ALIGN_CENTER);	//设置在画面的中心位置
    //设置进度条的大小，当前值，范围值
    lv_bar_set_range(bar,-100,100);	//设置进度条的范围值
    lv_obj_set_style_anim_time(bar,1000,LV_STATE_DEFAULT);	//设置动画效果，注意需要在当前值设置之前
    lv_bar_set_value(bar,-50,LV_ANIM_ON);	//设置进度条的当前值
    //拓展知识点：设置模式，起始值
    lv_bar_set_mode(bar,LV_BAR_MODE_SYMMETRICAL);	//修改模式,
//    lv_bar_set_start_value(bar,-50,LV_ANIM_OFF);	//修改起始位置
	
	enum{
		LV_BAR_MODE_NORMAL,					/*默认模式*/
		LV_BAR_MODE_SYSMMERTICAL,			/*从零绘制到当前值（当前值可以小于0）*/
		LV_BAR_MODE_RANGE					/*允许设置起始值，但起始值必须小于当前值*/
	}

进度条使用注意事项（v8.2）版本

1
2
3

@当进度条高度大于宽度时，其方向变为垂直。
@动画事件设置需要放在当前值之前，否则看不到动画。
@动画事件指的是旧值刷新到新值的绘图时间，并不是现实中当前值变化所需要的时间。

LVGL组件 lv_bar