Dialog工具箱 – ProgressDialog

素颜马尾好姑娘i 2022-09-30 06:53 159阅读 0赞

在此前的几个教程中引出过一些Dialog的使用方法，可从来没有系统全面的介绍Android平台上所有Dialog家族成员的情况（其实官方文档有相当明确的说明：[参考1][1]、[参考2][2]）。对于大部分人可以直接根据官方文档获得有关Dialog的使用方法，AR给出的有关Dialog参考教程可以作为额外的补充。

在这里为大家介绍[ProgressDialog][]的使用方法：

![ProgressDialog.jpg][]

1) 创建一个普通ProgressDialog（不带有ProgressBar）所必须的几个参数

*  Context: 指定当前Dialog的Container
 *  Title:对话框标题
 *  Message:对话框主体所显示的信息
 *  Indeterminate:不确定性属性，这个属性对于ProgressDailog默认的转轮模式没有实际意义，默认下设置为true，它仅仅对带有ProgressBar的Dialog有作用。

2）以下两个为可选参数

*  Cancelable:增加一个可以Cancel当前Dialog的按钮，强制退出。
 *  CancelListner:当前Dialog强制取消之后将会被执行，通常用来清理未完成的任务。

快速创建一个ProgressDialog的方法（代码片段）：  
01.private ProgressDialog dialog;  
02.private Handler handler = new Handler() \{  
03.    public void handleMessage(Message msg)  
04.    \{  
05.        dialog.dismiss();  
06.    \}  
07.\};  
08.private Thread checkUpdate = new Thread()  
09.\{  
10.    public void run() \{    
11.  
  
12.      try \{  
13.        sleep(3000);  
14.    \} catch (InterruptedException e) \{  
15.        // TODO Auto-generated catch block  
16.        e.printStackTrace();  
17.    \}  
18.      handler.sendEmptyMessage(0);  
19.    \}  
20.\};  
21.@Override  
22.public void onCreate(Bundle savedInstanceState) \{  
23.    super.onCreate(savedInstanceState);  
24.    setContentView(R.layout.main);     
25.  
  
26.    final Button button = (Button) findViewById(R.id.Compute);  
27.    button.setOnClickListener(new View.OnClickListener()  
28.    \{  
29.  
  
30.        public void onClick(View arg0) \{  
31.            // TODO Auto-generated method stub  
32.            checkUpdate.stop();  
33.            dialog = ProgressDialog.show(ARTestDrawing2D.this,  
34.                      "AndroidRes",  
35.                      "I am thinking...",  
36.                      true,true);  
37.            checkUpdate.start();  
38.        \}  
39.  
  
40.    \});  
41.\}

上边的例子中引用了[Handler][]（official）作为multi-thread[相互传递数据][Link 1]的载体，接下来为ProgressDialog实现一个可视化进度条(progressBar)的方法中依然需要调用[Handler][Handler 1](Internal)，借用这个例子大家也可以多了解Handler的用法。

![ProgressBar.jpg][]

利用一个可视化进度条取代第一个例子中比较抽象的旋转轮，让用户更加直观的了解当前任务的进度。初始化的方法如下：  
1.dialog = new ProgressDialog(ARTestDrawing2D.this);  
2.dialog.setProgressStyle(ProgressDialog.STYLE\_HORIZONTAL);  
3.dialog.setTitle("AndroidRes");  
4.dialog.setMessage("I am thinking...");  
  
  
看起来稍微比第一个例子复杂一些，每个参数都单独利用成员方法赋值。  
其中SetProgressStyle用来设置显示模式，通常为STYLE\_HORIZONTAL。下边通过一个完整的例子了解它的初始化和设置方法（例子来源于[Android官网][1]）：  
01.static final int PROGRESS\_DIALOG = 0;  
02.Button button;  
03.ProgressThread checkUpdate;  
04.ProgressDialog dialog;  
05.  
  
