Final - Select range

[quentin41500]

As from @papageorgiouk PR, here is a final version of the select range feature.

• Select range using SELECTION_MODE_RANGE
• Select items in between range dates, including first and last date
• Added api endpoint for selecting range (Select range possible even in SELECTION_MODE_NONE)
• Added mode in sample app
• Documented methods

@papageorgiouk feel free to review my final version. Credit as well to @damian-aragunde-udc for helping with this.

@ekchang @chahinem @Jogan

Fix #245

This adds select range functionality. When two dates are selected, the callback returns a sorted (ascending) list of dates in that range.

After that, if another date is selected, it clears the previous selection on the widget and waits for a second one for a new range select.

I tried to keep the documentation style as close to the original as possible. Please forgive any mistakes.

Usage

Set the new selection mode:
mcv.setSelectionMode(MaterialCalendarView.SELECTION_MODE_RANGE);

And the listener:
mcv.setOnRangeSelectedListener(new OnRangeSelectedListener() { @Override public void onRangeSelected(@NonNull MaterialCalendarView widget, @NonNull List<CalendarDay> dates) { // do stuff } });

The List<CalendarDay> dates is the desired range. It also works with a backwards selection, but the list will always be returned sorted in ascending order.

[papageorgiouk]

Awesome! Happy to have contributed to such a useful project.

Cheers and keep up the good work. If there's anything else I can do, I'd be more than happy to oblige.

[ekchang]

SELECTION_MODE_MULTIPLE shouldn't be removed, this is breaking selection mode multiple

[quentin41500]

@ekchang All good now

[ekchang]

LGTM 👍