Struct RecordColumn 

pub struct RecordColumn { /* private fields */ }

One stable column in a RecordsTable.

Visible labels need not be unique. Events and row lookup always use the application-supplied column ID.

Implementations

impl RecordColumn

pub fn new(id: impl Into<SharedString>, label: impl Into<SharedString>) -> Self

Creates a column with a stable application ID and visible label.

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

Enables or disables sorting for the column.

pub fn width(self, width: Pixels) -> Self

Sets the logical column width.

pub fn width_in_rems(self, width: f32) -> Self

Sets the column width in multiples of the reader’s base type size.

The width resolves against the window’s rem at layout time and is resolved again when the reader zooms, so a column sized for its text keeps that proportion; a width set with RecordColumn::width does not. Columns of one table may mix the two, and the later call wins.

pub fn fill(self, share: f32) -> Self

Takes a share of the width left over once every column has the width it asked for.

The width set by RecordColumn::width is a floor rather than a ceiling here: the surplus is added to it, so a column that fills can never collapse and there is no separate minimum to remember. A column with twice the share of another takes twice as much of the surplus.

The moment one column asks, it and its fellow askers divide the surplus and every other column keeps exactly what it asked for - which is how a table gets one exact column beside one that stretches.

let exact = RecordColumn::new("cost", "Unit cost").width(px(120.));
let stretches = RecordColumn::new("notes", "Notes").width(px(180.)).fill(1.);

pub fn alignment(self, alignment: RecordColumnAlignment) -> Self

Sets the column’s horizontal content alignment.

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

Pins or unpins the column at the leading edge.

pub fn description(self, description: impl Into<SharedString>) -> Self

Adds supplementary accessible column guidance.

pub fn id(&self) -> &str

Returns the stable application column ID.

pub fn label(&self) -> &str

Returns the visible column label.

pub fn is_sortable(&self) -> bool

Returns whether the column can request sorting.

pub fn configured_width(&self) -> Option<Pixels>

Returns the explicitly configured logical column width, if any.

A width set with RecordColumn::width_in_rems has no pixel value until a window resolves it, so it reads as None here.

pub fn column_alignment(&self) -> RecordColumnAlignment

Returns the horizontal content alignment.

pub fn is_fixed(&self) -> bool

Returns whether the column is pinned to the leading edge.

pub fn accessible_description(&self) -> Option<&str>

Returns supplementary accessible guidance, if supplied.

Trait Implementations

impl Clone for RecordColumn

fn clone(&self) -> RecordColumn

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecordColumn

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

Formats the value using the given formatter.

impl PartialEq for RecordColumn

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RecordColumn