public class

DatePicker

extends View

java.lang.Object
↳	com.neomades.ui.View
	↳	com.neomades.ui.DatePicker

Class Overview

This control lets the user pick a Date.

Day, month and year are available.

Handling Date Changes

 DateChangedListener dateListener = new DateChangedListener() {
 	public void onDateChanged(View source, int day, int month, int year) {
 		// do some stuff
 	}
 };
 DatePicker myDatePicker = new DatePicker();
 myDatePicker.setDateChangedListener(dateListener);

Default properties

By default, the following properties are applied to a new DatePicker:

focusable (limited to some devices)
clickable
enabled
Selected date (today)
no icon
width content stretch : MATCH_CONTENT.
height content stretch : MATCH_CONTENT.
content alignment : HCENTER|VCENTER.
mode : MODE_DIALOG_PICKER

Cross Platform Considerations

In Android, the DatePicker has two modes : MODE_INLINE, MODE_DIALOG_PICKER. The MODE_INLINE enables wrapping DatePicker control inside a Layout. The MODE_DIALOG_PICKER mode shows a button with the selected date, when the end-user click him, a dialog is displayed : DatePickerDialog.

Summary

XML Attributes
Attribute Name	Related Method	Description
contentAlignment	setContentAlignment(int)	A combination of alignment values (eg: TOP\|LEFT)
day	setDay(int)	Between 1 and 31
font	setFont(Font)	Font resource id: Res.font.FONT_XXXX
month	setMonth(int)	1: JANUARY, 12: DECEMBER
textColor	setTextColor(Color)	#AARRGGBB or a color
textSize	setTextSize(int)	a size in dp
year	setYear(int)

[Expand]

Inherited XML Attributes

From class com.neomades.ui.View

Constants
int	MODE_DIALOG_PICKER	A button is displayed with the value of Date.
int	MODE_INLINE	Three editors are displayed into the layout in order to input values of Date.

[Expand]

Inherited Constants

From interface com.neomades.ui.Alignment

From interface com.neomades.ui.StretchMode

Public Constructors
	DatePicker(int mode) Constructs a new date picker with the date set to today's day, month and year.
	DatePicker() Constructs a new date picker with the date set to today's day, month and year.
	DatePicker(int day, int month, int year) Constructs a new DatePicker with the date set to the given parameters.

Public Methods
Calendar	getCalendar() Gets the calendar object with the selected date in this picker
Date	getDate() Gets the date object with the selected date in this picker
int	getDay() Returns the day of this DatePicker (always between 1 and 31)
int	getMonth() Returns the month of this DatePicker (always between 1 and 12)
int	getYear() Returns the year of this DatePicker (always between -Infinity and +Infinity)
static void	openChooser(View origin, Calendar selectedDate, DateChangedListener listener) Shows a `dialog chooser` to the user in order to select a `date`.
void	setContentAlignment(int alignment) Sets the alignment of the text or icon in the button.
void	setDate(Calendar date)
void	setDate(Date date) Sets the date of the DatePicker to the given date Only the day, month and year components will be taken into acount
void	setDateChangedListener(DateChangedListener listener) Sets the listener for this DatePicker, that will be notified if the date changes.
void	setDay(int day) Sets the day number to set (always between 1 and 31)
void	setFont(Font font) Sets the datepicker's button text font.
void	setMonth(int month) Sets the months of this date picker (always between 1 and 12)
void	setTextColor(Color textColor) Sets the DatePicker text color.
void	setTextSize(int sizeInDp) Sets the text size to a given value (in dp).
void	setToday() Sets the date of the DatePicker to today's date
void	setYear(int year) Sets the year of this DatePicker (must be positive)

[Expand]

Inherited Methods

From class com.neomades.ui.View

