com.afollestad.materialdialogs

Class MaterialDialog

java.lang.Object

android.app.Dialog

com.afollestad.materialdialogs.MaterialDialog

All Implemented Interfaces:

android.content.DialogInterface, android.content.DialogInterface.OnShowListener, android.view.KeyEvent.Callback, android.view.View.OnClickListener, android.view.View.OnCreateContextMenuListener, android.view.Window.Callback

public class MaterialDialog
extends android.app.Dialog
implements android.view.View.OnClickListener

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MaterialDialog.Builder The class used to construct a MaterialDialog.
static class	MaterialDialog.ButtonCallback Deprecated. Use the individual onPositive, onNegative, onNeutral, or onAny Builder methods instead.
static interface	MaterialDialog.InputCallback
static interface	MaterialDialog.ListCallback A callback used for regular list dialogs.
static interface	MaterialDialog.ListCallbackMultiChoice A callback used for multi choice (check box) list dialogs.
static interface	MaterialDialog.ListCallbackSingleChoice A callback used for multi choice (check box) list dialogs.
static interface	MaterialDialog.ListLongCallback A callback used for regular list dialogs.
static interface	MaterialDialog.SingleButtonCallback An alternate way to define a single callback.

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

Modifier and Type	Field and Description
protected MaterialDialog.Builder	builder
protected android.widget.TextView	content
protected android.widget.ImageView	icon
protected android.widget.TextView	title
protected MDRootLayout	view

Fields inherited from interface android.content.DialogInterface

BUTTON_NEGATIVE, BUTTON_NEUTRAL, BUTTON_POSITIVE, BUTTON1, BUTTON2, BUTTON3

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MaterialDialog(MaterialDialog.Builder builder)

Method Summary

Modifier and Type	Method and Description
void	clearSelectedIndices() Clears all selected checkboxes from multi choice list dialogs.
void	clearSelectedIndices(boolean sendCallback) Clears all selected checkboxes from multi choice list dialogs.
void	dismiss()
android.view.View	findViewById(int id)
MDButton	getActionButton(DialogAction which) Retrieves the view of an action button, allowing you to modify properties such as whether or not it's enabled.
MaterialDialog.Builder	getBuilder()
android.widget.TextView	getContentView() Retrieves the TextView that contains the dialog content.
int	getCurrentProgress()
android.view.View	getCustomView() Retrieves the custom view that was inflated or set to the MaterialDialog during building.
android.widget.ImageView	getIconView() Retrieves the ImageView that contains the dialog icon.
android.widget.EditText	getInputEditText()
java.util.ArrayList<java.lang.CharSequence>	getItems()
int	getMaxProgress()
android.widget.ProgressBar	getProgressBar()
RecyclerView	getRecyclerView()
int	getSelectedIndex() Convenience method for getting the currently selected index of a single choice list.
java.lang.Integer[]	getSelectedIndices() Convenience method for getting the currently selected indices of a multi choice list
java.lang.Object	getTag()
android.widget.TextView	getTitleView() Retrieves the TextView that contains the dialog title.
android.view.View	getView() Retrieves the view representing the dialog as a whole.
boolean	hasActionButtons() Gets whether or not the positive, neutral, or negative action button is visible.
void	incrementProgress(int by)
boolean	isCancelled()
boolean	isIndeterminateProgress()
boolean	isPromptCheckBoxChecked()
void	notifyItemChanged(int index)
void	notifyItemInserted(int index)
void	notifyItemsChanged()
int	numberOfActionButtons() Gets the number of visible action buttons.
void	onClick(android.view.View v)
boolean	onItemSelected(MaterialDialog dialog, android.view.View view, int position, java.lang.CharSequence text, boolean longPress)
void	onShow(android.content.DialogInterface dialog)
void	selectAllIndices() Selects all checkboxes in multi choice list dialogs.
void	selectAllIndices(boolean sendCallback) Selects all checkboxes in multi choice list dialogs.
void	setActionButton(DialogAction which, java.lang.CharSequence title) Updates an action button's title, causing invalidation to check if the action buttons should be stacked.
void	setActionButton(DialogAction which, int titleRes) Updates an action button's title, causing invalidation to check if the action buttons should be stacked.
void	setContent(java.lang.CharSequence newContent)
void	setContent(int newContentRes)
void	setContent(int newContentRes, java.lang.Object... formatArgs)
void	setContentView(int layoutResID) Deprecated.
void	setContentView(android.view.View view) Deprecated.
void	setContentView(android.view.View view, android.view.ViewGroup.LayoutParams params) Deprecated.
void	setIcon(android.graphics.drawable.Drawable d)
void	setIcon(int resId)
void	setIconAttribute(int attrId)
void	setItems(java.lang.CharSequence... items)
void	setMaxProgress(int max)
void	setOnShowListener(android.content.DialogInterface.OnShowListener listener)
void	setProgress(int progress)
void	setProgressNumberFormat(java.lang.String format) Change the format of the small text showing current and maximum units of progress.
void	setProgressPercentFormat(java.text.NumberFormat format) Change the format of the small text showing the percentage of progress.
void	setPromptCheckBoxChecked(boolean checked)
void	setSelectedIndex(int index) Convenience method for setting the currently selected index of a single choice list.
void	setSelectedIndices(java.lang.Integer[] indices) Convenience method for setting the currently selected indices of a multi choice list.
void	setTitle(java.lang.CharSequence newTitle)
void	setTitle(int newTitleRes)
void	setTitle(int newTitleRes, java.lang.Object... formatArgs)
void	setTypeface(android.widget.TextView target, android.graphics.Typeface t)
void	show()

