de.mrapp.android.dialog

Class AbstractButtonBarDialog

java.lang.Object

android.app.Dialog

de.mrapp.android.dialog.AbstractMaterialDialog

de.mrapp.android.dialog.AbstractHeaderDialog

de.mrapp.android.dialog.AbstractValidateableDialog

de.mrapp.android.dialog.AbstractButtonBarDialog

All Implemented Interfaces:

android.content.DialogInterface, android.view.KeyEvent.Callback, android.view.View.OnCreateContextMenuListener, android.view.Window.Callback, ButtonBarDialog, ButtonBarDialogDecorator, Dialog, HeaderDialog, HeaderDialogDecorator, MaterialDialog, MaterialDialogDecorator, ValidateableDialog, ValidateableDialogDecorator

Direct Known Subclasses:

AbstractListDialog, ProgressDialog

public abstract class AbstractButtonBarDialog
extends AbstractValidateableDialog
implements ButtonBarDialog

An abstract base class for all dialogs, which are designed according to Android 5's Material design guidelines even on pre-Lollipop devices and may contain up to three buttons.

Since:

3.2.0

Nested Class Summary

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
protected	AbstractButtonBarDialog(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 and may contain up to three buttons.

Method Summary

Modifier and Type	Method and Description
boolean	areButtonsStacked() Returns, whether the buttons of the dialog are aligned vertically, or not.
android.widget.Button	getButton(int whichButton) Returns one of the buttons, which is shown by the dialog.
int	getButtonBarDividerColor() Returns the color of the divider, which is located above the dialog's buttons.
int	getButtonTextColor() Returns the color of the button texts of the dialog.
boolean	isButtonBarDividerShown() Returns, whether the divider, which is located above the dialog's buttons, is shown, or not.
protected void	onAttachDecorators(android.view.View view) The method, which is invoked when the dialog's decorators should be attached.
protected void	onDetachDecorators() The method, which is invoked when the dialog's decorators should be detached.
void	onRestoreInstanceState(android.os.Bundle savedInstanceState)
android.os.Bundle	onSaveInstanceState()
void	setButtonBarDividerColor(int color) Sets the color of the divider, which is located above the dialog's buttons.
void	setButtonTextColor(int color) Sets the color of the button texts 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	showButtonBarDivider(boolean show) Sets, whether the divider, which is located above the dialog's buttons, should be shown, or not.
void	stackButtons(boolean stackButtons) Sets, whether the buttons of the dialog should be aligned vertically, or not.

Methods inherited from class de.mrapp.android.dialog.AbstractValidateableDialog

addAllValidators, addValidator, getValidators, removeAllValidators, removeValidator

Methods inherited from class de.mrapp.android.dialog.AbstractHeaderDialog

getHeaderBackground, getHeaderDividerColor, getHeaderHeight, getHeaderIcon, isHeaderDividerShown, isHeaderShown, setHeaderBackground, setHeaderBackground, setHeaderBackgroundColor, setHeaderDividerColor, setHeaderHeight, setHeaderIcon, setHeaderIcon, showHeader, showHeaderDivider

Methods inherited from class de.mrapp.android.dialog.AbstractMaterialDialog

getBackground, getIcon, getMessage, getMessageColor, getTitle, getTitleColor, onStart, onStop, setBackground, setBackground, setBackgroundColor, setCustomMessage, setCustomMessage, setCustomTitle, setCustomTitle, setIcon, setIcon, setIconAttribute, setMessage, setMessage, setMessageColor, setTitle, setTitleColor, setView, setView

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, onCreate, onCreateContextMenu, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onDetachedFromWindow, onGenericMotionEvent, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyShortcut, onKeyUp, onMenuItemSelected, onMenuOpened, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPrepareOptionsMenu, onPreparePanel, onSearchRequested, onSearchRequested, 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 de.mrapp.android.dialog.model.MaterialDialog

setCancelable, setOnCancelListener, setOnDismissListener, setOnShowListener

Methods inherited from interface de.mrapp.android.dialog.model.MaterialDialogDecorator

getBackground, getIcon, getMessage, getMessageColor, getTitle, getTitleColor, setBackground, setBackground, setBackgroundColor, setCustomMessage, setCustomMessage, setCustomTitle, setCustomTitle, setIcon, setIcon, setIconAttribute, setMessage, setMessage, setMessageColor, setTitle, setTitle, setTitleColor, setView, setView

Methods inherited from interface de.mrapp.android.dialog.model.Dialog

getContext

Methods inherited from interface android.content.DialogInterface

cancel, dismiss

Methods inherited from interface de.mrapp.android.dialog.model.HeaderDialogDecorator

getHeaderBackground, getHeaderDividerColor, getHeaderHeight, getHeaderIcon, isHeaderDividerShown, isHeaderShown, setHeaderBackground, setHeaderBackground, setHeaderBackgroundColor, setHeaderDividerColor, setHeaderHeight, setHeaderIcon, setHeaderIcon, showHeader, showHeaderDivider

Methods inherited from interface de.mrapp.android.dialog.model.ValidateableDialogDecorator

addAllValidators, addValidator, getValidators, removeAllValidators, removeValidator

Methods inherited from interface android.view.Window.Callback

onProvideKeyboardShortcuts

Constructor Detail

AbstractButtonBarDialog

protected AbstractButtonBarDialog(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 and may contain up to three buttons.

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)

Description copied from interface: ButtonBarDialogDecorator

Returns one of the buttons, which is shown by the dialog.

Specified by:

getButton in interface ButtonBarDialogDecorator

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)