View	findView(int viewId) Find view by Id.
int	getId() Returns the identifier of this element, by default all elements return "0".
Object	getTag() Returns this view's tag.
static View	inflateXML(int layoutResId) Inflate view from XMLLayout declared in the URS File.
static View	inflateXML(InputStream xmlStream) @return
boolean	isClickable() Returns if the view is clickable.
boolean	isEnabled() Return a boolean indicating if the view is enabled or not
boolean	isFocusable() Returns if the view is focusable (for the devices that have a keyboard Ui navigation).
boolean	isVisible() Returns if the view is visible
void	runOnUiThread(Runnable action) Calls `action.run()` asynchronously on the `UI-Thread`.
void	setBackground(Background background) Sets the background on this view.
void	setBackground(int backgroundResId) Sets the background on this view with a XML background definition.
void	setBackgroundColor(Color color) Sets the background color on this view.
void	setBackgroundImage(int imageID) Set the background image for this view.
void	setBackgroundImage(Image image) Set the background image for this view.
void	setBorderColor(Color borderColor) Sets the border color on this view.
void	setBorderWidth(int widthInDp) Set the border width (size) in DP units.
void	setClickListener(ClickListener clickListener) Sets a ClickListener to this view.
void	setClickable(boolean clickable) Sets this view clickable.
void	setCornerRadius(int radiusSize) Set the four corners radius, if the view has corners.
void	setDrawingCacheEnabled(boolean enabled) Enables or disables the drawing cache.
void	setEnabled(boolean enabled) Sets the state of this view to enabled or disabled.
void	setFocusable(boolean focusable) Sets the view focusable.
void	setGestureDetector(GestureDetector detector) Sets a `GestureDetector` on this view.
void	setHeight(int heightDp) Sets the height of the view, in dp units (density-independent pixels).
void	setId(int id) Sets a identifier/tag to this element
void	setInvalidateDisabled(boolean disabled) If set to true, force the layout that contains the view to not be draw again when its content changes.
void	setLayoutAlignment(int alignment) Sets the view alignment into its parent.
void	setMargin(int uniformMarginDp) Set the margin outside this view (used by `Layout`), by setting on each side the given value.
void	setMargin(int leftDp, int topDp, int rightDp, int bottomDp) Set the margin outside this view (used by `Layout`).
void	setMarginBottom(int marginBottomDp) Sets the bottom margin with the given value.
void	setMarginLeft(int marginLeftDp) Sets the left margin with the given value.
void	setMarginRight(int marginRightDp) Sets the right margin with the given value.
void	setMarginTop(int marginTopDp) Sets the top margin with the given value.
void	setPadding(int leftDp, int topDp, int rightDp, int bottomDp) Sets the view padding.
void	setPadding(int uniformPaddingDp) Sets the view padding, with for each side the value given in parameter.
void	setPaddingBottom(int paddingBottomDp) Sets the bottom padding with the given value.
void	setPaddingLeft(int paddingLeftDp) Sets the left padding with the given value.
void	setPaddingRight(int paddingRightDp) Sets the right padding with the given value.
void	setPaddingTop(int paddingTopDp) Sets the top padding with the given value.
void	setSize(int widthDp, int heightDp) Sets the size of the view, in dp units (density-independent pixels).
void	setStretchHorizontalMode(int widthMode) Sets the stretch horizontal mode.
void	setStretchMode(int horizontalMode, int verticalMode) Sets the view content stretch mode.
void	setStretchVerticalMode(int heightMode) Sets the stretch vertical mode.
void	setStyle(int styleResId)
void	setStyle(Style style)
void	setTag(Object tag) Sets the tag associated with this view.
void	setTouchListener(TouchListener touchListener) Register a listener to be invoked when a touch event is dispatched to this view.
void	setTransformOrigin(float xOrigin, float yOrigin) Sets the x and y location of the point around which the view will be scaled or rotated when an animation occurs.
void	setVisible(boolean visible) Sets the view's visibility : visible or invisible/hidden
void	setWidth(int widthDp) Sets the width of the view, in dp units (density-independent pixels).

From class java.lang.Object

boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
final Class<?>	getClass() Returns the runtime class of an object.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait(long timeout, int nanos) Causes current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
final void	wait() Causes current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

XML Attributes

contentAlignment

A combination of alignment values (eg: TOP|LEFT)

Related Methods

setContentAlignment(int)

day

Between 1 and 31

Related Methods

setDay(int)

font

Font resource id: Res.font.FONT_XXXX

Related Methods

setFont(Font)

month

1: JANUARY, 12: DECEMBER

Related Methods

setMonth(int)

textColor

#AARRGGBB or a color

Related Methods

setTextColor(Color)

year

Related Methods

setYear(int)

Constants

public static final int MODE_DIALOG_PICKER

A button is displayed with the value of Date. When the user clicks on the button, a Dialog is displayed in order to pick a Date.

Default mode for all platforms.

Constant Value: 0 (0x00000000)

public static final int MODE_INLINE

Three editors are displayed into the layout in order to input values of Date. Only available for Android.

In this mode, text customization methods do nothing (text color, text font, text size and text alignment).

Constant Value: 1 (0x00000001)

Public Constructors

public DatePicker (int mode)

Constructs a new date picker with the date set to today's day, month and year.

public DatePicker ()

Constructs a new date picker with the date set to today's day, month and year.

The mode used here is MODE_DIALOG_PICKER.

public DatePicker (int day, int month, int year)

Constructs a new DatePicker with the date set to the given parameters.

Parameters

day	the day to set to this date picker. This value must be between 1 and 31.
month	the month to set to this date picker. This value must be between 1 and 12.
year	the year number

