com.codetroopers.betterpickers.datepicker

Class DatePickerBuilder

java.lang.Object

com.codetroopers.betterpickers.datepicker.DatePickerBuilder

public class DatePickerBuilder
extends java.lang.Object

User: derek Date: 5/2/13 Time: 7:55 PM

Constructor Summary

Constructors

Constructor and Description
DatePickerBuilder()

Method Summary

Modifier and Type	Method and Description
DatePickerBuilder	addDatePickerDialogHandler(DatePickerDialogFragment.DatePickerDialogHandler handler) Attach universal objects as additional handlers for notification when the Picker is set.
DatePickerBuilder	removeDatePickerDialogHandler(DatePickerDialogFragment.DatePickerDialogHandler handler) Remove objects previously added as handlers.
DatePickerBuilder	setDayOfMonth(int dayOfMonth) Pre-set a day of month.
DatePickerBuilder	setFragmentManager(FragmentManager manager) Attach a FragmentManager.
DatePickerBuilder	setMonthOfYear(int monthOfYear) Pre-set a zero-indexed month of year.
DatePickerBuilder	setOnDismissListener(OnDialogDismissListener onDismissListener)
DatePickerBuilder	setReference(int reference) Attach a reference to this Picker instance.
DatePickerBuilder	setStyleResId(int styleResId) Attach a style resource ID for theming.
DatePickerBuilder	setTargetFragment(Fragment targetFragment) Attach a target Fragment.
DatePickerBuilder	setYear(int year) Pre-set a year.
DatePickerBuilder	setYearOptional(boolean yearOptional) Set if year should be an optional field in the picker.
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

DatePickerBuilder

public DatePickerBuilder()

Method Detail

setFragmentManager

public DatePickerBuilder 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 DatePickerBuilder 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 DatePickerBuilder 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 DatePickerBuilder 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

setMonthOfYear

public DatePickerBuilder 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

setDayOfMonth

public DatePickerBuilder setDayOfMonth(int dayOfMonth)

Pre-set a day of month. 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:

dayOfMonth - the day of month to pre-set

Returns:

the current Builder object

setYear

public DatePickerBuilder 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

setYearOptional

public DatePickerBuilder setYearOptional(boolean yearOptional)

Set if year should be an optional field in the picker. False by default.

Parameters:

yearOptional - whether the year is optional

Returns:

the current Builder object

addDatePickerDialogHandler

public DatePickerBuilder addDatePickerDialogHandler(DatePickerDialogFragment.DatePickerDialogHandler 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

removeDatePickerDialogHandler

public DatePickerBuilder removeDatePickerDialogHandler(DatePickerDialogFragment.DatePickerDialogHandler handler)

Remove objects previously added as handlers.

Parameters:

handler - the Object to remove

Returns:

the current Builder object

setOnDismissListener

public DatePickerBuilder setOnDismissListener(OnDialogDismissListener onDismissListener)

show

public void show()

Instantiate and show the Picker