Selection Modes
By default, the Calendar is in single
selection mode.
To enable its multiple selection mode, set the selection
input property to multiple
.
The multiple selection mode includes the following key operations:
- Multiple selection—The
Ctrl
key handles the selection of dates. - Range selection—The
Shift
key handles the selection of date ranges. - Week selection—A click on the week number cell handles the range selection for a specific week.
The Ctrl
key allows the user to perform the following multiple selection actions:
- Pressing
Ctrl
+ mouse click (orEnter
) on a date will mark the date as selected and other previously selected dates will remain selected as well. - Selecting a date without using the
Ctrl
key will deselect all previously selected dates (including previously selected dates from other views or months) and will select the date of the clicked cell. - Selecting a date that is already selected while holding the
Ctrl
key will remove the date from the selection.
The Shift
key allows the user to select a range of dates in the same month or between different months in the following ways:
Shift
+ mouse click (orEnter
) will select all dates between the last one selected and the clicked cell.Shift
+ mouse click (orEnter
) when no previous selection was made will select the date of the clicked cell.
When the user clicks a specific week number, the Calendar will select the entire week. This scenario is regarded as a special case of range selection—starting from the first day of the week, the action will select all dates to the end of the week.