06./\*\* Called when the <a title="activity" href="[http://www.androidres.com/index.php/2009/02/09/activity/][http_www.androidres.com_index.php_2009_02_09_activity]">activity</a> is first created. \*/  
07.public void onCreate(Bundle savedInstanceState) \{  
08.    super.onCreate(savedInstanceState);  
09.    setContentView(R.layout.main);  
10.  
  
11.    // Setup the button that starts the progress dialog  
12.    button = (Button) findViewById(R.id.Compute);  
13.    button.setOnClickListener(new OnClickListener()\{  
14.        public void onClick(View v) \{  
15.            showDialog(PROGRESS\_DIALOG);  
16.        \}  
17.    \});  
18.\}  
19.  
  
20.protected Dialog onCreateDialog(int id) \{  
21.    switch(id) \{  
22.    case PROGRESS\_DIALOG:  
23.        dialog = new ProgressDialog(ARTestDrawing2D.this);  
24.        dialog.setProgressStyle(ProgressDialog.STYLE\_HORIZONTAL);  
25.        dialog.setTitle("AndroidRes");  
26.        dialog.setMessage("I am thinking...");  
27.        checkUpdate = new ProgressThread(handler);  
28.        checkUpdate.start();  
29.        return dialog;  
30.    default:  
31.        return null;  
32.    \}  
33.\}  
34.  
  
35.// Define the Handler that receives messages from the thread and update the progress  
36.final Handler handler = new Handler() \{  
37.    public void handleMessage(Message msg) \{  
38.        int total = msg.getData().getInt("total");  
39.        dialog.setProgress(total);  
40.        if (total >= 100)\{  
41.            dismissDialog(PROGRESS\_DIALOG);  
42.            checkUpdate.setState(ProgressThread.STATE\_DONE);  
43.            total = 0;  
44.        \}  
45.    \}  
46.\};  
47.  
  
48./\*\* Nested class that performs progress calculations (counting) \*/  
49.private class ProgressThread extends Thread \{  
50.    Handler mHandler;  
51.    final static int STATE\_DONE = 0;  
52.    final static int STATE\_RUNNING = 1;  
53.    int mState;  
54.    int total;  
55.  
  
56.    ProgressThread(Handler h) \{  
57.        mHandler = h;  
58.    \}  
59.  
  
60.    public void run() \{  
61.        mState = STATE\_RUNNING;  
62.        total = 0;  
63.        while (mState == STATE\_RUNNING) \{  
64.            try \{  
65.                Thread.sleep(100);  
66.            \} catch (InterruptedException e) \{  
67.                Log.e("ERROR", "AndroidRes Thread Interrupted");  
68.            \}  
69.            Message msg = mHandler.obtainMessage();  
70.            Bundle b = new Bundle();  
71.            b.putInt("total", total);  
72.            msg.setData(b);  
73.            mHandler.sendMessage(msg);  
74.            total++;  
75.        \}  
76.    \}  
77.  
  
78.    /\* sets the current state for the thread,  
79.     \* used to stop the thread \*/  
80.    public void setState(int state) \{  
81.        mState = state;  
82.    \}  
83.\}  
  
  
例子理解起来相对比较容易，对两个比较主要的对象做个简单的说明：  
**checkUpdate**: 从主线程中创建一个用于计算某项任务的线程，同时也是利用ProgessBar所追踪的对象，指示这个线程的任务进度。  
**handler**: 利用这个Handler可以将线程中的数据实时反映到主线程中的ProgessBar，使其可以实时接收到最新进度数据。  
**Share and Enjoy:**

[1]: http://developer.android.com/guide/topics/ui/dialogs.html
[2]: http://developer.android.com/reference/android/app/Dialog.html
[ProgressDialog]: http://developer.android.com/reference/android/app/ProgressDialog.html
[ProgressDialog.jpg]: /images/20220708/9c57a476aebb482b926052acef13c438.png
[Handler]: http://developer.android.com/reference/android/os/Handler.html
[Link 1]: http://www.androidres.com/?p=456
[Handler 1]: http://www.androidres.com/?p=330
[ProgressBar.jpg]: /images/20220708/05f7852b9f8f44ddadfaa00f2b9a220e.png
[http_www.androidres.com_index.php_2009_02_09_activity]: http://www.androidres.com/index.php/2009/02/09/activity/