> Dialog是一個(gè)常見的顯示在當(dāng)前activity之上的小窗口。下面的activity會(huì)失去焦點(diǎn),而dialog回接受用戶輸入。dialog常用在與程序直接相關(guān)聯(lián)的通知和短小的activity中。 Android API支持以下幾種dialog: 它可以包含0、1、2、3個(gè)按鈕,或者一個(gè)列表或者多選單選按鈕等,它是一個(gè)功能最強(qiáng)大的dialog接口,詳細(xì)信息可參考下面的章節(jié)。 它會(huì)顯示一個(gè)進(jìn)度條或者進(jìn)度環(huán),因?yàn)樗茿lertDialog的子類,所有野支持按鈕。 用來選擇日期的對(duì)話框。 用來選擇時(shí)間的。 如果你想要定制自己的dialog,你可以繼承Dialog對(duì)象,或者它的任何一個(gè)子類,并且定義一個(gè)新的布局。 Dialog 總是被當(dāng)做activity的一部分來創(chuàng)建和顯示。你可以在activity的onCreateDialog(int)方法中創(chuàng)建一個(gè)dialog。當(dāng)你使用這個(gè)方法,android系統(tǒng)會(huì)自動(dòng)的管理每個(gè)dialog的狀態(tài)并且關(guān)聯(lián)到所在的activity中,讓這個(gè)activity成為dialog的管理者。每個(gè)dialog都會(huì)繼承activity的某些特性。例如,當(dāng)dialog打開時(shí),按下menu彈出的是所在activity的菜單,調(diào)節(jié)的是所在activity的音量。 注意:如果你決定在onCreateDialog()方法之外建立dialog,他將不會(huì)連接到activity中,此時(shí),你可以使用setOwnerActivity(Activity)方法來綁定activity。 當(dāng)你顯示dialog時(shí),調(diào)用showDialog(int)來傳遞一個(gè)dialog的id句柄。 當(dāng)一個(gè)dialog首次顯示時(shí),android會(huì)在實(shí)例化dialog的activity中調(diào)用onCreateDialog(int)方法。回調(diào)方法會(huì)傳遞相同的id給showDialog(int)。當(dāng) 創(chuàng)建完一個(gè)dialog后,會(huì)再方法的最后返回這個(gè)對(duì)象。 在dialog顯示前,android回調(diào)用可選的方法 :onPrepareDialog(int,Dialog)。如果你想在每次調(diào)用dialog時(shí)改變一些配置的話,你可以定義這個(gè)方法。OnPrepareDialog(int,Dialog)方法會(huì)在每次調(diào)用dialog時(shí)調(diào)用,而onCreateDialog(int)方法只會(huì)調(diào)用一次。如果你不定義onPrepareDialog()方法,那么打開的dialog會(huì)保持上一次的狀態(tài)。這個(gè)方法也會(huì)傳遞dialog的id句柄。 定義這兩個(gè)onXXX()方法最好使用一個(gè)switch結(jié)構(gòu)來檢測(cè)Id參數(shù),每一個(gè)case項(xiàng)都應(yīng)該創(chuàng)建自己的dialog。例如。想象一個(gè) 游戲使用兩個(gè)不同的dialog,一個(gè)暫停一個(gè)結(jié)束游戲:
- static final int DIALOG_PAUSED_ID = 0;
static final int DIALOG_GAMEOVER_ID = 1;
復(fù)制代碼然后,再onCreateDialog(int)里根據(jù)id創(chuàng)建dialog: - protected Dialog onCreateDialog(int id) {
Dialog dialog;
switch(id) {
case DIALOG_PAUSED_ID:
// do the work to define the pause Dialog
break;
case DIALOG_GAMEOVER_ID:
// do the work to define the game over Dialog
break;
default:
dialog = null;
}
return dialog;
}
復(fù)制代碼注意:在例子中沒有詳寫,因?yàn)槎xdialog屬于另外的章節(jié)?,F(xiàn)在可以調(diào)用showDilaog(int)來顯示一個(gè)dialog了: - showDialog(DIALOG_PAUSED_ID);
復(fù)制代碼 調(diào)用dialog的dismiss()方法可以隱藏正在顯示的dialog,如果必要的話,可以調(diào)用activity的dismissDialog(int)方法,他倆效果是一樣的。如果使用的onCreateDialog(int)方法來管理dialog的狀態(tài),那么每次當(dāng)你的dialog消失時(shí),對(duì)話框的狀態(tài)都會(huì)被activity保存著。如果不太需要這個(gè)對(duì)話框或者不希望activity保留dialog的狀態(tài),可以調(diào)用removeDialog(int)方法。它會(huì)刪除任何關(guān)于dialog的引用,如果dialog正在顯示,此方法會(huì)讓dialog隱藏。隱藏dialog監(jiān)聽器的使用如果你想讓activity在dialog隱藏時(shí)執(zhí)行某些動(dòng)作,那么你可以建立一個(gè)監(jiān)聽器。首先定義DialogInterface.OnDismissListerner 接口,這個(gè)接口只有一個(gè)方法,onDismiss(DialogInterface),當(dāng)dialog隱藏時(shí)被調(diào)用,然后傳遞OnDismissListener 對(duì)象給setOnDismissLister()方法。然而,注意dialog也可以是取消,用戶讓這個(gè)dialog取消也是一種特殊的情況。當(dāng)用戶按下back鍵時(shí),或者調(diào)用cancel()方法時(shí)會(huì)發(fā)生這種情況。當(dāng)一個(gè)dialog被取消時(shí),OnDismissLister監(jiān)聽器仍然會(huì)收到通知,但如果你喜歡的到明確的取消消息,可以注冊(cè)DialogInterface.OnCancelLister監(jiān)聽器。
AlertDialog時(shí)Dialog的子類,Dilaog絕大多數(shù)是這個(gè)強(qiáng)大類型,你可以在以下情況下使用:@ 一個(gè)標(biāo)題@ 一個(gè)文本信息@ 一個(gè)兩個(gè)或者三個(gè)按鈕@ 一個(gè)單選或者多選列表建立AlertDialog,使用AlertDialog.Builder子類。使用AlertDialog.Builder(Context)方法來獲得一個(gè)Builder,并且使用它的公共方法來定義AlertDialog所有的屬性。最后,調(diào)用create()方法來顯示。下面顯示了如何定義AlertDialog.Builder類的一些屬性,如果在onCreateDialog()方法中使用了例子中的代碼,你可以返回結(jié)果對(duì)話框來顯示這個(gè)dialog。
創(chuàng)建一個(gè)上圖所示包含按鈕的AlertDialog,可以使用setXXXButton()方法: - AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setMessage("Are you sure you want to exit?")
.setCancelable(false)
.setPositiveButton("Yes", new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int id) {
MyActivity.this.finish();
}
})
.setNegativeButton("No", new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int id) {
dialog.cancel();
}
});
AlertDialog alert = builder.create();
復(fù)制代碼首先,通過setMessage(CharSequence)為dialog添加一個(gè)message,然后通過setCancelable(boolean)方法讓此dialog無法通過按back鍵來取消。每個(gè)按鈕都需要調(diào)用setXXXButton()方法,例如setPositiveButton()方法,DialogInterface.OnClickListener()類會(huì)定義按下按鈕所要做的處理。注意:每種類型的按鈕只能加一個(gè),這就是說,你不能添加多于一個(gè)的positive按鈕。最多能添加三個(gè)按鈕,positive, neutral, 和 negative.他們名字所顯示的功能并未實(shí)現(xiàn),但能幫你記住要實(shí)現(xiàn)的功能。
如上圖所示,使用setItems()方法添加可選列表: - final CharSequence[] items = {"Red", "Green", "Blue"};
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("Pick a color");
builder.setItems(items, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int item) {
Toast.makeText(getApplicationContext(), items[item], Toast.LENGTH_SHORT).show();
}
});
AlertDialog alert = builder.create();
復(fù)制代碼首先,使用setTitle(CharSequence)方法設(shè)置標(biāo)題,然后使用setItem()方法添加可選列表,這個(gè)列表會(huì)接收一個(gè)item數(shù)組來顯示,DialogInterFace.OnClickListener類會(huì)定義他們的點(diǎn)擊事件。 通過setMultiChoiceItems()方法或 setSingleChoiceItems()方法來分別建立一個(gè)多選按鈕列表或者單選列表,如果再onCreateDialog()方法中建立了其中一種列表,android會(huì)為你管理這個(gè)list。當(dāng)activity處于 活動(dòng)狀態(tài)時(shí),dialog會(huì)記住當(dāng)才選中項(xiàng),如果退出了程序,選擇結(jié)果便會(huì)丟失。注意:當(dāng)用戶離開或者暫停activity時(shí),如果你想保存選擇狀態(tài),你必須在整個(gè)activity的生命周期中保存這個(gè)設(shè)置。永久的保存所選項(xiàng),甚至當(dāng)前進(jìn)程完全被關(guān)閉,你需要使用數(shù)據(jù)存儲(chǔ)方式來保存。建立一個(gè)如上圖所示的列表dialog,代碼和上面的例子相同,只需要把setItems()方法改為setSingleChoiceItems()方法即可。 - final CharSequence[] items = {"Red", "Green", "Blue"};
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("Pick a color");
builder.setSingleChoiceItems(items, -1, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int item) {
Toast.makeText(getApplicationContext(), items[item], Toast.LENGTH_SHORT).show();
}
});
AlertDialog alert = builder.create();
復(fù)制代碼setSingleChoiseItems()方法的第二個(gè)參數(shù)是checkedItem的id值,從0開始對(duì)應(yīng)著位置,如果返回”-1“表明沒有選中任何項(xiàng)。
ProgressDialog時(shí)AlertDialog的子類,它會(huì)顯示一個(gè)表示進(jìn)度的圓形動(dòng)畫,來表示一個(gè)進(jìn)度或者任務(wù)正在運(yùn)行,也可以時(shí)一個(gè)進(jìn)度條,能清晰的表示出進(jìn)度。他也能添加按鈕,比如取消一個(gè)下載進(jìn)程。調(diào)用ProgressDialog.show()方法可以顯示進(jìn)程對(duì)話框,例如,上圖的對(duì)話框可通過如下代碼生成: - ProgressDialog dialog = ProgressDialog.show(MyActivity.this, "",
"Loading. Please wait...", true);
復(fù)制代碼第一個(gè)參數(shù)是程序的Context引用,四二個(gè)為標(biāo)題,第三個(gè)為顯示的信息,最后一個(gè)為類型,(當(dāng)創(chuàng)建進(jìn)度條時(shí)才會(huì)用到,下節(jié)討論)。默認(rèn)的進(jìn)度條為圓形的樣式,如果你想生成一個(gè)通過具體數(shù)值來顯示任務(wù)的加載情況的進(jìn)度條,下一節(jié)會(huì)討論。進(jìn)度條的顯示顯示一個(gè)進(jìn)度條要經(jīng)過以下幾個(gè)步驟:1-使用ProgressDialog(Context)方法初始化2-使用setProgressStyle(int)方法設(shè)置類型。3-調(diào)用show()方法顯示,或者在onCreateDialog(int)方法里返回一個(gè)ProgressDialog。4-你可以調(diào)用setProgress(int)方法,根據(jù)整體的任務(wù)完成度來設(shè)置一個(gè)具體進(jìn)度值,或者使用incrementPressBy(int)來設(shè)置一個(gè)增長(zhǎng)值。例如: - ProgressDialog progressDialog;
progressDialog = new ProgressDialog(mContext);
progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
progressDialog.setMessage("Loading...");
progressDialog.setCancelable(false);
復(fù)制代碼設(shè)置代碼非常簡(jiǎn)單,大部分代碼是在dialog參與進(jìn)程并且更新的功能里。你會(huì)發(fā)現(xiàn),另起一個(gè)線程來做這個(gè)工作是很有必要的,要把消息傳遞給activity的UI線程里需要用到 Handler 消息機(jī)制。如果你并不熟悉使用額外的線程,那么看這個(gè)例子:這個(gè)例子使用了第二個(gè)線程來跟蹤任務(wù)的進(jìn)度(實(shí)際上只是在數(shù)值上加到100),線程通過 Handler 發(fā)了一個(gè)Message 給主activity,然后主activity更新ProgressDialog。 - package com.example.progressdialog;
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.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
public class NotificationTest extends Activity {
static final int PROGRESS_DIALOG = 0;
Button button;
ProgressThread progressThread;
ProgressDialog progressDialog;
/** Called when the activity is first created. */
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// Setup the button that starts the progress dialog
button = (Button) findViewById(R.id.progressDialog);
button.setOnClickListener(new OnClickListener(){
public void onClick(View v) {
showDialog(PROGRESS_DIALOG);
}
});
}
protected Dialog onCreateDialog(int id) {
switch(id) {
case PROGRESS_DIALOG:
progressDialog = new ProgressDialog(NotificationTest.this);
progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
progressDialog.setMessage("Loading...");
progressThread = new ProgressThread(handler);
progressThread.start();
return progressDialog;
default:
return null;
}
}
// Define the Handler that receives messages from the thread and update the progress
final Handler handler = new Handler() {
public void handleMessage(Message msg) {
int total = msg.getData().getInt("total");
progressDialog.setProgress(total);
if (total >= 100){
dismissDialog(PROGRESS_DIALOG);
progressThread.setState(ProgressThread.STATE_DONE);
}
}
};
/** Nested class that performs progress calculations (counting) */
private class ProgressThread extends Thread {
Handler mHandler;
final static int STATE_DONE = 0;
final static int STATE_RUNNING = 1;
int mState;
int total;
ProgressThread(Handler h) {
mHandler = h;
}
public void run() {
mState = STATE_RUNNING;
total = 0;
while (mState == STATE_RUNNING) {
try {
Thread.sleep(100);
} catch (InterruptedException e) {
Log.e("ERROR", "Thread Interrupted");
}
Message msg = mHandler.obtainMessage();
Bundle b = new Bundle();
b.putInt("total", total);
msg.setData(b);
mHandler.sendMessage(msg);
total++;
}
}
/* sets the current state for the thread,
* used to stop the thread */
public void setState(int state) {
mState = state;
}
}
}
復(fù)制代碼 如果你想自定義dialog的布局,你可以自己創(chuàng)建一個(gè)dialog布局。定義好之后,傳遞根View對(duì)象或者資源ID到setContextView(View)方法。例如,如上圖的dialog:1-建立一個(gè)xml布局文件custom_dialog.xml;
- <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/layout_root"
android:orientation="horizontal"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:padding="10dp"
>
<ImageView android:id="@+id/image"
android:layout_width="wrap_content"
android:layout_height="fill_parent"
android:layout_marginRight="10dp"
/>
<TextView android:id="@+id/text"
android:layout_width="wrap_content"
android:layout_height="fill_parent"
android:textColor="#FFF"
/>
</LinearLayout>
復(fù)制代碼 這個(gè)xml在LinearLayout里定義了一個(gè)ImageView和TextView。 2-設(shè)置上面的布局為dialog的context view ,并且定義ImageView和TextView兩個(gè)元素。
- Context mContext = getApplicationContext();
Dialog dialog = new Dialog(mContext);
dialog.setContentView(R.layout.custom_dialog);
dialog.setTitle("Custom Dialog");
TextView text = (TextView) dialog.findViewById(R.id.text);
text.setText("Hello, this is a custom dialog!");
ImageView image = (ImageView) dialog.findViewById(R.id.image);
image.setImageResource(R.drawable.android);
復(fù)制代碼實(shí)例化dialog后,使用setContextView(int)方法設(shè)置自定義的布局?,F(xiàn)在dialog便有了一個(gè)自定義的布局,你可以使用findViewById(int)方法來獲得或者修改布局。3-完成了,現(xiàn)在你可以顯示自定義的dialog了。一個(gè)dialog必須有一個(gè)title,如果你沒有調(diào)用setTitile()方法,那么會(huì)標(biāo)題處會(huì)顯示空,但dialog仍然可見,如果你不想顯示標(biāo)題,只有寫一個(gè)自己的dialog類了。然而,因?yàn)橐粋€(gè)AlertDialog使用AlertDialog.builder類創(chuàng)建起來非常簡(jiǎn)單,你不必使用setContextView(int)方法。但必須使用setView(view)方法代替。這個(gè)方法會(huì)接受一個(gè)view參數(shù),你需要從xml中得到根view元素。得到xml布局,通過LayoutInflater類的getLayoutflater()方法(或者getSystemService()方法),然后調(diào)用inflate(int,ViewGroup)方法,第一個(gè)參數(shù)是xml文件id,第二個(gè)參數(shù)是根view的id,在這點(diǎn)上,你可以使用inflated 布局來獲得xml中的view對(duì)象并且定義ImageView和TextView對(duì)象,然后實(shí)例化AlertDialog.Builder類并且使用setView(View)方法來設(shè)置布局。這有一個(gè)自定義dialog布局文件的例子: - AlertDialog.Builder builder;
AlertDialog alertDialog;
Context mContext = getApplicationContext();
LayoutInflater inflater = (LayoutInflater) mContext.getSystemService(LAYOUT_INFLATER_SERVICE);
View layout = inflater.inflate(R.layout.custom_dialog,
(ViewGroup) findViewById(R.id.layout_root));
TextView text = (TextView) layout.findViewById(R.id.text);
text.setText("Hello, this is a custom dialog!");
ImageView image = (ImageView) layout.findViewById(R.id.image);
image.setImageResource(R.drawable.android);
builder = new AlertDialog.Builder(mContext);
builder.setView(layout);
alertDialog = builder.create();
復(fù)制代碼使用自定義布局這種方式來生成dialog,可以讓你使用更高級(jí)的特性,比如管理按鈕、列表、標(biāo)題、圖標(biāo)等。
|