MaterialDialog (library 3.0.2 API)

java.lang.Object
- android.app.Dialog
- - de.mrapp.android.dialog.MaterialDialog

All Implemented Interfaces:

android.content.DialogInterface, android.view.KeyEvent.Callback, android.view.View.OnCreateContextMenuListener, android.view.Window.Callback
```
public class MaterialDialog
extends android.app.Dialog
implements android.content.DialogInterface
```
A dialog, which is designed according to Android 5's Material Design guidelines even on pre-Lollipop devices. Such a dialog consists of a title, a message and up to three buttons. Furthermore, the dialog can be used to show list items. It is possible to customize the color of the dialog's title and button texts and the title as well as the dialog's content can be replaced with a custom view. For creating or showing such dialogs, the methods Dialog.create() or Dialog.show() of the builder MaterialDialog.Builder can be used.

Since:

3.0.0

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`MaterialDialog.Builder` A builder, which allows to create and show dialogs, which are designed according to Android 5's Material Design guidelines even on pre-Lollipop devices.
`static interface`	`MaterialDialog.Validator` Defines the interface, a class, which should be able to validate the content of a dialog, must implement.

Nested classes/interfaces inherited from interface android.content.DialogInterface
android.content.DialogInterface.OnCancelListener, android.content.DialogInterface.OnClickListener, android.content.DialogInterface.OnDismissListener, android.content.DialogInterface.OnKeyListener, android.content.DialogInterface.OnMultiChoiceClickListener, android.content.DialogInterface.OnShowListener

Field Summary
- Fields inherited from interface android.content.DialogInterface
  BUTTON_NEGATIVE, BUTTON_NEUTRAL, BUTTON_POSITIVE, BUTTON1, BUTTON2, BUTTON3

Constructor Summary

Constructors
Modifier	Constructor and Description
	`MaterialDialog(android.content.Context context)` Creates a dialog, which is designed according to Android 5's Material Design guidelines even on pre-Lollipop devices.
`protected`	`MaterialDialog(android.content.Context context, int themeResourceId)` Creates a dialog, which is designed according to Android 5's Material Design guidelines even on pre-Lollipop devices.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAllValidators(java.util.Collection<MaterialDialog.Validator> validators)` Adds all validators, which are contained by a specific collection and should be executed when the positive button of the dialog is clicked.
`void`	`addValidator(MaterialDialog.Validator validator)` Adds a new validator, which should be executed when the positive button of the dialog is clicked.
`android.graphics.drawable.Drawable`	`getBackground()` Returns the background of the dialog.
`android.widget.Button`	`getButton(int whichButton)` Returns one of the buttons, which is shown by the dialog.
`int`	`getButtonTextColor()` Returns the color of the button texts of the dialog.
`android.graphics.drawable.Drawable`	`getIcon()` Returns the icon of the dialog.
`int`	`getItemColor()` Returns the color of the list items of the dialog.
`int`	`getItemControlColor()` Returns the control color of the list items of the dialog.
`android.widget.ListAdapter`	`getListAdapter()` Returns the adapter of the list view, which is contained by the dialog.
`android.widget.ListView`	`getListView()` Returns the list view, which is contained by the dialog.
`java.lang.CharSequence`	`getMessage()` Returns the message of the dialog.
`int`	`getMessageColor()` Returns the color of the message of the dialog.
`java.lang.CharSequence`	`getTitle()` Returns the title of the dialog.
`int`	`getTitleColor()` Returns the color of the title of the dialog.
`java.util.Set<MaterialDialog.Validator>`	`getValidators()` Returns a set, which contains the validators, which are executed when the positive button of the dialog is clicked.
`void`	`onCreate(android.os.Bundle savedInstanceState)`
`void`	`removeAllValidators(java.util.Collection<MaterialDialog.Validator> validators)` Removes all validators, which are contained by a specific collection and should not be executed, when the positive button of the dialog is clicked, anymore.
`void`	`removeValidator(MaterialDialog.Validator validator)` Removes a specific validator, which should not be executed, when the positive button of the dialog is clicked, anymore.
`void`	`setBackground(android.graphics.drawable.Drawable background)` Sets the background of the dialog.
`void`	`setBackground(int resourceId)` Sets the background of the dialog.
`void`	`setBackgroundColor(int color)` Sets the background color of the dialog.
`void`	`setButtonTextColor(int color)` Sets the color of the button texts of the dialog.
`void`	`setCustomTitle(android.view.View view)` Sets the custom view, which should be used to show the title of the dialog.
`void`	`setIcon(android.graphics.drawable.Drawable icon)` Sets the icon of the dialog.
`void`	`setIcon(int resourceId)` Sets the icon of the dialog.
`void`	`setIconAttribute(int attributeId)` Set the icon of the dialog.
`void`	`setItemColor(int color)` Sets the color of the list items of the dialog.
`void`	`setItemControlColor(int color)` Sets the control color of the list items of the dialog, which is created by the builder.
`void`	`setMessage(java.lang.CharSequence message)` Sets the message of the dialog.
`void`	`setMessage(int resourceId)` Sets the message of the dialog.
`void`	`setMessageColor(int color)` Sets the color of the message of the dialog.
`void`	`setNegativeButton(java.lang.CharSequence text, android.content.DialogInterface.OnClickListener listener)` Sets the text of the negative button of the dialog.
`void`	`setNegativeButton(int resourceId, android.content.DialogInterface.OnClickListener listener)` Sets the text of the negative button of the dialog.
`void`	`setNeutralButton(java.lang.CharSequence text, android.content.DialogInterface.OnClickListener listener)` Sets the text of the neutral button of the dialog.
`void`	`setNeutralButton(int resourceId, android.content.DialogInterface.OnClickListener listener)` Sets the text of the neutral button of the dialog.
`void`	`setPositiveButton(java.lang.CharSequence text, android.content.DialogInterface.OnClickListener listener)` Sets the text of the positive button of the dialog.
`void`	`setPositiveButton(int resourceId, android.content.DialogInterface.OnClickListener listener)` Sets the text of the positive button of the dialog.
`void`	`setTitle(java.lang.CharSequence title)`
`void`	`setTitleColor(int color)` Sets the color of the title of the dialog.
`void`	`setView(int resourceId)` Sets the custom view, which should be shown by the dialog.
`void`	`setView(android.view.View view)` Sets the custom view, which should be shown by the dialog.

