public class

DatePickerCell

extends AbstractEditableCell<C, V>
java.lang.Object
   ↳ com.google.gwt.cell.client.AbstractCell<C>
     ↳ com.google.gwt.cell.client.AbstractEditableCell<C, V>
       ↳ com.google.gwt.cell.client.DatePickerCell

Class Overview

A Cell used to render and edit Dates. When a cell is selected by clicking on it, a DatePicker is popped up. When a date is selected using the DatePicker, the new date is passed to the update method of the ValueUpdater that was passed to onBrowserEvent(Cell.Context, Element, C, NativeEvent, ValueUpdater) for the click event. Note that this means that the call to update(C) will occur after onBrowserEvent(Cell.Context, Element, C, NativeEvent, ValueUpdater) has returned. Pressing the 'escape' key dismisses the DatePicker popup without calling update(C).

Each DatePickerCell has a unique DatePicker popup associated with it; thus, if a single DatePickerCell is used as the cell for a column in a table, only one entry in that column will be editable at a given time.

Summary

Public Constructors
DatePickerCell()
Constructs a new DatePickerCell that uses the date/time format given by getFullDateFormat().
DatePickerCell(DateTimeFormat format)
Constructs a new DatePickerCell that uses the given date/time format and a SimpleSafeHtmlRenderer.
DatePickerCell(SafeHtmlRenderer<String> renderer)
Constructs a new DatePickerCell that uses the date/time format given by getFullDateFormat() and the given SafeHtmlRenderer.
DatePickerCell(DateTimeFormat format, SafeHtmlRenderer<String> renderer)
Constructs a new DatePickerCell that uses the given date/time format and SafeHtmlRenderer.
Public Methods
boolean isEditing(Cell.Context context, Element parent, Date value)
Returns true if the cell is currently editing the data identified by the given element and key.
void onBrowserEvent(Cell.Context context, Element parent, Date value, NativeEvent event, ValueUpdater<Date> valueUpdater)
Handle a browser event that took place within the cell.

If you override this method to add support for events, remember to pass the event types that the cell expects into the constructor.

void render(Cell.Context context, Date value, SafeHtmlBuilder sb)
Render a cell as HTML into a SafeHtmlBuilder, suitable for passing to setInnerHTML(String) on a container element.
Protected Methods
void onEnterKeyDown(Cell.Context context, Element parent, Date value, NativeEvent event, ValueUpdater<Date> valueUpdater)
Called when the user triggers a keydown event with the ENTER key while focused on the cell.
[Expand]
Inherited Methods
From class com.google.gwt.cell.client.AbstractEditableCell
From class com.google.gwt.cell.client.AbstractCell
From class java.lang.Object
From interface com.google.gwt.cell.client.Cell

Public Constructors

public DatePickerCell ()

Constructs a new DatePickerCell that uses the date/time format given by getFullDateFormat().

public DatePickerCell (DateTimeFormat format)

Constructs a new DatePickerCell that uses the given date/time format and a SimpleSafeHtmlRenderer.

Parameters
format a DateTimeFormat instance

public DatePickerCell (SafeHtmlRenderer<String> renderer)

Constructs a new DatePickerCell that uses the date/time format given by getFullDateFormat() and the given SafeHtmlRenderer.

Parameters
renderer a SafeHtmlRenderer instance

public DatePickerCell (DateTimeFormat format, SafeHtmlRenderer<String> renderer)

Constructs a new DatePickerCell that uses the given date/time format and SafeHtmlRenderer.

Parameters
format a DateTimeFormat instance
renderer a SafeHtmlRenderer instance

Public Methods

public boolean isEditing (Cell.Context context, Element parent, Date value)

Returns true if the cell is currently editing the data identified by the given element and key. While a cell is editing, widgets containing the cell may choose to pass keystrokes directly to the cell rather than using them for navigation purposes.

Parameters
context the Context of the cell
parent the parent Element
value the value associated with the cell
Returns
  • true if the cell is in edit mode

public void onBrowserEvent (Cell.Context context, Element parent, Date value, NativeEvent event, ValueUpdater<Date> valueUpdater)

Handle a browser event that took place within the cell. The default implementation returns null.

If you override this method to add support for events, remember to pass the event types that the cell expects into the constructor.

Parameters
context the Context of the cell
parent the parent Element
value the value associated with the cell
event the native browser event
valueUpdater a ValueUpdater, or null if not specified

public void render (Cell.Context context, Date value, SafeHtmlBuilder sb)

Render a cell as HTML into a SafeHtmlBuilder, suitable for passing to setInnerHTML(String) on a container element.

Note: If your cell contains natively focusable elements, such as buttons or input elements, be sure to set the tabIndex to -1 so that they do not steal focus away from the containing widget.

Parameters
context the Context of the cell
value the cell value to be rendered
sb the SafeHtmlBuilder to be written to

Protected Methods

protected void onEnterKeyDown (Cell.Context context, Element parent, Date value, NativeEvent event, ValueUpdater<Date> valueUpdater)

Called when the user triggers a keydown event with the ENTER key while focused on the cell. If your cell interacts with the user, you should override this method to provide a consistent user experience. Your widget must consume keydown events for this method to be called.

Parameters
context the Context of the cell
parent the parent Element
value the value associated with the cell
event the native browser event
valueUpdater a ValueUpdater, or null if not specified