api/dev.s7a.strata.modifier/onPress

onPress

fun Modifier.onPress(propagation: InputResult, button: PointerButton? = null, action: UiSession.(PointerEvent.Press, IntOffset) -> Unit): Modifier(source)

Subscribes to typed pointer notifications within the modifier's hit region, including local coordinates. propagation is applied immediately; action runs on the screen owner thread, on the hosting server or proxy for remote screens. Only the subscribed event variant and optional button are delivered or transmitted.

fun Modifier.onPress(callback: UiSession.(PointerEvent.Press, IntOffset) -> InputResult): Modifier(source)

Handles every pointer press that hits this modifier's laid-out bounds.

Return

this chain with one appended active press handler.

Parameters

callback

callback receiving the typed event and modifier-local position and deciding propagation.

Throws

Throwable

when callback fails during dispatch.

fun Modifier.onPress(action: UiSession.() -> Unit): Modifier(source)

Runs action for every primary pointer press that hits this modifier and consumes the event. Other button presses remain ignored so lower or earlier handlers can process them.

Return

this chain with one appended consuming press handler.

Parameters

action

synchronous action invoked on the owning tree thread.

Throws

Throwable

when action fails during dispatch.