Android - An Open Handset Alliance Project

android.app
public class

android.app.AlertDialog

java.lang.Object
	android.app.Dialog		DialogInterface KeyEvent.Callback Window.Callback
		android.app.AlertDialog	DialogInterface

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 "body" and add your view to it:

 FrameLayout fl = (FrameLayout) findViewById(R.id.body);
 fl.add(myView, new LayoutParams(FILL_PARENT, WRAP_CONTENT));

Nested Classes

AlertDialog.Builder

Summary

Constants inherited from interface android.content.DialogInterface

BUTTON1, BUTTON2, BUTTON3

		Value
int	BUTTON1	-1	0xffffffff
int	BUTTON2	-2	0xfffffffe
int	BUTTON3	-3	0xfffffffd

Fields inherited from class android.app.Dialog

mCancelMessage, mCancelable

Protected Constructors

					AlertDialog(Context context)
					AlertDialog(Context context, int theme)
					AlertDialog(Context context, boolean cancelable, Message cancelCallback)
					AlertDialog(Context context, boolean cancelable, OnCancelListener cancelListener)

Public Methods

	boolean	onKeyDown(int keyCode, KeyEvent event)
		A key was pressed down.
	boolean	onKeyUp(int keyCode, KeyEvent event)
		A key was released.
	void	onStart()
		Called when the dialog is starting.
	void	setButton(CharSequence text, Message msg)
	void	setButton(CharSequence text, OnClickListener listener)
		Set a listener to be invoked when button 1 of the dialog is pressed.
	void	setButton2(CharSequence text, Message msg)
	void	setButton2(CharSequence text, OnClickListener listener)
		Set a listener to be invoked when button 2 of the dialog is pressed.
	void	setButton3(CharSequence text, OnClickListener listener)
		Set a listener to be invoked when button 3 of the dialog is pressed.
	void	setIcon(Drawable icon)
	void	setIcon(int resId)
	void	setMessage(CharSequence message)
	void	setTitle(CharSequence title)
		Set the title text for this dialog's window.
	void	setView(View view)
		Set the view to display in that dialog.
static	AlertDialog	show(Context context, CharSequence title, int iconId, CharSequence message, CharSequence button1Text, OnClickListener button1Listener, CharSequence button2Text, OnClickListener button2Listener, CharSequence button3Text, OnClickListener button3Listener, boolean cancelable, OnCancelListener cancelListener)
		Display a simple alert dialog.
static	AlertDialog	show(Context context, CharSequence title, int iconId, CharSequence message, CharSequence buttonText, boolean cancelable)
		Display a simple alert dialog.
static	AlertDialog	show(Context context, CharSequence title, int iconId, CharSequence message, CharSequence buttonText, OnClickListener buttonListener, boolean cancelable, OnCancelListener cancelListener)
		Display a simple alert dialog.
static	AlertDialog	show(Context context, CharSequence title, int iconId, CharSequence message, CharSequence button1Text, OnClickListener button1Listener, CharSequence button2Text, OnClickListener button2Listener, boolean cancelable, OnCancelListener cancelListener)
		Display a simple alert dialog.
static	AlertDialog	show(Context context, CharSequence title, Drawable icon, View view, CharSequence buttonText, OnClickListener buttonListener, CharSequence button2Text, OnClickListener button2Listener, CharSequence button3Text, OnClickListener button3Listener, boolean cancelable, OnCancelListener cancelListener)
		Display a simple alert dialog.
static	AlertDialog	show(Context context, CharSequence title, int iconId, View view, CharSequence buttonText, OnClickListener buttonListener, CharSequence button2Text, OnClickListener button2Listener, boolean cancelable, OnCancelListener cancelListener)
		Display a simple alert dialog.
static	AlertDialog	show(Context context, CharSequence title, int iconId, View view, CharSequence buttonText, OnClickListener buttonListener, CharSequence button2Text, OnClickListener button2Listener, CharSequence button3Text, OnClickListener button3Listener, boolean cancelable, OnCancelListener cancelListener)
		Display a simple alert dialog.

Methods inherited from class android.app.Dialog

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

	Object	clone()
		Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Answers a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

				boolean	dispatchKeyEvent(KeyEvent event)
					Called to process key events.
				boolean	dispatchTouchEvent(MotionEvent event)
					Called to process touch screen events.
				boolean	dispatchTrackballEvent(MotionEvent event)
					Called to process trackball events.
				void	onContentChanged()
					This hook is called whenever the content view of the screen changes (due to a call to setContentView().
				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'.
				boolean	onMenuItemSelected(int featureId, Item item)
					Called when a panel's menu item has been selected by the user.
				void	onPanelClosed(int featureId, Menu menu)
					Called when a panel is being closed.
				boolean	onPreparePanel(int featureId, View view, Menu menu)
					Prepare a panel to be displayed.
				boolean	onSearchRequested()
					Called when the user signals the desire to start a search.
				void	onWindowAttributesChanged(LayoutParams attrs)
					This is called whenever the current window attributes change.
				void	onWindowFocusChanged(boolean hasFocus)
					This hook is called whenever the window focus changes.

Details

Protected Constructors

protected AlertDialog(Context context)

protected AlertDialog(Context context, int theme)

protected AlertDialog(Context context, boolean cancelable, Message cancelCallback)

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

Public Methods

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.

The default implementation handles KEYCODE_BACK to close the dialog.

public boolean onKeyUp(int keyCode, KeyEvent event)

A key was released.

public void onStart()

Called when the dialog is starting.

public void setButton(CharSequence text, Message msg)

public void setButton(CharSequence text, OnClickListener listener)

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

Parameters

text	The text to display in button 1.
listener	The DialogInterface.OnClickListener to use.

public void setButton2(CharSequence text, Message msg)

public void setButton2(CharSequence text, OnClickListener listener)

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

Parameters

text	The text to display in button 2.
listener	The DialogInterface.OnClickListener to use.

public void setButton3(CharSequence text, OnClickListener listener)

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

Parameters

text	The text to display in button 3.
listener	The DialogInterface.OnClickListener to use.

public void setIcon(Drawable icon)

public void setIcon(int resId)

public void setMessage(CharSequence message)

public void setTitle(CharSequence title)

Set the title text for this dialog's window.

Parameters

title	The new text to display in the title.