AlertDialog.Builder

Builder

public Builder (Context context)

Creates a builder for an alert dialog that uses the default alert dialog theme.

The default alert dialog theme is defined by R.attr.alertDialogTheme within the parent context's theme.

Builder

public Builder (Context context, 
                int themeResId)

Creates a builder for an alert dialog that uses an explicit theme resource.

The specified theme resource (themeResId) is applied on top of the parent context's theme. It may be specified as a style resource containing a fully-populated theme, such as R.style.Theme_Material_Dialog, to replace all attributes in the parent context's theme including primary and accent colors.

To preserve attributes such as primary and accent colors, the themeResId may instead be specified as an overlay theme such as R.style.ThemeOverlay_Material_Dialog. This will override only the window attributes necessary to style the alert window as a dialog.

Alternatively, the themeResId may be specified as 0 to use the parent context's resolved value for R.attr.alertDialogTheme.

create

public AlertDialog create ()

Creates an AlertDialog with the arguments supplied to this builder.

Calling this method does not display the dialog. If no additional processing is needed, show() may be called instead to both create and display the dialog.

getContext

public Context getContext ()

Returns a Context with the appropriate theme for dialogs created by this Builder. Applications should use this Context for obtaining LayoutInflaters for inflating views that will be used in the resulting dialogs, as it will cause views to be inflated with the correct theme.

setAdapter

public AlertDialog.Builder setAdapter (ListAdapter adapter, 
                DialogInterface.OnClickListener listener)

Set a list of items, which are supplied by the given ListAdapter, to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener.

setCancelable

public AlertDialog.Builder setCancelable (boolean cancelable)

Sets whether the dialog is cancelable or not. Default is true.

setCursor

public AlertDialog.Builder setCursor (Cursor cursor, 
                DialogInterface.OnClickListener listener, 
                String labelColumn)

Set a list of items, which are supplied by the given Cursor, to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener.

setCustomTitle

public AlertDialog.Builder setCustomTitle (View customTitleView)

Set the title using the custom view customTitleView.

The methods setTitle(int) and setIcon(int) should be sufficient for most titles, but this is provided if the title needs more customization. Using this will replace the title and icon set via the other methods.

Note: To ensure consistent styling, the custom view should be inflated or constructed using the alert dialog's themed context obtained via getContext().

setIcon

public AlertDialog.Builder setIcon (Drawable icon)

Set the Drawable to be used in the title.

Note: To ensure consistent styling, the drawable should be inflated or constructed using the alert dialog's themed context obtained via getContext().

setIcon

public AlertDialog.Builder setIcon (int iconId)

Set the resource id of the Drawable to be used in the title.

Takes precedence over values set using setIcon(android.graphics.drawable.Drawable).

setIconAttribute

public AlertDialog.Builder setIconAttribute (int attrId)

Set an icon as supplied by a theme attribute. e.g. R.attr.alertDialogIcon.

Takes precedence over values set using setIcon(int) or setIcon(android.graphics.drawable.Drawable).

setInverseBackgroundForced

public AlertDialog.Builder setInverseBackgroundForced (boolean useInverseBackground)

This method was deprecated in API level 23.
This flag is only used for pre-Material themes. Instead, specify the window background using on the alert dialog theme.

Sets the alert dialog to use the inverse background, regardless of what the contents is.

setItems

public AlertDialog.Builder setItems (int itemsId, 
                DialogInterface.OnClickListener listener)

Set a list of items to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. This should be an array type i.e. R.array.foo

setItems

public AlertDialog.Builder setItems (CharSequence[] items, 
                DialogInterface.OnClickListener listener)

Set a list of items to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener.

setMessage

public AlertDialog.Builder setMessage (int messageId)

Set the message to display using the given resource id.

setMessage

public AlertDialog.Builder setMessage (CharSequence message)

Set the message to display.

setMultiChoiceItems

public AlertDialog.Builder setMultiChoiceItems (CharSequence[] items, 
                boolean[] checkedItems, 
                DialogInterface.OnMultiChoiceClickListener listener)

Set a list of items to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. The list will have a check mark displayed to the right of the text for each checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

setMultiChoiceItems

public AlertDialog.Builder setMultiChoiceItems (Cursor cursor, 
                String isCheckedColumn, 
                String labelColumn, 
                DialogInterface.OnMultiChoiceClickListener listener)

Set a list of items to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. The list will have a check mark displayed to the right of the text for each checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

setMultiChoiceItems

