# AlertDialog.Builder

Artifact: [androidx.appcompat:appcompat](https://developer.android.com/jetpack/androidx/releases/appcompat) [View Source](https://cs.android.com/search?q=file:androidx/appcompat/app/AlertDialog.java+class:androidx.appcompat.app.AlertDialog.Builder) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

*** ** * ** ***


```
public class AlertDialog.Builder
```

<br />

*** ** * ** ***

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#Builder(android.content.Context)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html context)` Creates a builder for an alert dialog that uses the default alert dialog theme. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#Builder(android.content.Context,int)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html context, @https://developer.android.com/reference/androidx/annotation/StyleRes int themeResId)` Creates a builder for an alert dialog that uses an explicit theme resource. |

| ### Public methods |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/appcompat/app/AlertDialog` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#create()()` Creates an `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog` with the arguments supplied to this builder. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#getContext()()` Returns a `https://developer.android.com/reference/android/content/Context.html` with the appropriate theme for dialogs created by this Builder. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setAdapter(android.widget.ListAdapter,android.content.DialogInterface.OnClickListener)( https://developer.android.com/reference/android/widget/ListAdapter.html adapter, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener )` Set a list of items, which are supplied by the given `https://developer.android.com/reference/android/widget/ListAdapter.html`, to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setCancelable(boolean)(boolean cancelable)` Sets whether the dialog is cancelable or not. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setCursor(android.database.Cursor,android.content.DialogInterface.OnClickListener,java.lang.String)( https://developer.android.com/reference/android/database/Cursor.html cursor, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener, https://developer.android.com/reference/java/lang/String.html labelColumn )` Set a list of items, which are supplied by the given `https://developer.android.com/reference/android/database/Cursor.html`, to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setCustomTitle(android.view.View)(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/view/View.html customTitleView)` Set the title using the custom view `customTitleView`. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setIcon(android.graphics.drawable.Drawable)(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/graphics/drawable/Drawable.html icon)` Set the `https://developer.android.com/reference/android/graphics/drawable/Drawable.html` to be used in the title. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setIcon(int)(@https://developer.android.com/reference/androidx/annotation/DrawableRes int iconId)` Set the resource id of the `https://developer.android.com/reference/android/graphics/drawable/Drawable.html` to be used in the title. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setIconAttribute(int)(@https://developer.android.com/reference/androidx/annotation/AttrRes int attrId)` Set an icon as supplied by a theme attribute. e.g. `https://developer.android.com/reference/android/R.attr.html#alertDialogIcon`. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `[setInverseBackgroundForced](https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setInverseBackgroundForced(boolean))(boolean useInverseBackground)` **This method is deprecated.** This flag is only used for pre-Material themes. <br /> |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setItems(java.lang.CharSequence[],android.content.DialogInterface.OnClickListener)( CharSequence[] items, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setItems(int,android.content.DialogInterface.OnClickListener)(@https://developer.android.com/reference/androidx/annotation/ArrayRes int itemsId, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setMessage(java.lang.CharSequence)(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/CharSequence.html message)` Set the message to display. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setMessage(int)(@https://developer.android.com/reference/androidx/annotation/StringRes int messageId)` Set the message to display using the given resource id. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setMultiChoiceItems(java.lang.CharSequence[],boolean[],android.content.DialogInterface.OnMultiChoiceClickListener)( CharSequence[] items, boolean[] checkedItems, https://developer.android.com/reference/android/content/DialogInterface.OnMultiChoiceClickListener.html 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. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setMultiChoiceItems(int,boolean[],android.content.DialogInterface.OnMultiChoiceClickListener)( @https://developer.android.com/reference/androidx/annotation/ArrayRes int itemsId, boolean[] checkedItems, https://developer.android.com/reference/android/content/DialogInterface.OnMultiChoiceClickListener.html 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. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setMultiChoiceItems(android.database.Cursor,java.lang.String,java.lang.String,android.content.DialogInterface.OnMultiChoiceClickListener)( https://developer.android.com/reference/android/database/Cursor.html cursor, https://developer.android.com/reference/java/lang/String.html isCheckedColumn, https://developer.android.com/reference/java/lang/String.html labelColumn, https://developer.android.com/reference/android/content/DialogInterface.OnMultiChoiceClickListener.html 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. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setNegativeButton(java.lang.CharSequence,android.content.DialogInterface.OnClickListener)( https://developer.android.com/reference/java/lang/CharSequence.html text, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener )` Set a listener to be invoked when the negative button of the dialog is pressed. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setNegativeButton(int,android.content.DialogInterface.OnClickListener)( @https://developer.android.com/reference/androidx/annotation/StringRes int textId, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener )` Set a listener to be invoked when the negative button of the dialog is pressed. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setNegativeButtonIcon(android.graphics.drawable.Drawable)(https://developer.android.com/reference/android/graphics/drawable/Drawable.html icon)` Set an icon to be displayed for the negative button. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setNeutralButton(java.lang.CharSequence,android.content.DialogInterface.OnClickListener)( https://developer.android.com/reference/java/lang/CharSequence.html text, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener )` Set a listener to be invoked when the neutral button of the dialog is pressed. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setNeutralButton(int,android.content.DialogInterface.OnClickListener)( @https://developer.android.com/reference/androidx/annotation/StringRes int textId, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener )` Set a listener to be invoked when the neutral button of the dialog is pressed. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setNeutralButtonIcon(android.graphics.drawable.Drawable)(https://developer.android.com/reference/android/graphics/drawable/Drawable.html icon)` Set an icon to be displayed for the neutral button. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setOnCancelListener(android.content.DialogInterface.OnCancelListener)(https://developer.android.com/reference/android/content/DialogInterface.OnCancelListener.html onCancelListener)` Sets the callback that will be called if the dialog is canceled. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setOnDismissListener(android.content.DialogInterface.OnDismissListener)( https://developer.android.com/reference/android/content/DialogInterface.OnDismissListener.html onDismissListener )` Sets the callback that will be called when the dialog is dismissed for any reason. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setOnItemSelectedListener(android.widget.AdapterView.OnItemSelectedListener)(https://developer.android.com/reference/android/widget/AdapterView.OnItemSelectedListener.html listener)` Sets a listener to be invoked when an item in the list is selected. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setOnKeyListener(android.content.DialogInterface.OnKeyListener)(https://developer.android.com/reference/android/content/DialogInterface.OnKeyListener.html onKeyListener)` Sets the callback that will be called if a key is dispatched to the dialog. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setPositiveButton(java.lang.CharSequence,android.content.DialogInterface.OnClickListener)( https://developer.android.com/reference/java/lang/CharSequence.html text, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener )` Set a listener to be invoked when the positive button of the dialog is pressed. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setPositiveButton(int,android.content.DialogInterface.OnClickListener)( @https://developer.android.com/reference/androidx/annotation/StringRes int textId, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener )` Set a listener to be invoked when the positive button of the dialog is pressed. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setPositiveButtonIcon(android.graphics.drawable.Drawable)(https://developer.android.com/reference/android/graphics/drawable/Drawable.html icon)` Set an icon to be displayed for the positive button. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setSingleChoiceItems(android.widget.ListAdapter,int,android.content.DialogInterface.OnClickListener)( https://developer.android.com/reference/android/widget/ListAdapter.html adapter, int checkedItem, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setSingleChoiceItems(java.lang.CharSequence[],int,android.content.DialogInterface.OnClickListener)( CharSequence[] items, int checkedItem, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setSingleChoiceItems(int,int,android.content.DialogInterface.OnClickListener)( @https://developer.android.com/reference/androidx/annotation/ArrayRes int itemsId, int checkedItem, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setSingleChoiceItems(android.database.Cursor,int,java.lang.String,android.content.DialogInterface.OnClickListener)( https://developer.android.com/reference/android/database/Cursor.html cursor, int checkedItem, https://developer.android.com/reference/java/lang/String.html labelColumn, https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setTitle(java.lang.CharSequence)(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/CharSequence.html title)` Set the title displayed in the `https://developer.android.com/reference/android/app/Dialog.html`. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setTitle(int)(@https://developer.android.com/reference/androidx/annotation/StringRes int titleId)` Set the title using the given resource id. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setView(int)(int layoutResId)` Inflates a custom view resource inside the dialog, below the message and above the buttons. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setView(android.view.View)(https://developer.android.com/reference/android/view/View.html view)` Sets a custom view to be the contents of the alert dialog. |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog` | `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#show()()` Creates an `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog` with the arguments supplied to this builder and immediately displays the dialog. |

## Public constructors

### Builder

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public Builder(@NonNull Context context)
```

Creates a builder for an alert dialog that uses the default alert dialog theme.

The default alert dialog theme is defined by `https://developer.android.com/reference/android/R.attr.html#alertDialogTheme` within the parent `context`'s theme.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html context` | the parent context |

### Builder

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public Builder(@NonNull Context context, @StyleRes int themeResId)
```

Creates a builder for an alert dialog that uses an explicit theme resource.

The specified theme resource (`themeResId`) is applied on top of the parent `context`'s theme. It may be specified as a style resource containing a fully-populated theme, such as `https://developer.android.com/reference/androidx/appcompat/R.style#Theme_AppCompat_Dialog()`, to replace all attributes in the parent `context`'s theme including primary and accent colors.

To preserve attributes such as primary and accent colors, the `themeResId` may instead be specified as an overlay theme such as `https://developer.android.com/reference/androidx/appcompat/R.style#ThemeOverlay_AppCompat_Dialog()`. This will override only the window attributes necessary to style the alert window as a dialog.

Alternatively, the `themeResId` may be specified as `0` to use the parent `context`'s resolved value for `https://developer.android.com/reference/android/R.attr.html#alertDialogTheme`.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html context` | the parent context |
| `@https://developer.android.com/reference/androidx/annotation/StyleRes int themeResId` | the resource ID of the theme against which to inflate this dialog, or `0` to use the parent `context`'s default alert dialog theme |

## Public methods

### create

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public @NonNull AlertDialog create()
```

Creates an `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog` with the arguments supplied to this builder.

Calling this method does not display the dialog. If no additional processing is needed, `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#show()` may be called instead to both create and display the dialog.

### getContext

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public @NonNull Context getContext()
```

Returns a `https://developer.android.com/reference/android/content/Context.html` 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.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html` | A Context for built Dialogs. |

### setAdapter

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setAdapter(
    ListAdapter adapter,
    DialogInterface.OnClickListener listener
)
```

Set a list of items, which are supplied by the given `https://developer.android.com/reference/android/widget/ListAdapter.html`, to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/widget/ListAdapter.html adapter` | The `https://developer.android.com/reference/android/widget/ListAdapter.html` to supply the list of items |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener` | The listener that will be called when an item is clicked. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setCancelable

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setCancelable(boolean cancelable)
```

Sets whether the dialog is cancelable or not. Default is true.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setCursor

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setCursor(
    Cursor cursor,
    DialogInterface.OnClickListener listener,
    String labelColumn
)
```

Set a list of items, which are supplied by the given `https://developer.android.com/reference/android/database/Cursor.html`, to be displayed in the dialog as the content, you will be notified of the selected item via the supplied listener.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/database/Cursor.html cursor` | The `https://developer.android.com/reference/android/database/Cursor.html` to supply the list of items |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener` | The listener that will be called when an item is clicked. |
| `https://developer.android.com/reference/java/lang/String.html labelColumn` | The column name on the cursor containing the string to display in the label. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setCustomTitle

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setCustomTitle(@Nullable View customTitleView)
```

Set the title using the custom view `customTitleView`.

The methods `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setTitle(int)` and `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#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.

**Note:** To ensure consistent styling, the custom view should be inflated or constructed using the alert dialog's themed context obtained via `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#getContext()`.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/view/View.html customTitleView` | the custom view to use as the title |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | this Builder object to allow for chaining of calls to set methods |

### setIcon

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setIcon(@Nullable Drawable icon)
```

Set the `https://developer.android.com/reference/android/graphics/drawable/Drawable.html` to be used in the title.

**Note:** To ensure consistent styling, the drawable should be inflated or constructed using the alert dialog's themed context obtained via `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#getContext()`.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | this Builder object to allow for chaining of calls to set methods |

### setIcon

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setIcon(@DrawableRes int iconId)
```

Set the resource id of the `https://developer.android.com/reference/android/graphics/drawable/Drawable.html` to be used in the title.

Takes precedence over values set using `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setIcon(android.graphics.drawable.Drawable)`.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setIconAttribute

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setIconAttribute(@AttrRes int attrId)
```

Set an icon as supplied by a theme attribute. e.g. `https://developer.android.com/reference/android/R.attr.html#alertDialogIcon`.

Takes precedence over values set using `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setIcon(int)` or `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setIcon(android.graphics.drawable.Drawable)`.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/AttrRes int attrId` | ID of a theme attribute that points to a drawable resource. |

### setInverseBackgroundForced

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder [setInverseBackgroundForced](https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setInverseBackgroundForced(boolean))(boolean useInverseBackground)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This flag is only used for pre-Material themes. Instead, specify the window background using on the alert dialog theme.

Sets the Dialog to use the inverse background, regardless of what the contents is.

| Parameters |
|---|---|
| `boolean useInverseBackground` | Whether to use the inverse background |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setItems

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public 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.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setItems

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setItems(@ArrayRes 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. This should be an array type i.e. R.array.foo

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setMessage

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setMessage(@Nullable CharSequence message)
```

Set the message to display.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setMessage

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setMessage(@StringRes int messageId)
```

Set the message to display using the given resource id.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setMultiChoiceItems

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public 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. The list will have a check mark displayed to the right of the text for each checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

| Parameters |
|---|---|
| `CharSequence[] items` | the text of the items to be displayed in the list. |
| `boolean[] 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. |
| `https://developer.android.com/reference/android/content/DialogInterface.OnMultiChoiceClickListener.html 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. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setMultiChoiceItems

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setMultiChoiceItems(
    @ArrayRes 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. This should be an array type, e.g. R.array.foo. The list will have a check mark displayed to the right of the text for each checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/ArrayRes int itemsId` | the resource id of an array i.e. R.array.foo |
| `boolean[] 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. |
| `https://developer.android.com/reference/android/content/DialogInterface.OnMultiChoiceClickListener.html 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. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setMultiChoiceItems

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public 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. The list will have a check mark displayed to the right of the text for each checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/database/Cursor.html cursor` | the cursor used to provide the items. |
| `https://developer.android.com/reference/java/lang/String.html 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. |
| `https://developer.android.com/reference/java/lang/String.html labelColumn` | The column name on the cursor containing the string to display in the label. |
| `https://developer.android.com/reference/android/content/DialogInterface.OnMultiChoiceClickListener.html 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. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setNegativeButton

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setNegativeButton(
    CharSequence text,
    DialogInterface.OnClickListener listener
)
```

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

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/CharSequence.html text` | The text to display in the negative button |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener` | The `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html` to use. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setNegativeButton

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setNegativeButton(
    @StringRes int textId,
    DialogInterface.OnClickListener listener
)
```

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

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/StringRes int textId` | The resource id of the text to display in the negative button |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener` | The `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html` to use. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setNegativeButtonIcon

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setNegativeButtonIcon(Drawable icon)
```

Set an icon to be displayed for the negative button.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/graphics/drawable/Drawable.html icon` | The icon to be displayed |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setNeutralButton

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setNeutralButton(
    CharSequence text,
    DialogInterface.OnClickListener listener
)
```

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

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/CharSequence.html text` | The text to display in the neutral button |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener` | The `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html` to use. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setNeutralButton

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setNeutralButton(
    @StringRes int textId,
    DialogInterface.OnClickListener listener
)
```

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

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/StringRes int textId` | The resource id of the text to display in the neutral button |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener` | The `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html` to use. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setNeutralButtonIcon

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setNeutralButtonIcon(Drawable icon)
```

Set an icon to be displayed for the neutral button.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/graphics/drawable/Drawable.html icon` | The icon to be displayed |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setOnCancelListener

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setOnCancelListener(DialogInterface.OnCancelListener onCancelListener)
```

Sets the callback that will be called if the dialog is canceled.

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 `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setOnDismissListener(android.content.DialogInterface.OnDismissListener)`.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setCancelable(boolean)` |   |
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#setOnDismissListener(android.content.DialogInterface.OnDismissListener)` |   |

### setOnDismissListener

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setOnDismissListener(
    DialogInterface.OnDismissListener onDismissListener
)
```

Sets the callback that will be called when the dialog is dismissed for any reason.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setOnItemSelectedListener

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setOnItemSelectedListener(AdapterView.OnItemSelectedListener listener)
```

Sets a listener to be invoked when an item in the list is selected.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/widget/AdapterView.OnItemSelectedListener.html listener` | the listener to be invoked |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | this Builder object to allow for chaining of calls to set methods |

| See also |
|---|---|
| `https://developer.android.com/reference/android/widget/AdapterView.html#setOnItemSelectedListener(android.widget.AdapterView.OnItemSelectedListener)` |   |

### setOnKeyListener

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setOnKeyListener(DialogInterface.OnKeyListener onKeyListener)
```

Sets the callback that will be called if a key is dispatched to the dialog.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setPositiveButton

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setPositiveButton(
    CharSequence text,
    DialogInterface.OnClickListener listener
)
```

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

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/CharSequence.html text` | The text to display in the positive button |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener` | The `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html` to use. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setPositiveButton

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setPositiveButton(
    @StringRes int textId,
    DialogInterface.OnClickListener listener
)
```

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

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/StringRes int textId` | The resource id of the text to display in the positive button |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html listener` | The `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html` to use. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setPositiveButtonIcon

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setPositiveButtonIcon(Drawable icon)
```

Set an icon to be displayed for the positive button.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/graphics/drawable/Drawable.html icon` | The icon to be displayed |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setSingleChoiceItems

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public 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. The list will have a check mark displayed to the right of the text for the checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/widget/ListAdapter.html adapter` | The `https://developer.android.com/reference/android/widget/ListAdapter.html` to supply the list of items |
| `int checkedItem` | specifies which item is checked. If -1 no items are checked. |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setSingleChoiceItems

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public 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. The list will have a check mark displayed to the right of the text for the checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

| Parameters |
|---|---|
| `CharSequence[] items` | the items to be displayed. |
| `int checkedItem` | specifies which item is checked. If -1 no items are checked. |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setSingleChoiceItems

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setSingleChoiceItems(
    @ArrayRes 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. This should be an array type i.e. R.array.foo The list will have a check mark displayed to the right of the text for the checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/ArrayRes int itemsId` | the resource id of an array i.e. R.array.foo |
| `int checkedItem` | specifies which item is checked. If -1 no items are checked. |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setSingleChoiceItems

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public 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. The list will have a check mark displayed to the right of the text for the checked item. Clicking on an item in the list will not dismiss the dialog. Clicking on a button will dismiss the dialog.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/database/Cursor.html cursor` | the cursor to retrieve the items from. |
| `int checkedItem` | specifies which item is checked. If -1 no items are checked. |
| `https://developer.android.com/reference/java/lang/String.html labelColumn` | The column name on the cursor containing the string to display in the label. |
| `https://developer.android.com/reference/android/content/DialogInterface.OnClickListener.html 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. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setTitle

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setTitle(@Nullable CharSequence title)
```

Set the title displayed in the `https://developer.android.com/reference/android/app/Dialog.html`.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setTitle

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setTitle(@StringRes int titleId)
```

Set the title using the given resource id.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | This Builder object to allow for chaining of calls to set methods |

### setView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setView(int layoutResId)
```

Inflates a custom view resource inside the dialog, below the message and above the buttons. If none of the other parts of the dialog are made visible, the custom view occupies the entire view. Because the view is inflated inside the parent dialog's view, take care not to define conflicting resource IDs.

| Parameters |
|---|---|
| `int layoutResId` | Resource ID to be inflated. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | this Builder object to allow for chaining of calls to set methods |

### setView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog.Builder setView(View view)
```

Sets a custom view to be the contents of the alert dialog.

When using a pre-Holo theme, if the supplied view is an instance of a `https://developer.android.com/reference/android/widget/ListView.html` then the light background will be used.

**Note:** To ensure consistent styling, the custom view should be inflated or constructed using the alert dialog's themed context obtained via `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder#getContext()`.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/view/View.html view` | the view to use as the contents of the alert dialog |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog.Builder` | this Builder object to allow for chaining of calls to set methods |

### show

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/appcompat#1.1.0)

```
public AlertDialog show()
```

Creates an `https://developer.android.com/reference/androidx/appcompat/app/AlertDialog` with the arguments supplied to this builder and immediately displays the dialog.

Calling this method is functionally identical to:

```
    AlertDialog dialog = builder.create();
    dialog.show();
```