Struct CellGrid 

pub struct CellGrid {
    pub entries: Vec<Entry>,
    pub cols: Vec<Sizing>,
    pub rows: Vec<Sizing>,
    pub vlines: Vec<Vec<Line>>,
    pub hlines: Vec<Vec<Line>>,
    pub headers: Vec<Repeatable<Header>>,
    pub footer: Option<Repeatable<Footer>>,
    pub has_gutter: bool,
}

A grid of cells, including the columns, rows, and cell data.

Fields

entries: Vec<Entry>

The grid cells.

cols: Vec<Sizing>

The column tracks including gutter tracks.

rows: Vec<Sizing>

The row tracks including gutter tracks.

vlines: Vec<Vec<Line>>

The vertical lines before each column, or on the end border. Gutter columns are not included. Contains up to ‘cols_without_gutter.len() + 1’ vectors of lines.

hlines: Vec<Vec<Line>>

The horizontal lines on top of each row, or on the bottom border. Gutter rows are not included. Contains up to ‘rows_without_gutter.len() + 1’ vectors of lines.

headers: Vec<Repeatable<Header>>

The repeatable headers of this grid.

footer: Option<Repeatable<Footer>>

The repeatable footer of this grid.

has_gutter: bool

Whether this grid has gutters.

Implementations

impl CellGrid

pub fn new( tracks: Axes<&[Sizing]>, gutter: Axes<&[Sizing]>, cells: impl IntoIterator<Item = Cell>, ) -> Self

Generates the cell grid, given the tracks and cells.

pub fn new_internal( tracks: Axes<&[Sizing]>, gutter: Axes<&[Sizing]>, vlines: Vec<Vec<Line>>, hlines: Vec<Vec<Line>>, headers: Vec<Repeatable<Header>>, footer: Option<Repeatable<Footer>>, entries: Vec<Entry>, ) -> Self

Generates the cell grid, given the tracks and resolved entries.

pub fn entry(&self, x: usize, y: usize) -> Option<&Entry>

Get the grid entry in column x and row y.

Returns None if it’s a gutter cell.

pub fn cell(&self, x: usize, y: usize) -> Option<&Cell>

Get the content of the cell in column x and row y.

Returns None if it’s a gutter cell or merged position.

pub fn parent_cell_position(&self, x: usize, y: usize) -> Option<Axes<usize>>

Returns the position of the parent cell of the grid entry at the given position. It is guaranteed to have a non-gutter, non-merged cell at the returned position, due to how the grid is built.

• If the entry at the given position is a cell, returns the given position.
• If it is a merged cell, returns the parent cell’s position.
• If it is a gutter cell, returns None.

pub fn effective_parent_cell_position( &self, x: usize, y: usize, ) -> Option<Axes<usize>>

Returns the position of the actual parent cell of a merged position, even if the given position is gutter, in which case we return the parent of the nearest adjacent content cell which could possibly span the given gutter position. If the given position is not a gutter cell, then this function will return the same as parent_cell_position would. If the given position is a gutter cell, but no cell spans it, returns None.

This is useful for lines. A line needs to check if a cell next to it has a stroke override - even at a gutter position there could be a stroke override, since a cell could be merged with two cells at both ends of the gutter cell (e.g. to its left and to its right), and thus that cell would impose a stroke under the gutter. This function allows getting the position of that cell (which spans the given gutter position, if it is gutter), if it exists; otherwise returns None (it’s gutter and no cell spans it).

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

Checks if the track with the given index is gutter. Does not check if the index is a valid track.

pub fn effective_colspan_of_cell(&self, cell: &Cell) -> usize

Returns the effective colspan of a cell, considering the gutters it might span if the grid has gutters.

pub fn effective_rowspan_of_cell(&self, cell: &Cell) -> usize

Returns the effective rowspan of a cell, considering the gutters it might span if the grid has gutters.

pub fn non_gutter_column_count(&self) -> usize

pub fn non_gutter_row_count(&self) -> usize

pub fn has_repeated_headers(&self) -> bool

Trait Implementations

impl Debug for CellGrid

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

Formats the value using the given formatter.

impl Hash for CellGrid

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CellGrid

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CellGrid