Android Dialog用法

时间 2019-11-13

原文原文链接

建立对话框
　　一个对话框通常是一个出如今当前Activity之上的一个小窗口. 处于下面的Activity失去焦点, 对话框接受全部的用户交互. 对话框通常用于提示信息和与当前应用程序直接相关的小功能.
　　Android API 支持下列类型的对话框对象:
　　警告对话框 AlertDialog: 一个能够有0到3个按钮, 一个单选框或复选框的列表的对话框. 警告对话框能够建立大多数的交互界面, 是推荐的类型.
　　进度对话框 ProgressDialog: 显示一个进度环或者一个进度条. 因为它是AlertDialog的扩展, 因此它也支持按钮.
　　日期选择对话框 DatePickerDialog: 让用户选择一个日期.
　　时间选择对话框 TimePickerDialog: 让用户选择一个时间.
　　若是你但愿自定义你的对话框, 能够扩展Dialog类.
　　Showing a Dialog 显示对话框
　　一个对话框老是被建立和显示为一个Activity的一部分. 你应该在Activity的onCreateDialog(int)中建立对话框. 当你使用这个回调函数时,Android系统自动管理每一个对话框的状态并将它们和Activity链接, 将Activity变为对话框的"全部者". 这样,每一个对话框从Activity继承一些属性. 例如,当一个对话框打开时, MENU键会显示Activity的菜单, 音量键会调整Activity当前使用的音频流的音量.
　　注意: 若是你但愿在onCreateDialog()方法以外建立对话框, 它将不会依附在Activity上. 你可使用setOwnerActivity(Activity)来将它依附在Activity上.
　　当你但愿显示一个对话框时, 调用showDialog(int)并将对话框的id传给它.
　　当一个对话框第一次被请求时,Android调用onCreateDialog(int). 这里是你初始化对话框的地方. 这个回调函数传入的id和showDialog(int)相同. 建立对话框以后,将返回被建立的对象.
　　在对话框被显示以前,Android还会调用onPrepareDialog(int, Dialog). 若是你但愿每次显示对话框时有动态更改的内容, 那么就改写这个函数. 该函数在每次一个对话框打开时都调用. 若是你不定义该函数,则对话框每次打开都是同样的. 该函数也会传入对话框的id以及你在onCreateDialog()中建立的Dialog对象.
　　最好的定义onCreateDialog(int) 和onPrepareDialog(int, Dialog) 的方法就是使用一个switch语句来检查传入的id. 每一个case建立相应的对话框. 例如, 一个游戏使用两个对话框: 一个来指示游戏暂停,另外一个指示游戏结束. 首先, 为它们定义ID:static final int DIALOG_PAUSED_ID = 0;
static final int DIALOG_GAMEOVER_ID = 1;
而后, 在onCreateDialog(int)中加入一个switch语句:
java

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;  
}

