ButtonBarDialogDecorator (library API)

java.lang.Object
- de.mrapp.android.dialog.decorator.AbstractDialogDecorator<ValidateableDialog>
- - de.mrapp.android.dialog.decorator.ButtonBarDialogDecorator

All Implemented Interfaces:

ButtonBarDialogDecorator, Dialog, DialogDecorator
```
public class ButtonBarDialogDecorator
extends AbstractDialogDecorator<ValidateableDialog>
implements ButtonBarDialogDecorator
```
A decorator, which allows to modify the view hierarchy of 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.

Since:

3.2.0

Constructor Summary

Constructors
Constructor and Description
`ButtonBarDialogDecorator(ValidateableDialog dialog)` Creates a new decorator, which allows to modify the view hierarchy of 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

All Methods Instance Methods Concrete Methods
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`	`onAttach(android.view.View view)` The method, which is invoked, when the decorator is attached to the view hierarchy.
`protected void`	`onDetach()` The method, which is invoked, when the decorator is detached from the view hierarchy.
`void`	`onRestoreInstanceState(android.os.Bundle savedInstanceState)` The method, which is invoked in order to restore the state, which has previously stored within a bundle.
`void`	`onSaveInstanceState(android.os.Bundle outState)` The method, which is invoked in order to stores the decorator's state.
`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.decorator.AbstractDialogDecorator
attach, detach, getContext, getDialog, getView

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.Dialog
getContext

- Constructor Detail
  - ButtonBarDialogDecorator
```
public ButtonBarDialogDecorator(ValidateableDialog dialog)
```
    Creates a new decorator, which allows to modify the view hierarchy of 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:
    
    dialog - The dialog, whose view hierarchy should be modified by the decorator, as an instance of the type ValidateableDialog. The dialog may not be null
- 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 final void onSaveInstanceState(android.os.Bundle outState)
```
    Description copied from interface: DialogDecorator
    
    The method, which is invoked in order to stores the decorator's state.
    
    Specified by:
    
    onSaveInstanceState in interface DialogDecorator
    
    Parameters:
    
    outState - The bundle, the decorator's state should be stored within, as an instance of the class Bundle. The bundle may not be null
  - onRestoreInstanceState
```
public final void onRestoreInstanceState(android.os.Bundle savedInstanceState)
```
    Description copied from interface: DialogDecorator
    
    The method, which is invoked in order to restore the state, which has previously stored within a bundle.
    
    Specified by:
    
    onRestoreInstanceState in interface DialogDecorator
    
    Parameters:
    
    savedInstanceState - The bundle, which has been used to store the state, as an instance of the class Bundle. The bundle may not be null
  - onAttach
```
protected final void onAttach(android.view.View view)
```
    Description copied from class: AbstractDialogDecorator
    
    The method, which is invoked, when the decorator is attached to the view hierarchy.
    
    Specified by:
    
    onAttach in class AbstractDialogDecorator<ValidateableDialog>
    
    Parameters:
    
    view - The root view of the dialog, which is modified by the decorator, as an instance of the class View. The view may not be null
  - onDetach
```
protected final void onDetach()
```
    Description copied from class: AbstractDialogDecorator
    
    The method, which is invoked, when the decorator is detached from the view hierarchy.
    
    Specified by:
    
    onDetach in class AbstractDialogDecorator<ValidateableDialog>

Class ButtonBarDialogDecorator

Constructor Summary

Method Summary

Methods inherited from class de.mrapp.android.dialog.decorator.AbstractDialogDecorator

Methods inherited from class java.lang.Object

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

Constructor Detail

ButtonBarDialogDecorator

Method Detail

getButton

setPositiveButton

setPositiveButton

setNegativeButton

setNegativeButton

setNeutralButton

setNeutralButton

areButtonsStacked

stackButtons

getButtonTextColor

setButtonTextColor

isButtonBarDividerShown

showButtonBarDivider

getButtonBarDividerColor

setButtonBarDividerColor

onSaveInstanceState

onRestoreInstanceState

onAttach

onDetach