==================================
进度条(lv_bar)
==================================

概述
##################################
条对象上有一个背景和一个指示器。指示器的宽度根据条的当前值进行设置。

如果对象的宽度小于其高度，则可以创建垂直条。

不仅可以结束，还可以设置条的起始值，从而改变指示器的起始位置。

零件和样式
##################################
进度条的主要部分称为 ``LV_BAR_PART_BG`` ，它使用典型的背景样式属性。

``LV_BAR_PART_INDIC`` 是一个虚拟部件，还使用了所有典型的背景属性。默认情况下，指示器的最大尺寸与背景的尺寸相同，但是在其中设置正的填充值 ``LV_BAR_PART_BG`` 将使指示器变小。（负值会使它变大）如果在指标上使用了值样式属性，则将根据指标的当前大小来计算对齐方式。例如，中心对齐的值始终显示在指示器的中间，而不管其当前大小如何。


用法
##################################

值和范围
**********************************
可以通过 ``lv_bar_set_value(bar, new_value, LV_ANIM_ON/OFF)`` 设置新值。该值以一个范围（最小值和最大值）解释，可以使用 ``lv_bar_set_range(bar, min, max)`` 进行修改。默认范围是 1..100。

``lv_bar_set_value`` 中的新值可以根据最后一个参数 ``(LV_ANIM_ON/OFF)`` 设置是否带有动画。动画的时间可以通过 ``lv_bar_set_anim_time(bar, 100)`` 进行调整。时间以毫秒为单位。

也可以使用 ``lv_bar_set_start_value(bar, new_value, LV_ANIM_ON/OFF)`` 设置进度条的起始值


模式
**********************************
如果已通过 ``lv_bar_set_type(bar, LV_BAR_TYPE_SYMMETRICAL)`` 启用，则条形可以对称地绘制为零（从零开始，从左至右绘制）。


事件
##################################
仅 `通用事件`_ 是按对象类型发送的。

了解有关`事件`_ 的更多信息。

.. _通用事件: http://lvgl.100ask.net/documentation/03_overview/03_events.html#id2
.. _事件: http://lvgl.100ask.net/documentation/03_overview/03_events.html


按键
##################################
对象类型不处理任何输入按键。

进一步了解 `按键`_ 。

.. _按键: http://lvgl.100ask.net/documentation/03_overview/05_indev.html


范例
##################################

简单的进度条
**********************************

.. figure:: http://photos.100ask.net/lvgl/04_widgets/03_bar/01_lv_ex_bar1.png
	   
	  进度条简单演示


上述效果的示例代码：

.. code-block:: c
    :linenos:

	#include "../../../lv_examples.h"
	#if LV_USE_BAR

	void lv_ex_bar_1(void)
	{
		lv_obj_t * bar1 = lv_bar_create(lv_scr_act(), NULL);
		lv_obj_set_size(bar1, 200, 20);
		lv_obj_align(bar1, NULL, LV_ALIGN_CENTER, 0, 0);
		lv_bar_set_anim_time(bar1, 2000);
		lv_bar_set_value(bar1, 100, LV_ANIM_ON);
	}

	#endif




相关API
##################################
TODO