【起航计划 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();  

 


 

posted @ 2015-03-06 11:31  马走日  阅读(174)  评论(0编辑  收藏  举报