Struct FileTable 

pub struct FileTable<R>
where
    R: FileRow,
{ /* private fields */ }

The file list a host keeps across its rebuilds.

Implementations

impl<R> FileTable<R>

where R: FileRow,

pub fn new(id: &'static str, accessible_name: impl Into<String>) -> FileTable<R>

A list with the accessibility id and accessible_name it is known by. It shows selection; the host decides what a press selects.

pub fn handles_clicks(self) -> FileTable<R>

The list reports a press on a row (FileTableOutcome::click) instead of selecting it itself, so the host’s selection stays the only one.

pub fn handles_row_menu(self) -> FileTable<R>

The list reports a row’s own menu (FileTableOutcome::menu) instead of opening it: a right-press, and the assistance technology’s “show context menu” on the same row, both reach the host, which draws the one menu it has.

pub fn sync(&mut self, inputs: FileTableInputs<'_, R>)

Put this build’s rows, selection and sort into the table, making it first if there is none or the columns changed.

pub fn column_widths(&self) -> Vec<(String, f32)>

The column widths the person set by dragging an edge, by column key: what a host keeps so a resized column is where they left it next time.

pub fn set_column_widths( &mut self, widths: impl IntoIterator<Item = (String, f32)>, )

Lay the columns out at the widths the person set last time. Widths for columns this table does not show are ignored.

pub fn rows(&self) -> Vec<&R>

The rows as the table holds them, in display order.

pub fn reset_scroll(&mut self)

Scroll back to the top (a folder was opened).

pub fn scroll_y(&self) -> f32

The table’s scroll offset.

pub fn set_scroll_y(&mut self, y: f32)

Scroll to y (clamped by the table).

pub fn max_scroll_y(&self) -> f32

The farthest the list can scroll.

pub fn reveal_row(&mut self, index: usize)

Scroll so the row at display index is in view.

pub fn rect(&self) -> Rect

The table’s laid-out rectangle.

pub fn build_layout( &mut self, taffy: &mut TaffyTree, theme: &Theme, ) -> Option<NodeId>

Add the table’s node to taffy, sized to fill its parent.

pub fn apply_layout( &mut self, taffy: &TaffyTree, node: NodeId, origin: Point, ) -> bool

Lay the table out in node, and give it the body height and row height it scrolls by. Returns whether the columns should change with the new width, so the host syncs again.

pub fn place(&mut self, rect: Rect, theme: &Theme) -> bool

Lay the table out in rect on a layout of its own, for a host that places its parts itself. Returns what Self::apply_layout does.

pub fn draw( &mut self, scene: &mut Scene, transform: Affine, text_renderer: &mut TextRenderer, theme: &Theme, presence: &PresenceCtx, )

pub fn handle_event( &mut self, event: &WindowEvent, ctx: &mut EventCtx<'_>, ) -> FileTableOutcome

Forward event to the table and report what its callbacks recorded.

pub fn take_outcome(&mut self) -> FileTableOutcome

What the table’s callbacks recorded since the last read.

pub fn take_row_requests(&mut self) -> (Option<usize>, Option<(usize, Point)>)

What an assistive technology asked of a row since the last read: the row it asked to open, and the row and point it asked a menu for. No pointer event delivers these — they come through the accessibility tree — so a host reads them once a frame, before it lays the next one out, rather than waiting for the next event.

pub fn in_scrollbar(&self, at: Point) -> bool

Whether at is over the table’s scrollbar, which the table keeps for itself.

pub fn select(&mut self, selection: &SelectionModel)

Show selection in the table.

pub fn selection(&self) -> Option<&SelectionModel>

The selection as the table holds it (keyboard movement changes it).

pub fn point_at(&mut self, at: Point, ctx: &mut EventCtx<'_>)

Tell the table where the pointer is, so a press that arrives with no move since the host was rebuilt still lands on the right row.

pub fn update( &mut self, state: &(dyn Any + 'static), path: &(dyn Any + 'static), ) -> bool

pub fn needs_animation_frame(&self) -> bool

pub fn is_layout_dirty(&self) -> bool

pub fn wants_pointer_capture(&self) -> bool

pub fn discard_structure_dirty(&mut self)

The table swaps its retained cell controls on a scroll; a file list has no such cells, so this never asks for a rebuild.

pub fn set_focus(&mut self, focused: bool)

pub fn header_height(&self) -> f64

The header band’s height as the table lays it out.

pub fn row_rects(&self) -> Vec<(usize, Rect)>

Each visible row’s rectangle by display index, read from the table’s accessibility export (the table publishes no row geometry) and clipped to the body below the header band, so a row scrolled half under the header or the bottom edge is only as large as what shows.

pub fn accessibility(&self) -> Option<AccessNode>

The table’s accessibility node.

pub fn perform_action( &mut self, action: &Action, key_path: &[u64], state: &mut Edits<'_>, path: &(dyn Any + 'static), ) -> bool

Run an assistive technology’s action on the table’s row at key_path (empty: the table itself).

pub fn perform_semantic_action( &mut self, target: &str, action: &Action, state: &mut Edits<'_>, path: &(dyn Any + 'static), ) -> bool

Run an assistive technology’s action on the synthetic row the semantic target target names: the row an access node forwarded from this table addresses.