public class Calendar extends Canvas implements DataBoundComponent, HasBackgroundClickHandlers, HasBackgroundMouseDownHandlers, HasBackgroundMouseUpHandlers, HasCurrentViewChangedHandlers, HasDateChangedHandlers, HasDayBodyClickHandlers, HasDayHeaderClickHandlers, HasEventAddedHandlers, HasEventChangedHandlers, HasEventClickHandlers, HasEventRemoveClickHandlers, HasEventRemovedHandlers, HasEventRepositionMoveHandlers, HasEventRepositionStopHandlers, HasEventResizeMoveHandlers, HasEventResizeStopHandlers, HasEventSaveErrorHandlers, HasEventsRenderedHandlers, HasIndicatorClickHandlers, HasZoneClickHandlers
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 |
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 |
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 |
addEventSaveErrorHandler(EventSaveErrorHandler handler)
Add a eventSaveError handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addEventsRenderedHandler(EventsRenderedHandler handler)
Add a eventsRendered 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. |
com.google.gwt.event.shared.HandlerRegistration |
addIndicatorClickHandler(IndicatorClickHandler handler)
Add a indicatorClick handler.
|
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. |
void |
addZone(CalendarEvent zone)
Adds a new
zone to the calendar. |
com.google.gwt.event.shared.HandlerRegistration |
addZoneClickHandler(ZoneClickHandler handler)
Add a zoneClick handler.
|
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.
|
void |
cancelEditing()
Cancels the current edit-session, closing the builtin event
dialog or editor and clearing any visible edit-selection from the
current CalendarView . |
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() |
Canvas |
createEventCanvasComponent(EventCanvas canvas)
Called from
EventCanvas.setEvent() when showEventCanvasComponents is true and an
eventCanvas needs a component. |
boolean |
dateIsWorkday(java.util.Date date)
|
boolean |
dateIsWorkday(java.util.Date date,
java.lang.String laneName)
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
|
java.lang.Boolean |
deselectEvent(CalendarEvent event)
Removes an event from the list of selected events in the current view, clearing its selected style.
|
java.lang.Boolean |
deselectEvents(CalendarEvent... events)
Removes one or more events from the list of selected events in the current view, clearing their selected styles.
|
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.
|
boolean |
eventMoved(java.util.Date newDate,
CalendarEvent event,
java.lang.String newLane)
Deprecated.
in favor of
Calendar.eventRepositionStop() |
boolean |
eventResized(java.util.Date newDate,
CalendarEvent event)
Deprecated.
in favor of
Calendar.eventResizeStop() |
void |
exportData()
|
void |
exportData(DSRequest requestProperties)
|
void |
exportData(DSRequest requestProperties,
RPCCallback callback)
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 |
getAlwaysShowEventHovers()
By default, EventCanvases show their content in hovers.
|
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.String |
getCalMonthEventLinkStyle()
The base name for the CSS class applied to the links rendered by
getDayBodyHTML() . |
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 |
getCanCreateOtherDayEvents()
When
showOtherDays is true, determines whether
clicking in a Month-view body-cell that represents a date outside the selected month will open the event-editor window at the cell's location. |
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 the event quick dialog and editor allow a lane to be selected with a drop-down
chooser. |
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.lang.Boolean |
getCanSelectEvents()
When set to true, makes individual
event canvases selectable. |
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.
|
VLayout |
getColumnLayout()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
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. |
java.lang.Integer |
getControlBarIconSize()
The size of the various icons displayed in the
controlsBar of this Calendar. |
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. |
java.lang.Integer |
getControlsBarHeight()
Default height of the
controlsBar shown above the
main Calendar grid. |
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 . |
Canvas |
getEventCanvasComponent()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
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.
|
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 . |
java.lang.String |
getEventEditorDateFieldTitle()
The title for the Date-field in the
eventEditor
that allows for changing the logical start-date of an event, along with its start and end times, when editing events in
the day and week views. |
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 fixed
height for the header area in event canvases. |
java.lang.String |
getEventHeaderHTML(CalendarEvent event)
Returns the title text for the passed event, which is displayed in the header area of an eventCanvas rendered in a
vertical or horizontal view, or as a clickable link in a cell in a
Month view . |
java.lang.String |
getEventHeaderHTML(CalendarEvent event,
CalendarView view)
Returns the title text for the passed event, which is displayed in the header area of an eventCanvas rendered in a
vertical or horizontal view, or as a clickable link in a cell in a
Month view . |
boolean |
getEventHeaderWrap()
When rendering the
canvas for an event, whether to
allow the content of the header area to wrap to
multiple lines. |
java.lang.String |
getEventHoverHTML(CalendarEvent event,
EventCanvas eventCanvas,
CalendarView view)
Gets the hover HTML for an event being hovered over.
|
java.lang.String |
getEventHoverHTML(CalendarEvent event,
EventCanvas eventCanvas,
CalendarView view,
java.lang.String defaultValue)
Gets the hover HTML for an event being hovered over.
|
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.String |
getEventScreen()
Screen to create (via
createScreen() ) in lieu of calling createEventCanvasComponent() . |
java.lang.Integer |
getEventSnapGap()
The number of minutes that determines the positions to which events will snap when rendered, and when moved or resized
with the mouse.
|
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()
|
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.Boolean |
getExportIncludeSummaries()
If Summary rows exist for this component, whether to include them when exporting client data.
|
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, Sunday-Saturday) which the calendar should consider as the first day of the week in multi-day
views, and in the popup
DateChooser . |
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.
|
Criteria |
getImplicitCriteria()
Criteria that are never shown to or edited by the user and are cumulative with any
criteria provided via
DataBoundComponent.initialCriteria ,
DataBoundComponent.setCriteria() etc. |
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()
Deprecated.
in favor of
getLaneGroupByFieldAsStringArray() . |
java.lang.String[] |
getLaneGroupByFieldAsStringArray()
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 a given 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.
|
java.lang.Boolean |
getLimitToWorkday()
When
showWorkday is true, this attribute prevents
the user from scrolling vertical views beyond the specified workday start and end hours. |
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. |
int |
getMinRowHeight()
The minimum height of time-rows in vertical calendar views.
|
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 . |
java.lang.String |
getNewEventWindowTitle()
The title-text displayed in the popup event dialog/editor for new events.
|
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.Boolean |
getOtherDayClickNavigation()
When
showOtherDays is true, this attribute
determines whether the month-view should change month when cells representing days in the previous or following month
are clicked. |
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. |
boolean |
getRenderEventsOnDemand()
When set to true, the default, each
event is rendered as it
appears in the viewport. |
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.String |
getSavedSearchId()
Optional identifier for saved searches that should be applied to this component.
|
java.lang.Boolean |
getScrollToWorkday()
If set, and
showWorkday is true, automatically
scrolls the day and week views to the start of the workday when the calendar is first displayed and whenever
the user changes to a different day or week. |
java.lang.Boolean |
getSelectChosenDate()
When true, shows the current
chosenDate in a
selected style in the month view . |
java.lang.String |
getSelectedCellStyle()
The base name for the CSS class applied to a cell that is selected via a mouse drag.
|
CalendarEvent |
getSelectedEvent()
Returns the currently selected
event , or the first one if
more than one is selected. |
CalendarEvent[] |
getSelectedEvents()
Returns the currently selected list of
events . |
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 |
getShowColumnLayouts()
When true, causes
layouts to be added to each
column in vertical views. |
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 |
getShowDayView()
Whether to show the Day view.
|
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 |
getShowEventCanvasComponents()
Whether
event-canvases should show a custom widget
as content, rather than the default header and
body HTML. |
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. |
boolean |
getShowLabelColumn()
When set to false, hides the frozen Label-Column in vertical
CalendarView s. |
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 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 |
getShowMonthView()
Whether to show the Month view.
|
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 |
getShowWeekView()
Whether to show the Week view.
|
java.lang.Boolean |
getShowWorkday()
When set to true, this setting enables various features related to cells that fall within the workday (as defined by
workdayStart and workdayEnd ) in vertical calendar views (day and week ). |
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.lang.Boolean |
getSizeToWorkday()
When
showWorkday is true, attempt to resize rows in
the day and week views so that the workday hours
fill the visible viewport-height, and the whole workday is visible without scrolling. |
SortSpecifier[] |
getSort()
Returns the current
SortSpecifiers for
this component. |
java.lang.Boolean |
getSparseFieldState()
If true,
ListGrid.getFieldState() and
ListGrid.setFieldState(java.lang.String) will omit state
information for hidden fields by default. |
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 . |
java.lang.Boolean |
getStyleWorkday()
When
showWorkday is true, applies the workdayBaseStyle to cells that fall within the
workday (as defined by workdayStart and workdayEnd ), in both the dayView and weekView . |
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()
Dictates whether times throughout the widget are formatted and edited as 24-hour values.
|
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)
|
java.lang.String |
getWorkdayEnd(java.util.Date date,
java.lang.String laneName)
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)
|
java.lang.String |
getWorkdayStart(java.util.Date date,
java.lang.String laneName)
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)
Deprecated.
in favor of
scrollToEvent() . |
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 |
scrollToEnd()
Move the viewport of a CalendarView to the end of its scrollable range.
|
void |
scrollToEnd(CalendarView view)
Move the viewport of a CalendarView to the end of its scrollable range.
|
void |
scrollToEvent(CalendarEvent event)
Scrolls the
current view so the passed event is
visible. |
void |
scrollToEvent(CalendarEvent event,
boolean canReload)
Scrolls the
current view so the passed event is
visible. |
void |
scrollToStart()
Move the viewport of a CalendarView to the start of it's scrollable range.
|
void |
scrollToStart(CalendarView view)
Move the viewport of a CalendarView to the start of it's scrollable range.
|
void |
scrollToTime(java.lang.String time)
|
void |
selectAllRecords()
Select all records
|
java.lang.Boolean |
selectEvent(CalendarEvent event)
Adds an event to the list of selected events in the current view, showing it in a selected style.
|
java.lang.Boolean |
selectEvents(CalendarEvent... events)
Adds one or more events to the list of selected events in the current view, showing them in a selected style.
|
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. |
java.lang.Boolean |
selectSingleEvent(CalendarEvent event)
Selects a single event in the current view, showing it in a selected style and deselecting any other selected events.
|
void |
selectTab(int tabnum)
Selects the calendar view in the passed tab number.
|
Calendar |
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.
|
Calendar |
setAddEventButtonHoverText(java.lang.String addEventButtonHoverText)
The text to be displayed when a user hovers over the
add event toolbar button |
Calendar |
setAddFormulaFieldText(java.lang.String addFormulaFieldText)
Text for a menu item allowing users to add a formula field
|
Calendar |
setAddOperation(java.lang.String addOperation)
operationId this component
should use when performing add operations. |
Calendar |
setAddSummaryFieldText(java.lang.String addSummaryFieldText)
Text for a menu item allowing users to add a formula field
|
Calendar |
setAllowDurationEvents(java.lang.Boolean allowDurationEvents)
When set to true, allows events to be managed by duration, as well as by end date.
|
Calendar |
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. |
Calendar |
setAlwaysShowEventHovers(java.lang.Boolean alwaysShowEventHovers)
By default, EventCanvases show their content in hovers.
|
Calendar |
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() |
Calendar |
setAutoFetchData(java.lang.Boolean autoFetchData)
If true, when this component is first drawn, automatically call
DataBoundComponent.fetchData() or DataBoundComponent.filterData() depending on
DataBoundComponent.getAutoFetchAsFilter() . |
Calendar |
setAutoFetchTextMatchStyle(TextMatchStyle autoFetchTextMatchStyle)
If
autoFetchData is true , this attribute allows the developer to specify a textMatchStyle
for the initial DataBoundComponent.fetchData() call. |
Calendar |
setBackButtonTitle(java.lang.String backButtonTitle)
The title of the
month on Handsets when the month view is the current visible view. |
Calendar |
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.
|
Calendar |
setBringEventsToFront(java.lang.Boolean bringEventsToFront)
If set to true, clicking an event will bring it to the front of the zorder.
|
Calendar |
setCalMonthEventLinkStyle(java.lang.String calMonthEventLinkStyle)
The base name for the CSS class applied to the links rendered by
getDayBodyHTML() . |
Calendar |
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 .
|
Calendar |
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 .
|
Calendar |
setCancelButtonTitle(java.lang.String cancelButtonTitle)
The title for the
Cancel button in the event editor . |
Calendar |
setCanCreateEvents(java.lang.Boolean canCreateEvents)
If true, users can create new events.
|
Calendar |
setCanCreateOtherDayEvents(java.lang.Boolean canCreateOtherDayEvents)
When
showOtherDays is true, determines whether
clicking in a Month-view body-cell that represents a date outside the selected month will open the event-editor window at the cell's location. |
Calendar |
setCanDeleteEvents(java.lang.Boolean canDeleteEvents)
Deprecated.
in favor of
canRemoveEvents |
Calendar |
setCanDragCreateEvents(java.lang.Boolean canDragCreateEvents)
A boolean value controlling whether new events of varying length can be created by dragging the cursor.
|
Calendar |
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. |
Calendar |
setCanDragEvents(java.lang.Boolean canDragEvents)
A boolean value controlling whether users can drag-reposition events.
|
Calendar |
setCanEditEvents(java.lang.Boolean canEditEvents)
If true, users can edit existing events.
|
Calendar |
setCanEditField(java.lang.String canEditField)
Name of the field on each
CalendarEvent that determines whether it can be
edited in the event editor . |
Calendar |
setCanEditLane(java.lang.Boolean canEditLane)
Can events be moved between lanes? If so, the event can be dragged to a different
lane , and the event quick dialog and editor allow a lane to be selected with a drop-down
chooser. |
Calendar |
setCanEditLaneField(java.lang.String canEditLaneField)
Name of the field on each
CalendarEvent that determines whether that event
can be moved between lanes. |
Calendar |
setCanEditSublane(java.lang.Boolean canEditSublane)
Can events be moved between sublanes?
|
Calendar |
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 . |
Calendar |
setCanGroupLanes(java.lang.Boolean canGroupLanes)
If true, allows the lanes in a Timeline to be grouped by providing a value for
laneGroupByField . |
Calendar |
setCanRemoveEvents(java.lang.Boolean canRemoveEvents)
If true, users can remove existing events.
|
Calendar |
setCanRemoveField(java.lang.String canRemoveField)
Name of the field on each
CalendarEvent that determines whether an event
shows a remove button. |
Calendar |
setCanReorderLanes(java.lang.Boolean canReorderLanes)
If true, lanes can be reordered by dragging their
laneFields with the mouse. |
Calendar |
setCanResizeEventField(java.lang.String canResizeEventField)
Name of the field on each
CalendarEvent that determines whether an event
can be resized by dragging. |
Calendar |
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. |
Calendar |
setCanResizeTimelineEvents(java.lang.Boolean canResizeTimelineEvents)
Deprecated.
in favor of
canResizeEvents ; |
Calendar |
setCanSelectEvents(java.lang.Boolean canSelectEvents)
When set to true, makes individual
event canvases selectable. |
void |
setCellHoverCustomizer(CellHoverCustomizer customizer)
Customize the Hover text to display when the mouse hovers over cells in a CalendarView
|
Calendar |
setChosenDate(java.util.Date chosenDate)
The date for which events are displayed in the day, week, and month tabs of the calendar.
|
Calendar |
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. |
Calendar |
setControlBarIconSize(java.lang.Integer controlBarIconSize)
The size of the various icons displayed in the
controlsBar of this Calendar. |
Calendar |
setControlsBarHeight(java.lang.Integer controlsBarHeight)
Default height of the
controlsBar shown above the
main Calendar grid. |
Calendar |
setCurrentViewName(ViewName currentViewName)
The name of the view that should be visible initially by default.
|
Calendar |
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.
|
Calendar |
setDataFetchMode(FetchMode dataFetchMode)
How to fetch and manage records retrieve from the server.
|
Calendar |
setDataPageSize(int dataPageSize)
When using
data
paging , how many records to fetch at a time. |
Calendar |
setDataSource(DataSource dataSource)
The DataSource that this component should bind to for default fields and for performing
DataSource requests . |
Calendar |
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
|
Calendar |
setDateEditingStyle(DateEditingStyle dateEditingStyle)
Indicates the type of controls to use in event-windows.
|
Calendar |
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
|
Calendar |
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
|
Calendar |
setDayBodyBaseStyle(java.lang.String dayBodyBaseStyle)
The base name for the CSS class applied to the day body of the month view of the calendar.
|
Calendar |
setDayHeaderBaseStyle(java.lang.String dayHeaderBaseStyle)
The base name for the CSS class applied to the day headers of the month view.
|
Calendar |
setDayViewTitle(java.lang.String dayViewTitle)
The title for the
day view . |
Calendar |
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.
|
Calendar |
setDefaultTimelineColumnSpan(int defaultTimelineColumnSpan)
The number of columns of the
timelineGranularity to give the timeline by default if no endDate is provided. |
Calendar |
setDescriptionField(java.lang.String descriptionField)
The name of the description field on a
CalendarEvent . |
Calendar |
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
|
Calendar |
setDisableWeekends(java.lang.Boolean disableWeekends)
If true, weekend days appear in a disabled style and events cannot be created on weekends.
|
Calendar |
setDragDataAction(DragDataAction dragDataAction)
Indicates what to do with data dragged into another DataBoundComponent.
|
Calendar |
setDragDataCustomizer(DragDataCustomizer customizer)
During a drag-and-drop interaction, this method returns the set of records being dragged
out of the component.
|
void |
setDragHoverCustomizer(DragHoverCustomizer customizer)
Customize the Hover text to display during a drag operation
|
Calendar |
setDragTrackerStyle(java.lang.String dragTrackerStyle)
CSS Style to apply to the drag tracker when dragging occurs on this component.
|
Calendar |
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. |
Calendar |
setDuplicateDragMessage(java.lang.String duplicateDragMessage)
Message to show when a user attempts to transfer duplicate records into this component, and
preventDuplicates
is enabled. |
Calendar |
setDurationField(java.lang.String durationField)
The name of the
duration field on a CalendarEvent . |
Calendar |
setDurationUnitField(java.lang.String durationUnitField)
The name of the
durationUnit field on a
CalendarEvent . |
Calendar |
setEditFormulaFieldText(java.lang.String editFormulaFieldText)
Text for a menu item allowing users to edit a formula field
|
Calendar |
setEditSummaryFieldText(java.lang.String editSummaryFieldText)
Text for a menu item allowing users to edit the formatter for a field
|
Calendar |
setEndDate(java.util.Date endDate)
The end date of the calendar timeline view.
|
Calendar |
setEndDateField(java.lang.String endDateField)
The name of the end date field on a
CalendarEvent . |
Calendar |
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 |
setEventCanvasComponentCustomizer(EventCanvasComponentCustomizer customizer)
This method sets the customizer for EventCanvasComponent methods
|
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 |
setEventCanvasMenuCustomizer(EventCanvasMenuCustomizer customizer)
Customizer called whenever the Calender needs to show a context-menu for a given EventCanvas
|
Calendar |
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 . |
Calendar |
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.
|
Calendar |
setEventDurationFieldTitle(java.lang.String eventDurationFieldTitle)
|
Calendar |
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
|
Calendar |
setEventEditorDateFieldTitle(java.lang.String eventEditorDateFieldTitle)
The title for the Date-field in the
eventEditor
that allows for changing the logical start-date of an event, along with its start and end times, when editing events in
the day and week views. |
void |
setEventEditorFields(FormItem... eventEditorFields)
The set of fields for the
eventEditor . |
Calendar |
setEventEndDateFieldTitle(java.lang.String eventEndDateFieldTitle)
|
Calendar |
setEventHeaderHeight(int eventHeaderHeight)
When
eventHeaderWrap is false and showEventDescriptions is true, this is 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.
|
Calendar |
setEventHeaderWrap(boolean eventHeaderWrap)
When rendering the
canvas for an event, whether to
allow the content of the header area to wrap to
multiple lines. |
Calendar |
setEventLaneFieldTitle(java.lang.String eventLaneFieldTitle)
|
Calendar |
setEventNameFieldTitle(java.lang.String eventNameFieldTitle)
|
Calendar |
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 . |
Calendar |
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.
|
Calendar |
setEventOverlapPercent(int eventOverlapPercent)
The size of the overlap, presented as a percentage of the width of events sharing timeslots.
|
Calendar |
setEventScreen(java.lang.String eventScreen)
Screen to create (via
createScreen() ) in lieu of calling createEventCanvasComponent() . |
Calendar |
setEventSnapGap(java.lang.Integer eventSnapGap)
The number of minutes that determines the positions to which events will snap when rendered, and when moved or resized
with the mouse.
|
Calendar |
setEventStartDateFieldTitle(java.lang.String eventStartDateFieldTitle)
|
void |
setEventStyle(CalendarEvent event,
java.lang.String styleName)
Update the styleName for the passed event.
|
Calendar |
setEventStyleName(java.lang.String eventStyleName)
The base name for the CSS class applied to
events
when they're rendered in calendar views. |
Calendar |
setEventStyleNameField(java.lang.String eventStyleNameField)
The name of the field used to override
eventStyleName for an individual CalendarEvent.styleName . |
Calendar |
setEventSublaneFieldTitle(java.lang.String eventSublaneFieldTitle)
|
Calendar |
setEventWindowStyle(java.lang.String eventWindowStyle)
Deprecated.
in favor of
eventStyleName |
Calendar |
setEventWindowStyleField(java.lang.String eventWindowStyleField)
Deprecated.
in favor of
eventStyleNameField |
Calendar |
setExportAll(java.lang.Boolean exportAll)
Setting exportAll to true prevents the component from passing its list of fields to the
export call.
|
Calendar |
setExportFields(java.lang.String[] exportFields)
The list of field-names to export.
|
Calendar |
setExportIncludeSummaries(java.lang.Boolean exportIncludeSummaries)
If Summary rows exist for this component, whether to include them when exporting client data.
|
Calendar |
setFetchOperation(java.lang.String fetchOperation)
Operation ID this component should use when performing fetch operations.
|
Calendar |
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. |
Calendar |
setFirstDayOfWeek(java.lang.Integer firstDayOfWeek)
The numeric day (0-6, Sunday-Saturday) which the calendar should consider as the first day of the week in multi-day
views, and in the popup
DateChooser . |
void |
setHeaderHoverCustomizer(HeaderLevelHoverCustomizer customizer)
Customize the Hover text for a given span in a HeaderLevel.
|
Calendar |
setHeaderLevels(HeaderLevel... headerLevels)
Configures the levels of
headers shown above the event area,
and their time units. |
Calendar |
setHideUnusedLanes(java.lang.Boolean hideUnusedLanes)
When set to true, hides any
lane that doesn't have any
active events in the current dataset. |
Calendar |
setHiliteProperty(java.lang.String hiliteProperty)
Marker that can be set on a record to flag that record as hilited.
|
Calendar |
setHilites(Hilite[] hilites)
Accepts an array of hilite objects and applies them to this DataBoundComponent.
|
Calendar |
setHiliteState(java.lang.String hiliteState)
Set the current hilites based on a hiliteState String previously returned from getHilitesState.
|
Calendar |
setImplicitCriteria(Criteria implicitCriteria)
Criteria that are never shown to or edited by the user and are cumulative with any
criteria provided via
DataBoundComponent.initialCriteria ,
DataBoundComponent.setCriteria() etc. |
java.lang.Boolean |
setImplicitCriteria(Criteria implicitCriteria,
DSCallback callback) |
java.lang.Boolean |
setImplicitCriteria(Criteria criteria,
DSCallback callback,
java.lang.Boolean initialFetch) |
void |
setIndicatorHoverHTMLCustomizer(IndicatorHoverHTMLCustomizer indicatorHoverHTMLCustomizer)
This method returns the hover HTML to be displayed when the user hovers over an IndicatorCanvas
|
Calendar |
setIndicators(CalendarEvent... indicators)
An array of CalendarEvent instances representing instants in time, to be highlighted in
timeline views . |
Calendar |
setIndicatorStyleName(java.lang.String indicatorStyleName)
|
Calendar |
setInitialCriteria(Criteria initialCriteria)
Criteria to use when
DataBoundComponent.setAutoFetchData(Boolean) is used. |
Calendar |
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. |
Calendar |
setLaneEventPadding(java.lang.Integer laneEventPadding)
|
Calendar |
setLaneFields(ListGridField... laneFields)
Field definitions for the frozen area of the
timelineView , which shows data about the timeline lanes . |
Calendar |
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. |
Calendar |
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) |
Calendar |
setLaneNameField(java.lang.String laneNameField)
The name of the field which will determine the
lane in
which a given event will be displayed in Timeline s and in the day view , if showDayLanes is true. |
Calendar |
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. |
boolean |
setLaneTitle(java.lang.String lane,
java.lang.String title)
For views that support
lanes , updates the title for the
passed lane. |
Calendar |
setLeadingDateField(java.lang.String leadingDateField)
The name of the leading date field for each event.
|
Calendar |
setLimitToWorkday(java.lang.Boolean limitToWorkday)
When
showWorkday is true, this attribute prevents
the user from scrolling vertical views beyond the specified workday start and end hours. |
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. |
Calendar |
setMinimalUI(boolean minimalUI)
A boolean value controlling whether the Calendar shows tabs for available calendar views.
|
Calendar |
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. |
Calendar |
setMinLaneWidth(java.lang.Integer minLaneWidth)
When showing
vertical lanes in the dayView , this attribute sets the minimum width of each column
or field. |
Calendar |
setMinRowHeight(int minRowHeight)
The minimum height of time-rows in vertical calendar views.
|
Calendar |
setMinutesPerRow(java.lang.Integer minutesPerRow)
|
Calendar |
setMonthButtonTitle(java.lang.String monthButtonTitle)
The title of the
month button , used for showing and
hiding the month view on Handsets. |
Calendar |
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.
|
Calendar |
setMonthViewTitle(java.lang.String monthViewTitle)
The title for the
month view . |
Calendar |
setNameField(java.lang.String nameField)
The name of the name field on a
CalendarEvent . |
Calendar |
setNewEventWindowTitle(java.lang.String newEventWindowTitle)
The title-text displayed in the popup event dialog/editor for new events.
|
Calendar |
setNextButtonHoverText(java.lang.String nextButtonHoverText)
The text to be displayed when a user hovers over the
next toolbar button |
Calendar |
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. |
Calendar |
setOtherDayBodyBaseStyle(java.lang.String otherDayBodyBaseStyle)
The base name for the CSS class applied to the day body of the month view of the calendar.
|
Calendar |
setOtherDayClickNavigation(java.lang.Boolean otherDayClickNavigation)
When
showOtherDays is true, this attribute
determines whether the month-view should change month when cells representing days in the previous or following month
are clicked. |
Calendar |
setOtherDayHeaderBaseStyle(java.lang.String otherDayHeaderBaseStyle)
The base name for the CSS class applied to the day headers of the month view.
|
Calendar |
setOverlapSortSpecifiers(SortSpecifier... overlapSortSpecifiers)
A set of
sort-specifiers for customizing the render order of events that
overlap. |
Calendar |
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) . |
Calendar |
setPreviousButtonHoverText(java.lang.String previousButtonHoverText)
The text to be displayed when a user hovers over the
previous toolbar button. |
Calendar |
setProgressiveLoading(java.lang.Boolean progressiveLoading)
Indicates whether or not this component will load its data
progressively |
Calendar |
setRemoveButtonTitle(java.lang.String removeButtonTitle)
The title for the
Remove button in the event editor . |
Calendar |
setRemoveOperation(java.lang.String removeOperation)
operationId this component
should use when performing remove operations. |
Calendar |
setRenderEventsOnDemand(boolean renderEventsOnDemand)
When set to true, the default, each
event is rendered as it
appears in the viewport. |
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.
|
Calendar |
setRowHeight(int rowHeight)
The height of time-slots in the calendar.
|
Calendar |
setRowTitleFrequency(java.lang.Integer rowTitleFrequency)
|
Calendar |
setSaveButtonTitle(java.lang.String saveButtonTitle)
|
Calendar |
setSavedSearchId(java.lang.String savedSearchId)
Optional identifier for saved searches that should be applied to this component.
|
Calendar |
setScrollToWorkday(java.lang.Boolean scrollToWorkday)
If set, and
showWorkday is true, automatically
scrolls the day and week views to the start of the workday when the calendar is first displayed and whenever
the user changes to a different day or week. |
Calendar |
setSelectChosenDate(java.lang.Boolean selectChosenDate)
When true, shows the current
chosenDate in a
selected style in the month view . |
Calendar |
setSelectedCellStyle(java.lang.String selectedCellStyle)
The base name for the CSS class applied to a cell that is selected via a mouse drag.
|
Calendar |
setShowAddEventButton(java.lang.Boolean showAddEventButton)
Set to false to hide the
Add Event button. |
Calendar |
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. |
Calendar |
setShowColumnLayouts(java.lang.Boolean showColumnLayouts)
When true, causes
layouts to be added to each
column in vertical views. |
Calendar |
setShowComplexFields(java.lang.Boolean showComplexFields)
Whether to show fields of non-atomic types when a DataBoundComponent is given a
DataSource but no
component.fields .
|
Calendar |
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. |
Calendar |
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.
|
Calendar |
setShowDatePickerButton(java.lang.Boolean showDatePickerButton)
Set to false to hide the
datePickerButton that
allows selecting a new base date for this Calendar. |
Calendar |
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 . |
Calendar |
setShowDayLanes(java.lang.Boolean showDayLanes)
|
Calendar |
setShowDayView(java.lang.Boolean showDayView)
Whether to show the Day view.
|
Calendar |
setShowDetailFields(java.lang.Boolean showDetailFields)
Whether to show fields marked
detail:true when a DataBoundComponent is given a DataSource but no
component.fields . |
Calendar |
setShowDragHovers(java.lang.Boolean showDragHovers)
When
showViewHovers is true, dictates whether to
display hover prompts when an event is being dragged with the mouse. |
Calendar |
setShowEventCanvasComponents(boolean showEventCanvasComponents)
Whether
event-canvases should show a custom widget
as content, rather than the default header and
body HTML. |
void |
setShowEventCustomizer(ShowEventCustomizer customizer)
Return false from the customizer to prevent the passed CalendarEvent from being rendered in the
passed view.
|
Calendar |
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 . |
Calendar |
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 . |
Calendar |
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. |
Calendar |
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 . |
Calendar |
setShowHiddenFields(java.lang.Boolean showHiddenFields)
Whether to show fields marked
hidden:true when a DataBoundComponent is given a
DataSource but no component.fields .
|
Calendar |
setShowIndicators(java.lang.Boolean showIndicators)
Set to true to render any defined
indicators into
timeline views . |
Calendar |
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. |
Calendar |
setShowLabelColumn(boolean showLabelColumn)
When set to false, hides the frozen Label-Column in vertical
CalendarView s. |
void |
setShowLaneCustomizer(ShowLaneCustomizer customizer)
Return false from the customizer to prevent the passed Lane from being rendered in the
passed view.
|
Calendar |
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 . |
Calendar |
setShowLaneRollOver(java.lang.Boolean showLaneRollOver)
When set to true, causes
Timelines to highlight
the Lane under the mouse with the "Over" style. |
Calendar |
setShowMonthButton(java.lang.Boolean showMonthButton)
Set to false to prevent the
Month button from
displaying on Handset devices. |
Calendar |
setShowMonthView(java.lang.Boolean showMonthView)
Whether to show the Month view.
|
Calendar |
setShowNextButton(java.lang.Boolean showNextButton)
Set to false to hide the
Next button. |
Calendar |
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. |
Calendar |
setShowPreviousButton(java.lang.Boolean showPreviousButton)
Set to false to hide the
Previous button. |
Calendar |
setShowQuickEventDialog(java.lang.Boolean showQuickEventDialog)
Determines whether the quick event dialog is displayed when a time is clicked.
|
Calendar |
setShowTimelineView(java.lang.Boolean showTimelineView)
If set to true, show the
Timeline view . |
Calendar |
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.
|
Calendar |
setShowWeekends(java.lang.Boolean showWeekends)
|
Calendar |
setShowWeekView(java.lang.Boolean showWeekView)
Whether to show the Week view.
|
Calendar |
setShowWorkday(java.lang.Boolean showWorkday)
When set to true, this setting enables various features related to cells that fall within the workday (as defined by
workdayStart and workdayEnd ) in vertical calendar views (day and week ). |
Calendar |
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. |
Calendar |
setShowZones(java.lang.Boolean showZones)
Set to true to render any defined
zones into timeline views . |
Calendar |
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.
|
Calendar |
setSizeToWorkday(java.lang.Boolean sizeToWorkday)
When
showWorkday is true, attempt to resize rows in
the day and week views so that the workday hours
fill the visible viewport-height, and the whole workday is visible without scrolling. |
Calendar |
setSort(SortSpecifier... sortSpecifiers)
Sort the component on one or more fields.
|
Calendar |
setSparseFieldState(java.lang.Boolean sparseFieldState)
If true,
ListGrid.getFieldState() and
ListGrid.setFieldState(java.lang.String) will omit state
information for hidden fields by default. |
Calendar |
setStartDate(java.util.Date startDate)
The start date of the calendar
timeline view . |
Calendar |
setStartDateField(java.lang.String startDateField)
The name of the start date field on a
CalendarEvent . |
Calendar |
setStyleWorkday(java.lang.Boolean styleWorkday)
When
showWorkday is true, applies the workdayBaseStyle to cells that fall within the
workday (as defined by workdayStart and workdayEnd ), in both the dayView and weekView . |
Calendar |
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. |
Calendar |
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.
|
Calendar |
setTimelineUnitsPerColumn(int timelineUnitsPerColumn)
How many units of
timelineGranularity each
cell represents. |
Calendar |
setTimelineViewTitle(java.lang.String timelineViewTitle)
The title for the
timeline view . |
Calendar |
setTitleField(java.lang.String titleField)
Sets the best field to use for a user-visible title for an individual record from this component.
|
Calendar |
setTodayBackgroundColor(java.lang.String todayBackgroundColor)
The background color for cells that represent today in all
CalendarView s. |
Calendar |
setTrailingDateField(java.lang.String trailingDateField)
The name of the trailing date field for each event.
|
Calendar |
setTwentyFourHourTime(java.lang.Boolean twentyFourHourTime)
Dictates whether times throughout the widget are formatted and edited as 24-hour values.
|
Calendar |
setUpdateOperation(java.lang.String updateOperation)
operationId this component
should use when performing update operations. |
Calendar |
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.
|
Calendar |
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. |
Calendar |
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. |
Calendar |
setUseSublanes(java.lang.Boolean useSublanes)
|
Calendar |
setWeekendDays(int... weekendDays)
An array of integer day-numbers that should be considered to be weekend days by this Calendar instance.
|
Calendar |
setWeekEventBorderOverlap(java.lang.Boolean weekEventBorderOverlap)
Augments the width of week event windows slightly to avoid duplicate adjacent borders between events.
|
Calendar |
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. |
Calendar |
setWeekViewTitle(java.lang.String weekViewTitle)
The title for the
week view . |
Calendar |
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. |
Calendar |
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 |
Calendar |
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
|
Calendar |
setZones(CalendarEvent... zones)
An array of CalendarEvent instances representing pre-defined periods of time to be highlighted in
timeline views . |
Calendar |
setZoneStyleName(java.lang.String zoneStyleName)
|
Calendar |
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 . |
boolean |
showEventCanvasComponent(EventCanvas canvas)
Should a component be applied to the passed
canvas in the
view in which it appears? Return false from
this method to override the global value of showEventCanvasComponents for this canvas. |
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.
|
java.lang.Boolean |
timelineEventMoved(CalendarEvent event,
java.util.Date startDate,
java.util.Date endDate,
Lane lane)
Deprecated.
in favor of
Calendar.eventRepositionStop() |
java.lang.Boolean |
timelineEventResized(CalendarEvent event,
java.util.Date startDate,
java.util.Date endDate)
Deprecated.
in favor of
Calendar.eventResizeStop() |
void |
transferRecords(Record[] records,
Record targetRecord,
java.lang.Integer index,
Canvas sourceWidget,
TransferRecordsCallback callback)
Transfer a list of
Record s from another component
(does not have to be a databound component) into this component. |
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)
Save an event to this Calendar's ${isc.DocUtils.linkForRef('attr:Calendar.dataSource','dataSource) or \n
data array') . |
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.
|
void |
updateEventCanvasComponent(EventCanvas canvas,
Canvas component)
Called from
EventCanvas.setEvent() when showEventCanvasComponents is true and the
eventCanvas already has a component . |
addChild, addChild, addChild, addChild, addChild, addClearHandler, 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, addRuleContextChangedHandler, addScrolledHandler, addShowContextMenuHandler, addSnapAlignCandidate, addStyleName, addVisibilityChangedHandler, adjustForContent, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateHide, animateHide, animateHide, animateHide, 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, animateShow, asSGWTComponent, blur, bringToFront, clear, clearExplicitTabIndex, clickMaskUp, clickMaskUp, contains, contains, containsEvent, containsEventTarget, containsFocus, containsPoint, containsPoint, dataContextChanged, deparent, depeer, disable, enable, encloses, focus, focusAfterGroup, focusAtEnd, focusInNextTabElement, focusInPreviousTabElement, getAbsoluteLeft, getAbsoluteTop, getAccessKey, getAdaptiveHeightPriority, getAdaptiveWidthPriority, getAlwaysManageFocusNavigation, getAlwaysShowScrollbars, getAnimateAcceleration, getAnimateFadeTime, getAnimateHideAcceleration, getAnimateHideEffect, getAnimateHideTime, getAnimateMoveAcceleration, getAnimateMoveTime, getAnimateRectAcceleration, getAnimateRectTime, getAnimateResizeAcceleration, getAnimateResizeLayoutMode, getAnimateResizeTime, getAnimateScrollAcceleration, getAnimateScrollTime, getAnimateShowAcceleration, getAnimateShowEffect, getAnimateShowTime, getAnimateTime, getAppImgDir, getAriaHandleID, getAriaRole, getAriaStateDefaults, getAutoMaskComponents, getAutoParent, getAutoPopulateData, getAutoShowParent, getBackgroundColor, getBackgroundImage, getBackgroundPosition, getBackgroundRepeat, getBorder, getBorderRadius, getBottom, getById, getByJSObject, getByLocalId, getCanAcceptDrop, getCanAdaptHeight, getCanAdaptWidth, getCanDrag, getCanDragReposition, getCanDragResize, getCanDragScroll, getCanDrop, getCanDropBefore, getCanFocus, getCanHover, getCanSelectText, getCanvasAutoChild, getCanvasItem, getChildren, getChildrenResizeSnapAlign, getChildrenSnapAlign, getChildrenSnapCenterAlign, getChildrenSnapEdgeAlign, getChildrenSnapResizeToGrid, getChildrenSnapToGrid, getChildTabPosition, getClassName, getComponentMask, getComponentMaskDefaults, getContentElement, getContents, getContextMenu, getCorrectZoomOverflow, getCursor, getDataContext, getDataPath, getDefaultHeight, getDefaultWidth, getDestroyed, getDestroying, getDisabled, getDisabledCursor, getDisableTouchScrollingForDrag, getDoubleClickDelay, getDragAppearance, getDragIntersectStyle, getDragMaskType, getDragMaxHeight, getDragMaxWidth, getDragMinHeight, getDragMinWidth, getDragOpacity, getDragRepositionAppearance, getDragRepositionCursor, getDragResizeAppearance, getDragScrollDelay, getDragStartDistance, getDragTarget, getDragTargetAsString, getDragType, getDropTarget, getDropTargetAsString, getDropTypes, getDropTypesAsString, getDynamicContents, getEdgeBackgroundColor, getEdgeCenterBackgroundColor, getEdgeImage, getEdgeMarginSize, getEdgeOffset, getEdgeOpacity, getEdgeShowCenter, getEdgeSize, getEditNode, getEditProxy, getEditProxyConstructor, getElement, getElement, getEnableWhen, getEndLine, getEventEdge, getEventEdge, getExtraSpace, getFacetId, getFloatingScrollbars, getFormItemAutoChild, getForwardSVGeventsToObject, getFullDataPath, getGroupBorderCSS, getGroupLabelBackgroundColor, getGroupLabelStyleName, getGroupPadding, getGroupTitle, getHeight, getHeightAsString, getHideUsingDisplayNone, getHoverAlign, getHoverAutoDestroy, getHoverAutoFitMaxWidth, getHoverAutoFitMaxWidthAsString, getHoverAutoFitWidth, getHoverComponent, getHoverDelay, getHoverFocusKey, getHoverHeight, getHoverHTML, getHoverMoveWithMouse, getHoverOpacity, getHoverPersist, getHoverScreen, getHoverStyle, getHoverVAlign, getHoverWidth, getHoverWrap, getHSnapPosition, getHSnapPosition, getHtmlElement, getHtmlElementAsString, getHtmlPosition, getImage, getImgURL, getImgURL, getInnerContentHeight, getInnerContentWidth, getInnerHeight, getInnerWidth, getIsGroup, getIsPrinting, getIsRuleScope, getIsSnapAlignCandidate, getKeepInParentRect, getLayoutAlign, getLeaveGroupLabelSpace, getLeavePageSpace, getLeft, getLeftAsString, getLocalId, getLocateByIDOnly, getLocateChildrenBy, getLocateChildrenType, getLocatePeersBy, getLocatePeersType, getLocatorName, getMargin, getMasterCanvas, getMasterElement, getMatchElement, getMatchElementHeight, getMatchElementWidth, getMaxHeight, getMaxWidth, getMaxZoomOverflowError, getMenuConstructor, getMinHeight, getMinNonEdgeSize, getMinWidth, getMomentumScrollMinSpeed, getMouseStillDownDelay, getMouseStillDownInitialDelay, getName, getNativeAutoHideScrollbars, getNextZIndex, getNoDoubleClicks, getNoDropCursor, getOffsetHeight, getOffsetWidth, getOffsetX, getOffsetY, getOpacity, getOuterElement, getOverflow, getPadding, getPageBottom, getPageLeft, getPageRect, getPageRight, getPageTop, getPaletteDefaults, getPanelContainer, getParentCanvas, getParentElement, getPeers, getPercentBox, getPercentSource, getPersistentMatchElement, getPointerSettings, getPointerTarget, getPointerTargetAsString, getPosition, getPrefix, getPrintChildrenAbsolutelyPositioned, getPrintHTML, getPrintHTML, getPrintStyleName, getPrompt, getProportionalResizeModifiers, getProportionalResizing, getReceiveScrollbarEvents, getRect, getRedrawOnResize, getResizeBarTarget, getResizeFrom, getRight, getRuleContext, getRuleContext, getRuleScope, getScrollbarSize, getScrollBottom, getScrollHeight, getScrollLeft, getScrollRight, getScrollTop, getScrollWidth, getShadowColor, getShadowDepth, getShadowHOffset, getShadowImage, getShadowOffset, getShadowSoftness, getShadowSpread, getShadowVOffset, getShouldPrint, getShowCustomScrollbars, getShowDragShadow, getShowEdges, getShowHover, getShowHoverComponents, getShowPointer, getShowResizeBar, getShowShadow, getShowSnapGrid, getShrinkElementOnHide, getSizeMayChangeOnRedraw, getSkinImgDir, getSnapAlignCandidates, getSnapAlignCenterLineStyle, getSnapAlignEdgeLineStyle, getSnapAxis, getSnapEdge, getSnapGridLineProperties, getSnapGridStyle, getSnapHDirection, getSnapHGap, getSnapOffsetLeft, getSnapOffsetTop, getSnapOnDrop, getSnapPosition, getSnapPosition, getSnapResizeToAlign, getSnapResizeToGrid, getSnapTo, getSnapToAlign, getSnapToCenterAlign, getSnapToEdgeAlign, getSnapToGrid, getSnapVDirection, getSnapVGap, getStartLine, getStyleName, getTabIndex, getTestDataContext, getTestInstance, getTitle, getTooltip, getTop, getTopAsString, getTopElement, getUISummary, getUpdateTabPositionOnDraw, getUpdateTabPositionOnReparent, getUseBackMask, getUseCSSShadow, getUseDragMask, getUseImageForSVG, getUseNativeDrag, getUseOpacityFilter, getUseTouchScrolling, getValuesManager, getValuesManagerAsString, getViewportHeight, getViewportWidth, getVisibility, getVisibleHeight, getVisibleWhen, getVisibleWidth, getVSnapPosition, getVSnapPosition, getWidth, getWidthAsString, getZIndex, getZIndex, handleHover, hide, hideClickMask, hideClickMask, hideComponentMask, hideComponentMask, hideContextMenu, imgHTML, imgHTML, imgHTML, intersects, isDirty, isDisabled, 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, print, print, print, print, printComponents, provideRuleContext, provideRuleContext, redraw, redraw, registerFontScaledPaddingStyles, removeChild, removeChild, removePeer, removePeer, removeRuleContext, removeSnapAlignCandidate, resizeAutoChildAttributes, resizeBy, resizeControls, resizeControlsTo, resizeFonts, resizeFonts, resizeFonts, resizeFontsTo, resizeIcons, resizePadding, resizePadding, resizeTo, resizeTo, revealChild, revealChild, scrollBy, scrollByPercent, scrollTo, scrollTo, scrollTo, scrollToBottom, scrollToLeft, scrollToPercent, scrollToRight, scrollToTop, sendToBack, setAccessKey, setAdaptHeightByCustomizer, setAdaptiveHeightPriority, setAdaptiveWidthPriority, setAdaptWidthByCustomizer, setAlign, setAllowExternalFilters, setAlwaysManageFocusNavigation, setAlwaysShowScrollbars, setAnimateAcceleration, setAnimateFadeTime, setAnimateHideAcceleration, setAnimateHideEffect, setAnimateHideTime, setAnimateMoveAcceleration, setAnimateMoveTime, setAnimateRectAcceleration, setAnimateRectTime, setAnimateResizeAcceleration, setAnimateResizeLayoutMode, setAnimateResizeTime, setAnimateScrollAcceleration, setAnimateScrollTime, setAnimateShowAcceleration, setAnimateShowEffect, setAnimateShowTime, setAnimateTime, setAppImgDir, setAriaRole, setAriaState, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoHeight, setAutoMaskComponents, setAutoParent, setAutoPopulateData, setAutoResizeAutoChildAttributes, setAutoResizeIcons, setAutoShowParent, setAutoWidth, setBackgroundColor, setBackgroundImage, setBackgroundPosition, setBackgroundRepeat, setBorder, setBorderRadius, setBottom, setCanAcceptDrop, setCanAdaptHeight, setCanAdaptWidth, setCanDrag, setCanDragReposition, setCanDragResize, setCanDragScroll, setCanDrop, setCanDropBefore, setCanFocus, setCanHover, setCanSelectText, setChildren, setChildrenResizeSnapAlign, setChildrenSnapAlign, setChildrenSnapCenterAlign, setChildrenSnapEdgeAlign, setChildrenSnapResizeToGrid, setChildrenSnapToGrid, setComponentMaskDefaults, setContents, setContextMenu, setCorrectZoomOverflow, setCursor, setDataContext, setDataPath, setDefaultHeight, setDefaultPageSpace, setDefaultProperties, setDefaultShowCustomScrollbars, setDefaultWidth, setDisabled, setDisabledCursor, setDisableTouchScrollingForDrag, setDoubleClickDelay, setDragAppearance, setDragIntersectStyle, setDragMaskType, setDragMaxHeight, setDragMaxWidth, setDragMinHeight, setDragMinWidth, setDragOpacity, setDragRepositionAppearance, setDragRepositionCursor, setDragResizeAppearance, setDragScrollDelay, setDragStartDistance, setDragTarget, setDragTarget, setDragType, setDropTarget, setDropTarget, setDropTypes, setDropTypes, setDynamicContents, setEdgeBackgroundColor, setEdgeCenterBackgroundColor, setEdgeImage, setEdgeMarginSize, setEdgeOffset, setEdgeOpacity, setEdgeShowCenter, setEdgeSize, setEditMode, setEditMode, setEditMode, setEditProxyConstructor, setElement, setEnableWhen, setEndLine, setExtraSpace, setFacetId, setFloatingScrollbars, setForwardSVGeventsToObject, setGroupBorderCSS, setGroupLabelBackgroundColor, setGroupLabelStyleName, setGroupPadding, setGroupTitle, setHeight, setHeight, setHeight, setHeight100, setHideUsingDisplayNone, setHoverAlign, setHoverAutoDestroy, setHoverAutoFitMaxWidth, setHoverAutoFitMaxWidth, setHoverAutoFitWidth, setHoverDelay, setHoverFocusKey, setHoverHeight, setHoverMoveWithMouse, setHoverOpacity, setHoverPersist, setHoverScreen, setHoverStyle, setHoverVAlign, setHoverWidth, setHoverWrap, setHtmlElement, setHtmlElement, setHtmlPosition, setImage, setImage, setInitHandler, setIsGroup, setIsRuleScope, setIsSnapAlignCandidate, setKeepInParentRect, setKeepInParentRect, setKeepInParentRect, setLayoutAlign, setLayoutAlign, setLeaveGroupLabelSpace, setLeavePageSpace, setLeft, setLeft, setLocateByIDOnly, setLocateChildrenBy, setLocateChildrenType, setLocatePeersBy, setLocatePeersType, setLocatorName, setLocatorParent, setLocatorParent, setLogicalStructure, setMargin, setMatchElement, setMatchElementHeight, setMatchElementWidth, setMaxHeight, setMaxWidth, setMaxZoomOverflowError, setMenuConstructor, setMinHeight, setMinNonEdgeSize, setMinWidth, setMomentumScrollMinSpeed, setMouseStillDownDelay, setMouseStillDownInitialDelay, setName, setNativeAutoHideScrollbars, setNeverUseFilters, setNoDoubleClicks, setNoDropCursor, setOpacity, setOverflow, setPadding, setPageLeft, setPageTop, setPanelContainer, setParentCanvas, setParentElement, setPeers, setPercentBox, setPercentSource, setPersistentMatchElement, setPointerSettings, setPointerTarget, setPosition, setPrefix, setPrintChildrenAbsolutelyPositioned, setPrintStyleName, setPrompt, setProportionalResizeModifiers, setProportionalResizing, setReceiveScrollbarEvents, setRect, setRect, setRedrawOnResize, setRelativeTabPosition, setResizeBarTarget, setResizeFrom, setResizeFrom, setRight, setRuleScope, setScrollbarConstructor, setScrollbarSize, setShadowColor, setShadowDepth, setShadowHOffset, setShadowImage, setShadowOffset, setShadowSoftness, setShadowSpread, setShadowVOffset, setShouldPrint, setShowCustomScrollbars, setShowDragShadow, setShowEdges, setShowHover, setShowHoverComponents, setShowPointer, setShowResizeBar, setShowShadow, setShowSnapGrid, setShrinkElementOnHide, setSizeMayChangeOnRedraw, setSkinImgDir, setSmoothFade, setSnapAlignCandidates, setSnapAlignCenterLineStyle, setSnapAlignEdgeLineStyle, setSnapAxis, setSnapEdge, setSnapGridLineProperties, setSnapGridStyle, setSnapHDirection, setSnapHGap, setSnapOffsetLeft, setSnapOffsetTop, setSnapOnDrop, setSnapResizeToAlign, setSnapResizeToGrid, setSnapTo, setSnapToAlign, setSnapToCenterAlign, setSnapToEdgeAlign, setSnapToGrid, setSnapVDirection, setSnapVGap, setStartLine, setStyleName, setTabIndex, setTestDataContext, setTitle, setTooltip, setTop, setTop, setUpdateTabPositionOnDraw, setUpdateTabPositionOnReparent, setUseBackMask, setUseCSSShadow, setUseDragMask, setUseImageForSVG, setUseNativeDrag, setUseOpacityFilter, setUseTouchScrolling, setValuesManager, setValuesManager, setVisibility, setVisible, setVisibleWhen, setWidth, setWidth, setWidth, setWidth100, setZIndex, shouldDragScroll, show, showClickMask, showComponentMask, showComponentMask, showNextTo, showNextTo, showNextTo, showNextTo, showPrintPreview, showPrintPreview, showPrintPreview, showPrintPreview, showRecursively, updateChildTabPosition, updateChildTabPositions, updateEditNode, updateHover, updateHover, updateShadow, updateTabPositionForDraw, visibleAtPoint, willAcceptDrop
addDrawHandler, addDynamicProperty, addDynamicProperty, addDynamicProperty, addDynamicProperty, applyFactoryProperties, clearDynamicProperty, completeCreation, destroy, doAddHandler, doInit, doOnRender, draw, equals, error, errorIfNotCreated, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDateArray, getAttributeAsDouble, getAttributeAsElement, getAttributeAsFloat, getAttributeAsFloatArray, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getConfig, getDOM, getHandlerCount, getID, getInnerHTML, getJsObj, getOrCreateJsObj, getRef, getScClassName, hasAutoAssignedID, hasDynamicProperty, hashCode, initNativeObject, internalSetID, internalSetID, isConfigOnly, isCreated, isDrawn, 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, setDefaultProperties, setDragTracker, setFactoryCreated, setID, setJavaScriptObject, setLogicalStructure, 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
.
This component is an AutoChild named "addEventButton". 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 Calendar setAddEventButtonHoverText(java.lang.String addEventButtonHoverText) throws java.lang.IllegalStateException
add event
toolbar buttonaddEventButtonHoverText
- New addEventButtonHoverText value. Default value is "Add an event"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getAddEventButtonHoverText()
add event
toolbar buttonpublic Calendar 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
- New allowDurationEvents value. Default value is nullCalendar
instance, for chaining setter callsCalendarEvent
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 Calendar 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
- New alternateLaneStyles value. Default value is nullCalendar
instance, for chaining setter callspublic 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 Calendar setAlwaysShowEventHovers(java.lang.Boolean alwaysShowEventHovers)
Note - if you have custom hover-content/handling, you should leave this property set to true.
alwaysShowEventHovers
- New alwaysShowEventHovers value. Default value is trueCalendar
instance, for chaining setter callspublic java.lang.Boolean getAlwaysShowEventHovers()
Note - if you have custom hover-content/handling, you should leave this property set to true.
public Calendar 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
- New backButtonTitle value. Default value is "Back"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public 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 Calendar 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
- New baseStyle value. Default value is "calendar"Calendar
instance, for chaining setter callsCSSStyleName
,
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 Calendar setBringEventsToFront(java.lang.Boolean bringEventsToFront) throws java.lang.IllegalStateException
bringEventsToFront
- New bringEventsToFront value. Default value is nullCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getBringEventsToFront()
public Calendar setCalMonthEventLinkStyle(java.lang.String calMonthEventLinkStyle)
getDayBodyHTML()
. These links are rendered as plain
HTML links using A elements, and the CSS style in the provided skins references the pseudo-classes :link, :visited,
:active, :hover.
Even though it goes against the general policy of not exposing the HTML structures SC writes out
and not relying on them for styling, applying style to these particular selectors is acceptable, as we're unlikely to
use any other kind of HTML structure than a link.
calMonthEventLinkStyle
- New calMonthEventLinkStyle value. Default value is "calMonthEventLink"Calendar
instance, for chaining setter callsCSSStyleName
,
Appearance overview and related methods
public java.lang.String getCalMonthEventLinkStyle()
getDayBodyHTML()
. These links are rendered as plain
HTML links using A elements, and the CSS style in the provided skins references the pseudo-classes :link, :visited,
:active, :hover.
Even though it goes against the general policy of not exposing the HTML structures SC writes out
and not relying on them for styling, applying style to these particular selectors is acceptable, as we're unlikely to
use any other kind of HTML structure than a link.
CSSStyleName
,
Appearance overview and related methods
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
.
This component is an AutoChild named "cancelButton". 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 Calendar setCancelButtonTitle(java.lang.String cancelButtonTitle) throws java.lang.IllegalStateException
Cancel button
in the event editor
.cancelButtonTitle
- New cancelButtonTitle value. Default value is "Cancel"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getCancelButtonTitle()
Cancel button
in the event editor
.HTMLString
public Calendar setCanCreateEvents(java.lang.Boolean canCreateEvents) throws java.lang.IllegalStateException
canCreateEvents
- New canCreateEvents value. Default value is trueCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanCreateEvents()
public Calendar setCanCreateOtherDayEvents(java.lang.Boolean canCreateOtherDayEvents)
showOtherDays
is true, determines whether
clicking in a Month-view body-cell that represents a date outside the selected month will open the event-editor window
at the cell's location. Note that,
when otherDayClickNavigation
is also
true, the Month-view first switches to the month of the clicked date before displaying the event-editor. This causes
the editor to open in a different cell than the one clicked and may be unexpected to users.
canCreateOtherDayEvents
- New canCreateOtherDayEvents value. Default value is falseCalendar
instance, for chaining setter callspublic java.lang.Boolean getCanCreateOtherDayEvents()
showOtherDays
is true, determines whether
clicking in a Month-view body-cell that represents a date outside the selected month will open the event-editor window
at the cell's location. Note that,
when otherDayClickNavigation
is also
true, the Month-view first switches to the month of the clicked date before displaying the event-editor. This causes
the editor to open in a different cell than the one clicked and may be unexpected to users.
public Calendar setCanDeleteEvents(java.lang.Boolean canDeleteEvents) throws java.lang.IllegalStateException
canRemoveEvents
canEditEvents
.canDeleteEvents
- New canDeleteEvents value. Default value is nullCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanDeleteEvents()
canRemoveEvents
canEditEvents
.public Calendar setCanDragCreateEvents(java.lang.Boolean canDragCreateEvents)
canDragCreateEvents
- New canDragCreateEvents value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Boolean getCanDragCreateEvents()
public Calendar 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
- New canDragEventField value. Default value is "canDrag"Calendar
instance, for chaining setter callsjava.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 Calendar setCanDragEvents(java.lang.Boolean canDragEvents) throws java.lang.IllegalStateException
Only has an effect when canEditEvents
is true.
canDragEvents
- New canDragEvents value. Default value is nullCalendar
instance, for chaining setter callsjava.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 Calendar setCanEditEvents(java.lang.Boolean canEditEvents) throws java.lang.IllegalStateException
canEditEvents
- New canEditEvents value. Default value is trueCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanEditEvents()
public Calendar 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
- New canEditField value. Default value is "canEdit"Calendar
instance, for chaining setter callsjava.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 Calendar setCanEditLane(java.lang.Boolean canEditLane) throws java.lang.IllegalStateException
lane
, and the event quick dialog
and editor
allow a lane to be selected with a drop-down
chooser. In either case, the event's laneNameField
is updated automatically.
If set to false, cross-lane dragging is disallowed and drop-down
Lane-choosers are disabled when editing existng events. When creating new events
, the Lane-chooser remains enabled so an
initial Lane can be selected.
This setting can be overridden on each event
.
canEditLane
- New canEditLane value. Default value is nullCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanEditLane()
lane
, and the event quick dialog
and editor
allow a lane to be selected with a drop-down
chooser. In either case, the event's laneNameField
is updated automatically.
If set to false, cross-lane dragging is disallowed and drop-down
Lane-choosers are disabled when editing existng events. When creating new events
, the Lane-chooser remains enabled so an
initial Lane can be selected.
This setting can be overridden on each event
.
public Calendar setCanEditLaneField(java.lang.String canEditLaneField) throws java.lang.IllegalStateException
CalendarEvent
that determines whether that event
can be moved between lanes.canEditLaneField
- New canEditLaneField value. Default value is "canEditLane"Calendar
instance, for chaining setter callsjava.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 Calendar 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
- New canEditSublane value. Default value is nullCalendar
instance, for chaining setter callsjava.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 Calendar 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
- New canEditSublaneField value. Default value is "canEditSublane"Calendar
instance, for chaining setter callsjava.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 Calendar 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
- New canGroupLanes value. Default value is nullCalendar
instance, for chaining setter callspublic 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 Calendar setCanRemoveEvents(java.lang.Boolean canRemoveEvents) throws java.lang.IllegalStateException
canEditEvents
.canRemoveEvents
- New canRemoveEvents value. Default value is trueCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanRemoveEvents()
canEditEvents
.public Calendar setCanRemoveField(java.lang.String canRemoveField) throws java.lang.IllegalStateException
CalendarEvent
that determines whether an event
shows a remove button.canRemoveField
- New canRemoveField value. Default value is "canRemove"Calendar
instance, for chaining setter callsjava.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 Calendar setCanReorderLanes(java.lang.Boolean canReorderLanes) throws java.lang.IllegalStateException
laneFields
with the mouse.canReorderLanes
- New canReorderLanes value. Default value is nullCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanReorderLanes()
laneFields
with the mouse.public Calendar setCanResizeEventField(java.lang.String canResizeEventField) throws java.lang.IllegalStateException
CalendarEvent
that determines whether an event
can be resized by dragging.canResizeEventField
- New canResizeEventField value. Default value is "canResize"Calendar
instance, for chaining setter callsjava.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 Calendar 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. Always false when showColumnLayouts
is true.
canResizeEvents
- New canResizeEvents value. Default value is trueCalendar
instance, for chaining setter callsjava.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. Always false when showColumnLayouts
is true.
public Calendar setCanResizeTimelineEvents(java.lang.Boolean canResizeTimelineEvents) throws java.lang.IllegalStateException
canResizeEvents
;Timeline
events be stretched by their left and right edges?canResizeTimelineEvents
- New canResizeTimelineEvents value. Default value is falseCalendar
instance, for chaining setter callsjava.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 Calendar setCanSelectEvents(java.lang.Boolean canSelectEvents) throws java.lang.IllegalStateException
event canvases
selectable.
Events may be selected via a single click, as well as being included in the page's tab order. The current selected event
is shown in a special style and pressing TAB or Shift-TAB will move the selection first among the events in the same
lane, and then among those in the next or previous lane. Pressing Enter while an editable event is selected will
show either the event- dialog
or editor
. Pressing Delete will remove the event.
Note that when this property is false, single clicking the event canvas for an editable event will bring up an editing interface for that event. When true this is no longer the case - a user can double click to bring up the editing interface instead (a single click will simply select the event canvas).
canSelectEvents
- New canSelectEvents value. Default value is nullCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanSelectEvents()
event canvases
selectable.
Events may be selected via a single click, as well as being included in the page's tab order. The current selected event
is shown in a special style and pressing TAB or Shift-TAB will move the selection first among the events in the same
lane, and then among those in the next or previous lane. Pressing Enter while an editable event is selected will
show either the event- dialog
or editor
. Pressing Delete will remove the event.
Note that when this property is false, single clicking the event canvas for an editable event will bring up an editing interface for that event. When true this is no longer the case - a user can double click to bring up the editing interface instead (a single click will simply select the event canvas).
public Calendar setChosenDate(java.util.Date chosenDate)
chosenDate
- the new date to set as the current date. Default value is 'Today'Calendar
instance, for chaining setter callspublic java.util.Date getChosenDate()
public VLayout getColumnLayout()
Using AutoChildren
for details.
When showColumnLayouts
is true, the layouts
added to each column to stack events.
public Calendar 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
- New columnsPerPage value. Default value is nullCalendar
instance, for chaining setter callsjava.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 Calendar setControlBarIconSize(java.lang.Integer controlBarIconSize) throws java.lang.IllegalStateException
controlsBar
of this Calendar.controlBarIconSize
- New controlBarIconSize value. Default value is 16Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getControlBarIconSize()
controlsBar
of this Calendar.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.
This component is an AutoChild named "controlsBar". 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 Calendar setControlsBarHeight(java.lang.Integer controlsBarHeight) throws java.lang.IllegalStateException
controlsBar
shown above the
main Calendar grid. When multiple views are available and tabs are visible, this value is modified to ensure that the
content of the controlsBar
is vertically-aligned with the text in the tabs.controlsBarHeight
- New controlsBarHeight value. Default value is 34Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getControlsBarHeight()
controlsBar
shown above the
main Calendar grid. When multiple views are available and tabs are visible, this value is modified to ensure that the
content of the controlsBar
is vertically-aligned with the text in the tabs.public Calendar setCurrentViewName(ViewName currentViewName)
currentViewName
- The name of the view that should be made visible. Default value is nullCalendar
instance, for chaining setter callspublic ViewName getCurrentViewName()
public Calendar 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 nullCalendar
instance, for chaining setter callsCalendarEvent
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 Calendar 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
- New dataFetchMode value. Default value is "paged"Calendar
instance, for chaining setter callsDatabinding 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 Calendar 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
- New dataSource value. Default value is nullCalendar
instance, for chaining setter callsDatabinding overview and related methods
,
DataSource fields Examplepublic Calendar 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
- New dataSource value. Default value is nullCalendar
instance, for chaining setter callsDatabinding 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.
This component is an AutoChild named "dateChooser". 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 Calendar 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
- New dateEditingStyle value. Default value is nullCalendar
instance, for chaining setter callsjava.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 Calendar setDateFormatter(DateDisplayFormat dateFormatter)
DateUtil.setShortDisplayFormat()
. Specify any valid DateDisplayFormat
.dateFormatter
- New dateFormatter value. Default value is nullCalendar
instance, for chaining setter callspublic DateDisplayFormat getDateFormatter()
DateUtil.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.
This component is an AutoChild named "dateLabel". 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.
This component is an AutoChild named "datePickerButton". 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 Calendar setDatePickerHoverText(java.lang.String datePickerHoverText) throws java.lang.IllegalStateException
date picker
toolbar buttondatePickerHoverText
- New datePickerHoverText value. Default value is "Choose a date"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getDatePickerHoverText()
date picker
toolbar buttonpublic Calendar 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
- New dayBodyBaseStyle value. Default value is "calMonthDayBody"Calendar
instance, for chaining setter callsCSSStyleName
,
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 Calendar 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
- New dayHeaderBaseStyle value. Default value is "calMonthDayHeader"Calendar
instance, for chaining setter callsCSSStyleName
,
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.
This component is an AutoChild named "dayView". 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 Calendar setDayViewTitle(java.lang.String dayViewTitle) throws java.lang.IllegalStateException
day view
.dayViewTitle
- New dayViewTitle value. Default value is "Day"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getDayViewTitle()
day view
.public Calendar setDefaultTimelineColumnSpan(int defaultTimelineColumnSpan) throws java.lang.IllegalStateException
timelineGranularity
to give the timeline by default if no endDate
is provided. The default is 20.defaultTimelineColumnSpan
- New defaultTimelineColumnSpan value. Default value is 20Calendar
instance, for chaining setter callsjava.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 Calendar setDescriptionField(java.lang.String descriptionField) throws java.lang.IllegalStateException
CalendarEvent
.descriptionField
- New descriptionField value. Default value is "description"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getDescriptionField()
CalendarEvent
.public Calendar setDetailsButtonTitle(java.lang.String detailsButtonTitle) throws java.lang.IllegalStateException
quick
event dialog
.detailsButtonTitle
- New detailsButtonTitle value. Default value is "Edit Details"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getDetailsButtonTitle()
quick
event dialog
.HTMLString
public Calendar setDisableWeekends(java.lang.Boolean disableWeekends)
weekendDays
.disableWeekends
- New disableWeekends value. Default value is trueCalendar
instance, for chaining setter callsVisibility overview and related methods
public java.lang.Boolean getDisableWeekends()
weekendDays
.Visibility overview and related methods
public Calendar setDurationField(java.lang.String durationField) throws java.lang.IllegalStateException
duration
field on a CalendarEvent
.durationField
- New durationField value. Default value is "duration"Calendar
instance, for chaining setter callsjava.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 Calendar setDurationUnitField(java.lang.String durationUnitField) throws java.lang.IllegalStateException
durationUnit
field on a
CalendarEvent
.durationUnitField
- New durationUnitField value. Default value is "durationUnit"Calendar
instance, for chaining setter callsjava.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 Calendar setEndDate(java.util.Date endDate) throws java.lang.IllegalStateException
To set different start
and end dates after initial draw, see setTimelineRange
.
Note that the value you provide
may be automatically altered if showing header-levels
, to fit to header boundaries.
endDate
- New endDate value. Default value is nullCalendar
instance, for chaining setter callsjava.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 the value you provide
may be automatically altered if showing header-levels
, to fit to header boundaries.
public Calendar setEndDateField(java.lang.String endDateField) throws java.lang.IllegalStateException
CalendarEvent
.endDateField
- New endDateField value. Default value is "endDate"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getEndDateField()
CalendarEvent
.CalendarEvent
public Calendar setEventAutoArrange(java.lang.Boolean eventAutoArrange) throws java.lang.IllegalStateException
eventAutoArrange
- New eventAutoArrange value. Default value is trueCalendar
instance, for chaining setter callsjava.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.
This component is an AutoChild named "eventCanvasButtonLayout". 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
.
This component is an AutoChild named "eventCanvasCloseButton". 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 Canvas getEventCanvasComponent()
Using AutoChildren
for details.
Multi-AutoChild component, created as a space-filling member in individual event-canvases
, when showEventCanvasComponents
is true.
public ImgButton getEventCanvasContextButton() throws java.lang.IllegalStateException
context menu
when clicked.
This component is an AutoChild named "eventCanvasContextButton". 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.
This component is an AutoChild named "eventCanvasContextMenu". 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 Calendar setEventDescriptionFieldTitle(java.lang.String eventDescriptionFieldTitle) throws java.lang.IllegalStateException
eventDescriptionFieldTitle
- New eventDescriptionFieldTitle value. Default value is "Description"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public 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.
This component is an AutoChild named "eventDialog". 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 Calendar setEventDragGap(java.lang.Integer eventDragGap)
eventDragGap
- New eventDragGap value. Default value is 10Calendar
instance, for chaining setter callspublic java.lang.Integer getEventDragGap()
public Calendar setEventDurationFieldTitle(java.lang.String eventDurationFieldTitle) throws java.lang.IllegalStateException
eventDurationFieldTitle
- New eventDurationFieldTitle value. Default value is "Duration"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getEventDurationFieldTitle()
HTMLString
public Calendar setEventDurationUnitFieldTitle(java.lang.String eventDurationUnitFieldTitle) throws java.lang.IllegalStateException
eventDurationUnitFieldTitle
- New eventDurationUnitFieldTitle value. Default value is " "Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public 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
This component is an AutoChild named "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 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
.
This component is an AutoChild named "eventEditorButtonLayout". 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 Calendar setEventEditorDateFieldTitle(java.lang.String eventEditorDateFieldTitle) throws java.lang.IllegalStateException
eventEditor
that allows for changing the logical start-date of an event, along with its start and end times, when editing events in
the day
and week
views.eventEditorDateFieldTitle
- New eventEditorDateFieldTitle value. Default value is "Date"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
,
Editing overview and related methods
public java.lang.String getEventEditorDateFieldTitle()
eventEditor
that allows for changing the logical start-date of an event, along with its start and end times, when editing events in
the day
and week
views.HTMLString
,
Editing overview and related methods
public Window getEventEditorLayout() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
of type Window
that displays the full
event editor
This component is an AutoChild named "eventEditorLayout". 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 Calendar setEventEndDateFieldTitle(java.lang.String eventEndDateFieldTitle) throws java.lang.IllegalStateException
eventEndDateFieldTitle
- New eventEndDateFieldTitle value. Default value is "To"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getEventEndDateFieldTitle()
HTMLString
public Calendar setEventHeaderHeight(int eventHeaderHeight) throws java.lang.IllegalStateException
eventHeaderWrap
is false and showEventDescriptions
is true, this is the fixed
height for the header area
in event canvases.eventHeaderHeight
- New eventHeaderHeight value. Default value is 14Calendar
instance, for chaining setter callsjava.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 fixed
height for the header area
in event canvases.public Calendar 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
- New eventHeaderWrap value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar setEventLaneFieldTitle(java.lang.String eventLaneFieldTitle) throws java.lang.IllegalStateException
eventLaneFieldTitle
- New eventLaneFieldTitle value. Default value is "Lane"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getEventLaneFieldTitle()
HTMLString
public Calendar setEventNameFieldTitle(java.lang.String eventNameFieldTitle) throws java.lang.IllegalStateException
eventNameFieldTitle
- New eventNameFieldTitle value. Default value is "Event Name"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getEventNameFieldTitle()
HTMLString
public Calendar 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 for Calendars and false for Timelines
.eventOverlap
- New eventOverlap value. Default value is trueCalendar
instance, for chaining setter callsjava.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 for Calendars and false for Timelines
.public Calendar setEventOverlapIdenticalStartTimes(java.lang.Boolean eventOverlapIdenticalStartTimes) throws java.lang.IllegalStateException
eventOverlapIdenticalStartTimes
- New eventOverlapIdenticalStartTimes value. Default value is falseCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getEventOverlapIdenticalStartTimes()
public Calendar setEventOverlapPercent(int eventOverlapPercent) throws java.lang.IllegalStateException
eventOverlapPercent
- New eventOverlapPercent value. Default value is 10Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getEventOverlapPercent()
public Calendar setEventScreen(java.lang.String eventScreen) throws java.lang.IllegalStateException
createScreen()
) in lieu of calling createEventCanvasComponent()
. If this
calendar has a dataSource
, the created screen is
provided with a Canvas.dataContext
that includes the event
being shown. Be sure the event screen meets these requirements
to utilize the dataContext
.
eventScreen
- New eventScreen value. Default value is nullCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getEventScreen()
createScreen()
) in lieu of calling createEventCanvasComponent()
. If this
calendar has a dataSource
, the created screen is
provided with a Canvas.dataContext
that includes the event
being shown. Be sure the event screen meets these requirements
to utilize the dataContext
.
public Calendar setEventSnapGap(java.lang.Integer eventSnapGap)
If unset (the default), all views will snap to each cell boundary; 30 minutes in a default vertical
view, or one column
in a default Timeline.
If set to zero, views will snap to one of a set of known "sensible" defaults: for a default vertical, this will be
5 minutes. For timelines, the eventSnapGap 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 any other value is specified, it is used where possible.
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 of a set of "sensible" time-spans 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
- New eventSnapGap value. Default value is nullCalendar
instance, for chaining setter callsEditing overview and related methods
public java.lang.Integer getEventSnapGap()
If unset (the default), all views will snap to each cell boundary; 30 minutes in a default vertical
view, or one column
in a default Timeline.
If set to zero, views will snap to one of a set of known "sensible" defaults: for a default vertical, this will be
5 minutes. For timelines, the eventSnapGap 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 any other value is specified, it is used where possible.
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 of a set of "sensible" time-spans 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 Calendar setEventStartDateFieldTitle(java.lang.String eventStartDateFieldTitle) throws java.lang.IllegalStateException
eventStartDateFieldTitle
- New eventStartDateFieldTitle value. Default value is "From"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getEventStartDateFieldTitle()
HTMLString
public Calendar 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
- New eventStyleName value. Default value is "eventWindow"Calendar
instance, for chaining setter callsCSSStyleName
,
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 Calendar setEventStyleNameField(java.lang.String eventStyleNameField) throws java.lang.IllegalStateException
eventStyleName
for an individual CalendarEvent.styleName
.eventStyleNameField
- New eventStyleNameField value. Default value is "styleName"Calendar
instance, for chaining setter callsjava.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 Calendar setEventSublaneFieldTitle(java.lang.String eventSublaneFieldTitle) throws java.lang.IllegalStateException
eventSublaneFieldTitle
- New eventSublaneFieldTitle value. Default value is "Sublane"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getEventSublaneFieldTitle()
HTMLString
public Calendar setEventWindowStyle(java.lang.String eventWindowStyle)
eventStyleName
eventWindowStyle
- New eventWindowStyle value. Default value is nullCalendar
instance, for chaining setter callsCSSStyleName
,
Appearance overview and related methods
public java.lang.String getEventWindowStyle()
eventStyleName
CSSStyleName
,
Appearance overview and related methods
public Calendar setEventWindowStyleField(java.lang.String eventWindowStyleField) throws java.lang.IllegalStateException
eventStyleNameField
eventWindowStyle
for an individual CalendarEvent
. See CalendarEvent.eventWindowStyle
.eventWindowStyleField
- New eventWindowStyleField value. Default value is "eventWindowStyle"Calendar
instance, for chaining setter callsjava.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 Calendar setFirstDayOfWeek(java.lang.Integer firstDayOfWeek)
DateChooser
. If unset, the default is taken from the current locale.
firstDayOfWeek
- New firstDayOfWeek value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Integer getFirstDayOfWeek()
DateChooser
. If unset, the default is taken from the current locale.
public Calendar 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 nullCalendar
instance, for chaining setter callspublic 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 Calendar setHideUnusedLanes(java.lang.Boolean hideUnusedLanes)
lane
that doesn't have any
active events in the current dataset.
hideUnusedLanes
after creation.hideUnusedLanes
- whether to hide unused lanes. Default value is nullCalendar
instance, for chaining setter callspublic 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 Calendar 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 nullCalendar
instance, for chaining setter callspublic 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 Calendar setIndicatorStyleName(java.lang.String indicatorStyleName)
indicatorStyleName
- New indicatorStyleName value. Default value is "indicatorCanvas"Calendar
instance, for chaining setter callsCSSStyleName
public java.lang.String getIndicatorStyleName()
CSSStyleName
public Calendar 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
- New invalidDateMessage value. Default value is "From must be before To"Calendar
instance, for chaining setter callsjava.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 Calendar setLaneEventPadding(java.lang.Integer laneEventPadding)
lane
or sublane
they appear in. Only applicable to timelines
and to dayViews
showing day lanes
.laneEventPadding
- New laneEventPadding value. Default value is 0Calendar
instance, for chaining setter callspublic java.lang.Integer getLaneEventPadding()
lane
or sublane
they appear in. Only applicable to timelines
and to dayViews
showing day lanes
.public Calendar 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
- New laneFields value. Default value is nullCalendar
instance, for chaining setter callsjava.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 Calendar 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
- New laneGroupByField value. Default value is nullCalendar
instance, for chaining setter callspublic 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 Calendar 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
- New laneGroupByField value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.String[] getLaneGroupByFieldAsStringArray()
canGroupLanes
set to true,
this is a field name or array of field names on which to group the lanes in a timeline.public Calendar setLaneNameField(java.lang.String laneNameField) throws java.lang.IllegalStateException
lane
in
which a given event will be displayed in Timeline
s and in the day view
, if showDayLanes
is true.laneNameField
- New laneNameField value. Default value is "lane"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getLaneNameField()
lane
in
which a given event will be displayed in Timeline
s and in the day view
, if showDayLanes
is true.CalendarEvent
public Calendar 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 nullCalendar
instance, for chaining setter callspublic Lane[] getLanes()
Lane
definitions that represent the rows of the timelineView
, or the columns of the dayView
if showDayLanes
is true.public Calendar 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
- New leadingDateField value. Default value is "leadingDate"Calendar
instance, for chaining setter callsjava.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 Calendar setLimitToWorkday(java.lang.Boolean limitToWorkday) throws java.lang.IllegalStateException
showWorkday
is true, this attribute prevents
the user from scrolling vertical views beyond the specified workday start
and end
hours.limitToWorkday
- New limitToWorkday value. Default value is falseCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetStyleWorkday(java.lang.Boolean)
,
setSizeToWorkday(java.lang.Boolean)
,
setScrollToWorkday(java.lang.Boolean)
,
setMinRowHeight(int)
public java.lang.Boolean getLimitToWorkday()
showWorkday
is true, this attribute prevents
the user from scrolling vertical views beyond the specified workday start
and end
hours.getStyleWorkday()
,
getSizeToWorkday()
,
getScrollToWorkday()
,
getMinRowHeight()
public TabSet getMainView() throws java.lang.IllegalStateException
TabSet
for managing calendar views when multiple views are available (eg, day
and month
).
This component is an AutoChild named "mainView". 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 Calendar setMinimalUI(boolean minimalUI)
minimalUI
- New minimalUI value. Default value is falseCalendar
instance, for chaining setter callspublic boolean getMinimalUI()
public Calendar 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
- New minimumDayHeight value. Default value is 80Calendar
instance, for chaining setter callsAppearance 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 Calendar 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
- New minLaneWidth value. Default value is nullCalendar
instance, for chaining setter callsjava.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 Calendar setMinRowHeight(int minRowHeight)
sizeToWorkday
is true, meaning that a Calendar with a
long workday may not be able to fit all workday rows in the viewport at once, and scrolling may be necessary. To
prevent users from scrolling beyond the workday hours, see limitToWorkday
.
minRowHeight
- New minRowHeight value. Default value is 20Calendar
instance, for chaining setter callspublic int getMinRowHeight()
sizeToWorkday
is true, meaning that a Calendar with a
long workday may not be able to fit all workday rows in the viewport at once, and scrolling may be necessary. To
prevent users from scrolling beyond the workday hours, see limitToWorkday
.
public Calendar 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
- New minutesPerRow value. Default value is 30Calendar
instance, for chaining setter callsjava.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.
This component is an AutoChild named "monthButton". 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 Calendar 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
- New monthButtonTitle value. Default value is "< ${monthName}"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public 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 Calendar 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
- New monthMoreEventsLinkTitle value. Default value is "+ ${eventCount} more..."Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public 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.
This component is an AutoChild named "monthMoreEventsMenu". 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.
This component is an AutoChild named "monthView". 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 Calendar setMonthViewTitle(java.lang.String monthViewTitle) throws java.lang.IllegalStateException
month view
.monthViewTitle
- New monthViewTitle value. Default value is "Month"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getMonthViewTitle()
month view
.public Calendar setNameField(java.lang.String nameField) throws java.lang.IllegalStateException
CalendarEvent
.nameField
- New nameField value. Default value is "name"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getNameField()
CalendarEvent
.CalendarEvent
public Calendar setNewEventWindowTitle(java.lang.String newEventWindowTitle) throws java.lang.IllegalStateException
newEventWindowTitle
- New newEventWindowTitle value. Default value is "New Event"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getNewEventWindowTitle()
HTMLString
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.
This component is an AutoChild named "nextButton". 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 Calendar setNextButtonHoverText(java.lang.String nextButtonHoverText) throws java.lang.IllegalStateException
next
toolbar buttonnextButtonHoverText
- New nextButtonHoverText value. Default value is "Next"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getNextButtonHoverText()
next
toolbar buttonpublic Calendar setOtherDayBlankStyle(java.lang.String otherDayBlankStyle) throws java.lang.IllegalStateException
month view
, when showOtherDays
is false.otherDayBlankStyle
- New otherDayBlankStyle value. Default value is "calMonthOtherDayBlank"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCSSStyleName
,
Appearance overview and related methods
public java.lang.String getOtherDayBlankStyle()
month view
, when showOtherDays
is false.CSSStyleName
,
Appearance overview and related methods
public Calendar 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
- New otherDayBodyBaseStyle value. Default value is "calMonthOtherDayBody"Calendar
instance, for chaining setter callsCSSStyleName
,
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 Calendar setOtherDayClickNavigation(java.lang.Boolean otherDayClickNavigation)
showOtherDays
is true, this attribute
determines whether the month-view should change month when cells representing days in the previous or following month
are clicked.otherDayClickNavigation
- New otherDayClickNavigation value. Default value is trueCalendar
instance, for chaining setter callspublic java.lang.Boolean getOtherDayClickNavigation()
showOtherDays
is true, this attribute
determines whether the month-view should change month when cells representing days in the previous or following month
are clicked.public Calendar 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
- New otherDayHeaderBaseStyle value. Default value is "calMonthDayHeader"Calendar
instance, for chaining setter callsCSSStyleName
,
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 Calendar 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
- New overlapSortSpecifiers value. Default value is nullCalendar
instance, for chaining setter callspublic 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.
This component is an AutoChild named "previousButton". 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 Calendar setPreviousButtonHoverText(java.lang.String previousButtonHoverText) throws java.lang.IllegalStateException
previous
toolbar button.previousButtonHoverText
- New previousButtonHoverText value. Default value is "Previous"Calendar
instance, for chaining setter callsjava.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
.
This component is an AutoChild named "removeButton". 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 Calendar setRemoveButtonTitle(java.lang.String removeButtonTitle) throws java.lang.IllegalStateException
Remove button
in the event editor
.removeButtonTitle
- New removeButtonTitle value. Default value is "Remove Event"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getRemoveButtonTitle()
Remove button
in the event editor
.HTMLString
public Calendar setRenderEventsOnDemand(boolean renderEventsOnDemand) throws java.lang.IllegalStateException
event
is rendered as it
appears in the viewport. If set to false, all events are rendered up-front, whenever the current range changes.
Has no effect when showColumnLayouts
is true.
renderEventsOnDemand
- New renderEventsOnDemand value. Default value is trueCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic boolean getRenderEventsOnDemand()
event
is rendered as it
appears in the viewport. If set to false, all events are rendered up-front, whenever the current range changes.
Has no effect when showColumnLayouts
is true.
public Calendar setRowHeight(int rowHeight)
rowHeight
- New rowHeight value. Default value is 20Calendar
instance, for chaining setter callspublic int getRowHeight()
public Calendar 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
- New rowTitleFrequency value. Default value is 60Calendar
instance, for chaining setter callsjava.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
.
This component is an AutoChild named "saveButton". 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 Calendar setSaveButtonTitle(java.lang.String saveButtonTitle) throws java.lang.IllegalStateException
saveButtonTitle
- New saveButtonTitle value. Default value is "Save Event"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public java.lang.String getSaveButtonTitle()
HTMLString
public Calendar setScrollToWorkday(java.lang.Boolean scrollToWorkday)
showWorkday
is true, automatically
scrolls the day
and week
views to the start of the workday
when the calendar is first displayed and whenever
the user changes to a different day or week.scrollToWorkday
- New scrollToWorkday value. Default value is falseCalendar
instance, for chaining setter callssetStyleWorkday(java.lang.Boolean)
,
setSizeToWorkday(java.lang.Boolean)
,
setLimitToWorkday(java.lang.Boolean)
public java.lang.Boolean getScrollToWorkday()
showWorkday
is true, automatically
scrolls the day
and week
views to the start of the workday
when the calendar is first displayed and whenever
the user changes to a different day or week.getStyleWorkday()
,
getSizeToWorkday()
,
getLimitToWorkday()
public Calendar setSelectChosenDate(java.lang.Boolean selectChosenDate)
chosenDate
in a
selected style in the month view
. Has no effect in
other views.selectChosenDate
- New selectChosenDate value. Default value is trueCalendar
instance, for chaining setter callsVisibility 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 Calendar setSelectedCellStyle(java.lang.String selectedCellStyle)
selectedCellStyle
- New selectedCellStyle value. Default value is "calendarCellSelected"Calendar
instance, for chaining setter callsCSSStyleName
,
Appearance overview and related methods
public java.lang.String getSelectedCellStyle()
CSSStyleName
,
Appearance overview and related methods
public Calendar setShowAddEventButton(java.lang.Boolean showAddEventButton)
Add Event
button.showAddEventButton
- New showAddEventButton value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowAddEventButton()
Add Event
button.public Calendar 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
- New showCellHovers value. Default value is falseCalendar
instance, for chaining setter callsjava.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 Calendar setShowColumnLayouts(java.lang.Boolean showColumnLayouts) throws java.lang.IllegalStateException
layouts
to be added to each
column in vertical views. In this mode, eventCanvases are stacked in these layouts, filling width and auto-sizing
vertically to content, rather than being placed, sized and overlapped according to their times. Because times are
ignored in this mode, various behaviors are switched off automatically; for example, the time-column
is hidden and event-canvases cannot be
resized
or rendered on-demand
.
showColumnLayouts
- New showColumnLayouts value. Default value is falseCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.Boolean getShowColumnLayouts()
layouts
to be added to each
column in vertical views. In this mode, eventCanvases are stacked in these layouts, filling width and auto-sizing
vertically to content, rather than being placed, sized and overlapped according to their times. Because times are
ignored in this mode, various behaviors are switched off automatically; for example, the time-column
is hidden and event-canvases cannot be
resized
or rendered on-demand
.
Appearance overview and related methods
public Calendar 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
- New showControlsBar value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar setShowDateChooser(java.lang.Boolean showDateChooser) throws java.lang.IllegalStateException
dateChooser
is displayed.showDateChooser
- New showDateChooser value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar setShowDatePickerButton(java.lang.Boolean showDatePickerButton)
datePickerButton
that
allows selecting a new base date for this Calendar.showDatePickerButton
- New showDatePickerButton value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowDatePickerButton()
datePickerButton
that
allows selecting a new base date for this Calendar.public Calendar 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
- New showDayHeaders value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar 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 nullCalendar
instance, for chaining setter callsjava.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 Calendar setShowDayView(java.lang.Boolean showDayView) throws java.lang.IllegalStateException
showDayView
- New showDayView value. Default value is trueCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.Boolean getShowDayView()
Appearance overview and related methods
public Calendar 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
- New showDetailFields value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar 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
- New showDragHovers value. Default value is falseCalendar
instance, for chaining setter callspublic 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 Calendar setShowEventCanvasComponents(boolean showEventCanvasComponents) throws java.lang.IllegalStateException
event-canvases
should show a custom widget
as content, rather than the default header
and
body
HTML.showEventCanvasComponents
- New showEventCanvasComponents value. Default value is falseCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdcreateEventCanvasComponent(com.smartgwt.client.widgets.calendar.EventCanvas)
,
updateEventCanvasComponent(com.smartgwt.client.widgets.calendar.EventCanvas, com.smartgwt.client.widgets.Canvas)
public boolean getShowEventCanvasComponents()
event-canvases
should show a custom widget
as content, rather than the default header
and
body
HTML.createEventCanvasComponent(com.smartgwt.client.widgets.calendar.EventCanvas)
,
updateEventCanvasComponent(com.smartgwt.client.widgets.calendar.EventCanvas, com.smartgwt.client.widgets.Canvas)
public Calendar 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
- New showEventDescriptions value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar 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
- New showEventHeaders value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar 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
- New showEventHovers value. Default value is trueCalendar
instance, for chaining setter callspublic 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 Calendar 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
- New showHeaderHovers value. Default value is falseCalendar
instance, for chaining setter callsjava.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 Calendar setShowIndicators(java.lang.Boolean showIndicators)
indicators
into
timeline views
.showIndicators
- New showIndicators value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowIndicators()
indicators
into
timeline views
.public Calendar 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
- New showIndicatorsInFront value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar setShowLabelColumn(boolean showLabelColumn) throws java.lang.IllegalStateException
CalendarView
s.
Always false when showColumnLayouts
is
true.
showLabelColumn
- New showLabelColumn value. Default value is trueCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic boolean getShowLabelColumn()
CalendarView
s.
Always false when showColumnLayouts
is
true.
public Calendar 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
- New showLaneFieldHovers value. Default value is falseCalendar
instance, for chaining setter callspublic 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 Calendar setShowLaneRollOver(java.lang.Boolean showLaneRollOver)
Timelines
to highlight
the Lane under the mouse with the "Over" style.showLaneRollOver
- New showLaneRollOver value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowLaneRollOver()
Timelines
to highlight
the Lane under the mouse with the "Over" style.public Calendar setShowMonthButton(java.lang.Boolean showMonthButton)
Month
button from
displaying on Handset devices.showMonthButton
- New showMonthButton value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowMonthButton()
Month
button from
displaying on Handset devices.public Calendar setShowMonthView(java.lang.Boolean showMonthView) throws java.lang.IllegalStateException
showMonthView
- New showMonthView value. Default value is trueCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.Boolean getShowMonthView()
Appearance overview and related methods
public Calendar setShowNextButton(java.lang.Boolean showNextButton)
Next
button.showNextButton
- New showNextButton value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowNextButton()
Next
button.public Calendar 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
- New showOtherDays value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar setShowPreviousButton(java.lang.Boolean showPreviousButton)
Previous
button.showPreviousButton
- New showPreviousButton value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowPreviousButton()
Previous
button.public Calendar setShowQuickEventDialog(java.lang.Boolean showQuickEventDialog) throws java.lang.IllegalStateException
showQuickEventDialog
- New showQuickEventDialog value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar setShowTimelineView(java.lang.Boolean showTimelineView)
Timeline view
.showTimelineView
- New showTimelineView value. Default value is falseCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowTimelineView()
Timeline view
.public Calendar 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 trueCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowViewHovers()
See showEventHovers
, showZoneHovers
, showHeaderHovers
, showCellHovers
, showLaneFieldHovers
, showDragHovers
for further configuration options.
public Calendar 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 trueCalendar
instance, for chaining setter callsVisibility 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 Calendar setShowWeekView(java.lang.Boolean showWeekView) throws java.lang.IllegalStateException
showWeekView
- New showWeekView value. Default value is trueCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.Boolean getShowWeekView()
Appearance overview and related methods
public Calendar setShowWorkday(java.lang.Boolean showWorkday)
workdayStart
and workdayEnd
) in vertical calendar views (day
and week
). Workday cells can be styled separately
and sized automatically
, and users can be prevented from
scrolling the calendar beyond the workday
hours
. The hours of the workday can be customized for particular dates by providing implementations of getWorkdayStart()
and getWorkdayEnd()
.
showWorkday
- New showWorkday value. Default value is falseCalendar
instance, for chaining setter callssetStyleWorkday(java.lang.Boolean)
,
setScrollToWorkday(java.lang.Boolean)
,
setSizeToWorkday(java.lang.Boolean)
,
setLimitToWorkday(java.lang.Boolean)
public java.lang.Boolean getShowWorkday()
workdayStart
and workdayEnd
) in vertical calendar views (day
and week
). Workday cells can be styled separately
and sized automatically
, and users can be prevented from
scrolling the calendar beyond the workday
hours
. The hours of the workday can be customized for particular dates by providing implementations of getWorkdayStart()
and getWorkdayEnd()
.
getStyleWorkday()
,
getScrollToWorkday()
,
getSizeToWorkday()
,
getLimitToWorkday()
public Calendar 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
- New showZoneHovers value. Default value is trueCalendar
instance, for chaining setter callspublic 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 Calendar setShowZones(java.lang.Boolean showZones)
zones
into timeline views
.showZones
- New showZones value. Default value is nullCalendar
instance, for chaining setter callspublic java.lang.Boolean getShowZones()
zones
into timeline views
.public Calendar setSizeEventsToGrid(java.lang.Boolean sizeEventsToGrid) throws java.lang.IllegalStateException
sizeEventsToGrid
- New sizeEventsToGrid value. Default value is trueCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getSizeEventsToGrid()
public Calendar setSizeToWorkday(java.lang.Boolean sizeToWorkday)
showWorkday
is true, attempt to resize rows in
the day and week views so that the workday hours
fill the visible viewport-height, and the whole workday is visible without scrolling. If the Calendar is resized, the
row-size is recalculated to keep the workday hours visible. Note that row-heights will not shrink below the minRowHeight
, so the entire workday may not be visible
without scrolling if the workday is long or the viewport-height is insufficient.
sizeToWorkday
- New sizeToWorkday value. Default value is falseCalendar
instance, for chaining setter callssetStyleWorkday(java.lang.Boolean)
,
setScrollToWorkday(java.lang.Boolean)
,
setLimitToWorkday(java.lang.Boolean)
,
setMinRowHeight(int)
public java.lang.Boolean getSizeToWorkday()
showWorkday
is true, attempt to resize rows in
the day and week views so that the workday hours
fill the visible viewport-height, and the whole workday is visible without scrolling. If the Calendar is resized, the
row-size is recalculated to keep the workday hours visible. Note that row-heights will not shrink below the minRowHeight
, so the entire workday may not be visible
without scrolling if the workday is long or the viewport-height is insufficient.
getStyleWorkday()
,
getScrollToWorkday()
,
getLimitToWorkday()
,
getMinRowHeight()
public Calendar 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 the
value you provide may be automatically altered if showing header-levels
, to fit to header boundaries.
startDate
- New startDate value. Default value is nullCalendar
instance, for chaining setter callsjava.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 the
value you provide may be automatically altered if showing header-levels
, to fit to header boundaries.
public Calendar setStartDateField(java.lang.String startDateField) throws java.lang.IllegalStateException
CalendarEvent
.startDateField
- New startDateField value. Default value is "startDate"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCalendarEvent
public java.lang.String getStartDateField()
CalendarEvent
.CalendarEvent
public Calendar setStyleWorkday(java.lang.Boolean styleWorkday)
showWorkday
is true, applies the workdayBaseStyle
to cells that fall within the
workday (as defined by workdayStart
and workdayEnd
), in both the dayView
and weekView
. The hours of the workday can be customized for
particular dates by providing implementations of getWorkdayStart()
and getWorkdayEnd()
.
styleWorkday
- New styleWorkday value. Default value is trueCalendar
instance, for chaining setter callssetScrollToWorkday(java.lang.Boolean)
,
setSizeToWorkday(java.lang.Boolean)
,
setLimitToWorkday(java.lang.Boolean)
public java.lang.Boolean getStyleWorkday()
showWorkday
is true, applies the workdayBaseStyle
to cells that fall within the
workday (as defined by workdayStart
and workdayEnd
), in both the dayView
and weekView
. The hours of the workday can be customized for
particular dates by providing implementations of getWorkdayStart()
and getWorkdayEnd()
.
getScrollToWorkday()
,
getSizeToWorkday()
,
getLimitToWorkday()
public Calendar 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
- New sublaneNameField value. Default value is "sublane"Calendar
instance, for chaining setter callsjava.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 Calendar setTimelineGranularity(TimeUnit timelineGranularity) throws java.lang.IllegalStateException
timelineView
will
display events. Possible values are those available in the built-in TimeUnit
type.timelineGranularity
- New timelineGranularity value. Default value is "day"Calendar
instance, for chaining setter callsjava.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 Calendar setTimelineUnitsPerColumn(int timelineUnitsPerColumn) throws java.lang.IllegalStateException
timelineGranularity
each
cell represents.timelineUnitsPerColumn
- New timelineUnitsPerColumn value. Default value is 1Calendar
instance, for chaining setter callsjava.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.
This component is an AutoChild named "timelineView". 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 Calendar setTimelineViewTitle(java.lang.String timelineViewTitle) throws java.lang.IllegalStateException
timeline view
.timelineViewTitle
- New timelineViewTitle value. Default value is "Timeline"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getTimelineViewTitle()
timeline view
.public Calendar setTodayBackgroundColor(java.lang.String todayBackgroundColor) throws java.lang.IllegalStateException
CalendarView
s.todayBackgroundColor
- New todayBackgroundColor value. Default value is nullCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getTodayBackgroundColor()
CalendarView
s.public Calendar 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
- New trailingDateField value. Default value is "trailingDate"Calendar
instance, for chaining setter callsjava.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 Calendar setTwentyFourHourTime(java.lang.Boolean twentyFourHourTime) throws java.lang.IllegalStateException
local formatter
is
installed, causes the Calendar to choose an appropriate builtin formatter.twentyFourHourTime
- New twentyFourHourTime value. Default value is nullCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getTwentyFourHourTime()
local formatter
is
installed, causes the Calendar to choose an appropriate builtin formatter.public Calendar 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
- New useEventCanvasRolloverControls value. Default value is trueCalendar
instance, for chaining setter callsjava.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 Calendar setUseSublanes(java.lang.Boolean useSublanes) throws java.lang.IllegalStateException
useSublanes
- New useSublanes value. Default value is nullCalendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getUseSublanes()
public Calendar setWeekendDays(int... weekendDays)
globally
.weekendDays
- New weekendDays value. Default value is nullCalendar
instance, for chaining setter callsVisibility overview and related methods
public int[] getWeekendDays()
globally
.Visibility overview and related methods
public Calendar setWeekEventBorderOverlap(java.lang.Boolean weekEventBorderOverlap) throws java.lang.IllegalStateException
weekEventBorderOverlap
- New weekEventBorderOverlap value. Default value is falseCalendar
instance, for chaining setter callsjava.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 Calendar setWeekPrefix(java.lang.String weekPrefix) throws java.lang.IllegalStateException
week-based
HeaderLevel
s when this calendar is showing a timeline.weekPrefix
- New weekPrefix value. Default value is "Week"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdHTMLString
public 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.
This component is an AutoChild named "weekView". 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 Calendar setWeekViewTitle(java.lang.String weekViewTitle) throws java.lang.IllegalStateException
week view
.weekViewTitle
- New weekViewTitle value. Default value is "Week"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getWeekViewTitle()
week view
.public Calendar 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
- New workdayBaseStyle value. Default value is "calendarWorkday"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdCSSStyleName
,
Appearance 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 Calendar 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 getWorkdayStart()
and getWorkdayEnd()
.
workdayEnd
- New workdayEnd value. Default value is "5:00pm"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic Calendar 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 getWorkdayStart()
and getWorkdayEnd()
.
workdayStart
- New workdayStart value. Default value is "9:00am"Calendar
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic ZoneCanvas getZoneCanvas()
Using AutoChildren
for details.
AutoChild component created for each zone
entry.
public Calendar 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 nullCalendar
instance, for chaining setter callspublic 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 Calendar setZoneStyleName(java.lang.String zoneStyleName)
zoneStyleName
- New zoneStyleName value. Default value is "zoneCanvas"Calendar
instance, for chaining setter callsCSSStyleName
public java.lang.String getZoneStyleName()
CSSStyleName
public Calendar setZoneTitleOrientation(VerticalAlignment zoneTitleOrientation) throws java.lang.IllegalStateException
zone
.zoneTitleOrientation
- New zoneTitleOrientation value. Default value is "bottom"Calendar
instance, for chaining setter callsjava.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.
To deal with errors during
saving, see Calendar.eventSaveError()
.
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.
To deal with errors during
saving, see Calendar.eventSaveError()
.
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 void cancelEditing()
dialog
or editor
and clearing any visible edit-selection from the
current CalendarView
.public Canvas createEventCanvasComponent(EventCanvas canvas)
EventCanvas.setEvent()
when showEventCanvasComponents
is true and an
eventCanvas needs a component. The method is expected to create and return a single component to apply as a
space-filling member of the passed EventCanvas
in the view
in which it appears. By default, this method
returns a DetailViewer
showing values from the associated event, according
to the fields in the Calendar's dataSource
, or the
default event-fields if no dataSource is present.
However, the component can be any canvas-based
widget, including a Layout containing an arrangement of other widgets.
When applied as a member of an eventCanvas, the component fills its container and limits its own content to that size,
showing scrollbars as appropriate.
See updateEventCanvasComponent()
for details on
updating components that have already been created and applied.
canvas
- the eventCanvas to get the component forupdateEventCanvasComponent(com.smartgwt.client.widgets.calendar.EventCanvas, com.smartgwt.client.widgets.Canvas)
,
getEventScreen()
public 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.
Note that,
when Calendar.otherDayClickNavigation
is true, the calendar will first navigate the Month view to the selected month, before showing the Event Editor dialog
at the proper location.
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 java.lang.Boolean deselectEvent(CalendarEvent event)
event
- the event to deselectpublic java.lang.Boolean deselectEvents(CalendarEvent... events)
events
- the events to deselectpublic 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 that can be edited. 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 boolean eventMoved(java.util.Date newDate, CalendarEvent event, java.lang.String newLane)
Calendar.eventRepositionStop()
newDate
- new start date and time that the event is being moved toevent
- the event as it will be after this movementnewLane
- the name of the lane into which the event was movedpublic 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 boolean eventResized(java.util.Date newDate, CalendarEvent event)
Calendar.eventResizeStop()
newDate
- new end date and time that event is being resized toevent
- the event as it will be after this resizepublic 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 com.google.gwt.event.shared.HandlerRegistration addEventSaveErrorHandler(EventSaveErrorHandler handler)
Notification method fired when an attempt to save an event
following edits or drag-movements results in an error from the server. May be overridden to handle specific errors and
provide feedback to the user or push a server-provided record to client caches with a call to updateCaches()
, for example.
The scenarioCode
parameter may be used to determine how the save was initiated
.
Return false from this method to cancel builtin behavior, which is as follows:
If a save happened because
an event-canvas was moved or sized with the mouse, and any kind of error occurs, the event is restored to it's
pre-save position - if this method specifically returns true, the errors are also sent to central error handling
, which will show them to the user in a simple error
dialog.
If a save happened because an event was edited in the Calendar.eventDialog
or Calendar.eventEditor
windows and a validation error
occurs, the window is re-opened for editing with the validation errors visible. If any other kind of error occurs, the
window will not be re-opened and, if this method specifically returns true, the error will be sent to central error handling
which will show a simple error dialog to the end user.
In all cases, if the server returned an updated record despite the save failing (eg, perhaps the server enforces
optimistic locking and the underlying record has been changed by another user), it is assumed to be a latest-version of
the record and is applied instead of the original record during those builtin UI processes. So, the Calendar.eventEditor
and Calendar.eventDialog
will show any changes from the
latest-record. If the save was caused by dragging an event and the event's start
or end
dates are different in the latest-record, the
EventCanvas will be positioned using the latest values, instead of returning to it's pre-save position on-screen.
addEventSaveErrorHandler
in interface HasEventSaveErrorHandlers
handler
- the eventSaveError handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addEventsRenderedHandler(EventsRenderedHandler handler)
A notification method fired when the events in the current view have been refreshed.
addEventsRenderedHandler
in interface HasEventsRenderedHandlers
handler
- the eventsRendered handlerHandlerRegistration
used to remove this handlerpublic 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 valuesHTMLString
public 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 CalendarViewHTMLString
getDateHTML(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 CalendarViewHTMLString
getDateHTML(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 CalendarViewHTMLString
getDateCellAlign(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 CalendarViewCSSStyleName
getDateHTML(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 valuesHTMLString
public java.lang.String getEventBodyHTML(CalendarEvent event)
description
field
.event
- the event to get the description text forHTMLString
public 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 renderedHTMLString
public 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 forCSSStyleName
public 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 styledCSSStyleName
public 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)
Month view
. The default implementation returns the
event's name field
for timelines, and that same value
pre-pended with the event's start
for day, week
and month views.
event
- the event to get the description text forHTMLString
public java.lang.String getEventHeaderHTML(CalendarEvent event, CalendarView view)
Month view
. The default implementation returns the
event's name field
for timelines, and that same value
pre-pended with the event's start
for day, week
and month views.
event
- the event to get the description text forview
- the view in which the event is being renderedHTMLString
public java.lang.String getEventHoverHTML(CalendarEvent event, EventCanvas eventCanvas, CalendarView view)
event
- The event being hoveredeventCanvas
- the event canvas being hovered overview
- the CalendarView in which the eventCanvas livesHTMLString
public java.lang.String getEventHoverHTML(CalendarEvent event, EventCanvas eventCanvas, CalendarView view, java.lang.String defaultValue)
event
- The event being hoveredeventCanvas
- the event canvas being hovered overview
- the CalendarView in which the eventCanvas livesdefaultValue
- the default HTML to show when hovering over the passed eventHTMLString
public 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 rangeHTMLString
public 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 forCSSStyleName
public 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 styledCSSStyleName
public 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 IndicatorHTMLString
public 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.HTMLString
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 CalendarEvent getSelectedEvent()
event
, or the first one if
more than one is selected.public CalendarEvent[] getSelectedEvents()
events
.public 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 forCSSStyleName
public 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 styledCSSStyleName
public 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 ZoneHTMLString
public 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 com.google.gwt.event.shared.HandlerRegistration addIndicatorClickHandler(IndicatorClickHandler handler)
Called whenever an IndicatorCanvas
is clicked in the timelineView
. There is no default implementation.
addIndicatorClickHandler
in interface HasIndicatorClickHandlers
handler
- the indicatorClick handlerHandlerRegistration
used to remove this handlerpublic void moveToEvent(CalendarEvent event)
scrollToEvent()
.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 scrollToEnd()
public void scrollToEnd(CalendarView view)
view
- the view to affect, the current view if not specifiedpublic void scrollToEvent(CalendarEvent event)
current view
so the passed event is
visible. If the event is outside of the view's current date-range, the default behavior is to automatically reload the
view with a date-range starting at the event's startDate
and then scroll to the event vertically as necessary. Pass false as the canReload
param to
prevent that default behavior.event
- the event to move the calendar view topublic void scrollToEvent(CalendarEvent event, boolean canReload)
current view
so the passed event is
visible. If the event is outside of the view's current date-range, the default behavior is to automatically reload the
view with a date-range starting at the event's startDate
and then scroll to the event vertically as necessary. Pass false as the canReload
param to
prevent that default behavior.event
- the event to move the calendar view tocanReload
- set to false to prevent a view from automatically reloading with a new range if the passed
event is not in its current scrollable rangepublic void scrollToStart()
public void scrollToStart(CalendarView view)
view
- the view to affect, the current view if not specifiedpublic void scrollToTime(java.lang.String time)
day
or week
views to the time represented by the time parameter.
This string parameter is expected to be an arbitrary logical time value in any parsable time format - no date portion
is expected, but time formats like "13:31" or "1:20am" are supported. Has no effect in timelines
, where an arbitrary time-value is inapplicable
to any range or resolution greater than a day.
time
- any parsable time-stringpublic java.lang.Boolean selectEvent(CalendarEvent event)
event
- the event to add to the selectionpublic java.lang.Boolean selectEvents(CalendarEvent... events)
events
- the events to add to the selectionpublic java.lang.Boolean selectSingleEvent(CalendarEvent event)
event
- the event to selectpublic 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 boolean setLaneTitle(java.lang.String lane, java.lang.String title)
lanes
, updates the title for the
passed lane.lane
- the name of the lane to change the title fortitle
- the new title to applypublic 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 boolean showEventCanvasComponent(EventCanvas canvas)
canvas
in the
view
in which it appears? Return false from
this method to override the global value of showEventCanvasComponents
for this canvas.canvas
- should this eventCanvas get a component component?createEventCanvasComponent(com.smartgwt.client.widgets.calendar.EventCanvas)
,
updateEventCanvasComponent(com.smartgwt.client.widgets.calendar.EventCanvas, com.smartgwt.client.widgets.Canvas)
public 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 java.lang.Boolean timelineEventMoved(CalendarEvent event, java.util.Date startDate, java.util.Date endDate, Lane lane)
Calendar.eventRepositionStop()
event
- the event that was movedstartDate
- new start date of the passed eventendDate
- new end date of the passed eventlane
- the Lane in which this event has been droppedpublic java.lang.Boolean timelineEventResized(CalendarEvent event, java.util.Date startDate, java.util.Date endDate)
Calendar.eventResizeStop()
event
- the event that was resizedstartDate
- new start date of the passed event, after the resizeendDate
- new end date of the passed event, after the resizepublic void updateCalendarEvent(CalendarEvent event, CalendarEvent newEvent, java.util.Map otherFields)
data array')
. To deal with errors while saving, see Calendar.eventSaveError()
event
- The event object that will be updatednewEvent
- The new attributes for the eventotherFields
- new values of additional fields to be updatedpublic void updateEventCanvasComponent(EventCanvas canvas, Canvas component)
EventCanvas.setEvent()
when showEventCanvasComponents
is true and the
eventCanvas already has a component
.
This method is expected to update the passed component
as necessary, based on the current event
. By default, if the passed
component
has methods called setEvent
or setData
, those methods are called
automatically.
canvas
- the eventCanvas to update the component forcomponent
- the component to be updated the canvas in questioncreateEventCanvasComponent(com.smartgwt.client.widgets.calendar.EventCanvas)
public com.google.gwt.event.shared.HandlerRegistration addZoneClickHandler(ZoneClickHandler handler)
Called whenever a ZoneCanvas
is clicked in the timelineView
. There is no default implementation.
addZoneClickHandler
in interface HasZoneClickHandlers
handler
- the zoneClick handlerHandlerRegistration
used to remove this handlerpublic 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 java.lang.String getWorkdayStart(java.util.Date date, java.lang.String laneName)
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
getWorkdayStart()
and getWorkdayEnd()
.
Note: This is an override point
date
- the date to get the workday start forlaneName
- the name of the lane if
showDayLanes
is
true, or null otherwiseworkdayStart
.
Default value is "9:00am"public java.lang.String getWorkdayStart(java.util.Date date)
public java.lang.String getWorkdayEnd(java.util.Date date, java.lang.String laneName)
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
getWorkdayStart()
and getWorkdayEnd()
.
Note: This is an override point
date
- the date to get the workday end forlaneName
- the name of the lane if
showDayLanes
is
true, or null otherwiseworkdayEnd
.
Default value is "5:00pm"public java.lang.String getWorkdayEnd(java.util.Date date)
public boolean dateIsWorkday(java.util.Date date, java.lang.String laneName)
workdays
, and returns
true if found. Override this method to provide custom logic for determining workday, for
example returning false on holidays. Note that, when showing
vertical lanes
in
the day view
, this
method is also passed the name of the associated lane.
Note: This is an override point
date
- date to check for being a workdaylaneName
- the name of the lane if
showDayLanes
is
true, or null otherwisepublic boolean dateIsWorkday(java.util.Date date)
protected 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 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 setEventCanvasComponentCustomizer(EventCanvasComponentCustomizer 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 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 java.lang.String[] getLaneGroupByFieldAsString()
getLaneGroupByFieldAsStringArray()
.public void setEventCanvasMenuCustomizer(EventCanvasMenuCustomizer customizer)
customizer
- the customizer to execute.public Calendar 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 0DataBoundComponent
instance, for chaining setter callsDatabinding 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 Calendar 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 falseDataBoundComponent
instance, for chaining setter callspublic 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 Calendar setSparseFieldState(java.lang.Boolean sparseFieldState)
DataBoundComponent
ListGrid.getFieldState()
and
ListGrid.setFieldState(java.lang.String)
will omit state
information for hidden fields by default.setSparseFieldState
in interface DataBoundComponent
sparseFieldState
- sparseFieldState Default value is falseDataBoundComponent
instance, for chaining setter callspublic java.lang.Boolean getSparseFieldState()
DataBoundComponent
ListGrid.getFieldState()
and
ListGrid.setFieldState(java.lang.String)
will omit state
information for hidden fields by default.getSparseFieldState
in interface DataBoundComponent
public Calendar 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 falseDataBoundComponent
instance, for chaining setter callspublic 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 Calendar 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 trueDataBoundComponent
instance, for chaining setter callspublic 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 Calendar setFetchOperation(java.lang.String fetchOperation)
DataBoundComponent
setFetchOperation
in interface DataBoundComponent
fetchOperation
- fetchOperation Default value is nullDataBoundComponent
instance, for chaining setter callspublic java.lang.String getFetchOperation()
DataBoundComponent
getFetchOperation
in interface DataBoundComponent
public Calendar setUpdateOperation(java.lang.String updateOperation)
DataBoundComponent
operationId
this component
should use when performing update operations.setUpdateOperation
in interface DataBoundComponent
updateOperation
- Default value is nullDataBoundComponent
instance, for chaining setter callsOperations 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 Calendar setAddOperation(java.lang.String addOperation)
DataBoundComponent
operationId
this component
should use when performing add operations.setAddOperation
in interface DataBoundComponent
addOperation
- Default value is nullDataBoundComponent
instance, for chaining setter callsOperations 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 Calendar setRemoveOperation(java.lang.String removeOperation)
DataBoundComponent
operationId
this component
should use when performing remove operations.setRemoveOperation
in interface DataBoundComponent
removeOperation
- Default value is nullDataBoundComponent
instance, for chaining setter callsOperations 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 Calendar 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 nullDataBoundComponent
instance, for chaining setter callspublic 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 Calendar 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 falseDataBoundComponent
instance, for chaining setter callspublic 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 Calendar setExportIncludeSummaries(java.lang.Boolean exportIncludeSummaries)
DataBoundComponent
setExportIncludeSummaries
in interface DataBoundComponent
exportIncludeSummaries
- exportIncludeSummaries Default value is trueDataBoundComponent
instance, for chaining setter callspublic java.lang.Boolean getExportIncludeSummaries()
DataBoundComponent
getExportIncludeSummaries
in interface DataBoundComponent
public Calendar 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 nullDataBoundComponent
instance, for chaining setter callsjava.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 Calendar 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"DataBoundComponent
instance, for chaining setter callsjava.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 Calendar 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 trueDataBoundComponent
instance, for chaining setter callspublic 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 Calendar 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 nullDataBoundComponent
instance, for chaining setter callspublic 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 Calendar setProgressiveLoading(java.lang.Boolean progressiveLoading)
progressively
progressiveLoading
- DataBoundComponent
instance, for chaining setter callsProgressiveLoading
,
DataSource.setProgressiveLoading(java.lang.Boolean)
public java.lang.Boolean getProgressiveLoading()
progressively
ProgressiveLoading
,
DataSource.getProgressiveLoading()
public Calendar 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 nullDataBoundComponent
instance, for chaining setter callsjava.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 Calendar setHiliteProperty(java.lang.String hiliteProperty)
DataBoundComponent
id
for a hilite defined on this component.setHiliteProperty
in interface DataBoundComponent
hiliteProperty
- hiliteProperty Default value is "_hilite"DataBoundComponent
instance, for chaining setter callspublic java.lang.String getHiliteProperty()
DataBoundComponent
id
for a hilite defined on this component.getHiliteProperty
in interface DataBoundComponent
public void editFields()
public void editHilites()
DataBoundComponent
editHilites
in interface DataBoundComponent
public java.lang.String getHiliteState()
DataBoundComponent
getHiliteState
in interface DataBoundComponent
public Calendar setHiliteState(java.lang.String hiliteState)
DataBoundComponent
setHiliteState
in interface DataBoundComponent
hiliteState
- hilites state encoded as a StringDataBoundComponent
instance, for chaining setter callspublic Calendar setHilites(Hilite[] hilites)
DataBoundComponent
getHilites
for a method of retrieving the hilite array for storage,
including hilites manually added by the user.
NOTE: This is only supported on
ListGrid
for now.
setHilites
in interface DataBoundComponent
hilites
- array of hilite objectsDataBoundComponent
instance, for chaining setter callspublic Hilite[] getHilites()
DataBoundComponent
getHilites
in interface DataBoundComponent
public Calendar setDragDataAction(DragDataAction dragDataAction)
DataBoundComponent
setDragDataAction
in interface DataBoundComponent
dragDataAction
- dragDataAction Default value is Canvas.MOVEDataBoundComponent
instance, for chaining setter callspublic DragDataAction getDragDataAction()
DataBoundComponent
getDragDataAction
in interface DataBoundComponent
public Calendar setDragTrackerStyle(java.lang.String dragTrackerStyle)
DataBoundComponent
setDragTrackerStyle
in interface DataBoundComponent
dragTrackerStyle
- dragTrackerStyle Default value is "gridDragTracker"DataBoundComponent
instance, for chaining setter callspublic java.lang.String getDragTrackerStyle()
DataBoundComponent
getDragTrackerStyle
in interface DataBoundComponent
public Calendar 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 falseDataBoundComponent
instance, for chaining setter callspublic 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 Calendar setAddFormulaFieldText(java.lang.String addFormulaFieldText)
DataBoundComponent
setAddFormulaFieldText
in interface DataBoundComponent
addFormulaFieldText
- addFormulaFieldText Default value is "Add formula column..."DataBoundComponent
instance, for chaining setter callspublic java.lang.String getAddFormulaFieldText()
DataBoundComponent
getAddFormulaFieldText
in interface DataBoundComponent
public Calendar setEditFormulaFieldText(java.lang.String editFormulaFieldText)
DataBoundComponent
setEditFormulaFieldText
in interface DataBoundComponent
editFormulaFieldText
- editFormulaFieldText Default value is "Edit formula..."DataBoundComponent
instance, for chaining setter callspublic java.lang.String getEditFormulaFieldText()
DataBoundComponent
getEditFormulaFieldText
in interface DataBoundComponent
public Calendar 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 falseDataBoundComponent
instance, for chaining setter callspublic 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 Calendar setAddSummaryFieldText(java.lang.String addSummaryFieldText)
DataBoundComponent
setAddSummaryFieldText
in interface DataBoundComponent
addSummaryFieldText
- addSummaryFieldText Default value is "Add summary column..."DataBoundComponent
instance, for chaining setter callspublic java.lang.String getAddSummaryFieldText()
DataBoundComponent
getAddSummaryFieldText
in interface DataBoundComponent
public Calendar setEditSummaryFieldText(java.lang.String editSummaryFieldText)
DataBoundComponent
setEditSummaryFieldText
in interface DataBoundComponent
editSummaryFieldText
- editSummaryFieldText Default value is "Edit summary format..."DataBoundComponent
instance, for chaining setter callspublic java.lang.String getEditSummaryFieldText()
DataBoundComponent
getEditSummaryFieldText
in interface DataBoundComponent
public Calendar setSavedSearchId(java.lang.String savedSearchId)
DataBoundComponent
By default
SavedSearches
are associated with a component via its
local ID
and
DataSource ID
. This
property allows developers to override this behavior and explicitly associate a
component with a set of saved searches. This can provide a couple of benefits:
Firstly this ensures that saved searches will be unambiguously associated with the
particular component even if the page changes such that a stored minimal locator would
no longer applied to the component, without requiring an explicit
Canvas.ID
.
Secondly this allows the same set of saved searches to be applied to more than one
component on a page. This may be valueable for cases where the same information from the
same dataSource is presented to users in multiple places.
Note: This is an advanced setting.
setSavedSearchId
in interface DataBoundComponent
savedSearchId
- New savedSearchId value. Default value is nullDataBoundComponent
instance, for chaining setter callspublic java.lang.String getSavedSearchId()
DataBoundComponent
By default
SavedSearches
are associated with a component via its
local ID
and
DataSource ID
. This
property allows developers to override this behavior and explicitly associate a
component with a set of saved searches. This can provide a couple of benefits:
Firstly this ensures that saved searches will be unambiguously associated with the
particular component even if the page changes such that a stored minimal locator would
no longer applied to the component, without requiring an explicit
Canvas.ID
.
Secondly this allows the same set of saved searches to be applied to more than one
component on a page. This may be valueable for cases where the same information from the
same dataSource is presented to users in multiple places.
getSavedSearchId
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 Calendar setTitleField(java.lang.String titleField)
DataBoundComponent
setTitleField
in interface DataBoundComponent
DataBoundComponent
instance, for chaining setter callspublic 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 Calendar 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
- autoFetchDataDataBoundComponent
instance, for chaining setter callsjava.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 Calendar 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
DataBoundComponent
instance, for chaining setter callsjava.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 Calendar 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
- autoFetchAsFilterDataBoundComponent
instance, for chaining setter callsjava.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 Calendar setInitialCriteria(Criteria initialCriteria) throws java.lang.IllegalStateException
DataBoundComponent
DataBoundComponent.setAutoFetchData(Boolean)
is used.setInitialCriteria
in interface DataBoundComponent
initialCriteria
- the initial criteriaDataBoundComponent
instance, for chaining setter callsjava.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 Calendar setImplicitCriteria(Criteria implicitCriteria)
DataBoundComponent
DataBoundComponent.initialCriteria
,
DataBoundComponent.setCriteria()
etc.setImplicitCriteria
in interface DataBoundComponent
implicitCriteria
- New implicitCriteria value. Default value is nullDataBoundComponent
instance, for chaining setter callspublic java.lang.Boolean setImplicitCriteria(Criteria implicitCriteria, DSCallback callback)
public java.lang.Boolean setImplicitCriteria(Criteria criteria, DSCallback callback, java.lang.Boolean initialFetch)
public Criteria getImplicitCriteria()
DataBoundComponent
DataBoundComponent.initialCriteria
,
DataBoundComponent.setCriteria()
etc.getImplicitCriteria
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
exportData
in interface DataBoundComponent
public void exportData(DSRequest requestProperties)
DataBoundComponent
exportData
in interface DataBoundComponent
public void exportData(DSRequest requestProperties, RPCCallback callback)
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 DSRequest that will be issuedcallback
- Optional callback. Note that this parameter only applies if you specify
exportToClient
: false in
the request properties, because file downloads don't provide ordinary framework callbacksDataBoundComponentMethods
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 Calendar 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
DataBoundComponent
instance, for chaining setter callspublic Calendar 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 fieldsDataBoundComponent
instance, for chaining setter callspublic 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 void transferRecords(Record[] records, Record targetRecord, java.lang.Integer index, Canvas sourceWidget, TransferRecordsCallback callback)
DataBoundComponent
Record
s from another component
(does not have to be a databound component) into this component. This method is only
applicable to list-type components, such as ListGrid
or com.smartgwt.client.widgets.tile.TileGridTileGrid
. Notably, it does not apply to
TreeGrid
; the equivalent for treeGrids is
transferNodes
.
This method implements the automatic drag-copy and drag-move behaviors of components like
ListGrid
, and calling it is equivalent to completing a drag and drop of the
dropRecords
(the default record drop behavior is simply to call
transferRecords()
, passing in the dropped nodes)
Note that this method is asynchronous - it may need to perform server turnarounds to prevent
duplicates in the target component's data. If you wish to be notified when the transfer
process has completed, you can either pass a non-null callback to this method or add a
DropCompleteHandler
to this component.
See also transferSelectedData()
transferRecords
in interface DataBoundComponent
records
- Recordss to transfer to this componenttargetRecord
- The target record (eg, of a drop interaction), for contextindex
- Insert point relative to the target record for the transferred recordssourceWidget
- The databound or non-databound component from which the records
are to be transferred.callback
- optional TransferRecordsCallback to be fired when the transfer process has
completed (pass null if your code does not need to be called back).
The callback will be passed the list of records actually transferred
to this componentpublic Calendar setDragDataCustomizer(DragDataCustomizer customizer)
This method is consulted by
willAcceptDrop()
.
DragDataCustomizer
- customizerDataBoundComponent
instance, for chaining setter callspublic SortSpecifier[] getSort()
DataBoundComponent
SortSpecifiers
for
this component. Will return null if this component has never been sorted, or the
underlying SmartClient widget does not exist.getSort
in interface DataBoundComponent
public Calendar setSort(SortSpecifier... sortSpecifiers)
DataBoundComponent
Pass in an array of SortSpecifier
s to have the
component's data sorted by the fields in each
specifier.property
and
in the directions specified. The component can be sorted by any combination of fields,
including fields specified in the fields array and
unused fields from the underlying
dataSource
, if there is one.
If setSort() is called on a component which doesn't yet have a SmartClient widget, the
widget will be created. If autoFetchData
is set and a
DataSource
has been set, this will result in data being fetched.
setSort
in interface DataBoundComponent
sortSpecifiers
- Array of SortSpecifier
objectspublic 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