Added in API level 1

AlertDialog

Kotlin |Java

public class AlertDialog
extends Dialog implements DialogInterface

java.lang.Object
↳	android.app.Dialog
	↳	android.app.AlertDialog

Known direct subclasses

DatePickerDialog, ProgressDialog, TimePickerDialog

DatePickerDialog	A simple dialog containing an `DatePicker`.
ProgressDialog	This class was deprecated in API level 26. `ProgressDialog` is a modal dialog, which prevents the user from interacting with the app. Instead of using this class, you should use a progress indicator like `ProgressBar`, which can be embedded in your app's UI. Alternatively, you can use a notification to inform the user of the task's progress.
TimePickerDialog	A dialog that prompts the user for the time of day using a `TimePicker`.

A subclass of Dialog that can display one, two or three buttons. If you only want to display a String in this dialog box, use the setMessage() method. If you want to display a more complex view, look up the FrameLayout called "custom" and add your view to it:

 FrameLayout fl = findViewById(android.R.id.custom);
 fl.addView(myView, new LayoutParams(MATCH_PARENT, WRAP_CONTENT));

The AlertDialog class takes care of automatically setting WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM for you based on whether any views in the dialog return true from View.onCheckIsTextEditor(). Generally you want this set for a Dialog without text editors, so that it will be placed on top of the current input method UI. You can modify this behavior by forcing the flag to your desired mode after calling onCreate(Bundle).

Developer Guides

For more information about creating dialogs, read the Dialogs developer guide.

Summary

Nested classes
`class`	`AlertDialog.Builder`

Constants
`int`	`THEME_DEVICE_DEFAULT_DARK` This constant was deprecated in API level 23. Use `R.style.Theme_DeviceDefault_Dialog_Alert`.
`int`	`THEME_DEVICE_DEFAULT_LIGHT` This constant was deprecated in API level 23. Use `R.style.Theme_DeviceDefault_Light_Dialog_Alert`.
`int`	`THEME_HOLO_DARK` This constant was deprecated in API level 23. Use `R.style.Theme_Material_Dialog_Alert`.
`int`	`THEME_HOLO_LIGHT` This constant was deprecated in API level 23. Use `R.style.Theme_Material_Light_Dialog_Alert`.
`int`	`THEME_TRADITIONAL` This constant was deprecated in API level 23. Use `R.style.Theme_Material_Dialog_Alert`.

Inherited constants

From interface android.content.DialogInterface

`int`	`BUTTON1` This constant was deprecated in API level 15. Use `BUTTON_POSITIVE`
`int`	`BUTTON2` This constant was deprecated in API level 15. Use `BUTTON_NEGATIVE`
`int`	`BUTTON3` This constant was deprecated in API level 15. Use `BUTTON_NEUTRAL`
`int`	`BUTTON_NEGATIVE` The identifier for the negative button.
`int`	`BUTTON_NEUTRAL` The identifier for the neutral button.
`int`	`BUTTON_POSITIVE` The identifier for the positive button.

Protected constructors
`AlertDialog(Context context)` Creates an alert dialog that uses the default alert dialog theme.
`AlertDialog(Context context, boolean cancelable, DialogInterface.OnCancelListener cancelListener)` Creates an alert dialog that uses the default alert dialog theme and a custom cancel listener.
`AlertDialog(Context context, int themeResId)` Creates an alert dialog that uses an explicit theme resource.

