【起航计划 020】2015 起航计划 Android APIDemo的魔鬼步伐 19 App->Dialog Dialog样式

这个例子的主Activity定义在AlertDialogSamples.java 主要用来介绍类AlertDialog的用法，AlertDialog提供的功能是多样的：

• 显示消息给用户，并可提供一到三个按钮（OK, Cancel ,Yes ,No)用于选择或是显示警告。
• 显示一个列表以供用户选择,列表中可以是Radio Button  (单选),Check button (多选)
• 显示文本框来接受用户输入等。

创建AlertDialog一般是通过AlertDialog.Builder来构造：

AlertDialog.Builder ad=new AlertDialog.Builder(context);

之后可以为这个AlergDialog设置标题，显示的信息，需要显示的Buttons等。然后调用 ad.show来显示这个对话框。

为了避免每次显示对话框都新建一个Dialog对象，Android提供两个方法 onCreateDialog和onPrepareDialog事件来管理对话框的创建。

通过重载onCreateDialog，可以根据需要（如执行showDialog时）创建所需对话框实例。而在创建这个对话框实例后，在每次 showDialog之前，如果需要对这个对话框做些修改可以重载onPrepareDialog方法来实现。 原理和Android管理Menu的方法类似。

下面给出使用AlertDialog的一般步骤。因为在onCreateDialog可能创建多个Dialog示例，所以必须先定义一个Dialog的ID。

    private static final int DIALOG_YES_NO_MESSAGE = 1;
    private static final int DIALOG_YES_NO_LONG_MESSAGE = 2;
    private static final int DIALOG_LIST = 3;
    private static final int DIALOG_PROGRESS = 4;
    private static final int DIALOG_SINGLE_CHOICE = 5;
    private static final int DIALOG_MULTIPLE_CHOICE = 6;
    private static final int DIALOG_TEXT_ENTRY = 7;
    private static final int DIALOG_MULTIPLE_CHOICE_CURSOR = 8;
    private static final int DIALOG_YES_NO_ULTRA_LONG_MESSAGE = 9;
    private static final int DIALOG_YES_NO_OLD_SCHOOL_MESSAGE = 10;
    private static final int DIALOG_YES_NO_HOLO_LIGHT_MESSAGE = 11;
    private static final int DIALOG_YES_NO_DEFAULT_LIGHT_MESSAGE = 12;
    private static final int DIALOG_YES_NO_DEFAULT_DARK_MESSAGE = 13;
    private static final int DIALOG_PROGRESS_SPINNER = 14;

然后重载onCreateDialog，参数id为Dialog ID，可以根据id来创建需要的Dialog实例：

