Struct Axis 

pub struct Axis { /* private fields */ }

A row of labels along the edge of a chart: hours of a day, weekdays, months, or names of your own.

Hours are placed by time: a label starts in the cell its clock time falls in, the way a Timeline places a block, so an axis under a strip of the same range reads straight down. Weekdays, months and names of your own are placed in slots: the width is shared out into one slot per label, with gap empty cells between slots, and each label is centred in its slot. A vertical BarChart shares its width out the same way, so an axis with the chart’s gap stands under its bars.

Names come from the active language — quvyta.date.weekday-long-*, weekday-*, month-*, month-short-*, and quvyta.time.clock and hour for times — never from the source.

Labels never collide and are never cut. Weekdays and months write every name in full while all of them fit, then every name in its short form, then the short form of every second, third, … name. Hours take the finest step whose labels fit — a quarter hour, half an hour, an hour, then 2, 3, 4, 6, 12 hours and a day, always on round clock times — in the long form (09:30), and fall back to the short form (09) only when the long one leaves fewer than two labels, which gives a reader no scale. At least one cell stays empty between two labels, and a label that would run past the right edge is left out rather than cut. An area too narrow for a single label writes nothing.

An axis is text only, so it reads the same in every glyph mode; it takes no focus and sends no messages.

Style keys: axis (fg).

Implementations

impl Axis

pub fn hours(from: TimeOfDay, to: TimeOfDay) -> Self

The hours from from to to: into the next day when to is not after from, a whole day when the two are the same.

pub fn weekdays(first: Weekday, count: usize) -> Self

count weekdays from first on, wrapping after Sunday.

pub fn months(first: u8, count: usize) -> Self

count months from first on (1 for January to 12 for December), wrapping after December. A first outside 1 to 12 is taken as the nearest month.

pub fn labels(labels: impl IntoIterator<Item = impl Into<String>>) -> Self

Names of your own, one slot each, e.g. the weeks of a quarter. A name with no room in the active width is left out, never cut.

pub fn gap(self, cells: u16) -> Self

Empty cells between two slots; none by default. Give it the gap of the chart above so the labels stand under its bars. Hours are placed by time and have no slots, so they ignore it.

Trait Implementations

impl Clone for Axis

fn clone(&self) -> Axis

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Axis

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Axis

impl PartialEq for Axis

fn eq(&self, other: &Axis) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Axis

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

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.