Methods inherited from class android.app.Dialog

addContentView, cancel, closeOptionsMenu, create, dispatchGenericMotionEvent, dispatchKeyEvent, dispatchKeyShortcutEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, getActionBar, getContext, getCurrentFocus, getLayoutInflater, getOwnerActivity, getSearchEvent, getVolumeControlStream, getWindow, hide, invalidateOptionsMenu, isShowing, onActionModeFinished, onActionModeStarted, onAttachedToWindow, onBackPressed, onContentChanged, onContextItemSelected, onContextMenuClosed, onCreate, 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, setDismissMessage, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setOnCancelListener, setOnDismissListener, setOnKeyListener, setOwnerActivity, setVolumeControlStream, 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.view.Window.Callback

onPointerCaptureChanged, onProvideKeyboardShortcuts

Field Detail

builder

protected final MaterialDialog.Builder builder

icon

protected android.widget.ImageView icon

title

protected android.widget.TextView title

content

protected android.widget.TextView content

view

protected MDRootLayout view

Constructor Detail

MaterialDialog

protected MaterialDialog(MaterialDialog.Builder builder)

Method Detail

getBuilder

public final MaterialDialog.Builder getBuilder()

setTypeface

public final void setTypeface(android.widget.TextView target,
                              android.graphics.Typeface t)

getTag

public java.lang.Object getTag()

onItemSelected

public boolean onItemSelected(MaterialDialog dialog,
                              android.view.View view,
                              int position,
                              java.lang.CharSequence text,
                              boolean longPress)

getRecyclerView

public RecyclerView getRecyclerView()

isPromptCheckBoxChecked

public boolean isPromptCheckBoxChecked()

setPromptCheckBoxChecked

public void setPromptCheckBoxChecked(boolean checked)

onClick

public final void onClick(android.view.View v)

Specified by:

onClick in interface android.view.View.OnClickListener

show

public void show()

Overrides:

show in class android.app.Dialog

getActionButton

public final MDButton getActionButton(DialogAction which)

Retrieves the view of an action button, allowing you to modify properties such as whether or not it's enabled. Use setActionButton(DialogAction, int) to change text, since the view returned here is not the view that displays text.

Parameters:

which - The action button of which to get the view for.

Returns:

The view from the dialog's layout representing this action button.

getView

public final android.view.View getView()

Retrieves the view representing the dialog as a whole. Be careful with this.

getInputEditText

public final android.widget.EditText getInputEditText()

getTitleView

public final android.widget.TextView getTitleView()

Retrieves the TextView that contains the dialog title. If you want to update the title, use #setTitle(CharSequence) instead.

getIconView

public android.widget.ImageView getIconView()

Retrieves the ImageView that contains the dialog icon.

getContentView

public final android.widget.TextView getContentView()

Retrieves the TextView that contains the dialog content. If you want to update the content (message), use #setContent(CharSequence) instead.

getCustomView

public final android.view.View getCustomView()

Retrieves the custom view that was inflated or set to the MaterialDialog during building.

Returns:

The custom view that was passed into the Builder.

setActionButton

public final void setActionButton(DialogAction which,
                                  java.lang.CharSequence title)

Updates an action button's title, causing invalidation to check if the action buttons should be stacked. Setting an action button's text to null is a shortcut for hiding it, too.

Parameters:

which - The action button to update.

title - The new title of the action button.

setActionButton

public final void setActionButton(DialogAction which,
                                  int titleRes)

Updates an action button's title, causing invalidation to check if the action buttons should be stacked.

Parameters:

which - The action button to update.

titleRes - The string resource of the new title of the action button.

hasActionButtons

public final boolean hasActionButtons()

Gets whether or not the positive, neutral, or negative action button is visible.

Returns:

Whether or not 1 or more action buttons is visible.

numberOfActionButtons

public final int numberOfActionButtons()

Gets the number of visible action buttons.

Returns:

0 through 3, depending on how many should be or are visible.

setTitle