Methods inherited from class android.app.Dialog
addContentView, cancel, closeOptionsMenu, create, dismiss, dispatchGenericMotionEvent, dispatchKeyEvent, dispatchKeyShortcutEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, findViewById, getActionBar, getContext, getCurrentFocus, getLayoutInflater, getOwnerActivity, getSearchEvent, getVolumeControlStream, getWindow, hide, invalidateOptionsMenu, isShowing, onActionModeFinished, onActionModeStarted, onAttachedToWindow, onBackPressed, onContentChanged, onContextItemSelected, onContextMenuClosed, onCreateContextMenu, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onDetachedFromWindow, onGenericMotionEvent, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyShortcut, onKeyUp, onMenuItemSelected, onMenuOpened, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPrepareOptionsMenu, onPreparePanel, onRestoreInstanceState, onSaveInstanceState, onSearchRequested, onSearchRequested, onStart, onStop, onTouchEvent, onTrackballEvent, onWindowAttributesChanged, onWindowFocusChanged, onWindowStartingActionMode, onWindowStartingActionMode, openContextMenu, openOptionsMenu, registerForContextMenu, requestWindowFeature, setCancelable, setCanceledOnTouchOutside, setCancelMessage, setContentView, setContentView, setContentView, setDismissMessage, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setOnCancelListener, setOnDismissListener, setOnKeyListener, setOnShowListener, setOwnerActivity, setTitle, setVolumeControlStream, show, takeKeyEvents, unregisterForContextMenu

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface android.content.DialogInterface
cancel, dismiss

- Constructor Detail
  - MaterialDialog
```
public MaterialDialog(android.content.Context context)
```
    Creates a dialog, which is designed according to Android 5's Material Design guidelines even on pre-Lollipop devices.
    
    Parameters:
    
    context - The context, which should be used by the dialog, as an instance of the class Context. The context may not be null
  - MaterialDialog
```
protected MaterialDialog(android.content.Context context,
                         int themeResourceId)
```
    Creates a dialog, which is designed according to Android 5's Material Design guidelines even on pre-Lollipop devices.
    
    Parameters:
    
    context - The context, which should be used by the dialog, as an instance of the class Context. The context may not be null
    
    themeResourceId - The resource id of the theme, which should be used by the dialog, as an Integer value. The resource id must correspond to a valid theme
