com.codetroopers.betterpickers.expirationpicker

Class ExpirationPickerBuilder

java.lang.Object

com.codetroopers.betterpickers.expirationpicker.ExpirationPickerBuilder

public class ExpirationPickerBuilder
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
ExpirationPickerBuilder()

Method Summary

Modifier and Type	Method and Description
ExpirationPickerBuilder	addExpirationPickerDialogHandler(ExpirationPickerDialogFragment.ExpirationPickerDialogHandler handler) Attach universal objects as additional handlers for notification when the Picker is set.
ExpirationPickerBuilder	removeExpirationPickerDialogHandler(ExpirationPickerDialogFragment.ExpirationPickerDialogHandler handler) Remove objects previously added as handlers.
ExpirationPickerBuilder	setFragmentManager(FragmentManager manager) Attach a FragmentManager.
ExpirationPickerBuilder	setMinYear(int year) Set the minimum year that the user is allowed to pick.
ExpirationPickerBuilder	setMonthOfYear(int monthOfYear) Pre-set a zero-indexed month of year.
ExpirationPickerBuilder	setOnDismissListener(OnDialogDismissListener onDismissListener)
ExpirationPickerBuilder	setReference(int reference) Attach a reference to this Picker instance.
ExpirationPickerBuilder	setStyleResId(int styleResId) Attach a style resource ID for theming.
ExpirationPickerBuilder	setTargetFragment(Fragment targetFragment) Attach a target Fragment.
ExpirationPickerBuilder	setYear(int year) Pre-set a year.
void	show() Instantiate and show the Picker

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExpirationPickerBuilder

public ExpirationPickerBuilder()

Method Detail

setFragmentManager

public ExpirationPickerBuilder setFragmentManager(FragmentManager manager)

Attach a FragmentManager. This is required for creation of the Fragment.

Parameters:

manager - the FragmentManager that handles the transaction

Returns:

the current Builder object

setStyleResId

public ExpirationPickerBuilder setStyleResId(int styleResId)

Attach a style resource ID for theming. This is required for creation of the Fragment. Two stock styles are provided using R.style.BetterPickersDialogFragment and R.style.BetterPickersDialogFragment.Light

Parameters:

styleResId - the style resource ID to use for theming

Returns:

the current Builder object

setTargetFragment

public ExpirationPickerBuilder setTargetFragment(Fragment targetFragment)

Attach a target Fragment. This is optional and useful if creating a Picker within a Fragment.

Parameters:

targetFragment - the Fragment to attach to

Returns:

the current Builder object

setReference

public ExpirationPickerBuilder setReference(int reference)

Attach a reference to this Picker instance. This is used to track multiple pickers, if the user wishes.

Parameters:

reference - a user-defined int intended for Picker tracking

Returns:

the current Builder object

setMinYear

public ExpirationPickerBuilder setMinYear(int year)

Set the minimum year that the user is allowed to pick. The default is the current year.

Parameters:

year - the year to set as the minimum

Returns:

the current Builder object

setMonthOfYear

public ExpirationPickerBuilder setMonthOfYear(int monthOfYear)

Pre-set a zero-indexed month of year. This is highly frowned upon as it contributes to user confusion. The Pickers do a great job of making input quick and easy, and thus it is preferred to always start with a blank slate.

Parameters:

monthOfYear - the zero-indexed month of year to pre-set

Returns:

the current Builder object

setYear

public ExpirationPickerBuilder setYear(int year)

Pre-set a year. This is highly frowned upon as it contributes to user confusion. The Pickers do a great job of making input quick and easy, and thus it is preferred to always start with a blank slate.

Parameters:

year - the year to pre-set

Returns:

the current Builder object

addExpirationPickerDialogHandler

public ExpirationPickerBuilder addExpirationPickerDialogHandler(ExpirationPickerDialogFragment.ExpirationPickerDialogHandler handler)

Attach universal objects as additional handlers for notification when the Picker is set. For most use cases, this method is not necessary as attachment to an Activity or Fragment is done automatically. If, however, you would like additional objects to subscribe to this Picker being set, attach Handlers here.

Parameters:

handler - an Object implementing the appropriate Picker Handler

Returns:

the current Builder object

removeExpirationPickerDialogHandler

public ExpirationPickerBuilder removeExpirationPickerDialogHandler(ExpirationPickerDialogFragment.ExpirationPickerDialogHandler handler)

Remove objects previously added as handlers.

Parameters:

handler - the Object to remove

Returns:

the current Builder object

show

public void show()

Instantiate and show the Picker

setOnDismissListener

public ExpirationPickerBuilder setOnDismissListener(OnDialogDismissListener onDismissListener)