Description copied from interface: ButtonBarDialogDecorator

Sets the text of the positive button of the dialog. Note, that the attached listener is not stored using a dialog's onSaveInstanceState-method, because it is not serializable. Therefore this method must be called again after configuration changes, e.g when the orientation of the device has changed, in order to re-register the listener.

Specified by:

setPositiveButton in interface ButtonBarDialogDecorator

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 DialogInterface.OnClickListener or null, if no listener should be notified

setPositiveButton

public final void setPositiveButton(int resourceId,
                                    android.content.DialogInterface.OnClickListener listener)

Description copied from interface: ButtonBarDialogDecorator

Sets the text of the positive button of the dialog. Note, that the attached listener is not stored using a dialog's onSaveInstanceState-method, because it is not serializable. Therefore this method must be called again after configuration changes, e.g when the orientation of the device has changed, in order to re-register the listener.

Specified by:

setPositiveButton in interface ButtonBarDialogDecorator

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 DialogInterface.OnClickListener or null, if no listener should be notified

setNegativeButton

public final void setNegativeButton(java.lang.CharSequence text,
                                    android.content.DialogInterface.OnClickListener listener)

Description copied from interface: ButtonBarDialogDecorator

Sets the text of the negative button of the dialog. Note, that the attached listener is not stored using a dialog's onSaveInstanceState-method, because it is not serializable. Therefore this method must be called again after configuration changes, e.g when the orientation of the device has changed, in order to re-register the listener.

Specified by:

setNegativeButton in interface ButtonBarDialogDecorator

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 DialogInterface.OnClickListener or null, if no listener should be notified

setNegativeButton

public final void setNegativeButton(int resourceId,
                                    android.content.DialogInterface.OnClickListener listener)

Description copied from interface: ButtonBarDialogDecorator

Sets the text of the negative button of the dialog. Note, that the attached listener is not stored using a dialog's onSaveInstanceState-method, because it is not serializable. Therefore this method must be called again after configuration changes, e.g when the orientation of the device has changed, in order to re-register the listener.

Specified by:

setNegativeButton in interface ButtonBarDialogDecorator

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 DialogInterface.OnClickListener or null, if no listener should be notified

setNeutralButton

public final void setNeutralButton(java.lang.CharSequence text,
                                   android.content.DialogInterface.OnClickListener listener)

Description copied from interface: ButtonBarDialogDecorator

Sets the text of the neutral button of the dialog. Note, that the attached listener is not stored using a dialog's onSaveInstanceState-method, because it is not serializable. Therefore this method must be called again after configuration changes, e.g when the orientation of the device has changed, in order to re-register the listener.

Specified by:

setNeutralButton in interface ButtonBarDialogDecorator

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 DialogInterface.OnClickListener or null, if no listener should be notified

setNeutralButton

public final void setNeutralButton(int resourceId,
                                   android.content.DialogInterface.OnClickListener listener)

