simvx.core.ui.multiline

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

Supports keyboard navigation, mouse click positioning, text selection via shift+arrow keys, vertical scrolling via mouse wheel and scrollbar thumb drag, undo/redo history, 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.core.Control

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

Features: - Multi-line text buffer with cursor navigation - Text selection via shift+arrow keys - 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

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(…)’

property text: str

Get full text content (lines joined with newlines).

undo()

Restore the previous text state from the undo stack.

redo()

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

copy()

Copy selected text to clipboard.

cut()

Cut selected text to clipboard.

paste()

Paste clipboard text at cursor, replacing selection if any.

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.

process(dt: float)

Update cursor blink timer.

draw(renderer)

size_x

‘Property(…)’

size_y

‘Property(…)’

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

touch_mode: str

‘mouse’

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

property mouse_over: bool

property focused: bool

property disabled: bool

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

queue_redraw()

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

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

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

is_point_inside(point) → bool

set_anchor_preset(preset: simvx.core.ui.enums.AnchorPreset)

set_focus()

grab_focus()

release_focus()

has_focus() → bool

focus_next_control()

focus_previous_control()

grab_mouse()

release_mouse()

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

draw_popup(renderer)

is_popup_point_inside(point) → bool

popup_input(event)

dismiss_popup()

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 position: simvx.core.math.types.Vec2

property rotation: float

property rotation_degrees: float

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

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

property world_rotation: float

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

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)

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

draw_polygon(renderer, points: list[simvx.core.math.types.Vec2], closed=True, colour=None)

wrap_screen(margin: float = 20)

strict_errors: ClassVar[bool]

True

script_error_raised

‘Signal(…)’

classmethod __init_subclass__(**kwargs)

property name: str

property process_mode: simvx.core.descriptors.ProcessMode

reset_error() → None

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

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

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

get_node(path: str) → simvx.core.node.Node

find_child(name: str, recursive: bool = False) → simvx.core.node.Node | None

find(node_type: type, recursive: bool = True) → simvx.core.node.Node | None

find_all(node_type: type, recursive: bool = True) → list

property path: str

add_to_group(group: str)

remove_from_group(group: str)

is_in_group(group: str) → bool

ready() → None

enter_tree() → None

exit_tree() → None

physics_process(dt: float) → None

input_event(event: simvx.core.events.InputEvent) → None

input(event: simvx.core.events.TreeInputEvent) → None

unhandled_input(event: simvx.core.events.TreeInputEvent) → None

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

stop_coroutine(gen_or_handle)

clear_children()

destroy()

property app

property tree: simvx.core.scene_tree.SceneTree

get_tree() → simvx.core.scene_tree.SceneTree

__getitem__(key: str)

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

__repr__()