# DatePickerDialog Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary:[Nested Classes](https://developer.android.com/reference/android/app/DatePickerDialog#nestedclasses)\|[Inherited Constants](https://developer.android.com/reference/android/app/DatePickerDialog#inhconstants)\|[Ctors](https://developer.android.com/reference/android/app/DatePickerDialog#pubctors)\|[Methods](https://developer.android.com/reference/android/app/DatePickerDialog#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/app/DatePickerDialog#inhmethods) # DatePickerDialog *** ** * ** *** [Kotlin](https://developer.android.com/reference/kotlin/android/app/DatePickerDialog "View this page in Kotlin")\|Java ` public class DatePickerDialog ` ` `` `` extends `[AlertDialog](https://developer.android.com/reference/android/app/AlertDialog)` `` implements `[DatePicker.OnDateChangedListener](https://developer.android.com/reference/android/widget/DatePicker.OnDateChangedListener)`, `[DialogInterface.OnClickListener](https://developer.android.com/reference/android/content/DialogInterface.OnClickListener)` ` |---|---|---|------------------------------| | [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||| | ↳ | [android.app.Dialog](https://developer.android.com/reference/android/app/Dialog) ||| | | ↳ | [android.app.AlertDialog](https://developer.android.com/reference/android/app/AlertDialog) || | | | ↳ | android.app.DatePickerDialog |
*** ** * ** *** A simple dialog containing an[DatePicker](https://developer.android.com/reference/android/widget/DatePicker). See the[Pickers](https://developer.android.com/guide/topics/ui/controls/pickers)guide. ## Summary | ### Nested classes || |--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` interface` | [DatePickerDialog.OnDateSetListener](https://developer.android.com/reference/android/app/DatePickerDialog.OnDateSetListener) The listener used to indicate the user has finished selecting a date. | | ### Inherited constants | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | From class[android.app.AlertDialog](https://developer.android.com/reference/android/app/AlertDialog) |-------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `int` | [THEME_DEVICE_DEFAULT_DARK](https://developer.android.com/reference/android/app/AlertDialog#THEME_DEVICE_DEFAULT_DARK) *This constant was deprecated in API level 23. Use[R.style.Theme_DeviceDefault_Dialog_Alert](https://developer.android.com/reference/android/R.style#Theme_DeviceDefault_Dialog_Alert).* | | `int` | [THEME_DEVICE_DEFAULT_LIGHT](https://developer.android.com/reference/android/app/AlertDialog#THEME_DEVICE_DEFAULT_LIGHT) *This constant was deprecated in API level 23. Use[R.style.Theme_DeviceDefault_Light_Dialog_Alert](https://developer.android.com/reference/android/R.style#Theme_DeviceDefault_Light_Dialog_Alert).* | | `int` | [THEME_HOLO_DARK](https://developer.android.com/reference/android/app/AlertDialog#THEME_HOLO_DARK) *This constant was deprecated in API level 23. Use[R.style.Theme_Material_Dialog_Alert](https://developer.android.com/reference/android/R.style#Theme_Material_Dialog_Alert).* | | `int` | [THEME_HOLO_LIGHT](https://developer.android.com/reference/android/app/AlertDialog#THEME_HOLO_LIGHT) *This constant was deprecated in API level 23. Use[R.style.Theme_Material_Light_Dialog_Alert](https://developer.android.com/reference/android/R.style#Theme_Material_Light_Dialog_Alert).* | | `int` | [THEME_TRADITIONAL](https://developer.android.com/reference/android/app/AlertDialog#THEME_TRADITIONAL) *This constant was deprecated in API level 23. Use[R.style.Theme_Material_Dialog_Alert](https://developer.android.com/reference/android/R.style#Theme_Material_Dialog_Alert).* | | | From interface[android.content.DialogInterface](https://developer.android.com/reference/android/content/DialogInterface) |-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `int` | [BUTTON1](https://developer.android.com/reference/android/content/DialogInterface#BUTTON1) *This constant was deprecated in API level 15. Use[BUTTON_POSITIVE](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_POSITIVE)* | | `int` | [BUTTON2](https://developer.android.com/reference/android/content/DialogInterface#BUTTON2) *This constant was deprecated in API level 15. Use[BUTTON_NEGATIVE](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_NEGATIVE)* | | `int` | [BUTTON3](https://developer.android.com/reference/android/content/DialogInterface#BUTTON3) *This constant was deprecated in API level 15. Use[BUTTON_NEUTRAL](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_NEUTRAL)* | | `int` | [BUTTON_NEGATIVE](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_NEGATIVE) The identifier for the negative button. | | `int` | [BUTTON_NEUTRAL](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_NEUTRAL) The identifier for the neutral button. | | `int` | [BUTTON_POSITIVE](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_POSITIVE) The identifier for the positive button. | | | ### Public constructors || |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---| | ` `[DatePickerDialog](https://developer.android.com/reference/android/app/DatePickerDialog#DatePickerDialog(android.content.Context))`(`[Context](https://developer.android.com/reference/android/content/Context)` context) ` Creates a new date picker dialog for the current date using the parent context's default date picker dialog theme. | | ` `[DatePickerDialog](https://developer.android.com/reference/android/app/DatePickerDialog#DatePickerDialog(android.content.Context,%20android.app.DatePickerDialog.OnDateSetListener,%20int,%20int,%20int))`(`[Context](https://developer.android.com/reference/android/content/Context)` context, `[DatePickerDialog.OnDateSetListener](https://developer.android.com/reference/android/app/DatePickerDialog.OnDateSetListener)` listener, int year, int month, int dayOfMonth) ` Creates a new date picker dialog for the specified date using the parent context's default date picker dialog theme. | | ` `[DatePickerDialog](https://developer.android.com/reference/android/app/DatePickerDialog#DatePickerDialog(android.content.Context,%20int))`(`[Context](https://developer.android.com/reference/android/content/Context)` context, int themeResId) ` Creates a new date picker dialog for the current date. | | ` `[DatePickerDialog](https://developer.android.com/reference/android/app/DatePickerDialog#DatePickerDialog(android.content.Context,%20int,%20android.app.DatePickerDialog.OnDateSetListener,%20int,%20int,%20int))`(`[Context](https://developer.android.com/reference/android/content/Context)` context, int themeResId, `[DatePickerDialog.OnDateSetListener](https://developer.android.com/reference/android/app/DatePickerDialog.OnDateSetListener)` listener, int year, int monthOfYear, int dayOfMonth) ` Creates a new date picker dialog for the specified date. | | ### Public methods || |------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[DatePicker](https://developer.android.com/reference/android/widget/DatePicker) | ` `[getDatePicker](https://developer.android.com/reference/android/app/DatePickerDialog#getDatePicker())`() ` Returns the[DatePicker](https://developer.android.com/reference/android/widget/DatePicker)contained in this dialog. | | ` void` | ` `[onClick](https://developer.android.com/reference/android/app/DatePickerDialog#onClick(android.content.DialogInterface,%20int))`(`[DialogInterface](https://developer.android.com/reference/android/content/DialogInterface)` dialog, int which) ` This method will be invoked when a button in the dialog is clicked. | | ` void` | ` `[onDateChanged](https://developer.android.com/reference/android/app/DatePickerDialog#onDateChanged(android.widget.DatePicker,%20int,%20int,%20int))`(`[DatePicker](https://developer.android.com/reference/android/widget/DatePicker)` view, int year, int month, int dayOfMonth) ` Called upon a date change. | | ` void` | ` `[onRestoreInstanceState](https://developer.android.com/reference/android/app/DatePickerDialog#onRestoreInstanceState(android.os.Bundle))`(`[Bundle](https://developer.android.com/reference/android/os/Bundle)` savedInstanceState) ` Restore the state of the dialog from a previously saved bundle. | | ` `[Bundle](https://developer.android.com/reference/android/os/Bundle) | ` `[onSaveInstanceState](https://developer.android.com/reference/android/app/DatePickerDialog#onSaveInstanceState())`() ` Saves the state of the dialog into a bundle. | | ` void` | ` `[setOnDateSetListener](https://developer.android.com/reference/android/app/DatePickerDialog#setOnDateSetListener(android.app.DatePickerDialog.OnDateSetListener))`(`[DatePickerDialog.OnDateSetListener](https://developer.android.com/reference/android/app/DatePickerDialog.OnDateSetListener)` listener) ` Sets the listener to call when the user sets the date. | | ` void` | ` `[updateDate](https://developer.android.com/reference/android/app/DatePickerDialog#updateDate(int,%20int,%20int))`(int year, int month, int dayOfMonth) ` Sets the current date. | | ### Inherited methods | |-----------------------|---| | From class` `[android.app.AlertDialog](https://developer.android.com/reference/android/app/AlertDialog)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Button](https://developer.android.com/reference/android/widget/Button) | ` `[getButton](https://developer.android.com/reference/android/app/AlertDialog#getButton(int))`(int whichButton) ` Gets one of the buttons used in the dialog. | | ` `[ListView](https://developer.android.com/reference/android/widget/ListView) | ` `[getListView](https://developer.android.com/reference/android/app/AlertDialog#getListView())`() ` Gets the list view used in the dialog. | | ` void` | ` `[onCreate](https://developer.android.com/reference/android/app/AlertDialog#onCreate(android.os.Bundle))`(`[Bundle](https://developer.android.com/reference/android/os/Bundle)` savedInstanceState) ` Similar to[Activity.onCreate](https://developer.android.com/reference/android/app/Activity#onCreate(android.os.Bundle)), you should initialize your dialog in this method, including calling[setContentView(View)](https://developer.android.com/reference/android/app/Dialog#setContentView(android.view.View)). | | ` boolean` | ` `[onKeyDown](https://developer.android.com/reference/android/app/AlertDialog#onKeyDown(int,%20android.view.KeyEvent))`(int keyCode, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` A key was pressed down. | | ` boolean` | ` `[onKeyUp](https://developer.android.com/reference/android/app/AlertDialog#onKeyUp(int,%20android.view.KeyEvent))`(int keyCode, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` A key was released. | | ` void` | ` `[setButton](https://developer.android.com/reference/android/app/AlertDialog#setButton(java.lang.CharSequence,%20android.content.DialogInterface.OnClickListener))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text, `[DialogInterface.OnClickListener](https://developer.android.com/reference/android/content/DialogInterface.OnClickListener)` listener) ` *This method was deprecated in API level 15. Use[setButton(int, java.lang.CharSequence, android.content.DialogInterface.OnClickListener)](https://developer.android.com/reference/android/app/AlertDialog#setButton(int,%20java.lang.CharSequence,%20android.content.DialogInterface.OnClickListener))with[DialogInterface.BUTTON_POSITIVE](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_POSITIVE)* | | ` void` | ` `[setButton](https://developer.android.com/reference/android/app/AlertDialog#setButton(int,%20java.lang.CharSequence,%20android.content.DialogInterface.OnClickListener))`(int whichButton, `[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text, `[DialogInterface.OnClickListener](https://developer.android.com/reference/android/content/DialogInterface.OnClickListener)` listener) ` Set a listener to be invoked when the specified button of the dialog is pressed. | | ` void` | ` `[setButton](https://developer.android.com/reference/android/app/AlertDialog#setButton(java.lang.CharSequence,%20android.os.Message))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text, `[Message](https://developer.android.com/reference/android/os/Message)` msg) ` *This method was deprecated in API level 15. Use[setButton(int, java.lang.CharSequence, android.os.Message)](https://developer.android.com/reference/android/app/AlertDialog#setButton(int,%20java.lang.CharSequence,%20android.os.Message))with[DialogInterface.BUTTON_POSITIVE](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_POSITIVE).* | | ` void` | ` `[setButton](https://developer.android.com/reference/android/app/AlertDialog#setButton(int,%20java.lang.CharSequence,%20android.os.Message))`(int whichButton, `[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text, `[Message](https://developer.android.com/reference/android/os/Message)` msg) ` Set a message to be sent when a button is pressed. | | ` void` | ` `[setButton2](https://developer.android.com/reference/android/app/AlertDialog#setButton2(java.lang.CharSequence,%20android.os.Message))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text, `[Message](https://developer.android.com/reference/android/os/Message)` msg) ` *This method was deprecated in API level 15. Use[setButton(int, java.lang.CharSequence, android.os.Message)](https://developer.android.com/reference/android/app/AlertDialog#setButton(int,%20java.lang.CharSequence,%20android.os.Message))with[DialogInterface.BUTTON_NEGATIVE](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_NEGATIVE).* | | ` void` | ` `[setButton2](https://developer.android.com/reference/android/app/AlertDialog#setButton2(java.lang.CharSequence,%20android.content.DialogInterface.OnClickListener))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text, `[DialogInterface.OnClickListener](https://developer.android.com/reference/android/content/DialogInterface.OnClickListener)` listener) ` *This method was deprecated in API level 15. Use[setButton(int, java.lang.CharSequence, android.content.DialogInterface.OnClickListener)](https://developer.android.com/reference/android/app/AlertDialog#setButton(int,%20java.lang.CharSequence,%20android.content.DialogInterface.OnClickListener))with[DialogInterface.BUTTON_NEGATIVE](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_NEGATIVE)* | | ` void` | ` `[setButton3](https://developer.android.com/reference/android/app/AlertDialog#setButton3(java.lang.CharSequence,%20android.os.Message))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text, `[Message](https://developer.android.com/reference/android/os/Message)` msg) ` *This method was deprecated in API level 15. Use[setButton(int, java.lang.CharSequence, android.os.Message)](https://developer.android.com/reference/android/app/AlertDialog#setButton(int,%20java.lang.CharSequence,%20android.os.Message))with[DialogInterface.BUTTON_NEUTRAL](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_NEUTRAL).* | | ` void` | ` `[setButton3](https://developer.android.com/reference/android/app/AlertDialog#setButton3(java.lang.CharSequence,%20android.content.DialogInterface.OnClickListener))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text, `[DialogInterface.OnClickListener](https://developer.android.com/reference/android/content/DialogInterface.OnClickListener)` listener) ` *This method was deprecated in API level 15. Use[setButton(int, java.lang.CharSequence, android.content.DialogInterface.OnClickListener)](https://developer.android.com/reference/android/app/AlertDialog#setButton(int,%20java.lang.CharSequence,%20android.content.DialogInterface.OnClickListener))with[DialogInterface.BUTTON_NEUTRAL](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_NEUTRAL)* | | ` void` | ` `[setCustomTitle](https://developer.android.com/reference/android/app/AlertDialog#setCustomTitle(android.view.View))`(`[View](https://developer.android.com/reference/android/view/View)` customTitleView) ` | | ` void` | ` `[setIcon](https://developer.android.com/reference/android/app/AlertDialog#setIcon(android.graphics.drawable.Drawable))`(`[Drawable](https://developer.android.com/reference/android/graphics/drawable/Drawable)` icon) ` | | ` void` | ` `[setIcon](https://developer.android.com/reference/android/app/AlertDialog#setIcon(int))`(int resId) ` Set resId to 0 if you don't want an icon. | | ` void` | ` `[setIconAttribute](https://developer.android.com/reference/android/app/AlertDialog#setIconAttribute(int))`(int attrId) ` Set an icon as supplied by a theme attribute. | | ` void` | ` `[setInverseBackgroundForced](https://developer.android.com/reference/android/app/AlertDialog#setInverseBackgroundForced(boolean))`(boolean forceInverseBackground) ` | | ` void` | ` `[setMessage](https://developer.android.com/reference/android/app/AlertDialog#setMessage(java.lang.CharSequence))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` message) ` | | ` void` | ` `[setTitle](https://developer.android.com/reference/android/app/AlertDialog#setTitle(java.lang.CharSequence))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` title) ` Set the title text for this dialog's window. | | ` void` | ` `[setView](https://developer.android.com/reference/android/app/AlertDialog#setView(android.view.View,%20int,%20int,%20int,%20int))`(`[View](https://developer.android.com/reference/android/view/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](https://developer.android.com/reference/android/app/AlertDialog#setView(android.view.View))`(`[View](https://developer.android.com/reference/android/view/View)` view) ` Set the view to display in that dialog. | || | From class` `[android.app.Dialog](https://developer.android.com/reference/android/app/Dialog)` ` |--------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` void` | ` `[addContentView](https://developer.android.com/reference/android/app/Dialog#addContentView(android.view.View,%20android.view.ViewGroup.LayoutParams))`(`[View](https://developer.android.com/reference/android/view/View)` view, `[ViewGroup.LayoutParams](https://developer.android.com/reference/android/view/ViewGroup.LayoutParams)` params) ` Add an additional content view to the screen. | | ` void` | ` `[cancel](https://developer.android.com/reference/android/app/Dialog#cancel())`() ` Cancel the dialog. | | ` void` | ` `[closeOptionsMenu](https://developer.android.com/reference/android/app/Dialog#closeOptionsMenu())`() ` | | ` void` | ` `[create](https://developer.android.com/reference/android/app/Dialog#create())`() ` Forces immediate creation of the dialog. | | ` void` | ` `[dismiss](https://developer.android.com/reference/android/app/Dialog#dismiss())`() ` Dismiss this dialog, removing it from the screen. | | ` boolean` | ` `[dispatchGenericMotionEvent](https://developer.android.com/reference/android/app/Dialog#dispatchGenericMotionEvent(android.view.MotionEvent))`(`[MotionEvent](https://developer.android.com/reference/android/view/MotionEvent)` ev) ` Called to process generic motion events. | | ` boolean` | ` `[dispatchKeyEvent](https://developer.android.com/reference/android/app/Dialog#dispatchKeyEvent(android.view.KeyEvent))`(`[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Called to process key events. | | ` boolean` | ` `[dispatchKeyShortcutEvent](https://developer.android.com/reference/android/app/Dialog#dispatchKeyShortcutEvent(android.view.KeyEvent))`(`[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Called to process a key shortcut event. | | ` boolean` | ` `[dispatchPopulateAccessibilityEvent](https://developer.android.com/reference/android/app/Dialog#dispatchPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent))`(`[AccessibilityEvent](https://developer.android.com/reference/android/view/accessibility/AccessibilityEvent)` event) ` Called to process population of[AccessibilityEvent](https://developer.android.com/reference/android/view/accessibility/AccessibilityEvent)s. | | ` boolean` | ` `[dispatchTouchEvent](https://developer.android.com/reference/android/app/Dialog#dispatchTouchEvent(android.view.MotionEvent))`(`[MotionEvent](https://developer.android.com/reference/android/view/MotionEvent)` ev) ` Called to process touch screen events. | | ` boolean` | ` `[dispatchTrackballEvent](https://developer.android.com/reference/android/app/Dialog#dispatchTrackballEvent(android.view.MotionEvent))`(`[MotionEvent](https://developer.android.com/reference/android/view/MotionEvent)` ev) ` Called to process trackball events. | | ` T` | ` `[findViewById](https://developer.android.com/reference/android/app/Dialog#findViewById(int))`(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()](https://developer.android.com/reference/android/app/Dialog#show())or[create()](https://developer.android.com/reference/android/app/Dialog#create())). | | ` `[ActionBar](https://developer.android.com/reference/android/app/ActionBar) | ` `[getActionBar](https://developer.android.com/reference/android/app/Dialog#getActionBar())`() ` Retrieve the[ActionBar](https://developer.android.com/reference/android/app/ActionBar)attached to this dialog, if present. | | ` final `[Context](https://developer.android.com/reference/android/content/Context) | ` `[getContext](https://developer.android.com/reference/android/app/Dialog#getContext())`() ` Retrieve the Context this Dialog is running in. | | ` `[View](https://developer.android.com/reference/android/view/View) | ` `[getCurrentFocus](https://developer.android.com/reference/android/app/Dialog#getCurrentFocus())`() ` Call[Window.getCurrentFocus()](https://developer.android.com/reference/android/view/Window#getCurrentFocus())on the Window if this Activity to return the currently focused view. | | ` `[LayoutInflater](https://developer.android.com/reference/android/view/LayoutInflater) | ` `[getLayoutInflater](https://developer.android.com/reference/android/app/Dialog#getLayoutInflater())`() ` | | ` `[OnBackInvokedDispatcher](https://developer.android.com/reference/android/window/OnBackInvokedDispatcher) | ` `[getOnBackInvokedDispatcher](https://developer.android.com/reference/android/app/Dialog#getOnBackInvokedDispatcher())`() ` Returns the[OnBackInvokedDispatcher](https://developer.android.com/reference/android/window/OnBackInvokedDispatcher)instance associated with the window that this dialog is attached to. | | ` final `[Activity](https://developer.android.com/reference/android/app/Activity) | ` `[getOwnerActivity](https://developer.android.com/reference/android/app/Dialog#getOwnerActivity())`() ` Returns the Activity that owns this Dialog. | | ` final `[SearchEvent](https://developer.android.com/reference/android/view/SearchEvent) | ` `[getSearchEvent](https://developer.android.com/reference/android/app/Dialog#getSearchEvent())`() ` During the onSearchRequested() callbacks, this function will return the[SearchEvent](https://developer.android.com/reference/android/view/SearchEvent)that triggered the callback, if it exists. | | ` final int` | ` `[getVolumeControlStream](https://developer.android.com/reference/android/app/Dialog#getVolumeControlStream())`() ` | | ` `[Window](https://developer.android.com/reference/android/view/Window) | ` `[getWindow](https://developer.android.com/reference/android/app/Dialog#getWindow())`() ` Retrieve the current Window for the activity. | | ` void` | ` `[hide](https://developer.android.com/reference/android/app/Dialog#hide())`() ` Hide the dialog, but do not dismiss it. | | ` void` | ` `[invalidateOptionsMenu](https://developer.android.com/reference/android/app/Dialog#invalidateOptionsMenu())`() ` | | ` boolean` | ` `[isShowing](https://developer.android.com/reference/android/app/Dialog#isShowing())`() ` | | ` void` | ` `[onActionModeFinished](https://developer.android.com/reference/android/app/Dialog#onActionModeFinished(android.view.ActionMode))`(`[ActionMode](https://developer.android.com/reference/android/view/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](https://developer.android.com/reference/android/app/Dialog#onActionModeStarted(android.view.ActionMode))`(`[ActionMode](https://developer.android.com/reference/android/view/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](https://developer.android.com/reference/android/app/Dialog#onAttachedToWindow())`() ` Called when the window has been attached to the window manager. | | ` void` | ` `[onBackPressed](https://developer.android.com/reference/android/app/Dialog#onBackPressed())`() ` *This method was deprecated in API level 33. Use[OnBackInvokedCallback](https://developer.android.com/reference/android/window/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()](https://developer.android.com/reference/android/app/Dialog#onBackPressed())and[KeyEvent.KEYCODE_BACK](https://developer.android.com/reference/android/view/KeyEvent#KEYCODE_BACK)should not be used to handle back events (back gesture or back button click). Instead, an[OnBackInvokedCallback](https://developer.android.com/reference/android/window/OnBackInvokedCallback)should be registered using[Dialog.getOnBackInvokedDispatcher()](https://developer.android.com/reference/android/app/Dialog#getOnBackInvokedDispatcher())[.registerOnBackInvokedCallback(priority, callback)](https://developer.android.com/reference/android/window/OnBackInvokedDispatcher#registerOnBackInvokedCallback(int,%20android.window.OnBackInvokedCallback)).* | | ` void` | ` `[onContentChanged](https://developer.android.com/reference/android/app/Dialog#onContentChanged())`() ` This hook is called whenever the content view of the screen changes (due to a call to[Window.setContentView](https://developer.android.com/reference/android/view/Window#setContentView(android.view.View,%20android.view.ViewGroup.LayoutParams))or[Window.addContentView](https://developer.android.com/reference/android/view/Window#addContentView(android.view.View,%20android.view.ViewGroup.LayoutParams))). | | ` boolean` | ` `[onContextItemSelected](https://developer.android.com/reference/android/app/Dialog#onContextItemSelected(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem)` item) ` | | ` void` | ` `[onContextMenuClosed](https://developer.android.com/reference/android/app/Dialog#onContextMenuClosed(android.view.Menu))`(`[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` | | ` void` | ` `[onCreate](https://developer.android.com/reference/android/app/Dialog#onCreate(android.os.Bundle))`(`[Bundle](https://developer.android.com/reference/android/os/Bundle)` savedInstanceState) ` Similar to[Activity.onCreate](https://developer.android.com/reference/android/app/Activity#onCreate(android.os.Bundle)), you should initialize your dialog in this method, including calling[setContentView(View)](https://developer.android.com/reference/android/app/Dialog#setContentView(android.view.View)). | | ` void` | ` `[onCreateContextMenu](https://developer.android.com/reference/android/app/Dialog#onCreateContextMenu(android.view.ContextMenu,%20android.view.View,%20android.view.ContextMenu.ContextMenuInfo))`(`[ContextMenu](https://developer.android.com/reference/android/view/ContextMenu)` menu, `[View](https://developer.android.com/reference/android/view/View)` v, `[ContextMenu.ContextMenuInfo](https://developer.android.com/reference/android/view/ContextMenu.ContextMenuInfo)` menuInfo) ` Called when the context menu for this view is being built. | | ` boolean` | ` `[onCreateOptionsMenu](https://developer.android.com/reference/android/app/Dialog#onCreateOptionsMenu(android.view.Menu))`(`[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` It is usually safe to proxy this call to the owner activity's[Activity.onCreateOptionsMenu(Menu)](https://developer.android.com/reference/android/app/Activity#onCreateOptionsMenu(android.view.Menu))if the client desires the same menu for this Dialog. | | ` boolean` | ` `[onCreatePanelMenu](https://developer.android.com/reference/android/app/Dialog#onCreatePanelMenu(int,%20android.view.Menu))`(int featureId, `[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` Initialize the contents of the menu for panel 'featureId'. | | ` `[View](https://developer.android.com/reference/android/view/View) | ` `[onCreatePanelView](https://developer.android.com/reference/android/app/Dialog#onCreatePanelView(int))`(int featureId) ` Instantiate the view to display in the panel for 'featureId'. | | ` void` | ` `[onDetachedFromWindow](https://developer.android.com/reference/android/app/Dialog#onDetachedFromWindow())`() ` Called when the window has been detached from the window manager. | | ` boolean` | ` `[onGenericMotionEvent](https://developer.android.com/reference/android/app/Dialog#onGenericMotionEvent(android.view.MotionEvent))`(`[MotionEvent](https://developer.android.com/reference/android/view/MotionEvent)` event) ` Called when a generic motion event was not handled by any of the views inside of the dialog. | | ` boolean` | ` `[onKeyDown](https://developer.android.com/reference/android/app/Dialog#onKeyDown(int,%20android.view.KeyEvent))`(int keyCode, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` A key was pressed down. | | ` boolean` | ` `[onKeyLongPress](https://developer.android.com/reference/android/app/Dialog#onKeyLongPress(int,%20android.view.KeyEvent))`(int keyCode, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Default implementation of[KeyEvent.Callback.onKeyLongPress()](https://developer.android.com/reference/android/view/KeyEvent.Callback#onKeyLongPress(int,%20android.view.KeyEvent)): always returns false (doesn't handle the event). | | ` boolean` | ` `[onKeyMultiple](https://developer.android.com/reference/android/app/Dialog#onKeyMultiple(int,%20int,%20android.view.KeyEvent))`(int keyCode, int repeatCount, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Default implementation of[KeyEvent.Callback.onKeyMultiple()](https://developer.android.com/reference/android/view/KeyEvent.Callback#onKeyMultiple(int,%20int,%20android.view.KeyEvent)): always returns false (doesn't handle the event). | | ` boolean` | ` `[onKeyShortcut](https://developer.android.com/reference/android/app/Dialog#onKeyShortcut(int,%20android.view.KeyEvent))`(int keyCode, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Called when a key shortcut event is not handled by any of the views in the Dialog. | | ` boolean` | ` `[onKeyUp](https://developer.android.com/reference/android/app/Dialog#onKeyUp(int,%20android.view.KeyEvent))`(int keyCode, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` A key was released. | | ` boolean` | ` `[onMenuItemSelected](https://developer.android.com/reference/android/app/Dialog#onMenuItemSelected(int,%20android.view.MenuItem))`(int featureId, `[MenuItem](https://developer.android.com/reference/android/view/MenuItem)` item) ` Called when a panel's menu item has been selected by the user. | | ` boolean` | ` `[onMenuOpened](https://developer.android.com/reference/android/app/Dialog#onMenuOpened(int,%20android.view.Menu))`(int featureId, `[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` Called when a panel's menu is opened by the user. | | ` boolean` | ` `[onOptionsItemSelected](https://developer.android.com/reference/android/app/Dialog#onOptionsItemSelected(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem)` item) ` | | ` void` | ` `[onOptionsMenuClosed](https://developer.android.com/reference/android/app/Dialog#onOptionsMenuClosed(android.view.Menu))`(`[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` | | ` void` | ` `[onPanelClosed](https://developer.android.com/reference/android/app/Dialog#onPanelClosed(int,%20android.view.Menu))`(int featureId, `[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` Called when a panel is being closed. | | ` boolean` | ` `[onPrepareOptionsMenu](https://developer.android.com/reference/android/app/Dialog#onPrepareOptionsMenu(android.view.Menu))`(`[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` It is usually safe to proxy this call to the owner activity's[Activity.onPrepareOptionsMenu(Menu)](https://developer.android.com/reference/android/app/Activity#onPrepareOptionsMenu(android.view.Menu))if the client desires the same menu for this Dialog. | | ` boolean` | ` `[onPreparePanel](https://developer.android.com/reference/android/app/Dialog#onPreparePanel(int,%20android.view.View,%20android.view.Menu))`(int featureId, `[View](https://developer.android.com/reference/android/view/View)` view, `[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` Prepare a panel to be displayed. | | ` void` | ` `[onRestoreInstanceState](https://developer.android.com/reference/android/app/Dialog#onRestoreInstanceState(android.os.Bundle))`(`[Bundle](https://developer.android.com/reference/android/os/Bundle)` savedInstanceState) ` Restore the state of the dialog from a previously saved bundle. | | ` `[Bundle](https://developer.android.com/reference/android/os/Bundle) | ` `[onSaveInstanceState](https://developer.android.com/reference/android/app/Dialog#onSaveInstanceState())`() ` Saves the state of the dialog into a bundle. | | ` boolean` | ` `[onSearchRequested](https://developer.android.com/reference/android/app/Dialog#onSearchRequested(android.view.SearchEvent))`(`[SearchEvent](https://developer.android.com/reference/android/view/SearchEvent)` searchEvent) ` This hook is called when the user signals the desire to start a search. | | ` boolean` | ` `[onSearchRequested](https://developer.android.com/reference/android/app/Dialog#onSearchRequested())`() ` This hook is called when the user signals the desire to start a search. | | ` void` | ` `[onStart](https://developer.android.com/reference/android/app/Dialog#onStart())`() ` Called when the dialog is starting. | | ` void` | ` `[onStop](https://developer.android.com/reference/android/app/Dialog#onStop())`() ` Called to tell you that you're stopping. | | ` boolean` | ` `[onTouchEvent](https://developer.android.com/reference/android/app/Dialog#onTouchEvent(android.view.MotionEvent))`(`[MotionEvent](https://developer.android.com/reference/android/view/MotionEvent)` event) ` Called when a touch screen event was not handled by any of the views under it. | | ` boolean` | ` `[onTrackballEvent](https://developer.android.com/reference/android/app/Dialog#onTrackballEvent(android.view.MotionEvent))`(`[MotionEvent](https://developer.android.com/reference/android/view/MotionEvent)` event) ` Called when the trackball was moved and not handled by any of the views inside of the activity. | | ` void` | ` `[onWindowAttributesChanged](https://developer.android.com/reference/android/app/Dialog#onWindowAttributesChanged(android.view.WindowManager.LayoutParams))`(`[WindowManager.LayoutParams](https://developer.android.com/reference/android/view/WindowManager.LayoutParams)` params) ` This is called whenever the current window attributes change. | | ` void` | ` `[onWindowFocusChanged](https://developer.android.com/reference/android/app/Dialog#onWindowFocusChanged(boolean))`(boolean hasFocus) ` This hook is called whenever the window focus changes. | | ` `[ActionMode](https://developer.android.com/reference/android/view/ActionMode) | ` `[onWindowStartingActionMode](https://developer.android.com/reference/android/app/Dialog#onWindowStartingActionMode(android.view.ActionMode.Callback))`(`[ActionMode.Callback](https://developer.android.com/reference/android/view/ActionMode.Callback)` callback) ` Called when an action mode is being started for this window. | | ` `[ActionMode](https://developer.android.com/reference/android/view/ActionMode) | ` `[onWindowStartingActionMode](https://developer.android.com/reference/android/app/Dialog#onWindowStartingActionMode(android.view.ActionMode.Callback,%20int))`(`[ActionMode.Callback](https://developer.android.com/reference/android/view/ActionMode.Callback)` callback, int type) ` Called when an action mode is being started for this window. | | ` void` | ` `[openContextMenu](https://developer.android.com/reference/android/app/Dialog#openContextMenu(android.view.View))`(`[View](https://developer.android.com/reference/android/view/View)` view) ` | | ` void` | ` `[openOptionsMenu](https://developer.android.com/reference/android/app/Dialog#openOptionsMenu())`() ` | | ` void` | ` `[registerForContextMenu](https://developer.android.com/reference/android/app/Dialog#registerForContextMenu(android.view.View))`(`[View](https://developer.android.com/reference/android/view/View)` view) ` | | ` final boolean` | ` `[requestWindowFeature](https://developer.android.com/reference/android/app/Dialog#requestWindowFeature(int))`(int featureId) ` Enable extended window features. | | ` final T` | ` `[requireViewById](https://developer.android.com/reference/android/app/Dialog#requireViewById(int))`(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()](https://developer.android.com/reference/android/app/Dialog#show())or[create()](https://developer.android.com/reference/android/app/Dialog#create())). | | ` void` | ` `[setCancelMessage](https://developer.android.com/reference/android/app/Dialog#setCancelMessage(android.os.Message))`(`[Message](https://developer.android.com/reference/android/os/Message)` msg) ` Set a message to be sent when the dialog is canceled. | | ` void` | ` `[setCancelable](https://developer.android.com/reference/android/app/Dialog#setCancelable(boolean))`(boolean flag) ` Sets whether this dialog is cancelable with the[BACK](https://developer.android.com/reference/android/view/KeyEvent#KEYCODE_BACK)key. | | ` void` | ` `[setCanceledOnTouchOutside](https://developer.android.com/reference/android/app/Dialog#setCanceledOnTouchOutside(boolean))`(boolean cancel) ` Sets whether this dialog is canceled when touched outside the window's bounds. | | ` void` | ` `[setContentView](https://developer.android.com/reference/android/app/Dialog#setContentView(int))`(int layoutResID) ` Set the screen content from a layout resource. | | ` void` | ` `[setContentView](https://developer.android.com/reference/android/app/Dialog#setContentView(android.view.View,%20android.view.ViewGroup.LayoutParams))`(`[View](https://developer.android.com/reference/android/view/View)` view, `[ViewGroup.LayoutParams](https://developer.android.com/reference/android/view/ViewGroup.LayoutParams)` params) ` Set the screen content to an explicit view. | | ` void` | ` `[setContentView](https://developer.android.com/reference/android/app/Dialog#setContentView(android.view.View))`(`[View](https://developer.android.com/reference/android/view/View)` view) ` Set the screen content to an explicit view. | | ` void` | ` `[setDismissMessage](https://developer.android.com/reference/android/app/Dialog#setDismissMessage(android.os.Message))`(`[Message](https://developer.android.com/reference/android/os/Message)` msg) ` Set a message to be sent when the dialog is dismissed. | | ` final void` | ` `[setFeatureDrawable](https://developer.android.com/reference/android/app/Dialog#setFeatureDrawable(int,%20android.graphics.drawable.Drawable))`(int featureId, `[Drawable](https://developer.android.com/reference/android/graphics/drawable/Drawable)` drawable) ` Convenience for calling[Window.setFeatureDrawable(int, Drawable)](https://developer.android.com/reference/android/view/Window#setFeatureDrawable(int,%20android.graphics.drawable.Drawable)). | | ` final void` | ` `[setFeatureDrawableAlpha](https://developer.android.com/reference/android/app/Dialog#setFeatureDrawableAlpha(int,%20int))`(int featureId, int alpha) ` Convenience for calling[Window.setFeatureDrawableAlpha(int, int)](https://developer.android.com/reference/android/view/Window#setFeatureDrawableAlpha(int,%20int)). | | ` final void` | ` `[setFeatureDrawableResource](https://developer.android.com/reference/android/app/Dialog#setFeatureDrawableResource(int,%20int))`(int featureId, int resId) ` Convenience for calling[Window.setFeatureDrawableResource(int, int)](https://developer.android.com/reference/android/view/Window#setFeatureDrawableResource(int,%20int)). | | ` final void` | ` `[setFeatureDrawableUri](https://developer.android.com/reference/android/app/Dialog#setFeatureDrawableUri(int,%20android.net.Uri))`(int featureId, `[Uri](https://developer.android.com/reference/android/net/Uri)` uri) ` Convenience for calling[Window.setFeatureDrawableUri(int, Uri)](https://developer.android.com/reference/android/view/Window#setFeatureDrawableUri(int,%20android.net.Uri)). | | ` void` | ` `[setOnCancelListener](https://developer.android.com/reference/android/app/Dialog#setOnCancelListener(android.content.DialogInterface.OnCancelListener))`(`[DialogInterface.OnCancelListener](https://developer.android.com/reference/android/content/DialogInterface.OnCancelListener)` listener) ` Set a listener to be invoked when the dialog is canceled. | | ` void` | ` `[setOnDismissListener](https://developer.android.com/reference/android/app/Dialog#setOnDismissListener(android.content.DialogInterface.OnDismissListener))`(`[DialogInterface.OnDismissListener](https://developer.android.com/reference/android/content/DialogInterface.OnDismissListener)` listener) ` Set a listener to be invoked when the dialog is dismissed. | | ` void` | ` `[setOnKeyListener](https://developer.android.com/reference/android/app/Dialog#setOnKeyListener(android.content.DialogInterface.OnKeyListener))`(`[DialogInterface.OnKeyListener](https://developer.android.com/reference/android/content/DialogInterface.OnKeyListener)` onKeyListener) ` Sets the callback that will be called if a key is dispatched to the dialog. | | ` void` | ` `[setOnShowListener](https://developer.android.com/reference/android/app/Dialog#setOnShowListener(android.content.DialogInterface.OnShowListener))`(`[DialogInterface.OnShowListener](https://developer.android.com/reference/android/content/DialogInterface.OnShowListener)` listener) ` Sets a listener to be invoked when the dialog is shown. | | ` final void` | ` `[setOwnerActivity](https://developer.android.com/reference/android/app/Dialog#setOwnerActivity(android.app.Activity))`(`[Activity](https://developer.android.com/reference/android/app/Activity)` activity) ` Sets the Activity that owns this dialog. | | ` void` | ` `[setTitle](https://developer.android.com/reference/android/app/Dialog#setTitle(java.lang.CharSequence))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` title) ` Set the title text for this dialog's window. | | ` void` | ` `[setTitle](https://developer.android.com/reference/android/app/Dialog#setTitle(int))`(int titleId) ` Set the title text for this dialog's window. | | ` final void` | ` `[setVolumeControlStream](https://developer.android.com/reference/android/app/Dialog#setVolumeControlStream(int))`(int streamType) ` By default, this will use the owner Activity's suggested stream type. | | ` void` | ` `[show](https://developer.android.com/reference/android/app/Dialog#show())`() ` Start the dialog and display it on screen. | | ` void` | ` `[takeKeyEvents](https://developer.android.com/reference/android/app/Dialog#takeKeyEvents(boolean))`(boolean get) ` Request that key events come to this dialog. | | ` void` | ` `[unregisterForContextMenu](https://developer.android.com/reference/android/app/Dialog#unregisterForContextMenu(android.view.View))`(`[View](https://developer.android.com/reference/android/view/View)` view) ` | || | From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(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](https://developer.android.com/reference/java/lang/Object#wait(long))`(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](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | || | From interface` `[android.content.DialogInterface](https://developer.android.com/reference/android/content/DialogInterface)` ` |------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract void` | ` `[cancel](https://developer.android.com/reference/android/content/DialogInterface#cancel())`() ` Cancels the dialog, invoking the[OnCancelListener](https://developer.android.com/reference/android/content/DialogInterface.OnCancelListener). | | ` abstract void` | ` `[dismiss](https://developer.android.com/reference/android/content/DialogInterface#dismiss())`() ` Dismisses the dialog, invoking the[OnDismissListener](https://developer.android.com/reference/android/content/DialogInterface.OnDismissListener). | || | From interface` `[android.view.KeyEvent.Callback](https://developer.android.com/reference/android/view/KeyEvent.Callback)` ` |---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract boolean` | ` `[onKeyDown](https://developer.android.com/reference/android/view/KeyEvent.Callback#onKeyDown(int,%20android.view.KeyEvent))`(int keyCode, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Called when a key down event has occurred. | | ` abstract boolean` | ` `[onKeyLongPress](https://developer.android.com/reference/android/view/KeyEvent.Callback#onKeyLongPress(int,%20android.view.KeyEvent))`(int keyCode, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Called when a long press has occurred. | | ` abstract boolean` | ` `[onKeyMultiple](https://developer.android.com/reference/android/view/KeyEvent.Callback#onKeyMultiple(int,%20int,%20android.view.KeyEvent))`(int keyCode, int count, `[KeyEvent](https://developer.android.com/reference/android/view/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](https://developer.android.com/reference/android/view/KeyEvent.Callback#onKeyUp(int,%20android.view.KeyEvent))`(int keyCode, `[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Called when a key up event has occurred. | || | From interface` `[android.view.View.OnCreateContextMenuListener](https://developer.android.com/reference/android/view/View.OnCreateContextMenuListener)` ` |------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract void` | ` `[onCreateContextMenu](https://developer.android.com/reference/android/view/View.OnCreateContextMenuListener#onCreateContextMenu(android.view.ContextMenu,%20android.view.View,%20android.view.ContextMenu.ContextMenuInfo))`(`[ContextMenu](https://developer.android.com/reference/android/view/ContextMenu)` menu, `[View](https://developer.android.com/reference/android/view/View)` v, `[ContextMenu.ContextMenuInfo](https://developer.android.com/reference/android/view/ContextMenu.ContextMenuInfo)` menuInfo) ` Called when the context menu for this view is being built. | || | From interface` `[android.view.Window.Callback](https://developer.android.com/reference/android/view/Window.Callback)` ` |-------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract boolean` | ` `[dispatchGenericMotionEvent](https://developer.android.com/reference/android/view/Window.Callback#dispatchGenericMotionEvent(android.view.MotionEvent))`(`[MotionEvent](https://developer.android.com/reference/android/view/MotionEvent)` event) ` Called to process generic motion events. | | ` abstract boolean` | ` `[dispatchKeyEvent](https://developer.android.com/reference/android/view/Window.Callback#dispatchKeyEvent(android.view.KeyEvent))`(`[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Called to process key events. | | ` abstract boolean` | ` `[dispatchKeyShortcutEvent](https://developer.android.com/reference/android/view/Window.Callback#dispatchKeyShortcutEvent(android.view.KeyEvent))`(`[KeyEvent](https://developer.android.com/reference/android/view/KeyEvent)` event) ` Called to process a key shortcut event. | | ` abstract boolean` | ` `[dispatchPopulateAccessibilityEvent](https://developer.android.com/reference/android/view/Window.Callback#dispatchPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent))`(`[AccessibilityEvent](https://developer.android.com/reference/android/view/accessibility/AccessibilityEvent)` event) ` Called to process population of[AccessibilityEvent](https://developer.android.com/reference/android/view/accessibility/AccessibilityEvent)s. | | ` abstract boolean` | ` `[dispatchTouchEvent](https://developer.android.com/reference/android/view/Window.Callback#dispatchTouchEvent(android.view.MotionEvent))`(`[MotionEvent](https://developer.android.com/reference/android/view/MotionEvent)` event) ` Called to process touch screen events. | | ` abstract boolean` | ` `[dispatchTrackballEvent](https://developer.android.com/reference/android/view/Window.Callback#dispatchTrackballEvent(android.view.MotionEvent))`(`[MotionEvent](https://developer.android.com/reference/android/view/MotionEvent)` event) ` Called to process trackball events. | | ` abstract void` | ` `[onActionModeFinished](https://developer.android.com/reference/android/view/Window.Callback#onActionModeFinished(android.view.ActionMode))`(`[ActionMode](https://developer.android.com/reference/android/view/ActionMode)` mode) ` Called when an action mode has been finished. | | ` abstract void` | ` `[onActionModeStarted](https://developer.android.com/reference/android/view/Window.Callback#onActionModeStarted(android.view.ActionMode))`(`[ActionMode](https://developer.android.com/reference/android/view/ActionMode)` mode) ` Called when an action mode has been started. | | ` abstract void` | ` `[onAttachedToWindow](https://developer.android.com/reference/android/view/Window.Callback#onAttachedToWindow())`() ` Called when the window has been attached to the window manager. | | ` abstract void` | ` `[onContentChanged](https://developer.android.com/reference/android/view/Window.Callback#onContentChanged())`() ` This hook is called whenever the content view of the screen changes (due to a call to[Window.setContentView](https://developer.android.com/reference/android/view/Window#setContentView(android.view.View,%20android.view.ViewGroup.LayoutParams))or[Window.addContentView](https://developer.android.com/reference/android/view/Window#addContentView(android.view.View,%20android.view.ViewGroup.LayoutParams))). | | ` abstract boolean` | ` `[onCreatePanelMenu](https://developer.android.com/reference/android/view/Window.Callback#onCreatePanelMenu(int,%20android.view.Menu))`(int featureId, `[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` Initialize the contents of the menu for panel 'featureId'. | | ` abstract `[View](https://developer.android.com/reference/android/view/View) | ` `[onCreatePanelView](https://developer.android.com/reference/android/view/Window.Callback#onCreatePanelView(int))`(int featureId) ` Instantiate the view to display in the panel for 'featureId'. | | ` abstract void` | ` `[onDetachedFromWindow](https://developer.android.com/reference/android/view/Window.Callback#onDetachedFromWindow())`() ` Called when the window has been detached from the window manager. | | ` abstract boolean` | ` `[onMenuItemSelected](https://developer.android.com/reference/android/view/Window.Callback#onMenuItemSelected(int,%20android.view.MenuItem))`(int featureId, `[MenuItem](https://developer.android.com/reference/android/view/MenuItem)` item) ` Called when a panel's menu item has been selected by the user. | | ` abstract boolean` | ` `[onMenuOpened](https://developer.android.com/reference/android/view/Window.Callback#onMenuOpened(int,%20android.view.Menu))`(int featureId, `[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` Called when a panel's menu is opened by the user. | | ` abstract void` | ` `[onPanelClosed](https://developer.android.com/reference/android/view/Window.Callback#onPanelClosed(int,%20android.view.Menu))`(int featureId, `[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` Called when a panel is being closed. | | ` default void` | ` `[onPointerCaptureChanged](https://developer.android.com/reference/android/view/Window.Callback#onPointerCaptureChanged(boolean))`(boolean hasCapture) ` Called when pointer capture is enabled or disabled for the current window. | | ` abstract boolean` | ` `[onPreparePanel](https://developer.android.com/reference/android/view/Window.Callback#onPreparePanel(int,%20android.view.View,%20android.view.Menu))`(int featureId, `[View](https://developer.android.com/reference/android/view/View)` view, `[Menu](https://developer.android.com/reference/android/view/Menu)` menu) ` Prepare a panel to be displayed. | | ` default void` | ` `[onProvideKeyboardShortcuts](https://developer.android.com/reference/android/view/Window.Callback#onProvideKeyboardShortcuts(java.util.List,%20android.view.Menu,%20int))`(`[List](https://developer.android.com/reference/java/util/List)`<`[KeyboardShortcutGroup](https://developer.android.com/reference/android/view/KeyboardShortcutGroup)`> data, `[Menu](https://developer.android.com/reference/android/view/Menu)` menu, int deviceId) ` Called when Keyboard Shortcuts are requested for the current window. | | ` abstract boolean` | ` `[onSearchRequested](https://developer.android.com/reference/android/view/Window.Callback#onSearchRequested())`() ` Called when the user signals the desire to start a search. | | ` abstract boolean` | ` `[onSearchRequested](https://developer.android.com/reference/android/view/Window.Callback#onSearchRequested(android.view.SearchEvent))`(`[SearchEvent](https://developer.android.com/reference/android/view/SearchEvent)` searchEvent) ` Called when the user signals the desire to start a search. | | ` abstract void` | ` `[onWindowAttributesChanged](https://developer.android.com/reference/android/view/Window.Callback#onWindowAttributesChanged(android.view.WindowManager.LayoutParams))`(`[WindowManager.LayoutParams](https://developer.android.com/reference/android/view/WindowManager.LayoutParams)` attrs) ` This is called whenever the current window attributes change. | | ` abstract void` | ` `[onWindowFocusChanged](https://developer.android.com/reference/android/view/Window.Callback#onWindowFocusChanged(boolean))`(boolean hasFocus) ` This hook is called whenever the window focus changes. | | ` abstract `[ActionMode](https://developer.android.com/reference/android/view/ActionMode) | ` `[onWindowStartingActionMode](https://developer.android.com/reference/android/view/Window.Callback#onWindowStartingActionMode(android.view.ActionMode.Callback))`(`[ActionMode.Callback](https://developer.android.com/reference/android/view/ActionMode.Callback)` callback) ` Called when an action mode is being started for this window. | | ` abstract `[ActionMode](https://developer.android.com/reference/android/view/ActionMode) | ` `[onWindowStartingActionMode](https://developer.android.com/reference/android/view/Window.Callback#onWindowStartingActionMode(android.view.ActionMode.Callback,%20int))`(`[ActionMode.Callback](https://developer.android.com/reference/android/view/ActionMode.Callback)` callback, int type) ` Called when an action mode is being started for this window. | || | From interface` `[android.widget.DatePicker.OnDateChangedListener](https://developer.android.com/reference/android/widget/DatePicker.OnDateChangedListener)` ` |------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract void` | ` `[onDateChanged](https://developer.android.com/reference/android/widget/DatePicker.OnDateChangedListener#onDateChanged(android.widget.DatePicker,%20int,%20int,%20int))`(`[DatePicker](https://developer.android.com/reference/android/widget/DatePicker)` view, int year, int monthOfYear, int dayOfMonth) ` Called upon a date change. | || | From interface` `[android.content.DialogInterface.OnClickListener](https://developer.android.com/reference/android/content/DialogInterface.OnClickListener)` ` |------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract void` | ` `[onClick](https://developer.android.com/reference/android/content/DialogInterface.OnClickListener#onClick(android.content.DialogInterface,%20int))`(`[DialogInterface](https://developer.android.com/reference/android/content/DialogInterface)` dialog, int which) ` This method will be invoked when a button in the dialog is clicked. | || ## Public constructors ### DatePickerDialog Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DatePickerDialog (Context context) ``` Creates a new date picker dialog for the current date using the parent context's default date picker dialog theme.
| Parameters || |-----------|------------------------------------------------------------------| | `context` | `Context`: the parent context This value cannot be`null`.
| ### DatePickerDialog Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DatePickerDialog (Context context, DatePickerDialog.OnDateSetListener listener, int year, int month, int dayOfMonth) ``` Creates a new date picker dialog for the specified date using the parent context's default date picker dialog theme.
| Parameters || |--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------| | `context` | `Context`: the parent context This value cannot be`null`.
| | `listener` | `DatePickerDialog.OnDateSetListener`: the listener to call when the user sets the date This value may be`null`.
| | `year` | `int`: the initially selected year
| | `month` | `int`: the initially selected month (0-11 for compatibility with[Calendar.MONTH](https://developer.android.com/reference/java/util/Calendar#MONTH))
| | `dayOfMonth` | `int`: the initially selected day of month (1-31, depending on month)
| ### DatePickerDialog Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DatePickerDialog (Context context, int themeResId) ``` Creates a new date picker dialog for the current date.
| Parameters || |--------------|-----------------------------------------------------------------------------------------------------------------------------------------------| | `context` | `Context`: the parent context This value cannot be`null`.
| | `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
| ### DatePickerDialog Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DatePickerDialog (Context context, int themeResId, DatePickerDialog.OnDateSetListener listener, int year, int monthOfYear, int dayOfMonth) ``` Creates a new date picker dialog for the specified date.
| Parameters || |---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `context` | `Context`: the parent context This value cannot be`null`.
| | `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
| | `listener` | `DatePickerDialog.OnDateSetListener`: the listener to call when the user sets the date This value may be`null`.
| | `year` | `int`: the initially selected year
| | `monthOfYear` | `int`: the initially selected month of the year (0-11 for compatibility with[Calendar.MONTH](https://developer.android.com/reference/java/util/Calendar#MONTH))
| | `dayOfMonth` | `int`: the initially selected day of month (1-31, depending on month)
| ## Public methods ### getDatePicker Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public DatePicker getDatePicker () ``` Returns the[DatePicker](https://developer.android.com/reference/android/widget/DatePicker)contained in this dialog.
| Returns || |---------------------------------------------------------------------------------|----------------------------------------------------| | [DatePicker](https://developer.android.com/reference/android/widget/DatePicker) | the date picker This value cannot be`null`.
| ### onClick Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void onClick (DialogInterface dialog, int which) ``` This method will be invoked when a button in the dialog is clicked.
| Parameters || |----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `dialog` | `DialogInterface`: This value cannot be`null`.
| | `which` | `int`: the button that was clicked (ex.[DialogInterface.BUTTON_POSITIVE](https://developer.android.com/reference/android/content/DialogInterface#BUTTON_POSITIVE)) or the position of the item clicked
| ### onDateChanged Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void onDateChanged (DatePicker view, int year, int month, int dayOfMonth) ``` Called upon a date change.
| Parameters || |--------------|-------------------------------------------------------------------------------------------------------------------------------------------| | `view` | `DatePicker`: This value cannot be`null`.
| | `year` | `int`: The year that was set.
| | `month` | `int`: The month that was set (0-11) for compatibility with[Calendar](https://developer.android.com/reference/java/util/Calendar).
| | `dayOfMonth` | `int`: The day of the month that was set.
| ### onRestoreInstanceState Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void onRestoreInstanceState (Bundle savedInstanceState) ``` Restore the state of the dialog from a previously saved bundle. The default implementation restores the state of the dialog's view hierarchy that was saved in the default implementation of[onSaveInstanceState()](https://developer.android.com/reference/android/app/Dialog#onSaveInstanceState()), so be sure to call through to super when overriding unless you want to do all restoring of state yourself.
| Parameters || |----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `savedInstanceState` | `Bundle`: The state of the dialog previously saved by[onSaveInstanceState()](https://developer.android.com/reference/android/app/DatePickerDialog#onSaveInstanceState()). This value cannot be`null`.
| ### onSaveInstanceState Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public Bundle onSaveInstanceState () ``` Saves the state of the dialog into a bundle. The default implementation saves the state of its view hierarchy, so you'll likely want to call through to super if you override this to save additional state.
| Returns || |---------------------------------------------------------------------|---------------------------------------------------------------------------| | [Bundle](https://developer.android.com/reference/android/os/Bundle) | A bundle with the state of the dialog. This value cannot be`null`.
| ### setOnDateSetListener Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void setOnDateSetListener (DatePickerDialog.OnDateSetListener listener) ``` Sets the listener to call when the user sets the date.
| Parameters || |------------|------------------------------------------------------------------------------------------------------------------------| | `listener` | `DatePickerDialog.OnDateSetListener`: the listener to call when the user sets the date This value may be`null`.
| ### updateDate Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void updateDate (int year, int month, int dayOfMonth) ``` Sets the current date.
| Parameters || |--------------|-----------------------------------------------------------------------------------------------------------------------------------------| | `year` | `int`: the year
| | `month` | `int`: the month (0-11 for compatibility with[Calendar.MONTH](https://developer.android.com/reference/java/util/Calendar#MONTH))
| | `dayOfMonth` | `int`: the day of month (1-31, depending on month)
|