Struct DatePickerDialog 

pub struct DatePickerDialog<State: 'static> { /* private fields */ }

A declarative M3E date picker dialog. See the module docs.

Implementations

impl<State: 'static> DatePickerDialog<State>

pub fn today(self, today: MaterialDate) -> Self

Mark today with the today ring — see CalendarDatePicker::today for why this is required rather than defaulted.

pub fn strings(self, strings: DatePickerStrings) -> Self

Replace the localized strings (default DatePickerStrings::ENGLISH).

pub fn selectable<F: Fn(MaterialDate) -> bool + 'static>( self, predicate: F, ) -> Self

Refuse individual dates inside the bounds — the reference’s selectableDayPredicate, applied by both the calendar and the field.

pub fn on_confirm<F: Fn(&mut State, Option<MaterialDate>) + 'static>( self, on_confirm: F, ) -> Self

Observe OK. show_date_picker wires this to a staged dismissal carrying the picked date (ModalDismiss::dismiss_with); a caller mounting the dialog directly (in a Stack, with no navigator) wires its own.

pub fn dismissable(self, dismissable: bool) -> Self

Whether the user can dismiss the dialog at all — the scrim tap, Escape, and an Android back press (default true). false disables all three; Cancel and OK still work.

pub fn on_dismiss<F: Fn(&mut State) + 'static>(self, on_dismiss: F) -> Self

Observe a dismissal — the callback the Cancel button fires when no dismiss_handle is installed (see the module docs’ OK-and-Cancel section). show_date_picker installs a handle, so on that path Cancel stages the host’s exit instead and this callback is the host’s own unstaged fallback, nothing more.

pub fn dismiss_handle(self, dismiss: ModalDismiss) -> Self

Install the app-triggered staged-dismiss handle, so Cancel closes the dialog through the host’s exit ramp instead of firing on_dismiss into an immediate pop (see ModalDismiss). show_date_picker installs one for you — and wires OK to it too, since OK’s own pop is its to make.

pub fn confirmable(&self) -> Option<MaterialDate>

What pressing OK would confirm right now.

In calendar mode that is DatePickerState::selected (or None — the reference pops a null date from an untouched calendar too). In input mode it is the parsed field text, and None there means OK does nothing at all rather than confirming an empty pick — see the module docs.

pub fn can_confirm(&self) -> bool

Whether pressing OK does anything at all — false only for an input mode whose text does not resolve.

pub fn confirm(&self, app: &mut State)

Run the OK action’s body directly — the same code path Self::confirm_view’s button callback runs, reachable without an event pass (both routes share [confirm_action], so a test of one is a test of the other).

pub fn cancel(&self, app: &mut State)

Run the Cancel action’s body directly — see Self::confirm.

Trait Implementations

impl<State: 'static> OverlayModalContent<State> for DatePickerDialog<State>

fn on_modal_dismiss(self, on_dismiss: Rc<dyn Fn(&mut State)>) -> Self

Install the dismiss callback, replacing any the builder already set.

fn modal_dismissable(&self) -> bool

Whether this modal may be dismissed by the user at all — read once, at push time, to pick the page’s BackPolicy.

impl<State: 'static> View<State> for DatePickerDialog<State>

type Element = OverlayModalWidget

The retained widget this view produces.

fn build(&self, ctx: &mut BuildCtx<'_>) -> OverlayModalWidget

Materialise a fresh widget for this view.

fn rebuild( &self, prev: &Self, element: &mut OverlayModalWidget, ctx: &mut BuildCtx<'_>, ) -> ChangeFlags

Reconcile prev (the previous view of the same type) against the live element, mutating it in place and reporting what changed.

fn teardown(&self, element: &mut OverlayModalWidget, ctx: &mut BuildCtx<'_>)

Tear down element when this view is being removed.

fn message(&self, _element: &mut Self::Element, _state: &mut State)

Deliver an event message to this view, mutating application state.