Struct TimeInput 

pub struct TimeInput<Msg> { /* private fields */ }

A time of day edited segment by segment: hours and minutes, optionally seconds, on a 24-hour clock written the same in every language.

The field takes focus as one control and one segment at a time is active: Left and Right move between segments, Up and Down change the active segment and wrap around (23 → 00), and typing digits fills it, moving on once the segment is complete. : moves on as well and Backspace sets the segment to zero. A click activates the segment under the pointer. The wheel changes the segment under the pointer, one step per notch, without moving focus or the active segment; over a colon it changes the segment the pointer was last over inside the field, or the active segment when there was none. The application owns the time.

Ctrl+A selects the whole time; then Ctrl+C copies it as 09:30 (09:30:00 with seconds) and Ctrl+X copies it and sets the time to zero. Pasting 9:30 or 09:30:15 sets the time; other text is ignored. A right click (or Shift+F10 and the menu key) opens the edit menu of TextInput with the same actions; Cut and Copy need the whole time selected.

Style keys: time-input (bg, fg) with states hover, focus, invalid, disabled; time-segment (bg, fg, bold) with selected for the active segment and active while a first digit waits for the second; time-separator (fg); text-input-selection (bg, fg) for the whole time selected.

Implementations

impl<Msg> TimeInput<Msg>

pub fn new(value: TimeOfDay) -> Self

A field showing value as hours and minutes.

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

Shows and edits seconds too.

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

Marks the time as failing validation, such as an end before its start.

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

Greys the field out; it cannot be focused or changed.

pub fn on_change(self, message: impl Fn(TimeOfDay) -> Msg + 'static) -> Self

Message carrying the new time after every change.

Trait Implementations

impl<Msg: 'static> Widget<Msg> for TimeInput<Msg>

fn measure(&self, _cx: &mut MeasureCx<'_>, available: Size) -> Size

The size the widget wants when it may use up to available.

fn paint(&self, cx: &mut PaintCx<'_>, area: Rect)

Draws the widget into area.

fn paint_overlay(&self, cx: &mut PaintCx<'_>, anchor: Rect)

Draws the widget’s overlay after the whole view was painted, when it asked for one with PaintCx::request_overlay. anchor is the area the widget was painted in.

fn event(&self, cx: &mut EventCx<'_, Msg>, event: &Event) -> bool

Handles input. Returns true when the event was used; unused key and scroll events bubble to the parent widget.

fn focusable(&self) -> bool

Whether the widget can take keyboard focus.

fn children(&self) -> &[Node<Msg>]

Child nodes, for widgets that contain other widgets.

fn children_mut(&mut self) -> &mut [Node<Msg>]

Mutable child nodes, used to assign ids.