Public Methods

public Calendar getCalendar ()

Gets the calendar object with the selected date in this picker

Returns

the selected date

public Date getDate ()

Gets the date object with the selected date in this picker

Returns

the selected date

public int getDay ()

Returns the day of this DatePicker (always between 1 and 31)

Related XML Attributes

day

Returns

the day of this DatePicker (always between 1 and 31)

public int getMonth ()

Returns the month of this DatePicker (always between 1 and 12)

Related XML Attributes

month

Returns

the month of this DatePicker (always between 1 and 12)

public int getYear ()

Returns the year of this DatePicker (always between -Infinity and +Infinity)

Related XML Attributes

year

Returns

the year of this DatePicker (always between -Infinity and +Infinity)

public static void openChooser (View origin, Calendar selectedDate, DateChangedListener listener)

Shows a dialog chooser to the user in order to select a date.

Parameters

origin	the view from here the dialog should be opened in iOS.
selectedDate	the selected date when the chooser will be shown at the user
listener	the callback used to get the selected date or null

Throws

NullPointerException	for iOS if the `origin` parameter is `null`.

public void setContentAlignment (int alignment)

Sets the alignment of the text or icon in the button. The parameter is a combination of values from Alignment

Only available in MODE_DIALOG_PICKER.

Related XML Attributes

contentAlignment

Parameters

alignment	The new alignment of the button's text

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public void setDate (Calendar date)

public void setDate (Date date)

Sets the date of the DatePicker to the given date Only the day, month and year components will be taken into acount

Parameters

date	the date to set

public void setDateChangedListener (DateChangedListener listener)

Sets the listener for this DatePicker, that will be notified if the date changes.

Parameters

listener	the listener

public void setDay (int day)

Sets the day number to set (always between 1 and 31)

Related XML Attributes

day

Throws

CrossThreadException	if the method is called from outside the UI-Thread
IllegalArgumentException	if the day value is not between 1 and 31

public void setFont (Font font)

Sets the datepicker's button text font.

Related XML Attributes

font

Parameters

font	new font for the text

Throws

CrossThreadException	if the method is called from outside the UI-Thread
NullPointerException	if the font parameter is null

public void setMonth (int month)

Sets the months of this date picker (always between 1 and 12)

Related XML Attributes

month

Parameters

month	the hours to set (always between 1 and 12)

Throws

CrossThreadException	if the method is called from outside the UI-Thread
IllegalArgumentException	if the month value is not between 1 and 12

public void setTextColor (Color textColor)

Sets the DatePicker text color.

Related XML Attributes

textColor

Parameters

textColor	new color for the text

Throws

CrossThreadException	if the method is called from outside the UI-Thread
NullPointerException	if the parameter is null

public void setTextSize (int sizeInDp)

Sets the text size to a given value (in dp).

Related XML Attributes

textSize

Parameters

sizeInDp	size to set to the text

public void setToday ()

Sets the date of the DatePicker to today's date

public void setYear (int year)

Sets the year of this DatePicker (must be positive)

Related XML Attributes

year

Parameters

year	the years to set

Throws

CrossThreadException	if the method is called from outside the UI-Thread
IllegalArgumentException	if the year value is negative

Interfaces

Classes

Enums

Exceptions

DatePicker

Class Overview

Handling Date Changes

Default properties

Cross Platform Considerations

Summary

XML Attributes

contentAlignment

Related Methods

day

Related Methods

font

Related Methods

month

Related Methods

textColor

Related Methods

textSize

Related Methods

year

Related Methods

Constants

public static final int MODE_DIALOG_PICKER

public static final int MODE_INLINE

Public Constructors

public DatePicker (int mode)

See Also

public DatePicker ()

See Also

public DatePicker (int day, int month, int year)

Parameters

Public Methods

public Calendar getCalendar ()

Returns

See Also

public Date getDate ()

Returns

See Also

public int getDay ()

Related XML Attributes

Returns

public int getMonth ()

Related XML Attributes

Returns

public int getYear ()

Related XML Attributes

Returns

public static void openChooser (View origin, Calendar selectedDate, DateChangedListener listener)

Parameters

Throws

See Also

public void setContentAlignment (int alignment)

Related XML Attributes

Parameters

Throws

See Also

public void setDate (Calendar date)

See Also

public void setDate (Date date)

Parameters

See Also

public void setDateChangedListener (DateChangedListener listener)

Parameters

public void setDay (int day)

Related XML Attributes

Throws

public void setFont (Font font)

Related XML Attributes

Parameters

Throws

public void setMonth (int month)

Related XML Attributes

Parameters

Throws

public void setTextColor (Color textColor)

Related XML Attributes