ketraterm-ui-swing/io.github.ketraterm.ui.swing.api/CellSelection

CellSelection

data class CellSelection(val anchorColumn: Int, val anchorRow: Int, val caretColumn: Int, val caretRow: Int, val isBlock: Boolean = false)

Half-open terminal cell selection in visible render-cache coordinates.

anchorColumn and anchorRow identify the fixed selection edge. caretColumn and caretRow identify the moving edge and may be before the anchor for backward selections. Columns are caret positions between cells, so selecting cells 2 through 4 on one row is represented as columns 2..5. Linear selections use logical columns in stored text order. Block selections use visual columns and the same horizontal interval on every selected row; copying a block maps its cells back to logical order independently per row.

Constructors

CellSelection

constructor(anchorColumn: Int, anchorRow: Int, caretColumn: Int, caretRow: Int, isBlock: Boolean = false)

Types

Companion

object Companion

Properties

anchorColumn

val anchorColumn: Int

zero-based anchor caret column.

anchorRow

val anchorRow: Int

zero-based anchor row.

caretColumn

val caretColumn: Int

zero-based moving caret column.

caretRow

val caretRow: Int

zero-based moving row.

endColumn

val endColumn: Int

End-exclusive logical caret column on endRow, or the right visual edge of a block.

endRow

val endRow: Int

Last selected row after normalizing anchor and caret order.

isBlock

val isBlock: Boolean

whether the selection is a rectangular block selection.

isEmpty

val isEmpty: Boolean

Returns true when the selection covers no cells.

startColumn

val startColumn: Int

First logical caret column on startRow, or the left visual edge of a block.

startRow

val startRow: Int

First selected row after normalizing anchor and caret order.

Functions

packedColumnRange

fun packedColumnRange(row: Int, columns: Int, cache: TerminalRenderCache? = null): Long

Returns the selected half-open column range for row, packed as start shl 32 | end, or NO_RANGE when row is outside the selection. The range uses logical columns for linear selections and visual columns for blocks. A block's visual bounds do not depend on the row's bidi order.