table-core/ua.wwind.table.state/TableColumnsState

TableColumnsState

Column layout of one table: the order columns render in, the width overrides that apply to them, and the measurements the auto-fit works from.

Reached as TableState.columns. Every member here has a deprecated forwarder on TableState itself, kept for one release so existing call sites compile with a warning that names the replacement; the forwarders go away in the next major.

Properties

autoWidthAppliedForData

var autoWidthAppliedForData: Boolean

Whether automatic width fitting has been applied for the first data batch render.

autoWidthAppliedForEmpty

var autoWidthAppliedForEmpty: Boolean

Whether automatic width fitting has been applied for the empty (header-only) state.

contentMaxWidths

val contentMaxWidths: SnapshotStateMap<C, Dp>

Tracks the maximum measured minimal content width per column across visible rows. Used to auto-fit columns on demand.

headerWidths

val headerWidths: SnapshotStateMap<C, Dp>

Tracks header widths separately. These are preserved during auto-width recalculation and used as base values after reset.

order

val order: SnapshotStateList<C>

Column keys in render order.

widths

val widths: SnapshotStateMap<C, Dp>

Width overrides per column. A missing key falls back to the spec width, then the default.

Functions

fitToContent

fun fitToContent(column: C)

Set the column width override to the tracked maximum minimal content width (if available). No-op if no measured width is present for the column.

move

fun move(fromIndex: Int, toIndex: Int)

Move a column from fromIndex to toIndex within the current order. Indices are validated; dropping after the last element is supported.

recalculateAutoWidths

fun recalculateAutoWidths()

Recalculate auto-widths for columns with autoWidth enabled.

resize

fun resize(column: C, action: ColumnWidthAction)

Apply a width action for a column (set or reset override).

resolveWidth

fun resolveWidth(key: C, spec: ColumnSpec<*, C, *>? = null): Dp

Resolves the effective width for a column given its key and optional spec.

setOrder

fun setOrder(newOrder: List<C>)

Replace current column order with newOrder. Missing keys are ignored; unknown keys appended.

setWidths

fun setWidths(newWidths: Map<C, Dp?>)

Apply external newWidths in bulk. Null width removes the override for that column.

updateMaxContentWidth

fun updateMaxContentWidth(column: C, width: Dp, source: String)

Update the tracked maximum minimal content width for a column. If the provided width is greater than the stored value, it will be recorded.