二、Android应用的界面编程（六）ProgressBar及其子类[SeekBar、RatingBar]er

通常用于向用户显示某个耗时操作完成的百分比。
Android支持几种风格的进度条，通过style属性可以为ProgressBar指定风格。该属性支持如下几个属性值。
# @android:style/Widget.ProgressBar.Horizontal; 水平进度条。
# @android:style/Widget.ProgressBar.Inverse; 普通大小的环形进度条。
# @android:style/Widget.ProgressBar.Large; 大环形进度条。
# @android:style/Widget.ProgressBar.Large.Inverse; 大环形进度条。
# @android:style/Widget.ProgressBar.Small; 小环形进度条。
# @android:style/Widget.ProgressBar.Small.Inverse; 小环形进度条。

【ProgressBar常用的XML属性和方法】
android:max 设置该进度条的最大值
android:progress 设置该进度条的已完成进度值
android:progressDrawable 设置该进度条的轨道对应的Drawable对象
android:indeterminate 该属性设为true，设置进度条不精确显示进度
android:indeterminateDrawable 设置绘制不显示进度的进度条的Drawable对象
android:indeterminateDuration 设置不精确显示进度的持续时间

getMax()：返回这个进度条的范围的上限。
getProgress()：返回进度。
getSecondaryProgress()：返回次要进度。
incrementProgressBy(int diff)：指定增加的进度或减少(+进度增加，-进度减少)。
isIndeterminate()：指示进度条是否在不确定模式下。
setIndeterminate(boolean indeterminate)：设置不确定模式下。
setVisibility(int v)：设置该进度条是否可视。

android:progressDrawable用于指定进度条的轨道的绘制形式，该属性可指定为一个LayerDrawable对象
(该对象可通过在XML文件中用<layer-list>元素进行配置)的引用。

范例：进度条各种样式。

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:orientation="vertical" >
     <LinearLayout
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:orientation="horizontal" >
         <!-- 定义一个大环形进度条 -->
         <ProgressBar
             style="@android:style/Widget.ProgressBar.Large"
             android:layout_width="wrap_content"
             android:layout_height="wrap_content" />
         <!-- 定义一个中等大小的环形进度条 -->
         <ProgressBar
             android:layout_width="wrap_content"
             android:layout_height="wrap_content" />
         <!-- 定义一个小环形进度条 -->
         <ProgressBar
             style="@android:style/Widget.ProgressBar.Small"
             android:layout_width="wrap_content"
             android:layout_height="wrap_content" />
     </LinearLayout>

     <TextView
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
         android:text="任务完成的进度" />

     <!-- 定义一个水平进度条 -->
     <ProgressBar
         android:id="@+id/bar"
         style="@android:style/Widget.ProgressBar.Horizontal"
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
         android:max="100" />
     <!-- 定义一个水平进度条，并改变轨道外观 -->
     <ProgressBar
         android:id="@+id/bar2"
         style="@android:style/Widget.ProgressBar.Horizontal"
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
         android:max="100"
         android:progressDrawable="@drawable/my_bar" />
 </LinearLayout>

其中android:progressDrawable="@drawable/my_bar" 的样式如下：

<?xml version="1.0" encoding="UTF-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 定义轨道的背景  (错号小图标)-->
    <item android:id="@android:id/background"
        android:drawable="@drawable/no" />
    <!-- 定义轨道上已完成部分的样式 (对号小图标) -->
    <item android:id="@android:id/progress"
        android:drawable="@drawable/ok" />
</layer-list>

 public class ProgressBarTest extends Activity {
     // 该程序模拟填充长度为100的数组
     private int[] data = new int[100];
     int hasData = 0;
     // 记录ProgressBar的完成进度
     int status = 0;
     ProgressBar bar, bar2;
     // 创建一个负责更新的进度的Handler
     Handler mHandler = new Handler() {
         @Override
         public void handleMessage(Message msg) {
             // 表明消息是由该程序发送的
             if (msg.what == 0x111) {
                 bar.setProgress(status);
                 bar2.setProgress(status);
             }
         }
     };

     @Override
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.main);
         bar = (ProgressBar) findViewById(R.id.bar);
         bar2 = (ProgressBar) findViewById(R.id.bar2);

         // 启动线程来执行任务
         new Thread() {
             public void run() {
                 while (status < 100) {
                     // 获取耗时操作的完成百分比
                     status = doWork();
                     // 发送消息
                     mHandler.sendEmptyMessage(0x111);
                 }
             }
         }.start();
     }

     // 模拟一个耗时的操作
     public int doWork() {
         // 为数组元素赋值
         data[hasData++] = (int) (Math.random() * 100);
         try {
             Thread.sleep(100);
         } catch (InterruptedException e) {
             e.printStackTrace();
         }
         return hasData;
     }
 }

范例：显示在标题上的进度条
1) 调用Activity的requestWindowFeature()，该方法根据传入的参数可启用特定的窗口特征，例如
传入Window.FEATURE_INDETERMINATE_PROGRESS在窗口标题上显示不带进度的进度条；传入
Window.FEATURE_PROGRESS则显示带进度的进度条。
2) 调用Activity的setProgressBarVisibility(boolean)setProgressBarIndeterminateVisibility(boolean)
即可控制进度条的显示和隐藏。