　　注意: 在这个例子中, case语句为空由于定义Dialog的程序在后面会有介绍.
　　在须要显示对话框是, 调用showDialog(int), 传入对话框的id:
　　showDialog(DIALOG_PAUSED_ID);Dismissing a Dialog 解除对话框
　　当你准备关闭对话框时, 你可使用dismiss()函数. 若是须要的话, 你也能够从Activity调用dismissDialog(int), 两者效果是同样的.
　　若是你使用onCreateDialog(int)来管理你的对话框的状态, 那么每次你的对话框被解除时, 该对话框对象的状态会被Activity保存. 若是你决定你再也不须要这个对象或者须要清除对话框的状态, 那么你应该调用 removeDialog(int). 这将把全部该对象的内部引用移除, 若是该对话框在显示的话将被解除.
　　Using dismiss listeners 使用解除监听器
　　若是你但愿在对话框解除时运行某些程序, 那么你应该给对话框附加一个解除监听器.
　　首先定义DialogInterface.OnDismissListener接口. 这个接口只有一个方法, onDismiss(DialogInterface), 该方法将在对话框解除时被调用.
　　而后将你的OnDismissListener实现传给setOnDismissListener().
　　然而,注意对话框也能够被"取消". 这是一个特殊的情形, 它意味着对话框被用户显式的取消掉. 这将在用户按下"back"键时, 或者对话框显式的调用cancel()(按下对话框的cancel按钮)时发生. 当一个对话框被取消时, OnDismissListener将仍然被通知, 但若是你但愿在对话框被显示取消(而不是正常解除)时被通知, 则你应该使用setOnCancelListener()注册一个DialogInterface.OnCancelListener.
　　Creating an AlertDialog 建立警告对话框
　　An AlertDialog is an extension of the Dialog class. It is capable of constructing most dialog user interfaces and is the suggested dialog type. You should use it for dialogs that use any of the following features:
　　一个警告对话框是对话框的一个扩展. 它可以建立大多数对话框用户界面而且是推荐的对话框类新星. 对于须要下列任何特性的对话框,你都应该使用它:
　　一个标题
　　一条文字消息
　　1个-3个按钮
　　一个可选择的列表(单选框或者复选框)
　　要建立一个AlertDialog, 使用AlertDialog.Builder子类. 使用AlertDialog.Builder(Context)来获得一个Builder, 而后使用该类的公有方法来定义AlertDialog的属性. 设定好之后, 使用create()方法来得到AlertDialog对象.
　　下面的主题展现了如何为AlertDialog定义不一样的属性, 使用AlertDialog.Builder类. 若是你使用这些示例代码, 你能够在onCreateDialog()中返回最后的Dialog对象来得到图片中对话框的效果.
　　Adding buttons 增长按钮android

要建立一个如图所示的窗口，使用set...Button()方法：app

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();

首先，使用setMessage(CharSequence)为对话框增长一条消息。而后，开始连续调用方法，使用setCancelable(boolean)将对话框设为不可取消（不能使用back键来取消）。对每个按钮，使用set...Button()方法，该方法接受按钮名称和一个DialogInterface.OnClickListener，该监听器定义了当用户选择该按钮时应作的动做。
　　注意：对每种按钮类型，只能为AlertDialog建立一个。也就是说，一个AlertDialog不能有两个以上的"positive"按钮。这使得可能的按钮数量最多为三个：确定、否认、中性。这些名字和实际功能没有联系，可是将帮助你记忆它们各作什么事情。函数

Adding a list 增长列表布局

要建立一个具备可选项的AlertDialog，使用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();

首先增长一个标题。而后使用setItems()增长一个可选列表，该列表接受一个选项名称的列表和一个DialogInterface.OnClickListener, 后者定义了选项对应的响应。ui

Adding checkboxes and radio buttons 增长单选框和复选框this

要建立一个带有多选列表或者单选列表的对话框，使用setMultiChoiceItems()和setSingleChoiceItems()方法。若是你在onCreateDialog()中建立可选择列表, Android会自动管理列表的状态. 只要activity仍然活跃, 那么对话框就会记住刚才选中的选项，但当用户退出activity时，该选择丢失。
　　注意: 要在你的acitivity离开和暂停时保存选择，你必须在activity的声明周期中正确的保存和恢复设置。为了永久性保存选择，你必须使用数据存储技术中的一种。
　　要建立一个具备单选列表的AlertDialog，只需将一个例子中的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();

第二个参数是默认被选中的选项位置，使用“-1”来表示默认状况下不选中任何选项。code

Creating a ProgressDialog 建立进度对话框

