public static class AlertDialog.Builder extends Object
Constructor and Description |
---|
AlertDialog.Builder(Context context)
Constructor using a context for this builder and the
AlertDialog it creates. |
AlertDialog.Builder(Context context,
int theme)
Constructor using a context and theme for this builder and
the
AlertDialog it creates. |
Modifier and Type | Method and Description |
---|---|
AlertDialog |
create()
Creates a
AlertDialog with the arguments supplied to this builder. |
Context |
getContext()
Returns a
Context with the appropriate theme for dialogs created by this Builder. |
AlertDialog.Builder |
setAdapter(ListAdapter adapter,
DialogInterface.OnClickListener listener)
Set a list of items, which are supplied by the given
ListAdapter , to be
displayed in the dialog as the content, you will be notified of the
selected item via the supplied listener. |
AlertDialog.Builder |
setCancelable(boolean cancelable)
Sets whether the dialog is cancelable or not.
|
AlertDialog.Builder |
setCursor(Cursor cursor,
DialogInterface.OnClickListener listener,
String labelColumn)
Set a list of items, which are supplied by the given
Cursor , to be
displayed in the dialog as the content, you will be notified of the
selected item via the supplied listener. |
AlertDialog.Builder |
setCustomTitle(View customTitleView)
Set the title using the custom view
customTitleView . |
AlertDialog.Builder |
setIcon(Drawable icon)
Set the
Drawable to be used in the title. |
AlertDialog.Builder |
setIcon(int iconId)
Set the resource id of the
Drawable to be used in the title. |
AlertDialog.Builder |
setIconAttribute(int attrId)
Set an icon as supplied by a theme attribute.
|
AlertDialog.Builder |
setInverseBackgroundForced(boolean useInverseBackground)
Sets the Dialog to use the inverse background, regardless of what the
contents is.
|
AlertDialog.Builder |
setItems(CharSequence[] items,
DialogInterface.OnClickListener listener)
Set a list of items to be displayed in the dialog as the content, you will be notified of the
selected item via the supplied listener.
|
AlertDialog.Builder |
setItems(int itemsId,
DialogInterface.OnClickListener listener)
Set a list of items to be displayed in the dialog as the content, you will be notified of the
selected item via the supplied listener.
|
AlertDialog.Builder |
setMessage(CharSequence message)
Set the message to display.
|
AlertDialog.Builder |
setMessage(int messageId)
Set the message to display using the given resource id.
|
AlertDialog.Builder |
setMultiChoiceItems(CharSequence[] items,
boolean[] checkedItems,
DialogInterface.OnMultiChoiceClickListener listener)
Set a list of items to be displayed in the dialog as the content,
you will be notified of the selected item via the supplied listener.
|
AlertDialog.Builder |
setMultiChoiceItems(Cursor cursor,
String isCheckedColumn,
String labelColumn,
DialogInterface.OnMultiChoiceClickListener listener)
Set a list of items to be displayed in the dialog as the content,
you will be notified of the selected item via the supplied listener.
|
AlertDialog.Builder |
setMultiChoiceItems(int itemsId,
boolean[] checkedItems,
DialogInterface.OnMultiChoiceClickListener listener)
Set a list of items to be displayed in the dialog as the content,
you will be notified of the selected item via the supplied listener.
|
AlertDialog.Builder |
setNegativeButton(CharSequence text,
DialogInterface.OnClickListener listener)
Set a listener to be invoked when the negative button of the dialog is pressed.
|
AlertDialog.Builder |
setNegativeButton(int textId,
DialogInterface.OnClickListener listener)
Set a listener to be invoked when the negative button of the dialog is pressed.
|
AlertDialog.Builder |
setNeutralButton(CharSequence text,
DialogInterface.OnClickListener listener)
Set a listener to be invoked when the neutral button of the dialog is pressed.
|
AlertDialog.Builder |
setNeutralButton(int textId,
DialogInterface.OnClickListener listener)
Set a listener to be invoked when the neutral button of the dialog is pressed.
|
AlertDialog.Builder |
setOnCancelListener(DialogInterface.OnCancelListener onCancelListener)
Sets the callback that will be called if the dialog is canceled.
|
AlertDialog.Builder |
setOnDismissListener(DialogInterface.OnDismissListener onDismissListener)
Sets the callback that will be called when the dialog is dismissed for any reason.
|
AlertDialog.Builder |
setOnItemSelectedListener(AdapterView.OnItemSelectedListener listener)
Sets a listener to be invoked when an item in the list is selected.
|
AlertDialog.Builder |
setOnKeyListener(DialogInterface.OnKeyListener onKeyListener)
Sets the callback that will be called if a key is dispatched to the dialog.
|
AlertDialog.Builder |
setPositiveButton(CharSequence text,
DialogInterface.OnClickListener listener)
Set a listener to be invoked when the positive button of the dialog is pressed.
|
AlertDialog.Builder |
setPositiveButton(int textId,
DialogInterface.OnClickListener listener)
Set a listener to be invoked when the positive button of the dialog is pressed.
|
AlertDialog.Builder |
setRecycleOnMeasureEnabled(boolean enabled) |
AlertDialog.Builder |
setSingleChoiceItems(CharSequence[] items,
int checkedItem,
DialogInterface.OnClickListener listener)
Set a list of items to be displayed in the dialog as the content, you will be notified of
the selected item via the supplied listener.
|
AlertDialog.Builder |
setSingleChoiceItems(Cursor cursor,
int checkedItem,
String labelColumn,
DialogInterface.OnClickListener listener)
Set a list of items to be displayed in the dialog as the content, you will be notified of
the selected item via the supplied listener.
|
AlertDialog.Builder |
setSingleChoiceItems(int itemsId,
int checkedItem,
DialogInterface.OnClickListener listener)
Set a list of items to be displayed in the dialog as the content, you will be notified of
the selected item via the supplied listener.
|
AlertDialog.Builder |
setSingleChoiceItems(ListAdapter adapter,
int checkedItem,
DialogInterface.OnClickListener listener)
Set a list of items to be displayed in the dialog as the content, you will be notified of
the selected item via the supplied listener.
|
AlertDialog.Builder |
setTitle(CharSequence title)
Set the title displayed in the
Dialog . |
AlertDialog.Builder |
setTitle(int titleId)
Set the title using the given resource id.
|
AlertDialog.Builder |
setView(View view)
Set a custom view to be the contents of the Dialog.
|
AlertDialog.Builder |
setView(View view,
int viewSpacingLeft,
int viewSpacingTop,
int viewSpacingRight,
int viewSpacingBottom)
Set a custom view to be the contents of the Dialog, specifying the
spacing to appear around that view.
|
AlertDialog |
show()
Creates a
AlertDialog with the arguments supplied to this builder and
Dialog.show() 's the dialog. |
public AlertDialog.Builder(Context context)
AlertDialog
it creates.public AlertDialog.Builder(Context context, int theme)
AlertDialog
it creates. The actual theme
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 android.R.attr#alertDialogTheme
or one of the constants
AlertDialog.THEME_TRADITIONAL
,
AlertDialog.THEME_HOLO_DARK
, or
AlertDialog.THEME_HOLO_LIGHT
.public Context getContext()
Context
with the appropriate theme for dialogs created by this Builder.
Applications should use this Context for obtaining LayoutInflaters for inflating views
that will be used in the resulting dialogs, as it will cause views to be inflated with
the correct theme.public AlertDialog.Builder setTitle(int titleId)
public AlertDialog.Builder setTitle(CharSequence title)
Dialog
.public AlertDialog.Builder setCustomTitle(View customTitleView)
customTitleView
. The
methods setTitle(int)
and setIcon(int)
should be
sufficient for most titles, but this is provided if the title needs
more customization. Using this will replace the title and icon set
via the other methods.customTitleView
- The custom view to use as the title.public AlertDialog.Builder setMessage(int messageId)
public AlertDialog.Builder setMessage(CharSequence message)
public AlertDialog.Builder setIcon(int iconId)
Drawable
to be used in the title.public AlertDialog.Builder setIcon(Drawable icon)
Drawable
to be used in the title.public AlertDialog.Builder setIconAttribute(int attrId)
attrId
- ID of a theme attribute that points to a drawable resource.public AlertDialog.Builder setPositiveButton(int textId, DialogInterface.OnClickListener listener)
textId
- The resource id of the text to display in the positive buttonlistener
- The DialogInterface.OnClickListener
to use.public AlertDialog.Builder setPositiveButton(CharSequence text, DialogInterface.OnClickListener listener)
text
- The text to display in the positive buttonlistener
- The DialogInterface.OnClickListener
to use.public AlertDialog.Builder setNegativeButton(int textId, DialogInterface.OnClickListener listener)
textId
- The resource id of the text to display in the negative buttonlistener
- The DialogInterface.OnClickListener
to use.public AlertDialog.Builder setNegativeButton(CharSequence text, DialogInterface.OnClickListener listener)
text
- The text to display in the negative buttonlistener
- The DialogInterface.OnClickListener
to use.public AlertDialog.Builder setNeutralButton(int textId, DialogInterface.OnClickListener listener)
textId
- The resource id of the text to display in the neutral buttonlistener
- The DialogInterface.OnClickListener
to use.public AlertDialog.Builder setNeutralButton(CharSequence text, DialogInterface.OnClickListener listener)
text
- The text to display in the neutral buttonlistener
- The DialogInterface.OnClickListener
to use.public AlertDialog.Builder setCancelable(boolean cancelable)
public AlertDialog.Builder setOnCancelListener(DialogInterface.OnCancelListener onCancelListener)
Even in a cancelable dialog, the dialog may be dismissed for reasons other than
being canceled or one of the supplied choices being selected.
If you are interested in listening for all cases where the dialog is dismissed
and not just when it is canceled, see
setOnDismissListener
.
setCancelable(boolean)
,
setOnDismissListener(android.content.DialogInterface.OnDismissListener)
public AlertDialog.Builder setOnDismissListener(DialogInterface.OnDismissListener onDismissListener)
public AlertDialog.Builder setOnKeyListener(DialogInterface.OnKeyListener onKeyListener)
public AlertDialog.Builder setItems(int itemsId, DialogInterface.OnClickListener listener)
public AlertDialog.Builder setItems(CharSequence[] items, DialogInterface.OnClickListener listener)
public AlertDialog.Builder setAdapter(ListAdapter adapter, DialogInterface.OnClickListener listener)
ListAdapter
, to be
displayed in the dialog as the content, you will be notified of the
selected item via the supplied listener.adapter
- The ListAdapter
to supply the list of itemslistener
- The listener that will be called when an item is clicked.public AlertDialog.Builder setCursor(Cursor cursor, DialogInterface.OnClickListener listener, String labelColumn)
Cursor
, to be
displayed in the dialog as the content, you will be notified of the
selected item via the supplied listener.cursor
- The Cursor
to supply the list of itemslistener
- The listener that will be called when an item is clicked.labelColumn
- The column name on the cursor containing the string to display
in the label.public AlertDialog.Builder setMultiChoiceItems(int itemsId, boolean[] checkedItems, DialogInterface.OnMultiChoiceClickListener listener)
itemsId
- the resource id of an array i.e. R.array.foocheckedItems
- specifies which items are checked. It should be null in which case no
items are checked. If non null it must be exactly the same length as the array of
items.listener
- notified when an item on the list is clicked. The dialog will not be
dismissed when an item is clicked. It will only be dismissed if clicked on a
button, if no buttons are supplied it's up to the user to dismiss the dialog.public AlertDialog.Builder setMultiChoiceItems(CharSequence[] items, boolean[] checkedItems, DialogInterface.OnMultiChoiceClickListener listener)
items
- the text of the items to be displayed in the list.checkedItems
- specifies which items are checked. It should be null in which case no
items are checked. If non null it must be exactly the same length as the array of
items.listener
- notified when an item on the list is clicked. The dialog will not be
dismissed when an item is clicked. It will only be dismissed if clicked on a
button, if no buttons are supplied it's up to the user to dismiss the dialog.public AlertDialog.Builder setMultiChoiceItems(Cursor cursor, String isCheckedColumn, String labelColumn, DialogInterface.OnMultiChoiceClickListener listener)
cursor
- the cursor used to provide the items.isCheckedColumn
- specifies the column name on the cursor to use to determine
whether a checkbox is checked or not. It must return an integer value where 1
means checked and 0 means unchecked.labelColumn
- The column name on the cursor containing the string to display in the
label.listener
- notified when an item on the list is clicked. The dialog will not be
dismissed when an item is clicked. It will only be dismissed if clicked on a
button, if no buttons are supplied it's up to the user to dismiss the dialog.public AlertDialog.Builder setSingleChoiceItems(int itemsId, int checkedItem, DialogInterface.OnClickListener listener)
itemsId
- the resource id of an array i.e. R.array.foocheckedItem
- specifies which item is checked. If -1 no items are checked.listener
- notified when an item on the list is clicked. The dialog will not be
dismissed when an item is clicked. It will only be dismissed if clicked on a
button, if no buttons are supplied it's up to the user to dismiss the dialog.public AlertDialog.Builder setSingleChoiceItems(Cursor cursor, int checkedItem, String labelColumn, DialogInterface.OnClickListener listener)
cursor
- the cursor to retrieve the items from.checkedItem
- specifies which item is checked. If -1 no items are checked.labelColumn
- The column name on the cursor containing the string to display in the
label.listener
- notified when an item on the list is clicked. The dialog will not be
dismissed when an item is clicked. It will only be dismissed if clicked on a
button, if no buttons are supplied it's up to the user to dismiss the dialog.public AlertDialog.Builder setSingleChoiceItems(CharSequence[] items, int checkedItem, DialogInterface.OnClickListener listener)
items
- the items to be displayed.checkedItem
- specifies which item is checked. If -1 no items are checked.listener
- notified when an item on the list is clicked. The dialog will not be
dismissed when an item is clicked. It will only be dismissed if clicked on a
button, if no buttons are supplied it's up to the user to dismiss the dialog.public AlertDialog.Builder setSingleChoiceItems(ListAdapter adapter, int checkedItem, DialogInterface.OnClickListener listener)
adapter
- The ListAdapter
to supply the list of itemscheckedItem
- specifies which item is checked. If -1 no items are checked.listener
- notified when an item on the list is clicked. The dialog will not be
dismissed when an item is clicked. It will only be dismissed if clicked on a
button, if no buttons are supplied it's up to the user to dismiss the dialog.public AlertDialog.Builder setOnItemSelectedListener(AdapterView.OnItemSelectedListener listener)
listener
- The listener to be invoked.AdapterView.setOnItemSelectedListener(android.widget.AdapterView.OnItemSelectedListener)
public AlertDialog.Builder setView(View view)
ListView
the light background will be used.view
- The view to use as the contents of the Dialog.public AlertDialog.Builder setView(View view, int viewSpacingLeft, int viewSpacingTop, int viewSpacingRight, int viewSpacingBottom)
ListView
the light background will be used.view
- The view to use as the contents of the Dialog.viewSpacingLeft
- Spacing between the left edge of the view and
the dialog frameviewSpacingTop
- Spacing between the top edge of the view and
the dialog frameviewSpacingRight
- Spacing between the right edge of the view
and the dialog frameviewSpacingBottom
- Spacing between the bottom edge of the view
and the dialog framepublic AlertDialog.Builder setInverseBackgroundForced(boolean useInverseBackground)
useInverseBackground
- Whether to use the inverse backgroundpublic AlertDialog.Builder setRecycleOnMeasureEnabled(boolean enabled)
public AlertDialog create()
AlertDialog
with the arguments supplied to this builder. It does not
Dialog.show()
the dialog. This allows the user to do any extra processing
before displaying the dialog. Use show()
if you don't have any other processing
to do and want this to be created and displayed.public AlertDialog show()
AlertDialog
with the arguments supplied to this builder and
Dialog.show()
's the dialog.