Struct Chart 

pub struct Chart<M> { /* private fields */ }

A chart of a ChartModel: its panes stacked top to bottom on one horizontal axis, labelled under the lowest, each scaled to what it shows.

It shows the newest span of the data and moves with it as data arrives. The user zooms with the wheel or the up and down keys (around the pointer, or at the newest data while following it), pans by dragging, with a sideways scroll or with the left and right keys, and goes back to the newest data with a double click, End, or by panning past it; Home goes to the oldest. A view the user moved stays over the data as it changes (data trimmed away moves it along). A crosshair follows the pointer with its values, written a digit finer than the labels (with_label_chars for room). It reports ActionKind::Changed when the user moved the view.

Painting allocates nothing once the label characters are cached; what the model’s series cost is up to them (this crate’s series functions allocate nothing). Change the data through model_mut from an Ui::update on the chart, which repaints it. Give it Chart::style.

Implementations

impl<M: ChartModel> Chart<M>

pub fn new(model: M, span: f64) -> Self

A chart of model showing its newest span of x (an hour is 3600.0 on a time axis), following new data.

pub fn with_label_chars(self, chars: u16) -> Self

The chart with room for y labels of chars characters (8 unless told otherwise).

pub fn style() -> Style

A chart filling its parent’s free space, allowed to be small, and clipping.

pub fn model(&self) -> &M

The data.

pub fn model_mut(&mut self, cx: &mut EventCx<'_>) -> &mut M

The data, to change (from an Ui::update on the chart): the chart repaints.

pub fn x_axis(&self) -> Option<Axis>

What part of the horizontal axis shows, or None while there is no data.

pub fn is_following(&self) -> bool

Whether the chart moves with new data.

pub fn follow(&mut self, cx: &mut EventCx<'_>)

Shows the newest data again, as wide a part as now, and follows it.

pub fn show(&mut self, cx: &mut EventCx<'_>, x: Axis)

Shows x (within what the data allows), following new data if it reaches past the newest.

Trait Implementations

impl<M: Debug> Debug for Chart<M>

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

Formats the value using the given formatter.

impl<M: ChartModel + 'static> Widget for Chart<M>

fn layout(&mut self, cx: &mut LayoutCx<'_>, _size: Size)

Layout decided the widget’s size: re-wrap text or recompute anything that depends on it. Called after every layout pass that changed the size.

fn paint(&mut self, cx: &PaintCx<'_>, canvas: &mut Canvas<'_>)

Paints the widget below its children.

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

Handles event. An event the widget does not handle goes on to its parent.

fn accepts_focus(&self) -> bool

Whether the widget takes keyboard focus, by click or by Tab.

fn accessibility(&self, _cx: &PaintCx<'_>, node: &mut AccessNode)

Describes the widget to assistive technology: fills node, which starts as a Role::Group with the widget’s rectangle. Called only while assistive technology is listening; it may allocate.

fn measure(&mut self, cx: &mut LayoutCx<'_>, constraints: Constraints) -> Size

The size the widget wants within constraints, for a widget without children (one with children is sized by its style and its children). Physical pixels.

fn paint_over(&mut self, cx: &PaintCx<'_>, canvas: &mut Canvas<'_>)

Paints the widget over its children: scroll bars, focus rings, overlays.

fn focus_on_press(&self) -> bool

Whether a press on the widget, or on a widget inside it that takes no focus, focuses it (if it accepts focus). A container reachable by Tab, such as a dock’s tab list, says no, so clicks on its contents do not focus it; it can still ask for focus itself.

fn access_action( &mut self, cx: &mut EventCx<'_>, request: &AccessRequest<'_>, ) -> Handled

Does what assistive technology asks (only actions the widget’s node lists are asked of it). Focus and scrolling into view are done for every widget; a request the widget does not handle goes on to its parent if it is a scroll.