nativeSheet

inline fun <T> nativeSheet(crossinline block: (T) -> Unit)

Provides access to the underlying native sheet object.

Streaming Engine Caution: Streaming engines (POI SXSSF, FastExcel) flush rows to disk periodically to save memory. Once a row is flushed, it cannot be modified using the native object.

Safe Patterns: - Call BEFORE adding rows for: Freeze panes, sheet protection, zoom level, print setup. - Call AFTER adding rows for: Auto filters (works on sheet metadata).

Unsafe Patterns: - Attempting to modify or read rows that have already been flushed.

Parameters

block

the callback receiving the native sheet

Type Parameters

T

the expected native sheet type