simvx.core.ui.multiline

MultiLineTextEdit – Multi-line text editor widget with selection, scrollbar, line numbers, cursor blink, undo/redo, and clipboard.

Supports keyboard navigation (including word-wise ctrl+left/right and document-wise ctrl+home/end), mouse click positioning, text selection via shift+arrow keys, vertical scrolling via mouse wheel and scrollbar thumb drag, undo/redo history (ctrl+z, and ctrl+shift+z or ctrl+y to redo), clipboard cut/copy/paste, line comments, and select-word (ctrl+d).

Module Contents

Classes

MultiLineTextEdit

Multi-line text editor with selection, scrolling, and line numbers.

Data

log
__all__

API

simvx.core.ui.multiline.log

‘getLogger(…)’

simvx.core.ui.multiline.__all__

[‘MultiLineTextEdit’]

class simvx.core.ui.multiline.MultiLineTextEdit(text: str = '', **kwargs)

Bases: simvx.core.ui.text_selection.TextSelectionMixin, simvx.core.ui.core.Control

Multi-line text editor with selection, scrolling, and line numbers.

Features: - Multi-line text buffer with cursor navigation, word-wise (ctrl+left, ctrl+right) and document-wise (ctrl+home, ctrl+end) - Text selection via shift+arrow keys, and by holding shift with any of the ctrl motions above - Undo (ctrl+z) and redo (ctrl+shift+z or ctrl+y) - Vertical scrollbar with thumb drag and mouse wheel - Optional line number gutter - Cursor blink animation - Read-only mode

Example: editor = MultiLineTextEdit() editor.text = “Hello\nWorld” editor.text_changed.connect(lambda t: print(“Changed:”, t)) editor.show_line_numbers = True

Initialization

pointer_filter

‘Property(…)’

cursor_shape

‘Property(…)’

text_colour

‘ThemeColour(…)’

bg_colour

‘ThemeColour(…)’

border_colour

‘ThemeColour(…)’

focus_colour

‘ThemeColour(…)’

selection_colour

‘ThemeColour(…)’

line_number_colour

‘ThemeColour(…)’

current_line_colour

‘ThemeColour(…)’

gutter_bg_colour

‘ThemeColour(…)’

font_size

‘Property(…)’

show_line_numbers

‘Property(…)’

read_only

‘Property(…)’

tab_size

‘Property(…)’

size_x

‘Property(…)’

size_y

‘Property(…)’

focus_mode

‘Property(…)’

property wants_text_input: bool

Whether this view takes typing: an editable one does, a read-only one only selects and copies.

property text: str

Get full text content (lines joined with newlines).

property scroll_y: float

How far the view is scrolled, in lines from the top. Assigning it scrolls, clamped to the text.

undo()

Restore the previous text state from the undo stack.

redo()

Re-apply the last undone change from the redo stack.

cut() → None

Cut the selected text to the clipboard, as one undoable step.

insert(text: str) → None

Insert text at the caret, replacing the selection, and move the caret past it.

Typing, a paste and an IME commit all arrive here, whatever their length. Line breaks (\n, \r\n or \r) split the line. The insertion is one undo step and text_changed fires once for it, and not at all for empty text.

apply_text_edits(edits: list[tuple[int, int, int, int, str]])

Apply a batch of text edits atomically.

Each edit is (start_line, start_col, end_line, end_col, new_text). Edits are sorted bottom-to-top, right-to-left so earlier line numbers remain valid as later edits are applied. Records a single undo snapshot for the entire batch and emits text_changed once.

select_all()

Select the entire text buffer.

toggle_comment()

Toggle Python # comment on current line or selected lines.

Preserves indentation: comments are inserted at the minimum indentation level of the affected non-blank lines (VS Code-style).

delete_line()

Delete the current line (or all selected lines).

duplicate_line()

Duplicate the current line or all selected lines below.

move_line_up()

Move the current line (or selected lines) up one position.

move_line_down()

Move the current line (or selected lines) down one position.

select_word()

Select the word at cursor, or the next occurrence of the current selection.

on_gui_input(event)

on_update(dt: float)

Update cursor blink timer.

on_draw(renderer)

copy() → None

paste() → None

min_size_x

‘Property(…)’

min_size_y

‘Property(…)’

anchor_left

‘Property(…)’

anchor_top

‘Property(…)’

anchor_right

‘Property(…)’

anchor_bottom

‘Property(…)’

margin_left

‘Property(…)’

margin_top

‘Property(…)’

margin_right

‘Property(…)’

margin_bottom

‘Property(…)’

anchor

‘Property(…)’

inset

‘Property(…)’

dismiss_on_outside_click

‘Property(…)’

clip_contents

‘Property(…)’

tooltip

‘Property(…)’

pointer_types: frozenset[simvx.core.input.enums.PointerType] | None

None

touch_target: bool

False

size_flags_horizontal

‘Property(…)’

size_flags_vertical

‘Property(…)’

stretch_ratio

‘Property(…)’

max_size

‘Property(…)’

property size: simvx.core.math.types.Vec2

property min_size: simvx.core.math.types.Vec2

content_signature() → object

content_uses(chars: str) → bool

autosize_to_content() → None

accepts_pointers

‘Property(…)’

property theme: simvx.core.ui.types.Theme | None

property mouse_over: bool

property disabled: bool

get_theme() → simvx.core.ui.types.Theme

property viewport_size: simvx.core.math.types.Vec2

property viewport_insets: tuple[float, float, float, float]

queue_redraw()

size_floor() → tuple[float, float]

get_minimum_size() → simvx.core.math.types.Vec2

add_child(node: simvx.core.node.T) → simvx.core.node.T

get_rect() → tuple[float, float, float, float]

get_global_rect() → tuple[float, float, float, float]

property focus_rect: tuple[float, float, float, float] | None

is_point_inside(point) → bool

is_hit(event: simvx.core.input.events.PointerEvent) → bool

classmethod __init_subclass__(**kwargs)

activate() → bool

focus_next_control()

focus_previous_control()

set_drag_preview(control: simvx.core.ui.core.Control)

property is_overlay_open: bool

show_overlay(modality: str = 'light', *, dim: bool | None = None, dismiss: bool | None = None, inert: bool | None = None, owner: simvx.core.ui.core.Control | None = None, initial_focus: simvx.core.ui.core.Control | None = None) → None

close_overlay() → None

position

‘_SpatialVecProperty(…)’

rotation

‘Property(…)’

scale

‘_SpatialVecProperty(…)’

top_level

‘Property(…)’

z_index

‘Property(…)’

z_as_relative

‘Property(…)’

render_layer

‘Property(…)’

set_render_layer(index: int, enabled: bool = True) → None

is_on_render_layer(index: int) → bool

property absolute_z_index: int

property rotation_degrees: float

property world_position: simvx.core.math.types.Vec2

property world_rotation: float

property world_scale: simvx.core.math.types.Vec2

property world_transform: tuple[simvx.core.math.types.Vec2, simvx.core.math.types.Vec2, float]

property forward: simvx.core.math.types.Vec2

property right: simvx.core.math.types.Vec2

translate(offset: tuple[float, float] | numpy.ndarray)

rotate(radians: float)

rotate_deg(degrees: float)

look_at(target: tuple[float, float] | numpy.ndarray)

to_global(point) → simvx.core.math.types.Vec2

to_local(point) → simvx.core.math.types.Vec2

transform_points(points: list[simvx.core.math.types.Vec2]) → list[simvx.core.math.types.Vec2]

wrap_screen(margin: float = 20)

post_processed

‘Property(…)’

property transform_render_dirty: bool

strict_errors: ClassVar[bool]

True

dev_checks: ClassVar[bool]

None

dev_warnings: ClassVar[bool]

None

freeze_check_interval: ClassVar[float]

1.0

dynamic: bool

False

visible

‘Property(…)’

update_mode

‘Property(…)’

drag_threshold

‘Property(…)’

focus_entered

‘Signal(…)’

focus_exited

‘Signal(…)’

__properties__: ClassVar[dict[str, simvx.core.descriptors.Property]]

None

property name: str

property visible_in_tree: bool

property input_player: simvx.core.input.players.InputPlayer

property input_context: simvx.core.input.contexts.InputContext | None

reset_error() → None

remove_child(node: simvx.core.node.Node) → None

reparent(new_parent: simvx.core.node.Node)

node_at(path, default=_NO_DEFAULT)

find(target, *, direct: bool = False)

find_all(target, *, direct: bool = False)

expect(target, *, direct: bool = False)

ancestor(target)

walk(*, include_self: bool = True) → collections.abc.Iterator[simvx.core.node.Node]

property path: str

property is_scene_root: bool

add_to_group(group: str)

remove_from_group(group: str)

is_in_group(group: str) → bool

on_ready() → None

on_enter_tree() → None

on_exit_tree() → None

on_fixed_update(dt: float) → None

on_draw_3d(gizmos) → None

on_picked(event: simvx.core.input.events.PickEvent) → bool | None

start_coroutine(gen: simvx.core.descriptors.Coroutine) → simvx.core.descriptors.CoroutineHandle

stop_coroutine(gen_or_handle)

property focused: bool

drag_threshold_for(pointer_type: simvx.core.input.enums.PointerType | str) → float

grab_focus() → None

release_focus() → None

capture_pointer(pointer_id: int | None = None) → None

release_pointer(pointer_id: int | None = None) → None

property render_dirty: bool

clear_children()

destroy()

property destroying: bool

property destroyed: bool

call_deferred(method: collections.abc.Callable[..., Any], *args: Any) → None

property app

property tree: simvx.core.scene_tree.SceneTree

property physics

property physics_2d

__getitem__(key: str)

classmethod get_properties() → dict[str, simvx.core.descriptors.Property]

__repr__()