Struct cursive_calendar_view::CalendarView

pub struct CalendarView<T: TimeZone, L: Locale> { /* fields omitted */ }

View for selecting a date, supporting different modes for day, month or year based selection.

View modes can be navigated via Backspace and Enter.

Custom localization is possible by providing an implementation of the Locale trait.

Examples

// Allow selection a date within the year of 2017.
let mut calendar = CalendarView::<Utc, EnglishLocale>::new(Utc::today());

calendar.set_highest_view_mode(ViewMode::Year);
calendar.set_earliest_date(Some(Utc.ymd(2017, 1, 1)));
calendar.set_latest_date(Some(Utc.ymd(2017, 12, 31)));
calendar.set_show_iso_weeks(true);

Implementations

impl<T: TimeZone, L: Locale + 'static> CalendarView<T, L>

pub fn new(today: Date<T>) -> Self

Creates new CalendarView.

pub fn disable(&mut self)

Disables this view.

A disabled view cannot be selected.

pub fn enable(&mut self)

Re-enables this view.

pub fn set_enabled(&mut self, enabled: bool)

Enable or disable this view.

pub fn is_enabled(&self) -> bool

Returns true if this view is enabled.

pub fn date(&self) -> Date<T>

Returns the currently selected date of this view.

pub fn set_selected_date(&mut self, date: Date<T>)

Sets the currently selected date of this view.

pub fn selected_date(self, date: Date<T>) -> Self

Sets the currently selected date of this view.

Chainable variant.

pub fn set_view_date(&mut self, date: Date<T>)

Sets the visually selected date of this view.

pub fn view_date(self, date: Date<T>) -> Self

Sets the visually selected date of this view.

Chainable variant.

pub fn set_view_mode(&mut self, mode: ViewMode)

Sets the currently active view mode of this view.

pub fn view_mode(self, mode: ViewMode) -> Self

Sets the currently active view mode of this view.

Chainable variant.

pub fn set_lowest_view_mode(&mut self, mode: ViewMode)

Sets the lowest view mode this calendar can be in.

Can be used conjunction with CalendarView::set_highest_view_mode to limit a CalendarView to only allow selection of days, months or years.

pub fn lowest_view_mode(self, mode: ViewMode) -> Self

Sets the lowest view mode this calendar can be in.

Can be used conjunction with CalendarView::set_highest_view_mode to limit a CalendarView to only allow selection of days, months or years.

Chainable variant.

pub fn set_highest_view_mode(&mut self, mode: ViewMode)

Sets the highest view mode this calendar can be in.

Can be used conjunction with CalendarView::set_lowest_view_mode to limit a CalendarView to only allow selection of days, months or years.

pub fn highest_view_mode(self, mode: ViewMode) -> Self

Sets the highest view mode this calendar can be in.

Can be used conjunction with CalendarView::set_lowest_view_mode to limit a CalendarView to only allow selection of days, months or years.

Chainable variant.

pub fn set_earliest_date(&mut self, date: Option<Date<T>>)

Sets and limits the earliest date selectable by this view.

pub fn earliest_date(self, date: Option<Date<T>>) -> Self

Sets and limits the earliest date selectable by this view.

Chainable variant.

pub fn set_latest_date(&mut self, date: Option<Date<T>>)

Sets and limits the latest date selectable by this view.

pub fn latest_date(self, date: Option<Date<T>>) -> Self

Sets and limits the latest date selectable by this view.

Chainable variant.

pub fn set_week_start(&mut self, day: WeekDay)

Allows to change the default week start day of WeekDay::Monday to any other WeekDay.

pub fn week_start(self, day: WeekDay) -> Self

Allows to change the default week start day of WeekDay::Monday to any other WeekDay.

Chainable variant.

pub fn set_show_iso_weeks(&mut self, show: bool)

Show or hide ISO week numbers in the ViewMode::Month view mode.

ISO week numbers only make sense with a week start day of WeekDay::Monday.

pub fn show_iso_weeks(self, show: bool) -> Self

Show or hide ISO week numbers in the ViewMode::Month view mode.

ISO week numbers only make sense with a week start day of WeekDay::Monday.

Chainable variant.

pub fn set_on_submit<F>(&mut self, cb: F) where
    F: Fn(&mut Cursive, &Date<T>) + 'static, 

Sets a callback to be used when <Enter> is pressed to select a date.

pub fn on_submit<F>(self, cb: F) -> Self where
    F: Fn(&mut Cursive, &Date<T>) + 'static, 

Sets a callback to be used when <Enter> is pressed to select a date.

Chainable variant.

pub fn set_on_select<F>(&mut self, cb: F) where
    F: Fn(&mut Cursive, &Date<T>) + 'static, 

Sets a callback to be used when an a new date is visually selected.

pub fn on_select<F>(self, cb: F) -> Self where
    F: Fn(&mut Cursive, &Date<T>) + 'static, 

Sets a callback to be used when an a new date is visually selected.

Chainable variant.

Trait Implementations

impl<T: TimeZone + 'static, L: Locale + 'static> View for CalendarView<T, L>

fn draw(&self, printer: &Printer<'_, '_>)

Draws the view with the given printer (includes bounds) and focus.

fn required_size(&mut self, _: Vec2) -> Vec2

Returns the minimum size the view requires with the given restrictions.

fn take_focus(&mut self, _: Direction) -> Result<EventResult, CannotFocus>

Attempt to give this view the focus.

fn on_event(&mut self, event: Event) -> EventResult

Called when an event is received (key press, mouse event, …).

fn layout(&mut self, XY<usize>)

Called once the size for this view has been decided.

fn needs_relayout(&self) -> bool

Should return true if the view content changed since the last call to layout().

fn call_on_any(
    &mut self,
    &Selector<'_>,
    &'a mut (dyn FnMut(&mut (dyn View + 'static)) + 'a)
)

Runs a closure on the view identified by the given selector.

fn focus_view(&mut self, &Selector<'_>) -> Result<EventResult, ViewNotFound>

Moves the focus to the view identified by the given selector.

fn important_area(&self, view_size: XY<usize>) -> Rect

What part of the view is important and should be visible?

fn type_name(&self) -> &'static str

Returns the type of this view.