Struct Table 

pub struct Table { /* private fields */ }

Represents a simple table in a PDF document

Implementations

impl Table

pub fn new(column_widths: Vec<f64>) -> Self

Create a new table with specified column widths

pub fn with_equal_columns(num_columns: usize, total_width: f64) -> Self

Create a table with equal column widths

pub fn set_position(&mut self, x: f64, y: f64) -> &mut Self

Set table position

pub fn set_options(&mut self, options: TableOptions) -> &mut Self

Set table options

pub fn options(&self) -> &TableOptions

Get a reference to the table’s current options.

pub fn add_header_row( &mut self, cells: Vec<String>, ) -> Result<&mut Self, PdfError>

Add a header row

pub fn set_last_row_height(&mut self, height: f64) -> &mut Self

Set the height of the last added row

pub fn add_row(&mut self, cells: Vec<String>) -> Result<&mut Self, PdfError>

Add a data row

pub fn add_row_with_alignment( &mut self, cells: Vec<String>, align: TextAlign, ) -> Result<&mut Self, PdfError>

Add a data row with specific alignment

pub fn add_custom_row( &mut self, cells: Vec<TableCell>, ) -> Result<&mut Self, PdfError>

Add a row with custom cells (allows colspan)

pub fn get_height(&self) -> f64

Get total table height

pub fn get_width(&self) -> f64

Get total table width

pub fn row_count(&self) -> usize

Number of rows in this table (header + data).

pub fn header_count(&self) -> usize

Number of leading header rows in this table.

pub fn position(&self) -> (f64, f64)

Current top-left position of the table, (x, y).

pub fn render(&self, graphics: &mut GraphicsContext) -> Result<(), PdfError>

Render the table to a graphics context.

Back-compat note: this method is vertical-overflow-unaware by design. Rows past the page boundary are still drawn off-page (silent overflow). Callers concerned with overflow should use Table::render_with_split or Table::render_strict, or crate::page_tables::DocumentTables::add_paginated_table.

pub fn render_with_split( &self, graphics: &mut GraphicsContext, bottom_y: f64, ) -> Result<Option<Table>, PdfError>

Render as many leading rows as fully fit above bottom_y; return the unrendered tail as a fresh Table (with the same column_widths and options), or None when everything fit.

Tail position is a sentinel (start_x, 0.0) — the caller MUST call Table::set_position on the returned tail before using it for rendering or fit checks. Calling render_with_split on a tail without repositioning will report 0 rows fitting (since start_y - row_height < bottom_y for any positive bottom_y) and yield a tail identical to the input. For batteries-included pagination, see crate::page_tables::DocumentTables::add_paginated_table.

Errors

Returns PdfError::InvalidStructure when bottom_y is not a finite value (NaN or ±∞).

pub fn render_strict( &self, graphics: &mut GraphicsContext, bottom_y: f64, ) -> Result<(), PdfError>

Strict variant: pre-flight check the table against bottom_y. If any row would overflow, return PdfError::TableOverflow without drawing anything; otherwise render normally.

Errors

Returns PdfError::InvalidStructure when bottom_y is not finite.

Trait Implementations

impl Clone for Table

fn clone(&self) -> Table

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Table

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

Formats the value using the given formatter.