Public methods
`Button`	`getButton(int whichButton)` Gets one of the buttons used in the dialog.
`ListView`	`getListView()` Gets the list view used in the dialog.
`boolean`	`onKeyDown(int keyCode, KeyEvent event)` A key was pressed down.
`boolean`	`onKeyUp(int keyCode, KeyEvent event)` A key was released.
`void`	`setButton(CharSequence text, DialogInterface.OnClickListener listener)` This method was deprecated in API level 15. Use `setButton(int, java.lang.CharSequence, android.content.DialogInterface.OnClickListener)` with `DialogInterface.BUTTON_POSITIVE`
`void`	`setButton(int whichButton, CharSequence text, DialogInterface.OnClickListener listener)` Set a listener to be invoked when the specified button of the dialog is pressed.
`void`	`setButton(CharSequence text, Message msg)` This method was deprecated in API level 15. Use `setButton(int, java.lang.CharSequence, android.os.Message)` with `DialogInterface.BUTTON_POSITIVE`.
`void`	`setButton(int whichButton, CharSequence text, Message msg)` Set a message to be sent when a button is pressed.
`void`	`setButton2(CharSequence text, Message msg)` This method was deprecated in API level 15. Use `setButton(int, java.lang.CharSequence, android.os.Message)` with `DialogInterface.BUTTON_NEGATIVE`.
`void`	`setButton2(CharSequence text, DialogInterface.OnClickListener listener)` This method was deprecated in API level 15. Use `setButton(int, java.lang.CharSequence, android.content.DialogInterface.OnClickListener)` with `DialogInterface.BUTTON_NEGATIVE`
`void`	`setButton3(CharSequence text, Message msg)` This method was deprecated in API level 15. Use `setButton(int, java.lang.CharSequence, android.os.Message)` with `DialogInterface.BUTTON_NEUTRAL`.
`void`	`setButton3(CharSequence text, DialogInterface.OnClickListener listener)` This method was deprecated in API level 15. Use `setButton(int, java.lang.CharSequence, android.content.DialogInterface.OnClickListener)` with `DialogInterface.BUTTON_NEUTRAL`
`void`	`setCustomTitle(View customTitleView)`
`void`	`setIcon(Drawable icon)`
`void`	`setIcon(int resId)` Set resId to 0 if you don't want an icon.
`void`	`setIconAttribute(int attrId)` Set an icon as supplied by a theme attribute.
`void`	`setInverseBackgroundForced(boolean forceInverseBackground)`
`void`	`setMessage(CharSequence message)`
`void`	`setTitle(CharSequence title)` Set the title text for this dialog's window.
`void`	`setView(View view, int viewSpacingLeft, int viewSpacingTop, int viewSpacingRight, int viewSpacingBottom)` Set the view to display in that dialog, specifying the spacing to appear around that view.
`void`	`setView(View view)` Set the view to display in that dialog.

Protected methods
`void`	`onCreate(Bundle savedInstanceState)` Similar to `Activity.onCreate`, you should initialize your dialog in this method, including calling `setContentView(View)`.

Inherited methods

From class


        
          android.app.Dialog

