`
bcyy
  • 浏览: 1809484 次
文章分类
社区版块
存档分类
最新评论

Android用户界面---对话框(dialogs)

 
阅读更多

对话框通常是一个显示在当前Activity之前的小窗口。它下面的Activity会失去焦点,并且对话框会接受所有的用户交互。对话框通常用于通知用户中断操作的,并且要执行与应用程序内进度直接相关的短期任务(如进度条或登录提示)。

Dialog类是创建对话框的基类。但你通常不应该直接实例化Dialog类,而应该使用以下之类。

AlertDialog

一个能够有一个、两个、三个或没有按钮的对话框,并且能够包含一组复选框或单选按钮的可选项列表。AlertDialog对话框有构造大多数对话框用户界面的能力,并且是被建议的对话框类型。

ProgressDialog

显示一个进度滚轮或进度条的对话框。因为它是AlertDialog类型对话框的扩展,所以它也支持按钮。

DatePickerDialog

允许用户选择日期的对话框。

TimePickerDialog

允许用户选择时间的对话框。

如果你喜欢定制自己对话框,你能够继承Dialog类或上面介绍的任何子类,并且要定义一个新的布局。

显示对话框

对话框总是作为Activity的一部分来创建和显示的。你通常应该在Activity的onCreateDialog(int)回调方法内创建对话框。在使用这个回调方法时,Android系统会自动的管理每个对话框的状态,并且把它们跟Activity挂在一起,让Activity成为每个对话框的拥有者。这样每个对话框都会从Activity中继承一些属性。例如,当对话框打开时,菜单键依然能够显示给Activity定义的选项菜单,并且音量调节键依然能调整Activity使用的音频流的音量。

注意:如果你在onCreateDialog()方法外部创建了一个对话框,那么它就不会跟Activity捆绑在一起。但是,你能够使用setOwnerActivity(Activity)方法来完成捆绑操作。

在首次请求一个对话框是,Android会调用源自Activity中的onCreateDialog(int)方法,这是初始化对话框的地方。这个回调方法被传入一个与你传递给showDialog(int)方法相同的ID。创建了这个对话框后,在这个回调方法的最后返回对话框对象。

在对话框显示之前,Android系统也会选择性的调用onPrepareDialog(int, Dialog)回调方法。如果你想要每次打开对话框时都要改变它的一些属性,那么就要定义这个方法。这个方法在每次打开对话框时被调用,而onCreateDialog(int)方法仅会在首次打开对话框时被调用。如果你没有定义onPrepareDialog()方法,那么对话框会保留它前次被打开的状态。这个方法也要传递一个对话框的ID,跟在onCreateDialog()方法中创建对话框对象的ID一样。

定义onCreateDialog(int)和onPrepareDialog(int, Dialog)回调方法的最好方式是使用一个switch语句来检查传递给这个方法的id参数,每个case语句应该用来检查唯一的对话框ID,对于匹配的ID就创建和定义对应的对话框。例如,假设一个使用两个不同对话框的游戏,一个指示游戏已经被挂起了,另一个指示游戏结束了。首先要给每个对话框定义一个整数ID:

static final int DIALOG_PAUSED_ID = 0;
static final int DIALOG_GAMEOVER_ID = 1;

然后用户switch语句定义onCreateDialog(int)回调方法。

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语句中没有代码,因为定义对话框的过程超出了本节讨论的范围。在下面创建AlertDialog对话框一节中,会提供适合这个例子的代码。

当要显示一个对话框时,要调用带有这个对话框ID的showDialog(int)方法:

showDialog(DIALOG_PAUSED_ID);

废弃话框

当你准备关闭对话框时,你能够在对话框对象上调用dismiss()方法来废弃它,如果需要,也能够从Activity中调用dismissDialog(int)方法,它与对话框上的dismiss()方法等效。

如果你使用onCreateDialog(int)方法来管理对话框的状态,那么对话框每次被废弃后,这个对话框对象的状态会依然被它的Activity保留着。如果你决定不再需要这个对象,或者清除它的状态是至关重要的,那么应该调用removeDialog(int)方法。这样就会删除应用内部对这个对话框对象的任何引用,并且如果对话框正显示着,removeDialog(int)方法也会废弃它。

使用废弃监听器

如果你要让应用程序在对话框被废弃时执行一些处理,那么就应该给这个对话框绑定一个on-dismiss监听器。

首先要定义DialogInterface.OnDismissListener接口。这个接口只有一个onDismiss(DialogInterface)方法,它在对话框被废弃时被调用。然后把OnDismissListener的接口实现传递给setOnDismissListener()方法。

但是,要注意,对话框也能被取消。这种特定的情况是指对话框被用户明确的取消。如果用户按了回退按钮来关闭对话框或对话框明确的调用了cancel()方法(如用户点击了对话框中的取消按钮)就会发生这种情况。当对话框被取消时,onDismissListener回调依然会收到通知,但是如果你希望得到对话框明确的取消(不是废弃)的通知,那么你应该用setOnCancelListener()方法注册一个DialogInterface.OnCancelListener监听器。

创建AlertDialog型对话框

AlertDialog型对话框是Dialog类的扩展,它有构建大多数对话框用户界面的能力,并且是被建议使用的对话框类型。对于具有下列特征的对话框,你都应该使用这种类型的对话框。

1.标题;

2.文本消息;

3.有一个、两个或三个按钮;

4.一个可选项目的列表(一组复选框或单选按钮)。

使用AlertDialog.Builder子类来创建一个AlerDialog型的对话框。用AlertDialog.Builder(Context)方法获得一个构造器,然后使用这个构造器的公共方法来定义所有的对话框属性。用这个构造器设定完对话框属性之后,就可以用create()方法来获取AlertDialog对话框对象。

以下说明如何使用AlertDialog.Builder类来定义AlertDialog对话框的各种属性。如果你在onCreateDialog()方法中使用下面示例中任何代码,那么就能够返回让对话框显示的对话框对象。

添加按钮

使用set…Button()方法创建一个带有两并排按钮的对话框,如图1所示:

pic

创建代码如下:

AlertDialog.Builder builder =newAlertDialog.Builder(this);
builder.setMessage("Are you sure you want to exit?")
       .setCancelable(false)
       .setPositiveButton("Yes",newDialogInterface.OnClickListener(){
           publicvoid onClick(DialogInterface dialog,int id){
             MyActivity.this.finish();
           }
       })
       .setNegativeButton("No",newDialogInterface.OnClickListener(){
           publicvoid onClick(DialogInterface dialog,int id){
                dialog.cancel();
           }
       });
AlertDialog alert = builder.create();

首先用setMessage(CharSequence)方法给对话框添加一个消息。然后开始设置对话框属性,并且用setCancelable(Boolean)方法设置对话框不可取消(用户不能够永回退按钮关闭这个对话框)。使用set…Button方法来添加每个按钮,如setPositiveButton()方法,它接受一个按钮的名称和定义用户选择按钮时要执行的操作的DialogInterface.OnClickListener()回调方法。

注意:每种类型的按钮,你只能给AlerDialog对话框添加一个。也就是说你不能有多个”positive”按钮。这样就限制了三种按钮可能的数量:positive、neutral、negative。这些名字不代表按钮的实际功能,但是它们能够帮助你记忆每个按钮做要做的操作。

添加一个列表

要创建一个如图2所示的带有可选项列表的AlertDialog型对话框,就要使用setItems()方法:

pic

图2.

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

首先,用setTitle(charSequence)方法给对话框添加一个标题,然后,用setItems()方法让添加一个可选列表,这个方法需要两个参数:一个是要显示的列表项数组,另一个是定义用户选择项目时所以执行的操作的DialogInterface.OnClickListener监听器。

添加复选框和单选按钮

分别使用setMultiChoiceItems()和setSingleChoiceItems()方法,在对话框内部创建一个多选(复选框)或单选(单选按钮)项目的列表。如果你在onCreateDialog()回调方法中创建了其中一种可选列表,Android系统会为你管理列表的状态。对话框记住之前被选择的项目的时间会跟它所捆绑的Activity的生存周期一样长,当用户推出这个Activity时,对话框对应的选择也就丢失了。

注意:要在用户离开或挂起Activity时保存选择的项目,就必须在整个Activity生存周期中恰当的保存和恢复这些设置。要持久的保存被选择的项目,即使是在Activity处理被完成销毁时,就需要用一种数据存储技术来保存这些设置。

要创建一个如下图3所示的单选项目列表的AlertDialog型对话框,会使用与前面的示例代码相同的代码,但是要用setSingleChoiceItems()方法替代setItems()方法。

pic

图3

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

setSingleChoiceItems()方法的第二个参数是可选项目列表中项目的索引值,默认可选项目的位置是0,如果使用”-1”,那么默认情况下,就不应该有列表项被选择。

创建进度对话框

ProgressDialog是AlertDialog类的一个扩展,它能够用滚轮动画的形式显示一个未明确定义进度的任务,或者用一个进度条来显示明确定义了进度的任务。这中对话框也能够提供按钮,如取消按钮。

能够简单的调用ProgressDialog.show()方法来打开一个进度对话框。通过onCreateDialog(int)回调方法可以很容易的把图4所示的没有接受管理的对话框捆绑到指定的Activity上。

pic

图4

sDialog dialog =ProgressDialog.show(MyActivity.this,"", 
                        "Loading. Please wait...",true);

这个方法的第一个参数是应用程序的Context对象,第二个参数是对话框的标题(设置为空),第三个参数是消息,最后一个参数指定进度是否是不确定的。

进度对话框的默认样式是一个旋转的轮子。如果你想要创建一个显示加载进度的进度条对话框,请看下节的讨论。

显示进度条

显示一个如图5所示的带有动画的进度条的步骤如下:

pic

1.用类构造器(ProgressDialog(Context))实例化一个ProgressDialog型对话框;

2.用setProgressStyle(int)方法设置进度条的样式:STYLE_HORIZONTAL,并且设置其他属性,如消息等。

3.准备显示对话框时,调用show()方法,或者从onCreateDialog(int)回调方法中返回ProgressDialog对象;

4.你既可以通过调用setProgress(int)方法也可以调用incrementProgressBy(int)方法来设置显示进度的增量。不同的是setProgress(int)方法用到目前为止完成总的百分比值来设置进度,而incrementProgressBy(int)方法是用到目前为止总的进度的增量值来设置进度条的显示。

如:可能步骤如下:

ProgressDialog progressDialog;
progressDialog =newProgressDialog(mContext);
progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
progressDialog.setMessage("Loading...");
progressDialog.setCancelable(false);

创建一个定制的对话框

如果你要定制设计一个对话框,你能够给对话框窗口创建自己的布局,这个布局带有布局和可视构件元素。定义完布局以后,把根View对象或布局资源ID传递给setContentView(view)方法。

如,创建一个如图6所示的对话框的步骤如下:

pic

图6

1.创建一个保存在custom_dialog.xml文件中的XML布局

<LinearLayoutxmlns: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"
              >
    <ImageViewandroid:id="@+id/image"
               android:layout_width="wrap_content"
               android:layout_height="fill_parent"
               android:layout_marginRight="10dp"
               />
    <TextViewandroid:id="@+id/text"
              android:layout_width="wrap_content"
              android:layout_height="fill_parent"
              android:textColor="#FFF"
              />
</LinearLayout>

这个XML在LinearLayout元素内部定义了一个ImageView对象和TextView对象。

2.把上面的这个布局设置为对话框的内容视窗,并且给ImageView和TextView元素定义显示内容:

Context mContext = getApplicationContext();
Dialog dialog =newDialog(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);

实例化对话框之后,用setContentView(int)方法,把你定制的布局设置给对话框的内容视窗。现在对话框已经有了一个被定义的布局,你能够用findViewById(int)方法从布局中获取View对象,并可以修改它们的内容。

3.用上面介绍的显示对话框的方法显示对话框。

用基本对话框构造的对话框一定会有一个标题栏。如果你没有调用setTitle()方法,那么标题所使用的空间就会使空的,但依然可见。如果你不想要标题,那么就应该使用AlertDialog类创建定制的对话框。但是,因为AlertDialog型对话框用AlertDialog.Builder类最容易创建,所以不会使用上面的setContentView(int)方法。相反,你必须使用setView(View)方法。这个方法接受一个View对象,以便把布局填充到指定的View对象中。

用getLayoutInflater()方法(或getSystemService()方法)获取LayoutInflater对象,然后调用这个对象的inflate(int, ViewGroup)方法来填充XML布局。第一个参数是布局的资源ID,第二个参数是根View对象的ID。这时,你能够使用被填充的布局来查找布局中的View对象,并且给ImageView和TextView元素定义内容,然后实例化这个AlertDialog.Builder对象,并用setView(View)方法把填充好的布局设置给对话框。

以下示例,在AlertDialog型对话框中创建一个定制的布局:

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 =newAlertDialog.Builder(mContext);
builder.setView(layout);
alertDialog = builder.create();

给定制的布局使用AlertDialog型对话框,你会利用AlertDialog型对话框内置特征,如按钮管理、可选列表、标题、图标等。

分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics