dispatchTextInput

Dispatches event to the currently focused logical component.

An empty tree or a tree without focus returns InputResult.Ignored. A non-empty tree must have completed layout with no pending geometry work. Focused component and modifier nodes run from the component node toward outer modifiers until one consumes the event.

Return

consumed when focused behavior handles the event, otherwise ignored.

Parameters

event

immutable committed-character or preedit event.

Throws

when layout is incomplete, the call is from another execution owner, another operation is active, or the tree is not active.

when focused behavior fails; the original throwable escapes unchanged after cleanup attempts.