Struct ColumnWidths 

pub struct ColumnWidths { /* private fields */ }

Display widths by column identity (name and type): a retyped column starts afresh, one returning with its type keeps its width. Unrelated to the byte estimate that plans buffers.

Implementations

impl ColumnWidths

pub fn width( &mut self, name: &str, dtype: &DataType, page: PageMeasure, cap: u16, ) -> u16

The width to draw the column at on this page, learning from the page as automatic widths do. cap bounds automatic text and headings.

pub fn fill(&mut self, name: &str, dtype: &DataType, filled: u16)

The column, drawn last at width, was widened to filled to reach the table’s right edge. Only an automatic width fills: one set by hand is drawn as set.

pub fn choice(&self, name: &str, dtype: &DataType) -> WidthChoice

How the column’s width is chosen.

pub fn shown(&self, name: &str, dtype: &DataType) -> Option<u16>

The width the column was last drawn at, if it has been.

pub fn on_screen(&self, name: &str, dtype: &DataType) -> Option<u16>

Self::shown, with the room the column filled at the right edge: what a step narrower or wider starts from, so a wider column never draws narrower.

pub fn drawn(&self, name: &str, dtype: &DataType) -> Option<u16>

The width the column was last drawn at, if it has been drawn since the widths were last relearned: what a sideways page can be planned with.

pub fn set_choice(&mut self, name: &str, dtype: &DataType, choice: WidthChoice)

pub fn fits_pending(&self) -> Vec<(String, DataType)>

The columns waiting to be fitted to the rows on screen.

pub fn fit(&mut self, name: &str, dtype: &DataType, page: PageMeasure, cap: u16)

Fit the column to page: its values and type whole, its heading up to cap.

pub fn relearn(&mut self)

The view changed: learn every automatic width again from the next rows read (see Self::rows_arrived). Widths set by hand are kept.

pub fn keep_learned(&mut self)

The change asked to relearn never showed (it failed and the view was put back), so the widths learned for the view on screen stand.

pub fn rows_arrived(&mut self)

Rows read for the view are about to replace the ones on screen. After Self::relearn, every automatic width starts again from them: text from its first page with a value, and the rest from nothing, so they may narrow.

Trait Implementations

impl Clone for ColumnWidths

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColumnWidths

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

Formats the value using the given formatter.

impl Default for ColumnWidths

fn default() -> Self

Returns the “default value” for a type.