- Method Detail
  - getButton
```
public final android.widget.Button getButton(int whichButton)
```
    Returns one of the buttons, which is shown by the dialog.
    
    Parameters:
    
    whichButton - The identifier of the button, which should be returned, as an Integer value. The identifier must either be DialogInterface.BUTTON_POSITIVE, DialogInterface.BUTTON_NEGATIVE or DialogInterface.BUTTON_NEUTRAL
    
    Returns:
    
    The button, which corresponds to the given identifier, as an instance of the class Button or null, if the button is not shown or if the dialog has not been shown yet
  - setPositiveButton
```
public final void setPositiveButton(java.lang.CharSequence text,
                                    android.content.DialogInterface.OnClickListener listener)
```
    Sets the text of the positive button of the dialog.
    
    Parameters:
    
    text - The text, which should be set, as an instance of the type CharSequence or null, if no positive button should be shown
    
    listener - The listener, which should be notified, when the positive button is clicked, as an instance of the type OnClickListener or null, if no listener should be notified
  - setPositiveButton
```
public final void setPositiveButton(int resourceId,
                                    android.content.DialogInterface.OnClickListener listener)
```
    Sets the text of the positive button of the dialog.
    
    Parameters:
    
    resourceId - The resource id of the text, which should be set, as an Integer value. The resource id must correspond to a valid string resource
    
    listener - The listener, which should be notified, when the positive button is clicked, as an instance of the type OnClickListener or null, if no listener should be notified
  - setNegativeButton
```
public final void setNegativeButton(java.lang.CharSequence text,
                                    android.content.DialogInterface.OnClickListener listener)
```
    Sets the text of the negative button of the dialog.
    
    Parameters:
    
    text - The text, which should be set, as an instance of the type CharSequence or null, if no negative button should be shown
    
    listener - The listener, which should be notified, when the negative button is clicked, as an instance of the type OnClickListener or null, if no listener should be notified
  - setNegativeButton
```
public final void setNegativeButton(int resourceId,
                                    android.content.DialogInterface.OnClickListener listener)
```
    Sets the text of the negative button of the dialog.
    
    Parameters:
    
    resourceId - The resource id of the text, which should be set, as an Integer value. The resource id must correspond to a valid string resource
    
    listener - The listener, which should be notified, when the negative button is clicked, as an instance of the type OnClickListener or null, if no listener should be notified
  - setNeutralButton
```
public final void setNeutralButton(java.lang.CharSequence text,
                                   android.content.DialogInterface.OnClickListener listener)
```
    Sets the text of the neutral button of the dialog.
    
    Parameters:
    
    text - The text, which should be set, as an instance of the type CharSequence or null, if no neutral button should be shown
    
    listener - The listener, which should be notified, when the neutral button is clicked, as an instance of the type OnClickListener or null, if no listener should be notified
  - setNeutralButton
```
public final void setNeutralButton(int resourceId,
                                   android.content.DialogInterface.OnClickListener listener)
```
    Sets the text of the neutral button of the dialog.
    
    Parameters:
    
    resourceId - The resource id of the text, which should be set, as an Integer value. The resource id must correspond to a valid string resource
    
    listener - The listener, which should be notified, when the neutral button is clicked, as an instance of the type OnClickListener or null, if no listener should be notified
  - getValidators
```
public final java.util.Set<MaterialDialog.Validator> getValidators()
```
    Returns a set, which contains the validators, which are executed when the positive button of the dialog is clicked.
    
    Returns:
    
    A set, which contains the validators, which are executed when the positive button of the dialog is clicked, as an instance of the type Set or an empty set, if no validators are executed
  - addValidator
```
public final void addValidator(MaterialDialog.Validator validator)
```
    Adds a new validator, which should be executed when the positive button of the dialog is clicked.
    
    Parameters:
    
    validator - The validator, which should be added, as an instance of the type MaterialDialog.Validator. The validator may not be null
  - addAllValidators
