java.lang.Object | ||
↳ | android.app.Dialog | |
↳ | android.app.AlertDialog |
Known Direct Subclasses |
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 = (FrameLayout) 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)
.
For more information about creating dialogs, read the Dialogs developer guide.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
AlertDialog.Builder |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | THEME_DEVICE_DEFAULT_DARK | Special theme constant for AlertDialog(Context, int) : use
the device's default alert theme with a dark background. |
|||||||||
int | THEME_DEVICE_DEFAULT_LIGHT | Special theme constant for AlertDialog(Context, int) : use
the device's default alert theme with a light background. |
|||||||||
int | THEME_HOLO_DARK | Special theme constant for AlertDialog(Context, int) : use
the holographic alert theme with a dark background. |
|||||||||
int | THEME_HOLO_LIGHT | Special theme constant for AlertDialog(Context, int) : use
the holographic alert theme with a light background. |
|||||||||
int | THEME_TRADITIONAL | Special theme constant for AlertDialog(Context, int) : use
the traditional (pre-Holo) alert dialog theme. |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
android.content.DialogInterface
|
Protected Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Construct an AlertDialog that uses an explicit theme.
| |||||||||||
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Gets one of the buttons used in the dialog.
| |||||||||||
Gets the list view used in the dialog.
| |||||||||||
A key was pressed down.
| |||||||||||
A key was released.
| |||||||||||
This method was deprecated
in API level 3.
Use
setButton(int, CharSequence, Message) with
BUTTON_POSITIVE .
| |||||||||||
Set a listener to be invoked when the positive button of the dialog is pressed.
| |||||||||||
This method was deprecated
in API level 3.
Use
setButton(int, CharSequence, android.content.DialogInterface.OnClickListener)
with BUTTON_POSITIVE
| |||||||||||
Set a message to be sent when a button is pressed.
| |||||||||||
This method was deprecated
in API level 3.
Use
setButton(int, CharSequence, android.content.DialogInterface.OnClickListener)
with BUTTON_NEGATIVE
| |||||||||||
This method was deprecated
in API level 3.
Use
setButton(int, CharSequence, Message) with
BUTTON_NEGATIVE .
| |||||||||||
This method was deprecated
in API level 3.
Use
setButton(int, CharSequence, android.content.DialogInterface.OnClickListener)
with BUTTON_POSITIVE
| |||||||||||
This method was deprecated
in API level 3.
Use
setButton(int, CharSequence, Message) with
BUTTON_NEUTRAL .
| |||||||||||
Set resId to 0 if you don't want an icon.
| |||||||||||
Set an icon as supplied by a theme attribute.
| |||||||||||
Set the title text for this dialog's window.
| |||||||||||
Set the view to display in that dialog, specifying the spacing to appear around that
view.
| |||||||||||
Set the view to display in that dialog.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Similar to
onCreate(Bundle) , you should initialize your dialog
in this method, including calling setContentView(View) . |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
android.app.Dialog
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
android.content.DialogInterface
| |||||||||||
From interface
android.view.KeyEvent.Callback
| |||||||||||
From interface
android.view.View.OnCreateContextMenuListener
| |||||||||||
From interface
android.view.Window.Callback
|
Special theme constant for AlertDialog(Context, int)
: use
the device's default alert theme with a dark background.
Special theme constant for AlertDialog(Context, int)
: use
the device's default alert theme with a light background.
Special theme constant for AlertDialog(Context, int)
: use
the holographic alert theme with a dark background.
Special theme constant for AlertDialog(Context, int)
: use
the holographic alert theme with a light background.
Special theme constant for AlertDialog(Context, int)
: use
the traditional (pre-Holo) alert dialog theme.
Construct an AlertDialog that uses an explicit theme. The actual style
that an AlertDialog uses is a private implementation, however you can
here supply either the name of an attribute in the theme from which
to get the dialog's style (such as alertDialogTheme
or one of the constants THEME_TRADITIONAL
,
THEME_HOLO_DARK
, or THEME_HOLO_LIGHT
.
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 show()
or create()
).
whichButton | The identifier of the button that should be returned.
For example, this can be
BUTTON_POSITIVE . |
---|
Gets the list view used in the dialog.
ListView
from the dialog.
A key was pressed down.
If the focused view didn't want this event, this method is called.
The default implementation consumed the KEYCODE_BACK to later
handle it in onKeyUp(int, KeyEvent)
.
keyCode | The value in event.getKeyCode(). |
---|---|
event | Description of the key event. |
A key was released.
The default implementation handles KEYCODE_BACK to close the dialog.
keyCode | The value in event.getKeyCode(). |
---|---|
event | Description of the key event. |
This method was deprecated
in API level 3.
Use setButton(int, CharSequence, Message)
with
BUTTON_POSITIVE
.
Set a listener to be invoked when the positive button of the dialog is pressed.
whichButton | Which button to set the listener on, can be one of
BUTTON_POSITIVE ,
BUTTON_NEGATIVE , or
BUTTON_NEUTRAL |
---|---|
text | The text to display in positive button. |
listener | The DialogInterface.OnClickListener to use.
|
This method was deprecated
in API level 3.
Use
setButton(int, CharSequence, android.content.DialogInterface.OnClickListener)
with BUTTON_POSITIVE
Set a listener to be invoked when button 1 of the dialog is pressed.
text | The text to display in button 1. |
---|---|
listener | The DialogInterface.OnClickListener to use. |
Set a message to be sent when a button is pressed.
whichButton | Which button to set the message for, can be one of
BUTTON_POSITIVE ,
BUTTON_NEGATIVE , or
BUTTON_NEUTRAL |
---|---|
text | The text to display in positive button. |
msg | The Message to be sent when clicked.
|
This method was deprecated
in API level 3.
Use
setButton(int, CharSequence, android.content.DialogInterface.OnClickListener)
with BUTTON_NEGATIVE
Set a listener to be invoked when button 2 of the dialog is pressed.
text | The text to display in button 2. |
---|---|
listener | The DialogInterface.OnClickListener to use. |
This method was deprecated
in API level 3.
Use setButton(int, CharSequence, Message)
with
BUTTON_NEGATIVE
.
This method was deprecated
in API level 3.
Use
setButton(int, CharSequence, android.content.DialogInterface.OnClickListener)
with BUTTON_POSITIVE
Set a listener to be invoked when button 3 of the dialog is pressed.
text | The text to display in button 3. |
---|---|
listener | The DialogInterface.OnClickListener to use. |
This method was deprecated
in API level 3.
Use setButton(int, CharSequence, Message)
with
BUTTON_NEUTRAL
.
Set resId to 0 if you don't want an icon.
resId | the resourceId of the drawable to use as the icon or 0 if you don't want an icon. |
---|
Set an icon as supplied by a theme attribute. e.g. android.R.attr.alertDialogIcon
attrId | ID of a theme attribute that points to a drawable resource. |
---|
Set the title text for this dialog's window.
title | The new text to display in the title. |
---|
Set the view to display in that dialog, specifying the spacing to appear around that view.
view | The view to show in the content area of the dialog |
---|---|
viewSpacingLeft | Extra space to appear to the left of view |
viewSpacingTop | Extra space to appear above view |
viewSpacingRight | Extra space to appear to the right of view |
viewSpacingBottom | Extra space to appear below view
|
Similar to onCreate(Bundle)
, you should initialize your dialog
in this method, including calling setContentView(View)
.
savedInstanceState | If this dialog is being reinitalized after a
the hosting activity was previously shut down, holds the result from
the most recent call to onSaveInstanceState() , or null if this
is the first time.
|
---|