一个ProgressDialog(进度对话框)是AlertDialog的扩展。它能够显示一个进度的动画——进度环或者进度条。这个对话框也能够提供按钮，例如取消一个下载等。
　　打开一个进度对话框很简单，只须要调用 ProgressDialog.show()便可。例如，上图的对话框能够不经过onCreateDialog(int)，而直接显示：
　　ProgressDialog dialog = ProgressDialog.show(MyActivity.this, "",
　　"Loading. Please wait...", true);
　　第一个参数是应用程序上下文。第二个为对话框的标题（这里为空），第三个为对话框内容，最后一个为该进度是否为不可肯定的（这只跟进度条的建立有关，见下一节）。
　　进度对话框的默认样式为一个旋转的环。若是你但愿显示进度值，请看下一节。
　　Showing a progress bar 显示进度条
　　使用一个动画进度条来显示进度：
　　使用 ProgressDialog(Context)构造函数来初始化一个ProgressDialog对象。
　　将进度样式设置为"STYLE_HORIZONTAL"，使用setProgressStyle(int)方法。而且设置其它属性，例如内容等。
　　在须要显示时调用show()或者从onCreateDialog(int)回调函数中返回该ProgressDialog。
　　你可使用 setProgress(int)或者incrementProgressBy(int)来增长显示的进度。
　　例如，你的设置可能像这样：ProgressDialog progressDialog;
progressDialog = new ProgressDialog(mContext);
progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
progressDialog.setMessage("Loading...");
progressDialog.setCancelable(false);
　　设置很简单。大部分建立进度对话框须要的代码是在更新它的进程中。你可能须要在一个新的线程中更新它，并使用Handler来将进度报告给Activity。若是你不熟悉使用Handler和另外的线程，请看下列例子，该例子使用了一个新的线程来更新进度。
　　Example ProgressDialog with a second thread 例--使用一个线程来显示进度对话框
　　这个例子使用一个线程来跟踪一个进程的进度（其实为从1数到100）。每当进度更新时，该线程经过Handler给主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;  
        }  
    }  
}

Creating a Custom Dialog 建立自定义对话框

若是你想自定义一个对话框，你可使用布局元素来创造你的对话框的布局。定义好布局后，将根View对象或者布局资源ID传给setContentView(View).
例如，建立如图所示的对话框：
建立一个xml布局custom_dialog.xml:

<?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:id="@+id/ll_dialog"
    android:background="#00ff00"
    android:orientation="vertical">

    <TextView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:text="有更新啦~~" />

</LinearLayout>

该xml定义了一个LinearLayout中的一个ImageView 和一个TextView。
将以上布局设为对话框的content view，而且定义ImageView 和 TextView的内容：

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);  //注释 此段代码不是个人

在初始化Dialog以后，使用setContentView(int)，将布局资源id传给它。如今Dialog有一个定义好的布局，你可使用findViewById(int)来找到该元素的id并修改它的内容。
　　使用前面所讲的方法显示对话框。
　　一个使用Dialog类创建的对话框必须有一个标题。若是你不调用setTitle()，那么标题区域会保留空白。若是你不但愿有一个标题，那么你应该使用AlertDialog类来建立自定义对话框。然而，因为一个AlertDialog使用AlertDialog.Builder类来创建最方便，因此你没有方法使用setContentView(int)，而是只能使用setView(View)。该方法接受一个View对象，因此你须要从xml中展开你的根View。
　　要展开一个xml布局，使用 getLayoutInflater() (或 getSystemService())取得LayoutInflater，而后调用inflate(int, ViewGroup)，第一个参数为布局id，而第二个参数为根view的id。如今，你可使用展开后的布局来找到View对象并定义ImageView和TextView元素的内容。而后实例化AlertDialog.Builder并使用setView(View)来为对话框设置展开后的布局。例如：

//展现dialog
        AlertDialog.Builder builder= new AlertDialog.Builder(mContext);
        LayoutInflater inflater = LayoutInflater.from(mContext);
        View layout = inflater.inflate(R.layout.update_dialog, (ViewGroup) ((Activity) mContext).findViewById(R.id.ll_dialog));
        builder.setView(layout);
        AlertDialog alertDialog = builder.create();
        alertDialog.show();

使用AlertDialog来自定义对话框，能够利用其内置特性例如按钮、选择列表、标题、图标等。