public AlertDialog.Builder setMultiChoiceItems (int itemsId, 
                boolean[] checkedItems, 
                DialogInterface.OnMultiChoiceClickListener listener)

Set a list of items to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. This should be an array type, e.g. R.array.foo. The list will have a check mark displayed to the right of the text for each checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

setNegativeButton

public AlertDialog.Builder setNegativeButton (CharSequence text, 
                DialogInterface.OnClickListener listener)

Set a listener to be invoked when the negative button of the dialog is pressed.

setNegativeButton

public AlertDialog.Builder setNegativeButton (int textId, 
                DialogInterface.OnClickListener listener)

Set a listener to be invoked when the negative button of the dialog is pressed.

setNeutralButton

public AlertDialog.Builder setNeutralButton (CharSequence text, 
                DialogInterface.OnClickListener listener)

Set a listener to be invoked when the neutral button of the dialog is pressed.

setNeutralButton

public AlertDialog.Builder setNeutralButton (int textId, 
                DialogInterface.OnClickListener listener)

Set a listener to be invoked when the neutral button of the dialog is pressed.

setOnCancelListener

public AlertDialog.Builder setOnCancelListener (DialogInterface.OnCancelListener onCancelListener)

Sets the callback that will be called if the dialog is canceled.

Even in a cancelable dialog, the dialog may be dismissed for reasons other than being canceled or one of the supplied choices being selected. If you are interested in listening for all cases where the dialog is dismissed and not just when it is canceled, see setOnDismissListener.

setOnDismissListener

public AlertDialog.Builder setOnDismissListener (DialogInterface.OnDismissListener onDismissListener)

Sets the callback that will be called when the dialog is dismissed for any reason.

setOnItemSelectedListener

public AlertDialog.Builder setOnItemSelectedListener (AdapterView.OnItemSelectedListener listener)

Sets a listener to be invoked when an item in the list is selected.

setOnKeyListener

public AlertDialog.Builder setOnKeyListener (DialogInterface.OnKeyListener onKeyListener)

Sets the callback that will be called if a key is dispatched to the dialog.

setPositiveButton

public AlertDialog.Builder setPositiveButton (int textId, 
                DialogInterface.OnClickListener listener)

Set a listener to be invoked when the positive button of the dialog is pressed.

setPositiveButton

public AlertDialog.Builder setPositiveButton (CharSequence text, 
                DialogInterface.OnClickListener listener)

Set a listener to be invoked when the positive button of the dialog is pressed.

setSingleChoiceItems

public AlertDialog.Builder setSingleChoiceItems (int itemsId, 
                int checkedItem, 
                DialogInterface.OnClickListener listener)

Set a list of items to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. This should be an array type i.e. R.array.foo The list will have a check mark displayed to the right of the text for the checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

setSingleChoiceItems

public AlertDialog.Builder setSingleChoiceItems (ListAdapter adapter, 
                int checkedItem, 
                DialogInterface.OnClickListener listener)

Set a list of items to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. The list will have a check mark displayed to the right of the text for the checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

setSingleChoiceItems

public AlertDialog.Builder setSingleChoiceItems (Cursor cursor, 
                int checkedItem, 
                String labelColumn, 
                DialogInterface.OnClickListener listener)

Set a list of items to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. The list will have a check mark displayed to the right of the text for the checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

setSingleChoiceItems

public AlertDialog.Builder setSingleChoiceItems (CharSequence[] items, 
                int checkedItem, 
                DialogInterface.OnClickListener listener)

Set a list of items to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. The list will have a check mark displayed to the right of the text for the checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

setTitle

public AlertDialog.Builder setTitle (CharSequence title)

Set the title displayed in the Dialog.

setTitle

public AlertDialog.Builder setTitle (int titleId)

Set the title using the given resource id.

setView

public AlertDialog.Builder setView (int layoutResId)

Set a custom view resource to be the contents of the Dialog. The resource will be inflated, adding all top-level views to the screen.

setView

public AlertDialog.Builder setView (View view)

Sets a custom view to be the contents of the alert dialog.

When using a pre-Holo theme, if the supplied view is an instance of a ListView then the light background will be used.

Note: To ensure consistent styling, the custom view should be inflated or constructed using the alert dialog's themed context obtained via getContext().

show

public AlertDialog show ()

Creates an AlertDialog with the arguments supplied to this builder and immediately displays the dialog.

Calling this method is functionally identical to:

     AlertDialog dialog = builder.create();
     dialog.show();