```
public final void addAllValidators(java.util.Collection<MaterialDialog.Validator> validators)
```
    Adds all validators, which are contained by a specific collection and should be executed when the positive button of the dialog is clicked.
    
    Parameters:
    
    validators - A collection, which contains all validators, which should be added, as an instance of the type Collection or an empty collection, if no validators should be added
  - removeValidator
```
public final void removeValidator(MaterialDialog.Validator validator)
```
    Removes a specific validator, which should not be executed, when the positive button of the dialog is clicked, anymore.
    
    Parameters:
    
    validator - The validator, which should be removed, as an instance of the type MaterialDialog.Validator. The validator may not be null
  - removeAllValidators
```
public final void removeAllValidators(java.util.Collection<MaterialDialog.Validator> validators)
```
    Removes all validators, which are contained by a specific collection and should not be executed, when the positive button of the dialog is clicked, anymore.
    
    Parameters:
    
    validators - A collection, which contains the validators, which should be removed, as an instance of the type Collection or an empty collection, if no validators should be removed
  - getListView
```
public final android.widget.ListView getListView()
```
    Returns the list view, which is contained by the dialog.
    
    Returns:
    
    The list view, which is contained by the dialog, as an instance of the class ListView or null, if the dialog does not show any list items or has not been shown yet
  - getListAdapter
```
public final android.widget.ListAdapter getListAdapter()
```
    Returns the adapter of the list view, which is contained by the dialog.
    
    Returns:
    
    The adapter of the list view, which is contained by the dialog, as an instance of the type ListAdapter or null, if the dialog does not show any list items or has not been shown yet
  - getIcon
```
public final android.graphics.drawable.Drawable getIcon()
```
    Returns the icon of the dialog.
    
    Returns:
    
    The icon of the dialog, as an instance of the class Drawable or null, if no icon is shown or if the dialog has not been shown yet
  - setIcon
```
public final void setIcon(android.graphics.drawable.Drawable icon)
```
    Sets the icon of the dialog.
    
    Parameters:
    
    icon - The icon, which should be set, as an instance of the class Drawable or null, if no icon should be shown
  - setIcon
```
public final void setIcon(int resourceId)
```
    Sets the icon of the dialog.
    
    Parameters:
    
    resourceId - The resource id of the icon, which should be set, as an Integer value. The resource id must correspond to a valid drawable resource
  - setIconAttribute
```
public final void setIconAttribute(int attributeId)
```
    Set the icon of the dialog.
    
    Parameters:
    
    attributeId - The id of the theme attribute, which supplies the icon, which should be set, as an Integer value. The id must point to a valid drawable resource
  - getTitleColor
```
public final int getTitleColor()
```
    Returns the color of the title of the dialog.
    
    Returns:
    
    The color of the title of the dialog as an Integer value or -1, if no title is shown or if the dialog has not been shown yet
  - setTitleColor
```
public final void setTitleColor(int color)
```
    Sets the color of the title of the dialog.
    
    Parameters:
    
    color - The color, which should be set, as an Integer value
  - getMessageColor
```
public final int getMessageColor()
```
    Returns the color of the message of the dialog.
    
    Returns:
    
    The color of the message of the dialog as an Integer value or -1, if no message is shown or if the dialog has not been shown yet
  - setMessageColor
```
public final void setMessageColor(int color)
```
    Sets the color of the message of the dialog.
    
    Parameters:
    
    color - The color, which should be set, as an Integer value
  - getItemColor
```
public final int getItemColor()
```
    Returns the color of the list items of the dialog.
    
    Returns:
    
    The color of the list items of the dialog as an Integer value or -1, if no list items are shown or if the dialog has not been shown yet
  - setItemColor
```
public final void setItemColor(int color)
```
    Sets the color of the list items of the dialog.
    
    Parameters:
    
    color - The color, which should be set, as an Integer value
  - getItemControlColor
```
public final int getItemControlColor()
```
    Returns the control color of the list items of the dialog.
    
    Returns:
    
    The color of the list items of the dialog as an Integer value
  - setItemControlColor
```
public final void setItemControlColor(int color)
```
    Sets the control color of the list items of the dialog, which is created by the builder.
    
    Parameters:
    
    color - The control color, which should be set, as an Integer value or -1, if no list items are shown or if the dialog has not been shown yet
  - getBackground
```
public final android.graphics.drawable.Drawable getBackground()
```
    Returns the background of the dialog.
    
    Returns:
    
    The background of the dialog as an instance of the class Drawable or null, if no custom background is set or if the dialog has not been shown yet
  - setBackground
