public class Calendar extends Canvas implements DataBoundComponent, HasBackgroundClickHandlers, HasBackgroundMouseDownHandlers, HasBackgroundMouseUpHandlers, HasCurrentViewChangedHandlers, HasDateChangedHandlers, HasDayBodyClickHandlers, HasDayHeaderClickHandlers, HasEventAddedHandlers, HasEventChangedHandlers, HasEventClickHandlers, HasEventMovedHandlers, HasEventRemoveClickHandlers, HasEventRemovedHandlers, HasEventRepositionMoveHandlers, HasEventRepositionStopHandlers, HasEventResizedHandlers, HasEventResizeMoveHandlers, HasEventResizeStopHandlers, HasEventHoverHTMLHandlers, HasTimelineEventMovedHandlers, HasTimelineEventResizedHandlers
Calendar module
must be loaded to make use of the Calendar class. CalendarEvents
Events are represented as ordinary JavaScript Objects (see CalendarEvent
). The Calendar expects to be able to read and write a basic set of
properties on events: name, startDate, endDate, description, etc, which can be stored under configurable property
names (see eg startDateField
).
Much like a
ListGrid
manages it's ListGridRecords, the Calendar can either be passed an
ordinary Array of CalendarEvents or can fetch data from a DataSource. When this is the case, if the DataSource does
not contain fields with the configured property names, an attempt is made to auto-detect likely-looking fields from
those that are present. To see logs indicating that this has happened, switch default logging preferences to INFO
level in the Developer Console.
If the calendar is bound to a DataSource, event changes by user action or by calling methods will be saved to the DataSource.
Navigation
The calendar supports a number of views by
default: day
, week
, month
and timeline
. The user can navigate using back and forward
buttons or via an attached DateChooser
.
Event Manipulation
Events can be created by clicking directly onto one of the views, or via the Add Event
button. In the day, week and timeline views,
the user may click and drag to create an event of a specific duration.
Creating an event via click or click and
drag pops up the EventDialog
, which provides a
simple form for quick event entry (for normal events, only the description is required by default - for events that
are shown in a lane
, that field is also required).
A
separate editor called the EventEditor
provides an
interface for editing all possible properties of an event, including custom properties. The EventEditor is used
whenever a pre-existing event is being edited, and can also be invoked by the user wherever the simpler EventDialog
appears.
Events can also be programmatically added
, removed
, or updated
.
config, configOnly, factoryCreated, factoryProperties, id, nativeObject, scClassName
Constructor and Description |
---|
Calendar() |
Calendar(com.google.gwt.core.client.JavaScriptObject jsObj) |
Modifier and Type | Method and Description |
---|---|
com.google.gwt.event.shared.HandlerRegistration |
addBackgroundClickHandler(BackgroundClickHandler handler)
Add a backgroundClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addBackgroundMouseDownHandler(BackgroundMouseDownHandler handler)
Add a backgroundMouseDown handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addBackgroundMouseUpHandler(BackgroundMouseUpHandler handler)
Add a backgroundMouseUp handler.
|
void |
addCalendarEvent(CalendarEvent event)
Create a new event in this calendar.
|
void |
addCalendarEvent(CalendarEvent event,
java.util.Map customValues)
Create a new event in this calendar.
|
com.google.gwt.event.shared.HandlerRegistration |
addCurrentViewChangedHandler(CurrentViewChangedHandler handler)
Add a currentViewChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDateChangedHandler(DateChangedHandler handler)
Add a dateChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDayBodyClickHandler(DayBodyClickHandler handler)
Add a dayBodyClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDayHeaderClickHandler(DayHeaderClickHandler handler)
Add a dayHeaderClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addDragCompleteHandler(DragCompleteHandler handler)
Add a
com.smartgwt.client.widgets.DragCompleteHandler . |
com.google.gwt.event.shared.HandlerRegistration |
addDropCompleteHandler(DropCompleteHandler handler)
Add a
com.smartgwt.client.widgets.DropCompleteHandler . |
void |
addEvent(java.util.Date startDate,
java.util.Date endDate,
java.lang.String name,
java.lang.String description)
Create a new event in this calendar instance.
|
void |
addEvent(java.util.Date startDate,
java.util.Date endDate,
java.lang.String name,
java.lang.String description,
java.util.Map otherFields)
Create a new event in this calendar instance.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventAddedHandler(EventAddedHandler handler)
Add a eventAdded handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventChangedHandler(EventChangedHandler handler)
Add a eventChanged handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventClickHandler(EventClickHandler handler)
Add a eventClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventHoverHTMLHandler(EventHoverHTMLHandler handler)
Deprecated.
Please use setEventHoverHTMLCustomizer instead, this will be removed in a future release.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventMovedHandler(EventMovedHandler handler)
Deprecated.
Please use addEventReposition[Move/Stop]Handler instead, this will be removed in a future release.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventRemoveClickHandler(EventRemoveClickHandler handler)
Add a eventRemoveClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventRemovedHandler(EventRemovedHandler handler)
Add a eventRemoved handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventRepositionMoveHandler(EventRepositionMoveHandler handler)
Add a eventRepositionMove handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventRepositionStopHandler(EventRepositionStopHandler handler)
Add a eventRepositionStop handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventResizedHandler(EventResizedHandler handler)
Deprecated.
Please use addEventResize[Move/Stop]Handler instead, this will be removed in a future release.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventResizeMoveHandler(EventResizeMoveHandler handler)
Add a eventResizeMove handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventResizeStopHandler(EventResizeStopHandler handler)
Add a eventResizeStop handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addFetchDataHandler(FetchDataHandler handler)
Add a fetchData handler.
|
void |
addFormulaField()
Convenience method to display a
com.smartgwt.client..FormulaBuilder to create a new Formula Field. |
void |
addIndicator(CalendarEvent indicator)
Adds a new
indicator to the calendar. |
void |
addLane(Lane lane)
Adds a new
Lane to the calendar, for display in the timeline view , and in the day view if showDayLanes is true. |
void |
addLaneEvent(Lane laneName,
java.util.Date startDate)
Deprecated.
in favor of
addCalendarEvent() |
void |
addLaneEvent(Lane laneName,
java.util.Date startDate,
java.util.Date endDate) |
void |
addLaneEvent(Lane laneName,
java.util.Date startDate,
java.util.Date endDate,
java.lang.String name) |
void |
addLaneEvent(Lane laneName,
java.util.Date startDate,
java.util.Date endDate,
java.lang.String name,
java.lang.String description) |
void |
addLaneEvent(Lane laneName,
java.util.Date startDate,
java.util.Date endDate,
java.lang.String name,
java.lang.String description,
java.lang.Object otherFields)
Deprecated.
in favor of
addCalendarEvent() |
void |
addSummaryField()
Convenience method to display a
com.smartgwt.client..SummaryBuilder to create a new Summary Field. |
com.google.gwt.event.shared.HandlerRegistration |
addTimelineEventMovedHandler(TimelineEventMovedHandler handler)
Deprecated.
Please use addEventReposition[Move/Stop]Handler instead, this will be removed in a future release.
|
com.google.gwt.event.shared.HandlerRegistration |
addTimelineEventResizedHandler(TimelineEventResizedHandler handler)
Deprecated.
Please use addEventResize[Move/Stop]Handler instead, this will be removed in a future release.
|
void |
addZone(CalendarEvent zone)
Adds a new
zone to the calendar. |
java.lang.Boolean |
anySelected()
Whether at least one item is selected
|
static boolean |
calendarLoaded()
Static method indicating whether the optional Calendar module is loaded for the page.
|
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
Canvas defaults)
Changes the defaults for Canvas AutoChildren named
autoChildName . |
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
FormItem defaults)
Changes the defaults for FormItem AutoChildren named
autoChildName . |
protected com.google.gwt.core.client.JavaScriptObject |
create() |
boolean |
dateIsWorkday(java.util.Date date)
Should the parameter date be considered a workday? By default this method tries to find the
parameter date day in
workdays ,
and returns true if found. |
void |
deselectAllRecords()
Deselect all records
|
void |
deselectRecord(int record)
Deselect a
Record passed in explicitly, or by index. |
void |
deselectRecord(Record record)
Deselect a
Record passed in explicitly, or by index. |
void |
deselectRecords(int[] records)
Deselect a list of
Record s passed in explicitly, or by index. |
void |
deselectRecords(Record[] records)
Deselect a list of
Record s passed in explicitly, or by index. |
void |
disableHilite(java.lang.String hiliteID)
Disable a hilite
|
void |
disableHiliting()
Disable all hilites.
|
void |
editFields()
Shows a FieldPicker interface allowing end-users to rearrange the order and visibiility
of the fields in the associated DataBoundComponent.
|
void |
editHilites()
Shows a HiliteEditor interface allowing end-users to edit the data-hilites currently in use by this DataBoundComponent.
|
void |
enableHilite(java.lang.String hiliteID)
Enable / disable a
hilites
|
void |
enableHilite(java.lang.String hiliteID,
boolean enable)
Enable / disable a
hilites
|
void |
enableHiliting()
Enable all hilites.
|
void |
enableHiliting(boolean enable)
Enable all hilites.
|
void |
eventsRendered()
A notification method fired when the events in the current view have been refreshed.
|
void |
exportData()
Uses a "fetch" operation on the current
DataSource
to retrieve data that matches the current filter and sort criteria for this component, then exports the resulting data
to a file or window in the requested format. |
void |
exportData(DSRequest requestProperties)
Uses a "fetch" operation on the current
DataSource
to retrieve data that matches the current filter and sort criteria for this component, then exports the resulting data
to a file or window in the requested format. |
void |
fetchData()
Retrieves data from the DataSource that matches the specified criteria.
|
void |
fetchData(Criteria criteria)
Retrieves data from the DataSource that matches the specified criteria.
|
void |
fetchData(Criteria criteria,
DSCallback callback)
Retrieves data from the DataSource that matches the specified criteria.
|
void |
fetchData(Criteria criteria,
DSCallback callback,
DSRequest requestProperties)
Retrieves data from the DataSource that matches the specified criteria.
|
void |
filterData()
Retrieves data that matches the provided criteria and displays the matching data in this component.
|
void |
filterData(Criteria criteria)
Retrieves data that matches the provided criteria and displays the matching data in this component.
|
void |
filterData(Criteria criteria,
DSCallback callback)
Retrieves data that matches the provided criteria and displays the matching data in this component.
|
void |
filterData(Criteria criteria,
DSCallback callback,
DSRequest requestProperties)
Retrieves data that matches the provided criteria and displays the matching data in this component.
|
Record |
find(AdvancedCriteria adCriteria)
Filters all objects according to the AdvancedCriteria passed and returns the first matching object or null if not found
|
Record[] |
findAll(AdvancedCriteria adCriteria)
Filters all objects according to the AdvancedCriteria passed
|
int |
findIndex(AdvancedCriteria adCriteria)
Finds the index of the first Record that matches with the AdvacendCriteria passed.
|
int |
findNextIndex(int startIndex,
AdvancedCriteria adCriteria)
Like
RecordList.findIndex(java.util.Map) , but considering the startIndex parameter. |
int |
findNextIndex(int startIndex,
AdvancedCriteria adCriteria,
int endIndex)
Like
RecordList.findIndex(java.util.Map) , but considering the startIndex and endIndex parameters. |
java.lang.Integer |
getActiveDay()
Gets the day of the week (0-6) that the mouse is currently over.
|
java.util.Date |
getActiveTime()
Gets a date object representing the date over which the mouse is hovering for the current selected view.
|
java.lang.Boolean |
getAddDropValues()
Indicates whether to add "drop values" to items dropped on this component, if both the source and target widgets are databound, either to the same DataSource or to
different DataSources that are related via a foreign key.
|
ImgButton |
getAddEventButton()
|
java.lang.String |
getAddEventButtonHoverText()
The text to be displayed when a user hovers over the
add event toolbar button |
java.lang.String |
getAddFormulaFieldText()
Text for a menu item allowing users to add a formula field
|
java.lang.String |
getAddOperation()
operationId this component
should use when performing add operations. |
java.lang.String |
getAddSummaryFieldText()
Text for a menu item allowing users to add a formula field
|
java.lang.Boolean |
getAllowDurationEvents()
When set to true, allows events to be managed by duration, as well as by end date.
|
java.lang.Boolean |
getAlternateLaneStyles()
When showing a
Timeline , or a day view when showDayLanes is true, whether to make lane boundaries
more obvious by showing alternate lanes in a different color. |
java.lang.Boolean |
getAutoFetchAsFilter()
If
DataBoundComponent.setAutoFetchData(Boolean) is true, this attribute determines whether the initial fetch operation should be
performed via DataBoundComponent.fetchData() or DataBoundComponent.filterData() |
java.lang.Boolean |
getAutoFetchData()
If true, when this component is first drawn, automatically call
DataBoundComponent.fetchData() or DataBoundComponent.filterData() depending on
DataBoundComponent.getAutoFetchAsFilter() . |
TextMatchStyle |
getAutoFetchTextMatchStyle()
If
autoFetchData is true , this attribute allows the developer to specify a textMatchStyle
for the initial DataBoundComponent.fetchData() call. |
java.lang.String |
getBackButtonTitle()
The title of the
month on Handsets when the month view is the current visible view. |
java.lang.String |
getBaseStyle()
The base name for the CSS class applied to the grid cells of the day and week views of the calendar.
|
java.lang.Boolean |
getBringEventsToFront()
If set to true, clicking an event will bring it to the front of the zorder.
|
java.lang.Boolean |
getCanAddFormulaFields()
Adds an item to the header context menu allowing users to launch a dialog to define a new
field based on values present in other fields, using the
com.smartgwt.client..FormulaBuilder .
|
java.lang.Boolean |
getCanAddSummaryFields()
Adds an item to the header context menu allowing users to launch a dialog to define a new
text field that can contain both user-defined text and the formatted values present in other
fields, using the
com.smartgwt.client..SummaryBuilder .
|
IButton |
getCancelButton()
An
com.smartgwt.client.types.AutoChild of type IButton , used to cancel
editing of an event and close the eventEditor . |
java.lang.String |
getCancelButtonTitle()
The title for the
Cancel button in the event editor . |
java.lang.Boolean |
getCanCreateEvents()
If true, users can create new events.
|
java.lang.Boolean |
getCanDeleteEvents()
Deprecated.
in favor of
canRemoveEvents |
java.lang.Boolean |
getCanDragCreateEvents()
A boolean value controlling whether new events of varying length can be created by dragging the cursor.
|
java.lang.String |
getCanDragEventField()
Name of the field on each
CalendarEvent that determines whether an EventCanvas can be moved or resized by dragging with the mouse. |
java.lang.Boolean |
getCanDragEvents()
A boolean value controlling whether users can drag-reposition events.
|
java.lang.Boolean |
getCanEditEvents()
If true, users can edit existing events.
|
java.lang.String |
getCanEditField()
Name of the field on each
CalendarEvent that determines whether it can be
edited in the event editor . |
java.lang.Boolean |
getCanEditLane()
Can events be moved between lanes? If so, the event can be dragged to a different
lane and, when it's editor is shown, an additional drop-down
widget is provided allowing the user to select a different lane. |
java.lang.String |
getCanEditLaneField()
Name of the field on each
CalendarEvent that determines whether that event
can be moved between lanes. |
java.lang.Boolean |
getCanEditSublane()
Can events be moved between sublanes?
|
java.lang.String |
getCanEditSublaneField()
Name of the field on each
CalendarEvent that determines whether that event
can be moved between individual sublanes in a Lane . |
java.lang.Boolean |
getCanGroupLanes()
If true, allows the lanes in a Timeline to be grouped by providing a value for
laneGroupByField . |
java.lang.Boolean |
getCanRemoveEvents()
If true, users can remove existing events.
|
java.lang.String |
getCanRemoveField()
Name of the field on each
CalendarEvent that determines whether an event
shows a remove button. |
java.lang.Boolean |
getCanReorderLanes()
If true, lanes can be reordered by dragging their
laneFields with the mouse. |
java.lang.String |
getCanResizeEventField()
Name of the field on each
CalendarEvent that determines whether an event
can be resized by dragging. |
java.lang.Boolean |
getCanResizeEvents()
Can
events be resized by dragging appropriate edges of the
canvas ? Only has an effect when both canEditEvents and canDragEvents are true. |
java.lang.Boolean |
getCanResizeTimelineEvents()
Deprecated.
in favor of
canResizeEvents ; |
java.util.Date |
getCellDate()
Return the Date instance associated with the passed co-ordinates in the passed or selected view.
|
java.util.Date |
getCellDate(java.lang.Integer rowNum) |
java.util.Date |
getCellDate(java.lang.Integer rowNum,
java.lang.Integer colNum) |
java.util.Date |
getCellDate(java.lang.Integer rowNum,
java.lang.Integer colNum,
CalendarView view)
Return the Date instance associated with the passed co-ordinates in the passed or selected view.
|
java.lang.String |
getCellHoverHTML(CalendarView view,
Record record,
java.lang.Integer rowNum,
java.lang.Integer colNum,
java.util.Date date,
java.lang.String defaultValue)
Returns the hover HTML for the cell at the passed co-ordinates in the passed view.
|
java.util.Date |
getChosenDate()
The date for which events are displayed in the day, week, and month tabs of the calendar.
|
java.lang.Integer |
getColumnsPerPage()
When using the Next and Previous arrows to scroll a Timeline, this is the number of columns of the
timelineGranularity to scroll by. |
HLayout |
getControlsBar()
An
HLayout shown above the Calendar views and displaying a set of
controls for interacting with the current view - namely, the next , previous and add buttons, the date label and the date-picker icon. |
ViewName |
getCurrentViewName()
The name of the view that should be visible initially by default.
|
CalendarEvent[] |
getData()
A List of CalendarEvent objects, specifying the data to be used to populate the calendar.
|
com.google.gwt.core.client.JavaScriptObject |
getDataAsJSList() |
FetchMode |
getDataFetchMode()
How to fetch and manage records retrieve from the server.
|
int |
getDataPageSize()
When using
data
paging , how many records to fetch at a time. |
DataSource |
getDataSource()
The DataSource that this component should bind to for default fields and for performing
DataSource requests . |
java.lang.String |
getDateCellAlign(java.util.Date date,
java.lang.Integer rowNum,
java.lang.Integer colNum,
CalendarView view)
When
getDateHTML returns a value, this method returns
the horizontal alignment for that value in its cell, in the passed view. |
java.lang.String |
getDateCellVAlign(java.util.Date date,
java.lang.Integer rowNum,
java.lang.Integer colNum,
CalendarView view)
When
getDateHTML returns a value, this method returns
the vertical alignment for that value in its cell, in the passed view. |
DateChooser |
getDateChooser()
DateChooser used to select the date for which events will be displayed. |
java.lang.String |
getDateCSSText(java.util.Date date,
java.lang.Integer rowNum,
java.lang.Integer colNum,
CalendarView view)
Return CSS text for styling the cell associated with the passed date and/or rowNum & colNum, which will be applied in
addition to the CSS class for the cell, as overrides.
|
DateEditingStyle |
getDateEditingStyle()
Indicates the type of controls to use in event-windows.
|
DateDisplayFormat |
getDateFormatter()
Date formatter for displaying events.
|
java.util.Date |
getDateFromPoint()
Returns a Date instance representing the point at the passed offsets into the body of the current view.
|
java.util.Date |
getDateFromPoint(java.lang.Integer x) |
java.util.Date |
getDateFromPoint(java.lang.Integer x,
java.lang.Integer y) |
java.util.Date |
getDateFromPoint(java.lang.Integer x,
java.lang.Integer y,
java.lang.Boolean snapOffsets) |
java.util.Date |
getDateFromPoint(java.lang.Integer x,
java.lang.Integer y,
java.lang.Boolean snapOffsets,
CalendarView view)
Returns a Date instance representing the point at the passed offsets into the body of the current view.
|
java.lang.String |
getDateHeaderTitle(java.util.Date date,
int dayOfWeek,
java.lang.String defaultValue,
CalendarView view)
Return the title text to display in the header-button of the ListGridField showing the passed date, in the passed view.
|
java.lang.String |
getDateHTML(java.util.Date date,
java.lang.Integer rowNum,
java.lang.Integer colNum,
CalendarView view)
Return the HTML to be displayed in the associated date-cell in the passed view.
|
Label |
getDateLabel()
The
com.smartgwt.client.types.AutoChild Label used to display the current
date or range above the selected calendar view. |
java.lang.String |
getDateLabelText(java.lang.String viewName,
java.util.Date startDate,
java.util.Date endDate)
Returns the text to display with the navigation buttons above the Calendar - indicates the visible date range.
|
ImgButton |
getDatePickerButton()
An
ImgButton that appears above the various views of the calendar and
offers alternative access to a DateChooser to pick the current day. |
java.lang.String |
getDatePickerHoverText()
The text to be displayed when a user hovers over the
date picker toolbar button |
java.lang.String |
getDateStyle(java.util.Date date,
java.lang.Integer rowNum,
java.lang.Integer colNum,
CalendarView view)
Return the CSS styleName for the associated date-cell in the passed view.
|
java.lang.String |
getDayBodyBaseStyle()
The base name for the CSS class applied to the day body of the month view of the calendar.
|
protected java.lang.String |
getDayBodyHTML(java.util.Date date,
CalendarEvent[] events,
Calendar calendar,
int rowNum,
int colNum)
Return the HTML to be shown in the body of a day in the month view.
|
java.lang.String |
getDayHeaderBaseStyle()
The base name for the CSS class applied to the day headers of the month view.
|
CalendarView |
getDayView()
CalendarView used to display events that pertain to a given day. |
java.lang.String |
getDayViewTitle()
The title for the
day view . |
java.lang.Boolean |
getDeepCloneOnEdit()
Before we start editing values in this DataBoundComponent, should we perform a deep clone
of the underlying values.
|
int |
getDefaultTimelineColumnSpan()
The number of columns of the
timelineGranularity to give the timeline by default if no endDate is provided. |
java.lang.String |
getDescriptionField()
The name of the description field on a
CalendarEvent . |
java.lang.String |
getDetailsButtonTitle()
The title for the edit button in the quick
quick
event dialog . |
java.lang.Boolean |
getDisableWeekends()
If true, weekend days appear in a disabled style and events cannot be created on weekends.
|
Record[] |
getDragData()
During a drag-and-drop interaction, this method returns the set of records being dragged out of the component.
|
DragDataAction |
getDragDataAction()
Indicates what to do with data dragged into another DataBoundComponent.
|
java.lang.String |
getDragHoverHTML(CalendarView view,
CalendarEvent event,
java.lang.String defaultValue)
Returns the HTML to show in a hover when an existing event is dragged, or when a new event is being created by dragging
with the mouse.
|
java.lang.String |
getDragTrackerStyle()
CSS Style to apply to the drag tracker when dragging occurs on this component.
|
java.util.Map |
getDropValues()
When an item is dropped on this component, and
addDropValues is true and both the source and
target widgets are databound, either to the same DataSource or to different DataSources that are related via a foreign key, this object provides the "drop values" that
Smart GWT will apply to the dropped object before updating it. |
java.lang.String |
getDuplicateDragMessage()
Message to show when a user attempts to transfer duplicate records into this component, and
preventDuplicates
is enabled. |
java.lang.String |
getDurationField()
The name of the
duration field on a CalendarEvent . |
java.lang.String |
getDurationUnitField()
The name of the
durationUnit field on a
CalendarEvent . |
java.lang.String |
getEditFormulaFieldText()
Text for a menu item allowing users to edit a formula field
|
java.lang.String |
getEditSummaryFieldText()
Text for a menu item allowing users to edit the formatter for a field
|
java.util.Date |
getEndDate()
The end date of the calendar timeline view.
|
java.lang.String |
getEndDateField()
The name of the end date field on a
CalendarEvent . |
java.lang.Boolean |
getEventAutoArrange()
If set to true, enables the auto-arrangement of events that share time in the calendar.
|
java.lang.String |
getEventBodyHTML(CalendarEvent event)
Returns the description text for the passed event, for display in the body area of an event canvas.
|
java.lang.String |
getEventBodyHTML(CalendarEvent event,
CalendarView view)
Returns the description text for the passed event, for display in the body area of an event canvas.
|
EventCanvas |
getEventCanvas()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
HLayout |
getEventCanvasButtonLayout()
|
ImgButton |
getEventCanvasCloseButton()
The close button that snaps to the top-right of an event canvas on rollover and allows an event to be removed from a
CalendarView . |
ImgButton |
getEventCanvasContextButton()
The context button that snaps to the top-right of an event canvas on rollover and shows a custom
context menu when clicked. |
Menu |
getEventCanvasContextMenu()
Context menu displayed when an
event canvas is right-clicked,
or when the rollover context button is
clicked. |
Img |
getEventCanvasGripper()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
Img |
getEventCanvasHResizer()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
Label |
getEventCanvasLabel()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
MenuItem[] |
getEventCanvasMenuItems(EventCanvas canvas)
If this method returns a value, it is expected to return an array of
items applicable to the passed canvas and its event. |
java.lang.String |
getEventCanvasStyle(CalendarEvent event)
|
java.lang.String |
getEventCanvasStyle(CalendarEvent event,
CalendarView view)
|
Img |
getEventCanvasVResizer()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
java.lang.String |
getEventDescriptionFieldTitle()
|
Window |
getEventDialog()
An
com.smartgwt.client.types.AutoChild of type Window that displays a quick
event entry form in a popup window. |
java.lang.Integer |
getEventDragGap()
The number of pixels to leave to the right of events so overlapping events can still be added using the mouse.
|
java.lang.String |
getEventDurationFieldTitle()
|
java.lang.String |
getEventDurationUnitFieldTitle()
|
DynamicForm |
getEventEditor()
|
HLayout |
getEventEditorButtonLayout()
An
com.smartgwt.client.types.AutoChild of type HLayout which houses
the Save , Remove and Cancel buttons in the eventEditor . |
Window |
getEventEditorLayout()
|
java.util.Date |
getEventEndDate(CalendarEvent event)
Returns the
end date of the passed event. |
java.lang.String |
getEventEndDateFieldTitle()
|
int |
getEventHeaderHeight()
When
eventHeaderWrap is false and showEventDescriptions is true, this is the the
fixed height for the header area in event
canvases. |
java.lang.String |
getEventHeaderHTML(CalendarEvent event)
Returns the title text for the passed event, for display in the header area of an event canvas.
|
java.lang.String |
getEventHeaderHTML(CalendarEvent event,
CalendarView view)
Returns the title text for the passed event, for display in the header area of an event canvas.
|
boolean |
getEventHeaderWrap()
When rendering the
canvas for an event, whether to
allow the content of the header area to wrap to
multiple lines. |
Lane |
getEventLane(CalendarEvent event)
Returns the
lane associated with the passed event, in the passed view |
Lane |
getEventLane(CalendarEvent event,
CalendarView view)
Returns the
lane associated with the passed event, in the passed view |
java.lang.String |
getEventLaneFieldTitle()
|
void |
getEventLength(CalendarEvent event)
|
void |
getEventLength(CalendarEvent event,
TimeUnit unit)
|
java.lang.String |
getEventNameFieldTitle()
|
java.lang.Boolean |
getEventOverlap()
When
eventAutoArrange is true, setting
eventOverlap to true causes events that share timeslots to overlap each other by a percentage of their width, specified
by eventOverlapPercent . |
java.lang.Boolean |
getEventOverlapIdenticalStartTimes()
When set to true, events that start at the same time will not overlap each other to prevent events having their close
button hidden.
|
int |
getEventOverlapPercent()
The size of the overlap, presented as a percentage of the width of events sharing timeslots.
|
java.lang.Integer |
getEventSnapGap()
Determines the number of minutes by which an event can be moved or resized when dragging.
|
java.util.Date |
getEventStartDate(CalendarEvent event)
Returns the
start date of the passed event. |
java.lang.String |
getEventStartDateFieldTitle()
|
java.lang.String |
getEventStyleName()
The base name for the CSS class applied to
events
when they're rendered in calendar views. |
java.lang.String |
getEventStyleNameField()
The name of the field used to override
eventStyleName for an individual CalendarEvent.styleName . |
Lane |
getEventSublane(CalendarEvent event)
Returns the
sublane associated with the passed event, in
the passed view |
Lane |
getEventSublane(CalendarEvent event,
CalendarView view)
Returns the
sublane associated with the passed event, in
the passed view |
java.lang.String |
getEventSublaneFieldTitle()
|
EventWindow |
getEventWindow()
Deprecated.
in favor of
eventCanvas |
java.lang.String |
getEventWindowStyle()
Deprecated.
in favor of
eventStyleName |
java.lang.String |
getEventWindowStyleField()
Deprecated.
in favor of
eventStyleNameField |
java.lang.Boolean |
getExportAll()
Setting exportAll to true prevents the component from passing its list of fields to the
export call.
|
java.lang.String[] |
getExportFields()
The list of field-names to export.
|
java.lang.String |
getFetchOperation()
Operation ID this component should use when performing fetch operations.
|
Alignment[] |
getFieldAlignments()
Returna an array of field alignments for this grid
|
int |
getFieldCount()
Return the number of fields.
|
com.google.gwt.core.client.JavaScriptObject[] |
getFieldsAsJavaScriptObjects()
Return the fields as JavaScriptObjects rather than as SmartGWT Java wrappers of the field
class type
(e.g.
|
java.lang.Integer |
getFirstDayOfWeek()
The numeric day (0-6) which the calendar should consider as the first day of the week - if unset, the default is taken
from the current locale.
|
java.lang.String |
getHeaderHoverHTML(CalendarView view,
HeaderLevel headerLevel,
java.util.Date startDate,
java.util.Date endDate,
java.lang.String defaultValue)
Returns the hover HTML to show in a hover when the mouse moves over the header area.
|
HeaderLevel[] |
getHeaderLevels()
Configures the levels of
headers shown above the event area,
and their time units. |
java.lang.Boolean |
getHideUnusedLanes()
When set to true, hides any
lane that doesn't have any
active events in the current dataset. |
java.lang.String |
getHiliteProperty()
Marker that can be set on a record to flag that record as hilited.
|
Hilite[] |
getHilites()
Return the set of hilite-objects currently applied to this DataBoundComponent.
|
java.lang.String |
getHiliteState()
Get the current hilites encoded as a String, for saving.
|
IndicatorCanvas |
getIndicatorCanvas()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
java.lang.String |
getIndicatorCanvasStyle(CalendarEvent indicator)
|
java.lang.String |
getIndicatorCanvasStyle(CalendarEvent indicator,
CalendarView view)
|
java.lang.String |
getIndicatorHoverHTML(CalendarEvent indicator,
IndicatorCanvas indicatorCanvas,
CalendarView view,
java.lang.String defaultValue)
Gets the hover HTML for an
indicator being hovered
over. |
CalendarEvent[] |
getIndicators()
An array of CalendarEvent instances representing instants in time, to be highlighted in
timeline views . |
java.lang.String |
getIndicatorStyleName()
|
Criteria |
getInitialCriteria()
Criteria to use when
DataBoundComponent.setAutoFetchData(Boolean) is used. |
java.lang.String |
getInvalidDateMessage()
The message to display in the
eventEditor when the
'To' date is greater than the 'From' date and a save is attempted. |
Lane |
getLane(java.lang.String lane)
Returns the
lane with the passed name, in the passed view |
Lane |
getLane(java.lang.String lane,
CalendarView view)
Returns the
lane with the passed name, in the passed view |
java.lang.Integer |
getLaneEventPadding()
|
CalendarEvent[] |
getLaneEvents(Lane lane)
For views that support
lanes , returns the array of events
in the current dataset that apply to the passed lane in the passed or current view. |
CalendarEvent[] |
getLaneEvents(Lane lane,
CalendarView view)
For views that support
lanes , returns the array of events
in the current dataset that apply to the passed lane in the passed or current view. |
CalendarEvent[] |
getLaneEvents(java.lang.String lane)
For views that support
lanes , returns the array of events
in the current dataset that apply to the passed lane in the passed or current view. |
ListGridField[] |
getLaneFields()
Field definitions for the frozen area of the
timelineView , which shows data about the timeline lanes . |
Lane |
getLaneFromPoint()
Returns the
Lane at the passed co-ordinates. |
Lane |
getLaneFromPoint(java.lang.Integer x) |
Lane |
getLaneFromPoint(java.lang.Integer x,
java.lang.Integer y) |
Lane |
getLaneFromPoint(java.lang.Integer x,
java.lang.Integer y,
CalendarView view)
Returns the
Lane at the passed co-ordinates. |
java.lang.String |
getLaneGroupByField()
For timelines with
canGroupLanes set to true,
this is a field name or array of field names on which to group the lanes in a timeline. |
java.lang.String[] |
getLaneGroupByFieldAsString()
For timelines with
canGroupLanes set to true,
this is a field name or array of field names on which to group the lanes in a timeline. |
java.lang.String |
getLaneNameField()
The name of the field which will determine the
lane in
which this event will be displayed in Timeline s and in the day view , if showDayLanes is true. |
java.lang.Integer |
getLanePadding()
For views that support
lanes , returns the padding to
apply to events rendered in lanes in the passed or current view. |
java.lang.Integer |
getLanePadding(CalendarView view)
For views that support
lanes , returns the padding to
apply to events rendered in lanes in the passed or current view. |
Lane[] |
getLanes()
An array of
Lane definitions that represent the rows of the timelineView , or the columns of the dayView if showDayLanes is true. |
java.lang.String |
getLeadingDateField()
The name of the leading date field for each event.
|
com.smartgwt.logicalstructure.core.LogicalStructureObject |
getLogicalStructure()
Getter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
TabSet |
getMainView()
|
boolean |
getMinimalUI()
A boolean value controlling whether the Calendar shows tabs for available calendar views.
|
java.lang.Integer |
getMinimumDayHeight()
In the
month view when showDayHeaders is true, this is the minimum height
applied to a day cell and its header combined. |
java.lang.Integer |
getMinLaneWidth()
When showing
vertical lanes in the dayView , this attribute sets the minimum width of each column
or field. |
java.lang.Integer |
getMinutesPerRow()
|
NavigationButton |
getMonthButton()
A
NavigationButton that appears to the left of other navigation controls in the
controls bar on Handset devices. |
java.lang.String |
getMonthButtonTitle()
The title of the
month button , used for showing and
hiding the month view on Handsets. |
java.lang.String |
getMonthMoreEventsLinkTitle()
The title of the link shown in a cell of a
month view
when there are too many events to be displayed at once. |
Menu |
getMonthMoreEventsMenu()
AutoChild Menu, shown when a user clicks the
more events link in a cell of the monthView . |
CalendarView |
getMonthView()
CalendarView used to display events that pertain to a given month. |
java.lang.String |
getMonthViewHoverHTML(java.util.Date date,
CalendarEvent... events)
This method returns the hover HTML to be displayed when the user hovers over a cell displayed in the calendar month view
tab.
|
java.lang.String |
getMonthViewTitle()
The title for the
month view . |
java.lang.String |
getNameField()
The name of the name field on a
CalendarEvent . |
ImgButton |
getNextButton()
An
ImgButton that appears above the week/day/month views of the calendar and allows
the user to move the calendar forwards in time. |
java.lang.String |
getNextButtonHoverText()
The text to be displayed when a user hovers over the
next toolbar button |
static Calendar |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
java.lang.String |
getOtherDayBlankStyle()
The CSS style applied to both the header and body of days from other months in the
month view , when showOtherDays is false. |
java.lang.String |
getOtherDayBodyBaseStyle()
The base name for the CSS class applied to the day body of the month view of the calendar.
|
java.lang.String |
getOtherDayHeaderBaseStyle()
The base name for the CSS class applied to the day headers of the month view.
|
SortSpecifier[] |
getOverlapSortSpecifiers()
A set of
sort-specifiers for customizing the render order of events that
overlap. |
java.util.Date |
getPeriodEndDate()
Returns the end of the period selected in the passed, or current, calendar view.
|
java.util.Date |
getPeriodEndDate(CalendarView view)
Returns the end of the period selected in the passed, or current, calendar view.
|
java.util.Date |
getPeriodStartDate()
Returns the start of the selected week or month depending on the current calendar view.
|
java.util.Date |
getPeriodStartDate(CalendarView view)
Returns the start of the selected week or month depending on the current calendar view.
|
java.lang.Boolean |
getPreventDuplicates()
If set, detect and prevent duplicate records from being transferred to this component, either via
drag and drop or via
DataBoundComponent.transferSelectedData(com.smartgwt.client.widgets.DataBoundComponent) . |
ImgButton |
getPreviousButton()
An
ImgButton that appears above the week/day/month views of the calendar and allows
the user to move the calendar backwards in time. |
java.lang.String |
getPreviousButtonHoverText()
The text to be displayed when a user hovers over the
previous toolbar button. |
java.lang.Boolean |
getProgressiveLoading()
Indicates whether or not this component will load its data
progressively |
int |
getRecordIndex(Record record)
Get the index of the provided record.
|
RecordList |
getRecordList()
Return the underlying data of this DataBoundComponent as a
RecordList . |
IButton |
getRemoveButton()
An
com.smartgwt.client.types.AutoChild of type IButton , used to permanently
remove an event from the eventEditor . |
java.lang.String |
getRemoveButtonTitle()
The title for the
Remove button in the event editor . |
java.lang.String |
getRemoveOperation()
operationId this component
should use when performing remove operations. |
ResultSet |
getResultSet()
Return the underlying data of this DataBoundComponent as a
ResultSet . |
int |
getRowHeight()
The height of time-slots in the calendar.
|
java.lang.Integer |
getRowTitleFrequency()
|
IButton |
getSaveButton()
|
java.lang.String |
getSaveButtonTitle()
|
java.lang.Boolean |
getScrollToWorkday()
If set, causes the
workday hours to be sized to
fill the available space in the day view and week view, and automatically scrolls these views to the start of the
workday when the calendar is first displayed and whenever the user switches to a new day or week. |
java.lang.Boolean |
getSelectChosenDate()
When true, shows the current
chosenDate in a
selected style in the month view Has no effect in
other views. |
java.lang.String |
getSelectedCellStyle()
The base name for the CSS class applied to a cell that is selected via a mouse drag.
|
CalendarView |
getSelectedView()
Returns the currently selected
view . |
java.lang.Boolean |
getShowAddEventButton()
Set to false to hide the
Add Event button. |
java.lang.Boolean |
getShowCellHovers()
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse rolls over the normal cells in the body of CalendarViews. |
java.lang.Boolean |
getShowComplexFields()
Whether to show fields of non-atomic types when a DataBoundComponent is given a
DataSource but no
component.fields .
|
java.lang.Boolean |
getShowControlsBar()
If false the controls bar at the top of the calendar will not be displayed - this means that the
controlsBar will be hidden, so the autoChildren (previousButton , dateLabel , nextButton , addEventButton , and datePickerButton ) will not be created or shown. |
java.lang.Boolean |
getShowDateChooser()
Determines whether the
dateChooser is displayed. |
java.lang.Boolean |
getShowDatePickerButton()
Set to false to hide the
datePickerButton that
allows selecting a new base date for this Calendar. |
java.lang.Boolean |
getShowDayHeaders()
If true, the default, show a header cell for each day cell in the
month view , with both cells having a minimum combined height
of minimumDayHeight . |
java.lang.Boolean |
getShowDayLanes()
|
java.lang.Boolean |
getShowDetailFields()
Whether to show fields marked
detail:true when a DataBoundComponent is given a DataSource but no
component.fields . |
java.lang.Boolean |
getShowDragHovers()
When
showViewHovers is true, dictates whether to
display hover prompts when an event is being dragged with the mouse. |
boolean |
getShowEventDescriptions()
When rendering the
canvas for an event, whether to
show the body area , typically containing brief
details of the event - by default , its description . |
boolean |
getShowEventHeaders()
When rendering the
canvas for an event, whether to
show the header area , typically containing
suitable title text - by default , the event's
name . |
java.lang.Boolean |
getShowEventHovers()
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse moves over an event canvas
in a calendarView. |
java.lang.Boolean |
getShowHeaderHovers()
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse rolls over the header levels in a CalendarView . |
java.lang.Boolean |
getShowHiddenFields()
Whether to show fields marked
hidden:true when a DataBoundComponent is given a
DataSource but no component.fields .
|
java.lang.Boolean |
getShowIndicators()
Set to true to render any defined
indicators into
timeline views . |
boolean |
getShowIndicatorsInFront()
In
indicator lines are showing, this attribute
affects where in the z-order their canvases will be rendered: either in front of, or behind normal calendar events. |
java.lang.Boolean |
getShowLaneFieldHovers()
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse moves over the cells in a laneField . |
java.lang.Boolean |
getShowLaneRollOver()
When set to true, causes
Timelines , and day views with showDayLanes set, to highlight the Lane under the mouse
with the "Over" style. |
java.lang.Boolean |
getShowMonthButton()
Set to false to prevent the
Month button from
displaying on Handset devices. |
java.lang.Boolean |
getShowNextButton()
Set to false to hide the
Next button. |
java.lang.Boolean |
getShowOtherDays()
If set to true, in the
month view , days that fall in
an adjacent month are still shown with a header and body area, and are interactive. |
java.lang.Boolean |
getShowPreviousButton()
Set to false to hide the
Previous button. |
java.lang.Boolean |
getShowQuickEventDialog()
Determines whether the quick event dialog is displayed when a time is clicked.
|
java.lang.Boolean |
getShowTimelineView()
If set to true, show the
Timeline view . |
java.lang.Boolean |
getShowViewHovers()
When set to true, the default value, causes the Calendar to show customizable hovers when the mouse moves over various
areas of a CalendarView.
|
java.lang.Boolean |
getShowWeekends()
|
java.lang.Boolean |
getShowWorkday()
If set, causes the calendar to use
workdayBaseStyle for cells falling within the workday as defined by workdayStart and workdayEnd , in both the weekView and dayView . |
java.lang.Boolean |
getShowZoneHovers()
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse moves over a zone in
a calendarView. |
java.lang.Boolean |
getShowZones()
Set to true to render any defined
zones into timeline views . |
java.lang.Boolean |
getSizeEventsToGrid()
If true, events will be sized to the grid, even if they start and/or end at times between grid cells.
|
java.util.Date |
getStartDate()
The start date of the calendar
timeline view . |
java.lang.String |
getStartDateField()
The name of the start date field on a
CalendarEvent . |
Lane |
getSublane(java.lang.String lane,
java.lang.String sublane)
|
Lane |
getSublane(java.lang.String lane,
java.lang.String sublane,
CalendarView view)
|
CalendarEvent[] |
getSublaneEvents(Lane lane,
Lane sublane)
|
CalendarEvent[] |
getSublaneEvents(Lane lane,
Lane sublane,
CalendarView view)
|
Lane |
getSublaneFromPoint()
Returns the
sublane at the passed co-ordinates. |
Lane |
getSublaneFromPoint(java.lang.Integer x) |
Lane |
getSublaneFromPoint(java.lang.Integer x,
java.lang.Integer y) |
Lane |
getSublaneFromPoint(java.lang.Integer x,
java.lang.Integer y,
CalendarView view)
Returns the
sublane at the passed co-ordinates. |
java.lang.String |
getSublaneNameField()
The name of the field which will determine the
sublane in
which this event will be displayed, within its parent Lane, in Timeline s
and in the day view , if showDayLanes is true. |
TimeDisplayFormat |
getTimeFormatter()
Display format to use for the time portion of events' date information.
|
TimeUnit |
getTimelineGranularity()
The granularity in which the
timelineView will
display events. |
int |
getTimelineUnitsPerColumn()
How many units of
timelineGranularity each
cell represents. |
CalendarView |
getTimelineView()
CalendarView used to display events in lanes in a horizontal Timeline view. |
java.lang.String |
getTimelineViewTitle()
The title for the
timeline view . |
java.lang.String |
getTitleField()
Method to return the fieldName which represents the "title" for records in this
Component.
If this.titleField is explicitly specified it will always be used. Otherwise, default implementation will check titleField for databound
components.For non databound components returns the first defined field name of "title" ,
"name" , or "id" . |
java.lang.String |
getTitleFieldValue(Record record)
Get the value of the titleField for the passed record
|
java.lang.String |
getTodayBackgroundColor()
The background color for cells that represent today in all
CalendarView s. |
java.lang.String |
getTrailingDateField()
The name of the trailing date field for each event.
|
java.lang.Boolean |
getTwentyFourHourTime()
If set to true, causes the
eventEditor to hide the
AM/PM picker and provide the full 24-hour range in the hour picker. |
java.lang.String |
getUpdateOperation()
operationId this component
should use when performing update operations. |
java.lang.Boolean |
getUseAllDataSourceFields()
If true, the set of fields given by the "default binding" (see
fields ) is used, with any fields specified in
component.fields acting as overrides that can suppress or modify the
display of individual fields, without having to list the entire set of fields that
should be shown.
|
boolean |
getUseEventCanvasRolloverControls()
By default, the
close buttons and the
horizontal and vertical resizer widgets for event canvases are
shown only when the mouse is over a given event. |
java.lang.Boolean |
getUseFlatFields()
The
useFlatFields flag causes all simple type fields anywhere in a nested
set of DataSources to be exposed as a flat list for form binding. |
java.lang.Boolean |
getUseSublanes()
|
CalendarView |
getView(ViewName viewName)
|
java.util.Date |
getVisibleEndDate()
Returns the last visible date in the passed, or currently selected, calendar view.
|
java.util.Date |
getVisibleEndDate(CalendarView view)
Returns the last visible date in the passed, or currently selected, calendar view.
|
java.util.Date |
getVisibleStartDate()
Returns the first visible date in the passed, or currently selected, calendar view.
|
java.util.Date |
getVisibleStartDate(CalendarView view)
Returns the first visible date in the passed, or currently selected, calendar view.
|
int[] |
getWeekendDays()
An array of integer day-numbers that should be considered to be weekend days by this Calendar instance.
|
java.lang.Boolean |
getWeekEventBorderOverlap()
Augments the width of week event windows slightly to avoid duplicate adjacent borders between events.
|
java.lang.String |
getWeekPrefix()
The text to appear before the week number in the title of
week-based HeaderLevel s when this calendar is showing a timeline. |
CalendarView |
getWeekView()
CalendarView used to display events that pertain to a given week. |
java.lang.String |
getWeekViewTitle()
The title for the
week view . |
java.lang.String |
getWorkdayBaseStyle()
If
showWorkday is set, this is the style used for
cells that are within the workday, as defined by workdayStart and workdayEnd , or by a date-specific
range provided in getWorkdayStart() and getWorkdayEnd() implementations. |
java.lang.String |
getWorkdayEnd(java.util.Date date)
When using
showWorkday :true,
workdayStart and workdayEnd specify the time of day when the workday starts and ends,
specified as a String acceptable to String. |
java.lang.String |
getWorkdayStart(java.util.Date date)
When using
showWorkday :true,
workdayStart and workdayEnd specify the time of day when the workday starts and ends,
specified as a String acceptable to String. |
ZoneCanvas |
getZoneCanvas()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
java.lang.String |
getZoneCanvasStyle(CalendarEvent zone)
|
java.lang.String |
getZoneCanvasStyle(CalendarEvent zone,
CalendarView view)
|
java.lang.String |
getZoneHoverHTML(CalendarEvent zone,
ZoneCanvas zoneCanvas,
CalendarView view,
java.lang.String defaultValue)
Gets the hover HTML for a
zone being hovered over. |
CalendarEvent[] |
getZones()
An array of CalendarEvent instances representing pre-defined periods of time to be highlighted in
timeline views . |
java.lang.String |
getZoneStyleName()
|
VerticalAlignment |
getZoneTitleOrientation()
The vertical alignment of the header-text in each
zone . |
void |
groupLanesBy(java.lang.String... groupFieldName)
When
canGroupLanes is true, this method allows
the grouping in timeline s to be altered at
runtime. |
void |
groupLanesBy(java.lang.String groupFieldName)
When
canGroupLanes is true, this method allows
the grouping in timeline s to be altered at
runtime. |
void |
invalidateCache()
Invalidate the current data cache for this databound component via a call to the dataset's
invalidateCache() method, for example,
ResultSet.invalidateCache() . |
void |
moveToEvent(CalendarEvent event)
Rests the current visible range of a calendar view so that it shows the date on which the passed event occurs.
|
void |
next()
Move to the next day, week, or month, depending on which tab is selected.
|
protected void |
onInit_Calendar() |
protected void |
onInit() |
void |
previous()
Move to the previous day, week, month, or timeline range depending on which tab is selected.
|
void |
refreshEvent(CalendarEvent event)
Refreshes the passed event in the current view.
|
void |
removeEvent(CalendarEvent event)
Remove an event from this calendar.
|
void |
removeIndicator(CalendarEvent indicator)
Removes a
indicator from the calendar. |
void |
removeIndicator(java.lang.String indicator)
Removes a
indicator from the calendar. |
void |
removeLane(Lane lane)
Removes a lane from the calendar in
timelineView
mode. |
void |
removeLane(java.lang.String laneName)
Removes a lane from the calendar in
timelineView
mode. |
void |
removeZone(CalendarEvent zone)
Removes a
zone from the calendar. |
void |
removeZone(java.lang.String zone)
Removes a
zone from the calendar. |
void |
scrollToTime(java.lang.String time)
Scroll the calendar Day or Week views to the specified time.
|
void |
selectAllRecords()
Select all records
|
void |
selectRecord(int record)
Select/deselect a
Record passed in explicitly, or by index. |
void |
selectRecord(int record,
boolean newState)
Select/deselect a
Record passed in explicitly, or by index. |
void |
selectRecord(Record record)
Select/deselect a
Record passed in explicitly, or by index. |
void |
selectRecord(Record record,
boolean newState)
Select/deselect a
Record passed in explicitly, or by index. |
void |
selectRecords(int[] records)
Select/deselect a list of
Record s passed in explicitly, or by index. |
void |
selectRecords(int[] records,
boolean newState)
Select/deselect a list of
Record s passed in explicitly, or by index. |
void |
selectRecords(Record[] records)
Select/deselect a list of
Record s passed in explicitly, or by index. |
void |
selectRecords(Record[] records,
boolean newState)
Select/deselect a list of
Record s passed in explicitly, or by index. |
void |
selectTab(int tabnum)
Selects the calendar view in the passed tab number.
|
void |
setAddDropValues(java.lang.Boolean addDropValues)
Indicates whether to add "drop values" to items dropped on this component, if both the source and target widgets are databound, either to the same DataSource or to
different DataSources that are related via a foreign key.
|
void |
setAddEventButtonHoverText(java.lang.String addEventButtonHoverText)
The text to be displayed when a user hovers over the
add event toolbar button |
void |
setAddFormulaFieldText(java.lang.String addFormulaFieldText)
Text for a menu item allowing users to add a formula field
|
void |
setAddOperation(java.lang.String addOperation)
operationId this component
should use when performing add operations. |
void |
setAddSummaryFieldText(java.lang.String addSummaryFieldText)
Text for a menu item allowing users to add a formula field
|
void |
setAllowDurationEvents(java.lang.Boolean allowDurationEvents)
When set to true, allows events to be managed by duration, as well as by end date.
|
void |
setAlternateLaneStyles(java.lang.Boolean alternateLaneStyles)
When showing a
Timeline , or a day view when showDayLanes is true, whether to make lane boundaries
more obvious by showing alternate lanes in a different color. |
void |
setAutoFetchAsFilter(java.lang.Boolean autoFetchAsFilter)
If
DataBoundComponent.setAutoFetchData(Boolean) is true, this attribute determines whether the initial fetch operation should be
performed via DataBoundComponent.fetchData() or DataBoundComponent.filterData() |
void |
setAutoFetchData(java.lang.Boolean autoFetchData)
If true, when this component is first drawn, automatically call
DataBoundComponent.fetchData() or DataBoundComponent.filterData() depending on
DataBoundComponent.getAutoFetchAsFilter() . |
void |
setAutoFetchTextMatchStyle(TextMatchStyle autoFetchTextMatchStyle)
If
autoFetchData is true , this attribute allows the developer to specify a textMatchStyle
for the initial DataBoundComponent.fetchData() call. |
void |
setBackButtonTitle(java.lang.String backButtonTitle)
The title of the
month on Handsets when the month view is the current visible view. |
void |
setBaseStyle(java.lang.String baseStyle)
The base name for the CSS class applied to the grid cells of the day and week views of the calendar.
|
void |
setBringEventsToFront(java.lang.Boolean bringEventsToFront)
If set to true, clicking an event will bring it to the front of the zorder.
|
void |
setCanAddFormulaFields(java.lang.Boolean canAddFormulaFields)
Adds an item to the header context menu allowing users to launch a dialog to define a new
field based on values present in other fields, using the
com.smartgwt.client..FormulaBuilder .
|
void |
setCanAddSummaryFields(java.lang.Boolean canAddSummaryFields)
Adds an item to the header context menu allowing users to launch a dialog to define a new
text field that can contain both user-defined text and the formatted values present in other
fields, using the
com.smartgwt.client..SummaryBuilder .
|
void |
setCancelButtonTitle(java.lang.String cancelButtonTitle)
The title for the
Cancel button in the event editor . |
void |
setCanCreateEvents(java.lang.Boolean canCreateEvents)
If true, users can create new events.
|
void |
setCanDeleteEvents(java.lang.Boolean canDeleteEvents)
Deprecated.
in favor of
canRemoveEvents |
void |
setCanDragCreateEvents(java.lang.Boolean canDragCreateEvents)
A boolean value controlling whether new events of varying length can be created by dragging the cursor.
|
void |
setCanDragEventField(java.lang.String canDragEventField)
Name of the field on each
CalendarEvent that determines whether an EventCanvas can be moved or resized by dragging with the mouse. |
void |
setCanDragEvents(java.lang.Boolean canDragEvents)
A boolean value controlling whether users can drag-reposition events.
|
void |
setCanEditEvents(java.lang.Boolean canEditEvents)
If true, users can edit existing events.
|
void |
setCanEditField(java.lang.String canEditField)
Name of the field on each
CalendarEvent that determines whether it can be
edited in the event editor . |
void |
setCanEditLane(java.lang.Boolean canEditLane)
Can events be moved between lanes? If so, the event can be dragged to a different
lane and, when it's editor is shown, an additional drop-down
widget is provided allowing the user to select a different lane. |
void |
setCanEditLaneField(java.lang.String canEditLaneField)
Name of the field on each
CalendarEvent that determines whether that event
can be moved between lanes. |
void |
setCanEditSublane(java.lang.Boolean canEditSublane)
Can events be moved between sublanes?
|
void |
setCanEditSublaneField(java.lang.String canEditSublaneField)
Name of the field on each
CalendarEvent that determines whether that event
can be moved between individual sublanes in a Lane . |
void |
setCanGroupLanes(java.lang.Boolean canGroupLanes)
If true, allows the lanes in a Timeline to be grouped by providing a value for
laneGroupByField . |
void |
setCanRemoveEvents(java.lang.Boolean canRemoveEvents)
If true, users can remove existing events.
|
void |
setCanRemoveField(java.lang.String canRemoveField)
Name of the field on each
CalendarEvent that determines whether an event
shows a remove button. |
void |
setCanReorderLanes(java.lang.Boolean canReorderLanes)
If true, lanes can be reordered by dragging their
laneFields with the mouse. |
void |
setCanResizeEventField(java.lang.String canResizeEventField)
Name of the field on each
CalendarEvent that determines whether an event
can be resized by dragging. |
void |
setCanResizeEvents(java.lang.Boolean canResizeEvents)
Can
events be resized by dragging appropriate edges of the
canvas ? Only has an effect when both canEditEvents and canDragEvents are true. |
void |
setCanResizeTimelineEvents(java.lang.Boolean canResizeTimelineEvents)
Deprecated.
in favor of
canResizeEvents ; |
void |
setCellHoverCustomizer(CellHoverCustomizer customizer)
Customize the Hover text to display when the mouse hovers over cells in a CalendarView
|
void |
setChosenDate(java.util.Date chosenDate)
The date for which events are displayed in the day, week, and month tabs of the calendar.
|
void |
setColumnsPerPage(java.lang.Integer columnsPerPage)
When using the Next and Previous arrows to scroll a Timeline, this is the number of columns of the
timelineGranularity to scroll by. |
void |
setCurrentViewName(ViewName currentViewName)
The name of the view that should be visible initially by default.
|
void |
setData(CalendarEvent[] data)
A List of CalendarEvent objects, specifying the data to be used to populate the calendar.
|
void |
setData(Record[] data)
An array of Record objects, specifying the data to be used to populate the DataBoundComponent.
|
void |
setData(RecordList data)
An List of Record objects, specifying the data to be used to populate the DataBoundComponent.
|
void |
setDataFetchMode(FetchMode dataFetchMode)
How to fetch and manage records retrieve from the server.
|
void |
setDataPageSize(int dataPageSize)
When using
data
paging , how many records to fetch at a time. |
void |
setDataSource(DataSource dataSource)
The DataSource that this component should bind to for default fields and for performing
DataSource requests . |
void |
setDataSource(java.lang.String dataSource)
The DataSource that this component should bind to for default fields and for performing
DataSource requests . |
void |
setDateCellAlignCustomizer(DateCellAlignCustomizer customizer)
This method installs a customizer that returns the horizontsal Alignment to display in the passed date-cell when rendered in the passed view
|
void |
setDateCellVAlignCustomizer(DateCellVAlignCustomizer customizer)
This method installs a customizer that returns the VerticalAlignment to display in the passed date-cell when rendered in the passed view
|
void |
setDateCSSTextCustomizer(DateCSSTextCustomizer customizer)
This method returns the CSS class name for the passed event when rendered in the passed view
|
void |
setDateEditingStyle(DateEditingStyle dateEditingStyle)
Indicates the type of controls to use in event-windows.
|
void |
setDateFormatter(DateDisplayFormat dateFormatter)
Date formatter for displaying events.
|
void |
setDateHeaderCustomizer(DateHeaderCustomizer customizer)
This method installs a customizer to determine the HTML to be displayed in the header for a given date column in a CalendarView
|
void |
setDateHTMLCustomizer(DateHTMLCustomizer customizer)
This method installs a customizer that returns the HTML to display in the passed date-cell when rendered in the passed view
|
void |
setDatePickerHoverText(java.lang.String datePickerHoverText)
The text to be displayed when a user hovers over the
date picker toolbar button |
void |
setDateStyleCustomizer(DateStyleCustomizer customizer)
This method installs a customizer that returns the CSS class name for the passed date-cell when rendered in the passed view
|
void |
setDayBodyBaseStyle(java.lang.String dayBodyBaseStyle)
The base name for the CSS class applied to the day body of the month view of the calendar.
|
void |
setDayHeaderBaseStyle(java.lang.String dayHeaderBaseStyle)
The base name for the CSS class applied to the day headers of the month view.
|
void |
setDayViewTitle(java.lang.String dayViewTitle)
The title for the
day view . |
void |
setDeepCloneOnEdit(java.lang.Boolean deepCloneOnEdit)
Before we start editing values in this DataBoundComponent, should we perform a deep clone
of the underlying values.
|
static void |
setDefaultProperties(Calendar calendarProperties)
Class level method to set the default properties of this class.
|
void |
setDefaultTimelineColumnSpan(int defaultTimelineColumnSpan)
The number of columns of the
timelineGranularity to give the timeline by default if no endDate is provided. |
void |
setDescriptionField(java.lang.String descriptionField)
The name of the description field on a
CalendarEvent . |
void |
setDetailsButtonTitle(java.lang.String detailsButtonTitle)
The title for the edit button in the quick
quick
event dialog . |
void |
setDisableDateCustomizer(DisableDateCustomizer customizer)
Return true from the customizer to have the passed event considered disabled in the passed view
|
void |
setDisableWeekends(java.lang.Boolean disableWeekends)
If true, weekend days appear in a disabled style and events cannot be created on weekends.
|
void |
setDragDataAction(DragDataAction dragDataAction)
Indicates what to do with data dragged into another DataBoundComponent.
|
void |
setDragHoverCustomizer(DragHoverCustomizer customizer)
Customize the Hover text to display during a drag operation
|
void |
setDragTrackerStyle(java.lang.String dragTrackerStyle)
CSS Style to apply to the drag tracker when dragging occurs on this component.
|
void |
setDropValues(java.util.Map dropValues)
When an item is dropped on this component, and
addDropValues is true and both the source and
target widgets are databound, either to the same DataSource or to different DataSources that are related via a foreign key, this object provides the "drop values" that
Smart GWT will apply to the dropped object before updating it. |
void |
setDuplicateDragMessage(java.lang.String duplicateDragMessage)
Message to show when a user attempts to transfer duplicate records into this component, and
preventDuplicates
is enabled. |
void |
setDurationField(java.lang.String durationField)
The name of the
duration field on a CalendarEvent . |
void |
setDurationUnitField(java.lang.String durationUnitField)
The name of the
durationUnit field on a
CalendarEvent . |
void |
setEditFormulaFieldText(java.lang.String editFormulaFieldText)
Text for a menu item allowing users to edit a formula field
|
void |
setEditSummaryFieldText(java.lang.String editSummaryFieldText)
Text for a menu item allowing users to edit the formatter for a field
|
void |
setEndDate(java.util.Date endDate)
The end date of the calendar timeline view.
|
void |
setEndDateField(java.lang.String endDateField)
The name of the end date field on a
CalendarEvent . |
void |
setEventAutoArrange(java.lang.Boolean eventAutoArrange)
If set to true, enables the auto-arrangement of events that share time in the calendar.
|
void |
setEventBodyHTMLCustomizer(EventBodyHTMLCustomizer customizer)
This method installs a customizer that returns the HTML to be used as the body/description for the passed event.
|
void |
setEventCanvasGripperIconCustomizer(EventCanvasGripperIconCustomizer customizer)
This method returns the SCImgURL for the icon to use as the gripper for a given EventCanvas
|
void |
setEventCanvasHoverHTMLCustomizer(EventCanvasHoverHTMLCustomizer customizer)
This method returns the hover HTML to be displayed when the user hovers over an eventCanvas
|
void |
setEventDescriptionFieldTitle(java.lang.String eventDescriptionFieldTitle)
|
void |
setEventDialogCustomizer(EventDialogCustomizer customizer)
Customizer called whenever the Calender needs to show an EventDialog, to edit or view a CalendarEvent
|
void |
setEventDialogFields(FormItem... eventDialogFields)
The set of fields for the
eventDialog . |
void |
setEventDragGap(java.lang.Integer eventDragGap)
The number of pixels to leave to the right of events so overlapping events can still be added using the mouse.
|
void |
setEventDurationFieldTitle(java.lang.String eventDurationFieldTitle)
|
void |
setEventDurationUnitFieldTitle(java.lang.String eventDurationUnitFieldTitle)
|
void |
setEventEditorCustomizer(EventEditorCustomizer customizer)
Customizer called whenever the Calender needs to show an EventEditor, to edit or create a CalendarEvent
|
void |
setEventEditorFields(FormItem... eventEditorFields)
The set of fields for the
eventEditor . |
void |
setEventEndDateFieldTitle(java.lang.String eventEndDateFieldTitle)
|
void |
setEventHeaderHeight(int eventHeaderHeight)
When
eventHeaderWrap is false and showEventDescriptions is true, this is the the
fixed height for the header area in event
canvases. |
void |
setEventHeaderHTMLCustomizer(EventHeaderHTMLCustomizer customizer)
This method returns the HTML to be used as the header/title for the passed event.
|
void |
setEventHeaderWrap(boolean eventHeaderWrap)
When rendering the
canvas for an event, whether to
allow the content of the header area to wrap to
multiple lines. |
void |
setEventHoverHTMLCustomizer(EventHoverHTMLCustomizer eventHoverHTMLCustomizer)
This method returns the hover HTML to be displayed when the user hovers over an event
|
void |
setEventLaneFieldTitle(java.lang.String eventLaneFieldTitle)
|
void |
setEventNameFieldTitle(java.lang.String eventNameFieldTitle)
|
void |
setEventOverlap(java.lang.Boolean eventOverlap)
When
eventAutoArrange is true, setting
eventOverlap to true causes events that share timeslots to overlap each other by a percentage of their width, specified
by eventOverlapPercent . |
void |
setEventOverlapIdenticalStartTimes(java.lang.Boolean eventOverlapIdenticalStartTimes)
When set to true, events that start at the same time will not overlap each other to prevent events having their close
button hidden.
|
void |
setEventOverlapPercent(int eventOverlapPercent)
The size of the overlap, presented as a percentage of the width of events sharing timeslots.
|
void |
setEventSnapGap(java.lang.Integer eventSnapGap)
Determines the number of minutes by which an event can be moved or resized when dragging.
|
void |
setEventStartDateFieldTitle(java.lang.String eventStartDateFieldTitle)
|
void |
setEventStyle(CalendarEvent event,
java.lang.String styleName)
Update the styleName for the passed event.
|
void |
setEventStyleName(java.lang.String eventStyleName)
The base name for the CSS class applied to
events
when they're rendered in calendar views. |
void |
setEventStyleNameField(java.lang.String eventStyleNameField)
The name of the field used to override
eventStyleName for an individual CalendarEvent.styleName . |
void |
setEventSublaneFieldTitle(java.lang.String eventSublaneFieldTitle)
|
void |
setEventWindowStyle(java.lang.String eventWindowStyle)
Deprecated.
in favor of
eventStyleName |
void |
setEventWindowStyleField(java.lang.String eventWindowStyleField)
Deprecated.
in favor of
eventStyleNameField |
void |
setExportAll(java.lang.Boolean exportAll)
Setting exportAll to true prevents the component from passing its list of fields to the
export call.
|
void |
setExportFields(java.lang.String[] exportFields)
The list of field-names to export.
|
void |
setFetchOperation(java.lang.String fetchOperation)
Operation ID this component should use when performing fetch operations.
|
void |
setFields(com.google.gwt.core.client.JavaScriptObject... fields)
Field setter variant (alternative to
setFields(FormItem...) ,
setFields(ListGridField...) ,
etc.) that will accept an array of JavaScriptObject, rather than an array of SmartGWT
Java wrappers of the field class type (e.g. |
void |
setFirstDayOfWeek(java.lang.Integer firstDayOfWeek)
The numeric day (0-6) which the calendar should consider as the first day of the week - if unset, the default is taken
from the current locale.
|
void |
setHeaderHoverCustomizer(HeaderLevelHoverCustomizer customizer)
Customize the Hover text for a given span in a HeaderLevel.
|
void |
setHeaderLevels(HeaderLevel... headerLevels)
Configures the levels of
headers shown above the event area,
and their time units. |
void |
setHideUnusedLanes(java.lang.Boolean hideUnusedLanes)
When set to true, hides any
lane that doesn't have any
active events in the current dataset. |
void |
setHiliteProperty(java.lang.String hiliteProperty)
Marker that can be set on a record to flag that record as hilited.
|
void |
setHilites(Hilite[] hilites)
Accepts an array of hilite objects and applies them to this DataBoundComponent.
|
void |
setHiliteState(java.lang.String hiliteState)
Set the current hilites based on a hiliteState String previously returned from getHilitesState.
|
void |
setIndicatorHoverHTMLCustomizer(IndicatorHoverHTMLCustomizer indicatorHoverHTMLCustomizer)
This method returns the hover HTML to be displayed when the user hovers over an IndicatorCanvas
|
void |
setIndicators(CalendarEvent... indicators)
An array of CalendarEvent instances representing instants in time, to be highlighted in
timeline views . |
void |
setIndicatorStyleName(java.lang.String indicatorStyleName)
|
void |
setInitialCriteria(Criteria initialCriteria)
Criteria to use when
DataBoundComponent.setAutoFetchData(Boolean) is used. |
void |
setInvalidDateMessage(java.lang.String invalidDateMessage)
The message to display in the
eventEditor when the
'To' date is greater than the 'From' date and a save is attempted. |
void |
setLaneEventPadding(java.lang.Integer laneEventPadding)
|
void |
setLaneFields(ListGridField... laneFields)
Field definitions for the frozen area of the
timelineView , which shows data about the timeline lanes . |
void |
setLaneGroupByField(java.lang.String... laneGroupByField)
For timelines with
canGroupLanes set to true,
this is a field name or array of field names on which to group the lanes in a timeline. |
void |
setLaneGroupByField(java.lang.String laneGroupByField)
For timelines with
canGroupLanes set to true,
this is a field name or array of field names on which to group the lanes in a timeline. |
void |
setLaneGroupStartOpen(GroupStartOpen group) |
void |
setLaneGroupStartOpen(java.lang.Object... groupValues) |
void |
setLaneNameField(java.lang.String laneNameField)
The name of the field which will determine the
lane in
which this event will be displayed in Timeline s and in the day view , if showDayLanes is true. |
void |
setLanes(Lane... lanes)
An array of
Lane definitions that represent the rows of the timelineView , or the columns of the dayView if showDayLanes is true. |
void |
setLeadingDateField(java.lang.String leadingDateField)
The name of the leading date field for each event.
|
com.smartgwt.logicalstructure.core.LogicalStructureObject |
setLogicalStructure(com.smartgwt.logicalstructure.widgets.calendar.CalendarLogicalStructure s)
Setter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
void |
setMinimalUI(boolean minimalUI)
A boolean value controlling whether the Calendar shows tabs for available calendar views.
|
void |
setMinimumDayHeight(java.lang.Integer minimumDayHeight)
In the
month view when showDayHeaders is true, this is the minimum height
applied to a day cell and its header combined. |
void |
setMinLaneWidth(java.lang.Integer minLaneWidth)
When showing
vertical lanes in the dayView , this attribute sets the minimum width of each column
or field. |
void |
setMinutesPerRow(java.lang.Integer minutesPerRow)
|
void |
setMonthButtonTitle(java.lang.String monthButtonTitle)
The title of the
month button , used for showing and
hiding the month view on Handsets. |
void |
setMonthMoreEventsLinkTitle(java.lang.String monthMoreEventsLinkTitle)
The title of the link shown in a cell of a
month view
when there are too many events to be displayed at once. |
void |
setMonthViewHoverHTMLCustomizer(MonthViewHoverHTMLCustomizer monthViewHoverHTMLCustomizer)
This method returns the hover HTML to be displayed when the user hovers over a cell displayed in the calendar month view tab.
|
void |
setMonthViewTitle(java.lang.String monthViewTitle)
The title for the
month view . |
void |
setNameField(java.lang.String nameField)
The name of the name field on a
CalendarEvent . |
void |
setNextButtonHoverText(java.lang.String nextButtonHoverText)
The text to be displayed when a user hovers over the
next toolbar button |
void |
setOtherDayBlankStyle(java.lang.String otherDayBlankStyle)
The CSS style applied to both the header and body of days from other months in the
month view , when showOtherDays is false. |
void |
setOtherDayBodyBaseStyle(java.lang.String otherDayBodyBaseStyle)
The base name for the CSS class applied to the day body of the month view of the calendar.
|
void |
setOtherDayHeaderBaseStyle(java.lang.String otherDayHeaderBaseStyle)
The base name for the CSS class applied to the day headers of the month view.
|
void |
setOverlapSortSpecifiers(SortSpecifier... overlapSortSpecifiers)
A set of
sort-specifiers for customizing the render order of events that
overlap. |
void |
setPreventDuplicates(java.lang.Boolean preventDuplicates)
If set, detect and prevent duplicate records from being transferred to this component, either via
drag and drop or via
DataBoundComponent.transferSelectedData(com.smartgwt.client.widgets.DataBoundComponent) . |
void |
setPreviousButtonHoverText(java.lang.String previousButtonHoverText)
The text to be displayed when a user hovers over the
previous toolbar button. |
void |
setProgressiveLoading(java.lang.Boolean progressiveLoading)
Indicates whether or not this component will load its data
progressively |
void |
setRemoveButtonTitle(java.lang.String removeButtonTitle)
The title for the
Remove button in the event editor . |
void |
setRemoveOperation(java.lang.String removeOperation)
operationId this component
should use when performing remove operations. |
void |
setResolution(HeaderLevel[] headerLevels,
TimeUnit unit,
java.lang.Integer unitCount)
Reset the resolution, the header levels and scrollable range, of the timeline view.
|
void |
setResolution(HeaderLevel[] headerLevels,
TimeUnit unit,
java.lang.Integer unitCount,
java.lang.Integer granularityPerColumn)
Reset the resolution, the header levels and scrollable range, of the timeline view.
|
void |
setRowHeight(int rowHeight)
The height of time-slots in the calendar.
|
void |
setRowTitleFrequency(java.lang.Integer rowTitleFrequency)
|
void |
setSaveButtonTitle(java.lang.String saveButtonTitle)
|
void |
setScrollToWorkday(java.lang.Boolean scrollToWorkday)
If set, causes the
workday hours to be sized to
fill the available space in the day view and week view, and automatically scrolls these views to the start of the
workday when the calendar is first displayed and whenever the user switches to a new day or week. |
void |
setSelectChosenDate(java.lang.Boolean selectChosenDate)
When true, shows the current
chosenDate in a
selected style in the month view Has no effect in
other views. |
void |
setSelectedCellStyle(java.lang.String selectedCellStyle)
The base name for the CSS class applied to a cell that is selected via a mouse drag.
|
void |
setShowAddEventButton(java.lang.Boolean showAddEventButton)
Set to false to hide the
Add Event button. |
void |
setShowCellHovers(java.lang.Boolean showCellHovers)
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse rolls over the normal cells in the body of CalendarViews. |
void |
setShowComplexFields(java.lang.Boolean showComplexFields)
Whether to show fields of non-atomic types when a DataBoundComponent is given a
DataSource but no
component.fields .
|
void |
setShowControlsBar(java.lang.Boolean showControlsBar)
If false the controls bar at the top of the calendar will not be displayed - this means that the
controlsBar will be hidden, so the autoChildren (previousButton , dateLabel , nextButton , addEventButton , and datePickerButton ) will not be created or shown. |
void |
setShowDateChooser(java.lang.Boolean showDateChooser)
Determines whether the
dateChooser is displayed. |
void |
setShowDateCustomizer(ShowDateCustomizer customizer)
This method is called during rendering for all events in the visible range - those which
would be rendered by default.
|
void |
setShowDatePickerButton(java.lang.Boolean showDatePickerButton)
Set to false to hide the
datePickerButton that
allows selecting a new base date for this Calendar. |
void |
setShowDayHeaders(java.lang.Boolean showDayHeaders)
If true, the default, show a header cell for each day cell in the
month view , with both cells having a minimum combined height
of minimumDayHeight . |
void |
setShowDayLanes(java.lang.Boolean showDayLanes)
|
void |
setShowDayView(java.lang.Boolean showDayView) |
void |
setShowDetailFields(java.lang.Boolean showDetailFields)
Whether to show fields marked
detail:true when a DataBoundComponent is given a DataSource but no
component.fields . |
void |
setShowDragHovers(java.lang.Boolean showDragHovers)
When
showViewHovers is true, dictates whether to
display hover prompts when an event is being dragged with the mouse. |
void |
setShowEventCustomizer(ShowEventCustomizer customizer)
Return false from the customizer to prevent the passed CalendarEvent from being rendered in the
passed view.
|
void |
setShowEventDescriptions(boolean showEventDescriptions)
When rendering the
canvas for an event, whether to
show the body area , typically containing brief
details of the event - by default , its description . |
void |
setShowEventHeaders(boolean showEventHeaders)
When rendering the
canvas for an event, whether to
show the header area , typically containing
suitable title text - by default , the event's
name . |
void |
setShowEventHovers(java.lang.Boolean showEventHovers)
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse moves over an event canvas
in a calendarView. |
void |
setShowHeaderHovers(java.lang.Boolean showHeaderHovers)
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse rolls over the header levels in a CalendarView . |
void |
setShowHiddenFields(java.lang.Boolean showHiddenFields)
Whether to show fields marked
hidden:true when a DataBoundComponent is given a
DataSource but no component.fields .
|
void |
setShowIndicators(java.lang.Boolean showIndicators)
Set to true to render any defined
indicators into
timeline views . |
void |
setShowIndicatorsInFront(boolean showIndicatorsInFront)
In
indicator lines are showing, this attribute
affects where in the z-order their canvases will be rendered: either in front of, or behind normal calendar events. |
void |
setShowLaneCustomizer(ShowLaneCustomizer customizer)
Return false from the customizer to prevent the passed Lane from being rendered in the
passed view.
|
void |
setShowLaneFieldHovers(java.lang.Boolean showLaneFieldHovers)
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse moves over the cells in a laneField . |
void |
setShowLaneRollOver(java.lang.Boolean showLaneRollOver)
When set to true, causes
Timelines , and day views with showDayLanes set, to highlight the Lane under the mouse
with the "Over" style. |
void |
setShowMonthButton(java.lang.Boolean showMonthButton)
Set to false to prevent the
Month button from
displaying on Handset devices. |
void |
setShowMonthView(java.lang.Boolean showMonthView) |
void |
setShowNextButton(java.lang.Boolean showNextButton)
Set to false to hide the
Next button. |
void |
setShowOtherDays(java.lang.Boolean showOtherDays)
If set to true, in the
month view , days that fall in
an adjacent month are still shown with a header and body area, and are interactive. |
void |
setShowPreviousButton(java.lang.Boolean showPreviousButton)
Set to false to hide the
Previous button. |
void |
setShowQuickEventDialog(java.lang.Boolean showQuickEventDialog)
Determines whether the quick event dialog is displayed when a time is clicked.
|
void |
setShowTimelineView(java.lang.Boolean showTimelineView)
If set to true, show the
Timeline view . |
void |
setShowViewHovers(java.lang.Boolean showViewHovers)
When set to true, the default value, causes the Calendar to show customizable hovers when the mouse moves over various
areas of a CalendarView.
|
void |
setShowWeekends(java.lang.Boolean showWeekends)
|
void |
setShowWeekView(java.lang.Boolean showWeekView) |
void |
setShowWorkday(java.lang.Boolean showWorkday)
If set, causes the calendar to use
workdayBaseStyle for cells falling within the workday as defined by workdayStart and workdayEnd , in both the weekView and dayView . |
void |
setShowZoneHovers(java.lang.Boolean showZoneHovers)
When
showViewHovers is true, dictates whether to
display hover prompts when the mouse moves over a zone in
a calendarView. |
void |
setShowZones(java.lang.Boolean showZones)
Set to true to render any defined
zones into timeline views . |
void |
setSizeEventsToGrid(java.lang.Boolean sizeEventsToGrid)
If true, events will be sized to the grid, even if they start and/or end at times between grid cells.
|
void |
setStartDate(java.util.Date startDate)
The start date of the calendar
timeline view . |
void |
setStartDateField(java.lang.String startDateField)
The name of the start date field on a
CalendarEvent . |
void |
setSublaneNameField(java.lang.String sublaneNameField)
The name of the field which will determine the
sublane in
which this event will be displayed, within its parent Lane, in Timeline s
and in the day view , if showDayLanes is true. |
void |
setTimeFormatter(TimeDisplayFormat timeFormatter)
Display format to use for the time portion of events' date information.
|
void |
setTimeFormatter(TimeFormatter timeFormatter)
Deprecated.
use
setTimeFormatter(TimeDisplayFormat) instead. |
void |
setTimelineGranularity(TimeUnit timelineGranularity)
The granularity in which the
timelineView will
display events. |
void |
setTimelineRange(java.util.Date start)
Sets the range over which the timeline will display events.
|
void |
setTimelineRange(java.util.Date start,
java.util.Date end)
Sets the range over which the timeline will display events.
|
void |
setTimelineUnitsPerColumn(int timelineUnitsPerColumn)
How many units of
timelineGranularity each
cell represents. |
void |
setTimelineViewTitle(java.lang.String timelineViewTitle)
The title for the
timeline view . |
void |
setTitleField(java.lang.String titleField)
Sets the best field to use for a user-visible title for an individual record from this component.
|
void |
setTodayBackgroundColor(java.lang.String todayBackgroundColor)
The background color for cells that represent today in all
CalendarView s. |
void |
setTrailingDateField(java.lang.String trailingDateField)
The name of the trailing date field for each event.
|
void |
setTwentyFourHourTime(java.lang.Boolean twentyFourHourTime)
If set to true, causes the
eventEditor to hide the
AM/PM picker and provide the full 24-hour range in the hour picker. |
void |
setUpdateOperation(java.lang.String updateOperation)
operationId this component
should use when performing update operations. |
void |
setUseAllDataSourceFields(java.lang.Boolean useAllDataSourceFields)
If true, the set of fields given by the "default binding" (see
fields ) is used, with any fields specified in
component.fields acting as overrides that can suppress or modify the
display of individual fields, without having to list the entire set of fields that
should be shown.
|
void |
setUseEventCanvasRolloverControls(boolean useEventCanvasRolloverControls)
By default, the
close buttons and the
horizontal and vertical resizer widgets for event canvases are
shown only when the mouse is over a given event. |
void |
setUseFlatFields(java.lang.Boolean useFlatFields)
The
useFlatFields flag causes all simple type fields anywhere in a nested
set of DataSources to be exposed as a flat list for form binding. |
void |
setUseSublanes(java.lang.Boolean useSublanes)
|
void |
setWeekendDays(int... weekendDays)
An array of integer day-numbers that should be considered to be weekend days by this Calendar instance.
|
void |
setWeekEventBorderOverlap(java.lang.Boolean weekEventBorderOverlap)
Augments the width of week event windows slightly to avoid duplicate adjacent borders between events.
|
void |
setWeekPrefix(java.lang.String weekPrefix)
The text to appear before the week number in the title of
week-based HeaderLevel s when this calendar is showing a timeline. |
void |
setWeekViewTitle(java.lang.String weekViewTitle)
The title for the
week view . |
void |
setWorkdayBaseStyle(java.lang.String workdayBaseStyle)
If
showWorkday is set, this is the style used for
cells that are within the workday, as defined by workdayStart and workdayEnd , or by a date-specific
range provided in getWorkdayStart() and getWorkdayEnd() implementations. |
void |
setWorkdayEnd(java.lang.String workdayEnd)
When using
showWorkday :true,
workdayStart and workdayEnd specify the time of day when the workday starts and ends,
specified as a String acceptable to String. |
void |
setWorkdays(int[] workdays)
Array of days that are considered workdays when
showWorkday is true |
void |
setWorkdayStart(java.lang.String workdayStart)
When using
showWorkday :true,
workdayStart and workdayEnd specify the time of day when the workday starts and ends,
specified as a String acceptable to String. |
void |
setZoneHoverHTMLCustomizer(ZoneHoverHTMLCustomizer zoneHoverHTMLCustomizer)
This method returns the hover HTML to be displayed when the user hovers over an ZoneCanvas
|
void |
setZones(CalendarEvent... zones)
An array of CalendarEvent instances representing pre-defined periods of time to be highlighted in
timeline views . |
void |
setZoneStyleName(java.lang.String zoneStyleName)
|
void |
setZoneTitleOrientation(VerticalAlignment zoneTitleOrientation)
The vertical alignment of the header-text in each
zone . |
boolean |
shouldDisableDate(java.util.Date date)
Returns true if the passed date should be considered disabled.
|
boolean |
shouldDisableDate(java.util.Date date,
CalendarView view)
Returns true if the passed date should be considered disabled.
|
boolean |
shouldShowDate(java.util.Date date)
Indicates whether the passed date should be visible in the passed
CalendarView . |
boolean |
shouldShowDate(java.util.Date date,
CalendarView view)
Indicates whether the passed date should be visible in the passed
CalendarView . |
boolean |
shouldShowEvent(CalendarEvent event)
Indicates whether the passed
event should be visible in the
passed CalendarView . |
boolean |
shouldShowEvent(CalendarEvent event,
CalendarView view)
Indicates whether the passed
event should be visible in the
passed CalendarView . |
boolean |
shouldShowLane(Lane lane)
Indicates whether the passed
lane should be visible in
the passed CalendarView . |
boolean |
shouldShowLane(Lane lane,
CalendarView view)
Indicates whether the passed
lane should be visible in
the passed CalendarView . |
boolean |
shouldShowLane(java.lang.String lane)
Indicates whether the passed
lane should be visible in
the passed CalendarView . |
void |
showEventDialog()
Open the Quick Event dialog showing minimal information about an existing
event . |
void |
showEventDialog(CalendarEvent event) |
void |
showEventDialog(CalendarEvent event,
java.lang.Boolean isNewEvent)
Open the Quick Event dialog showing minimal information about an existing
event . |
void |
showEventEditor()
Show an Event Editor for the passed event.
|
void |
showEventEditor(CalendarEvent event) |
void |
showEventEditor(CalendarEvent event,
java.lang.Boolean isNewEvent)
Show an Event Editor for the passed event.
|
void |
showNewEventDialog()
Open the Quick Event dialog to begin editing a new
event . |
void |
showNewEventDialog(CalendarEvent event)
Open the Quick Event dialog to begin editing a new
event . |
void |
showNewEventEditor()
Show an Event Editor for a new event.
|
void |
showNewEventEditor(CalendarEvent event)
Show an Event Editor for a new event.
|
void |
transferSelectedData(DataBoundComponent source)
Simulates a drag / drop type transfer of the selected records in some other component to this component, without requiring any user interaction.
|
void |
transferSelectedData(DataBoundComponent source,
int index)
Simulates a drag / drop type transfer of the selected records in some other component to this component, without requiring any user interaction.
|
void |
updateCalendarEvent(CalendarEvent event,
CalendarEvent newEvent,
java.util.Map otherFields)
Update an event in this calendar.
|
void |
updateEvent(CalendarEvent event,
java.util.Date startDate,
java.util.Date endDate,
java.lang.String name,
java.lang.String description)
update an event in this calendar.
|
addChild, addChild, addChild, addChild, addChild, addClickHandler, addDoubleClickHandler, addDragMoveHandler, addDragRepositionMoveHandler, addDragRepositionStartHandler, addDragRepositionStopHandler, addDragResizeMoveHandler, addDragResizeStartHandler, addDragResizeStopHandler, addDragStartHandler, addDragStopHandler, addDropHandler, addDropMoveHandler, addDropOutHandler, addDropOverHandler, addFocusChangedHandler, addHoverHandler, addHoverHiddenHandler, addKeyDownHandler, addKeyPressHandler, addMouseDownHandler, addMouseMoveHandler, addMouseOutHandler, addMouseOverHandler, addMouseStillDownHandler, addMouseUpHandler, addMouseWheelHandler, addMovedHandler, addParentMovedHandler, addPeer, addPeer, addPeer, addPeer, addResizedHandler, addRightMouseDownHandler, addScrolledHandler, addShowContextMenuHandler, addSnapAlignCandidate, addStyleName, addVisibilityChangedHandler, adjustForContent, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateHide, animateHide, animateHide, animateMove, animateMove, animateMove, animateMove, animateRect, animateRect, animateRect, animateRect, animateResize, animateResize, animateResize, animateResize, animateScroll, animateScroll, animateScroll, animateScroll, animateScroll, animateScroll, animateShow, animateShow, animateShow, animateShow, animateShow, animateShow, asSGWTComponent, blur, bringToFront, clear, clickMaskUp, clickMaskUp, contains, contains, containsEvent, containsFocus, containsPoint, containsPoint, deparent, depeer, disable, enable, encloses, focus, focusInNextTabElement, focusInPreviousTabElement, getAbsoluteLeft, getAbsoluteTop, getAccessKey, getAlwaysShowScrollbars, getAnimateAcceleration, getAnimateFadeTime, getAnimateHideAcceleration, getAnimateHideTime, getAnimateMoveAcceleration, getAnimateMoveTime, getAnimateRectAcceleration, getAnimateRectTime, getAnimateResizeAcceleration, getAnimateResizeTime, getAnimateScrollAcceleration, getAnimateScrollTime, getAnimateShowAcceleration, getAnimateShowEffect, getAnimateShowTime, getAnimateTime, getAppImgDir, getAriaRole, getAutoDraw, getAutoMaskComponents, getAutoShowParent, getBackgroundColor, getBackgroundImage, getBackgroundPosition, getBackgroundRepeat, getBorder, getBottom, getById, getByJSObject, getByLocalId, getCanAcceptDrop, getCanDrag, getCanDragReposition, getCanDragResize, getCanDragScroll, getCanDrop, getCanDropBefore, getCanFocus, getCanHover, getCanSelectText, getCanvasAutoChild, getCanvasItem, getChildren, getChildrenResizeSnapAlign, getChildrenSnapAlign, getChildrenSnapCenterAlign, getChildrenSnapEdgeAlign, getChildrenSnapResizeToGrid, getChildrenSnapToGrid, getClassName, getComponentMask, getComponentMaskDefaults, getContentElement, getContents, getContextMenu, getCursor, getDataPath, getDefaultHeight, getDefaultWidth, getDestroyed, getDestroying, getDisabled, getDisabledCursor, getDisableTouchScrollingForDrag, getDoubleClickDelay, getDragAppearance, getDragIntersectStyle, getDragMaskType, getDragOpacity, getDragRepositionAppearance, getDragRepositionCursor, getDragResizeAppearance, getDragScrollDelay, getDragStartDistance, getDragTarget, getDragType, getDropTypes, getDropTypesAsString, getDynamicContents, getEdgeBackgroundColor, getEdgeCenterBackgroundColor, getEdgeImage, getEdgeMarginSize, getEdgeOffset, getEdgeOpacity, getEdgeShowCenter, getEdgeSize, getEditNode, getEditProxy, getEditProxyConstructor, getElement, getElement, getEventEdge, getEventEdge, getExtraSpace, getFacetId, getFormItemAutoChild, getFullDataPath, getGroupBorderCSS, getGroupLabelBackgroundColor, getGroupLabelStyleName, getGroupTitle, getHeight, getHeightAsString, getHideUsingDisplayNone, getHoverAlign, getHoverAutoDestroy, getHoverComponent, getHoverDelay, getHoverHeight, getHoverHTML, getHoverMoveWithMouse, getHoverOpacity, getHoverStyle, getHoverVAlign, getHoverWidth, getHoverWrap, getHSnapOrigin, getHSnapOrigin, getHSnapPosition, getHSnapPosition, getHtmlElement, getHtmlPosition, getImage, getImgURL, getImgURL, getInnerContentHeight, getInnerContentWidth, getInnerHeight, getInnerWidth, getIsGroup, getIsPrinting, getIsSnapAlignCandidate, getKeepInParentRect, getLayoutAlign, getLeavePageSpace, getLeft, getLeftAsString, getLocateChildrenBy, getLocateChildrenType, getLocatePeersBy, getLocatePeersType, getMargin, getMasterCanvas, getMasterElement, getMatchElement, getMaxHeight, getMaxWidth, getMenuConstructor, getMinHeight, getMinNonEdgeSize, getMinWidth, getMomentumScrollMinSpeed, getMouseStillDownDelay, getMouseStillDownInitialDelay, getNextZIndex, getNoDoubleClicks, getNoDropCursor, getOffsetHeight, getOffsetWidth, getOffsetX, getOffsetY, getOpacity, getOuterElement, getOverflow, getPadding, getPageBottom, getPageLeft, getPageRect, getPageRight, getPageTop, getPanelContainer, getParentCanvas, getParentElement, getPeers, getPercentBox, getPercentSource, getPosition, getPrefix, getPrintChildrenAbsolutelyPositioned, getPrintHTML, getPrintHTML, getPrompt, getProportionalResizeModifiers, getProportionalResizing, getRect, getRedrawOnResize, getResizeBarTarget, getResizeFrom, getRight, getScrollbarSize, getScrollBottom, getScrollHeight, getScrollLeft, getScrollRight, getScrollTop, getScrollWidth, getShadowDepth, getShadowImage, getShadowOffset, getShadowSoftness, getShouldPrint, getShowCustomScrollbars, getShowDragShadow, getShowEdges, getShowHover, getShowHoverComponents, getShowResizeBar, getShowShadow, getShowSnapGrid, getShrinkElementOnHide, getSkinImgDir, getSnapAlignCandidates, getSnapAlignCenterLineStyle, getSnapAlignEdgeLineStyle, getSnapAxis, getSnapEdge, getSnapHDirection, getSnapHGap, getSnapOffsetLeft, getSnapOffsetTop, getSnapOnDrop, getSnapPosition, getSnapPosition, getSnapResizeToAlign, getSnapResizeToGrid, getSnapTo, getSnapToAlign, getSnapToCenterAlign, getSnapToEdgeAlign, getSnapToGrid, getSnapVDirection, getSnapVGap, getStyleName, getTabIndex, getTestInstance, getTitle, getTooltip, getTop, getTopAsString, getTopElement, getUseBackMask, getUseDragMask, getUseNativeDrag, getUseOpacityFilter, getUseTouchScrolling, getValuesManager, getViewportHeight, getViewportWidth, getVisibility, getVisibleHeight, getVisibleWidth, getVSnapOrigin, getVSnapOrigin, getVSnapPosition, getVSnapPosition, getWidth, getWidthAsString, getZIndex, getZIndex, handleHover, hide, hideClickMask, hideClickMask, hideComponentMask, hideComponentMask, hideContextMenu, imgHTML, imgHTML, imgHTML, intersects, isDirty, isDisabled, isDrawn, isFocused, isVisible, keyUp, layoutChildren, linkHTML, linkHTML, linkHTML, linkHTML, linkHTML, linkHTML, markForDestroy, markForRedraw, markForRedraw, moveAbove, moveBelow, moveBy, moveTo, onAttach, onDetach, pageScrollDown, pageScrollUp, parentResized, placeNear, placeNear, placeNear, printComponents, provideRuleContext, redraw, redraw, removeChild, removeChild, removePeer, removePeer, removeSnapAlignCandidate, resizeBy, resizeTo, resizeTo, revealChild, revealChild, scrollBy, scrollByPercent, scrollTo, scrollTo, scrollTo, scrollToBottom, scrollToLeft, scrollToPercent, scrollToRight, scrollToTop, sendToBack, setAccessKey, setAlign, setAllowExternalFilters, setAlwaysShowScrollbars, setAnimateAcceleration, setAnimateFadeTime, setAnimateHideAcceleration, setAnimateHideTime, setAnimateMoveAcceleration, setAnimateMoveTime, setAnimateRectAcceleration, setAnimateRectTime, setAnimateResizeAcceleration, setAnimateResizeTime, setAnimateScrollAcceleration, setAnimateScrollTime, setAnimateShowAcceleration, setAnimateShowEffect, setAnimateShowTime, setAnimateTime, setAppImgDir, setAriaRole, setAriaState, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoDraw, setAutoHeight, setAutoMaskComponents, setAutoShowParent, setAutoWidth, setBackgroundColor, setBackgroundImage, setBackgroundPosition, setBackgroundRepeat, setBorder, setBottom, setCanAcceptDrop, setCanDrag, setCanDragReposition, setCanDragResize, setCanDragScroll, setCanDrop, setCanDropBefore, setCanFocus, setCanHover, setCanSelectText, setChildren, setChildrenResizeSnapAlign, setChildrenSnapAlign, setChildrenSnapCenterAlign, setChildrenSnapEdgeAlign, setChildrenSnapResizeToGrid, setChildrenSnapToGrid, setComponentMaskDefaults, setContents, setContextMenu, setCursor, setDataPath, setDefaultHeight, setDefaultPageSpace, setDefaultProperties, setDefaultWidth, setDisabled, setDisabledCursor, setDisableTouchScrollingForDrag, setDoubleClickDelay, setDragAppearance, setDragIntersectStyle, setDragMaskType, setDragOpacity, setDragRepositionAppearance, setDragRepositionCursor, setDragResizeAppearance, setDragScrollDelay, setDragStartDistance, setDragTarget, setDragType, setDropTypes, setDropTypes, setDynamicContents, setEdgeBackgroundColor, setEdgeCenterBackgroundColor, setEdgeImage, setEdgeMarginSize, setEdgeOffset, setEdgeOpacity, setEdgeShowCenter, setEdgeSize, setEditMode, setEditMode, setEditMode, setEditProxyConstructor, setElement, setExtraSpace, setFacetId, setGroupBorderCSS, setGroupLabelBackgroundColor, setGroupLabelStyleName, setGroupTitle, setHeight, setHeight, setHeight, setHeight100, setHideUsingDisplayNone, setHoverAlign, setHoverAutoDestroy, setHoverDelay, setHoverHeight, setHoverMoveWithMouse, setHoverOpacity, setHoverStyle, setHoverVAlign, setHoverWidth, setHoverWrap, setHtmlElement, setHtmlPosition, setImage, setImage, setInitHandler, setIsGroup, setIsSnapAlignCandidate, setKeepInParentRect, setKeepInParentRect, setKeepInParentRect, setLayoutAlign, setLayoutAlign, setLeavePageSpace, setLeft, setLeft, setLocateChildrenBy, setLocateChildrenType, setLocatePeersBy, setLocatePeersType, setLogicalStructure, setMargin, setMatchElement, setMaxHeight, setMaxWidth, setMenuConstructor, setMinHeight, setMinNonEdgeSize, setMinWidth, setMomentumScrollMinSpeed, setMouseStillDownDelay, setMouseStillDownInitialDelay, setNeverUseFilters, setNoDoubleClicks, setNoDropCursor, setOpacity, setOverflow, setPadding, setPageLeft, setPageTop, setParentCanvas, setParentElement, setPeers, setPercentBox, setPercentSource, setPosition, setPrefix, setPrintChildrenAbsolutelyPositioned, setPrompt, setProportionalResizeModifiers, setProportionalResizing, setRect, setRect, setRedrawOnResize, setResizeBarTarget, setResizeFrom, setResizeFrom, setRight, setScrollbarConstructor, setScrollbarSize, setShadowDepth, setShadowImage, setShadowOffset, setShadowSoftness, setShouldPrint, setShowCustomScrollbars, setShowDragShadow, setShowEdges, setShowHover, setShowHoverComponents, setShowResizeBar, setShowShadow, setShowSnapGrid, setShrinkElementOnHide, setSkinImgDir, setSmoothFade, setSnapAlignCandidates, setSnapAlignCenterLineStyle, setSnapAlignEdgeLineStyle, setSnapAxis, setSnapEdge, setSnapHDirection, setSnapHGap, setSnapOffsetLeft, setSnapOffsetTop, setSnapOnDrop, setSnapResizeToAlign, setSnapResizeToGrid, setSnapTo, setSnapToAlign, setSnapToCenterAlign, setSnapToEdgeAlign, setSnapToGrid, setSnapVDirection, setSnapVGap, setStyleName, setTabIndex, setTitle, setTooltip, setTop, setTop, setUseBackMask, setUseDragMask, setUseNativeDrag, setUseOpacityFilter, setUseTouchScrolling, setValuesManager, setVisibility, setVisible, setWidth, setWidth, setWidth, setWidth100, setZIndex, shouldDragScroll, show, showClickMask, showComponentMask, showComponentMask, showNextTo, showNextTo, showNextTo, showNextTo, showPrintPreview, showPrintPreview, showPrintPreview, showPrintPreview, showRecursively, updateEditNode, updateHover, updateHover, updateShadow, visibleAtPoint, willAcceptDrop
addDrawHandler, applyFactoryProperties, destroy, doAddHandler, doInit, doOnRender, draw, equals, error, errorIfNotCreated, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDateArray, getAttributeAsDouble, getAttributeAsElement, getAttributeAsFloat, getAttributeAsFloatArray, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsMap, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getConfig, getDOM, getHandlerCount, getID, getInnerHTML, getJsObj, getOrCreateJsObj, getRef, getScClassName, hasAutoAssignedID, hashCode, initNativeObject, internalSetID, internalSetID, isConfigOnly, isCreated, isFactoryCreated, onBind, onDestroy, onDraw, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setConfig, setConfigOnly, setDragTracker, setFactoryCreated, setID, setJavaScriptObject, setLogicalStructure, setNullProperty, setPosition, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setScClassName, toString
addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getLayoutData, getParent, isAttached, isOrWasAttached, onBrowserEvent, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents
addStyleDependentName, ensureDebugId, ensureDebugId, ensureDebugId, getStyleElement, getStyleName, getStylePrimaryName, getStylePrimaryName, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setVisible, sinkBitlessEvent
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
getOrCreateJsObj
public Calendar()
public Calendar(com.google.gwt.core.client.JavaScriptObject jsObj)
public static Calendar getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public static void changeAutoChildDefaults(java.lang.String autoChildName, Canvas defaults)
autoChildName
.autoChildName
- name of an AutoChild to customize the defaults for.defaults
- Canvas defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties
.AutoChildUsage
public static void changeAutoChildDefaults(java.lang.String autoChildName, FormItem defaults)
autoChildName
.autoChildName
- name of an AutoChild to customize the defaults for.defaults
- FormItem defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties
.AutoChildUsage
protected com.google.gwt.core.client.JavaScriptObject create()
public ImgButton getAddEventButton() throws java.lang.IllegalStateException
ImgButton
that appears in a Calendar's week/day/month views and offers an
alternative way to create a new event
.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setAddEventButtonHoverText(java.lang.String addEventButtonHoverText) throws java.lang.IllegalStateException
add event
toolbar buttonaddEventButtonHoverText
- Default value is "Add an event"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getAddEventButtonHoverText()
add event
toolbar buttonpublic void setAllowDurationEvents(java.lang.Boolean allowDurationEvents)
duration
and duration unit
on each event, and are then
maintained, instead of the end date, when alterations are made to the event via editors or dragging with the mouse.allowDurationEvents
- Default value is nullCalendarEvent
public java.lang.Boolean getAllowDurationEvents()
duration
and duration unit
on each event, and are then
maintained, instead of the end date, when alterations are made to the event via editors or dragging with the mouse.CalendarEvent
public void setAlternateLaneStyles(java.lang.Boolean alternateLaneStyles)
Timeline
, or a day view
when showDayLanes
is true, whether to make lane boundaries
more obvious by showing alternate lanes in a different color.alternateLaneStyles
- Default value is nullpublic java.lang.Boolean getAlternateLaneStyles()
Timeline
, or a day view
when showDayLanes
is true, whether to make lane boundaries
more obvious by showing alternate lanes in a different color.public void setBackButtonTitle(java.lang.String backButtonTitle) throws java.lang.IllegalStateException
month
on Handsets when the month view
is the current visible view. When the month
view is not the current visible view, the title for the month button is set according to the value of monthButtonTitle
.
backButtonTitle
- See HTMLString
. Default value is "Back"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getBackButtonTitle()
month
on Handsets when the month view
is the current visible view. When the month
view is not the current visible view, the title for the month button is set according to the value of monthButtonTitle
.
HTMLString
public void setBaseStyle(java.lang.String baseStyle)
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
baseStyle
- See CSSStyleName
. Default value is "calendar"Appearance overview and related methods
public java.lang.String getBaseStyle()
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
CSSStyleName
Appearance overview and related methods
public void setBringEventsToFront(java.lang.Boolean bringEventsToFront) throws java.lang.IllegalStateException
bringEventsToFront
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getBringEventsToFront()
public IButton getCancelButton() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
of type IButton
, used to cancel
editing of an event and close the eventEditor
.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setCancelButtonTitle(java.lang.String cancelButtonTitle) throws java.lang.IllegalStateException
Cancel button
in the event editor
.cancelButtonTitle
- See HTMLString
. Default value is "Cancel"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getCancelButtonTitle()
Cancel button
in the event editor
.HTMLString
public void setCanCreateEvents(java.lang.Boolean canCreateEvents) throws java.lang.IllegalStateException
canCreateEvents
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanCreateEvents()
public void setCanDeleteEvents(java.lang.Boolean canDeleteEvents) throws java.lang.IllegalStateException
canRemoveEvents
canEditEvents
.canDeleteEvents
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanDeleteEvents()
canRemoveEvents
canEditEvents
.public void setCanDragCreateEvents(java.lang.Boolean canDragCreateEvents)
canDragCreateEvents
- Default value is nullpublic java.lang.Boolean getCanDragCreateEvents()
public void setCanDragEventField(java.lang.String canDragEventField) throws java.lang.IllegalStateException
CalendarEvent
that determines whether an EventCanvas
can be moved or resized by dragging with the mouse. Note that canEditEvents
must be true for dragging to be allowed.canDragEventField
- Default value is "canDrag"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getCanDragEventField()
CalendarEvent
that determines whether an EventCanvas
can be moved or resized by dragging with the mouse. Note that canEditEvents
must be true for dragging to be allowed.CalendarEvent
public void setCanDragEvents(java.lang.Boolean canDragEvents) throws java.lang.IllegalStateException
Only has an effect when canEditEvents
is true.
canDragEvents
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanDragEvents()
Only has an effect when canEditEvents
is true.
public void setCanEditEvents(java.lang.Boolean canEditEvents) throws java.lang.IllegalStateException
canEditEvents
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanEditEvents()
public void setCanEditField(java.lang.String canEditField) throws java.lang.IllegalStateException
CalendarEvent
that determines whether it can be
edited in the event editor
. Note that an event
with canEdit
set to true can also have canDrag
or canResize
set to false, which would still allow
editing, but not via drag operations.canEditField
- Default value is "canEdit"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getCanEditField()
CalendarEvent
that determines whether it can be
edited in the event editor
. Note that an event
with canEdit
set to true can also have canDrag
or canResize
set to false, which would still allow
editing, but not via drag operations.CalendarEvent
public void setCanEditLane(java.lang.Boolean canEditLane) throws java.lang.IllegalStateException
lane
and, when it's editor is shown, an additional drop-down
widget is provided allowing the user to select a different lane. In either case, the event's laneNameField
is updated automatically.
This setting
can be overridden on each event
.
canEditLane
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanEditLane()
lane
and, when it's editor is shown, an additional drop-down
widget is provided allowing the user to select a different lane. In either case, the event's laneNameField
is updated automatically.
This setting
can be overridden on each event
.
public void setCanEditLaneField(java.lang.String canEditLaneField) throws java.lang.IllegalStateException
CalendarEvent
that determines whether that event
can be moved between lanes.canEditLaneField
- Default value is "canEditLane"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getCanEditLaneField()
CalendarEvent
that determines whether that event
can be moved between lanes.CalendarEvent
public void setCanEditSublane(java.lang.Boolean canEditSublane) throws java.lang.IllegalStateException
If so, the event can be dragged to a different sublane
within the same parent Lane and, when it's editor is
shown, an additional drop-down widget is provided allowing the sublane to be altered.
If the sublane is locked, but
the parent lane
isn't, an update to the event's
lane name
will be allowed, assuming that the new
Lane has an existing sublane with the same name.
In either case, the event's sublane
is updated automatically.
This setting
can be overridden on each event
.
canEditSublane
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanEditSublane()
If so, the event can be dragged to a different sublane
within the same parent Lane and, when it's editor is
shown, an additional drop-down widget is provided allowing the sublane to be altered.
If the sublane is locked, but
the parent lane
isn't, an update to the event's
lane name
will be allowed, assuming that the new
Lane has an existing sublane with the same name.
In either case, the event's sublane
is updated automatically.
This setting
can be overridden on each event
.
public void setCanEditSublaneField(java.lang.String canEditSublaneField) throws java.lang.IllegalStateException
CalendarEvent
that determines whether that event
can be moved between individual sublanes
in a Lane
.canEditSublaneField
- Default value is "canEditSublane"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getCanEditSublaneField()
CalendarEvent
that determines whether that event
can be moved between individual sublanes
in a Lane
.CalendarEvent
public void setCanGroupLanes(java.lang.Boolean canGroupLanes)
laneGroupByField
. The fields available for grouping
on are those defined as lane fields
. Since these
are definitions for normal fields
, you can choose to hide
the field in the timeline, but still have it available for
grouping.canGroupLanes
- Default value is nullpublic java.lang.Boolean getCanGroupLanes()
laneGroupByField
. The fields available for grouping
on are those defined as lane fields
. Since these
are definitions for normal fields
, you can choose to hide
the field in the timeline, but still have it available for
grouping.public void setCanRemoveEvents(java.lang.Boolean canRemoveEvents) throws java.lang.IllegalStateException
canEditEvents
.canRemoveEvents
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanRemoveEvents()
canEditEvents
.public void setCanRemoveField(java.lang.String canRemoveField) throws java.lang.IllegalStateException
CalendarEvent
that determines whether an event
shows a remove button.canRemoveField
- Default value is "canRemove"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getCanRemoveField()
CalendarEvent
that determines whether an event
shows a remove button.CalendarEvent
public void setCanReorderLanes(java.lang.Boolean canReorderLanes) throws java.lang.IllegalStateException
laneFields
with the mouse.canReorderLanes
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanReorderLanes()
laneFields
with the mouse.public void setCanResizeEventField(java.lang.String canResizeEventField) throws java.lang.IllegalStateException
CalendarEvent
that determines whether an event
can be resized by dragging.canResizeEventField
- Default value is "canResize"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getCanResizeEventField()
CalendarEvent
that determines whether an event
can be resized by dragging.CalendarEvent
public void setCanResizeEvents(java.lang.Boolean canResizeEvents) throws java.lang.IllegalStateException
events
be resized by dragging appropriate edges of the
canvas
? Only has an effect when both canEditEvents
and canDragEvents
are true. Set this attribute to false to
disallow drag-resizing.canResizeEvents
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanResizeEvents()
events
be resized by dragging appropriate edges of the
canvas
? Only has an effect when both canEditEvents
and canDragEvents
are true. Set this attribute to false to
disallow drag-resizing.public void setCanResizeTimelineEvents(java.lang.Boolean canResizeTimelineEvents) throws java.lang.IllegalStateException
canResizeEvents
;Timeline
events be stretched by their left and right edges?canResizeTimelineEvents
- Default value is falsejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanResizeTimelineEvents()
canResizeEvents
;Timeline
events be stretched by their left and right edges?public void setChosenDate(java.util.Date chosenDate)
chosenDate
- the new date to set as the current date. Default value is 'Today'public java.util.Date getChosenDate()
public void setColumnsPerPage(java.lang.Integer columnsPerPage) throws java.lang.IllegalStateException
timelineGranularity
to scroll by. With the
default value of null, the Timeline will scroll by its current length.columnsPerPage
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getColumnsPerPage()
timelineGranularity
to scroll by. With the
default value of null, the Timeline will scroll by its current length.public HLayout getControlsBar() throws java.lang.IllegalStateException
HLayout
shown above the Calendar views and displaying a set of
controls for interacting with the current view - namely, the next
, previous
and add
buttons, the date label
and the date-picker
icon.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setCurrentViewName(ViewName currentViewName)
currentViewName
- The name of the view that should be made visible.. Default value is nullpublic ViewName getCurrentViewName()
public void setData(CalendarEvent[] data)
This property will
typically not be explicitly specified for databound Calendars, where the data is returned from the server via databound
component methods such as fetchData()
. In this case the
data objects will be set to a resultSet
rather than a simple array.
If this method is called after the component has been drawn/initialized:
Initialize the data object with the given array. Observes methods of the data object so that when the data changes, the calendar will redraw automatically.
data
- data to show in the list. Default value is nullCalendarEvent
public CalendarEvent[] getData()
This property will
typically not be explicitly specified for databound Calendars, where the data is returned from the server via databound
component methods such as fetchData()
. In this case the
data objects will be set to a resultSet
rather than a simple array.
CalendarEvent
public void setDataFetchMode(FetchMode dataFetchMode)
FetchMode
. This
setting only applies to the ResultSet
automatically created by calling fetchData()
. If a pre-existing ResultSet is passed to setData()
instead, it's existing setting for ResultSet.fetchMode
applies.
setDataFetchMode
in interface DataBoundComponent
dataFetchMode
- Default value is "paged"Databinding overview and related methods
public FetchMode getDataFetchMode()
FetchMode
. This
setting only applies to the ResultSet
automatically created by calling fetchData()
. If a pre-existing ResultSet is passed to setData()
instead, it's existing setting for ResultSet.fetchMode
applies.
getDataFetchMode
in interface DataBoundComponent
Databinding overview and related methods
public void setDataSource(DataSource dataSource)
DataSource requests
. Can be specified as either a DataSource instance or the String ID of a DataSource.
setDataSource
in interface DataBoundComponent
dataSource
- Default value is nullDatabinding overview and related methods
,
DataSource fields Examplepublic void setDataSource(java.lang.String dataSource)
DataSource requests
. Can be specified as either a DataSource instance or the String ID of a DataSource.
setDataSource
in interface DataBoundComponent
dataSource
- Default value is nullDatabinding overview and related methods
,
DataSource fields Examplepublic DateChooser getDateChooser() throws java.lang.IllegalStateException
DateChooser
used to select the date for which events will be displayed.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setDateEditingStyle(DateEditingStyle dateEditingStyle) throws java.lang.IllegalStateException
DateEditingStyle
type. If unset, the editing style will be set to the
field-type on the DataSource, if there is one. If there's no DataSource, it will be set to "date" if the granularity
is "day" or larger and "time" if
granularity is "minute" or smaller, otherwise "datetime".
dateEditingStyle
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic DateEditingStyle getDateEditingStyle()
DateEditingStyle
type. If unset, the editing style will be set to the
field-type on the DataSource, if there is one. If there's no DataSource, it will be set to "date" if the granularity
is "day" or larger and "time" if
granularity is "minute" or smaller, otherwise "datetime".
public void setDateFormatter(DateDisplayFormat dateFormatter)
Date.setShortDisplayFormat()
. Specify any valid DateDisplayFormat
.dateFormatter
- Default value is nullpublic DateDisplayFormat getDateFormatter()
Date.setShortDisplayFormat()
. Specify any valid DateDisplayFormat
.public Label getDateLabel() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
Label
used to display the current
date or range above the selected calendar view.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public ImgButton getDatePickerButton() throws java.lang.IllegalStateException
ImgButton
that appears above the various views of the calendar and
offers alternative access to a DateChooser
to pick the current day.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setDatePickerHoverText(java.lang.String datePickerHoverText) throws java.lang.IllegalStateException
date picker
toolbar buttondatePickerHoverText
- Default value is "Choose a date"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getDatePickerHoverText()
date picker
toolbar buttonpublic void setDayBodyBaseStyle(java.lang.String dayBodyBaseStyle)
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
dayBodyBaseStyle
- See CSSStyleName
. Default value is "calMonthDayBody"Appearance overview and related methods
public java.lang.String getDayBodyBaseStyle()
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
CSSStyleName
Appearance overview and related methods
public void setDayHeaderBaseStyle(java.lang.String dayHeaderBaseStyle)
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
dayHeaderBaseStyle
- See CSSStyleName
. Default value is "calMonthDayHeader"Appearance overview and related methods
public java.lang.String getDayHeaderBaseStyle()
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
CSSStyleName
Appearance overview and related methods
public CalendarView getDayView() throws java.lang.IllegalStateException
CalendarView
used to display events that pertain to a given day.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setDayViewTitle(java.lang.String dayViewTitle) throws java.lang.IllegalStateException
day view
.dayViewTitle
- Default value is "Day"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getDayViewTitle()
day view
.public void setDefaultTimelineColumnSpan(int defaultTimelineColumnSpan) throws java.lang.IllegalStateException
timelineGranularity
to give the timeline by default if no endDate
is provided. The default is 20.defaultTimelineColumnSpan
- Default value is 20java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getDefaultTimelineColumnSpan()
timelineGranularity
to give the timeline by default if no endDate
is provided. The default is 20.public void setDescriptionField(java.lang.String descriptionField) throws java.lang.IllegalStateException
CalendarEvent
.descriptionField
- Default value is "description"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getDescriptionField()
CalendarEvent
.public void setDetailsButtonTitle(java.lang.String detailsButtonTitle) throws java.lang.IllegalStateException
quick
event dialog
.detailsButtonTitle
- See HTMLString
. Default value is "Edit Details"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getDetailsButtonTitle()
quick
event dialog
.HTMLString
public void setDisableWeekends(java.lang.Boolean disableWeekends)
weekendDays
.disableWeekends
- Default value is trueVisibility overview and related methods
public java.lang.Boolean getDisableWeekends()
weekendDays
.Visibility overview and related methods
public void setDurationField(java.lang.String durationField) throws java.lang.IllegalStateException
duration
field on a CalendarEvent
.durationField
- Default value is "duration"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getDurationField()
duration
field on a CalendarEvent
.CalendarEvent
public void setDurationUnitField(java.lang.String durationUnitField) throws java.lang.IllegalStateException
durationUnit
field on a
CalendarEvent
.durationUnitField
- Default value is "durationUnit"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getDurationUnitField()
durationUnit
field on a
CalendarEvent
.CalendarEvent
public void setEndDate(java.util.Date endDate) throws java.lang.IllegalStateException
To set different start
and end dates after initial draw, see setTimelineRange
.
Note that this attribute may be
automatically altered if showing header-levels
,
to fit to header boundaries.
endDate
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.util.Date getEndDate()
To set different start
and end dates after initial draw, see setTimelineRange
.
Note that this attribute may be
automatically altered if showing header-levels
,
to fit to header boundaries.
public void setEndDateField(java.lang.String endDateField) throws java.lang.IllegalStateException
CalendarEvent
.endDateField
- Default value is "endDate"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getEndDateField()
CalendarEvent
.CalendarEvent
public void setEventAutoArrange(java.lang.Boolean eventAutoArrange) throws java.lang.IllegalStateException
eventAutoArrange
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getEventAutoArrange()
public EventCanvas getEventCanvas()
Using AutoChildren
for details.
To display events in day
, week
and timeline
views, the Calendar creates instances of EventCanvas
for each event. Use the com.smartgwt.client.types.AutoChild
system to customize these canvases.
public HLayout getEventCanvasButtonLayout() throws java.lang.IllegalStateException
close
and/or context
buttons.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public ImgButton getEventCanvasCloseButton() throws java.lang.IllegalStateException
CalendarView
.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public ImgButton getEventCanvasContextButton() throws java.lang.IllegalStateException
context menu
when clicked.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Menu getEventCanvasContextMenu() throws java.lang.IllegalStateException
event canvas
is right-clicked,
or when the rollover context button
is
clicked. The context button, and the menu itself, will only be displayed if getEventCanvasMenuItems
returns an array of
appropriate items for the event.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Img getEventCanvasGripper()
Using AutoChildren
for details.
The "gripper" widget that snaps to the top of an event canvas and allows an event to be dragged with the mouse.
public Img getEventCanvasHResizer()
Using AutoChildren
for details.
The resizer image that snaps to the left and right edges of an editable event canvas in a Timeline
, allowing it to be resized horizontally by dragging with the mouse.
public Label getEventCanvasLabel()
Using AutoChildren
for details.
public Img getEventCanvasVResizer()
Using AutoChildren
for details.
The resizer image that snaps to the bottom of event canvases in day
and week
views, allowing them to be resized vertically by
dragging with the mouse.
public void setEventDescriptionFieldTitle(java.lang.String eventDescriptionFieldTitle) throws java.lang.IllegalStateException
eventDescriptionFieldTitle
- See HTMLString
. Default value is "Description"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getEventDescriptionFieldTitle()
HTMLString
public Window getEventDialog() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
of type Window
that displays a quick
event entry form in a popup window.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setEventDragGap(java.lang.Integer eventDragGap)
eventDragGap
- Default value is 10public java.lang.Integer getEventDragGap()
public void setEventDurationFieldTitle(java.lang.String eventDurationFieldTitle) throws java.lang.IllegalStateException
eventDurationFieldTitle
- See HTMLString
. Default value is "Duration"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getEventDurationFieldTitle()
HTMLString
public void setEventDurationUnitFieldTitle(java.lang.String eventDurationUnitFieldTitle) throws java.lang.IllegalStateException
eventDurationUnitFieldTitle
- See HTMLString
. Default value is " "java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getEventDurationUnitFieldTitle()
HTMLString
public DynamicForm getEventEditor() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
of type DynamicForm
which
displays event data
. This form is created within the event editor layout
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public HLayout getEventEditorButtonLayout() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
of type HLayout
which houses
the Save
, Remove
and Cancel
buttons in the eventEditor
.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public Window getEventEditorLayout() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
of type Window
that displays the full
event editor
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setEventEndDateFieldTitle(java.lang.String eventEndDateFieldTitle) throws java.lang.IllegalStateException
eventEndDateFieldTitle
- See HTMLString
. Default value is "To"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getEventEndDateFieldTitle()
HTMLString
public void setEventHeaderHeight(int eventHeaderHeight) throws java.lang.IllegalStateException
eventHeaderWrap
is false and showEventDescriptions
is true, this is the the
fixed height for the header area
in event
canvases.eventHeaderHeight
- Default value is 14java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getEventHeaderHeight()
eventHeaderWrap
is false and showEventDescriptions
is true, this is the the
fixed height for the header area
in event
canvases.public void setEventHeaderWrap(boolean eventHeaderWrap) throws java.lang.IllegalStateException
canvas
for an event, whether to
allow the content of the header area
to wrap to
multiple lines. The default is true - if set to false, the header area is fixed
, unless showEventDescriptions
is false, in which case
the header area fills the canvas.
eventHeaderWrap
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic boolean getEventHeaderWrap()
canvas
for an event, whether to
allow the content of the header area
to wrap to
multiple lines. The default is true - if set to false, the header area is fixed
, unless showEventDescriptions
is false, in which case
the header area fills the canvas.
public void setEventLaneFieldTitle(java.lang.String eventLaneFieldTitle) throws java.lang.IllegalStateException
eventLaneFieldTitle
- See HTMLString
. Default value is "Lane"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getEventLaneFieldTitle()
HTMLString
public void setEventNameFieldTitle(java.lang.String eventNameFieldTitle) throws java.lang.IllegalStateException
eventNameFieldTitle
- See HTMLString
. Default value is "Event Name"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getEventNameFieldTitle()
HTMLString
public void setEventOverlap(java.lang.Boolean eventOverlap) throws java.lang.IllegalStateException
eventAutoArrange
is true, setting
eventOverlap to true causes events that share timeslots to overlap each other by a percentage of their width, specified
by eventOverlapPercent
. The default is
true.eventOverlap
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getEventOverlap()
eventAutoArrange
is true, setting
eventOverlap to true causes events that share timeslots to overlap each other by a percentage of their width, specified
by eventOverlapPercent
. The default is
true.public void setEventOverlapIdenticalStartTimes(java.lang.Boolean eventOverlapIdenticalStartTimes) throws java.lang.IllegalStateException
eventOverlapIdenticalStartTimes
- Default value is falsejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getEventOverlapIdenticalStartTimes()
public void setEventOverlapPercent(int eventOverlapPercent) throws java.lang.IllegalStateException
eventOverlapPercent
- Default value is 10java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getEventOverlapPercent()
public void setEventSnapGap(java.lang.Integer eventSnapGap) throws java.lang.IllegalStateException
If set to a value, it is respected exactly where possible.
If unset (the default), vertical views will snap to each cell boundary; 30
minutes. In Timelines, the snapGap is automatic depending on the current timelineGranularity
. If timelineUnitsPerColumn
is greater than 1, the
snapGap is set to one unit of the current granularity. So, a cell-resolution of 15 minutes would snap to every minute,
assuming there are at least 15 pixels per column. Otherwise, the snapGap is either 15 minutes, 1 hour, one day or one
month, depending on granularity.
If the specified or calculated value is less than the time covered by a single pixel in the current view, then it can't be represented. In this case, it is rounded up to the lowest "sensible" time-span that can be represented: one of [1, 5, 10, 15, 20, 30, 60, 120, 240, 360, 480, 720, 1440].
For example - a Timeline showing "day" columns cannot support an eventSnapGap of 1 minute, unless each column is at least 1440 pixels wide - if the columns were only 150px wide, then each pixel would represent around 9.6 minutes, which would result in unpleasant and unexpected time-offsets when dragging events. So, the calculated eventSnapGap will be rounded up to the nearest "sensible" time-span - in this case, 10 minutes. If the columns were only 60px wide, it would be 30 minutes.
eventSnapGap
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdEditing overview and related methods
public java.lang.Integer getEventSnapGap()
If set to a value, it is respected exactly where possible.
If unset (the default), vertical views will snap to each cell boundary; 30
minutes. In Timelines, the snapGap is automatic depending on the current timelineGranularity
. If timelineUnitsPerColumn
is greater than 1, the
snapGap is set to one unit of the current granularity. So, a cell-resolution of 15 minutes would snap to every minute,
assuming there are at least 15 pixels per column. Otherwise, the snapGap is either 15 minutes, 1 hour, one day or one
month, depending on granularity.
If the specified or calculated value is less than the time covered by a single pixel in the current view, then it can't be represented. In this case, it is rounded up to the lowest "sensible" time-span that can be represented: one of [1, 5, 10, 15, 20, 30, 60, 120, 240, 360, 480, 720, 1440].
For example - a Timeline showing "day" columns cannot support an eventSnapGap of 1 minute, unless each column is at least 1440 pixels wide - if the columns were only 150px wide, then each pixel would represent around 9.6 minutes, which would result in unpleasant and unexpected time-offsets when dragging events. So, the calculated eventSnapGap will be rounded up to the nearest "sensible" time-span - in this case, 10 minutes. If the columns were only 60px wide, it would be 30 minutes.
Editing overview and related methods
public void setEventStartDateFieldTitle(java.lang.String eventStartDateFieldTitle) throws java.lang.IllegalStateException
eventStartDateFieldTitle
- See HTMLString
. Default value is "From"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getEventStartDateFieldTitle()
HTMLString
public void setEventStyleName(java.lang.String eventStyleName)
events
when they're rendered in calendar views. This style will have "Header" and "Body" appended to it, according to which
part of the event window is being styled. For example, to style the header, define a CSS class called
'eventWindowHeader'.eventStyleName
- See CSSStyleName
. Default value is "eventWindow"Appearance overview and related methods
public java.lang.String getEventStyleName()
events
when they're rendered in calendar views. This style will have "Header" and "Body" appended to it, according to which
part of the event window is being styled. For example, to style the header, define a CSS class called
'eventWindowHeader'.CSSStyleName
Appearance overview and related methods
public void setEventStyleNameField(java.lang.String eventStyleNameField) throws java.lang.IllegalStateException
eventStyleName
for an individual CalendarEvent.styleName
.eventStyleNameField
- Default value is "styleName"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.String getEventStyleNameField()
eventStyleName
for an individual CalendarEvent.styleName
.Appearance overview and related methods
public void setEventSublaneFieldTitle(java.lang.String eventSublaneFieldTitle) throws java.lang.IllegalStateException
eventSublaneFieldTitle
- See HTMLString
. Default value is "Sublane"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getEventSublaneFieldTitle()
HTMLString
public EventWindow getEventWindow()
eventCanvas
Using AutoChildren
for details.
To display events in day and week views, the Calendar creates instance of EventWindow
for each event. Use the com.smartgwt.client.types.AutoChild
system to customize these windows.
public void setEventWindowStyle(java.lang.String eventWindowStyle)
eventStyleName
eventWindowStyle
- See CSSStyleName
. Default value is nullAppearance overview and related methods
public java.lang.String getEventWindowStyle()
eventStyleName
CSSStyleName
Appearance overview and related methods
public void setEventWindowStyleField(java.lang.String eventWindowStyleField) throws java.lang.IllegalStateException
eventStyleNameField
eventWindowStyle
for an individual CalendarEvent
. See CalendarEvent.eventWindowStyle
.eventWindowStyleField
- Default value is "eventWindowStyle"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.String getEventWindowStyleField()
eventStyleNameField
eventWindowStyle
for an individual CalendarEvent
. See CalendarEvent.eventWindowStyle
.Appearance overview and related methods
public void setFirstDayOfWeek(java.lang.Integer firstDayOfWeek)
firstDayOfWeek
- Default value is nullpublic java.lang.Integer getFirstDayOfWeek()
public void setHeaderLevels(HeaderLevel... headerLevels)
headers
shown above the event area,
and their time units. Header levels are provided from the top down, so the first header level should be the largest
time unit and the last one the smallest. The smallest is then used for the actual field-headers.
If this method is called after the component has been drawn/initialized:
For Timeline
s, configures the levels of headers
shown above the event area, and their time units, after initialization.
headerLevels
- the array of HeaderLevels to set. Default value is nullpublic HeaderLevel[] getHeaderLevels()
headers
shown above the event area,
and their time units. Header levels are provided from the top down, so the first header level should be the largest time unit and the last one the smallest. The smallest is then used for the actual field-headers.
public void setHideUnusedLanes(java.lang.Boolean hideUnusedLanes)
lane
that doesn't have any
active events in the current dataset.hideUnusedLanes
- Default value is nullpublic java.lang.Boolean getHideUnusedLanes()
lane
that doesn't have any
active events in the current dataset.public IndicatorCanvas getIndicatorCanvas()
Using AutoChildren
for details.
AutoChild component created for each indicator
entry.
public void setIndicators(CalendarEvent... indicators)
timeline views
. Each indicator renders out as an indicator canvas
, a special, non-interactive subclass of EventCanvas
, which spans all lanes and draws behind any normal, interactive
events in the zorder, but in front of any zones
. The
default style
for these components renders
them as thin vertical lines that span all lanes and have a hover but no title.
indicators
used to highlight instants in time.indicators
- array of indicators to display. Default value is nullpublic CalendarEvent[] getIndicators()
timeline views
. Each indicator renders out as an indicator canvas
, a special, non-interactive subclass of EventCanvas
, which spans all lanes and draws behind any normal, interactive
events in the zorder, but in front of any zones
. The
default style
for these components renders
them as thin vertical lines that span all lanes and have a hover but no title.public void setIndicatorStyleName(java.lang.String indicatorStyleName)
indicatorStyleName
- See CSSStyleName
. Default value is "indicatorCanvas"public java.lang.String getIndicatorStyleName()
CSSStyleName
public void setInvalidDateMessage(java.lang.String invalidDateMessage) throws java.lang.IllegalStateException
eventEditor
when the
'To' date is greater than the 'From' date and a save is attempted.invalidDateMessage
- Default value is "From must be before To"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getInvalidDateMessage()
eventEditor
when the
'To' date is greater than the 'From' date and a save is attempted.public void setLaneEventPadding(java.lang.Integer laneEventPadding)
lane
or sublane
they appear in. Only applicable to timelines
and to dayViews
showing day lanes
.laneEventPadding
- Default value is 0public java.lang.Integer getLaneEventPadding()
lane
or sublane
they appear in. Only applicable to timelines
and to dayViews
showing day lanes
.public void setLaneFields(ListGridField... laneFields) throws java.lang.IllegalStateException
timelineView
, which shows data about the timeline lanes
.
Each field shows one attribute of the objects provided as lanes
. When lane grouping
is enabled, only
fields that are specified as lane fields can be used as group fields.
laneFields
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic ListGridField[] getLaneFields()
timelineView
, which shows data about the timeline lanes
.
Each field shows one attribute of the objects provided as lanes
. When lane grouping
is enabled, only
fields that are specified as lane fields can be used as group fields.
public void setLaneGroupByField(java.lang.String laneGroupByField)
canGroupLanes
set to true,
this is a field name or array of field names on which to group the lanes in a timeline.laneGroupByField
- Default value is nullpublic java.lang.String getLaneGroupByField()
canGroupLanes
set to true,
this is a field name or array of field names on which to group the lanes in a timeline.public void setLaneGroupByField(java.lang.String... laneGroupByField)
canGroupLanes
set to true,
this is a field name or array of field names on which to group the lanes in a timeline.laneGroupByField
- Default value is nullpublic java.lang.String[] getLaneGroupByFieldAsString()
canGroupLanes
set to true,
this is a field name or array of field names on which to group the lanes in a timeline.public void setLaneNameField(java.lang.String laneNameField) throws java.lang.IllegalStateException
lane
in
which this event will be displayed in Timeline
s and in the day view
, if showDayLanes
is true.laneNameField
- Default value is "lane"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getLaneNameField()
lane
in
which this event will be displayed in Timeline
s and in the day view
, if showDayLanes
is true.CalendarEvent
public void setLanes(Lane... lanes)
Lane
definitions that represent the rows of the timelineView
, or the columns of the dayView
if showDayLanes
is true.
lanes
in the current calendar view. Only has an effect in timeline views
, and in day views
when showDayLanes
is true.lanes
- array of lanes to display. Default value is nullpublic Lane[] getLanes()
Lane
definitions that represent the rows of the timelineView
, or the columns of the dayView
if showDayLanes
is true.public void setLeadingDateField(java.lang.String leadingDateField) throws java.lang.IllegalStateException
trailingDateField
are present in the data, a line
extends out from the event showing the extent of the leading and trailing dates - useful for visualizing a pipeline of
events where some can be moved a certain amount without affecting others.leadingDateField
- Default value is "leadingDate"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getLeadingDateField()
trailingDateField
are present in the data, a line
extends out from the event showing the extent of the leading and trailing dates - useful for visualizing a pipeline of
events where some can be moved a certain amount without affecting others.CalendarEvent
public TabSet getMainView() throws java.lang.IllegalStateException
TabSet
for managing calendar views when multiple views are available (eg, day
and month
).
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setMinimalUI(boolean minimalUI)
minimalUI
- Default value is falsepublic boolean getMinimalUI()
public void setMinimumDayHeight(java.lang.Integer minimumDayHeight)
month view
when showDayHeaders
is true, this is the minimum height
applied to a day cell and its header combined. If showDayHeaders
is false, this attribute has no effect
- the minimum height of day cells is either an equal share of the available height, or the rendered height of the
cell's HTML content, whichever is greater. If the latter, a vertical scrollbar is shown.
minimumDayHeight
- Default value is 80Appearance overview and related methods
public java.lang.Integer getMinimumDayHeight()
month view
when showDayHeaders
is true, this is the minimum height
applied to a day cell and its header combined. If showDayHeaders
is false, this attribute has no effect
- the minimum height of day cells is either an equal share of the available height, or the rendered height of the
cell's HTML content, whichever is greater. If the latter, a vertical scrollbar is shown.
Appearance overview and related methods
public void setMinLaneWidth(java.lang.Integer minLaneWidth) throws java.lang.IllegalStateException
vertical lanes
in the dayView
, this attribute sets the minimum width of each column
or field.minLaneWidth
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getMinLaneWidth()
vertical lanes
in the dayView
, this attribute sets the minimum width of each column
or field.public void setMinutesPerRow(java.lang.Integer minutesPerRow) throws java.lang.IllegalStateException
day
and week
views. The default of 30 minutes shows two rows per
hour. Note that this value must divide into 60.minutesPerRow
- Default value is 30java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getMinutesPerRow()
day
and week
views. The default of 30 minutes shows two rows per
hour. Note that this value must divide into 60.public NavigationButton getMonthButton() throws java.lang.IllegalStateException
NavigationButton
that appears to the left of other navigation controls in the
controls bar
on Handset devices. Used to show
and hide the month view
on devices with limited
space.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setMonthButtonTitle(java.lang.String monthButtonTitle) throws java.lang.IllegalStateException
month button
, used for showing and
hiding the month view
on Handsets. This is a
dynamic string - text within ${...}
are dynamic variables and will be evaluated as JS code when the
message is displayed.
Only one dynamic variable, monthName, is available and represents the name of the month containing the currently selected date.
The default value is a left-facing arrow followed by the Month-name of the selected date.
When the month view is already visible, the title for the month button is set according to the value
of backButtonTitle
.
monthButtonTitle
- See HTMLString
. Default value is "< ${monthName}"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getMonthButtonTitle()
month button
, used for showing and
hiding the month view
on Handsets. This is a
dynamic string - text within ${...}
are dynamic variables and will be evaluated as JS code when the
message is displayed.
Only one dynamic variable, monthName, is available and represents the name of the month containing the currently selected date.
The default value is a left-facing arrow followed by the Month-name of the selected date.
When the month view is already visible, the title for the month button is set according to the value
of backButtonTitle
.
HTMLString
public void setMonthMoreEventsLinkTitle(java.lang.String monthMoreEventsLinkTitle) throws java.lang.IllegalStateException
month view
when there are too many events to be displayed at once. This is a dynamic string - text within
${...}
are dynamic variables and will be evaluated as JS code when the message is displayed.
Only one dynamic variable, eventCount, is available and represents the number of events that are not currently displayed and that will appear in the menu displayed when the More Events link is clicked.
The default value is a string like "+ 3 more...".
monthMoreEventsLinkTitle
- See HTMLString
. Default value is "+ ${eventCount} more..."java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getMonthMoreEventsLinkTitle()
month view
when there are too many events to be displayed at once. This is a dynamic string - text within
${...}
are dynamic variables and will be evaluated as JS code when the message is displayed.
Only one dynamic variable, eventCount, is available and represents the number of events that are not currently displayed and that will appear in the menu displayed when the More Events link is clicked.
The default value is a string like "+ 3 more...".
HTMLString
public Menu getMonthMoreEventsMenu() throws java.lang.IllegalStateException
more events
link in a cell of the monthView
. Items in this menu represent additional events,
not already displayed in the cell, and clicking them fires the eventClick
notification.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public CalendarView getMonthView() throws java.lang.IllegalStateException
CalendarView
used to display events that pertain to a given month.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setMonthViewTitle(java.lang.String monthViewTitle) throws java.lang.IllegalStateException
month view
.monthViewTitle
- Default value is "Month"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getMonthViewTitle()
month view
.public void setNameField(java.lang.String nameField) throws java.lang.IllegalStateException
CalendarEvent
.nameField
- Default value is "name"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getNameField()
CalendarEvent
.CalendarEvent
public ImgButton getNextButton() throws java.lang.IllegalStateException
ImgButton
that appears above the week/day/month views of the calendar and allows
the user to move the calendar forwards in time.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setNextButtonHoverText(java.lang.String nextButtonHoverText) throws java.lang.IllegalStateException
next
toolbar buttonnextButtonHoverText
- Default value is "Next"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getNextButtonHoverText()
next
toolbar buttonpublic void setOtherDayBlankStyle(java.lang.String otherDayBlankStyle) throws java.lang.IllegalStateException
month view
, when showOtherDays
is false.otherDayBlankStyle
- See CSSStyleName
. Default value is "calMonthOtherDayBlank"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.String getOtherDayBlankStyle()
month view
, when showOtherDays
is false.CSSStyleName
Appearance overview and related methods
public void setOtherDayBodyBaseStyle(java.lang.String otherDayBodyBaseStyle)
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
otherDayBodyBaseStyle
- See CSSStyleName
. Default value is "calMonthDayBody"Appearance overview and related methods
public java.lang.String getOtherDayBodyBaseStyle()
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
CSSStyleName
Appearance overview and related methods
public void setOtherDayHeaderBaseStyle(java.lang.String otherDayHeaderBaseStyle)
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
otherDayHeaderBaseStyle
- See CSSStyleName
. Default value is "calMonthDayHeader"Appearance overview and related methods
public java.lang.String getOtherDayHeaderBaseStyle()
See CellStyleSuffixes
for details on how stateful suffixes are combined with the base style to
generate stateful cell styles.
CSSStyleName
Appearance overview and related methods
public void setOverlapSortSpecifiers(SortSpecifier... overlapSortSpecifiers)
sort-specifiers
for customizing the render order of events that
overlap. In timelines
, this dictates the vertical rendering
order of overlapped events in each lane
.
In day
and week
views, it dictates the horizontal rendering order of
overlapped events in each column or Lane.
By default, events that share space in a Lane or column are rendered from
top to bottom, or left to right according to their start-dates
- the earliest in a given lane appears
top-most in that lane, or left-most in its column.
Providing overlapSortSpecifiers
allows for the
events to be ordered by one or more of the fields stored on the events, or in the underlying data-source
, if the Calendar is databound.
overlapSortSpecifiers
- Default value is nullpublic SortSpecifier[] getOverlapSortSpecifiers()
sort-specifiers
for customizing the render order of events that
overlap. In timelines
, this dictates the vertical rendering
order of overlapped events in each lane
.
In day
and week
views, it dictates the horizontal rendering order of
overlapped events in each column or Lane.
By default, events that share space in a Lane or column are rendered from
top to bottom, or left to right according to their start-dates
- the earliest in a given lane appears
top-most in that lane, or left-most in its column.
Providing overlapSortSpecifiers
allows for the
events to be ordered by one or more of the fields stored on the events, or in the underlying data-source
, if the Calendar is databound.
public ImgButton getPreviousButton() throws java.lang.IllegalStateException
ImgButton
that appears above the week/day/month views of the calendar and allows
the user to move the calendar backwards in time.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setPreviousButtonHoverText(java.lang.String previousButtonHoverText) throws java.lang.IllegalStateException
previous
toolbar button.previousButtonHoverText
- Default value is "Previous"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getPreviousButtonHoverText()
previous
toolbar button.public IButton getRemoveButton() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
of type IButton
, used to permanently
remove an event from the eventEditor
.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setRemoveButtonTitle(java.lang.String removeButtonTitle) throws java.lang.IllegalStateException
Remove button
in the event editor
.removeButtonTitle
- See HTMLString
. Default value is "Remove Event"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getRemoveButtonTitle()
Remove button
in the event editor
.HTMLString
public void setRowHeight(int rowHeight)
rowHeight
- Default value is 20public int getRowHeight()
public void setRowTitleFrequency(java.lang.Integer rowTitleFrequency) throws java.lang.IllegalStateException
day
and week
. The default of 60 minutes shows titles on the first
row of each hour. The value provided must be a multiple of minutesPerRow
and be no larger than 60.rowTitleFrequency
- Default value is 60java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getRowTitleFrequency()
day
and week
. The default of 60 minutes shows titles on the first
row of each hour. The value provided must be a multiple of minutesPerRow
and be no larger than 60.public IButton getSaveButton() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
of type IButton
, used to save an
event from the eventEditor
.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setSaveButtonTitle(java.lang.String saveButtonTitle) throws java.lang.IllegalStateException
saveButtonTitle
- See HTMLString
. Default value is "Save Event"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getSaveButtonTitle()
HTMLString
public void setScrollToWorkday(java.lang.Boolean scrollToWorkday) throws java.lang.IllegalStateException
workday hours
to be sized to
fill the available space in the day view and week view, and automatically scrolls these views to the start of the
workday when the calendar is first displayed and whenever the user switches to a new day or week.scrollToWorkday
- Default value is falsejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getScrollToWorkday()
workday hours
to be sized to
fill the available space in the day view and week view, and automatically scrolls these views to the start of the
workday when the calendar is first displayed and whenever the user switches to a new day or week.public void setSelectChosenDate(java.lang.Boolean selectChosenDate)
chosenDate
in a
selected style in the month view
Has no effect in
other views.selectChosenDate
- Default value is trueVisibility overview and related methods
public java.lang.Boolean getSelectChosenDate()
chosenDate
in a
selected style in the month view
Has no effect in
other views.Visibility overview and related methods
public void setSelectedCellStyle(java.lang.String selectedCellStyle)
selectedCellStyle
- See CSSStyleName
. Default value is "calendarCellSelected"Appearance overview and related methods
public java.lang.String getSelectedCellStyle()
CSSStyleName
Appearance overview and related methods
public void setShowAddEventButton(java.lang.Boolean showAddEventButton)
Add Event
button.showAddEventButton
- Default value is nullpublic java.lang.Boolean getShowAddEventButton()
Add Event
button.public void setShowCellHovers(java.lang.Boolean showCellHovers) throws java.lang.IllegalStateException
showViewHovers
is true, dictates whether to
display hover prompts when the mouse rolls over the normal cells in the body of CalendarViews. The content of the
hover is determined by a call to getCellHoverHTML()
, which can be overridden to return custom results; by default, it returns the cell's date as a
string.
showCellHovers
- Default value is falsejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowCellHovers()
showViewHovers
is true, dictates whether to
display hover prompts when the mouse rolls over the normal cells in the body of CalendarViews. The content of the
hover is determined by a call to getCellHoverHTML()
, which can be overridden to return custom results; by default, it returns the cell's date as a
string.
public void setShowControlsBar(java.lang.Boolean showControlsBar) throws java.lang.IllegalStateException
controlsBar
will be hidden, so the autoChildren (previousButton
, dateLabel
, nextButton
, addEventButton
, and datePickerButton
) will not be created or shown.showControlsBar
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowControlsBar()
controlsBar
will be hidden, so the autoChildren (previousButton
, dateLabel
, nextButton
, addEventButton
, and datePickerButton
) will not be created or shown.public void setShowDateChooser(java.lang.Boolean showDateChooser) throws java.lang.IllegalStateException
dateChooser
is displayed.showDateChooser
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdVisibility overview and related methods
public java.lang.Boolean getShowDateChooser()
dateChooser
is displayed.Visibility overview and related methods
public void setShowDatePickerButton(java.lang.Boolean showDatePickerButton)
datePickerButton
that
allows selecting a new base date for this Calendar.showDatePickerButton
- Default value is nullpublic java.lang.Boolean getShowDatePickerButton()
datePickerButton
that
allows selecting a new base date for this Calendar.public void setShowDayHeaders(java.lang.Boolean showDayHeaders) throws java.lang.IllegalStateException
month view
, with both cells having a minimum combined height
of minimumDayHeight
. If false, the header
cells will not be shown, and the value of minimumDayHeight
is ignored. This causes the available vertical space in month views to be shared equally between day
cells, such that no vertical scrollbar is required unless the HTML in the cells renders them taller than will fit.showDayHeaders
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdVisibility overview and related methods
public java.lang.Boolean getShowDayHeaders()
month view
, with both cells having a minimum combined height
of minimumDayHeight
. If false, the header
cells will not be shown, and the value of minimumDayHeight
is ignored. This causes the available vertical space in month views to be shared equally between day
cells, such that no vertical scrollbar is required unless the HTML in the cells renders them taller than will fit.Visibility overview and related methods
public void setShowDayLanes(java.lang.Boolean showDayLanes) throws java.lang.IllegalStateException
day view
uses lanes
to render multiple vertical "lanes" within the day, very
much like a vertical Timeline
. Day lanes are useful for showing events for various entities on the same day - agendas for various staff members, for example, or delivery schedules for a fleet of trucks.
Each day lane is self-contained, showing in a column with a header and individual events are
placed in appropriate lanes
, respecting padding and
overlapping. If canEditEvents
is true, events
can be drag-moved or drag-resized from their top and bottom edges, within the containing lane. To allow events to be
dragged from one lane into another, see canEditLane
.
If this method is called after the component has been drawn/initialized:
Changes the view mode
of the day view at runtime - whether to show a normal day column for the chosenDate
, or the specified set of vertical lanes
.
showDayLanes
- whether or not to show lanes in the day view. Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowDayLanes()
day view
uses lanes
to render multiple vertical "lanes" within the day, very
much like a vertical Timeline
. Day lanes are useful for showing events for various entities on the same day - agendas for various staff members, for example, or delivery schedules for a fleet of trucks.
Each day lane is self-contained, showing in a column with a header and individual events are
placed in appropriate lanes
, respecting padding and
overlapping. If canEditEvents
is true, events
can be drag-moved or drag-resized from their top and bottom edges, within the containing lane. To allow events to be
dragged from one lane into another, see canEditLane
.
public void setShowDetailFields(java.lang.Boolean showDetailFields) throws java.lang.IllegalStateException
detail:true
when a DataBoundComponent is given a DataSource but no
component.fields
. The detail
property is used on DataSource fields to mark fields that
shouldn't appear by default in a view that tries to show many records in a small space.
setShowDetailFields
in interface DataBoundComponent
showDetailFields
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdDatabinding overview and related methods
public java.lang.Boolean getShowDetailFields()
detail:true
when a DataBoundComponent is given a DataSource but no
component.fields
. The detail
property is used on DataSource fields to mark fields that
shouldn't appear by default in a view that tries to show many records in a small space.
getShowDetailFields
in interface DataBoundComponent
Databinding overview and related methods
public void setShowDragHovers(java.lang.Boolean showDragHovers)
showViewHovers
is true, dictates whether to
display hover prompts when an event is being dragged with the mouse. The content of the hover is determined by a
call to getDragHoverHTML()
, which can be
overridden to return custom results; by default, it returns the date range of the drag canvas as a string.
showDragHovers
- Default value is falsepublic java.lang.Boolean getShowDragHovers()
showViewHovers
is true, dictates whether to
display hover prompts when an event is being dragged with the mouse. The content of the hover is determined by a
call to getDragHoverHTML()
, which can be
overridden to return custom results; by default, it returns the date range of the drag canvas as a string.
public void setShowEventDescriptions(boolean showEventDescriptions) throws java.lang.IllegalStateException
canvas
for an event, whether to
show the body area
, typically containing brief
details of the event - by default
, its description
. The default is true - if set to
false, the event's header
will fill the canvas.
showEventDescriptions
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic boolean getShowEventDescriptions()
canvas
for an event, whether to
show the body area
, typically containing brief
details of the event - by default
, its description
. The default is true - if set to
false, the event's header
will fill the canvas.
public void setShowEventHeaders(boolean showEventHeaders) throws java.lang.IllegalStateException
canvas
for an event, whether to
show the header area
, typically containing
suitable title text - by default
, the event's
name
. The default is true - if set to false, the
event's body area
will fill the canvas.
showEventHeaders
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic boolean getShowEventHeaders()
canvas
for an event, whether to
show the header area
, typically containing
suitable title text - by default
, the event's
name
. The default is true - if set to false, the
event's body area
will fill the canvas.
public void setShowEventHovers(java.lang.Boolean showEventHovers)
showViewHovers
is true, dictates whether to
display hover prompts when the mouse moves over an event canvas
in a calendarView. The content of the hover is determined by a call to getCellHoverHTML()
, which can be overridden to return
custom results.
showEventHovers
- Default value is truepublic java.lang.Boolean getShowEventHovers()
showViewHovers
is true, dictates whether to
display hover prompts when the mouse moves over an event canvas
in a calendarView. The content of the hover is determined by a call to getCellHoverHTML()
, which can be overridden to return
custom results.
public void setShowHeaderHovers(java.lang.Boolean showHeaderHovers) throws java.lang.IllegalStateException
showViewHovers
is true, dictates whether to
display hover prompts when the mouse rolls over the header levels
in a CalendarView
. The content of the hover is
determined by a call to getHeaderHoverHTML()
,
which can be overridden to return custom results;
showHeaderHovers
- Default value is falsejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowHeaderHovers()
showViewHovers
is true, dictates whether to
display hover prompts when the mouse rolls over the header levels
in a CalendarView
. The content of the hover is
determined by a call to getHeaderHoverHTML()
,
which can be overridden to return custom results;
public void setShowIndicators(java.lang.Boolean showIndicators)
indicators
into
timeline views
.showIndicators
- Default value is nullpublic java.lang.Boolean getShowIndicators()
indicators
into
timeline views
.public void setShowIndicatorsInFront(boolean showIndicatorsInFront) throws java.lang.IllegalStateException
indicator lines
are showing, this attribute
affects where in the z-order their canvases will be rendered: either in front of, or behind normal calendar events.showIndicatorsInFront
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic boolean getShowIndicatorsInFront()
indicator lines
are showing, this attribute
affects where in the z-order their canvases will be rendered: either in front of, or behind normal calendar events.public void setShowLaneFieldHovers(java.lang.Boolean showLaneFieldHovers)
showViewHovers
is true, dictates whether to
display hover prompts when the mouse moves over the cells in a laneField
. The content of the hover is determined by a
call to getCellHoverHTML()
, which can be
overridden to return custom results. Note that getCellHoverHTML() is also called when the mouse moves over cells if
showCellHovers
is true - when called for a
laneField, no "date" parameter is passed to that method.
showLaneFieldHovers
- Default value is falsepublic java.lang.Boolean getShowLaneFieldHovers()
showViewHovers
is true, dictates whether to
display hover prompts when the mouse moves over the cells in a laneField
. The content of the hover is determined by a
call to getCellHoverHTML()
, which can be
overridden to return custom results. Note that getCellHoverHTML() is also called when the mouse moves over cells if
showCellHovers
is true - when called for a
laneField, no "date" parameter is passed to that method.
public void setShowLaneRollOver(java.lang.Boolean showLaneRollOver)
Timelines
, and day views
with showDayLanes
set, to highlight the Lane under the mouse
with the "Over" style.showLaneRollOver
- Default value is nullpublic java.lang.Boolean getShowLaneRollOver()
Timelines
, and day views
with showDayLanes
set, to highlight the Lane under the mouse
with the "Over" style.public void setShowMonthButton(java.lang.Boolean showMonthButton)
Month
button from
displaying on Handset devices.showMonthButton
- Default value is nullpublic java.lang.Boolean getShowMonthButton()
Month
button from
displaying on Handset devices.public void setShowNextButton(java.lang.Boolean showNextButton)
Next
button.showNextButton
- Default value is nullpublic java.lang.Boolean getShowNextButton()
Next
button.public void setShowOtherDays(java.lang.Boolean showOtherDays) throws java.lang.IllegalStateException
month view
, days that fall in
an adjacent month are still shown with a header and body area, and are interactive. Otherwise days from other months
are rendered in the otherDayBlankStyle
and
are non-interactive.showOtherDays
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdVisibility overview and related methods
public java.lang.Boolean getShowOtherDays()
month view
, days that fall in
an adjacent month are still shown with a header and body area, and are interactive. Otherwise days from other months
are rendered in the otherDayBlankStyle
and
are non-interactive.Visibility overview and related methods
public void setShowPreviousButton(java.lang.Boolean showPreviousButton)
Previous
button.showPreviousButton
- Default value is nullpublic java.lang.Boolean getShowPreviousButton()
Previous
button.public void setShowQuickEventDialog(java.lang.Boolean showQuickEventDialog) throws java.lang.IllegalStateException
showQuickEventDialog
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdEditing overview and related methods
public java.lang.Boolean getShowQuickEventDialog()
Editing overview and related methods
public void setShowTimelineView(java.lang.Boolean showTimelineView)
Timeline view
.showTimelineView
- Default value is falsepublic java.lang.Boolean getShowTimelineView()
Timeline view
.public void setShowViewHovers(java.lang.Boolean showViewHovers)
See showEventHovers
, showZoneHovers
, showHeaderHovers
, showCellHovers
, showLaneFieldHovers
, showDragHovers
for further configuration options.
If this method is called after the component has been drawn/initialized:
Switches the various levels of hovers
on or off at runtime.
showViewHovers
- whether to allow CalendarViews to show hovers. Default value is truepublic java.lang.Boolean getShowViewHovers()
See showEventHovers
, showZoneHovers
, showHeaderHovers
, showCellHovers
, showLaneFieldHovers
, showDragHovers
for further configuration options.
public void setShowWeekends(java.lang.Boolean showWeekends)
week
,
month
and timeline
views, and disallows the creation of events on
weekends. Which days are considered weekends is controlled by weekendDays
.
showWeekends
at runtime.showWeekends
- whether or not to show weekends. Default value is trueVisibility overview and related methods
public java.lang.Boolean getShowWeekends()
week
,
month
and timeline
views, and disallows the creation of events on
weekends. Which days are considered weekends is controlled by weekendDays
.Visibility overview and related methods
public void setShowWorkday(java.lang.Boolean showWorkday) throws java.lang.IllegalStateException
workdayBaseStyle
for cells falling within the workday as defined by workdayStart
and workdayEnd
, in both the weekView
and dayView
. The hours of the workday can be customized for
particular dates by providing implementations of getWorkdayStart()
and getWorkdayEnd()
.
showWorkday
- Default value is falsejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowWorkday()
workdayBaseStyle
for cells falling within the workday as defined by workdayStart
and workdayEnd
, in both the weekView
and dayView
. The hours of the workday can be customized for
particular dates by providing implementations of getWorkdayStart()
and getWorkdayEnd()
.
public void setShowZoneHovers(java.lang.Boolean showZoneHovers)
showViewHovers
is true, dictates whether to
display hover prompts when the mouse moves over a zone
in
a calendarView. When showCellHovers
is true,
this attribute is ignored and zone hovers are not displayed.
The content of the hover is determined by a call to
getZoneHoverHTML()
, which can be overridden to
return custom results.
showZoneHovers
- Default value is truepublic java.lang.Boolean getShowZoneHovers()
showViewHovers
is true, dictates whether to
display hover prompts when the mouse moves over a zone
in
a calendarView. When showCellHovers
is true,
this attribute is ignored and zone hovers are not displayed.
The content of the hover is determined by a call to
getZoneHoverHTML()
, which can be overridden to
return custom results.
public void setShowZones(java.lang.Boolean showZones)
zones
into timeline views
.showZones
- Default value is nullpublic java.lang.Boolean getShowZones()
zones
into timeline views
.public void setSizeEventsToGrid(java.lang.Boolean sizeEventsToGrid) throws java.lang.IllegalStateException
sizeEventsToGrid
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getSizeEventsToGrid()
public void setStartDate(java.util.Date startDate) throws java.lang.IllegalStateException
timeline view
. Has no effect in
other views. If not specified, defaults to a timeline starting from the beginning of the current timelineGranularity
and spanning a default of 20
columns of that granularity.
To set different start and end
dates after initial
draw, see setTimelineRange
.
Note that this
attribute may be automatically altered if showing header-levels
, to fit to header boundaries.
startDate
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.util.Date getStartDate()
timeline view
. Has no effect in
other views. If not specified, defaults to a timeline starting from the beginning of the current timelineGranularity
and spanning a default of 20
columns of that granularity.
To set different start and end
dates after initial
draw, see setTimelineRange
.
Note that this
attribute may be automatically altered if showing header-levels
, to fit to header boundaries.
public void setStartDateField(java.lang.String startDateField) throws java.lang.IllegalStateException
CalendarEvent
.startDateField
- Default value is "startDate"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getStartDateField()
CalendarEvent
.CalendarEvent
public void setSublaneNameField(java.lang.String sublaneNameField) throws java.lang.IllegalStateException
sublane
in
which this event will be displayed, within its parent Lane, in Timeline
s
and in the day view
, if showDayLanes
is true.sublaneNameField
- Default value is "sublane"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getSublaneNameField()
sublane
in
which this event will be displayed, within its parent Lane, in Timeline
s
and in the day view
, if showDayLanes
is true.public void setTimelineGranularity(TimeUnit timelineGranularity) throws java.lang.IllegalStateException
timelineView
will
display events. Possible values are those available in the built-in TimeUnit
type.timelineGranularity
- Default value is "day"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic TimeUnit getTimelineGranularity()
timelineView
will
display events. Possible values are those available in the built-in TimeUnit
type.public void setTimelineUnitsPerColumn(int timelineUnitsPerColumn) throws java.lang.IllegalStateException
timelineGranularity
each
cell represents.timelineUnitsPerColumn
- Default value is 1java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getTimelineUnitsPerColumn()
timelineGranularity
each
cell represents.public CalendarView getTimelineView() throws java.lang.IllegalStateException
CalendarView
used to display events in lanes in a horizontal Timeline
view.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setTimelineViewTitle(java.lang.String timelineViewTitle) throws java.lang.IllegalStateException
timeline view
.timelineViewTitle
- Default value is "Timeline"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getTimelineViewTitle()
timeline view
.public void setTodayBackgroundColor(java.lang.String todayBackgroundColor) throws java.lang.IllegalStateException
CalendarView
s.todayBackgroundColor
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getTodayBackgroundColor()
CalendarView
s.public void setTrailingDateField(java.lang.String trailingDateField) throws java.lang.IllegalStateException
leadingDateField
are present in the data, a line
extends out from the event showing the extent of the leading and trailing dates - useful for visualizing a pipeline of
events where some can be moved a certain amount without affecting others.trailingDateField
- Default value is "trailingDate"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getTrailingDateField()
leadingDateField
are present in the data, a line
extends out from the event showing the extent of the leading and trailing dates - useful for visualizing a pipeline of
events where some can be moved a certain amount without affecting others.CalendarEvent
public void setTwentyFourHourTime(java.lang.Boolean twentyFourHourTime) throws java.lang.IllegalStateException
eventEditor
to hide the
AM/PM picker and provide the full 24-hour range in the hour picker.twentyFourHourTime
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getTwentyFourHourTime()
eventEditor
to hide the
AM/PM picker and provide the full 24-hour range in the hour picker.public void setUseEventCanvasRolloverControls(boolean useEventCanvasRolloverControls) throws java.lang.IllegalStateException
close buttons
and the
horizontal
and vertical
resizer widgets for event canvases are
shown only when the mouse is over a given event. Set this attribute to false to have event canvases show these widgets
permanently.useEventCanvasRolloverControls
- Default value is truejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic boolean getUseEventCanvasRolloverControls()
close buttons
and the
horizontal
and vertical
resizer widgets for event canvases are
shown only when the mouse is over a given event. Set this attribute to false to have event canvases show these widgets
permanently.public void setUseSublanes(java.lang.Boolean useSublanes) throws java.lang.IllegalStateException
useSublanes
- Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getUseSublanes()
public void setWeekendDays(int... weekendDays)
globally
.weekendDays
- Default value is nullVisibility overview and related methods
public int[] getWeekendDays()
globally
.Visibility overview and related methods
public void setWeekEventBorderOverlap(java.lang.Boolean weekEventBorderOverlap) throws java.lang.IllegalStateException
weekEventBorderOverlap
- Default value is falsejava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.Boolean getWeekEventBorderOverlap()
Appearance overview and related methods
public void setWeekPrefix(java.lang.String weekPrefix) throws java.lang.IllegalStateException
week-based
HeaderLevel
s when this calendar is showing a timeline.weekPrefix
- See HTMLString
. Default value is "Week"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getWeekPrefix()
week-based
HeaderLevel
s when this calendar is showing a timeline.HTMLString
public CalendarView getWeekView() throws java.lang.IllegalStateException
CalendarView
used to display events that pertain to a given week.
For an overview of how to use and configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public void setWeekViewTitle(java.lang.String weekViewTitle) throws java.lang.IllegalStateException
week view
.weekViewTitle
- Default value is "Week"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getWeekViewTitle()
week view
.public void setWorkdayBaseStyle(java.lang.String workdayBaseStyle) throws java.lang.IllegalStateException
showWorkday
is set, this is the style used for
cells that are within the workday, as defined by workdayStart
and workdayEnd
, or by a date-specific
range provided in getWorkdayStart()
and getWorkdayEnd()
implementations.workdayBaseStyle
- See CSSStyleName
. Default value is "calendarWorkday"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.String getWorkdayBaseStyle()
showWorkday
is set, this is the style used for
cells that are within the workday, as defined by workdayStart
and workdayEnd
, or by a date-specific
range provided in getWorkdayStart()
and getWorkdayEnd()
implementations.CSSStyleName
Appearance overview and related methods
public ZoneCanvas getZoneCanvas()
Using AutoChildren
for details.
AutoChild component created for each zone
entry.
public void setZones(CalendarEvent... zones)
timeline views
. Each zone renders out a zone canvas
, a special, non-interactive subclass of EventCanvas
, which spans all lanes and draws behind any normal, interactive
events in the zorder. The default style
for
these components renders them semi-transparent and with a bottom-aligned title label.
If this method is called after the component has been drawn/initialized:
Sets the zones
used to highlight areas of this calendar.
zones
- array of zones to display. Default value is nullpublic CalendarEvent[] getZones()
timeline views
. Each zone renders out a zone canvas
, a special, non-interactive subclass of EventCanvas
, which spans all lanes and draws behind any normal, interactive
events in the zorder. The default style
for
these components renders them semi-transparent and with a bottom-aligned title label.
public void setZoneStyleName(java.lang.String zoneStyleName)
zoneStyleName
- See CSSStyleName
. Default value is "zoneCanvas"public java.lang.String getZoneStyleName()
CSSStyleName
public void setZoneTitleOrientation(VerticalAlignment zoneTitleOrientation) throws java.lang.IllegalStateException
zone
.zoneTitleOrientation
- Default value is "bottom"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic VerticalAlignment getZoneTitleOrientation()
zone
.public void addCalendarEvent(CalendarEvent event)
In all cases, the event
passed as the first parameter must have at least a start date
set. If the calendar is showing lanes
, the name of the lane
and, if applicable, the sublane
, must also be set.
event
- the new calendar event to addpublic void addCalendarEvent(CalendarEvent event, java.util.Map customValues)
In all cases, the event
passed as the first parameter must have at least a start date
set. If the calendar is showing lanes
, the name of the lane
and, if applicable, the sublane
, must also be set.
event
- the new calendar event to addcustomValues
- additional, custom values to be saved with the eventpublic void addIndicator(CalendarEvent indicator)
indicator
to the calendar.indicator
- a new indicator to add to the calendarpublic void addLane(Lane lane)
Lane
to the calendar, for display in the timeline view
, and in the day view
if showDayLanes
is true.lane
- a new Lane object to add to the calendarpublic void addLaneEvent(Lane laneName, java.util.Date startDate)
addCalendarEvent()
Timeline
s, and for dayView
with showDayLanes
set, creates a new event and adds it to a
particular Lane
.laneName
- the Lane in which to add this eventstartDate
- start date of event, or CalendarEvent Objectpublic void addLaneEvent(Lane laneName, java.util.Date startDate, java.util.Date endDate)
public void addLaneEvent(Lane laneName, java.util.Date startDate, java.util.Date endDate, java.lang.String name)
public void addLaneEvent(Lane laneName, java.util.Date startDate, java.util.Date endDate, java.lang.String name, java.lang.String description)
public void addLaneEvent(Lane laneName, java.util.Date startDate, java.util.Date endDate, java.lang.String name, java.lang.String description, java.lang.Object otherFields)
addCalendarEvent()
Timeline
s, and for dayView
with showDayLanes
set, creates a new event and adds it to a
particular Lane
.laneName
- the Lane in which to add this eventstartDate
- start date of event, or CalendarEvent ObjectendDate
- end date of eventname
- name of eventdescription
- description of eventotherFields
- new values of additional fields to be updatedpublic void addZone(CalendarEvent zone)
zone
to the calendar.zone
- a new zone to add to the calendarpublic com.google.gwt.event.shared.HandlerRegistration addBackgroundClickHandler(BackgroundClickHandler handler)
Callback fired when the mouse is clicked in a background-cell, ie, one without an event.
addBackgroundClickHandler
in interface HasBackgroundClickHandlers
handler
- the backgroundClick handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addBackgroundMouseDownHandler(BackgroundMouseDownHandler handler)
Callback fired when the mouse button is depressed over a background-cell, ie, one without an event. Call BackgroundMouseDownEvent.cancel()
from within BackgroundMouseDownHandler.onBackgroundMouseDown(com.smartgwt.client.widgets.calendar.events.BackgroundMouseDownEvent)
to cancel the default
behavior of allowing sweep selection via dragging.
addBackgroundMouseDownHandler
in interface HasBackgroundMouseDownHandlers
handler
- the backgroundMouseDown handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addBackgroundMouseUpHandler(BackgroundMouseUpHandler handler)
Notification method fired when the mouse button is released over a background-cell, ie, one without an event. Call
BackgroundMouseUpEvent.cancel()
from within BackgroundMouseUpHandler.onBackgroundMouseUp(com.smartgwt.client.widgets.calendar.events.BackgroundMouseUpEvent)
to cancel the default behavior
of showing a dialog to add a new event with the passed dates.
addBackgroundMouseUpHandler
in interface HasBackgroundMouseUpHandlers
handler
- the backgroundMouseUp handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addCurrentViewChangedHandler(CurrentViewChangedHandler handler)
Notification that fires whenever the current view changes via the mainView tabset
.
addCurrentViewChangedHandler
in interface HasCurrentViewChangedHandlers
handler
- the currentViewChanged handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addDateChangedHandler(DateChangedHandler handler)
Fires whenever the user changes the current date, including picking a specific date or navigating to a new week or month.
addDateChangedHandler
in interface HasDateChangedHandlers
handler
- the dateChanged handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addDayBodyClickHandler(DayBodyClickHandler handler)
Called when the body area of a day in the month view is clicked on, outside of any links to a particular event.
By
default, if the user can add events, shows a dialog for adding a new event for that day. Call DayBodyClickEvent.cancel()
from within DayBodyClickHandler.onDayBodyClick(com.smartgwt.client.widgets.calendar.events.DayBodyClickEvent)
to cancel this action.
Not called if
the day falls outside the current month and Calendar.showOtherDays
is false.
addDayBodyClickHandler
in interface HasDayBodyClickHandlers
handler
- the dayBodyClick handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addDayHeaderClickHandler(DayHeaderClickHandler handler)
Called when the header area of a day in the month view is clicked on.
By default, moves to the day tab and shows the
clicked days events. Call DayHeaderClickEvent.cancel()
from within
DayHeaderClickHandler.onDayHeaderClick(com.smartgwt.client.widgets.calendar.events.DayHeaderClickEvent)
to cancel this action.
Not called if the day falls outside the current month and Calendar.showOtherDays
is false.
addDayHeaderClickHandler
in interface HasDayHeaderClickHandlers
handler
- the dayHeaderClick handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventAddedHandler(EventAddedHandler handler)
Notification fired whenever a user adds an event.
In a calendar with a DataSource, eventAdded() fires after the event has been successfully added at the server
addEventAddedHandler
in interface HasEventAddedHandlers
handler
- the eventAdded handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventChangedHandler(EventChangedHandler handler)
Notification fired whenever a user changes an event, whether by dragging the event or by editing it in a dialog.
In a calendar with a DataSource, eventChanged() fires after the updated event has been successfully saved to the server
addEventChangedHandler
in interface HasEventChangedHandlers
handler
- the eventChanged handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventClickHandler(EventClickHandler handler)
Called whenever an event is clicked on in the day, week or month views.
By default a dialog appears showing details
for the event, and offering the ability to edit events which are editable. Call CalendarEventClick.cancel()
from within EventClickHandler.onEventClick(com.smartgwt.client.widgets.calendar.events.CalendarEventClick)
to cancel the default action. This is a good
place to, for example, show a completely customized event dialog instead of the default one.
addEventClickHandler
in interface HasEventClickHandlers
handler
- the eventClick handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventMovedHandler(EventMovedHandler handler)
Called when an event is moved via dragging by a user. Call CalendarEventMoved.cancel()
from within EventMovedHandler.onEventMoved(com.smartgwt.client.widgets.calendar.events.CalendarEventMoved)
to disallow the move.
addEventMovedHandler
in interface HasEventMovedHandlers
handler
- the eventMoved handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventRemoveClickHandler(EventRemoveClickHandler handler)
Called whenever the close icon of an event canvas
is clicked in
the day
, week
and timeline
views, or when the remove button
is pressed in the event editor
.
Implement this method to intercept the
automatic removal of data. You can Call CalendarEventRemoveClick.cancel()
from within EventRemoveClickHandler.onEventRemoveClick(com.smartgwt.client.widgets.calendar.events.CalendarEventRemoveClick)
to prevent the default action
(calling removeEvent()
) and instead take action of
your own. For example, returning false from this method and then showing a custom confirmation dialog - if the user
cancels, do nothing, otherwise make a call to removeEvent(event)
, passing the event.
addEventRemoveClickHandler
in interface HasEventRemoveClickHandlers
handler
- the eventRemoveClick handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventRemovedHandler(EventRemovedHandler handler)
Notification fired whenever a user removes an event.
In a calendar with a DataSource, eventRemoved() fires after the event has been successfully removed from the server
addEventRemovedHandler
in interface HasEventRemovedHandlers
handler
- the eventRemoved handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventRepositionMoveHandler(EventRepositionMoveHandler handler)
Notification called whenever the drop position of an event being drag-moved changes.
The newEvent
parameter represents the event as it will be after the move, including start
and end
dates and lane
and sublane
where applicable.
Call EventRepositionMove.cancel()
from within EventRepositionMoveHandler.onEventRepositionMove(com.smartgwt.client.widgets.calendar.events.EventRepositionMove)
to prevent the default
action, of positioning the drag canvas to the newEvent.
addEventRepositionMoveHandler
in interface HasEventRepositionMoveHandlers
handler
- the eventRepositionMove handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventRepositionStopHandler(EventRepositionStopHandler handler)
Notification called when an event being drag-moved is dropped.
The newEvent
parameter represents the
event as it will be after the move, including start
and end
dates and lane
and sublane
where applicable.
Call EventRepositionStop.cancel()
from within EventRepositionStopHandler.onEventRepositionStop(com.smartgwt.client.widgets.calendar.events.EventRepositionStop)
to prevent the default
action, of actually updating
the event.
addEventRepositionStopHandler
in interface HasEventRepositionStopHandlers
handler
- the eventRepositionStop handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventResizedHandler(EventResizedHandler handler)
Called when an event is resized with the mouse. The passed date value is the new *end* date for the event, since resizing can only be performed on the bottom edge of an event in normal calendar views.
addEventResizedHandler
in interface HasEventResizedHandlers
handler
- the eventResized handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventResizeMoveHandler(EventResizeMoveHandler handler)
Notification called on each resize during an event drag-resize operation.
The newEvent
parameter
represents the event as it will be after the resize.
Call EventResizeMove.cancel()
from within EventResizeMoveHandler.onEventResizeMove(com.smartgwt.client.widgets.calendar.events.EventResizeMove)
to prevent the default action, of
resizing the drag canvas to the newEvent.
addEventResizeMoveHandler
in interface HasEventResizeMoveHandlers
handler
- the eventResizeMove handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventResizeStopHandler(EventResizeStopHandler handler)
Notification called when an event drag-resize operation completes.
The newEvent
parameter represents
the event as it will be after the move.
Call EventResizeStop.cancel()
from within EventResizeStopHandler.onEventResizeStop(com.smartgwt.client.widgets.calendar.events.EventResizeStop)
to prevent the default action, of
actually updating
the event.
addEventResizeStopHandler
in interface HasEventResizeStopHandlers
handler
- the eventResizeStop handlerHandlerRegistration
used to remove this handlerpublic void eventsRendered()
public java.lang.Integer getActiveDay()
getActiveTime()
public java.util.Date getActiveTime()
public java.util.Date getCellDate()
To determine the date at a more specific point within a cell, see getDateFromPoint()
.
public java.util.Date getCellDate(java.lang.Integer rowNum)
getCellDate()
public java.util.Date getCellDate(java.lang.Integer rowNum, java.lang.Integer colNum)
getCellDate()
public java.util.Date getCellDate(java.lang.Integer rowNum, java.lang.Integer colNum, CalendarView view)
To determine the date at a more specific point within a cell, see getDateFromPoint()
.
rowNum
- the row number to get the date forcolNum
- the column number to get the date forview
- the view to use - uses the selected view if not passedpublic java.lang.String getCellHoverHTML(CalendarView view, Record record, java.lang.Integer rowNum, java.lang.Integer colNum, java.util.Date date, java.lang.String defaultValue)
laneField
being hovered over. Override here to return custom HTML for the passed cell.
view
- the CalendarView the mouse is hovered overrecord
- The record containing the cell being hoveredrowNum
- The rowNum of the cell being hoveredcolNum
- the colNum of the cell being hovereddate
- the snap-date at the mouse, which may be different from the result of a call to getCellDate
defaultValue
- the default hover text for the passed valuespublic java.lang.String getDateCellAlign(java.util.Date date, java.lang.Integer rowNum, java.lang.Integer colNum, CalendarView view)
getDateHTML
returns a value, this method returns
the horizontal alignment for that value in its cell, in the passed view.date
- the date to get the cell-alignment forrowNum
- the row number containing the date to get the cell-alignment forcolNum
- the column number containing the date to get the cell-alignment forview
- the relevant CalendarViewgetDateHTML(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateCellVAlign(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateStyle(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateCSSText(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
public java.lang.String getDateCellVAlign(java.util.Date date, java.lang.Integer rowNum, java.lang.Integer colNum, CalendarView view)
getDateHTML
returns a value, this method returns
the vertical alignment for that value in its cell, in the passed view.date
- the date to get the cell-alignment forrowNum
- the row number containing the date to get the cell-alignment forcolNum
- the column number containing the date to get the cell-alignment forview
- the relevant CalendarViewgetDateHTML(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateCellAlign(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateStyle(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateCSSText(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
public java.lang.String getDateCSSText(java.util.Date date, java.lang.Integer rowNum, java.lang.Integer colNum, CalendarView view)
"CSS text" means semicolon-separated style settings, suitable for inclusion in a CSS stylesheet or in a STYLE attribute of an HTML element.
date
- the date to return CSS text forrowNum
- the row number containing the date to get the CSS forcolNum
- the column number containing the date to get the CSS forview
- the relevant CalendarViewgetDateHTML(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateStyle(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
public java.util.Date getDateFromPoint()
If
snapOffsets is passed as false, returns the date representing the exact position of the passed offsets. If unset or
passed as true, returns the date at the nearest eventSnapGap to the left, for Timeline
s, or above for day
and week
views.
If neither x nor y offsets are passed, assumes them from the last mouse event.
If the cell at the eventual offsets is not a date-cell, returns null.
Note that, for the month view
, this method is
functionally equivalent to getCellDate()
, which
determines the date associated with a cell, without the additional offset precision offered here.
public java.util.Date getDateFromPoint(java.lang.Integer x)
getDateFromPoint()
public java.util.Date getDateFromPoint(java.lang.Integer x, java.lang.Integer y)
getDateFromPoint()
public java.util.Date getDateFromPoint(java.lang.Integer x, java.lang.Integer y, java.lang.Boolean snapOffsets)
getDateFromPoint()
public java.util.Date getDateFromPoint(java.lang.Integer x, java.lang.Integer y, java.lang.Boolean snapOffsets, CalendarView view)
If
snapOffsets is passed as false, returns the date representing the exact position of the passed offsets. If unset or
passed as true, returns the date at the nearest eventSnapGap to the left, for Timeline
s, or above for day
and week
views.
If neither x nor y offsets are passed, assumes them from the last mouse event.
If the cell at the eventual offsets is not a date-cell, returns null.
Note that, for the month view
, this method is
functionally equivalent to getCellDate()
, which
determines the date associated with a cell, without the additional offset precision offered here.
x
- the x offset into the body of the selected view - non-functional for the day view
. If this param and "y" are both unset,
assumes both offsets from the last mouse event.y
- the y offset into the body of the selected view - non-functional for the timeline view
. If this param and "x" are
both unset, assumes both offsets from the last mouse event.snapOffsets
- whether to snap the offsets to the nearest eventSnapGap - if unset, the default is trueview
- the view to use - or the selected view if not passedpublic java.lang.String getDateHeaderTitle(java.util.Date date, int dayOfWeek, java.lang.String defaultValue, CalendarView view)
date
- the date to return the header-title for - note that the month view
does not pass this parameter
because a single column represents multiple datesdayOfWeek
- the week-day number of the passed date, except for the month view
, where no date is passed,
because the week-day number represents multiple dates.defaultValue
- the default header-title for the passed date and viewview
- the relevant CalendarViewpublic java.lang.String getDateHTML(java.util.Date date, java.lang.Integer rowNum, java.lang.Integer colNum, CalendarView view)
month view
has default cell HTML, controlled via getDayBodyHTML()
.date
- the date to get the HTML forrowNum
- the row number containing the date to get the HTML forcolNum
- the column number containing the date to get the HTML forview
- the relevant CalendarViewgetDateCellAlign(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateCellVAlign(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateStyle(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateCSSText(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDayBodyHTML(java.util.Date, com.smartgwt.client.widgets.calendar.CalendarEvent[], com.smartgwt.client.widgets.calendar.Calendar, int, int)
public java.lang.String getDateStyle(java.util.Date date, java.lang.Integer rowNum, java.lang.Integer colNum, CalendarView view)
date
- the date to return the CSS styleName forrowNum
- the row number containing the date to get the CSS styleName forcolNum
- the column number containing the date to get the CSS styleName forview
- the relevant CalendarViewgetDateHTML(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
,
getDateCSSText(java.util.Date, java.lang.Integer, java.lang.Integer, com.smartgwt.client.widgets.calendar.CalendarView)
public java.lang.String getDragHoverHTML(CalendarView view, CalendarEvent event, java.lang.String defaultValue)
view
- the CalendarView the mouse is hovered overevent
- the CalendarEvent attached to the EventCanvas being draggeddefaultValue
- the default text for the passed valuespublic java.lang.String getEventBodyHTML(CalendarEvent event)
description
field
.event
- the event to get the description text forpublic java.lang.String getEventBodyHTML(CalendarEvent event, CalendarView view)
description
field
.event
- the event to get the description text forview
- the view in which the event is being renderedpublic MenuItem[] getEventCanvasMenuItems(EventCanvas canvas)
items
applicable to the passed canvas and its event. If an array with valid entries is returned, the rollover context button
is shown for the passed
canvas.canvas
- the canvas to get menu items forpublic java.lang.String getEventCanvasStyle(CalendarEvent event)
styleName
to use for the passed event
, in the passed view
. By default, returns the style on the event
, if one is specified - otherwise, in
lane-based
views, it returns the style specified on the
lane or sublane
, or the style specified on the
calendar
.event
- the event to get the CSS style forpublic java.lang.String getEventCanvasStyle(CalendarEvent event, CalendarView view)
styleName
to use for the passed event
, in the passed view
. By default, returns the style on the event
, if one is specified - otherwise, in
lane-based
views, it returns the style specified on the
lane or sublane
, or the style specified on the
calendar
.event
- the event to get the CSS style forview
- the CalendarView that contains the canvas being styledpublic java.util.Date getEventEndDate(CalendarEvent event)
end date
of the passed event. If the
event is duration-based
, the result is
calculated from the start date
and the
specified duration
and unit
.event
- the event to get the start date ofpublic java.lang.String getEventHeaderHTML(CalendarEvent event)
name field
for
timelines, and that same value pre-pended with the event's start
and end
dates for day and week views.event
- the event to get the description text forpublic java.lang.String getEventHeaderHTML(CalendarEvent event, CalendarView view)
name field
for
timelines, and that same value pre-pended with the event's start
and end
dates for day and week views.event
- the event to get the description text forview
- the view in which the event is being renderedpublic com.google.gwt.event.shared.HandlerRegistration addEventHoverHTMLHandler(EventHoverHTMLHandler handler)
Gets the hover HTML for an event being hovered over. Override here to return custom HTML based upon the parameter event object.
addEventHoverHTMLHandler
in interface HasEventHoverHTMLHandlers
handler
- the eventHoverHTML handlerHandlerRegistration
used to remove this handlerpublic Lane getEventLane(CalendarEvent event)
lane
associated with the passed event, in the passed viewevent
- the event to get the lane forpublic Lane getEventLane(CalendarEvent event, CalendarView view)
lane
associated with the passed event, in the passed viewevent
- the event to get the lane forview
- the view to get the lane object frompublic void getEventLength(CalendarEvent event)
event
in the passed unit
. If unit
isn't passed, returns the length of the event in
milliseconds.event
- the event to get the length ofpublic void getEventLength(CalendarEvent event, TimeUnit unit)
event
in the passed unit
. If unit
isn't passed, returns the length of the event in
milliseconds.event
- the event to get the length ofunit
- the time unit to return the length in, milliseconds if not passedpublic java.util.Date getEventStartDate(CalendarEvent event)
start date
of the passed event.event
- the event to get the start date ofpublic Lane getEventSublane(CalendarEvent event)
sublane
associated with the passed event, in
the passed viewevent
- the event to get the sublane forpublic Lane getEventSublane(CalendarEvent event, CalendarView view)
sublane
associated with the passed event, in
the passed viewevent
- the event to get the sublane forview
- the view to get the sublane object frompublic java.lang.String getHeaderHoverHTML(CalendarView view, HeaderLevel headerLevel, java.util.Date startDate, java.util.Date endDate, java.lang.String defaultValue)
view
- the CalendarView the mouse is hovered overheaderLevel
- the header level hovered overstartDate
- the start date of the span being hovered overendDate
- the end date of the span being hovered overdefaultValue
- the default text for the passed header level and date rangepublic java.lang.String getIndicatorCanvasStyle(CalendarEvent indicator)
styleName
to use for the passed indicator
, in the passed view
. By default, returns the style on the indicator
, if one is specified, or the
style specified on the calendar
otherwise.indicator
- the indicator to get the CSS style forpublic java.lang.String getIndicatorCanvasStyle(CalendarEvent indicator, CalendarView view)
styleName
to use for the passed indicator
, in the passed view
. By default, returns the style on the indicator
, if one is specified, or the
style specified on the calendar
otherwise.indicator
- the indicator to get the CSS style forview
- the CalendarView that contains the canvas being styledpublic java.lang.String getIndicatorHoverHTML(CalendarEvent indicator, IndicatorCanvas indicatorCanvas, CalendarView view, java.lang.String defaultValue)
indicator
being hovered
over. Override here to return custom HTML based upon the parameter indicator object.indicator
- The indicator being hovered overindicatorCanvas
- the indicator canvas being hovered overview
- the CalendarView in which the indicatorCanvas is displayeddefaultValue
- the default HTML to show when hovering over the passed Indicatorpublic Lane getLane(java.lang.String lane)
lane
with the passed name, in the passed viewlane
- the name of the lane to returnpublic Lane getLane(java.lang.String lane, CalendarView view)
lane
with the passed name, in the passed viewlane
- the name of the lane to returnview
- the view to get the lane object frompublic CalendarEvent[] getLaneEvents(Lane lane)
lanes
, returns the array of events
in the current dataset that apply to the passed lane in the passed or current view.lane
- lane object or name to get the events forpublic CalendarEvent[] getLaneEvents(java.lang.String lane)
lanes
, returns the array of events
in the current dataset that apply to the passed lane in the passed or current view.lane
- lane object or name to get the events forpublic CalendarEvent[] getLaneEvents(Lane lane, CalendarView view)
lanes
, returns the array of events
in the current dataset that apply to the passed lane in the passed or current view.lane
- lane object or name to get the events forview
- the view in which the passed lane lives - uses the selected view if unsetpublic Lane getLaneFromPoint()
Lane
at the passed co-ordinates. To get the lane under the
mouse, pass null for both x and y.public Lane getLaneFromPoint(java.lang.Integer x)
getLaneFromPoint()
public Lane getLaneFromPoint(java.lang.Integer x, java.lang.Integer y)
getLaneFromPoint()
public Lane getLaneFromPoint(java.lang.Integer x, java.lang.Integer y, CalendarView view)
Lane
at the passed co-ordinates. To get the lane under the
mouse, pass null for both x and y.x
- the x offset into the body of the selected viewy
- the y offset into the body of the selected view. If this param and "x" are both unset,
assumes both offsets from the last mouse event.view
- the view to get the lane from - selected view if not passedpublic java.lang.Integer getLanePadding()
lanes
, returns the padding to
apply to events rendered in lanes in the passed or current view. By default, returns laneEventPadding
.public java.lang.Integer getLanePadding(CalendarView view)
lanes
, returns the padding to
apply to events rendered in lanes in the passed or current view. By default, returns laneEventPadding
.view
- the view to get the lane padding forpublic java.lang.String getMonthViewHoverHTML(java.util.Date date, CalendarEvent... events)
Default implementation will display a list of the events occurring on the date the user is hovering over. Override for custom behavior. Note that returning null will suppress the hover altogether.
date
- Date the user is hovering overevents
- array of events occurring on the current date. May be empty.public java.util.Date getPeriodEndDate()
month view
, and for the week view
when not showing weekends, this will often be a
different date than that returned by getVisibleEndDate()
.public java.util.Date getPeriodEndDate(CalendarView view)
month view
, and for the week view
when not showing weekends, this will often be a
different date than that returned by getVisibleEndDate()
.view
- the view to get the periodEndDate for, or current view if nullpublic java.util.Date getPeriodStartDate()
getVisibleStartDate()
.public java.util.Date getPeriodStartDate(CalendarView view)
getVisibleStartDate()
.view
- the view to get the periodStartDate for, or current view if nullpublic CalendarView getSelectedView()
view
.public Lane getSublane(java.lang.String lane, java.lang.String sublane)
lane
- the name of the lane containing the sublane to returnsublane
- the name of the sublane to returnpublic Lane getSublane(java.lang.String lane, java.lang.String sublane, CalendarView view)
lane
- the name of the lane containing the sublane to returnsublane
- the name of the sublane to returnview
- the view to get the sublane object frompublic CalendarEvent[] getSublaneEvents(Lane lane, Lane sublane)
lanes
and allow sublanes
, returns the array of events in the current
dataset that apply to the passed lane and sublane in the passed or current view.lane
- lane object or name to get the events forsublane
- sublane object or name to get the events forpublic CalendarEvent[] getSublaneEvents(Lane lane, Lane sublane, CalendarView view)
lanes
and allow sublanes
, returns the array of events in the current
dataset that apply to the passed lane and sublane in the passed or current view.lane
- lane object or name to get the events forsublane
- sublane object or name to get the events forview
- the view in which the passed sublane lives - uses the selected view if unsetpublic Lane getSublaneFromPoint()
sublane
at the passed co-ordinates. To get
the sublane under the mouse, pass null for both x and y.public Lane getSublaneFromPoint(java.lang.Integer x)
getSublaneFromPoint()
public Lane getSublaneFromPoint(java.lang.Integer x, java.lang.Integer y)
getSublaneFromPoint()
public Lane getSublaneFromPoint(java.lang.Integer x, java.lang.Integer y, CalendarView view)
sublane
at the passed co-ordinates. To get
the sublane under the mouse, pass null for both x and y.x
- optional x offset into the body of the selected viewy
- optional y offset into the body of the selected view. If this param and "x" are both unset,
assumes both offsets from the last mouse event.view
- the view to get the sublane from - selected view if not passedpublic CalendarView getView(ViewName viewName)
viewName
- the name of the CalendarView to returnpublic java.util.Date getVisibleEndDate()
public java.util.Date getVisibleEndDate(CalendarView view)
view
- the view to get the endDate for, or current view if nullpublic java.util.Date getVisibleStartDate()
public java.util.Date getVisibleStartDate(CalendarView view)
view
- the view to get the startDate for, or current view ifpublic java.lang.String getZoneCanvasStyle(CalendarEvent zone)
styleName
to use for the passed zone
, in the passed view
. By default, returns the style on the zone
, if one is specified, or the style
specified on the calendar
otherwise.zone
- the zone to get the CSS style forpublic java.lang.String getZoneCanvasStyle(CalendarEvent zone, CalendarView view)
styleName
to use for the passed zone
, in the passed view
. By default, returns the style on the zone
, if one is specified, or the style
specified on the calendar
otherwise.zone
- the zone to get the CSS style forview
- the CalendarView that contains the canvas being styledpublic java.lang.String getZoneHoverHTML(CalendarEvent zone, ZoneCanvas zoneCanvas, CalendarView view, java.lang.String defaultValue)
zone
being hovered over.
Override here to return custom HTML based upon the parameter zone object.zone
- The zone being hovered overzoneCanvas
- the zone canvas being hovered overview
- the CalendarView in which the zoneCanvas is displayeddefaultValue
- the default HTML to show when hovering over the passed Zonepublic void groupLanesBy(java.lang.String groupFieldName)
canGroupLanes
is true, this method allows
the grouping in timeline
s to be altered at
runtime.groupFieldName
- one or more field names to group bypublic void groupLanesBy(java.lang.String... groupFieldName)
canGroupLanes
is true, this method allows
the grouping in timeline
s to be altered at
runtime.groupFieldName
- one or more field names to group bypublic void moveToEvent(CalendarEvent event)
event
- the event to move the calendar view topublic void next()
public void previous()
public void refreshEvent(CalendarEvent event)
event
- The event object to refresh in the current viewpublic void removeIndicator(CalendarEvent indicator)
indicator
from the calendar. Accepts
either a indicator object
or a string that represents the
name
of anindicator.
indicator
- either the actual CalendarEvent representing the indicator, or the name of the indicator to removepublic void removeIndicator(java.lang.String indicator)
indicator
from the calendar. Accepts
either a indicator object
or a string that represents the
name
of anindicator.
indicator
- either the actual CalendarEvent representing the indicator, or the name of the indicator to removepublic void removeZone(CalendarEvent zone)
zone
from the calendar. Accepts either a
zone object
or a string that represents the name
of a zone.
zone
- either the actual CalendarEvent representing the zone, or the name of the zone to removepublic void removeZone(java.lang.String zone)
zone
from the calendar. Accepts either a
zone object
or a string that represents the name
of a zone.
zone
- either the actual CalendarEvent representing the zone, or the name of the zone to removepublic void scrollToTime(java.lang.String time)
time
- any parsable time-stringpublic void selectTab(int tabnum)
tabnum
- the index of the tab to selectpublic void setEventStyle(CalendarEvent event, java.lang.String styleName)
event
- The event object to refresh in the current viewstyleName
- The new CSS style to apply to the canvases showing this event. See CSSStyleName
public void setResolution(HeaderLevel[] headerLevels, TimeUnit unit, java.lang.Integer unitCount)
headerLevels
specifies the array of headers
to show above the timeline, and
the unit
and unitCount
parameters dictate the scrollable range (eg, passing "week" and 6 will
create a timeline with a scrollable range of six weeks, irrespective of the number of columns that requires, according
to the granularity
).
If the optional
granularityPerColumn
parameter is passed, each column will span that number of units of the granularity,
which is determined from the unit of the innermost of the passed headerLevels. For example, to show a span of 12 hours
with inner columns that each span 15 minutes, you could pass "hour" and "minute" -based headerLevels, unit and
unitCount values of "hour" and 12 respectively, and granularityPerColumn of 15.
headerLevels
- the header levels to show in the timelineunit
- the time unit to use when calculating the range of the timelineunitCount
- the count of the passed unit that the timeline should spanpublic void setResolution(HeaderLevel[] headerLevels, TimeUnit unit, java.lang.Integer unitCount, java.lang.Integer granularityPerColumn)
headerLevels
specifies the array of headers
to show above the timeline, and
the unit
and unitCount
parameters dictate the scrollable range (eg, passing "week" and 6 will
create a timeline with a scrollable range of six weeks, irrespective of the number of columns that requires, according
to the granularity
).
If the optional
granularityPerColumn
parameter is passed, each column will span that number of units of the granularity,
which is determined from the unit of the innermost of the passed headerLevels. For example, to show a span of 12 hours
with inner columns that each span 15 minutes, you could pass "hour" and "minute" -based headerLevels, unit and
unitCount values of "hour" and 12 respectively, and granularityPerColumn of 15.
headerLevels
- the header levels to show in the timelineunit
- the time unit to use when calculating the range of the timelineunitCount
- the count of the passed unit that the timeline should spangranularityPerColumn
- how many units of the granularity (the unit of the innermost headerLevel) should each column span? The
default is 1.public void setTimelineRange(java.util.Date start)
If the end
parameter is not passed, the end
date of the range will default to 20
columns of the current granularity
following the start date.
start
- start of rangepublic void setTimelineRange(java.util.Date start, java.util.Date end)
If the end
parameter is not passed, the end
date of the range will default to 20
columns of the current granularity
following the start date.
start
- start of rangeend
- end of rangepublic boolean shouldDisableDate(java.util.Date date)
The default
implementation returns false only for dates that fall on a weekend
.
date
- a Date instancepublic boolean shouldDisableDate(java.util.Date date, CalendarView view)
The default
implementation returns false only for dates that fall on a weekend
.
date
- a Date instanceview
- the view the date appears inpublic boolean shouldShowDate(java.util.Date date)
CalendarView
. The default implementation returns true, unless the date falls
on a weekend
and showWeekends
is false.
date
- a Date instancepublic boolean shouldShowDate(java.util.Date date, CalendarView view)
CalendarView
. The default implementation returns true, unless the date falls
on a weekend
and showWeekends
is false.
date
- a Date instanceview
- the view the date appears inpublic boolean shouldShowEvent(CalendarEvent event)
event
should be visible in the
passed CalendarView
. The default implementation returns true - note that this method only runs for events that are known to be in the accessible range and is a mechanism for extended custom filtering.
event
- the event to checkpublic boolean shouldShowEvent(CalendarEvent event, CalendarView view)
event
should be visible in the
passed CalendarView
. The default implementation returns true - note that this method only runs for events that are known to be in the accessible range and is a mechanism for extended custom filtering.
event
- the event to checkview
- the view the event will be rendered inpublic boolean shouldShowLane(Lane lane)
lane
should be visible in
the passed CalendarView
. The default implementation returns true,
unless the lane has no events and hideUnusedLanes
is true.
lane
- the lane object or namepublic boolean shouldShowLane(java.lang.String lane)
lane
should be visible in
the passed CalendarView
. The default implementation returns true,
unless the lane has no events and hideUnusedLanes
is true.
lane
- the lane object or namepublic boolean shouldShowLane(Lane lane, CalendarView view)
lane
should be visible in
the passed CalendarView
. The default implementation returns true,
unless the lane has no events and hideUnusedLanes
is true.
lane
- the lane object or nameview
- the view the lane appears inpublic void showEventDialog()
event
. The startDate
field on the event is used to calculate the
display location for the dialog.
If this method is called when the Event Dialog is already showing another event, and if changes have been made, a confirmation dialog is displayed and editing of the new event is cancelled unless confirmed.
You can override this method to prevent the default action, perhaps instead showing a custom interface
that performs validations or gathers custom data before making a call to addCalendarEvent
or updateCalendarEvent
when the new data is available.
public void showEventDialog(CalendarEvent event)
showEventDialog()
public void showEventDialog(CalendarEvent event, java.lang.Boolean isNewEvent)
event
. The startDate
field on the event is used to calculate the
display location for the dialog.
If this method is called when the Event Dialog is already showing another event, and if changes have been made, a confirmation dialog is displayed and editing of the new event is cancelled unless confirmed.
You can override this method to prevent the default action, perhaps instead showing a custom interface
that performs validations or gathers custom data before making a call to addCalendarEvent
or updateCalendarEvent
when the new data is available.
event
- the event to show in the EditorisNewEvent
- optional boolean indicating that this is a new event, event if an event is passed - used
to pass defaults for a new eventpublic void showEventEditor()
name
and description
, as well as any custom fields supplied
via eventEditorFields
. If isNewEvent is true, a new event is created - in this case, if an event is passed, it represents default values to apply to the new event.
You can override this method to prevent the default action, perhaps instead showing a custom interface that
performs validations or gathers custom data before making a call to addCalendarEvent
or updateCalendarEvent
when the new data is available.
public void showEventEditor(CalendarEvent event)
showEventEditor()
public void showEventEditor(CalendarEvent event, java.lang.Boolean isNewEvent)
name
and description
, as well as any custom fields supplied
via eventEditorFields
. If isNewEvent is true, a new event is created - in this case, if an event is passed, it represents default values to apply to the new event.
You can override this method to prevent the default action, perhaps instead showing a custom interface that
performs validations or gathers custom data before making a call to addCalendarEvent
or updateCalendarEvent
when the new data is available.
event
- an existing event to show in the EditorisNewEvent
- optional boolean indicating that this is a new event, even if an event is passed - used to
pass defaults for a new eventpublic void showNewEventDialog()
event
.
If passed, the event parameter is used as defaults for the new event - in addition, the event's startDate
, and its lane
, for timeline events, are used to calculate the
display location for the dialog.
If this method is called when the Event Dialog is already showing another event, and if changes have been made, a confirmation dialog is displayed and editing of the new event is cancelled unless confirmed.
You can override this method to prevent the default action, perhaps instead showing a custom interface
that performs validations or gathers custom data before making a call to addCalendarEvent
or updateCalendarEvent
when the new data is available.
public void showNewEventDialog(CalendarEvent event)
event
.
If passed, the event parameter is used as defaults for the new event - in addition, the event's startDate
, and its lane
, for timeline events, are used to calculate the
display location for the dialog.
If this method is called when the Event Dialog is already showing another event, and if changes have been made, a confirmation dialog is displayed and editing of the new event is cancelled unless confirmed.
You can override this method to prevent the default action, perhaps instead showing a custom interface
that performs validations or gathers custom data before making a call to addCalendarEvent
or updateCalendarEvent
when the new data is available.
event
- defaults for the new eventpublic void showNewEventEditor()
event
is passed
as the parameter, it is used as defaults for the new event.public void showNewEventEditor(CalendarEvent event)
event
is passed
as the parameter, it is used as defaults for the new event.event
- defaults for the new event to show in the Editorpublic com.google.gwt.event.shared.HandlerRegistration addTimelineEventMovedHandler(TimelineEventMovedHandler handler)
Called when a Timeline event is moved via dragging by a user. Call TimelineEventMoved.cancel()
from within TimelineEventMovedHandler.onTimelineEventMoved(com.smartgwt.client.widgets.calendar.events.TimelineEventMoved)
to disallow the move.
addTimelineEventMovedHandler
in interface HasTimelineEventMovedHandlers
handler
- the timelineEventMoved handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addTimelineEventResizedHandler(TimelineEventResizedHandler handler)
Called when a Timeline event is resized via dragging by a user. Call TimelineEventResized.cancel()
from within TimelineEventResizedHandler.onTimelineEventResized(com.smartgwt.client.widgets.calendar.events.TimelineEventResized)
to disallow the resize.
addTimelineEventResizedHandler
in interface HasTimelineEventResizedHandlers
handler
- the timelineEventResized handlerHandlerRegistration
used to remove this handlerpublic void updateCalendarEvent(CalendarEvent event, CalendarEvent newEvent, java.util.Map otherFields)
event
- The event object that will be updatednewEvent
- The new attributes for the eventotherFields
- new values of additional fields to be updatedpublic static void setDefaultProperties(Calendar calendarProperties)
Note: This method is intended for setting default attributes only and will affect all instances of the underlying class (including those automatically generated in JavaScript). This method should not be used to apply standard EventHandlers or override methods for a class - use a custom subclass instead. Calling this method after instances have been created can result in undefined behavior, since it bypasses any setters and a class instance may have already examined a particular property and not be expecting any changes through this route.
calendarProperties
- properties that should be used as new defaults when instances of this class are createdSGWTProperties
protected void onInit_Calendar()
public void setWorkdayEnd(java.lang.String workdayEnd) throws java.lang.IllegalStateException
showWorkday
:true,
workdayStart
and workdayEnd
specify the time of day when the workday starts and ends,
specified as a String acceptable to String. Both start and end time must fall on a 30 minute increment (eg 9:30, but not 9:45).
The hours of the workday can be customized for particular dates by providing implementations of Calendar.getWorkdayStart
and Calendar.getWorkdayEnd
.
workdayEnd
- Default value is "5:00pm"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getWorkdayEnd(java.util.Date date)
showWorkday
:true,
workdayStart
and workdayEnd
specify the time of day when the workday starts and ends,
specified as a String acceptable to String. Both start and end time must fall on a 30 minute increment (eg 9:30, but not 9:45).
The hours of the workday can be customized for particular dates by providing implementations of Calendar.getWorkdayStart
and Calendar.getWorkdayEnd
.
date
- the date to get the workday end forworkdayEnd
.public void setWorkdayStart(java.lang.String workdayStart) throws java.lang.IllegalStateException
showWorkday
:true,
workdayStart
and workdayEnd
specify the time of day when the workday starts and ends,
specified as a String acceptable to String. Both start and end time must fall on a 30 minute increment (eg 9:30, but not 9:45).
The hours of the workday can be customized for particular dates by providing implementations of Calendar.getWorkdayStart
and Calendar.getWorkdayEnd
.
workdayStart
- Default value is "9:00am"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getWorkdayStart(java.util.Date date)
showWorkday
:true,
workdayStart
and workdayEnd
specify the time of day when the workday starts and ends,
specified as a String acceptable to String. Both start and end time must fall on a 30 minute increment (eg 9:30, but not 9:45).
The hours of the workday can be customized for particular dates by providing implementations of Calendar.getWorkdayStart
and Calendar.getWorkdayEnd
.
date
- the date to get the workday start forworkdayStart
.public boolean dateIsWorkday(java.util.Date date)
workdays
,
and returns true if found. Override this method to provide custom logic for determining workday,
for example returning false on holidays.date
- the date being testedprotected java.lang.String getDayBodyHTML(java.util.Date date, CalendarEvent[] events, Calendar calendar, int rowNum, int colNum)
Default is to render a series of links that call
Calendar.eventClick
to provide details and/or
an editing interface for the events.
getDayBodyHTML()
is not called for days outside of the current
month if showOtherDays
is false.
date
- JavaScript Date object representing this dayevents
- events that fall on this daycalendar
- the calendar itselfrowNum
- the row number to which the parameter date belongscolNum
- the column number to which the parameter date belongspublic java.lang.String getDateLabelText(java.lang.String viewName, java.util.Date startDate, java.util.Date endDate)
Note: This is an override point.
viewName
- one of "day", "week", "month" or "timeline"startDate
- the start of the visible date rangeendDate
- the optional end of the visible date range. May be null.public void setEventEditorCustomizer(EventEditorCustomizer customizer)
customizer
- the customizer to execute.public void setEventDialogCustomizer(EventDialogCustomizer customizer)
customizer
- the customizer to execute.public void setEventHeaderHTMLCustomizer(EventHeaderHTMLCustomizer customizer)
customizer
- the customizer to execute.public void setEventBodyHTMLCustomizer(EventBodyHTMLCustomizer customizer)
customizer
- the customizer to execute.public void setDateStyleCustomizer(DateStyleCustomizer customizer)
customizer
- the customizer to execute.public void setDateHeaderCustomizer(DateHeaderCustomizer customizer)
customizer
- the customizer to execute.public void setDateHTMLCustomizer(DateHTMLCustomizer customizer)
customizer
- the customizer to execute.public void setDateCellAlignCustomizer(DateCellAlignCustomizer customizer)
customizer
- the customizer to execute.public void setDateCellVAlignCustomizer(DateCellVAlignCustomizer customizer)
customizer
- the customizer to execute.public void setDateCSSTextCustomizer(DateCSSTextCustomizer customizer)
customizer
- the customizer to execute.public void setDisableDateCustomizer(DisableDateCustomizer customizer)
customizer
- the customizer to execute.public void setShowDateCustomizer(ShowDateCustomizer customizer)
customizer
- the customizer to execute.public void setShowLaneCustomizer(ShowLaneCustomizer customizer)
customizer
- the customizer to execute.public void setShowEventCustomizer(ShowEventCustomizer customizer)
customizer
- the customizer to execute.public void setEventHoverHTMLCustomizer(EventHoverHTMLCustomizer eventHoverHTMLCustomizer)
eventHoverHTMLCustomizer
- the customizer to execute.public void setEventCanvasHoverHTMLCustomizer(EventCanvasHoverHTMLCustomizer customizer)
customizer
- the customizer to execute.public void setZoneHoverHTMLCustomizer(ZoneHoverHTMLCustomizer zoneHoverHTMLCustomizer)
zoneHoverHTMLCustomizer
- the customizer to execute.public void setIndicatorHoverHTMLCustomizer(IndicatorHoverHTMLCustomizer indicatorHoverHTMLCustomizer)
indicatorHoverHTMLCustomizer
- the customizer to execute.public void setMonthViewHoverHTMLCustomizer(MonthViewHoverHTMLCustomizer monthViewHoverHTMLCustomizer)
Default implementation will display a list of the events occurring on the date the user is hovering over. Override for custom behavior. Note that returning null will suppress the hover altogether.
monthViewHoverHTMLCustomizer
- the customizer to execute.public void setHeaderHoverCustomizer(HeaderLevelHoverCustomizer customizer)
customizer
- HeaderLevelHoverCustomizer the customizerpublic void setDragHoverCustomizer(DragHoverCustomizer customizer)
customizer
- DragHoverCustomizer the customizerpublic void setCellHoverCustomizer(CellHoverCustomizer customizer)
customizer
- CellHoverCustomizer the customizerpublic void setEventCanvasGripperIconCustomizer(EventCanvasGripperIconCustomizer customizer)
customizer
- the customizer to execute.public void setLaneGroupStartOpen(GroupStartOpen group)
public void setLaneGroupStartOpen(java.lang.Object... groupValues)
groupValues
- Array of values that should be openedpublic void setEventEditorFields(FormItem... eventEditorFields) throws java.lang.IllegalStateException
eventEditor
. The default set of fields are:
{name: "startHours", title: "From", type: "select", width: 60}, {name: "startMinutes", showTitle: false, type: "select", width: 60}, {name: "startAMPM", showTitle: false, type: "select", width: 60}, {name: "invalidDate", type: "blurb", colSpan: 4, visible: false} {name: "endHours", title: "To", type: "select", width: 60}, {name: "endMinutes", showTitle: false, type: "select", width: 60}, {name: "endAMPM", showTitle: false, type: "select", width: 60}, {name: "name", title: "Name", type: "text", colSpan: 4}, {name: "description", title: "Description", type: "textArea", colSpan: 4, height: 50}See the Customized Binding example below for more information on altering default datasource fields within forms.
eventEditorFields
- eventEditorFields Default value is see belowjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic void setEventDialogFields(FormItem... eventDialogFields) throws java.lang.IllegalStateException
eventDialog
. The default set of fields are:
{name: "name", title: "Event Name", type: nameType, width: 250 }, {name: "save", title: "Save Event", type: "SubmitItem", endRow: false}, {name: "details", title: "Edit Details", type: "button", startRow: false}See the Customized Binding example below for more information on altering default datasource fields within forms.
eventDialogFields
- eventDialogFields Default value is see belowjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic void setData(Record[] data)
data
- array of Record objects.setData(CalendarEvent[])
public void setData(RecordList data)
data
- List of Recordspublic void setTimeFormatter(TimeFormatter timeFormatter)
setTimeFormatter(TimeDisplayFormat)
instead.timeFormatter
- timeFormatter Default value is "toShortPaddedTime"public void setTimeFormatter(TimeDisplayFormat timeFormatter)
timeFormatter
- timeFormatter Default value is "toShortPaddedTime"public TimeDisplayFormat getTimeFormatter()
public void removeLane(Lane lane)
timelineView
mode.lane
- the lane to removepublic void removeLane(java.lang.String laneName)
timelineView
mode.laneName
- the name of the lane to removepublic void addEvent(java.util.Date startDate, java.util.Date endDate, java.lang.String name, java.lang.String description)
startDate
- start date of eventendDate
- end date of eventname
- name of eventdescription
- description of eventpublic void addEvent(java.util.Date startDate, java.util.Date endDate, java.lang.String name, java.lang.String description, java.util.Map otherFields)
startDate
- start date of eventendDate
- end date of eventname
- name of eventdescription
- description of eventotherFields
- new values of additional fields to be updatedpublic void removeEvent(CalendarEvent event)
event
- The event object to remove from the calendarpublic void updateEvent(CalendarEvent event, java.util.Date startDate, java.util.Date endDate, java.lang.String name, java.lang.String description)
event
- The event object to remove from the calendarstartDate
- start date of eventendDate
- end date of eventname
- name of eventdescription
- description of eventpublic void setShowDayView(java.lang.Boolean showDayView) throws java.lang.IllegalStateException
java.lang.IllegalStateException
public void setShowWeekView(java.lang.Boolean showWeekView) throws java.lang.IllegalStateException
java.lang.IllegalStateException
public void setShowMonthView(java.lang.Boolean showMonthView) throws java.lang.IllegalStateException
java.lang.IllegalStateException
public void setWorkdays(int[] workdays) throws java.lang.IllegalStateException
showWorkday
is trueworkdays
- workdays Default value is [1,2,3,4,5]java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic static boolean calendarLoaded()
public void setDataPageSize(int dataPageSize)
DataBoundComponent
data
paging
, how many records to fetch at a time. If set to a positive integer,
dataPageSize
will override the default resultSize
for ResultSets
automatically created when you call fetchData()
(and similarly for
the resultSize
of
ResultTrees). The default of 0 means to just use the default page size of the data
container. Note that regardless of the dataPageSize
setting,
a component will always fetch all of data that it needs to draw. Settings such as showAllRecords:true
, drawAllMaxCells
and drawAheadRatio
can cause
more rows than the configured dataPageSize
to be fetched.
setDataPageSize
in interface DataBoundComponent
dataPageSize
- dataPageSize Default value is 0Databinding overview and related methods
public int getDataPageSize()
DataBoundComponent
data
paging
, how many records to fetch at a time. If set to a positive integer,
dataPageSize
will override the default resultSize
for ResultSets
automatically created when you call fetchData()
(and similarly for
the resultSize
of
ResultTrees). The default of 0 means to just use the default page size of the data
container. Note that regardless of the dataPageSize
setting,
a component will always fetch all of data that it needs to draw. Settings such as showAllRecords:true
, drawAllMaxCells
and drawAheadRatio
can cause
more rows than the configured dataPageSize
to be fetched.
getDataPageSize
in interface DataBoundComponent
Databinding overview and related methods
public void setUseAllDataSourceFields(java.lang.Boolean useAllDataSourceFields)
DataBoundComponent
fields
) is used, with any fields specified in
component.fields
acting as overrides that can suppress or modify the
display of individual fields, without having to list the entire set of fields that
should be shown.
If component.fields
contains fields that are not found in the DataSource,
they will be shown after the most recently referred to DataSource field. If the new
fields appear first, they will be shown first.
setUseAllDataSourceFields
in interface DataBoundComponent
useAllDataSourceFields
- useAllDataSourceFields Default value is falsepublic java.lang.Boolean getUseAllDataSourceFields()
DataBoundComponent
fields
) is used, with any fields specified in
component.fields
acting as overrides that can suppress or modify the
display of individual fields, without having to list the entire set of fields that
should be shown.
If component.fields
contains fields that are not found in the DataSource,
they will be shown after the most recently referred to DataSource field. If the new
fields appear first, they will be shown first.
getUseAllDataSourceFields
in interface DataBoundComponent
public void setShowHiddenFields(java.lang.Boolean showHiddenFields)
DataBoundComponent
hidden:true
when a DataBoundComponent is given a
DataSource but no component.fields
.
The hidden
property is used on DataSource fields to mark fields that are
never of meaning to an end user.
setShowHiddenFields
in interface DataBoundComponent
showHiddenFields
- showHiddenFields Default value is falsepublic java.lang.Boolean getShowHiddenFields()
DataBoundComponent
hidden:true
when a DataBoundComponent is given a
DataSource but no component.fields
.
The hidden
property is used on DataSource fields to mark fields that are
never of meaning to an end user.
getShowHiddenFields
in interface DataBoundComponent
public void setShowComplexFields(java.lang.Boolean showComplexFields)
DataBoundComponent
component.fields
.
If true, the component will show fields that declare a complex type, for example, a field 'shippingAddress' that declares type 'Address', where 'Address' is the ID of a DataSource that declares the fields of a shipping address (city, street name, etc).
Such fields may need custom formatters or editors in order to create a usable interface, for example, an Address field in a ListGrid might use a custom formatter to combine the relevant fields of an address into one column, and might use a pop-up dialog for editing.
Note : This is an advanced setting
setShowComplexFields
in interface DataBoundComponent
showComplexFields
- showComplexFields Default value is truepublic java.lang.Boolean getShowComplexFields()
DataBoundComponent
component.fields
.
If true, the component will show fields that declare a complex type, for example, a field 'shippingAddress' that declares type 'Address', where 'Address' is the ID of a DataSource that declares the fields of a shipping address (city, street name, etc).
Such fields may need custom formatters or editors in order to create a usable interface, for example, an Address field in a ListGrid might use a custom formatter to combine the relevant fields of an address into one column, and might use a pop-up dialog for editing.
getShowComplexFields
in interface DataBoundComponent
public void setFetchOperation(java.lang.String fetchOperation)
DataBoundComponent
setFetchOperation
in interface DataBoundComponent
fetchOperation
- fetchOperation Default value is nullpublic java.lang.String getFetchOperation()
DataBoundComponent
getFetchOperation
in interface DataBoundComponent
public void setUpdateOperation(java.lang.String updateOperation)
DataBoundComponent
operationId
this component
should use when performing update operations.setUpdateOperation
in interface DataBoundComponent
updateOperation
- Default value is nullOperations overview and related methods
public java.lang.String getUpdateOperation()
DataBoundComponent
operationId
this component
should use when performing update operations.getUpdateOperation
in interface DataBoundComponent
Operations overview and related methods
public void setAddOperation(java.lang.String addOperation)
DataBoundComponent
operationId
this component
should use when performing add operations.setAddOperation
in interface DataBoundComponent
addOperation
- Default value is nullOperations overview and related methods
public java.lang.String getAddOperation()
DataBoundComponent
operationId
this component
should use when performing add operations.getAddOperation
in interface DataBoundComponent
Operations overview and related methods
public void setRemoveOperation(java.lang.String removeOperation)
DataBoundComponent
operationId
this component
should use when performing remove operations.setRemoveOperation
in interface DataBoundComponent
removeOperation
- Default value is nullOperations overview and related methods
public java.lang.String getRemoveOperation()
DataBoundComponent
operationId
this component
should use when performing remove operations.getRemoveOperation
in interface DataBoundComponent
Operations overview and related methods
public void setExportFields(java.lang.String[] exportFields)
DataBoundComponent
If exportFields is not provided, the exported output includes all visible fields from this component, sorted as they appear.
setExportFields
in interface DataBoundComponent
exportFields
- exportFields Default value is nullpublic java.lang.String[] getExportFields()
DataBoundComponent
If exportFields is not provided, the exported output includes all visible fields from this component, sorted as they appear.
getExportFields
in interface DataBoundComponent
public void setExportAll(java.lang.Boolean exportAll)
DataBoundComponent
fields
.
If exportAll is false, an export operation will first consider
exportFields
, if it's set, and fall back on all visible fields from
fields
otherwise.
setExportAll
in interface DataBoundComponent
exportAll
- exportAll Default value is falsepublic java.lang.Boolean getExportAll()
DataBoundComponent
fields
.
If exportAll is false, an export operation will first consider
exportFields
, if it's set, and fall back on all visible fields from
fields
otherwise.
getExportAll
in interface DataBoundComponent
public void setPreventDuplicates(java.lang.Boolean preventDuplicates) throws java.lang.IllegalStateException
DataBoundComponent
DataBoundComponent.transferSelectedData(com.smartgwt.client.widgets.DataBoundComponent)
.
When a duplicate transfer is detected,
a dialog will appear showing the duplicateDragMessage
.
If the component either does not have a DataSource
or has a DataSource with no
primaryKey
declared, duplicate checking is off by
default. If duplicate checking is enabled, it looks for an existing record in the dataset
that has all of the
properties of the dragged record, and considers that a duplicate.
For DragDataAction
:"copy" where the target DataSource is related to the source
DataSource by foreignKey, a duplicate means that
the target list, as filtered by the current
criteria, already has a record whose value for the foreignKey field matches the
primaryKey of the record being
transferred.
For example, consider dragging "employees" to "teams", where "teams" has a field "teams.employeeId" which is a foreignKey pointing to "employees.id", and the target grid has search criteria causing it to show all the members of one team. A duplicate - adding an employee to the same team twice - is when the target grid's dataset contains an record with "employeeId" matching the "id" field of the dropped employee.
setPreventDuplicates
in interface DataBoundComponent
preventDuplicates
- preventDuplicates Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getPreventDuplicates()
DataBoundComponent
DataBoundComponent.transferSelectedData(com.smartgwt.client.widgets.DataBoundComponent)
.
When a duplicate transfer is detected,
a dialog will appear showing the duplicateDragMessage
.
If the component either does not have a DataSource
or has a DataSource with no
primaryKey
declared, duplicate checking is off by
default. If duplicate checking is enabled, it looks for an existing record in the dataset
that has all of the
properties of the dragged record, and considers that a duplicate.
For DragDataAction
:"copy" where the target DataSource is related to the source
DataSource by foreignKey, a duplicate means that
the target list, as filtered by the current
criteria, already has a record whose value for the foreignKey field matches the
primaryKey of the record being
transferred.
For example, consider dragging "employees" to "teams", where "teams" has a field "teams.employeeId" which is a foreignKey pointing to "employees.id", and the target grid has search criteria causing it to show all the members of one team. A duplicate - adding an employee to the same team twice - is when the target grid's dataset contains an record with "employeeId" matching the "id" field of the dropped employee.
getPreventDuplicates
in interface DataBoundComponent
public void setDuplicateDragMessage(java.lang.String duplicateDragMessage) throws java.lang.IllegalStateException
DataBoundComponent
preventDuplicates
is enabled. If set to null, duplicates will not be reported and the dragged duplicates will not be saved.setDuplicateDragMessage
in interface DataBoundComponent
duplicateDragMessage
- duplicateDragMessage Default value is "Duplicates not allowed"java.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getDuplicateDragMessage()
DataBoundComponent
preventDuplicates
is enabled. If set to null, duplicates will not be reported and the dragged duplicates will not be saved.getDuplicateDragMessage
in interface DataBoundComponent
public void setAddDropValues(java.lang.Boolean addDropValues)
DataBoundComponent
If this value is true and this component is databound, DataBoundComponent.getDropValues()
will be called for every databound item
dropped on this grid, and an update performed on the item
setAddDropValues
in interface DataBoundComponent
addDropValues
- addDropValues Default value is truepublic java.lang.Boolean getAddDropValues()
DataBoundComponent
If this value is true and this component is databound, DataBoundComponent.getDropValues()
will be called for every databound item
dropped on this grid, and an update performed on the item
getAddDropValues
in interface DataBoundComponent
public void setDropValues(java.util.Map dropValues)
DataBoundComponent
addDropValues
is true and both the source and
target widgets are databound, either to the same DataSource or to different DataSources that are related via a foreign key, this object provides the "drop values" that
Smart GWT will apply to the dropped object before updating it.If this property is not defined, Smart GWT defaults to returning the selection criteria currently in place for this component. Thus, any databound items (for example, rows from other grids bound to the same DataSource) dropped on the grid will, by default, be subjected to an update that makes them conform to the grid's current filter criteria.
Note : This is an advanced setting
setDropValues
in interface DataBoundComponent
dropValues
- dropValues Default value is nullpublic java.util.Map getDropValues()
DataBoundComponent
addDropValues
is true and both the source and
target widgets are databound, either to the same DataSource or to different DataSources that are related via a foreign key, this object provides the "drop values" that
Smart GWT will apply to the dropped object before updating it.If this property is not defined, Smart GWT defaults to returning the selection criteria currently in place for this component. Thus, any databound items (for example, rows from other grids bound to the same DataSource) dropped on the grid will, by default, be subjected to an update that makes them conform to the grid's current filter criteria.
Note : This is an advanced setting
getDropValues
in interface DataBoundComponent
dropValues
for more details. If multiple records
are being dropped, this method is called for each of them in turn.
This method returns the following:
addDropValues
is falseYou can override this method if you need more complex setting of drop values than can be provided by simply supplying a dropValues object.
public void setProgressiveLoading(java.lang.Boolean progressiveLoading)
progressively
progressiveLoading
- ProgressiveLoading
,
DataSource.setProgressiveLoading(java.lang.Boolean)
public java.lang.Boolean getProgressiveLoading()
progressively
ProgressiveLoading
,
DataSource.getProgressiveLoading()
public void setUseFlatFields(java.lang.Boolean useFlatFields) throws java.lang.IllegalStateException
DataBoundComponent
useFlatFields
flag causes all simple type fields anywhere in a nested
set of DataSources to be exposed as a flat list for form binding.
useFlatFields
is typically used with imported metadata, such as
XMLTools.loadXMLSchema(java.lang.String, com.smartgwt.client.data.XSDLoadCallback)
from a
XMLTools.loadWSDL(java.lang.String, com.smartgwt.client.data.WSDLLoadCallback)
, as a means of eliminating levels of XML
nesting that aren't meaningful in a user interface, without the cumbersome and fragile
process of mapping form fields to XML structures.
For example, having called WebService.getInputDS(java.lang.String)
to retrieve the input message
schema for a web service operation whose input message looks like this:
<FindServices> <searchFor>search text</searchFor> <Options> <caseSensitive>false</caseSensitive> </Options> <IncludeInSearch> <serviceName>true</serviceName> <documentation>true</documentation> <keywords>true</keywords> </IncludeInSearch> </FindServices>Setting
useFlatFields
on a DynamicForm
that is bound to this input
message schema would result in 5 FormItem
reflecting the 5 simple type
fields in the message.
For this form, the result of DynamicForm.getValues()
might look
like:
{ searchFor: "search text", caseSensitive: false, serviceName: true, documentation : true, keywords : true }When contacting a
WebService
, these values can be automatically
mapped to the structure of the input message for a web service operation by setting
useFlatFields
(for use with WebService.callOperation(java.lang.String, java.util.Map, java.lang.String, com.smartgwt.client.data.WebServiceCallback)
) or by setting
useFlatFields
(for use with a DataSource
that is
'bound to a WSDL web service'
via
wsOperation
).
Using these two facilities in conjunction (component.useFlatFields and request.useFlatFields) allows gratuitous nesting to be consistently bypassed in both the user presentation and when providing the data for XML messages.
You can also set useFlatFields
to automatically enable
"flattened" XML serialization (request.useFlatFields) for all DataSource requests of a
particular operationType.
Note that useFlatFields
is not generally recommended for use with structures
where multiple simple type fields exist with the same name, however if used with such a
structure, the first field to use a given name wins. "first" means the first field
encountered in a depth first search. "wins" means only the first field will be present as a
field when data binding.
setUseFlatFields
in interface DataBoundComponent
useFlatFields
- useFlatFields Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getUseFlatFields()
DataBoundComponent
useFlatFields
flag causes all simple type fields anywhere in a nested
set of DataSources to be exposed as a flat list for form binding.
useFlatFields
is typically used with imported metadata, such as
XMLTools.loadXMLSchema(java.lang.String, com.smartgwt.client.data.XSDLoadCallback)
from a
XMLTools.loadWSDL(java.lang.String, com.smartgwt.client.data.WSDLLoadCallback)
, as a means of eliminating levels of XML
nesting that aren't meaningful in a user interface, without the cumbersome and fragile
process of mapping form fields to XML structures.
For example, having called WebService.getInputDS(java.lang.String)
to retrieve the input message
schema for a web service operation whose input message looks like this:
<FindServices> <searchFor>search text</searchFor> <Options> <caseSensitive>false</caseSensitive> </Options> <IncludeInSearch> <serviceName>true</serviceName> <documentation>true</documentation> <keywords>true</keywords> </IncludeInSearch> </FindServices>Setting
useFlatFields
on a DynamicForm
that is bound to this input
message schema would result in 5 FormItem
reflecting the 5 simple type
fields in the message.
For this form, the result of DynamicForm.getValues()
might look
like:
{ searchFor: "search text", caseSensitive: false, serviceName: true, documentation : true, keywords : true }When contacting a
WebService
, these values can be automatically
mapped to the structure of the input message for a web service operation by setting
useFlatFields
(for use with WebService.callOperation(java.lang.String, java.util.Map, java.lang.String, com.smartgwt.client.data.WebServiceCallback)
) or by setting
useFlatFields
(for use with a DataSource
that is
'bound to a WSDL web service'
via
wsOperation
).
Using these two facilities in conjunction (component.useFlatFields and request.useFlatFields) allows gratuitous nesting to be consistently bypassed in both the user presentation and when providing the data for XML messages.
You can also set useFlatFields
to automatically enable
"flattened" XML serialization (request.useFlatFields) for all DataSource requests of a
particular operationType.
Note that useFlatFields
is not generally recommended for use with structures
where multiple simple type fields exist with the same name, however if used with such a
structure, the first field to use a given name wins. "first" means the first field
encountered in a depth first search. "wins" means only the first field will be present as a
field when data binding.
getUseFlatFields
in interface DataBoundComponent
public void setHiliteProperty(java.lang.String hiliteProperty)
DataBoundComponent
id
for a hilite defined on this component.setHiliteProperty
in interface DataBoundComponent
hiliteProperty
- hiliteProperty Default value is "_hilite"public java.lang.String getHiliteProperty()
DataBoundComponent
id
for a hilite defined on this component.getHiliteProperty
in interface DataBoundComponent
public void editFields()
public void editHilites()
editHilites
in interface DataBoundComponent
public java.lang.String getHiliteState()
getHiliteState
in interface DataBoundComponent
public void setHiliteState(java.lang.String hiliteState)
setHiliteState
in interface DataBoundComponent
hiliteState
- hilites state encoded as a Stringpublic void setHilites(Hilite[] hilites)
getHilites
for a method of
retrieving the hilite array for storage, including hilites manually added by the user.setHilites
in interface DataBoundComponent
hilites
- array of hilite objectspublic Hilite[] getHilites()
getHilites
in interface DataBoundComponent
public void setDragDataAction(DragDataAction dragDataAction)
DataBoundComponent
setDragDataAction
in interface DataBoundComponent
dragDataAction
- dragDataAction Default value is Canvas.MOVEpublic DragDataAction getDragDataAction()
DataBoundComponent
getDragDataAction
in interface DataBoundComponent
public void setDragTrackerStyle(java.lang.String dragTrackerStyle)
DataBoundComponent
setDragTrackerStyle
in interface DataBoundComponent
dragTrackerStyle
- dragTrackerStyle Default value is "gridDragTracker"public java.lang.String getDragTrackerStyle()
DataBoundComponent
getDragTrackerStyle
in interface DataBoundComponent
public void setCanAddFormulaFields(java.lang.Boolean canAddFormulaFields)
DataBoundComponent
com.smartgwt.client..FormulaBuilder
.
User-added formula fields can be persisted via ListGrid.getFieldState()
and
ListGrid.setFieldState(java.lang.String)
.
setCanAddFormulaFields
in interface DataBoundComponent
canAddFormulaFields
- canAddFormulaFields Default value is falsepublic void addSummaryField()
DataBoundComponent
com.smartgwt.client..SummaryBuilder
to create a new Summary Field. This
is equivalent to calling DataBoundComponentGen#editSummaryField
with
no parameter.
addSummaryField
in interface DataBoundComponent
public void addFormulaField()
DataBoundComponent
com.smartgwt.client..FormulaBuilder
to create a new Formula Field. This
is equivalent to calling DataBoundComponentGen#editFormulaField
with
no parameter.
addFormulaField
in interface DataBoundComponent
public java.lang.Boolean getCanAddFormulaFields()
DataBoundComponent
com.smartgwt.client..FormulaBuilder
.
User-added formula fields can be persisted via ListGrid.getFieldState()
and
ListGrid.setFieldState(java.lang.String)
.
getCanAddFormulaFields
in interface DataBoundComponent
public void setAddFormulaFieldText(java.lang.String addFormulaFieldText)
DataBoundComponent
setAddFormulaFieldText
in interface DataBoundComponent
addFormulaFieldText
- addFormulaFieldText Default value is "Add formula column..."public java.lang.String getAddFormulaFieldText()
DataBoundComponent
getAddFormulaFieldText
in interface DataBoundComponent
public void setEditFormulaFieldText(java.lang.String editFormulaFieldText)
DataBoundComponent
setEditFormulaFieldText
in interface DataBoundComponent
editFormulaFieldText
- editFormulaFieldText Default value is "Edit formula..."public java.lang.String getEditFormulaFieldText()
DataBoundComponent
getEditFormulaFieldText
in interface DataBoundComponent
public void setCanAddSummaryFields(java.lang.Boolean canAddSummaryFields)
DataBoundComponent
com.smartgwt.client..SummaryBuilder
.
User-added summary fields can be persisted via ListGrid.getFieldState()
and
ListGrid.setFieldState(java.lang.String)
.
setCanAddSummaryFields
in interface DataBoundComponent
canAddSummaryFields
- canAddSummaryFields Default value is falsepublic java.lang.Boolean getCanAddSummaryFields()
DataBoundComponent
com.smartgwt.client..SummaryBuilder
.
User-added summary fields can be persisted via ListGrid.getFieldState()
and
ListGrid.setFieldState(java.lang.String)
.
getCanAddSummaryFields
in interface DataBoundComponent
public void setAddSummaryFieldText(java.lang.String addSummaryFieldText)
DataBoundComponent
setAddSummaryFieldText
in interface DataBoundComponent
addSummaryFieldText
- addSummaryFieldText Default value is "Add summary column..."public java.lang.String getAddSummaryFieldText()
DataBoundComponent
getAddSummaryFieldText
in interface DataBoundComponent
public void setEditSummaryFieldText(java.lang.String editSummaryFieldText)
DataBoundComponent
setEditSummaryFieldText
in interface DataBoundComponent
editSummaryFieldText
- editSummaryFieldText Default value is "Edit summary format..."public java.lang.String getEditSummaryFieldText()
DataBoundComponent
getEditSummaryFieldText
in interface DataBoundComponent
public Record[] findAll(AdvancedCriteria adCriteria)
adCriteria
- AdvancedCriteria to use to filter resultspublic Record find(AdvancedCriteria adCriteria)
adCriteria
- AdvancedCriteria to use to filter resultspublic int findIndex(AdvancedCriteria adCriteria)
adCriteria
- AdvancedCriteria to use to filter resultspublic int findNextIndex(int startIndex, AdvancedCriteria adCriteria, int endIndex)
RecordList.findIndex(java.util.Map)
, but considering the startIndex and endIndex parameters.startIndex
- first index to consideradCriteria
- AdvancedCriteria to use to filter resultsendIndex
- last index to considerpublic int findNextIndex(int startIndex, AdvancedCriteria adCriteria)
RecordList.findIndex(java.util.Map)
, but considering the startIndex parameter.startIndex
- first index to consideradCriteria
- AdvancedCriteria to use to filter resultspublic void selectRecord(Record record)
DataBoundComponent
Record
passed in explicitly, or by index.selectRecord
in interface DataBoundComponent
record
- record (or row number) to selectpublic void selectRecord(int record)
DataBoundComponent
Record
passed in explicitly, or by index.selectRecord
in interface DataBoundComponent
record
- record (or row number) to selectpublic void selectRecord(int record, boolean newState)
DataBoundComponent
Record
passed in explicitly, or by index.selectRecord
in interface DataBoundComponent
record
- record (or row number) to selectnewState
- new selection state (if null, defaults to true)public void selectRecord(Record record, boolean newState)
DataBoundComponent
Record
passed in explicitly, or by index.selectRecord
in interface DataBoundComponent
record
- record (or row number) to selectnewState
- new selection state (if null, defaults to true)public void selectRecords(int[] records)
DataBoundComponent
Record
s passed in explicitly, or by index.selectRecords
in interface DataBoundComponent
records
- records (or row numbers) to selectpublic void selectRecords(int[] records, boolean newState)
DataBoundComponent
Record
s passed in explicitly, or by index.selectRecords
in interface DataBoundComponent
records
- records (or row numbers) to selectnewState
- new selection statepublic void selectRecords(Record[] records)
DataBoundComponent
Record
s passed in explicitly, or by index.selectRecords
in interface DataBoundComponent
records
- records (or row numbers) to selectpublic void selectRecords(Record[] records, boolean newState)
DataBoundComponent
Record
s passed in explicitly, or by index.selectRecords
in interface DataBoundComponent
records
- records (or row numbers) to selectnewState
- new selection state (if null, defaults to true)public void deselectRecord(Record record)
DataBoundComponent
Record
passed in explicitly, or by index. Synonym for
selectRecord(record, false)
deselectRecord
in interface DataBoundComponent
record
- record (or row number) to deselectpublic void deselectRecord(int record)
DataBoundComponent
Record
passed in explicitly, or by index. Synonym for
selectRecord(record, false)
deselectRecord
in interface DataBoundComponent
record
- record (or row number) to deselectpublic void deselectRecords(int[] records)
DataBoundComponent
Record
s passed in explicitly, or by index. Synonym
for selectRecords(records, false)
deselectRecords
in interface DataBoundComponent
records
- records (or row numbers) to deselectpublic void deselectRecords(Record[] records)
DataBoundComponent
Record
s passed in explicitly, or by index. Synonym
for selectRecords(records, false)
deselectRecords
in interface DataBoundComponent
records
- records (or row numbers) to deselectpublic void selectAllRecords()
DataBoundComponent
selectAllRecords
in interface DataBoundComponent
public void deselectAllRecords()
DataBoundComponent
deselectAllRecords
in interface DataBoundComponent
public java.lang.Boolean anySelected()
DataBoundComponent
anySelected
in interface DataBoundComponent
public void enableHilite(java.lang.String hiliteID)
DataBoundComponent
hilites
enableHilite
in interface DataBoundComponent
hiliteID
- ID of hilite to enablepublic void enableHilite(java.lang.String hiliteID, boolean enable)
DataBoundComponent
hilites
enableHilite
in interface DataBoundComponent
hiliteID
- ID of hilite to enableenable
- new enabled state to apply - if null, defaults to truepublic void disableHilite(java.lang.String hiliteID)
DataBoundComponent
disableHilite
in interface DataBoundComponent
hiliteID
- ID of hilite to disablepublic void enableHiliting()
DataBoundComponent
enableHiliting
in interface DataBoundComponent
public void enableHiliting(boolean enable)
DataBoundComponent
enableHiliting
in interface DataBoundComponent
enable
- new enabled state to apply - if null, defaults to truepublic void disableHiliting()
DataBoundComponent
disableHiliting
in interface DataBoundComponent
public Record[] getDragData()
DataBoundComponent
This method is consulted by
ListGrid.willAcceptDrop()
.
getDragData
in interface DataBoundComponent
Record
s that are currently selected.public void transferSelectedData(DataBoundComponent source)
DataBoundComponent
DataBoundComponent.getDropValues()
for each dropped record.
To transfer all data in, for example, a ListGrid
, call grid.selection.selectAll() first.
Note that drag/drop type transfers of records between components are asynchronous operations: Smart GWT may need to perform server turnarounds to establish whether
dropped records already exist in the target component. Therefore, it is possible to issue a call to transferSelectedData()
and/or the drop()
method of a databound component whilst a transfer is still active. When this happens, Smart GWT adds the second and subsequent transfer requests to a queue and runs
them one after the other. If you want to be notified when a transfer process has actually completed, use addDropCompleteHandler
.
See the Dragging
documentation for an overview of list grid drag/drop data transfer.
transferSelectedData
in interface DataBoundComponent
source
- source component from which the records will be tranferredpublic void transferSelectedData(DataBoundComponent source, int index)
DataBoundComponent
DataBoundComponent.getDropValues()
for each dropped record.
To transfer all data in, for example, a ListGrid
, call grid.selection.selectAll() first.
Note that drag/drop type transfers of records between components are asynchronous operations: Smart GWT may need to perform server turnarounds to establish whether
dropped records already exist in the target component. Therefore, it is possible to issue a call to transferSelectedData()
and/or the drop()
method of a databound component whilst a transfer is still active. When this happens, Smart GWT adds the second and subsequent transfer requests to a queue and runs
them one after the other. If you want to be notified when a transfer process has actually completed, use addDropCompleteHandler
.
See the Dragging
documentation for an overview of list grid drag/drop data transfer.
transferSelectedData
in interface DataBoundComponent
source
- source component from which the records will be transferredindex
- target index (drop position) of the rows within this grid.public int getRecordIndex(Record record)
DataBoundComponent
Override in subclasses to provide more specific behaviour, for instance, when data holds a large number of records
getRecordIndex
in interface DataBoundComponent
record
- the record whose index is to be retrievedpublic java.lang.String getTitleFieldValue(Record record)
DataBoundComponent
Override in subclasses
getTitleFieldValue
in interface DataBoundComponent
record
- the record whose index is to be retrievedpublic void setTitleField(java.lang.String titleField)
DataBoundComponent
setTitleField
in interface DataBoundComponent
public java.lang.String getTitleField()
DataBoundComponent
titleField
for databound
components."title"
,
"name"
, or "id"
. If we dont find any field-names that match these
titles, the first field in the component will be used instead.
getTitleField
in interface DataBoundComponent
public DataSource getDataSource()
DataBoundComponent
DataSource requests
.getDataSource
in interface DataBoundComponent
public void setAutoFetchData(java.lang.Boolean autoFetchData) throws java.lang.IllegalStateException
DataBoundComponent
DataBoundComponent.fetchData()
or DataBoundComponent.filterData()
depending on
DataBoundComponent.getAutoFetchAsFilter()
. Criteria for this fetch may be picked up from initialCriteria
and textMatchStyle may be specified via DataBoundComponent.getAutoFetchTextMatchStyle()
.
NOTE: If autoFetchData is set, calling ListGrid.fetchData() before draw will cause two requests to be
issued, one from the manual call to fetchData() and one from the autoFetchData setting. The second request will use only
initialCriteria
and not any other criteria or settings from the first request. Generally, turn off
autoFetchData if you are going to manually call fetchData() at any time.
setAutoFetchData
in interface DataBoundComponent
autoFetchData
- autoFetchDatajava.lang.IllegalStateException
public java.lang.Boolean getAutoFetchData()
DataBoundComponent
DataBoundComponent.fetchData()
or DataBoundComponent.filterData()
depending on
DataBoundComponent.getAutoFetchAsFilter()
. Criteria for this fetch may be picked up from initialCriteria
and textMatchStyle may be specified via DataBoundComponent.getAutoFetchTextMatchStyle()
.
NOTE: If autoFetchData is set, calling ListGrid.fetchData() before draw will cause two requests to be
issued, one from the manual call to fetchData() and one from the autoFetchData setting. The second request will use only
initialCriteria
and not any other criteria or settings from the first request. Generally, turn off
autoFetchData if you are going to manually call fetchData() at any time.
getAutoFetchData
in interface DataBoundComponent
public void setAutoFetchTextMatchStyle(TextMatchStyle autoFetchTextMatchStyle) throws java.lang.IllegalStateException
DataBoundComponent
autoFetchData
is true
, this attribute allows the developer to specify a textMatchStyle
for the initial DataBoundComponent.fetchData()
call.setAutoFetchTextMatchStyle
in interface DataBoundComponent
java.lang.IllegalStateException
public TextMatchStyle getAutoFetchTextMatchStyle()
DataBoundComponent
autoFetchData
is true
, this attribute allows the developer to specify a textMatchStyle
for the initial DataBoundComponent.fetchData()
call.getAutoFetchTextMatchStyle
in interface DataBoundComponent
public void setAutoFetchAsFilter(java.lang.Boolean autoFetchAsFilter) throws java.lang.IllegalStateException
DataBoundComponent
DataBoundComponent.setAutoFetchData(Boolean)
is true, this attribute determines whether the initial fetch operation should be
performed via DataBoundComponent.fetchData()
or DataBoundComponent.filterData()
setAutoFetchAsFilter
in interface DataBoundComponent
autoFetchAsFilter
- autoFetchAsFilterjava.lang.IllegalStateException
public java.lang.Boolean getAutoFetchAsFilter()
DataBoundComponent
DataBoundComponent.setAutoFetchData(Boolean)
is true, this attribute determines whether the initial fetch operation should be
performed via DataBoundComponent.fetchData()
or DataBoundComponent.filterData()
getAutoFetchAsFilter
in interface DataBoundComponent
public void setInitialCriteria(Criteria initialCriteria) throws java.lang.IllegalStateException
DataBoundComponent
DataBoundComponent.setAutoFetchData(Boolean)
is used.setInitialCriteria
in interface DataBoundComponent
initialCriteria
- the initial criteriajava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic Criteria getInitialCriteria()
DataBoundComponent
DataBoundComponent.setAutoFetchData(Boolean)
is used.getInitialCriteria
in interface DataBoundComponent
public void fetchData()
DataBoundComponent
When fetchData()
is first called, if data has not already been provided via
setData()
, this method will create a ResultSet
, which will be
configured based on component settings such as fetchOperation
and dataPageSize
, as well
as the general purpose dataProperties
. The created ResultSet will automatically send a DSRequest
to retrieve data from the dataSource, and from then on will
automatically manage paging through large datasets, as well as performing filtering and
sorting operations inside the browser when possible - see the ResultSet docs for
details.
NOTE: do not use both autoFetchData
and a
call to fetchData()
- this may result in two DSRequests to fetch data. Use
either autoFetchData
and setAutoFetchCriteria()
or a manual call to fetchData()
passing criteria.
Whether a ResultSet was automatically created or provided via setData()
, subsequent
calls to fetchData() will simply call resultSet.setCriteria()
.
Changes to criteria may or may not result in a DSRequest to the server due to
client-side filtering. You can call
willFetchData(criteria)
to determine if new criteria will
result in a server fetch.
If you need to force data to be re-fetched, you can call
invalidateCache()
and new data will
automatically be fetched from the server using the current criteria and sort direction. NOTE:
when using invalidateCache()
there is no need to also call fetchData()
and in fact this could produce unexpected results.
This method takes an optional callback parameter (set to a DSCallback
)
to fire when the fetch completes. Note that this callback will not fire if no server fetch is performed.
In this case the data is updated synchronously, so as soon as this method completes you
can interact with the new data. If necessary, you can use
resultSet.willFetchData()
to determine whether or not a server
fetch will occur when fetchData()
is called with new criteria.
In addition to the callback parameter for this method, developers can use
resultSet.addDataArrivedHandler
to be notified every time data is loaded.
fetchData
in interface DataBoundComponent
public void fetchData(Criteria criteria)
DataBoundComponent
When fetchData()
is first called, if data has not already been provided via
setData()
, this method will create a ResultSet
, which will be
configured based on component settings such as fetchOperation
and dataPageSize
, as well
as the general purpose dataProperties
. The created ResultSet will automatically send a DSRequest
to retrieve data from the dataSource, and from then on will
automatically manage paging through large datasets, as well as performing filtering and
sorting operations inside the browser when possible - see the ResultSet docs for
details.
NOTE: do not use both autoFetchData
and a
call to fetchData()
- this may result in two DSRequests to fetch data. Use
either autoFetchData
and setAutoFetchCriteria()
or a manual call to fetchData()
passing criteria.
Whether a ResultSet was automatically created or provided via setData()
, subsequent
calls to fetchData() will simply call resultSet.setCriteria()
.
Changes to criteria may or may not result in a DSRequest to the server due to
client-side filtering. You can call
willFetchData(criteria)
to determine if new criteria will
result in a server fetch.
If you need to force data to be re-fetched, you can call
invalidateCache()
and new data will
automatically be fetched from the server using the current criteria and sort direction. NOTE:
when using invalidateCache()
there is no need to also call fetchData()
and in fact this could produce unexpected results.
This method takes an optional callback parameter (set to a DSCallback
)
to fire when the fetch completes. Note that this callback will not fire if no server fetch is performed.
In this case the data is updated synchronously, so as soon as this method completes you
can interact with the new data. If necessary, you can use
resultSet.willFetchData()
to determine whether or not a server
fetch will occur when fetchData()
is called with new criteria.
In addition to the callback parameter for this method, developers can use
resultSet.addDataArrivedHandler
to be notified every time data is loaded.
fetchData
in interface DataBoundComponent
criteria
- Search criteria. If a DynamicForm
is passed in as this argument instead of a raw criteria object, will be
derived by calling DynamicForm.getValuesAsCriteria()
public void fetchData(Criteria criteria, DSCallback callback)
DataBoundComponent
When fetchData()
is first called, if data has not already been provided via
setData()
, this method will create a ResultSet
, which will be
configured based on component settings such as fetchOperation
and dataPageSize
, as well
as the general purpose dataProperties
. The created ResultSet will automatically send a DSRequest
to retrieve data from the dataSource, and from then on will
automatically manage paging through large datasets, as well as performing filtering and
sorting operations inside the browser when possible - see the ResultSet docs for
details.
NOTE: do not use both autoFetchData
and a
call to fetchData()
- this may result in two DSRequests to fetch data. Use
either autoFetchData
and setAutoFetchCriteria()
or a manual call to fetchData()
passing criteria.
Whether a ResultSet was automatically created or provided via setData()
, subsequent
calls to fetchData() will simply call resultSet.setCriteria()
.
Changes to criteria may or may not result in a DSRequest to the server due to
client-side filtering. You can call
willFetchData(criteria)
to determine if new criteria will
result in a server fetch.
If you need to force data to be re-fetched, you can call
invalidateCache()
and new data will
automatically be fetched from the server using the current criteria and sort direction. NOTE:
when using invalidateCache()
there is no need to also call fetchData()
and in fact this could produce unexpected results.
This method takes an optional callback parameter (set to a DSCallback
)
to fire when the fetch completes. Note that this callback will not fire if no server fetch is performed.
In this case the data is updated synchronously, so as soon as this method completes you
can interact with the new data. If necessary, you can use
resultSet.willFetchData()
to determine whether or not a server
fetch will occur when fetchData()
is called with new criteria.
In addition to the callback parameter for this method, developers can use
resultSet.addDataArrivedHandler
to be notified every time data is loaded.
fetchData
in interface DataBoundComponent
criteria
- Search criteria. If a DynamicForm
is passed in as this argument instead of a raw criteria object, will be
derived by calling DynamicForm.getValuesAsCriteria()
callback
- callback to invoke when a fetch is complete. Fires only
if server contact was requiredpublic void fetchData(Criteria criteria, DSCallback callback, DSRequest requestProperties)
DataBoundComponent
When fetchData()
is first called, if data has not already been provided via
setData()
, this method will create a ResultSet
, which will be
configured based on component settings such as fetchOperation
and dataPageSize
, as well
as the general purpose dataProperties
. The created ResultSet will automatically send a DSRequest
to retrieve data from the dataSource, and from then on will
automatically manage paging through large datasets, as well as performing filtering and
sorting operations inside the browser when possible - see the ResultSet docs for
details.
NOTE: do not use both autoFetchData
and a
call to fetchData()
- this may result in two DSRequests to fetch data. Use
either autoFetchData
and setAutoFetchCriteria()
or a manual call to fetchData()
passing criteria.
Whether a ResultSet was automatically created or provided via setData()
, subsequent
calls to fetchData() will simply call resultSet.setCriteria()
.
Changes to criteria may or may not result in a DSRequest to the server due to
client-side filtering. You can call
willFetchData(criteria)
to determine if new criteria will
result in a server fetch.
If you need to force data to be re-fetched, you can call
invalidateCache()
and new data will
automatically be fetched from the server using the current criteria and sort direction. NOTE:
when using invalidateCache()
there is no need to also call fetchData()
and in fact this could produce unexpected results.
This method takes an optional callback parameter (set to a DSCallback
)
to fire when the fetch completes. Note that this callback will not fire if no server fetch is performed.
In this case the data is updated synchronously, so as soon as this method completes you
can interact with the new data. If necessary, you can use
resultSet.willFetchData()
to determine whether or not a server
fetch will occur when fetchData()
is called with new criteria.
In addition to the callback parameter for this method, developers can use
resultSet.addDataArrivedHandler
to be notified every time data is loaded.
fetchData
in interface DataBoundComponent
criteria
- Search criteria. If a DynamicForm
is passed in as this argument instead of a raw criteria object,
will be derived by calling DynamicForm.getValuesAsCriteria()
callback
- callback to invoke when a fetch is complete. Fires
only if server contact was requiredrequestProperties
- additional properties to set on the DSRequest
that will be issuedpublic void filterData()
DataBoundComponent
This
method behaves exactly like ListGrid.fetchData()
except that textMatchStyle
is automatically set to "substring" so that
String-valued fields are matched by case-insensitive substring comparison.
filterData
in interface DataBoundComponent
public void filterData(Criteria criteria)
DataBoundComponent
This
method behaves exactly like ListGrid.fetchData()
except that textMatchStyle
is automatically set to "substring" so that
String-valued fields are matched by case-insensitive substring comparison.
filterData
in interface DataBoundComponent
criteria
- Search criteria. If a DynamicForm
is passed in as this argument instead of a raw criteria object, will be
derived by calling DynamicForm.getValuesAsCriteria()
public void filterData(Criteria criteria, DSCallback callback)
DataBoundComponent
This
method behaves exactly like ListGrid.fetchData()
except that textMatchStyle
is automatically set to "substring" so that
String-valued fields are matched by case-insensitive substring comparison.
filterData
in interface DataBoundComponent
criteria
- Search criteria. If a DynamicForm
is passed in as this argument instead of a raw criteria object,
will be derived by calling DynamicForm.getValuesAsCriteria()
callback
- callback to invoke when a fetch is complete. Fires
only if server contact was required; see
DataBoundComponent.fetchData()
for detailspublic void filterData(Criteria criteria, DSCallback callback, DSRequest requestProperties)
DataBoundComponent
This
method behaves exactly like ListGrid.fetchData()
except that textMatchStyle
is automatically set to "substring" so that
String-valued fields are matched by case-insensitive substring comparison.
filterData
in interface DataBoundComponent
criteria
- Search criteria. If a DynamicForm
is passed in as this argument instead of a raw criteria object,
will be derived by calling DynamicForm.getValuesAsCriteria()
callback
- callback to invoke when a fetch is complete. Fires
only if server contact was required; see
DataBoundComponent.fetchData()
for detailsrequestProperties
- for databound components only - optional additional
properties to set on the DSRequest that will be issuedpublic void invalidateCache()
DataBoundComponent
invalidateCache()
method, for example,
ResultSet.invalidateCache()
.
NOTE: there is no need to call invalidateCache()
when a save operation
is performed on a DataSource. Automatic cache synchronization features will automatically
update caches - see ResultSet
for details. If automatic
cache synchronization isn't working, troubleshoot the problem using the steps suggested
in the FAQ rather than just calling invalidateCache(). Calling
invalidateCache()
unnecessarily causes extra server load and added code
complexity.
Calling invalidateCache()
will automatically cause a new
fetch to be performed with the current set of criteria if data had been previously
fetched and the component is currently drawn with data visible - there is no need to
manually call fetchData() after invalidateCache() and this could result in duplicate
fetches.
While data is being re-loaded after a call to invalidateCache()
, the widget
is in a state similar to initial data load - it doesn't know the total length of the
dataset and any APIs that act on records or row indices will necessarily fail and should
not be called. To detect that the widget is in this state, call
ResultSet.lengthIsKnown()
.
invalidateCache()
only has an effect if this component's dataset is a data
manager class that manages a cache (eg ResultSet or ResultTree). If data was provided as
a simple Array or List, invalidateCache() does nothing.
invalidateCache
in interface DataBoundComponent
ListGrid.refreshData()
,
DataBoundComponentMethods
overview and related methods
public ResultSet getResultSet()
DataBoundComponent
ResultSet
.
Note that this method should only be called after initial data has been fetched by this DataBoundComponent.
getResultSet
in interface DataBoundComponent
DataBoundComponent.fetchData()
public RecordList getRecordList()
DataBoundComponent
RecordList
.
Depending on the component configuration, the actual JavaScript instance of the returned RecordList may be one of several types:
DataSource
,
the instance is generally an Array of Record
.ResultSet
.Tree
.
To access the ungrouped record list regardless of grouping status, use
isGrouped() ? getOriginalRecordList() : getRecordList()
TreeGrid
,
the instance is a ResultTree.getRecordList
in interface DataBoundComponent
public com.google.gwt.core.client.JavaScriptObject getDataAsJSList()
getDataAsJSList
in interface DataBoundComponent
public void exportData()
DataBoundComponent
DataSource
to retrieve data that matches the current filter and sort criteria for this component, then exports the resulting data
to a file or window in the requested format. A variety of DSRequest settings, such as exportAs
and exportFilename
, affect the exporting process: see exportResults
for further detail.
Note that data exported via this method does not include any client-side
formatting and relies on both the Smart GWT server and server-side DataSources. To export client-data with formatters
applied, see exportClientData
, which still
requires the Smart GWT server but does not rely on server-side DataSources.
For more information on exporting data,
see DataSource.exportData
.
exportData
in interface DataBoundComponent
DataBoundComponentMethods overview and related methods
public void exportData(DSRequest requestProperties)
DataBoundComponent
DataSource
to retrieve data that matches the current filter and sort criteria for this component, then exports the resulting data
to a file or window in the requested format. A variety of DSRequest settings, such as exportAs
and exportFilename
, affect the exporting process: see exportResults
for further detail.
Note that data exported via this method does not include any client-side
formatting and relies on both the Smart GWT server and server-side DataSources. To export client-data with formatters
applied, see exportClientData
, which still
requires the Smart GWT server but does not rely on server-side DataSources.
For more information on exporting data,
see DataSource.exportData
.
exportData
in interface DataBoundComponent
requestProperties
- additional properties to set on the DSRequest that will be issuedDataBoundComponentMethods overview and related methods
public com.google.gwt.event.shared.HandlerRegistration addFetchDataHandler(FetchDataHandler handler)
Notification function fired on fetchData() or filterData()
addFetchDataHandler
in interface HasFetchDataHandlers
handler
- the filterData handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addDropCompleteHandler(DropCompleteHandler handler)
com.smartgwt.client.widgets.DropCompleteHandler
. See that class's documentation for a definition of "drop complete",
and how it differs from "drag complete" (com.smartgwt.client.widgets.DragCompleteHandler
).addDropCompleteHandler
in interface HasDropCompleteHandlers
handler
- the DropCompleteHandlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addDragCompleteHandler(DragCompleteHandler handler)
com.smartgwt.client.widgets.DragCompleteHandler
. See that class's documentation for a definition of "drag complete",
and how it differs from "drop complete" (com.smartgwt.client.widgets.DropCompleteHandler
).addDragCompleteHandler
in interface HasDragCompleteHandlers
handler
- the DropCompleteHandlerHandlerRegistration
used to remove this handlerpublic Alignment[] getFieldAlignments()
DataBoundComponent
getFieldAlignments
in interface DataBoundComponent
public java.lang.Boolean getDeepCloneOnEdit()
DataBoundComponent
DataSource.getDeepCloneOnEdit()
for details of what this means.
If this value is not explicitly set, it defaults to the DataSource deepCloneOnEdit
value.
This value can also be overridden per-field with DataSourceField.setDeepCloneOnEdit(java.lang.Boolean)
.
Like the other deepCloneOnEdit
settings, this flag only has an effect if you are
editing a values object that contains nested objects or arrays, using Canvas.setDataPath(java.lang.String)
getDeepCloneOnEdit
in interface DataBoundComponent
public void setDeepCloneOnEdit(java.lang.Boolean deepCloneOnEdit)
DataBoundComponent
DataSource.getDeepCloneOnEdit()
for details of what this means.
If this value is not explicitly set, it defaults to the DataSource deepCloneOnEdit
value.
This value can also be overridden per-field with DataSourceField.setDeepCloneOnEdit(java.lang.Boolean)
.
Like the other deepCloneOnEdit
settings, this flag only has an effect if you are
editing a values object that contains nested objects or arrays, using Canvas.setDataPath(java.lang.String)
setDeepCloneOnEdit
in interface DataBoundComponent
public void setFields(com.google.gwt.core.client.JavaScriptObject... fields)
DataBoundComponent
setFields(FormItem...)
,
setFields(ListGridField...)
,
etc.) that will accept an array of JavaScriptObject, rather than an array of SmartGWT
Java wrappers of the field class type (e.g.
FormItem
,
ListGridField
, etc.)
This is an advanced method and only for cases where you have the JavaScriptObject for
each field but want to avoid having to create each associated SmartGWT Java wrapper.
Note: use toArray()
to create a Java
array of JavaScriptObject if you only have the array itself as a single JavaScriptObject.
setFields
in interface DataBoundComponent
fields
- the component fieldspublic com.google.gwt.core.client.JavaScriptObject[] getFieldsAsJavaScriptObjects()
DataBoundComponent
FormItem
,
ListGridField
, etc.)
This avoids building the SmartGWT Java wrappers for the fields in situations where they
aren't needed - and for FormItems in particular - where there may not be enough
information to determine the correct subclass, such as before the SmartClient instance
underlying the DynamicForm
has been
created.getFieldsAsJavaScriptObjects
in interface DataBoundComponent
public int getFieldCount()
DataBoundComponent
getFieldCount
in interface DataBoundComponent
public com.smartgwt.logicalstructure.core.LogicalStructureObject setLogicalStructure(com.smartgwt.logicalstructure.widgets.calendar.CalendarLogicalStructure s)
LogicalStructure
interface,
which supports Eclipse's logical structure debugging facility.public com.smartgwt.logicalstructure.core.LogicalStructureObject getLogicalStructure()
LogicalStructure
interface,
which supports Eclipse's logical structure debugging facility.getLogicalStructure
in interface LogicalStructure
getLogicalStructure
in class Canvas