|
GWT 2.7.0 | |||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||
java.lang.Objectcom.google.gwt.cell.client.AbstractCell<C>
com.google.gwt.cell.client.AbstractEditableCell<java.util.Date,java.util.Date>
com.google.gwt.cell.client.DatePickerCell
public class DatePickerCell
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(com.google.gwt.cell.client.Cell.Context, com.google.gwt.dom.client.Element, java.util.Date, com.google.gwt.dom.client.NativeEvent, com.google.gwt.cell.client.ValueUpdater for the click event. Note that this
means that the call to ValueUpdater.update(C) will occur after onBrowserEvent(com.google.gwt.cell.client.Cell.Context, com.google.gwt.dom.client.Element, java.util.Date, com.google.gwt.dom.client.NativeEvent, com.google.gwt.cell.client.ValueUpdater has returned. Pressing the 'escape' key dismisses the DatePicker popup without calling ValueUpdater.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.
| Nested Class Summary |
|---|
| Nested classes/interfaces inherited from interface com.google.gwt.cell.client.Cell |
|---|
Cell.Context |
| Constructor Summary | |
|---|---|
DatePickerCell()
Constructs a new DatePickerCell that uses the date/time format given by DateTimeFormat.getFullDateFormat(). |
|
DatePickerCell(DateTimeFormat format)
Constructs a new DatePickerCell that uses the given date/time format and a SimpleSafeHtmlRenderer. |
|
DatePickerCell(DateTimeFormat format,
SafeHtmlRenderer<java.lang.String> renderer)
Constructs a new DatePickerCell that uses the given date/time format and SafeHtmlRenderer. |
|
DatePickerCell(SafeHtmlRenderer<java.lang.String> renderer)
Constructs a new DatePickerCell that uses the date/time format given by DateTimeFormat.getFullDateFormat() and the given
SafeHtmlRenderer. |
|
| Method Summary | |
|---|---|
DatePicker |
getDatePicker()
Returns the underlying DatePicker widget used by this cell. |
boolean |
isEditing(Cell.Context context,
Element parent,
java.util.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,
java.util.Date value,
NativeEvent event,
ValueUpdater<java.util.Date> valueUpdater)
Handle a browser event that took place within the cell. |
protected void |
onEnterKeyDown(Cell.Context context,
Element parent,
java.util.Date value,
NativeEvent event,
ValueUpdater<java.util.Date> valueUpdater)
Called when the user triggers a keydown event with the ENTER
key while focused on the cell. |
void |
render(Cell.Context context,
java.util.Date value,
SafeHtmlBuilder sb)
Render a cell as HTML into a SafeHtmlBuilder, suitable for passing
to Element.setInnerHTML(String) on a container element. |
| Methods inherited from class com.google.gwt.cell.client.AbstractEditableCell |
|---|
clearViewData, getViewData, setViewData |
| Methods inherited from class com.google.gwt.cell.client.AbstractCell |
|---|
dependsOnSelection, getConsumedEvents, handlesSelection, resetFocus, setValue |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public DatePickerCell()
DateTimeFormat.getFullDateFormat().
public DatePickerCell(DateTimeFormat format)
SimpleSafeHtmlRenderer.
format - a DateTimeFormat instancepublic DatePickerCell(SafeHtmlRenderer<java.lang.String> renderer)
DateTimeFormat.getFullDateFormat() and the given
SafeHtmlRenderer.
renderer - a SafeHtmlRenderer instance
public DatePickerCell(DateTimeFormat format,
SafeHtmlRenderer<java.lang.String> renderer)
SafeHtmlRenderer.
format - a DateTimeFormat instancerenderer - a SafeHtmlRenderer instance| Method Detail |
|---|
public DatePicker getDatePicker()
DatePicker widget used by this cell.
public boolean isEditing(Cell.Context context,
Element parent,
java.util.Date value)
AbstractEditableCell
isEditing in interface Cell<java.util.Date>isEditing in class AbstractEditableCell<java.util.Date,java.util.Date>context - the Context of the cellparent - the parent Elementvalue - the value associated with the cell
public void onBrowserEvent(Cell.Context context,
Element parent,
java.util.Date value,
NativeEvent event,
ValueUpdater<java.util.Date> valueUpdater)
AbstractCellIf you override this method to add support for events, remember to pass the event types that the cell expects into the constructor.
onBrowserEvent in interface Cell<java.util.Date>onBrowserEvent in class AbstractCell<java.util.Date>context - the Cell.Context of the cellparent - the parent Elementvalue - the value associated with the cellevent - the native browser eventvalueUpdater - a ValueUpdater, or null if not specified
public void render(Cell.Context context,
java.util.Date value,
SafeHtmlBuilder sb)
CellSafeHtmlBuilder, suitable for passing
to Element.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.
render in interface Cell<java.util.Date>render in class AbstractCell<java.util.Date>context - the Cell.Context of the cellvalue - the cell value to be renderedsb - the SafeHtmlBuilder to be written to
protected void onEnterKeyDown(Cell.Context context,
Element parent,
java.util.Date value,
NativeEvent event,
ValueUpdater<java.util.Date> valueUpdater)
AbstractCellkeydown 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.
onEnterKeyDown in class AbstractCell<java.util.Date>context - the Context of the cellparent - the parent Elementvalue - the value associated with the cellevent - the native browser eventvalueUpdater - a ValueUpdater, or null if not specified
|
GWT 2.7.0 | |||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||