Single-line text input field with optional label.
Supports placeholder text, max length, and focus management.
_properties: Dict[str, Dict[str, Any]] = {**UIElement._properties, 'text': {'name': 'text', 'key': 'text', 'type': str, 'editable': True, 'description': 'Current text content.'}, 'placeholder_text': {'name': 'placeholder', 'key': 'placeholder_text', 'type': str, 'editable': True, 'description': 'Text shown when empty.'}, 'font_size': {'name': 'font size', 'key': 'font_size', 'type': int, 'editable': True, 'description': 'Font size in pixels.'}, 'max_length': {'name': 'max length', 'key': 'max_length', 'type': int, 'editable': True, 'description': 'Maximum characters allowed (0 = unlimited).'}, 'focused': {'name': 'focused', 'key': 'focused', 'type': bool, 'editable': False, 'description': 'Whether the text box has keyboard focus.'}, 'label': {'name': 'label', 'key': 'label', 'type': str, 'editable': True, 'description': 'Label text displayed next to or above the input.'}, 'label_position': {'name': 'label position', 'key': 'label_position', 'type': str, 'editable': True, 'description': '"left" or "top".', 'options': ['left', 'top']}, 'label_size': {'name': 'label size', 'key': 'label_size', 'type': int, 'editable': True, 'description': 'Font size of the label (0 = auto).'}}
def __init__(self: Any, x: int, y: int, width: int, height: int, text: str = '', font_size: int = 20, font_name: Optional[str] = None, pivot: Tuple[float, float] = (0, 0), theme: Optional[ThemeType] = None, max_length: int = 0, element_id: Optional[str] = None, label: Optional[str] = None, label_position: Literal['left', 'top'] = 'left', label_size: Optional[int] = None, **kwargs: dict) -> None
def _get_init_args(self: Any) -> Dict[str, Any]
def set_on_text_changed(self: Any, callback: Callable[[str], None]) -> None
def font(self: Any) -> pygame.font.Font
def placeholder_font(self: Any) -> pygame.font.Font
def label_font(self: Any) -> pygame.font.Font
def _update_layout(self: Any) -> None
def get_text(self: Any) -> str
def has_focus(self: Any) -> bool
def set_text(self: Any, text: str) -> None
def _update_text_surface(self: Any) -> None
def _get_text_color(self: Any) -> Tuple[int, int, int]
def _get_placeholder_color(self: Any) -> Tuple[int, int, int, int]
def _get_background_color(self: Any) -> Tuple[int, int, int]
def on_key_down(self: Any, event: pygame.event.Event) -> None
def on_key_up(self: Any, event: pygame.event.Event) -> None
def update(self: Any, dt: float, inputState: InputState) -> None
def focus(self: Any) -> None
def unfocus(self: Any) -> None
def render(self: Any, renderer: Renderer) -> None
def _render_text_content(self: Any, renderer: Renderer, input_abs_x: int, input_abs_y: int, theme: Any) -> None
def _get_cursor_position(self: Any, input_abs_x: int, input_abs_y: int) -> Tuple[int, int]
def update_theme(self: Any, theme_type: ThemeType) -> None
Multi-line text input area with word wrapping and scrollbars.
Supports text editing, selection, copy/paste, and line numbers.
_properties: Dict[str, Dict[str, Any]] = {**UIElement._properties, 'text': {'name': 'text', 'key': 'text', 'type': str, 'editable': True, 'description': 'The text content.'}, 'line_numbers': {'name': 'line numbers', 'key': 'line_numbers', 'type': bool, 'editable': True, 'description': 'Show line numbers on the left.'}, 'word_wrap': {'name': 'word wrap', 'key': 'word_wrap', 'type': bool, 'editable': True, 'description': 'Automatically wrap long lines.'}, 'read_only': {'name': 'read only', 'key': 'read_only', 'type': bool, 'editable': True, 'description': 'If True, text cannot be edited.'}, 'tab_size': {'name': 'tab size', 'key': 'tab_size', 'type': int, 'editable': True, 'description': 'Number of spaces per tab.'}}
def __init__(self: Any, x: int, y: int, width: int, height: int, text: str = '', font_size: int = 16, font_name: Optional[str] = None, line_numbers: bool = True, word_wrap: bool = True, read_only: bool = False, tab_size: int = 4, pivot: Tuple[float, float] = (0, 0), theme: Optional[ThemeType] = None, element_id: Optional[str] = None) -> None
def line_height(self: Any) -> int
def font(self: Any) -> pygame.font.Font
def _get_init_args(self: Any) -> Dict[str, Any]
def get_text(self: Any) -> str
def set_text(self: Any, text: str) -> None
def _update_dimensions(self: Any) -> None
def _update_text_buffer(self: Any) -> None
def _save_to_undo_stack(self: Any) -> None
def undo(self: Any) -> None
def redo(self: Any) -> None
def _get_visible_lines(self: Any) -> List[int]
def _get_text_width(self: Any, text: str) -> int
def _get_char_width_at_position(self: Any, line: str, col: int) -> int
def _get_cursor_screen_pos(self: Any) -> Tuple[int, int]
def _scroll_to_cursor(self: Any) -> None
def _insert_text(self: Any, text: str) -> None
def _delete_selection(self: Any) -> None
def _get_selection_text(self: Any) -> str
def copy(self: Any) -> None
def cut(self: Any) -> None
def paste(self: Any) -> None
def select_all(self: Any) -> None
def _move_cursor(self: Any, line_delta: int, column_delta: int, extend_selection: bool = False) -> None
def update(self: Any, dt: float, inputState: InputState) -> None
def on_key_down(self: Any, event: pygame.event.Event) -> None
def on_key_up(self: Any, event: pygame.event.Event) -> None
def _get_cursor_from_mouse(self: Any, mouse_pos: Tuple[int, int]) -> Tuple[int, int]
def _handle_key_event(self: Any, event: pygame.event.Event) -> None
def render(self: Any, renderer: Renderer) -> None
def _draw_selection_highlight(self: Any, renderer: Renderer, ax: int, ay: int, line_num: int, line_y: int) -> None