Description copied from interface: ButtonBarDialogDecorator

Sets the text of the neutral button of the dialog. Note, that the attached listener is not stored using a dialog's onSaveInstanceState-method, because it is not serializable. Therefore this method must be called again after configuration changes, e.g when the orientation of the device has changed, in order to re-register the listener.

Specified by:

setNeutralButton in interface ButtonBarDialogDecorator

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 DialogInterface.OnClickListener or null, if no listener should be notified

areButtonsStacked

public final boolean areButtonsStacked()

Description copied from interface: ButtonBarDialogDecorator

Returns, whether the buttons of the dialog are aligned vertically, or not.

Specified by:

areButtonsStacked in interface ButtonBarDialogDecorator

Returns:

True, if the buttons of the dialog are aligned vertically, false otherwise

stackButtons

public final void stackButtons(boolean stackButtons)

Description copied from interface: ButtonBarDialogDecorator

Sets, whether the buttons of the dialog should be aligned vertically, or not.

Specified by:

stackButtons in interface ButtonBarDialogDecorator

Parameters:

stackButtons - True, if the buttons of the dialog should be aligned vertically, false otherwise

getButtonTextColor

public final int getButtonTextColor()

Description copied from interface: ButtonBarDialogDecorator

Returns the color of the button texts of the dialog.

Specified by:

getButtonTextColor in interface ButtonBarDialogDecorator

Returns:

The color of the button texts of the dialog as an Integer value

setButtonTextColor

public final void setButtonTextColor(int color)

Description copied from interface: ButtonBarDialogDecorator

Sets the color of the button texts of the dialog.

Specified by:

setButtonTextColor in interface ButtonBarDialogDecorator

Parameters:

color - The color, which should be set, as an Integer value

isButtonBarDividerShown

public final boolean isButtonBarDividerShown()

Description copied from interface: ButtonBarDialogDecorator

Returns, whether the divider, which is located above the dialog's buttons, is shown, or not.

Specified by:

isButtonBarDividerShown in interface ButtonBarDialogDecorator

Returns:

True, if the divider, which is located above the dialog's buttons, is shown, false otherwise

showButtonBarDivider

public final void showButtonBarDivider(boolean show)

Description copied from interface: ButtonBarDialogDecorator

Sets, whether the divider, which is located above the dialog's buttons, should be shown, or not.

Specified by:

showButtonBarDivider in interface ButtonBarDialogDecorator

Parameters:

show - True, if the divider, which is located above the dialog's buttons, should be show, false otherwise

getButtonBarDividerColor

public final int getButtonBarDividerColor()

Description copied from interface: ButtonBarDialogDecorator

Returns the color of the divider, which is located above the dialog's buttons.

Specified by:

getButtonBarDividerColor in interface ButtonBarDialogDecorator

Returns:

The color of the divider, which is located above the dialog's buttons, as an Integer value

setButtonBarDividerColor

public final void setButtonBarDividerColor(int color)

Description copied from interface: ButtonBarDialogDecorator

Sets the color of the divider, which is located above the dialog's buttons.

Specified by:

setButtonBarDividerColor in interface ButtonBarDialogDecorator

Parameters:

color - The color, which should be set, as an Integer value

onSaveInstanceState

public android.os.Bundle onSaveInstanceState()

Overrides:

onSaveInstanceState in class AbstractValidateableDialog

onRestoreInstanceState

public void onRestoreInstanceState(android.os.Bundle savedInstanceState)

Overrides:

onRestoreInstanceState in class AbstractValidateableDialog

onAttachDecorators

protected void onAttachDecorators(android.view.View view)

Description copied from class: AbstractMaterialDialog

The method, which is invoked when the dialog's decorators should be attached. This method may be overridden by subclasses in order to attach additional decorators.

Overrides:

onAttachDecorators in class AbstractValidateableDialog

Parameters:

view - The root view of the view hierarchy, which should be modified by the decorators, as an instance of the class View. The view may not be null

onDetachDecorators

protected void onDetachDecorators()

Description copied from class: AbstractMaterialDialog

The method, which is invoked when the dialog's decorators should be detached. This method must be overridden by subclasses if they attach additional decorators.

Overrides:

onDetachDecorators in class AbstractValidateableDialog