`void`	`addContentView(View view, ViewGroup.LayoutParams params)` Add an additional content view to the screen.
`void`	`cancel()` Cancel the dialog.
`void`	`closeOptionsMenu()`
`void`	`create()` Forces immediate creation of the dialog.
`void`	`dismiss()` Dismiss this dialog, removing it from the screen.
`boolean`	`dispatchGenericMotionEvent(MotionEvent ev)` Called to process generic motion events.
`boolean`	`dispatchKeyEvent(KeyEvent event)` Called to process key events.
`boolean`	`dispatchKeyShortcutEvent(KeyEvent event)` Called to process a key shortcut event.
`boolean`	`dispatchPopulateAccessibilityEvent(AccessibilityEvent event)` Called to process population of `AccessibilityEvent`s.
`boolean`	`dispatchTouchEvent(MotionEvent ev)` Called to process touch screen events.
`boolean`	`dispatchTrackballEvent(MotionEvent ev)` Called to process trackball events.
`<T extends View> T`	`findViewById(int id)` Finds the first descendant view with the given ID or `null` if the ID is invalid (< 0), there is no matching view in the hierarchy, or the dialog has not yet been fully created (for example, via `show()` or `create()`).
`ActionBar`	`getActionBar()` Retrieve the `ActionBar` attached to this dialog, if present.
`final Context`	`getContext()` Retrieve the Context this Dialog is running in.
`View`	`getCurrentFocus()` Call `Window.getCurrentFocus()` on the Window if this Activity to return the currently focused view.
`LayoutInflater`	`getLayoutInflater()`
`OnBackInvokedDispatcher`	`getOnBackInvokedDispatcher()` Returns the `OnBackInvokedDispatcher` instance associated with the window that this dialog is attached to.
`final Activity`	`getOwnerActivity()` Returns the Activity that owns this Dialog.
`final SearchEvent`	`getSearchEvent()` During the onSearchRequested() callbacks, this function will return the `SearchEvent` that triggered the callback, if it exists.
`final int`	`getVolumeControlStream()`
`Window`	`getWindow()` Retrieve the current Window for the activity.
`void`	`hide()` Hide the dialog, but do not dismiss it.
`void`	`invalidateOptionsMenu()`
`boolean`	`isShowing()`
`void`	`onActionModeFinished(ActionMode mode)` Called when an action mode has been finished. Note that if you override this method you should always call through to the superclass implementation by calling super.onActionModeFinished(mode).
`void`	`onActionModeStarted(ActionMode mode)` Called when an action mode has been started. Note that if you override this method you should always call through to the superclass implementation by calling super.onActionModeStarted(mode).
`void`	`onAttachedToWindow()` Called when the window has been attached to the window manager.
`void`	`onBackPressed()` This method was deprecated in API level 33. Use `OnBackInvokedCallback` or `androidx.activity.OnBackPressedCallback` to handle back navigation instead. Starting from Android 13 (API level 33), back event handling is moving to an ahead-of-time model and `onBackPressed()` and `KeyEvent.KEYCODE_BACK` should not be used to handle back events (back gesture or back button click). Instead, an `OnBackInvokedCallback` should be registered using `Dialog.getOnBackInvokedDispatcher()` `.registerOnBackInvokedCallback(priority, callback)`.
`void`	`onContentChanged()` This hook is called whenever the content view of the screen changes (due to a call to `Window.setContentView` or `Window.addContentView`).
`boolean`	`onContextItemSelected(MenuItem item)`
`void`	`onContextMenuClosed(Menu menu)`
`void`	`onCreate(Bundle savedInstanceState)` Similar to `Activity.onCreate`, you should initialize your dialog in this method, including calling `setContentView(View)`.
`void`	`onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo)` Called when the context menu for this view is being built.
`boolean`	`onCreateOptionsMenu(Menu menu)` It is usually safe to proxy this call to the owner activity's `Activity.onCreateOptionsMenu(Menu)` if the client desires the same menu for this Dialog.
`boolean`	`onCreatePanelMenu(int featureId, Menu menu)` Initialize the contents of the menu for panel 'featureId'.
`View`	`onCreatePanelView(int featureId)` Instantiate the view to display in the panel for 'featureId'.
`void`	`onDetachedFromWindow()` Called when the window has been detached from the window manager.
`boolean`	`onGenericMotionEvent(MotionEvent event)` Called when a generic motion event was not handled by any of the views inside of the dialog.
`boolean`	`onKeyDown(int keyCode, KeyEvent event)` A key was pressed down.
`boolean`	`onKeyLongPress(int keyCode, KeyEvent event)` Default implementation of `KeyEvent.Callback.onKeyLongPress()`: always returns false (doesn't handle the event).
`boolean`	`onKeyMultiple(int keyCode, int repeatCount, KeyEvent event)` Default implementation of `KeyEvent.Callback.onKeyMultiple()`: always returns false (doesn't handle the event).
`boolean`	`onKeyShortcut(int keyCode, KeyEvent event)` Called when a key shortcut event is not handled by any of the views in the Dialog.
`boolean`	`onKeyUp(int keyCode, KeyEvent event)` A key was released.
`boolean`	`onMenuItemSelected(int featureId, MenuItem item)` Called when a panel's menu item has been selected by the user.
`boolean`	`onMenuOpened(int featureId, Menu menu)` Called when a panel's menu is opened by the user.
`boolean`	`onOptionsItemSelected(MenuItem item)`
`void`	`onOptionsMenuClosed(Menu menu)`
`void`	`onPanelClosed(int featureId, Menu menu)` Called when a panel is being closed.
`boolean`	`onPrepareOptionsMenu(Menu menu)` It is usually safe to proxy this call to the owner activity's `Activity.onPrepareOptionsMenu(Menu)` if the client desires the same menu for this Dialog.
`boolean`	`onPreparePanel(int featureId, View view, Menu menu)` Prepare a panel to be displayed.
`void`	`onRestoreInstanceState(Bundle savedInstanceState)` Restore the state of the dialog from a previously saved bundle.
`Bundle`	`onSaveInstanceState()` Saves the state of the dialog into a bundle.
`boolean`	`onSearchRequested(SearchEvent searchEvent)` This hook is called when the user signals the desire to start a search.
`boolean`	`onSearchRequested()` This hook is called when the user signals the desire to start a search.
`void`	`onStart()` Called when the dialog is starting.
`void`	`onStop()` Called to tell you that you're stopping.
`boolean`	`onTouchEvent(MotionEvent event)` Called when a touch screen event was not handled by any of the views under it.
`boolean`	`onTrackballEvent(MotionEvent event)` Called when the trackball was moved and not handled by any of the views inside of the activity.
`void`	`onWindowAttributesChanged(WindowManager.LayoutParams params)` This is called whenever the current window attributes change.
`void`	`onWindowFocusChanged(boolean hasFocus)` This hook is called whenever the window focus changes.
`ActionMode`	`onWindowStartingActionMode(ActionMode.Callback callback)` Called when an action mode is being started for this window.
`ActionMode`	`onWindowStartingActionMode(ActionMode.Callback callback, int type)` Called when an action mode is being started for this window.
`void`	`openContextMenu(View view)`
`void`	`openOptionsMenu()`
`void`	`registerForContextMenu(View view)`
`final boolean`	`requestWindowFeature(int featureId)` Enable extended window features.
`final <T extends View> T`	`requireViewById(int id)` Finds the first descendant view with the given ID or throws an IllegalArgumentException if the ID is invalid (< 0), there is no matching view in the hierarchy, or the dialog has not yet been fully created (for example, via `show()` or `create()`).
`void`	`setCancelMessage(Message msg)` Set a message to be sent when the dialog is canceled.
`void`	`setCancelable(boolean flag)` Sets whether this dialog is cancelable with the `BACK` key.
`void`	`setCanceledOnTouchOutside(boolean cancel)` Sets whether this dialog is canceled when touched outside the window's bounds.
`void`	`setContentView(int layoutResID)` Set the screen content from a layout resource.
`void`	`setContentView(View view, ViewGroup.LayoutParams params)` Set the screen content to an explicit view.
`void`	`setContentView(View view)` Set the screen content to an explicit view.
`void`	`setDismissMessage(Message msg)` Set a message to be sent when the dialog is dismissed.
`final void`	`setFeatureDrawable(int featureId, Drawable drawable)` Convenience for calling `Window.setFeatureDrawable(int, Drawable)`.
`final void`	`setFeatureDrawableAlpha(int featureId, int alpha)` Convenience for calling `Window.setFeatureDrawableAlpha(int, int)`.
`final void`	`setFeatureDrawableResource(int featureId, int resId)` Convenience for calling `Window.setFeatureDrawableResource(int, int)`.
`final void`	`setFeatureDrawableUri(int featureId, Uri uri)` Convenience for calling `Window.setFeatureDrawableUri(int, Uri)`.
`void`	`setOnCancelListener(DialogInterface.OnCancelListener listener)` Set a listener to be invoked when the dialog is canceled.
`void`	`setOnDismissListener(DialogInterface.OnDismissListener listener)` Set a listener to be invoked when the dialog is dismissed.
`void`	`setOnKeyListener(DialogInterface.OnKeyListener onKeyListener)` Sets the callback that will be called if a key is dispatched to the dialog.
`void`	`setOnShowListener(DialogInterface.OnShowListener listener)` Sets a listener to be invoked when the dialog is shown.
`final void`	`setOwnerActivity(Activity activity)` Sets the Activity that owns this dialog.
`void`	`setTitle(CharSequence title)` Set the title text for this dialog's window.
`void`	`setTitle(int titleId)` Set the title text for this dialog's window.
`final void`	`setVolumeControlStream(int streamType)` By default, this will use the owner Activity's suggested stream type.
`void`	`show()` Start the dialog and display it on screen.
`void`	`takeKeyEvents(boolean get)` Request that key events come to this dialog.
`void`	`unregisterForContextMenu(View view)`

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

From interface


        
          android.content.DialogInterface

`abstract void`	`cancel()` Cancels the dialog, invoking the `OnCancelListener`.
`abstract void`	`dismiss()` Dismisses the dialog, invoking the `OnDismissListener`.

From interface


        
          android.view.KeyEvent.Callback

`abstract boolean`	`onKeyDown(int keyCode, KeyEvent event)` Called when a key down event has occurred.
`abstract boolean`	`onKeyLongPress(int keyCode, KeyEvent event)` Called when a long press has occurred.
`abstract boolean`	`onKeyMultiple(int keyCode, int count, KeyEvent event)` Called when a user's interaction with an analog control, such as flinging a trackball, generates simulated down/up events for the same key multiple times in quick succession.
`abstract boolean`	`onKeyUp(int keyCode, KeyEvent event)` Called when a key up event has occurred.

From interface


        
          android.view.View.OnCreateContextMenuListener


      onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo)

Called when the context menu for this view is being built.

From interface


        
          android.view.Window.Callback

`abstract boolean`	`dispatchGenericMotionEvent(MotionEvent event)` Called to process generic motion events.
`abstract boolean`	`dispatchKeyEvent(KeyEvent event)` Called to process key events.
`abstract boolean`	`dispatchKeyShortcutEvent(KeyEvent event)` Called to process a key shortcut event.
`abstract boolean`	`dispatchPopulateAccessibilityEvent(AccessibilityEvent event)` Called to process population of `AccessibilityEvent`s.
`abstract boolean`	`dispatchTouchEvent(MotionEvent event)` Called to process touch screen events.
`abstract boolean`	`dispatchTrackballEvent(MotionEvent event)` Called to process trackball events.
`abstract void`	`onActionModeFinished(ActionMode mode)` Called when an action mode has been finished.
`abstract void`	`onActionModeStarted(ActionMode mode)` Called when an action mode has been started.
`abstract void`	`onAttachedToWindow()` Called when the window has been attached to the window manager.
`abstract void`	`onContentChanged()` This hook is called whenever the content view of the screen changes (due to a call to `Window.setContentView` or `Window.addContentView`).
`abstract boolean`	`onCreatePanelMenu(int featureId, Menu menu)` Initialize the contents of the menu for panel 'featureId'.
`abstract View`	`onCreatePanelView(int featureId)` Instantiate the view to display in the panel for 'featureId'.
`abstract void`	`onDetachedFromWindow()` Called when the window has been detached from the window manager.
`abstract boolean`	`onMenuItemSelected(int featureId, MenuItem item)` Called when a panel's menu item has been selected by the user.
`abstract boolean`	`onMenuOpened(int featureId, Menu menu)` Called when a panel's menu is opened by the user.
`abstract void`	`onPanelClosed(int featureId, Menu menu)` Called when a panel is being closed.
`default void`	`onPointerCaptureChanged(boolean hasCapture)` Called when pointer capture is enabled or disabled for the current window.
`abstract boolean`	`onPreparePanel(int featureId, View view, Menu menu)` Prepare a panel to be displayed.
`default void`	`onProvideKeyboardShortcuts(List<KeyboardShortcutGroup> data, Menu menu, int deviceId)` Called when Keyboard Shortcuts are requested for the current window.
`abstract boolean`	`onSearchRequested()` Called when the user signals the desire to start a search.
`abstract boolean`	`onSearchRequested(SearchEvent searchEvent)` Called when the user signals the desire to start a search.
`abstract void`	`onWindowAttributesChanged(WindowManager.LayoutParams attrs)` This is called whenever the current window attributes change.
`abstract void`	`onWindowFocusChanged(boolean hasFocus)` This hook is called whenever the window focus changes.
`abstract ActionMode`	`onWindowStartingActionMode(ActionMode.Callback callback)` Called when an action mode is being started for this window.
`abstract ActionMode`	`onWindowStartingActionMode(ActionMode.Callback callback, int type)` Called when an action mode is being started for this window.

Constants

THEME_DEVICE_DEFAULT_DARK

Added in API level 14
Deprecated in API level 23

public static final int THEME_DEVICE_DEFAULT_DARK

This constant was deprecated in API level 23.
Use R.style.Theme_DeviceDefault_Dialog_Alert.

Special theme constant for AlertDialog(android.content.Context, int): use the device's default alert theme with a dark background.

Constant Value: 4 (0x00000004)

THEME_DEVICE_DEFAULT_LIGHT

Added in API level 14
Deprecated in API level 23

public static final int THEME_DEVICE_DEFAULT_LIGHT

This constant was deprecated in API level 23.
Use R.style.Theme_DeviceDefault_Light_Dialog_Alert.

Special theme constant for AlertDialog(android.content.Context, int): use the device's default alert theme with a light background.

Constant Value: 5 (0x00000005)

THEME_HOLO_DARK

Added in API level 11
Deprecated in API level 23

public static final int THEME_HOLO_DARK

This constant was deprecated in API level 23.
Use R.style.Theme_Material_Dialog_Alert.

Special theme constant for AlertDialog(android.content.Context, int): use the holographic alert theme with a dark background.

Constant Value: 2 (0x00000002)

THEME_HOLO_LIGHT

Added in API level 11
Deprecated in API level 23

public static final int THEME_HOLO_LIGHT

This constant was deprecated in API level 23.
Use R.style.Theme_Material_Light_Dialog_Alert.

Special theme constant for AlertDialog(android.content.Context, int): use the holographic alert theme with a light background.

Constant Value: 3 (0x00000003)

THEME_TRADITIONAL

Added in API level 11
Deprecated in API level 23

public static final int THEME_TRADITIONAL

This constant was deprecated in API level 23.
Use R.style.Theme_Material_Dialog_Alert.

Special theme constant for AlertDialog(android.content.Context, int): use the traditional (pre-Holo) alert dialog theme.

Constant Value: 1 (0x00000001)

Protected constructors

AlertDialog

Added in API level 1

protected AlertDialog (Context context)

Creates 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.

Parameters
`context`	`Context`: the parent context

See also:

R.styleable.Theme_alertDialogTheme

AlertDialog

Added in API level 1

protected AlertDialog (Context context, 
                boolean cancelable, 
                DialogInterface.OnCancelListener cancelListener)

Creates an alert dialog that uses the default alert dialog theme and a custom cancel listener.

This is functionally identical to:

     AlertDialog dialog = new AlertDialog(context);
     alertDialog.setCancelable(cancelable);
     alertDialog.setOnCancelListener(cancelListener);

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

Parameters
`context`	`Context`: the parent context
`cancelable`	`boolean`
`cancelListener`	`DialogInterface.OnCancelListener`

See also:

R.styleable.Theme_alertDialogTheme

AlertDialog

Added in API level 1

protected AlertDialog (Context context, 
                int themeResId)

Creates 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.

Parameters
`context`	`Context`: the parent context
`themeResId`	`int`: the resource ID of the theme against which to inflate this dialog, or `0` to use the parent `context`'s default alert dialog theme

See also:

R.styleable.Theme_alertDialogTheme

Public methods

getButton

Added in API level 3

public Button getButton (int whichButton)

Gets one of the buttons used in the dialog. Returns null if the specified button does not exist or the dialog has not yet been fully created (for example, via Dialog.show() or Dialog.create()).

Parameters
`whichButton`	`int`: The identifier of the button that should be returned. For example, this can be `DialogInterface.BUTTON_POSITIVE`.

Returns
`Button`	The button from the dialog, or null if a button does not exist.

getListView

Added in API level 3

public ListView getListView ()

Gets the list view used in the dialog.

Returns
`ListView`	The `ListView` from the dialog.

onKeyDown

Added in API level 1

public boolean onKeyDown (int keyCode, 
                KeyEvent event)

A key was pressed down.

If the focused view didn't want this event, this method is called.

Default implementation consumes KEYCODE_BACK and, as of P, KEYCODE_ESCAPE to later handle them in onKeyUp(int, KeyEvent).

Parameters
`keyCode`	`int`: The value in event.getKeyCode().
`event`	`KeyEvent`: This value cannot be `null`.

Returns
`boolean`	If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onKeyUp

Added in API level 1

public boolean onKeyUp (int keyCode, 
                KeyEvent event)

A key was released.

Default implementation consumes KEYCODE_BACK and, as of P, KEYCODE_ESCAPE to close the dialog.

Parameters
`keyCode`	`int`: The value in event.getKeyCode().
`event`	`KeyEvent`: This value cannot be `null`.

Returns
`boolean`	If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

setButton

Added in API level 1
Deprecated in API level 15

public void setButton (CharSequence text, 
                DialogInterface.OnClickListener listener)

This method was deprecated in API level 15.
Use setButton(int, java.lang.CharSequence, android.content.DialogInterface.OnClickListener) with DialogInterface.BUTTON_POSITIVE

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

Parameters
`text`	`CharSequence`: The text to display in button 1.
`listener`	`DialogInterface.OnClickListener`: The `DialogInterface.OnClickListener` to use.

setButton

Added in API level 3

public void setButton (int whichButton, 
                CharSequence text, 
                DialogInterface.OnClickListener listener)

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

Parameters
`whichButton`	`int`: Which button to set the listener on, can be one of `DialogInterface.BUTTON_POSITIVE`, `DialogInterface.BUTTON_NEGATIVE`, or `DialogInterface.BUTTON_NEUTRAL`
`text`	`CharSequence`: The text to display in positive button.
`listener`	`DialogInterface.OnClickListener`: The `DialogInterface.OnClickListener` to use.

setButton

Added in API level 1
Deprecated in API level 15

public void setButton (CharSequence text, 
                Message msg)

This method was deprecated in API level 15.
Use setButton(int, java.lang.CharSequence, android.os.Message) with DialogInterface.BUTTON_POSITIVE.

Parameters
`text`	`CharSequence`
`msg`	`Message`

setButton

Added in API level 3

public void setButton (int whichButton, 
                CharSequence text, 
                Message msg)

Set a message to be sent when a button is pressed.

Parameters
`whichButton`	`int`: Which button to set the message for, can be one of `DialogInterface.BUTTON_POSITIVE`, `DialogInterface.BUTTON_NEGATIVE`, or `DialogInterface.BUTTON_NEUTRAL`
`text`	`CharSequence`: The text to display in positive button.
`msg`	`Message`: The `Message` to be sent when clicked.

setButton2

Added in API level 1
Deprecated in API level 15

public void setButton2 (CharSequence text, 
                Message msg)

This method was deprecated in API level 15.
Use setButton(int, java.lang.CharSequence, android.os.Message) with DialogInterface.BUTTON_NEGATIVE.

Parameters
`text`	`CharSequence`
`msg`	`Message`

setButton2

Added in API level 1
Deprecated in API level 15

public void setButton2 (CharSequence text, 
                DialogInterface.OnClickListener listener)

This method was deprecated in API level 15.
Use setButton(int, java.lang.CharSequence, android.content.DialogInterface.OnClickListener) with DialogInterface.BUTTON_NEGATIVE

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

Parameters
`text`	`CharSequence`: The text to display in button 2.
`listener`	`DialogInterface.OnClickListener`: The `DialogInterface.OnClickListener` to use.

setButton3

Added in API level 1
Deprecated in API level 15

public void setButton3 (CharSequence text, 
                Message msg)

This method was deprecated in API level 15.
Use setButton(int, java.lang.CharSequence, android.os.Message) with DialogInterface.BUTTON_NEUTRAL.

Parameters
`text`	`CharSequence`
`msg`	`Message`

setButton3

Added in API level 1
Deprecated in API level 15

public void setButton3 (CharSequence text, 
                DialogInterface.OnClickListener listener)

This method was deprecated in API level 15.
Use setButton(int, java.lang.CharSequence, android.content.DialogInterface.OnClickListener) with DialogInterface.BUTTON_NEUTRAL

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

Parameters
`text`	`CharSequence`: The text to display in button 3.
`listener`	`DialogInterface.OnClickListener`: The `DialogInterface.OnClickListener` to use.

setCustomTitle

Added in API level 1

public void setCustomTitle (View customTitleView)

Parameters
`customTitleView`	`View`

See also:

AlertDialog.Builder.setCustomTitle(View)

setIcon

Added in API level 1

public void setIcon (Drawable icon)

Parameters
`icon`	`Drawable`

setIcon

Added in API level 1

public void setIcon (int resId)

Set resId to 0 if you don't want an icon.

Parameters
`resId`	`int`: the resourceId of the drawable to use as the icon or 0 if you don't want an icon.

setIconAttribute

Added in API level 11

public void setIconAttribute (int attrId)

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

Parameters
`attrId`	`int`: ID of a theme attribute that points to a drawable resource.

setInverseBackgroundForced

Added in API level 1

public void setInverseBackgroundForced (boolean forceInverseBackground)

Parameters
`forceInverseBackground`	`boolean`

setMessage

Added in API level 1

public void setMessage (CharSequence message)

Parameters
`message`	`CharSequence`

setTitle

Added in API level 1

public void setTitle (CharSequence title)

Set the title text for this dialog's window.

Parameters
`title`	`CharSequence`: The new text to display in the title. This value may be `null`.

setView

Added in API level 3

public void setView (View view, 
                int viewSpacingLeft, 
                int viewSpacingTop, 
                int viewSpacingRight, 
                int viewSpacingBottom)

Set the view to display in that dialog, specifying the spacing to appear around that view.

Parameters
`view`	`View`: The view to show in the content area of the dialog
`viewSpacingLeft`	`int`: Extra space to appear to the left of `view`
`viewSpacingTop`	`int`: Extra space to appear above `view`
`viewSpacingRight`	`int`: Extra space to appear to the right of `view`
`viewSpacingBottom`	`int`: Extra space to appear below `view`

setView

Added in API level 1

public void setView (View view)

Set the view to display in that dialog.

Parameters
`view`	`View`

Protected methods

onCreate

Added in API level 1

protected void onCreate (Bundle savedInstanceState)

Similar to Activity.onCreate, you should initialize your dialog in this method, including calling setContentView(View).

Parameters
`savedInstanceState`	`Bundle`: If this dialog is being reinitialized after a the hosting activity was previously shut down, holds the result from the most recent call to `Dialog.onSaveInstanceState()`, or null if this is the first time.

AlertDialog

Developer Guides

Summary

Nested classes

Constants

Inherited constants

Protected constructors

Public methods

Protected methods

Inherited methods

Constants

THEME_DEVICE_DEFAULT_DARK

THEME_DEVICE_DEFAULT_LIGHT

THEME_HOLO_DARK

THEME_HOLO_LIGHT

THEME_TRADITIONAL

Protected constructors

AlertDialog

AlertDialog

AlertDialog

Public methods

getButton

getListView

onKeyDown

onKeyUp

setButton

setButton

setButton

setButton

setButton2

setButton2

setButton3

setButton3

setCustomTitle

setIcon

setIcon

setIconAttribute

setInverseBackgroundForced

setMessage

setTitle

setView

setView

Protected methods

onCreate