Dialog工具箱 – ProgressDialog

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

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



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       try { 

12         sleep(3000); 

13     } catch (InterruptedException e) { 

14         // TODO Auto-generated catch block 

15         e.printStackTrace(); 

16     } 

17       handler.sendEmptyMessage(0); 

18     } 

19 }; 

20 @Override

21 public void onCreate(<A title=Bundle href="http://developer.android.com/reference/android/os/Bundle.html" target=_blank>Bundle</A> savedInstanceState) { 

22     super.onCreate(savedInstanceState); 

23     setContentView(R.layout.main);     

24     final Button button = (Button) findViewById(R.id.Compute); 

25     button.setOnClickListener(new View.OnClickListener() 

26     { 

27         public void onClick(View arg0) { 

28             // TODO Auto-generated method stub 

29             checkUpdate.stop(); 

30             dialog = ProgressDialog.show(ARTestDrawing2D.this, 

31                       "AndroidRes", 

32                       "I am thinking...", 

33                       true,true); 

34             checkUpdate.start(); 

35         } 

36     }); 

37 }

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



利用一个可视化进度条取代第一个例子中比较抽象的旋转轮，让用户更加直观的了解当前任务的进度。初始化的方法如下：

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官网）：

01 static final int PROGRESS_DIALOG = 0; 

02 Button button; 

03 ProgressThread checkUpdate; 

04 ProgressDialog dialog; 

05 /** Called when the <A title=activity href="http://www.androidres.com/index.php/2009/02/09/activity/">activity</A> is first created. */

06 public void onCreate(Bundle savedInstanceState) { 

07     super.onCreate(savedInstanceState); 

08     setContentView(R.layout.main); 

09     // Setup the button that starts the progress dialog 

10     button = (Button) findViewById(R.id.Compute); 

11     button.setOnClickListener(new OnClickListener(){ 

12         public void onClick(View v) { 

13             showDialog(PROGRESS_DIALOG); 

14         } 

15     }); 

16 } 

17 protected Dialog onCreateDialog(int id) { 

18     switch(id) { 

19     case PROGRESS_DIALOG: 

20         dialog = new ProgressDialog(ARTestDrawing2D.this); 

21         dialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL); 

22         dialog.setTitle("AndroidRes"); 

23         dialog.setMessage("I am thinking..."); 

24         checkUpdate = new ProgressThread(handler); 

25         checkUpdate.start(); 

26         return dialog; 

27     default: 

28         return null; 

29     } 

30 } 

31 // Define the Handler that receives messages from the thread and update the progress 

32 final Handler handler = new Handler() { 

33     public void handleMessage(Message msg) { 

34         int total = msg.getData().getInt("total"); 

35         dialog.setProgress(total); 

36         if (total >= 100){ 

37             dismissDialog(PROGRESS_DIALOG); 

38             checkUpdate.setState(ProgressThread.STATE_DONE); 

39             total = 0; 

40         } 

41     } 

42 }; 

43 /** Nested class that performs progress calculations (counting) */

44 private class ProgressThread extends Thread { 

45     Handler mHandler; 

46     final static int STATE_DONE = 0; 

47     final static int STATE_RUNNING = 1; 

48     int mState; 

49     int total; 

50     ProgressThread(Handler h) { 

51         mHandler = h; 

52     } 

53     public void run() { 

54         mState = STATE_RUNNING; 

55         total = 0; 

56         while (mState == STATE_RUNNING) { 

57             try { 

58                 Thread.sleep(100); 

59             } catch (InterruptedException e) { 

60                 Log.e("ERROR", "AndroidRes Thread Interrupted"); 

61             } 

62             Message msg = mHandler.obtainMessage(); 

63             Bundle b = new Bundle(); 

64             b.putInt("total", total); 

65             msg.setData(b); 

66             mHandler.sendMessage(msg); 

67             total++; 

68         } 

69     } 

70     /* sets the current state for the thread, 

71      * used to stop the thread */

72     public void setState(int state) { 

73         mState = state; 

74     } 

75 }

例子理解起来相对比较容易，对两个比较主要的对象做个简单的说明：
checkUpdate: 从主线程中创建一个用于计算某项任务的线程，同时也是利用ProgessBar所追踪的对象，指示这个线程的任务进度。
handler: 利用这个Handler可以将线程中的数据实时反映到主线程中的ProgessBar，使其可以实时接收到最新进度数据。