Skip to main content

Column

Struct Column 

Source
pub struct Column {
    pub id: ColumnId,
    pub header: String,
}
Expand description

Column schema. Header text is treated as schema, not a datum.

Fields§

§id: ColumnId

Opaque id.

§header: String

Header label painted as glyphs. Not copied in sealed mode.

Implementations§

Source§

impl Column

Source

pub fn new(id: u32, header: impl Into<String>) -> Self

Construct a column.

Examples found in repository?
examples/gallery.rs (line 611)
597fn demo_grid() -> Grid {
598    let mut rows = Vec::new();
599    for i in 0..16u32 {
600        rows.push(Row::new(
601            i,
602            vec![
603                CellValue::text(format!("SKU-{i:03}")),
604                CellValue::float(12.0 + f64::from(i) * 2.15, 2),
605                CellValue::int(i64::from(i) * 4 + 3),
606            ],
607        ));
608    }
609    Grid::try_new(
610        vec![
611            Column::new(0, "sku"),
612            Column::new(1, "price"),
613            Column::new(2, "qty"),
614        ],
615        rows,
616    )
617    .expect("grid")
618}
More examples
Hide additional examples
examples/scroll_resize.rs (line 28)
14fn main() -> Result<(), Box<dyn std::error::Error>> {
15    let mut rows = Vec::new();
16    for i in 0..40u32 {
17        rows.push(Row::new(
18            i,
19            vec![
20                CellValue::text(format!("SKU-{i:03}")),
21                CellValue::float(10.0 + f64::from(i), 2),
22                CellValue::int(i64::from(i) * 3),
23            ],
24        ));
25    }
26    let grid = Grid::try_new(
27        vec![
28            Column::new(0, "sku"),
29            Column::new(1, "price"),
30            Column::new(2, "qty"),
31        ],
32        rows,
33    )?;
34
35    let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
36    let metrics = surface.metrics(&grid);
37    let dir = renders_dir();
38    fs::create_dir_all(&dir)?;
39
40    let window = Viewport::window(420, 140);
41    let frames = [
42        ("scroll_y0.png", window.clamp_to(&metrics), None),
43        ("scroll_y90.png", window.scroll_by(0, 90, &metrics), None),
44        (
45            "scroll_clamped.png",
46            window.scroll_by(0, 9_999, &metrics),
47            None,
48        ),
49        (
50            "resize_sku200.png",
51            window,
52            Some(metrics.resize_column(0, 200)),
53        ),
54    ];
55
56    for (name, vp, widths) in frames {
57        let mut req = FrameRequest::full(vp);
58        if let Some(w) = widths {
59            req = req.column_widths(w);
60        }
61        let frame = surface.render(&grid, &req)?;
62        let path = dir.join(name);
63        fs::write(&path, &frame.png)?;
64        println!(
65            "{name}: origin_y={} visible {}..{} bytes={} -> {}",
66            vp.origin_y,
67            frame.visible_row_start,
68            frame.visible_row_end,
69            frame.png.len(),
70            path.display()
71        );
72    }
73    Ok(())
74}
examples/host_contract.rs (line 48)
37fn main() -> Result<(), Box<dyn std::error::Error>> {
38    let mut rows = Vec::new();
39    for i in 0..80u32 {
40        rows.push(Row::new(
41            i,
42            vec![
43                CellValue::text(format!("ACME-SKU-{i}")),
44                CellValue::float(10.0 + f64::from(i), 2),
45            ],
46        ));
47    }
48    let grid = Grid::try_new(vec![Column::new(0, "sku"), Column::new(1, "price")], rows)?;
49
50    let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
51    let metrics = surface.metrics(&grid);
52
53    // Host scrollbar: window 480×160, content from metrics.
54    let window = Viewport {
55        origin_x: 0,
56        origin_y: 0,
57        width: 480,
58        height: 160,
59    };
60    println!(
61        "host scrollbar: content {}x{} window {}x{} max_origin_y={}",
62        metrics.content_width,
63        metrics.content_height,
64        window.width,
65        window.height,
66        metrics.content_height.saturating_sub(window.height)
67    );
68
69    let dir = std::env::temp_dir().join("sealed-surface-examples");
70    fs::create_dir_all(&dir)?;
71
72    for (name, origin_y) in [("y0", 0u32), ("y180", 180), ("y360", 360)] {
73        let mut req = FrameRequest::full(Viewport {
74            origin_x: 0,
75            origin_y,
76            width: window.width,
77            height: window.height,
78        });
79        req.pointer = Some(Pointer { x: 24, y: 40 });
80        let frame = surface.render(&grid, &req)?;
81        let path = dir.join(format!("host_{name}.png"));
82        fs::write(&path, &frame.png)?;
83        assert!(
84            frame.host.audit_text().is_empty(),
85            "sealed host leaked: {:?}",
86            frame.host.audit_text()
87        );
88        println!(
89            "{name}: rows {}..{} png={} tooltip={} file={}",
90            frame.visible_row_start,
91            frame.visible_row_end,
92            frame.png.len(),
93            frame.tooltip_png.as_ref().map_or(0, Vec::len),
94            path.display()
95        );
96    }
97
98    println!("forbidden: interpolating cell values, tooltip JSON, CSS blur over live rows");
99    println!("allowed:   <img alt=\"\"> + tooltip PNG + metrics-driven origin");
100    Ok(())
101}
examples/paint_grid.rs (line 18)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16    let grid = Grid::try_new(
17        vec![
18            Column::new(0, "sku"),
19            Column::new(1, "price"),
20            Column::new(2, "qty"),
21        ],
22        vec![
23            Row::new(
24                0,
25                vec![
26                    CellValue::text("ACME-SKU-1"),
27                    CellValue::float(49.00, 2),
28                    CellValue::int(12),
29                ],
30            ),
31            Row::new(
32                1,
33                vec![
34                    CellValue::text("ACME-SKU-2"),
35                    CellValue::float(19.50, 2),
36                    CellValue::int(3),
37                ],
38            ),
39            Row::new(
40                2,
41                vec![
42                    CellValue::text("SECRET-ROW"),
43                    CellValue::float(999.00, 2),
44                    CellValue::int(1),
45                ],
46            ),
47        ],
48    )?;
49
50    let mut surface = Surface::new(
51        SurfaceMode::Sealed,
52        LicenseLens::from_tier(AccessTier::Trial),
53    );
54    let metrics = surface.metrics(&grid);
55    let mut req = FrameRequest::full(Viewport {
56        origin_x: 0,
57        origin_y: 0,
58        width: metrics.content_width.clamp(320, 960),
59        height: metrics.content_height.clamp(120, 360),
60    });
61    req.pointer = Some(Pointer { x: 24, y: 36 });
62
63    let frame = surface.render(&grid, &req)?;
64    let dir = example_out_dir();
65    fs::create_dir_all(&dir)?;
66    let frame_path = dir.join("frame.png");
67    fs::write(&frame_path, &frame.png)?;
68    if let Some(tip) = &frame.tooltip_png {
69        fs::write(dir.join("tooltip.png"), tip)?;
70    }
71    let renders = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
72    fs::create_dir_all(&renders)?;
73    fs::write(renders.join("readme_table.png"), &frame.png)?;
74    if let Some(tip) = &frame.tooltip_png {
75        fs::write(renders.join("readme_tooltip.png"), tip)?;
76    }
77
78    println!("mode={:?} lens=trial", surface.mode());
79    println!(
80        "content={}x{} visible_rows={}..{} png_bytes={}",
81        frame.content_width,
82        frame.content_height,
83        frame.visible_row_start,
84        frame.visible_row_end,
85        frame.png.len()
86    );
87    println!(
88        "host audit (must not contain prices): {:?}",
89        frame.host.audit_text()
90    );
91    println!("wrote {}", frame_path.display());
92
93    surface.set_mode(SurfaceMode::Copyable);
94    let copyable = surface.render(&grid, &req)?;
95    println!("copyable TSV:\n{}", copyable.host.audit_text());
96
97    write_readme_shots(&renders)?;
98    Ok(())
99}
100
101fn write_readme_shots(renders: &std::path::Path) -> Result<(), Box<dyn std::error::Error>> {
102    let mut rows = Vec::new();
103    for i in 0..8u32 {
104        rows.push(Row::new(
105            i,
106            vec![
107                CellValue::text(format!("SKU-{i:03}")),
108                CellValue::float(12.0 + f64::from(i) * 2.15, 2),
109                CellValue::int(i64::from(i) * 4 + 3),
110            ],
111        ));
112    }
113    let grid = Grid::try_new(
114        vec![
115            Column::new(0, "sku"),
116            Column::new(1, "price"),
117            Column::new(2, "qty"),
118        ],
119        rows,
120    )?;
121    let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
122    let m = surface.metrics(&grid);
123    let frame = surface.render(
124        &grid,
125        &FrameRequest::full(Viewport::window(m.content_width.max(320), 200)),
126    )?;
127    fs::write(renders.join("readme_table.png"), &frame.png)?;
128    Ok(())
129}

Trait Implementations§

Source§

impl Clone for Column

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Column

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for Column

Source§

impl PartialEq for Column

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Column

Auto Trait Implementations§

§

impl Forget for Column

§

impl Freeze for Column

§

impl Move for Column

§

impl RefUnwindSafe for Column

§

impl Send for Column

§

impl Sync for Column

§

impl Unpin for Column

§

impl UnsafeUnpin for Column

§

impl UnwindSafe for Column

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.