LVGL8.3 --lv_bar 进度条

一、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（值和范围）

设置进度条的范围：

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

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

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

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

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

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

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模式接口

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的类型。