public class TitleProgressBar extends Activity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // //设置窗口特征：启用显示进度的进度条
        // requestWindowFeature(Window.FEATURE_PROGRESS); //①
        // 设置窗口特征：启用不显示进度的进度条
        requestWindowFeature(Window.FEATURE_INDETERMINATE_PROGRESS); // ②
        setContentView(R.layout.main);
        Button bn1 = (Button) findViewById(R.id.bn1);
        Button bn2 = (Button) findViewById(R.id.bn2);
        bn1.setOnClickListener(new OnClickListener() {
            @Override
            public void onClick(View source) {
                // 显示不带进度的进度条。
                setProgressBarIndeterminateVisibility(true);
                // 显示带进度的进度条。
                setProgressBarVisibility(true);
                // 设置进度条的进度
                setProgress(4500);
            }
        });
        bn2.setOnClickListener(new OnClickListener() {
            @Override
            public void onClick(View source) {
                // 隐藏不带进度的进度条。
                setProgressBarIndeterminateVisibility(false);
                // 隐藏带进度的进度条。
                setProgressBarVisibility(false);
            }
        });
    }
}

===== 拖动条（SeekBar）的功能和用法 =====
# 拖动条是通过滑块的位置来标识数值，而且拖动条允许用户拖动滑块来改变值，比如：调节音量等。
# 由于SeekBar继承了ProgressBar，因此ProgressBar所支持的XML属性和方法完全适用于SeekBar。
# android:thumb：指定一个Drawable对象，该对象将作为自定义滑块，改变拖动条的滑块外观。
# 为了让程序能响应拖动条滑块位置的改变，程序可以考虑为它绑定一个OnSeekBarChangeListener监听器。

范例：通过拖动滑块来改变图片的透明度

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="vertical"
     android:layout_width="fill_parent"
     android:layout_height="fill_parent">
 <ImageView
     android:id="@+id/image"
     android:layout_width="fill_parent"
     android:layout_height="240px"
     android:src="@drawable/lijiang" />
 <!-- 定义一个拖动条，并改变它的滑块外观 -->
 <SeekBar
     android:id="@+id/seekbar"
     android:layout_width="fill_parent"
     android:layout_height="wrap_content"
     android:max="255"
     android:progress="255"
     android:thumb="@drawable/ic_launcher" />
 </LinearLayout>

 public class SeekBarTest extends Activity {
     ImageView image;

     @Override
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.main);
         image = (ImageView) findViewById(R.id.image);
         SeekBar seekBar = (SeekBar) findViewById(R.id.seekbar);

         seekBar.setOnSeekBarChangeListener(new OnSeekBarChangeListener() {
             // 当拖动条的滑块位置发生改变时触发该方法
             @Override
             public void onProgressChanged(SeekBar arg0, int progress,
                     boolean fromUser) {
                 // 动态改变图片的透明度
                 image.setAlpha(progress);
             }
             @Override
             public void onStartTrackingTouch(SeekBar bar) {
             }
             @Override
             public void onStopTrackingTouch(SeekBar bar) {
             }
         });
     }
 }

===== 星级评分条(RatingBar)的功能和用法 =====

# RatingBar与SeekBar最大区别在于：RatingBar通过星星来表示进度。

【RatingBar支持的常见XML属性】
android:rating 设置该星级评分条默认的星级
android:numStars 设置该星级评分条总共有多少个星级
android:stepSize 设置每次最少需要改变多少个星级
android:isIndicator 设置该星级评分条是否允许用户改变(true为不允许修改)

为了让程序能相应星级评分的改变，程序可以考虑为它绑定一个OnRatingBarChangeListener监听器。

范例：通过星级改变图片的透明度

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="vertical"
     android:layout_width="fill_parent"
     android:layout_height="fill_parent">
 <ImageView
     android:id="@+id/image"
     android:layout_width="fill_parent"
     android:layout_height="240px"
     android:src="@drawable/lijiang" />
 <!-- 定义一个星级评分条 -->
 <RatingBar
     android:id="@+id/rating"
     android:layout_width="wrap_content"
     android:layout_height="wrap_content"
     android:numStars="5"
     android:max="255"
     android:progress="255"
     android:stepSize="0.5" />
 </LinearLayout>

 public class RatingBarTest extends Activity {
     ImageView image;

     @Override
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.main);
         image = (ImageView) findViewById(R.id.image);
         RatingBar ratingBar = (RatingBar) findViewById(R.id.rating);

         ratingBar.setOnRatingBarChangeListener(new OnRatingBarChangeListener() {
             // 当拖动条的滑块位置发生改变时触发该方法
             @Override
             public void onRatingChanged(RatingBar arg0, float rating,
                     boolean fromUser) {
                 // 动态改变图片的透明度，其中255是星级评分条的最大值
                 // 5个星星就代表最大值255
                 image.setAlpha((int) (rating * 255 / 5));
             }
         });
     }
 }

由于上面定义RatingBar时指定了android:stepSize="0.5"，因此该星级评分条中星级的最小变化为0.5，也就是

最少要变化半个星级。

【改变样式】其中XML属性 style="@style/roomRatingBar"的样式如下：

styles.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="roomRatingBar" parent="@android:style/Widget.RatingBar">
       <item name="android:progressDrawable">@drawable/room_rating_bar</item>
       <item name="android:minHeight">16dip</item>
       <item name="android:maxHeight">16dip</item>
    </style>
</resources>

上面的意思是继承@android:style/Widget.RatingBar，重写android:progressDrawable属性，换成我们自定义@drawable/room_rating_bar文件。

控制该组件的最大和最小高度。好我们继续去找这自定义文件@drawable/room_rating_bar。

room_rating_bar.xml

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+android:id/background"
    android:drawable="@drawable/room_unselect" />
    <item android:id="@+android:id/secondaryProgress"
    android:drawable="@drawable/room_unselect" />
    <item android:id="@+android:id/progress"
    android:drawable="@drawable/room_select" />
</layer-list>