public final void setTitle(java.lang.CharSequence newTitle)

Overrides:

setTitle in class android.app.Dialog

setTitle

public final void setTitle(int newTitleRes)

Overrides:

setTitle in class android.app.Dialog

setTitle

public final void setTitle(int newTitleRes,
                           java.lang.Object... formatArgs)

setIcon

public void setIcon(int resId)

setIcon

public void setIcon(android.graphics.drawable.Drawable d)

setIconAttribute

public void setIconAttribute(int attrId)

setContent

public final void setContent(java.lang.CharSequence newContent)

setContent

public final void setContent(int newContentRes)

setContent

public final void setContent(int newContentRes,
                             java.lang.Object... formatArgs)

getItems

public final java.util.ArrayList<java.lang.CharSequence> getItems()

setItems

public final void setItems(java.lang.CharSequence... items)

notifyItemInserted

public final void notifyItemInserted(int index)

notifyItemChanged

public final void notifyItemChanged(int index)

notifyItemsChanged

public final void notifyItemsChanged()

getCurrentProgress

public final int getCurrentProgress()

getProgressBar

public android.widget.ProgressBar getProgressBar()

incrementProgress

public final void incrementProgress(int by)

setProgress

public final void setProgress(int progress)

isIndeterminateProgress

public final boolean isIndeterminateProgress()

getMaxProgress

public final int getMaxProgress()

setMaxProgress

public final void setMaxProgress(int max)

setProgressPercentFormat

public final void setProgressPercentFormat(java.text.NumberFormat format)

Change the format of the small text showing the percentage of progress. The default is NumberFormat.getPercentageInstance().

setProgressNumberFormat

public final void setProgressNumberFormat(java.lang.String format)

Change the format of the small text showing current and maximum units of progress. The default is "%1d/%2d".

isCancelled

public final boolean isCancelled()

getSelectedIndex

public int getSelectedIndex()

Convenience method for getting the currently selected index of a single choice list.

Returns:

Currently selected index of a single choice list, or -1 if not showing a single choice list

setSelectedIndex

public void setSelectedIndex(int index)

Convenience method for setting the currently selected index of a single choice list. This only works if you are not using a custom adapter; if you're using a custom adapter, an IllegalStateException is thrown. Note that this does not call the respective single choice callback.

Parameters:

index - The index of the list item to check.

getSelectedIndices

public java.lang.Integer[] getSelectedIndices()

Convenience method for getting the currently selected indices of a multi choice list

Returns:

Currently selected index of a multi choice list, or null if not showing a multi choice list

setSelectedIndices

public void setSelectedIndices(java.lang.Integer[] indices)

Convenience method for setting the currently selected indices of a multi choice list. This only works if you are not using a custom adapter; if you're using a custom adapter, an IllegalStateException is thrown. Note that this does not call the respective multi choice callback.

Parameters:

indices - The indices of the list items to check.

clearSelectedIndices

public void clearSelectedIndices()

Clears all selected checkboxes from multi choice list dialogs.

clearSelectedIndices

public void clearSelectedIndices(boolean sendCallback)

Clears all selected checkboxes from multi choice list dialogs.

Parameters:

sendCallback - Defaults to true. True will notify the multi-choice callback, if any.

selectAllIndices

public void selectAllIndices()

Selects all checkboxes in multi choice list dialogs.

selectAllIndices

public void selectAllIndices(boolean sendCallback)

Selects all checkboxes in multi choice list dialogs.

Parameters:

sendCallback - Defaults to true. True will notify the multi-choice callback, if any.

onShow

public final void onShow(android.content.DialogInterface dialog)

Specified by:

onShow in interface android.content.DialogInterface.OnShowListener

dismiss

public void dismiss()

Specified by:

dismiss in interface android.content.DialogInterface

Overrides:

dismiss in class android.app.Dialog

findViewById

public android.view.View findViewById(int id)

Overrides:

findViewById in class android.app.Dialog

setOnShowListener

public final void setOnShowListener(android.content.DialogInterface.OnShowListener listener)

Overrides:

setOnShowListener in class android.app.Dialog

setContentView

@Deprecated
public void setContentView(int layoutResID)
                                throws java.lang.IllegalAccessError

Deprecated.

Overrides:

setContentView in class android.app.Dialog

Throws:

java.lang.IllegalAccessError

setContentView

@Deprecated
public void setContentView(android.view.View view)
                                throws java.lang.IllegalAccessError

Deprecated.

Overrides:

setContentView in class android.app.Dialog

Throws:

java.lang.IllegalAccessError

setContentView

@Deprecated
public void setContentView(android.view.View view,
                                       android.view.ViewGroup.LayoutParams params)
                                throws java.lang.IllegalAccessError

Deprecated.

Overrides:

setContentView in class android.app.Dialog

Throws:

java.lang.IllegalAccessError