android基础知识30：Dialog02——showDialog()、onPrepareDialog()和onCreateDialog()的关系

       Activities提供了一种方便管理的创建、保存、回复的对话框机制，例如 onCreateDialog(int), onPrepareDialog(int, Dialog), showDialog(int), dismissDialog(int)等方法，如果使用这些方法的话，Activity将通过 getOwnerActivity()方法返回该Activity管理的对话框(dialog).

　　onCreateDialog(int):当你使用这个回调函数时，Android系统会有效的设置这个Activity为每个对话框的所有者，从而自动管理每个对话框的状态并挂靠到Activity上。这样，每个对话框继承这个Activity的特定属性。比如，当一个对话框打开时，菜单键显示为这个 Activity定义的选项菜单，音量键修改Activity使用的音频流。

　　showDialog(int): 当你想要显示一个对话框时，调用showDialog(int id) 方法并传递一个唯一标识这个对话框的整数。当对话框第一次被请求时，Android从你的Activity中调用onCreateDialog(int id)，你应该在这里初始化这个对话框Dialog。这个回调方法被传以和showDialog(int id)相同的ID。当你创建这个对话框后，在Activity的最后返回这个对象。

　　onPrepareDialog(int, Dialog):在对话框被显示之前，Android还调用了可选的回调函数onPrepareDialog(int id, Dialog). 如果你想在每一次对话框被打开时改变它的任何属性，你可以定义这个方法。这个方法在每次打开对话框时被调用，而onCreateDialog(int) 仅在对话框第一次打开时被调用。如果你不定义onPrepareDialog()，那么这个对话框将保持和上次打开时一样。这个方法也被传递以对话框的 ID，和在onCreateDialog()中创建的对话框对象。

　　dismissDialog(int):当你准备关闭对话框时，你可以通过对这个对话框调用dismiss()来消除它。如果需要，你还可以从这个Activity中调用 dismissDialog(int id) 方法，这实际上将为你对这个对话框调用dismiss() 方法。 如果你想使用onCreateDialog(int id) 方法来管理你对话框的状态(就如同在前面的章节讨论的那样)，然后每次你的对话框消除的时候，这个对话框对象的状态将由该Activity保留。如果你决定不再需要这个对象或者清除该状态是重要的，那么你应该调用removeDialog(int id)。这将删除任何内部对象引用而且如果这个对话框正在显示，它将被消除。

　　----> showDialog()调用createDialog()和onPrepareDialog()，其中createDialog()调用onCreateDialog()。
项目源码：

package com.bn.ex2s;

import android.app.Activity;
import android.app.Dialog;
import android.app.ProgressDialog;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;

public class Sample2_19_Activity extends Activity
{
    final int PROGRESS_DIALOG = 0;
    final int INCREASE = 0;
    final int MAX_COUNTER = 100;
   
    ProgressDialog pd;
    Handler hd;
   
    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
       
        Button bok = (Button) this.findViewById(R.id.Button01);
        bok.setOnClickListener
        (
            new OnClickListener()
            {
                @Override  
                public void onClick(View v)
                {
                    showDialog(PROGRESS_DIALOG);                   
                }
            }
        ); 
       
        hd = new Handler()
        {
            @Override
            public void handleMessage(Message msg)  //必须重写此方法，用于接收数据
            {
                super.handleMessage(msg);               
                switch(msg.what)
                {
                   case INCREASE:
                     pd.incrementProgressBy(1);//进度每次加1
                        if(pd.getProgress() >= MAX_COUNTER)
                        {
                            pd.dismiss();                                
                        }                      
                   break;
                }
            }
        };
    }
   
    @Override
    public Dialog onCreateDialog(int id)
    {
        switch(id)
        {
              case  PROGRESS_DIALOG:
                 pd = new ProgressDialog(this);
                 pd.setMax(MAX_COUNTER);//设置最大值
                 pd.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL); 
                 pd.setTitle(R.string.title);//设置标题
                 pd.setCancelable(false);//设置进度对话框不能用回退按钮关闭    
                 Log.d("kkk", "kkk");
              break;
        }       
        return pd;
    }  
   
    @Override
    //每次弹出对话框时被回调以动态更新对话框内容的方法
    public void onPrepareDialog(int id, Dialog dialog)
    {
        super.onPrepareDialog(id, dialog);
           switch(id)
           {
          case  PROGRESS_DIALOG:
            pd.incrementProgressBy(-pd.getProgress());//对话框进度清零
            new Thread()
            {
                  public void run()
                  {
                    while(true)
                    {
                          hd.sendEmptyMessage(INCREASE);
                          if(pd.getProgress() >= MAX_COUNTER)
                          {
                              break;
                          }
                          try
                          {
                              Thread.sleep(40);
                          }
                          catch(Exception e)
                          {
                              e.printStackTrace();
                          }
                     }
                  }                
             }.start();
          break;
        }
    }
}       

Android SDK 源代码：

public final void showDialog(int id) {
        showDialog(id, null);
}


public final boolean showDialog(int id, Bundle args) {
        if (mManagedDialogs == null) {
            mManagedDialogs = new SparseArray<ManagedDialog>();
        }
        ManagedDialog md = mManagedDialogs.get(id);
        if (md == null) {
            md = new ManagedDialog();
            md.mDialog = createDialog(id, null, args);
            if (md.mDialog == null) {
                return false;
            }
            mManagedDialogs.put(id, md);
        }
       
        md.mArgs = args;
        onPrepareDialog(id, md.mDialog, args);
        md.mDialog.show();
        return true;
}


 private Dialog createDialog(Integer dialogId, Bundle state, Bundle args) {
        final Dialog dialog = onCreateDialog(dialogId, args);
        if (dialog == null) {
            return null;
        }
        dialog.dispatchOnCreate(state);
        return dialog;
}

参考资料：
《showDialog()、onPrepareDialog()和onCreateDialog()的关系》