Struct ChartLayout 

pub struct ChartLayout {
    pub mode: ChartLayoutMode,
    pub sync: ChartSyncOptions,
    /* private fields */
}

Container state for up to sixteen host-owned charts. Supply charts in stable slot order.

Each chart keeps its own feed, settings, scales, studies and drawings. An unnamed group synchronizes with other unnamed charts; named groups are isolated. Save this state and the charts through host storage as needed. Synchronization includes supplied slots hidden by a grid preset. The container does not acquire data or persist it. Charts that keep their drawings in the same storage (Chart::set_storage) read the drawings of their symbol again after another of them wrote them, in any group.

use egui_charts::widget::{Chart, ChartLayout, ChartLayoutMode};
let mut a = Chart::new(egui_charts::model::BarData::new());
let mut b = Chart::new(egui_charts::model::BarData::new());
let mut layout = ChartLayout::default();
layout.mode = ChartLayoutMode::TwoHorizontal;
layout.show(ui, &mut [&mut a, &mut b]);

Fields

mode: ChartLayoutMode

The selected grid or tab preset.

sync: ChartSyncOptions

Synchronization controls, applied within each group.

Implementations

impl ChartLayout

pub fn active(&self) -> usize

Active chart slot, clamped to supplied charts by Self::show.

pub fn set_active(&mut self, index: usize)

Selects a chart slot and focuses its canvas when shown; out-of-range indices are ignored.

pub fn set_sync_group(&mut self, index: usize, group: Option<String>)

Assigns a named synchronization group; None restores the unnamed group.

pub fn sync_group(&self, index: usize) -> Option<&str>

The group assigned to a slot, or None for the unnamed group or an invalid slot.

pub fn set_detached(&mut self, index: usize, detached: bool)

Detaches a chart into an immediate viewport. Backends without native multi-window support embed the viewport. Closing it returns the chart to its grid or tab.

pub fn is_detached(&self, index: usize) -> bool

Whether a chart is detached.

pub fn apply_date_range( &self, charts: &mut [&mut Chart], range: VisibleTimeRange, )

Fits an explicit date selection to the active chart, or its synchronization group when sync_date_range is enabled. Call after the charts have rendered at their sizes.

pub fn show(&mut self, ui: &mut Ui, charts: &mut [&mut Chart]) -> Response

Shows the preset and synchronizes its charts. Click or scroll a panel to activate it. Its corner menu offers detachment and named groups. The active border is painted inside the chart; stacked charts have a two-point gap and side-by-side charts meet at their edge. Extra charts remain owned by the host and are not painted by a grid preset.

pub fn visible_chart_rects( &self, rect: Rect, count: usize, ) -> Vec<(usize, Rect)>

The slot and rectangle of each visible chart inside rect, for an image export. Uses the on-screen arrangement, omitting detached and hidden slots and tab controls. count is the number of charts the host owns, including the active one.

impl ChartLayout

pub fn set_replay_time( &self, charts: &mut [&mut Chart], source: usize, time: Option<DateTime<Utc>>, )

Sets one replay cutoff on the source slot’s synchronization group, including hidden slots. Other groups keep their own sessions. Call for every cursor move and with None to exit; each chart windows its own host-supplied history at its own interval.

Trait Implementations

impl Clone for ChartLayout

fn clone(&self) -> ChartLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ChartLayout

fn default() -> ChartLayout

Returns the “default value” for a type.