@Override
protected Dialog onCreateDialog(int id) {
 switch (id) {
 case DIALOG_YES_NO_MESSAGE:
 return new AlertDialog.Builder(AlertDialogSamples.this)
 .setIcon(R.drawable.alert_dialog_icon)
 .setTitle(R.string.alert_dialog_two_buttons_title)
 .setPositiveButton(R.string.alert_dialog_ok,
    new DialogInterface.OnClickListener() {
 public void onClick(DialogInterface dialog, int whichButton) {

 /* User clicked OK so do some stuff */
 }
 })
 .setNegativeButton(R.string.alert_dialog_cancel,
     new DialogInterface.OnClickListener() {
 public void onClick(DialogInterface dialog, int whichButton) {

 /* User clicked Cancel so do some stuff */
 }
 })
 .create();

 ...

显示Dialog：

showDialog(DIALOG_YES_NO_MESSAGE);  

App->Dialog目前通过14个例子来说明AlertDialog的多种用法：

OK Cancel dialog with a message

前面显示的代码就是这个例子的代码，使用AlertDialog.Builder创建一个AlertDialog示例 ，然后通过setIcon，setTitle，setPositiveButton，setNegativeButton设置这个对话框的图标，标 题，OK和Cancel Button。 标题也不知道是什么语言：-（。

OK Cancel dialog with a long message

这个例子中使用setMessage来显示一个很长的信息（可以有滚动条），并通过setNeutralButton 添加一个中间按钮。

List Dialog

AlertDialog 可以用来显示一组选项来获取用户选择。对应静态的选项可以先定义一个Array资源：

<!– Used in app/dialog examples –>
<string-array name=”select_dialog_items”>
<item>Command one</item>
< item>Command two</item>
< item>Command three</item>
< item>Command four</item>
< /string-array>

然后调用setItems 来显示这些选项：

    case DIALOG_LIST:
     return new AlertDialog.Builder(AlertDialogSamples.this)
     .setTitle(R.string.select_dialog)
     .setItems(R.array.select_dialog_items, new DialogInterface.OnClickListener() {
     public void onClick(DialogInterface dialog, int which) {  

     /* User clicked so do some stuff */
     String[] items = getResources().getStringArray(R.array.select_dialog_items);
     new AlertDialog.Builder(AlertDialogSamples.this)
     .setMessage("You selected: " + which + " , " + items[which])
     .show();
     }
     })
     .create();  

Progress dialog

这个例子显示了ProgressDialog的用法，ProgressDialog为AlertDialog的子类，ProgressDialog 无需通过AlertDialog.Builder 构造，可以直接通过构造函数来创建ProgressDialog的实例。ProgressDialog可以显示一个标题和一个进度条。因此比 AlertDialog多了几个方法：setProgressStyle ，setMax等来配置进度条的属性。

注： 这个例子还使用里Handler 来更新进度条，Handler将在后面的例子介绍。

    case DIALOG_PROGRESS:
     mProgressDialog = new ProgressDialog(AlertDialogSamples.this);
     mProgressDialog.setIcon(R.drawable.alert_dialog_icon);
     mProgressDialog.setTitle(R.string.select_dialog);
     mProgressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
     mProgressDialog.setMax(MAX_PROGRESS);
     mProgressDialog.setButton(getText(R.string.alert_dialog_hide),
     new DialogInterface.OnClickListener() {
     public void onClick(DialogInterface dialog, int whichButton) {  

     /* User clicked Yes so do some stuff */
     }
     });
     mProgressDialog.setButton2(getText(R.string.alert_dialog_cancel),
     new DialogInterface.OnClickListener() {
     public void onClick(DialogInterface dialog, int whichButton) {  

     /* User clicked No so do some stuff */
     }
     });
     return mProgressDialog;  

Single choice list

AlertDialog 显示列表时，可以指定为单选或是多选。将前面List中的setItems方法改成setSingleChoiceItems可以使用RadioButton来显示列表：

    case DIALOG_SINGLE_CHOICE:
     return new AlertDialog.Builder(AlertDialogSamples.this)
     .setIcon(R.drawable.alert_dialog_icon)
     .setTitle(R.string.alert_dialog_single_choice)
     .setSingleChoiceItems(R.array.select_dialog_items2, 0,
     new DialogInterface.OnClickListener() {
     public void onClick(DialogInterface dialog, int whichButton) {  

     /* User clicked on a radio button do some stuff */
     }
     })
     .setPositiveButton(R.string.alert_dialog_ok,
     new DialogInterface.OnClickListener() {
     public void onClick(DialogInterface dialog, int whichButton) {  

     /* User clicked Yes so do some stuff */
     }
     })
     .setNegativeButton(R.string.alert_dialog_cancel,
     new DialogInterface.OnClickListener() {
     public void onClick(DialogInterface dialog, int whichButton) {  

     /* User clicked No so do some stuff */
     }
     })
     .create();  

Repeat alarm

这个例子调用setMultiChoiceItems 方法使用CheckButton来显示列表，表示可以多选

    case DIALOG_MULTIPLE_CHOICE:
     return new AlertDialog.Builder(AlertDialogSamples.this)
     .setIcon(R.drawable.ic_popup_reminder)
     .setTitle(R.string.alert_dialog_multi_choice)
     .setMultiChoiceItems(R.array.select_dialog_items3,
     new boolean[]{false, true, false, true, false, false, false},
     new DialogInterface.OnMultiChoiceClickListener() {
     public void onClick(DialogInterface dialog,
     int whichButton,
     boolean isChecked) {  

     /* User clicked on a check box do some stuff */
     }
     })
     .setPositiveButton(R.string.alert_dialog_ok,
     new DialogInterface.OnClickListener() {
     public void onClick(DialogInterface dialog, int whichButton) {  

     /* User clicked Yes so do some stuff */
     }
     })
     .setNegativeButton(R.string.alert_dialog_cancel,
     new DialogInterface.OnClickListener() {
     public void onClick(DialogInterface dialog, int whichButton) {  

     /* User clicked No so do some stuff */
     }
     })
     .create();  

Send Call to VoiceMail

上面例子中列表项都是通过定义Array资源来实现的，列表项还可以使用Content Provider作为数据源。这个例子使用通讯录中的记录作为数据源，如果在模拟器运行，请先添加几个Contacts。Content Provider介绍请参见Android ApiDemo示例解析(10)：App->Activity->QuickContactsDemo

    case DIALOG_MULTIPLE_CHOICE_CURSOR:
    String[] projection = new String[] {
    Contacts.People._ID,
    Contacts.People.NAME,
    Contacts.People.SEND_TO_VOICEMAIL
    };
    Cursor cursor = managedQuery(Contacts.People.CONTENT_URI,
    projection, null, null, null);
    return new AlertDialog.Builder(AlertDialogSamples.this)
    .setIcon(R.drawable.ic_popup_reminder)
    .setTitle(R.string.alert_dialog_multi_choice_cursor)
    .setMultiChoiceItems(cursor,
    Contacts.People.SEND_TO_VOICEMAIL,
    Contacts.People.NAME,
    new DialogInterface.OnMultiChoiceClickListener() {
    public void onClick(DialogInterface dialog,
    int whichButton,
    boolean isChecked) {
    Toast.makeText(AlertDialogSamples.this,
    "Readonly Demo Only
    - Data will not be updated",
    Toast.LENGTH_SHORT).show();
    }
    })
    .create();  

Text Entry Dialog

最后一个例子是使用文本框来接受用户输入。AlertDialog也允许自定义UI，可以使用自定义的Layout做为AlertDialog的 UI。 理论上可以使用任意的Layout，这样可以避免使用派生Dialog的方法来自定义对话框。本例使用alert_dialog_text_entry ，其中定义里两个TextView显示Name:和Password:标签 ,两个EditText接受用户输入。 然后使用setView为AlertDialog定义自定义的UI。

    case DIALOG_TEXT_ENTRY:
    // This example shows how to add a custom layout to an AlertDialog
    LayoutInflater factory = LayoutInflater.from(this);
    final View textEntryView
    = factory.inflate(R.layout.alert_dialog_text_entry, null);
    return new AlertDialog.Builder(AlertDialogSamples.this)
    .setIcon(R.drawable.alert_dialog_icon)
    .setTitle(R.string.alert_dialog_text_entry)
    .setView(textEntryView)
    .setPositiveButton(R.string.alert_dialog_ok,
    new DialogInterface.OnClickListener() {
    public void onClick(DialogInterface dialog, int whichButton) {  

    /* User clicked OK so do some stuff */
    }
    })
    .setNegativeButton(R.string.alert_dialog_cancel,
    new DialogInterface.OnClickListener() {
    public void onClick(DialogInterface dialog, int whichButton) {  

    /* User clicked cancel so do some stuff */
    }
    })
    .create();