```
public final void setBackground(android.graphics.drawable.Drawable background)
```
    Sets the background of the dialog.
    
    Parameters:
    
    background - The background, which should be set, as an instance of the class Drawable or null, if no custom background should be set
  - setBackground
```
public final void setBackground(int resourceId)
```
    Sets the background of the dialog.
    
    Parameters:
    
    resourceId - The resource id of the background, which should be set, as an Integer value. The resource id must correspond to a valid drawable resource
  - setBackgroundColor
```
public final void setBackgroundColor(int color)
```
    Sets the background color of the dialog.
    
    Parameters:
    
    color - The background color, which should be set, as an Integer value or -1, if no custom background color should be set
  - getButtonTextColor
```
public final int getButtonTextColor()
```
    Returns the color of the button texts of the dialog.
    
    Returns:
    
    The color of the button texts of the dialog as an Integer value or -1, if no button is shown or if the dialog has not been shown yet
  - setButtonTextColor
```
public final void setButtonTextColor(int color)
```
    Sets the color of the button texts of the dialog.
    
    Parameters:
    
    color - The color, which should be set, as an Integer value
  - setCustomTitle
```
public final void setCustomTitle(android.view.View view)
```
    Sets the custom view, which should be used to show the title of the dialog.
    
    Parameters:
    
    view - The view, which should be set, as an instance of the class View or null, if no custom view should be used to show the title
  - setView
```
public final void setView(android.view.View view)
```
    Sets the custom view, which should be shown by the dialog.
    
    Parameters:
    
    view - The view, which should be set, as an instance of the class View or null, if no custom view should be shown
  - setView
```
public final void setView(int resourceId)
```
    Sets the custom view, which should be shown by the dialog.
    
    Parameters:
    
    resourceId - The resource id of the view, which should be set, as an Integer value. The resource id must correspond to a valid layout resource
  - getMessage
```
public final java.lang.CharSequence getMessage()
```
    Returns the message of the dialog.
    
    Returns:
    
    The message of the dialog as an instance of the type CharSequence or null, if no message is shown or if the dialog has not been shown yet
  - setMessage
```
public final void setMessage(java.lang.CharSequence message)
```
    Sets the message of the dialog.
    
    Parameters:
    
    message - The message, which should be set, as an instance of the type CharSequence or null, if no message should be shown
  - setMessage
```
public final void setMessage(int resourceId)
```
    Sets the message of the dialog.
    
    Parameters:
    
    resourceId - The resource id of the message, which should be set, as an Integer value. The resource id must correspond to a valid string resource
  - getTitle
```
public final java.lang.CharSequence getTitle()
```
    Returns the title of the dialog.
    
    Returns:
    
    The title of the dialog as an instance of the type CharSequence or null, if no title is shown or if the dialog has not been shown yet
  - setTitle
```
public final void setTitle(java.lang.CharSequence title)
```
    Overrides:
    
    setTitle in class android.app.Dialog
  - onCreate
```
public final void onCreate(android.os.Bundle savedInstanceState)
```
    Overrides:
    
    onCreate in class android.app.Dialog

Class MaterialDialog

Nested Class Summary

Nested classes/interfaces inherited from interface android.content.DialogInterface

Field Summary

Fields inherited from interface android.content.DialogInterface

Constructor Summary

Method Summary

Methods inherited from class android.app.Dialog

Methods inherited from class java.lang.Object

Methods inherited from interface android.content.DialogInterface

Constructor Detail

MaterialDialog

MaterialDialog

Method Detail

getButton

setPositiveButton

setPositiveButton

setNegativeButton

setNegativeButton

setNeutralButton

setNeutralButton

getValidators

addValidator

addAllValidators

removeValidator

removeAllValidators

getListView

getListAdapter

getIcon

setIcon

setIcon

setIconAttribute

getTitleColor

setTitleColor

getMessageColor

setMessageColor

getItemColor

setItemColor

getItemControlColor

setItemControlColor

getBackground

setBackground

setBackground

setBackgroundColor

getButtonTextColor

setButtonTextColor

setCustomTitle

setView

setView

getMessage

setMessage

setMessage

getTitle

setTitle

onCreate