:github_url: hide .. meta:: :keywords: textarea .. DO NOT EDIT THIS FILE!!! .. Generated automatically from Godot engine sources. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/TextEdit.xml. .. _class_TextEdit: TextEdit ======== **Inherits:** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` **Inherited By:** :ref:`CodeEdit` A multiline text editor. .. rst-class:: classref-introduction-group Description ----------- A multiline text editor. It also has limited facilities for editing code, such as syntax highlighting support. For more advanced facilities for editing code, see :ref:`CodeEdit`. \ **Note:** Most viewport, caret, and edit methods contain a ``caret_index`` argument for :ref:`caret_multiple` support. The argument should be one of the following: ``-1`` for all carets, ``0`` for the main caret, or greater than ``0`` for secondary carets in the order they were created. \ **Note:** When holding down :kbd:`Alt`, the vertical scroll wheel will scroll 5 times as fast as it would normally do. This also works in the Godot script editor. .. rst-class:: classref-reftable-group Properties ---------- .. table:: :widths: auto +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`AutowrapMode` | :ref:`autowrap_mode` | ``3`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_blink` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`caret_blink_interval` | ``0.65`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_draw_when_editable_disabled` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_mid_grapheme` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_move_on_right_click` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_multiple` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`CaretType` | :ref:`caret_type` | ``0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | clip_contents | ``true`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`context_menu_enabled` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`custom_word_separators` | ``""`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`deselect_on_focus_loss_enabled` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`drag_and_drop_selection_enabled` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`draw_control_chars` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`draw_spaces` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`draw_tabs` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`editable` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`empty_selection_clipboard_enabled` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`FocusMode` | focus_mode | ``2`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`highlight_all_occurrences` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`highlight_current_line` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`indent_wrapped_lines` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`language` | ``""`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`middle_mouse_paste_enabled` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`minimap_draw` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`minimap_width` | ``80`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`CursorShape` | mouse_default_cursor_shape | ``1`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`placeholder_text` | ``""`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`scroll_fit_content_height` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`scroll_fit_content_width` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`scroll_horizontal` | ``0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`scroll_past_end_of_file` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`scroll_smooth` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`scroll_v_scroll_speed` | ``80.0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`scroll_vertical` | ``0.0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`selecting_enabled` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shortcut_keys_enabled` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`StructuredTextParser` | :ref:`structured_text_bidi_override` | ``0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`Array` | :ref:`structured_text_bidi_override_options` | ``[]`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`SyntaxHighlighter` | :ref:`syntax_highlighter` | | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`text` | ``""`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`TextDirection` | :ref:`text_direction` | ``0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`use_custom_word_separators` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`use_default_word_separators` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`virtual_keyboard_enabled` | ``true`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`LineWrappingMode` | :ref:`wrap_mode` | ``0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Methods ------- .. table:: :widths: auto +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_backspace`\ (\ caret_index\: :ref:`int`\ ) |virtual| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_copy`\ (\ caret_index\: :ref:`int`\ ) |virtual| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_cut`\ (\ caret_index\: :ref:`int`\ ) |virtual| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_handle_unicode_input`\ (\ unicode_char\: :ref:`int`, caret_index\: :ref:`int`\ ) |virtual| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_paste`\ (\ caret_index\: :ref:`int`\ ) |virtual| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_paste_primary_clipboard`\ (\ caret_index\: :ref:`int`\ ) |virtual| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`add_caret`\ (\ line\: :ref:`int`, column\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_caret_at_carets`\ (\ below\: :ref:`bool`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_gutter`\ (\ at\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_selection_for_next_occurrence`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`adjust_carets_after_edit`\ (\ caret\: :ref:`int`, from_line\: :ref:`int`, from_col\: :ref:`int`, to_line\: :ref:`int`, to_col\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`adjust_viewport_to_caret`\ (\ caret_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`apply_ime`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`backspace`\ (\ caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`begin_complex_operation`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`begin_multicaret_edit`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`cancel_ime`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`center_viewport_to_caret`\ (\ caret_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear_undo_history`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`collapse_carets`\ (\ from_line\: :ref:`int`, from_column\: :ref:`int`, to_line\: :ref:`int`, to_column\: :ref:`int`, inclusive\: :ref:`bool` = false\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`copy`\ (\ caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`cut`\ (\ caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`delete_selection`\ (\ caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`deselect`\ (\ caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`end_action`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`end_complex_operation`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`end_multicaret_edit`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_caret_column`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_caret_count`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_caret_draw_pos`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`get_caret_index_edit_order`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_caret_line`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_caret_wrap_index`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_first_non_whitespace_column`\ (\ line\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_first_visible_line`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_gutter_count`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_gutter_name`\ (\ gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`GutterType` | :ref:`get_gutter_type`\ (\ gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_gutter_width`\ (\ gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`HScrollBar` | :ref:`get_h_scroll_bar`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_indent_level`\ (\ line\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_last_full_visible_line`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_last_full_visible_line_wrap_index`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_last_unhidden_line`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_line`\ (\ line\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`get_line_background_color`\ (\ line\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_line_column_at_pos`\ (\ position\: :ref:`Vector2i`, allow_out_of_bounds\: :ref:`bool` = true\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_line_count`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Texture2D` | :ref:`get_line_gutter_icon`\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`get_line_gutter_item_color`\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`get_line_gutter_metadata`\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_line_gutter_text`\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_line_height`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Array`\[:ref:`Vector2i`\] | :ref:`get_line_ranges_from_carets`\ (\ only_selections\: :ref:`bool` = false, merge_adjacent\: :ref:`bool` = true\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_line_width`\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = -1\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_line_wrap_count`\ (\ line\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_line_wrap_index_at_column`\ (\ line\: :ref:`int`, column\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedStringArray` | :ref:`get_line_wrapped_text`\ (\ line\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_local_mouse_pos`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PopupMenu` | :ref:`get_menu`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_minimap_line_at_pos`\ (\ position\: :ref:`Vector2i`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_minimap_visible_lines`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_next_visible_line_index_offset_from`\ (\ line\: :ref:`int`, wrap_index\: :ref:`int`, visible_amount\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_next_visible_line_offset_from`\ (\ line\: :ref:`int`, visible_amount\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_pos_at_line_column`\ (\ line\: :ref:`int`, column\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Rect2i` | :ref:`get_rect_at_line_column`\ (\ line\: :ref:`int`, column\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_saved_version`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_scroll_pos_for_line`\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_selected_text`\ (\ caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_at_line_column`\ (\ line\: :ref:`int`, column\: :ref:`int`, include_edges\: :ref:`bool` = true, only_selections\: :ref:`bool` = true\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_column`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_from_column`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_from_line`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_line`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`SelectionMode` | :ref:`get_selection_mode`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_origin_column`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_origin_line`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_to_column`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_to_line`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`get_sorted_carets`\ (\ include_ignored_carets\: :ref:`bool` = false\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_tab_size`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_total_gutter_width`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_total_visible_line_count`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`VScrollBar` | :ref:`get_v_scroll_bar`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_version`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_visible_line_count`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_visible_line_count_in_range`\ (\ from_line\: :ref:`int`, to_line\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_word_at_pos`\ (\ position\: :ref:`Vector2`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_word_under_caret`\ (\ caret_index\: :ref:`int` = -1\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_ime_text`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_redo`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_selection`\ (\ caret_index\: :ref:`int` = -1\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_undo`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`insert_line_at`\ (\ line\: :ref:`int`, text\: :ref:`String`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`insert_text`\ (\ text\: :ref:`String`, line\: :ref:`int`, column\: :ref:`int`, before_selection_begin\: :ref:`bool` = true, before_selection_end\: :ref:`bool` = false\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`insert_text_at_caret`\ (\ text\: :ref:`String`, caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_caret_after_selection_origin`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_caret_visible`\ (\ caret_index\: :ref:`int` = 0\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_dragging_cursor`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_gutter_clickable`\ (\ gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_gutter_drawn`\ (\ gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_gutter_overwritable`\ (\ gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_in_mulitcaret_edit`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_line_gutter_clickable`\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_line_wrapped`\ (\ line\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_menu_visible`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_mouse_over_selection`\ (\ edges\: :ref:`bool`, caret_index\: :ref:`int` = -1\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_overtype_mode_enabled`\ (\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`menu_option`\ (\ option\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`merge_gutters`\ (\ from_line\: :ref:`int`, to_line\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`merge_overlapping_carets`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`multicaret_edit_ignore_caret`\ (\ caret_index\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`paste`\ (\ caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`paste_primary_clipboard`\ (\ caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`redo`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_caret`\ (\ caret\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_gutter`\ (\ gutter\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_line_at`\ (\ line\: :ref:`int`, move_carets_down\: :ref:`bool` = true\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_secondary_carets`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_text`\ (\ from_line\: :ref:`int`, from_column\: :ref:`int`, to_line\: :ref:`int`, to_column\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`search`\ (\ text\: :ref:`String`, flags\: :ref:`int`, from_line\: :ref:`int`, from_column\: :ref:`int`\ ) |const| | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`select`\ (\ origin_line\: :ref:`int`, origin_column\: :ref:`int`, caret_line\: :ref:`int`, caret_column\: :ref:`int`, caret_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`select_all`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`select_word_under_caret`\ (\ caret_index\: :ref:`int` = -1\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_caret_column`\ (\ column\: :ref:`int`, adjust_viewport\: :ref:`bool` = true, caret_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_caret_line`\ (\ line\: :ref:`int`, adjust_viewport\: :ref:`bool` = true, can_be_hidden\: :ref:`bool` = true, wrap_index\: :ref:`int` = 0, caret_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_gutter_clickable`\ (\ gutter\: :ref:`int`, clickable\: :ref:`bool`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_gutter_custom_draw`\ (\ column\: :ref:`int`, draw_callback\: :ref:`Callable`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_gutter_draw`\ (\ gutter\: :ref:`int`, draw\: :ref:`bool`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_gutter_name`\ (\ gutter\: :ref:`int`, name\: :ref:`String`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_gutter_overwritable`\ (\ gutter\: :ref:`int`, overwritable\: :ref:`bool`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_gutter_type`\ (\ gutter\: :ref:`int`, type\: :ref:`GutterType`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_gutter_width`\ (\ gutter\: :ref:`int`, width\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line`\ (\ line\: :ref:`int`, new_text\: :ref:`String`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line_as_center_visible`\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line_as_first_visible`\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line_as_last_visible`\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line_background_color`\ (\ line\: :ref:`int`, color\: :ref:`Color`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line_gutter_clickable`\ (\ line\: :ref:`int`, gutter\: :ref:`int`, clickable\: :ref:`bool`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line_gutter_icon`\ (\ line\: :ref:`int`, gutter\: :ref:`int`, icon\: :ref:`Texture2D`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line_gutter_item_color`\ (\ line\: :ref:`int`, gutter\: :ref:`int`, color\: :ref:`Color`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line_gutter_metadata`\ (\ line\: :ref:`int`, gutter\: :ref:`int`, metadata\: :ref:`Variant`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_line_gutter_text`\ (\ line\: :ref:`int`, gutter\: :ref:`int`, text\: :ref:`String`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_overtype_mode_enabled`\ (\ enabled\: :ref:`bool`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_search_flags`\ (\ flags\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_search_text`\ (\ search_text\: :ref:`String`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_selection_mode`\ (\ mode\: :ref:`SelectionMode`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_selection_origin_column`\ (\ column\: :ref:`int`, caret_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_selection_origin_line`\ (\ line\: :ref:`int`, can_be_hidden\: :ref:`bool` = true, wrap_index\: :ref:`int` = -1, caret_index\: :ref:`int` = 0\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_tab_size`\ (\ size\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_tooltip_request_func`\ (\ callback\: :ref:`Callable`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`skip_selection_for_next_occurrence`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`start_action`\ (\ action\: :ref:`EditAction`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`swap_lines`\ (\ from_line\: :ref:`int`, to_line\: :ref:`int`\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`tag_saved_version`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`undo`\ (\ ) | +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Theme Properties ---------------- .. table:: :widths: auto +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`background_color` | ``Color(0, 0, 0, 0)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`caret_background_color` | ``Color(0, 0, 0, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`caret_color` | ``Color(0.875, 0.875, 0.875, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`current_line_color` | ``Color(0.25, 0.25, 0.26, 0.8)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_color` | ``Color(0.875, 0.875, 0.875, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_outline_color` | ``Color(0, 0, 0, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_placeholder_color` | ``Color(0.875, 0.875, 0.875, 0.6)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_readonly_color` | ``Color(0.875, 0.875, 0.875, 0.5)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_selected_color` | ``Color(0, 0, 0, 0)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`search_result_border_color` | ``Color(0.3, 0.3, 0.3, 0.4)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`search_result_color` | ``Color(0.3, 0.3, 0.3, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`selection_color` | ``Color(0.5, 0.5, 0.5, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`word_highlighted_color` | ``Color(0.5, 0.5, 0.5, 0.25)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`caret_width` | ``1`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`line_spacing` | ``4`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`outline_size` | ``0`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Font` | :ref:`font` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`font_size` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Texture2D` | :ref:`space` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Texture2D` | :ref:`tab` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`focus` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`normal` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`read_only` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Signals ------- .. _class_TextEdit_signal_caret_changed: .. rst-class:: classref-signal **caret_changed**\ (\ ) :ref:`🔗` Emitted when any caret changes position. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_signal_gutter_added: .. rst-class:: classref-signal **gutter_added**\ (\ ) :ref:`🔗` Emitted when a gutter is added. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_signal_gutter_clicked: .. rst-class:: classref-signal **gutter_clicked**\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) :ref:`🔗` Emitted when a gutter is clicked. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_signal_gutter_removed: .. rst-class:: classref-signal **gutter_removed**\ (\ ) :ref:`🔗` Emitted when a gutter is removed. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_signal_lines_edited_from: .. rst-class:: classref-signal **lines_edited_from**\ (\ from_line\: :ref:`int`, to_line\: :ref:`int`\ ) :ref:`🔗` Emitted immediately when the text changes. When text is added ``from_line`` will be less than ``to_line``. On a remove ``to_line`` will be less than ``from_line``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_signal_text_changed: .. rst-class:: classref-signal **text_changed**\ (\ ) :ref:`🔗` Emitted when the text changes. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_signal_text_set: .. rst-class:: classref-signal **text_set**\ (\ ) :ref:`🔗` Emitted when :ref:`clear` is called or :ref:`text` is set. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Enumerations ------------ .. _enum_TextEdit_MenuItems: .. rst-class:: classref-enumeration enum **MenuItems**: :ref:`🔗` .. _class_TextEdit_constant_MENU_CUT: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_CUT** = ``0`` Cuts (copies and clears) the selected text. .. _class_TextEdit_constant_MENU_COPY: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_COPY** = ``1`` Copies the selected text. .. _class_TextEdit_constant_MENU_PASTE: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_PASTE** = ``2`` Pastes the clipboard text over the selected text (or at the cursor's position). .. _class_TextEdit_constant_MENU_CLEAR: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_CLEAR** = ``3`` Erases the whole **TextEdit** text. .. _class_TextEdit_constant_MENU_SELECT_ALL: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_SELECT_ALL** = ``4`` Selects the whole **TextEdit** text. .. _class_TextEdit_constant_MENU_UNDO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_UNDO** = ``5`` Undoes the previous action. .. _class_TextEdit_constant_MENU_REDO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_REDO** = ``6`` Redoes the previous action. .. _class_TextEdit_constant_MENU_SUBMENU_TEXT_DIR: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_SUBMENU_TEXT_DIR** = ``7`` ID of "Text Writing Direction" submenu. .. _class_TextEdit_constant_MENU_DIR_INHERITED: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DIR_INHERITED** = ``8`` Sets text direction to inherited. .. _class_TextEdit_constant_MENU_DIR_AUTO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DIR_AUTO** = ``9`` Sets text direction to automatic. .. _class_TextEdit_constant_MENU_DIR_LTR: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DIR_LTR** = ``10`` Sets text direction to left-to-right. .. _class_TextEdit_constant_MENU_DIR_RTL: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DIR_RTL** = ``11`` Sets text direction to right-to-left. .. _class_TextEdit_constant_MENU_DISPLAY_UCC: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_DISPLAY_UCC** = ``12`` Toggles control character display. .. _class_TextEdit_constant_MENU_SUBMENU_INSERT_UCC: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_SUBMENU_INSERT_UCC** = ``13`` ID of "Insert Control Character" submenu. .. _class_TextEdit_constant_MENU_INSERT_LRM: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_LRM** = ``14`` Inserts left-to-right mark (LRM) character. .. _class_TextEdit_constant_MENU_INSERT_RLM: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_RLM** = ``15`` Inserts right-to-left mark (RLM) character. .. _class_TextEdit_constant_MENU_INSERT_LRE: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_LRE** = ``16`` Inserts start of left-to-right embedding (LRE) character. .. _class_TextEdit_constant_MENU_INSERT_RLE: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_RLE** = ``17`` Inserts start of right-to-left embedding (RLE) character. .. _class_TextEdit_constant_MENU_INSERT_LRO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_LRO** = ``18`` Inserts start of left-to-right override (LRO) character. .. _class_TextEdit_constant_MENU_INSERT_RLO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_RLO** = ``19`` Inserts start of right-to-left override (RLO) character. .. _class_TextEdit_constant_MENU_INSERT_PDF: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_PDF** = ``20`` Inserts pop direction formatting (PDF) character. .. _class_TextEdit_constant_MENU_INSERT_ALM: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_ALM** = ``21`` Inserts Arabic letter mark (ALM) character. .. _class_TextEdit_constant_MENU_INSERT_LRI: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_LRI** = ``22`` Inserts left-to-right isolate (LRI) character. .. _class_TextEdit_constant_MENU_INSERT_RLI: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_RLI** = ``23`` Inserts right-to-left isolate (RLI) character. .. _class_TextEdit_constant_MENU_INSERT_FSI: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_FSI** = ``24`` Inserts first strong isolate (FSI) character. .. _class_TextEdit_constant_MENU_INSERT_PDI: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_PDI** = ``25`` Inserts pop direction isolate (PDI) character. .. _class_TextEdit_constant_MENU_INSERT_ZWJ: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_ZWJ** = ``26`` Inserts zero width joiner (ZWJ) character. .. _class_TextEdit_constant_MENU_INSERT_ZWNJ: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_ZWNJ** = ``27`` Inserts zero width non-joiner (ZWNJ) character. .. _class_TextEdit_constant_MENU_INSERT_WJ: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_WJ** = ``28`` Inserts word joiner (WJ) character. .. _class_TextEdit_constant_MENU_INSERT_SHY: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_INSERT_SHY** = ``29`` Inserts soft hyphen (SHY) character. .. _class_TextEdit_constant_MENU_MAX: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_MAX** = ``30`` Represents the size of the :ref:`MenuItems` enum. .. rst-class:: classref-item-separator ---- .. _enum_TextEdit_EditAction: .. rst-class:: classref-enumeration enum **EditAction**: :ref:`🔗` .. _class_TextEdit_constant_ACTION_NONE: .. rst-class:: classref-enumeration-constant :ref:`EditAction` **ACTION_NONE** = ``0`` No current action. .. _class_TextEdit_constant_ACTION_TYPING: .. rst-class:: classref-enumeration-constant :ref:`EditAction` **ACTION_TYPING** = ``1`` A typing action. .. _class_TextEdit_constant_ACTION_BACKSPACE: .. rst-class:: classref-enumeration-constant :ref:`EditAction` **ACTION_BACKSPACE** = ``2`` A backwards delete action. .. _class_TextEdit_constant_ACTION_DELETE: .. rst-class:: classref-enumeration-constant :ref:`EditAction` **ACTION_DELETE** = ``3`` A forward delete action. .. rst-class:: classref-item-separator ---- .. _enum_TextEdit_SearchFlags: .. rst-class:: classref-enumeration enum **SearchFlags**: :ref:`🔗` .. _class_TextEdit_constant_SEARCH_MATCH_CASE: .. rst-class:: classref-enumeration-constant :ref:`SearchFlags` **SEARCH_MATCH_CASE** = ``1`` Match case when searching. .. _class_TextEdit_constant_SEARCH_WHOLE_WORDS: .. rst-class:: classref-enumeration-constant :ref:`SearchFlags` **SEARCH_WHOLE_WORDS** = ``2`` Match whole words when searching. .. _class_TextEdit_constant_SEARCH_BACKWARDS: .. rst-class:: classref-enumeration-constant :ref:`SearchFlags` **SEARCH_BACKWARDS** = ``4`` Search from end to beginning. .. rst-class:: classref-item-separator ---- .. _enum_TextEdit_CaretType: .. rst-class:: classref-enumeration enum **CaretType**: :ref:`🔗` .. _class_TextEdit_constant_CARET_TYPE_LINE: .. rst-class:: classref-enumeration-constant :ref:`CaretType` **CARET_TYPE_LINE** = ``0`` Vertical line caret. .. _class_TextEdit_constant_CARET_TYPE_BLOCK: .. rst-class:: classref-enumeration-constant :ref:`CaretType` **CARET_TYPE_BLOCK** = ``1`` Block caret. .. rst-class:: classref-item-separator ---- .. _enum_TextEdit_SelectionMode: .. rst-class:: classref-enumeration enum **SelectionMode**: :ref:`🔗` .. _class_TextEdit_constant_SELECTION_MODE_NONE: .. rst-class:: classref-enumeration-constant :ref:`SelectionMode` **SELECTION_MODE_NONE** = ``0`` Not selecting. .. _class_TextEdit_constant_SELECTION_MODE_SHIFT: .. rst-class:: classref-enumeration-constant :ref:`SelectionMode` **SELECTION_MODE_SHIFT** = ``1`` Select as if ``shift`` is pressed. .. _class_TextEdit_constant_SELECTION_MODE_POINTER: .. rst-class:: classref-enumeration-constant :ref:`SelectionMode` **SELECTION_MODE_POINTER** = ``2`` Select single characters as if the user single clicked. .. _class_TextEdit_constant_SELECTION_MODE_WORD: .. rst-class:: classref-enumeration-constant :ref:`SelectionMode` **SELECTION_MODE_WORD** = ``3`` Select whole words as if the user double clicked. .. _class_TextEdit_constant_SELECTION_MODE_LINE: .. rst-class:: classref-enumeration-constant :ref:`SelectionMode` **SELECTION_MODE_LINE** = ``4`` Select whole lines as if the user triple clicked. .. rst-class:: classref-item-separator ---- .. _enum_TextEdit_LineWrappingMode: .. rst-class:: classref-enumeration enum **LineWrappingMode**: :ref:`🔗` .. _class_TextEdit_constant_LINE_WRAPPING_NONE: .. rst-class:: classref-enumeration-constant :ref:`LineWrappingMode` **LINE_WRAPPING_NONE** = ``0`` Line wrapping is disabled. .. _class_TextEdit_constant_LINE_WRAPPING_BOUNDARY: .. rst-class:: classref-enumeration-constant :ref:`LineWrappingMode` **LINE_WRAPPING_BOUNDARY** = ``1`` Line wrapping occurs at the control boundary, beyond what would normally be visible. .. rst-class:: classref-item-separator ---- .. _enum_TextEdit_GutterType: .. rst-class:: classref-enumeration enum **GutterType**: :ref:`🔗` .. _class_TextEdit_constant_GUTTER_TYPE_STRING: .. rst-class:: classref-enumeration-constant :ref:`GutterType` **GUTTER_TYPE_STRING** = ``0`` When a gutter is set to string using :ref:`set_gutter_type`, it is used to contain text set via the :ref:`set_line_gutter_text` method. .. _class_TextEdit_constant_GUTTER_TYPE_ICON: .. rst-class:: classref-enumeration-constant :ref:`GutterType` **GUTTER_TYPE_ICON** = ``1`` When a gutter is set to icon using :ref:`set_gutter_type`, it is used to contain an icon set via the :ref:`set_line_gutter_icon` method. .. _class_TextEdit_constant_GUTTER_TYPE_CUSTOM: .. rst-class:: classref-enumeration-constant :ref:`GutterType` **GUTTER_TYPE_CUSTOM** = ``2`` When a gutter is set to custom using :ref:`set_gutter_type`, it is used to contain custom visuals controlled by a callback method set via the :ref:`set_gutter_custom_draw` method. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Property Descriptions --------------------- .. _class_TextEdit_property_autowrap_mode: .. rst-class:: classref-property :ref:`AutowrapMode` **autowrap_mode** = ``3`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_autowrap_mode**\ (\ value\: :ref:`AutowrapMode`\ ) - :ref:`AutowrapMode` **get_autowrap_mode**\ (\ ) If :ref:`wrap_mode` is set to :ref:`LINE_WRAPPING_BOUNDARY`, sets text wrapping mode. To see how each mode behaves, see :ref:`AutowrapMode`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_caret_blink: .. rst-class:: classref-property :ref:`bool` **caret_blink** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_blink_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_caret_blink_enabled**\ (\ ) If ``true``, makes the caret blink. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_caret_blink_interval: .. rst-class:: classref-property :ref:`float` **caret_blink_interval** = ``0.65`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_blink_interval**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_caret_blink_interval**\ (\ ) The interval at which the caret blinks (in seconds). .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_caret_draw_when_editable_disabled: .. rst-class:: classref-property :ref:`bool` **caret_draw_when_editable_disabled** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_caret_when_editable_disabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_drawing_caret_when_editable_disabled**\ (\ ) If ``true``, caret will be visible when :ref:`editable` is disabled. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_caret_mid_grapheme: .. rst-class:: classref-property :ref:`bool` **caret_mid_grapheme** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_mid_grapheme_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_caret_mid_grapheme_enabled**\ (\ ) Allow moving caret, selecting and removing the individual composite character components. \ **Note:** :kbd:`Backspace` is always removing individual composite character components. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_caret_move_on_right_click: .. rst-class:: classref-property :ref:`bool` **caret_move_on_right_click** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_move_caret_on_right_click_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_move_caret_on_right_click_enabled**\ (\ ) If ``true``, a right-click moves the caret at the mouse position before displaying the context menu. If ``false``, the context menu ignores mouse location. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_caret_multiple: .. rst-class:: classref-property :ref:`bool` **caret_multiple** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_multiple_carets_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_multiple_carets_enabled**\ (\ ) Sets if multiple carets are allowed. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_caret_type: .. rst-class:: classref-property :ref:`CaretType` **caret_type** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_type**\ (\ value\: :ref:`CaretType`\ ) - :ref:`CaretType` **get_caret_type**\ (\ ) Set the type of caret to draw. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_context_menu_enabled: .. rst-class:: classref-property :ref:`bool` **context_menu_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_context_menu_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_context_menu_enabled**\ (\ ) If ``true``, a right-click displays the context menu. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_custom_word_separators: .. rst-class:: classref-property :ref:`String` **custom_word_separators** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_custom_word_separators**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_custom_word_separators**\ (\ ) The characters to consider as word delimiters if :ref:`use_custom_word_separators` is ``true``. The characters should be defined without separation, for example ``#_!``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_deselect_on_focus_loss_enabled: .. rst-class:: classref-property :ref:`bool` **deselect_on_focus_loss_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_deselect_on_focus_loss_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_deselect_on_focus_loss_enabled**\ (\ ) If ``true``, the selected text will be deselected when focus is lost. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_drag_and_drop_selection_enabled: .. rst-class:: classref-property :ref:`bool` **drag_and_drop_selection_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_drag_and_drop_selection_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_drag_and_drop_selection_enabled**\ (\ ) If ``true``, allow drag and drop of selected text. Text can still be dropped from other sources. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_draw_control_chars: .. rst-class:: classref-property :ref:`bool` **draw_control_chars** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_control_chars**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_draw_control_chars**\ (\ ) If ``true``, control characters are displayed. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_draw_spaces: .. rst-class:: classref-property :ref:`bool` **draw_spaces** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_spaces**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_drawing_spaces**\ (\ ) If ``true``, the "space" character will have a visible representation. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_draw_tabs: .. rst-class:: classref-property :ref:`bool` **draw_tabs** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_tabs**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_drawing_tabs**\ (\ ) If ``true``, the "tab" character will have a visible representation. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_editable: .. rst-class:: classref-property :ref:`bool` **editable** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_editable**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_editable**\ (\ ) If ``false``, existing text cannot be modified and new text cannot be added. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_empty_selection_clipboard_enabled: .. rst-class:: classref-property :ref:`bool` **empty_selection_clipboard_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_empty_selection_clipboard_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_empty_selection_clipboard_enabled**\ (\ ) If ``true``, copying or cutting without a selection is performed on all lines with a caret. Otherwise, copy and cut require a selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_highlight_all_occurrences: .. rst-class:: classref-property :ref:`bool` **highlight_all_occurrences** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_highlight_all_occurrences**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_highlight_all_occurrences_enabled**\ (\ ) If ``true``, all occurrences of the selected text will be highlighted. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_highlight_current_line: .. rst-class:: classref-property :ref:`bool` **highlight_current_line** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_highlight_current_line**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_highlight_current_line_enabled**\ (\ ) If ``true``, the line containing the cursor is highlighted. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_indent_wrapped_lines: .. rst-class:: classref-property :ref:`bool` **indent_wrapped_lines** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_indent_wrapped_lines**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_indent_wrapped_lines**\ (\ ) If ``true``, all wrapped lines are indented to the same amount as the unwrapped line. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_language: .. rst-class:: classref-property :ref:`String` **language** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_middle_mouse_paste_enabled: .. rst-class:: classref-property :ref:`bool` **middle_mouse_paste_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_middle_mouse_paste_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_middle_mouse_paste_enabled**\ (\ ) If ``false``, using middle mouse button to paste clipboard will be disabled. \ **Note:** This method is only implemented on Linux. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_minimap_draw: .. rst-class:: classref-property :ref:`bool` **minimap_draw** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_minimap**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_drawing_minimap**\ (\ ) If ``true``, a minimap is shown, providing an outline of your source code. The minimap uses a fixed-width text size. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_minimap_width: .. rst-class:: classref-property :ref:`int` **minimap_width** = ``80`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_minimap_width**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_minimap_width**\ (\ ) The width, in pixels, of the minimap. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_placeholder_text: .. rst-class:: classref-property :ref:`String` **placeholder_text** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_placeholder**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_placeholder**\ (\ ) Text shown when the **TextEdit** is empty. It is **not** the **TextEdit**'s default value (see :ref:`text`). .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_scroll_fit_content_height: .. rst-class:: classref-property :ref:`bool` **scroll_fit_content_height** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_fit_content_height_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_fit_content_height_enabled**\ (\ ) If ``true``, **TextEdit** will disable vertical scroll and fit minimum height to the number of visible lines. When both this property and :ref:`scroll_fit_content_width` are ``true``, no scrollbars will be displayed. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_scroll_fit_content_width: .. rst-class:: classref-property :ref:`bool` **scroll_fit_content_width** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_fit_content_width_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_fit_content_width_enabled**\ (\ ) If ``true``, **TextEdit** will disable horizontal scroll and fit minimum width to the widest line in the text. When both this property and :ref:`scroll_fit_content_height` are ``true``, no scrollbars will be displayed. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_scroll_horizontal: .. rst-class:: classref-property :ref:`int` **scroll_horizontal** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_h_scroll**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_h_scroll**\ (\ ) If there is a horizontal scrollbar, this determines the current horizontal scroll value in pixels. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_scroll_past_end_of_file: .. rst-class:: classref-property :ref:`bool` **scroll_past_end_of_file** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_scroll_past_end_of_file_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_scroll_past_end_of_file_enabled**\ (\ ) Allow scrolling past the last line into "virtual" space. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_scroll_smooth: .. rst-class:: classref-property :ref:`bool` **scroll_smooth** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_smooth_scroll_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_smooth_scroll_enabled**\ (\ ) Scroll smoothly over the text rather than jumping to the next location. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_scroll_v_scroll_speed: .. rst-class:: classref-property :ref:`float` **scroll_v_scroll_speed** = ``80.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_v_scroll_speed**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_v_scroll_speed**\ (\ ) Sets the scroll speed with the minimap or when :ref:`scroll_smooth` is enabled. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_scroll_vertical: .. rst-class:: classref-property :ref:`float` **scroll_vertical** = ``0.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_v_scroll**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_v_scroll**\ (\ ) If there is a vertical scrollbar, this determines the current vertical scroll value in line numbers, starting at 0 for the top line. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_selecting_enabled: .. rst-class:: classref-property :ref:`bool` **selecting_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_selecting_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_selecting_enabled**\ (\ ) If ``true``, text can be selected. If ``false``, text can not be selected by the user or by the :ref:`select` or :ref:`select_all` methods. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_shortcut_keys_enabled: .. rst-class:: classref-property :ref:`bool` **shortcut_keys_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_shortcut_keys_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_shortcut_keys_enabled**\ (\ ) If ``true``, shortcut keys for context menu items are enabled, even if the context menu is disabled. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_structured_text_bidi_override: .. rst-class:: classref-property :ref:`StructuredTextParser` **structured_text_bidi_override** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_structured_text_bidi_override**\ (\ value\: :ref:`StructuredTextParser`\ ) - :ref:`StructuredTextParser` **get_structured_text_bidi_override**\ (\ ) Set BiDi algorithm override for the structured text. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_structured_text_bidi_override_options: .. rst-class:: classref-property :ref:`Array` **structured_text_bidi_override_options** = ``[]`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_structured_text_bidi_override_options**\ (\ value\: :ref:`Array`\ ) - :ref:`Array` **get_structured_text_bidi_override_options**\ (\ ) Set additional options for BiDi override. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_syntax_highlighter: .. rst-class:: classref-property :ref:`SyntaxHighlighter` **syntax_highlighter** :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_syntax_highlighter**\ (\ value\: :ref:`SyntaxHighlighter`\ ) - :ref:`SyntaxHighlighter` **get_syntax_highlighter**\ (\ ) The syntax highlighter to use. \ **Note:** A :ref:`SyntaxHighlighter` instance should not be used across multiple **TextEdit** nodes. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_text: .. rst-class:: classref-property :ref:`String` **text** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_text**\ (\ ) String value of the **TextEdit**. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_text_direction: .. rst-class:: classref-property :ref:`TextDirection` **text_direction** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text_direction**\ (\ value\: :ref:`TextDirection`\ ) - :ref:`TextDirection` **get_text_direction**\ (\ ) Base text writing direction. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_use_custom_word_separators: .. rst-class:: classref-property :ref:`bool` **use_custom_word_separators** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_use_custom_word_separators**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_custom_word_separators_enabled**\ (\ ) If ``false``, using :kbd:`Ctrl + Left` or :kbd:`Ctrl + Right` (:kbd:`Cmd + Left` or :kbd:`Cmd + Right` on macOS) bindings will use the behavior of :ref:`use_default_word_separators`. If ``true``, it will also stop the caret if a character within :ref:`custom_word_separators` is detected. Useful for subword moving. This behavior also will be applied to the behavior of text selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_use_default_word_separators: .. rst-class:: classref-property :ref:`bool` **use_default_word_separators** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_use_default_word_separators**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_default_word_separators_enabled**\ (\ ) If ``false``, using :kbd:`Ctrl + Left` or :kbd:`Ctrl + Right` (:kbd:`Cmd + Left` or :kbd:`Cmd + Right` on macOS) bindings will stop moving caret only if a space or punctuation is detected. If ``true``, it will also stop the caret if a character is part of ``!"#$%&'()*+,-./:;<=>?@[\]^`{|}~``, the Unicode General Punctuation table, or the Unicode CJK Punctuation table. Useful for subword moving. This behavior also will be applied to the behavior of text selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_virtual_keyboard_enabled: .. rst-class:: classref-property :ref:`bool` **virtual_keyboard_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_virtual_keyboard_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_virtual_keyboard_enabled**\ (\ ) If ``true``, the native virtual keyboard is shown when focused on platforms that support it. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_property_wrap_mode: .. rst-class:: classref-property :ref:`LineWrappingMode` **wrap_mode** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_line_wrapping_mode**\ (\ value\: :ref:`LineWrappingMode`\ ) - :ref:`LineWrappingMode` **get_line_wrapping_mode**\ (\ ) Sets the line wrapping mode to use. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Method Descriptions ------------------- .. _class_TextEdit_private_method__backspace: .. rst-class:: classref-method |void| **_backspace**\ (\ caret_index\: :ref:`int`\ ) |virtual| :ref:`🔗` Override this method to define what happens when the user presses the backspace key. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_private_method__copy: .. rst-class:: classref-method |void| **_copy**\ (\ caret_index\: :ref:`int`\ ) |virtual| :ref:`🔗` Override this method to define what happens when the user performs a copy operation. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_private_method__cut: .. rst-class:: classref-method |void| **_cut**\ (\ caret_index\: :ref:`int`\ ) |virtual| :ref:`🔗` Override this method to define what happens when the user performs a cut operation. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_private_method__handle_unicode_input: .. rst-class:: classref-method |void| **_handle_unicode_input**\ (\ unicode_char\: :ref:`int`, caret_index\: :ref:`int`\ ) |virtual| :ref:`🔗` Override this method to define what happens when the user types in the provided key ``unicode_char``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_private_method__paste: .. rst-class:: classref-method |void| **_paste**\ (\ caret_index\: :ref:`int`\ ) |virtual| :ref:`🔗` Override this method to define what happens when the user performs a paste operation. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_private_method__paste_primary_clipboard: .. rst-class:: classref-method |void| **_paste_primary_clipboard**\ (\ caret_index\: :ref:`int`\ ) |virtual| :ref:`🔗` Override this method to define what happens when the user performs a paste operation with middle mouse button. \ **Note:** This method is only implemented on Linux. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_add_caret: .. rst-class:: classref-method :ref:`int` **add_caret**\ (\ line\: :ref:`int`, column\: :ref:`int`\ ) :ref:`🔗` Adds a new caret at the given location. Returns the index of the new caret, or ``-1`` if the location is invalid. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_add_caret_at_carets: .. rst-class:: classref-method |void| **add_caret_at_carets**\ (\ below\: :ref:`bool`\ ) :ref:`🔗` Adds an additional caret above or below every caret. If ``below`` is ``true`` the new caret will be added below and above otherwise. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_add_gutter: .. rst-class:: classref-method |void| **add_gutter**\ (\ at\: :ref:`int` = -1\ ) :ref:`🔗` Register a new gutter to this **TextEdit**. Use ``at`` to have a specific gutter order. A value of ``-1`` appends the gutter to the right. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_add_selection_for_next_occurrence: .. rst-class:: classref-method |void| **add_selection_for_next_occurrence**\ (\ ) :ref:`🔗` Adds a selection and a caret for the next occurrence of the current selection. If there is no active selection, selects word under caret. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_adjust_carets_after_edit: .. rst-class:: classref-method |void| **adjust_carets_after_edit**\ (\ caret\: :ref:`int`, from_line\: :ref:`int`, from_col\: :ref:`int`, to_line\: :ref:`int`, to_col\: :ref:`int`\ ) :ref:`🔗` **Deprecated:** No longer necessary since methods now adjust carets themselves. This method does nothing. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_adjust_viewport_to_caret: .. rst-class:: classref-method |void| **adjust_viewport_to_caret**\ (\ caret_index\: :ref:`int` = 0\ ) :ref:`🔗` Adjust the viewport so the caret is visible. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_apply_ime: .. rst-class:: classref-method |void| **apply_ime**\ (\ ) :ref:`🔗` Applies text from the `Input Method Editor `__ (IME) to each caret and closes the IME if it is open. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_backspace: .. rst-class:: classref-method |void| **backspace**\ (\ caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Called when the user presses the backspace key. Can be overridden with :ref:`_backspace`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_begin_complex_operation: .. rst-class:: classref-method |void| **begin_complex_operation**\ (\ ) :ref:`🔗` Starts a multipart edit. All edits will be treated as one action until :ref:`end_complex_operation` is called. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_begin_multicaret_edit: .. rst-class:: classref-method |void| **begin_multicaret_edit**\ (\ ) :ref:`🔗` Starts an edit for multiple carets. The edit must be ended with :ref:`end_multicaret_edit`. Multicaret edits can be used to edit text at multiple carets and delay merging the carets until the end, so the caret indexes aren't affected immediately. :ref:`begin_multicaret_edit` and :ref:`end_multicaret_edit` can be nested, and the merge will happen at the last :ref:`end_multicaret_edit`. :: begin_complex_operation() begin_multicaret_edit() for i in range(get_caret_count()): if multicaret_edit_ignore_caret(i): continue # Logic here. end_multicaret_edit() end_complex_operation() .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_cancel_ime: .. rst-class:: classref-method |void| **cancel_ime**\ (\ ) :ref:`🔗` Closes the `Input Method Editor `__ (IME) if it is open. Any text in the IME will be lost. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_center_viewport_to_caret: .. rst-class:: classref-method |void| **center_viewport_to_caret**\ (\ caret_index\: :ref:`int` = 0\ ) :ref:`🔗` Centers the viewport on the line the editing caret is at. This also resets the :ref:`scroll_horizontal` value to ``0``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_clear: .. rst-class:: classref-method |void| **clear**\ (\ ) :ref:`🔗` Performs a full reset of **TextEdit**, including undo history. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_clear_undo_history: .. rst-class:: classref-method |void| **clear_undo_history**\ (\ ) :ref:`🔗` Clears the undo history. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_collapse_carets: .. rst-class:: classref-method |void| **collapse_carets**\ (\ from_line\: :ref:`int`, from_column\: :ref:`int`, to_line\: :ref:`int`, to_column\: :ref:`int`, inclusive\: :ref:`bool` = false\ ) :ref:`🔗` Collapse all carets in the given range to the ``from_line`` and ``from_column`` position. \ ``inclusive`` applies to both ends. If :ref:`is_in_mulitcaret_edit` is ``true``, carets that are collapsed will be ``true`` for :ref:`multicaret_edit_ignore_caret`. \ :ref:`merge_overlapping_carets` will be called if any carets were collapsed. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_copy: .. rst-class:: classref-method |void| **copy**\ (\ caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Copies the current text selection. Can be overridden with :ref:`_copy`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_cut: .. rst-class:: classref-method |void| **cut**\ (\ caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Cut's the current selection. Can be overridden with :ref:`_cut`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_delete_selection: .. rst-class:: classref-method |void| **delete_selection**\ (\ caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Deletes the selected text. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_deselect: .. rst-class:: classref-method |void| **deselect**\ (\ caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Deselects the current selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_end_action: .. rst-class:: classref-method |void| **end_action**\ (\ ) :ref:`🔗` Marks the end of steps in the current action started with :ref:`start_action`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_end_complex_operation: .. rst-class:: classref-method |void| **end_complex_operation**\ (\ ) :ref:`🔗` Ends a multipart edit, started with :ref:`begin_complex_operation`. If called outside a complex operation, the current operation is pushed onto the undo/redo stack. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_end_multicaret_edit: .. rst-class:: classref-method |void| **end_multicaret_edit**\ (\ ) :ref:`🔗` Ends an edit for multiple carets, that was started with :ref:`begin_multicaret_edit`. If this was the last :ref:`end_multicaret_edit` and :ref:`merge_overlapping_carets` was called, carets will be merged. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_caret_column: .. rst-class:: classref-method :ref:`int` **get_caret_column**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the column the editing caret is at. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_caret_count: .. rst-class:: classref-method :ref:`int` **get_caret_count**\ (\ ) |const| :ref:`🔗` Returns the number of carets in this **TextEdit**. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_caret_draw_pos: .. rst-class:: classref-method :ref:`Vector2` **get_caret_draw_pos**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the caret pixel draw position. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_caret_index_edit_order: .. rst-class:: classref-method :ref:`PackedInt32Array` **get_caret_index_edit_order**\ (\ ) :ref:`🔗` **Deprecated:** Carets no longer need to be edited in any specific order. If the carets need to be sorted, use :ref:`get_sorted_carets` instead. Returns a list of caret indexes in their edit order, this done from bottom to top. Edit order refers to the way actions such as :ref:`insert_text_at_caret` are applied. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_caret_line: .. rst-class:: classref-method :ref:`int` **get_caret_line**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the line the editing caret is on. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_caret_wrap_index: .. rst-class:: classref-method :ref:`int` **get_caret_wrap_index**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the wrap index the editing caret is on. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_first_non_whitespace_column: .. rst-class:: classref-method :ref:`int` **get_first_non_whitespace_column**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Returns the first column containing a non-whitespace character. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_first_visible_line: .. rst-class:: classref-method :ref:`int` **get_first_visible_line**\ (\ ) |const| :ref:`🔗` Returns the first visible line. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_gutter_count: .. rst-class:: classref-method :ref:`int` **get_gutter_count**\ (\ ) |const| :ref:`🔗` Returns the number of gutters registered. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_gutter_name: .. rst-class:: classref-method :ref:`String` **get_gutter_name**\ (\ gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns the name of the gutter at the given index. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_gutter_type: .. rst-class:: classref-method :ref:`GutterType` **get_gutter_type**\ (\ gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns the type of the gutter at the given index. Gutters can contain icons, text, or custom visuals. See :ref:`GutterType` for options. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_gutter_width: .. rst-class:: classref-method :ref:`int` **get_gutter_width**\ (\ gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns the width of the gutter at the given index. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_h_scroll_bar: .. rst-class:: classref-method :ref:`HScrollBar` **get_h_scroll_bar**\ (\ ) |const| :ref:`🔗` Returns the :ref:`HScrollBar` used by **TextEdit**. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_indent_level: .. rst-class:: classref-method :ref:`int` **get_indent_level**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Returns the number of spaces and ``tab * tab_size`` before the first char. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_last_full_visible_line: .. rst-class:: classref-method :ref:`int` **get_last_full_visible_line**\ (\ ) |const| :ref:`🔗` Returns the last visible line. Use :ref:`get_last_full_visible_line_wrap_index` for the wrap index. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_last_full_visible_line_wrap_index: .. rst-class:: classref-method :ref:`int` **get_last_full_visible_line_wrap_index**\ (\ ) |const| :ref:`🔗` Returns the last visible wrap index of the last visible line. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_last_unhidden_line: .. rst-class:: classref-method :ref:`int` **get_last_unhidden_line**\ (\ ) |const| :ref:`🔗` Returns the last unhidden line in the entire **TextEdit**. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line: .. rst-class:: classref-method :ref:`String` **get_line**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Returns the text of a specific line. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_background_color: .. rst-class:: classref-method :ref:`Color` **get_line_background_color**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Returns the current background color of the line. ``Color(0, 0, 0, 0)`` is returned if no color is set. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_column_at_pos: .. rst-class:: classref-method :ref:`Vector2i` **get_line_column_at_pos**\ (\ position\: :ref:`Vector2i`, allow_out_of_bounds\: :ref:`bool` = true\ ) |const| :ref:`🔗` Returns the line and column at the given position. In the returned vector, ``x`` is the column, ``y`` is the line. If ``allow_out_of_bounds`` is ``false`` and the position is not over the text, both vector values will be set to ``-1``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_count: .. rst-class:: classref-method :ref:`int` **get_line_count**\ (\ ) |const| :ref:`🔗` Returns the number of lines in the text. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_gutter_icon: .. rst-class:: classref-method :ref:`Texture2D` **get_line_gutter_icon**\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns the icon currently in ``gutter`` at ``line``. This only works when the gutter type is :ref:`GUTTER_TYPE_ICON` (see :ref:`set_gutter_type`). .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_gutter_item_color: .. rst-class:: classref-method :ref:`Color` **get_line_gutter_item_color**\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns the color currently in ``gutter`` at ``line``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_gutter_metadata: .. rst-class:: classref-method :ref:`Variant` **get_line_gutter_metadata**\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns the metadata currently in ``gutter`` at ``line``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_gutter_text: .. rst-class:: classref-method :ref:`String` **get_line_gutter_text**\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns the text currently in ``gutter`` at ``line``. This only works when the gutter type is :ref:`GUTTER_TYPE_STRING` (see :ref:`set_gutter_type`). .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_height: .. rst-class:: classref-method :ref:`int` **get_line_height**\ (\ ) |const| :ref:`🔗` Returns the maximum value of the line height among all lines. \ **Note:** The return value is influenced by :ref:`line_spacing` and :ref:`font_size`. And it will not be less than ``1``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_ranges_from_carets: .. rst-class:: classref-method :ref:`Array`\[:ref:`Vector2i`\] **get_line_ranges_from_carets**\ (\ only_selections\: :ref:`bool` = false, merge_adjacent\: :ref:`bool` = true\ ) |const| :ref:`🔗` Returns an :ref:`Array` of line ranges where ``x`` is the first line and ``y`` is the last line. All lines within these ranges will have a caret on them or be part of a selection. Each line will only be part of one line range, even if it has multiple carets on it. If a selection's end column (:ref:`get_selection_to_column`) is at column ``0``, that line will not be included. If a selection begins on the line after another selection ends and ``merge_adjacent`` is ``true``, or they begin and end on the same line, one line range will include both selections. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_width: .. rst-class:: classref-method :ref:`int` **get_line_width**\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = -1\ ) |const| :ref:`🔗` Returns the width in pixels of the ``wrap_index`` on ``line``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_wrap_count: .. rst-class:: classref-method :ref:`int` **get_line_wrap_count**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Returns the number of times the given line is wrapped. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_wrap_index_at_column: .. rst-class:: classref-method :ref:`int` **get_line_wrap_index_at_column**\ (\ line\: :ref:`int`, column\: :ref:`int`\ ) |const| :ref:`🔗` Returns the wrap index of the given line column. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_line_wrapped_text: .. rst-class:: classref-method :ref:`PackedStringArray` **get_line_wrapped_text**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Returns an array of :ref:`String`\ s representing each wrapped index. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_local_mouse_pos: .. rst-class:: classref-method :ref:`Vector2` **get_local_mouse_pos**\ (\ ) |const| :ref:`🔗` Returns the local mouse position adjusted for the text direction. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_menu: .. rst-class:: classref-method :ref:`PopupMenu` **get_menu**\ (\ ) |const| :ref:`🔗` Returns the :ref:`PopupMenu` of this **TextEdit**. By default, this menu is displayed when right-clicking on the **TextEdit**. You can add custom menu items or remove standard ones. Make sure your IDs don't conflict with the standard ones (see :ref:`MenuItems`). For example: .. tabs:: .. code-tab:: gdscript func _ready(): var menu = get_menu() # Remove all items after "Redo". menu.item_count = menu.get_item_index(MENU_REDO) + 1 # Add custom items. menu.add_separator() menu.add_item("Insert Date", MENU_MAX + 1) # Connect callback. menu.id_pressed.connect(_on_item_pressed) func _on_item_pressed(id): if id == MENU_MAX + 1: insert_text_at_caret(Time.get_date_string_from_system()) .. code-tab:: csharp public override void _Ready() { var menu = GetMenu(); // Remove all items after "Redo". menu.ItemCount = menu.GetItemIndex(TextEdit.MenuItems.Redo) + 1; // Add custom items. menu.AddSeparator(); menu.AddItem("Insert Date", TextEdit.MenuItems.Max + 1); // Add event handler. menu.IdPressed += OnItemPressed; } public void OnItemPressed(int id) { if (id == TextEdit.MenuItems.Max + 1) { InsertTextAtCaret(Time.GetDateStringFromSystem()); } } \ **Warning:** This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their :ref:`Window.visible` property. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_minimap_line_at_pos: .. rst-class:: classref-method :ref:`int` **get_minimap_line_at_pos**\ (\ position\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Returns the equivalent minimap line at ``position``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_minimap_visible_lines: .. rst-class:: classref-method :ref:`int` **get_minimap_visible_lines**\ (\ ) |const| :ref:`🔗` Returns the number of lines that may be drawn on the minimap. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_next_visible_line_index_offset_from: .. rst-class:: classref-method :ref:`Vector2i` **get_next_visible_line_index_offset_from**\ (\ line\: :ref:`int`, wrap_index\: :ref:`int`, visible_amount\: :ref:`int`\ ) |const| :ref:`🔗` Similar to :ref:`get_next_visible_line_offset_from`, but takes into account the line wrap indexes. In the returned vector, ``x`` is the line, ``y`` is the wrap index. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_next_visible_line_offset_from: .. rst-class:: classref-method :ref:`int` **get_next_visible_line_offset_from**\ (\ line\: :ref:`int`, visible_amount\: :ref:`int`\ ) |const| :ref:`🔗` Returns the count to the next visible line from ``line`` to ``line + visible_amount``. Can also count backwards. For example if a **TextEdit** has 5 lines with lines 2 and 3 hidden, calling this with ``line = 1, visible_amount = 1`` would return 3. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_pos_at_line_column: .. rst-class:: classref-method :ref:`Vector2i` **get_pos_at_line_column**\ (\ line\: :ref:`int`, column\: :ref:`int`\ ) |const| :ref:`🔗` Returns the local position for the given ``line`` and ``column``. If ``x`` or ``y`` of the returned vector equal ``-1``, the position is outside of the viewable area of the control. \ **Note:** The Y position corresponds to the bottom side of the line. Use :ref:`get_rect_at_line_column` to get the top side position. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_rect_at_line_column: .. rst-class:: classref-method :ref:`Rect2i` **get_rect_at_line_column**\ (\ line\: :ref:`int`, column\: :ref:`int`\ ) |const| :ref:`🔗` Returns the local position and size for the grapheme at the given ``line`` and ``column``. If ``x`` or ``y`` position of the returned rect equal ``-1``, the position is outside of the viewable area of the control. \ **Note:** The Y position of the returned rect corresponds to the top side of the line, unlike :ref:`get_pos_at_line_column` which returns the bottom side. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_saved_version: .. rst-class:: classref-method :ref:`int` **get_saved_version**\ (\ ) |const| :ref:`🔗` Returns the last tagged saved version from :ref:`tag_saved_version`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_scroll_pos_for_line: .. rst-class:: classref-method :ref:`float` **get_scroll_pos_for_line**\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the scroll position for ``wrap_index`` of ``line``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selected_text: .. rst-class:: classref-method :ref:`String` **get_selected_text**\ (\ caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Returns the text inside the selection of a caret, or all the carets if ``caret_index`` is its default value ``-1``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_at_line_column: .. rst-class:: classref-method :ref:`int` **get_selection_at_line_column**\ (\ line\: :ref:`int`, column\: :ref:`int`, include_edges\: :ref:`bool` = true, only_selections\: :ref:`bool` = true\ ) |const| :ref:`🔗` Returns the caret index of the selection at the given ``line`` and ``column``, or ``-1`` if there is none. If ``include_edges`` is ``false``, the position must be inside the selection and not at either end. If ``only_selections`` is ``false``, carets without a selection will also be considered. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_column: .. rst-class:: classref-method :ref:`int` **get_selection_column**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` **Deprecated:** Use :ref:`get_selection_origin_column` instead. Returns the original start column of the selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_from_column: .. rst-class:: classref-method :ref:`int` **get_selection_from_column**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the selection begin column. Returns the caret column if there is no selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_from_line: .. rst-class:: classref-method :ref:`int` **get_selection_from_line**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the selection begin line. Returns the caret line if there is no selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_line: .. rst-class:: classref-method :ref:`int` **get_selection_line**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` **Deprecated:** Use :ref:`get_selection_origin_line` instead. Returns the original start line of the selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_mode: .. rst-class:: classref-method :ref:`SelectionMode` **get_selection_mode**\ (\ ) |const| :ref:`🔗` Returns the current selection mode. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_origin_column: .. rst-class:: classref-method :ref:`int` **get_selection_origin_column**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the origin column of the selection. This is the opposite end from the caret. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_origin_line: .. rst-class:: classref-method :ref:`int` **get_selection_origin_line**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the origin line of the selection. This is the opposite end from the caret. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_to_column: .. rst-class:: classref-method :ref:`int` **get_selection_to_column**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the selection end column. Returns the caret column if there is no selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_selection_to_line: .. rst-class:: classref-method :ref:`int` **get_selection_to_line**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns the selection end line. Returns the caret line if there is no selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_sorted_carets: .. rst-class:: classref-method :ref:`PackedInt32Array` **get_sorted_carets**\ (\ include_ignored_carets\: :ref:`bool` = false\ ) |const| :ref:`🔗` Returns the carets sorted by selection beginning from lowest line and column to highest (from top to bottom of text). If ``include_ignored_carets`` is ``false``, carets from :ref:`multicaret_edit_ignore_caret` will be ignored. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_tab_size: .. rst-class:: classref-method :ref:`int` **get_tab_size**\ (\ ) |const| :ref:`🔗` Returns the **TextEdit**'s' tab size. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_total_gutter_width: .. rst-class:: classref-method :ref:`int` **get_total_gutter_width**\ (\ ) |const| :ref:`🔗` Returns the total width of all gutters and internal padding. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_total_visible_line_count: .. rst-class:: classref-method :ref:`int` **get_total_visible_line_count**\ (\ ) |const| :ref:`🔗` Returns the number of lines that may be drawn. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_v_scroll_bar: .. rst-class:: classref-method :ref:`VScrollBar` **get_v_scroll_bar**\ (\ ) |const| :ref:`🔗` Returns the :ref:`VScrollBar` of the **TextEdit**. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_version: .. rst-class:: classref-method :ref:`int` **get_version**\ (\ ) |const| :ref:`🔗` Returns the current version of the **TextEdit**. The version is a count of recorded operations by the undo/redo history. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_visible_line_count: .. rst-class:: classref-method :ref:`int` **get_visible_line_count**\ (\ ) |const| :ref:`🔗` Returns the number of visible lines, including wrapped text. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_visible_line_count_in_range: .. rst-class:: classref-method :ref:`int` **get_visible_line_count_in_range**\ (\ from_line\: :ref:`int`, to_line\: :ref:`int`\ ) |const| :ref:`🔗` Returns the total number of visible + wrapped lines between the two lines. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_word_at_pos: .. rst-class:: classref-method :ref:`String` **get_word_at_pos**\ (\ position\: :ref:`Vector2`\ ) |const| :ref:`🔗` Returns the word at ``position``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_get_word_under_caret: .. rst-class:: classref-method :ref:`String` **get_word_under_caret**\ (\ caret_index\: :ref:`int` = -1\ ) |const| :ref:`🔗` Returns a :ref:`String` text with the word under the caret's location. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_has_ime_text: .. rst-class:: classref-method :ref:`bool` **has_ime_text**\ (\ ) |const| :ref:`🔗` Returns ``true`` if the user has text in the `Input Method Editor `__ (IME). .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_has_redo: .. rst-class:: classref-method :ref:`bool` **has_redo**\ (\ ) |const| :ref:`🔗` Returns ``true`` if a "redo" action is available. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_has_selection: .. rst-class:: classref-method :ref:`bool` **has_selection**\ (\ caret_index\: :ref:`int` = -1\ ) |const| :ref:`🔗` Returns ``true`` if the user has selected text. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_has_undo: .. rst-class:: classref-method :ref:`bool` **has_undo**\ (\ ) |const| :ref:`🔗` Returns ``true`` if an "undo" action is available. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_insert_line_at: .. rst-class:: classref-method |void| **insert_line_at**\ (\ line\: :ref:`int`, text\: :ref:`String`\ ) :ref:`🔗` Inserts a new line with ``text`` at ``line``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_insert_text: .. rst-class:: classref-method |void| **insert_text**\ (\ text\: :ref:`String`, line\: :ref:`int`, column\: :ref:`int`, before_selection_begin\: :ref:`bool` = true, before_selection_end\: :ref:`bool` = false\ ) :ref:`🔗` Inserts the ``text`` at ``line`` and ``column``. If ``before_selection_begin`` is ``true``, carets and selections that begin at ``line`` and ``column`` will moved to the end of the inserted text, along with all carets after it. If ``before_selection_end`` is ``true``, selections that end at ``line`` and ``column`` will be extended to the end of the inserted text. These parameters can be used to insert text inside of or outside of selections. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_insert_text_at_caret: .. rst-class:: classref-method |void| **insert_text_at_caret**\ (\ text\: :ref:`String`, caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Insert the specified text at the caret position. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_caret_after_selection_origin: .. rst-class:: classref-method :ref:`bool` **is_caret_after_selection_origin**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns ``true`` if the caret of the selection is after the selection origin. This can be used to determine the direction of the selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_caret_visible: .. rst-class:: classref-method :ref:`bool` **is_caret_visible**\ (\ caret_index\: :ref:`int` = 0\ ) |const| :ref:`🔗` Returns ``true`` if the caret is visible, ``false`` otherwise. A caret will be considered hidden if it is outside the scrollable area when scrolling is enabled. \ **Note:** :ref:`is_caret_visible` does not account for a caret being off-screen if it is still within the scrollable area. It will return ``true`` even if the caret is off-screen as long as it meets **TextEdit**'s own conditions for being visible. This includes uses of :ref:`scroll_fit_content_width` and :ref:`scroll_fit_content_height` that cause the **TextEdit** to expand beyond the viewport's bounds. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_dragging_cursor: .. rst-class:: classref-method :ref:`bool` **is_dragging_cursor**\ (\ ) |const| :ref:`🔗` Returns ``true`` if the user is dragging their mouse for scrolling, selecting, or text dragging. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_gutter_clickable: .. rst-class:: classref-method :ref:`bool` **is_gutter_clickable**\ (\ gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns whether the gutter is clickable. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_gutter_drawn: .. rst-class:: classref-method :ref:`bool` **is_gutter_drawn**\ (\ gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns whether the gutter is currently drawn. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_gutter_overwritable: .. rst-class:: classref-method :ref:`bool` **is_gutter_overwritable**\ (\ gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns whether the gutter is overwritable. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_in_mulitcaret_edit: .. rst-class:: classref-method :ref:`bool` **is_in_mulitcaret_edit**\ (\ ) |const| :ref:`🔗` Returns ``true`` if a :ref:`begin_multicaret_edit` has been called and :ref:`end_multicaret_edit` has not yet been called. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_line_gutter_clickable: .. rst-class:: classref-method :ref:`bool` **is_line_gutter_clickable**\ (\ line\: :ref:`int`, gutter\: :ref:`int`\ ) |const| :ref:`🔗` Returns whether the gutter on the given line is clickable. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_line_wrapped: .. rst-class:: classref-method :ref:`bool` **is_line_wrapped**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Returns if the given line is wrapped. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_menu_visible: .. rst-class:: classref-method :ref:`bool` **is_menu_visible**\ (\ ) |const| :ref:`🔗` Returns whether the menu is visible. Use this instead of ``get_menu().visible`` to improve performance (so the creation of the menu is avoided). .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_mouse_over_selection: .. rst-class:: classref-method :ref:`bool` **is_mouse_over_selection**\ (\ edges\: :ref:`bool`, caret_index\: :ref:`int` = -1\ ) |const| :ref:`🔗` Returns whether the mouse is over selection. If ``edges`` is ``true``, the edges are considered part of the selection. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_is_overtype_mode_enabled: .. rst-class:: classref-method :ref:`bool` **is_overtype_mode_enabled**\ (\ ) |const| :ref:`🔗` Returns whether the user is in overtype mode. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_menu_option: .. rst-class:: classref-method |void| **menu_option**\ (\ option\: :ref:`int`\ ) :ref:`🔗` Executes a given action as defined in the :ref:`MenuItems` enum. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_merge_gutters: .. rst-class:: classref-method |void| **merge_gutters**\ (\ from_line\: :ref:`int`, to_line\: :ref:`int`\ ) :ref:`🔗` Merge the gutters from ``from_line`` into ``to_line``. Only overwritable gutters will be copied. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_merge_overlapping_carets: .. rst-class:: classref-method |void| **merge_overlapping_carets**\ (\ ) :ref:`🔗` Merges any overlapping carets. Will favor the newest caret, or the caret with a selection. If :ref:`is_in_mulitcaret_edit` is ``true``, the merge will be queued to happen at the end of the multicaret edit. See :ref:`begin_multicaret_edit` and :ref:`end_multicaret_edit`. \ **Note:** This is not called when a caret changes position but after certain actions, so it is possible to get into a state where carets overlap. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_multicaret_edit_ignore_caret: .. rst-class:: classref-method :ref:`bool` **multicaret_edit_ignore_caret**\ (\ caret_index\: :ref:`int`\ ) |const| :ref:`🔗` Returns ``true`` if the given ``caret_index`` should be ignored as part of a multicaret edit. See :ref:`begin_multicaret_edit` and :ref:`end_multicaret_edit`. Carets that should be ignored are ones that were part of removed text and will likely be merged at the end of the edit, or carets that were added during the edit. It is recommended to ``continue`` within a loop iterating on multiple carets if a caret should be ignored. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_paste: .. rst-class:: classref-method |void| **paste**\ (\ caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Paste at the current location. Can be overridden with :ref:`_paste`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_paste_primary_clipboard: .. rst-class:: classref-method |void| **paste_primary_clipboard**\ (\ caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Pastes the primary clipboard. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_redo: .. rst-class:: classref-method |void| **redo**\ (\ ) :ref:`🔗` Perform redo operation. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_remove_caret: .. rst-class:: classref-method |void| **remove_caret**\ (\ caret\: :ref:`int`\ ) :ref:`🔗` Removes the given caret index. \ **Note:** This can result in adjustment of all other caret indices. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_remove_gutter: .. rst-class:: classref-method |void| **remove_gutter**\ (\ gutter\: :ref:`int`\ ) :ref:`🔗` Removes the gutter from this **TextEdit**. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_remove_line_at: .. rst-class:: classref-method |void| **remove_line_at**\ (\ line\: :ref:`int`, move_carets_down\: :ref:`bool` = true\ ) :ref:`🔗` Removes the line of text at ``line``. Carets on this line will attempt to match their previous visual x position. If ``move_carets_down`` is ``true`` carets will move to the next line down, otherwise carets will move up. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_remove_secondary_carets: .. rst-class:: classref-method |void| **remove_secondary_carets**\ (\ ) :ref:`🔗` Removes all additional carets. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_remove_text: .. rst-class:: classref-method |void| **remove_text**\ (\ from_line\: :ref:`int`, from_column\: :ref:`int`, to_line\: :ref:`int`, to_column\: :ref:`int`\ ) :ref:`🔗` Removes text between the given positions. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_search: .. rst-class:: classref-method :ref:`Vector2i` **search**\ (\ text\: :ref:`String`, flags\: :ref:`int`, from_line\: :ref:`int`, from_column\: :ref:`int`\ ) |const| :ref:`🔗` Perform a search inside the text. Search flags can be specified in the :ref:`SearchFlags` enum. In the returned vector, ``x`` is the column, ``y`` is the line. If no results are found, both are equal to ``-1``. .. tabs:: .. code-tab:: gdscript var result = search("print", SEARCH_WHOLE_WORDS, 0, 0) if result.x != -1: # Result found. var line_number = result.y var column_number = result.x .. code-tab:: csharp Vector2I result = Search("print", (uint)TextEdit.SearchFlags.WholeWords, 0, 0); if (result.X != -1) { // Result found. int lineNumber = result.Y; int columnNumber = result.X; } .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_select: .. rst-class:: classref-method |void| **select**\ (\ origin_line\: :ref:`int`, origin_column\: :ref:`int`, caret_line\: :ref:`int`, caret_column\: :ref:`int`, caret_index\: :ref:`int` = 0\ ) :ref:`🔗` Selects text from ``origin_line`` and ``origin_column`` to ``caret_line`` and ``caret_column`` for the given ``caret_index``. This moves the selection origin and the caret. If the positions are the same, the selection will be deselected. If :ref:`selecting_enabled` is ``false``, no selection will occur. \ **Note:** If supporting multiple carets this will not check for any overlap. See :ref:`merge_overlapping_carets`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_select_all: .. rst-class:: classref-method |void| **select_all**\ (\ ) :ref:`🔗` Select all the text. If :ref:`selecting_enabled` is ``false``, no selection will occur. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_select_word_under_caret: .. rst-class:: classref-method |void| **select_word_under_caret**\ (\ caret_index\: :ref:`int` = -1\ ) :ref:`🔗` Selects the word under the caret. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_caret_column: .. rst-class:: classref-method |void| **set_caret_column**\ (\ column\: :ref:`int`, adjust_viewport\: :ref:`bool` = true, caret_index\: :ref:`int` = 0\ ) :ref:`🔗` Moves the caret to the specified ``column`` index. If ``adjust_viewport`` is ``true``, the viewport will center at the caret position after the move occurs. \ **Note:** If supporting multiple carets this will not check for any overlap. See :ref:`merge_overlapping_carets`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_caret_line: .. rst-class:: classref-method |void| **set_caret_line**\ (\ line\: :ref:`int`, adjust_viewport\: :ref:`bool` = true, can_be_hidden\: :ref:`bool` = true, wrap_index\: :ref:`int` = 0, caret_index\: :ref:`int` = 0\ ) :ref:`🔗` Moves the caret to the specified ``line`` index. The caret column will be moved to the same visual position it was at the last time :ref:`set_caret_column` was called, or clamped to the end of the line. If ``adjust_viewport`` is ``true``, the viewport will center at the caret position after the move occurs. If ``can_be_hidden`` is ``true``, the specified ``line`` can be hidden. If ``wrap_index`` is ``-1``, the caret column will be clamped to the ``line``'s length. If ``wrap_index`` is greater than ``-1``, the column will be moved to attempt to match the visual x position on the line's ``wrap_index`` to the position from the last time :ref:`set_caret_column` was called. \ **Note:** If supporting multiple carets this will not check for any overlap. See :ref:`merge_overlapping_carets`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_gutter_clickable: .. rst-class:: classref-method |void| **set_gutter_clickable**\ (\ gutter\: :ref:`int`, clickable\: :ref:`bool`\ ) :ref:`🔗` Sets the gutter as clickable. This will change the mouse cursor to a pointing hand when hovering over the gutter. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_gutter_custom_draw: .. rst-class:: classref-method |void| **set_gutter_custom_draw**\ (\ column\: :ref:`int`, draw_callback\: :ref:`Callable`\ ) :ref:`🔗` Set a custom draw method for the gutter. The callback method must take the following args: ``line: int, gutter: int, Area: Rect2``. This only works when the gutter type is :ref:`GUTTER_TYPE_CUSTOM` (see :ref:`set_gutter_type`). .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_gutter_draw: .. rst-class:: classref-method |void| **set_gutter_draw**\ (\ gutter\: :ref:`int`, draw\: :ref:`bool`\ ) :ref:`🔗` Sets whether the gutter should be drawn. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_gutter_name: .. rst-class:: classref-method |void| **set_gutter_name**\ (\ gutter\: :ref:`int`, name\: :ref:`String`\ ) :ref:`🔗` Sets the name of the gutter. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_gutter_overwritable: .. rst-class:: classref-method |void| **set_gutter_overwritable**\ (\ gutter\: :ref:`int`, overwritable\: :ref:`bool`\ ) :ref:`🔗` Sets the gutter to overwritable. See :ref:`merge_gutters`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_gutter_type: .. rst-class:: classref-method |void| **set_gutter_type**\ (\ gutter\: :ref:`int`, type\: :ref:`GutterType`\ ) :ref:`🔗` Sets the type of gutter. Gutters can contain icons, text, or custom visuals. See :ref:`GutterType` for options. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_gutter_width: .. rst-class:: classref-method |void| **set_gutter_width**\ (\ gutter\: :ref:`int`, width\: :ref:`int`\ ) :ref:`🔗` Set the width of the gutter. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line: .. rst-class:: classref-method |void| **set_line**\ (\ line\: :ref:`int`, new_text\: :ref:`String`\ ) :ref:`🔗` Sets the text for a specific ``line``. Carets on the line will attempt to keep their visual x position. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line_as_center_visible: .. rst-class:: classref-method |void| **set_line_as_center_visible**\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = 0\ ) :ref:`🔗` Positions the ``wrap_index`` of ``line`` at the center of the viewport. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line_as_first_visible: .. rst-class:: classref-method |void| **set_line_as_first_visible**\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = 0\ ) :ref:`🔗` Positions the ``wrap_index`` of ``line`` at the top of the viewport. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line_as_last_visible: .. rst-class:: classref-method |void| **set_line_as_last_visible**\ (\ line\: :ref:`int`, wrap_index\: :ref:`int` = 0\ ) :ref:`🔗` Positions the ``wrap_index`` of ``line`` at the bottom of the viewport. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line_background_color: .. rst-class:: classref-method |void| **set_line_background_color**\ (\ line\: :ref:`int`, color\: :ref:`Color`\ ) :ref:`🔗` Sets the current background color of the line. Set to ``Color(0, 0, 0, 0)`` for no color. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line_gutter_clickable: .. rst-class:: classref-method |void| **set_line_gutter_clickable**\ (\ line\: :ref:`int`, gutter\: :ref:`int`, clickable\: :ref:`bool`\ ) :ref:`🔗` If ``clickable`` is ``true``, makes the ``gutter`` on ``line`` clickable. See :ref:`gutter_clicked`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line_gutter_icon: .. rst-class:: classref-method |void| **set_line_gutter_icon**\ (\ line\: :ref:`int`, gutter\: :ref:`int`, icon\: :ref:`Texture2D`\ ) :ref:`🔗` Sets the icon for ``gutter`` on ``line`` to ``icon``. This only works when the gutter type is :ref:`GUTTER_TYPE_ICON` (see :ref:`set_gutter_type`). .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line_gutter_item_color: .. rst-class:: classref-method |void| **set_line_gutter_item_color**\ (\ line\: :ref:`int`, gutter\: :ref:`int`, color\: :ref:`Color`\ ) :ref:`🔗` Sets the color for ``gutter`` on ``line`` to ``color``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line_gutter_metadata: .. rst-class:: classref-method |void| **set_line_gutter_metadata**\ (\ line\: :ref:`int`, gutter\: :ref:`int`, metadata\: :ref:`Variant`\ ) :ref:`🔗` Sets the metadata for ``gutter`` on ``line`` to ``metadata``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_line_gutter_text: .. rst-class:: classref-method |void| **set_line_gutter_text**\ (\ line\: :ref:`int`, gutter\: :ref:`int`, text\: :ref:`String`\ ) :ref:`🔗` Sets the text for ``gutter`` on ``line`` to ``text``. This only works when the gutter type is :ref:`GUTTER_TYPE_STRING` (see :ref:`set_gutter_type`). .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_overtype_mode_enabled: .. rst-class:: classref-method |void| **set_overtype_mode_enabled**\ (\ enabled\: :ref:`bool`\ ) :ref:`🔗` If ``true``, sets the user into overtype mode. When the user types in this mode, it will override existing text. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_search_flags: .. rst-class:: classref-method |void| **set_search_flags**\ (\ flags\: :ref:`int`\ ) :ref:`🔗` Sets the search ``flags``. This is used with :ref:`set_search_text` to highlight occurrences of the searched text. Search flags can be specified from the :ref:`SearchFlags` enum. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_search_text: .. rst-class:: classref-method |void| **set_search_text**\ (\ search_text\: :ref:`String`\ ) :ref:`🔗` Sets the search text. See :ref:`set_search_flags`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_selection_mode: .. rst-class:: classref-method |void| **set_selection_mode**\ (\ mode\: :ref:`SelectionMode`\ ) :ref:`🔗` Sets the current selection mode. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_selection_origin_column: .. rst-class:: classref-method |void| **set_selection_origin_column**\ (\ column\: :ref:`int`, caret_index\: :ref:`int` = 0\ ) :ref:`🔗` Sets the selection origin column to the ``column`` for the given ``caret_index``. If the selection origin is moved to the caret position, the selection will deselect. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_selection_origin_line: .. rst-class:: classref-method |void| **set_selection_origin_line**\ (\ line\: :ref:`int`, can_be_hidden\: :ref:`bool` = true, wrap_index\: :ref:`int` = -1, caret_index\: :ref:`int` = 0\ ) :ref:`🔗` Sets the selection origin line to the ``line`` for the given ``caret_index``. If the selection origin is moved to the caret position, the selection will deselect. If ``can_be_hidden`` is ``false``, The line will be set to the nearest unhidden line below or above. If ``wrap_index`` is ``-1``, the selection origin column will be clamped to the ``line``'s length. If ``wrap_index`` is greater than ``-1``, the column will be moved to attempt to match the visual x position on the line's ``wrap_index`` to the position from the last time :ref:`set_selection_origin_column` or :ref:`select` was called. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_tab_size: .. rst-class:: classref-method |void| **set_tab_size**\ (\ size\: :ref:`int`\ ) :ref:`🔗` Sets the tab size for the **TextEdit** to use. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_set_tooltip_request_func: .. rst-class:: classref-method |void| **set_tooltip_request_func**\ (\ callback\: :ref:`Callable`\ ) :ref:`🔗` Provide custom tooltip text. The callback method must take the following args: ``hovered_word: String``. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_skip_selection_for_next_occurrence: .. rst-class:: classref-method |void| **skip_selection_for_next_occurrence**\ (\ ) :ref:`🔗` Moves a selection and a caret for the next occurrence of the current selection. If there is no active selection, moves to the next occurrence of the word under caret. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_start_action: .. rst-class:: classref-method |void| **start_action**\ (\ action\: :ref:`EditAction`\ ) :ref:`🔗` Starts an action, will end the current action if ``action`` is different. An action will also end after a call to :ref:`end_action`, after :ref:`ProjectSettings.gui/timers/text_edit_idle_detect_sec` is triggered or a new undoable step outside the :ref:`start_action` and :ref:`end_action` calls. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_swap_lines: .. rst-class:: classref-method |void| **swap_lines**\ (\ from_line\: :ref:`int`, to_line\: :ref:`int`\ ) :ref:`🔗` Swaps the two lines. Carets will be swapped with the lines. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_tag_saved_version: .. rst-class:: classref-method |void| **tag_saved_version**\ (\ ) :ref:`🔗` Tag the current version as saved. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_method_undo: .. rst-class:: classref-method |void| **undo**\ (\ ) :ref:`🔗` Perform undo operation. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Theme Property Descriptions --------------------------- .. _class_TextEdit_theme_color_background_color: .. rst-class:: classref-themeproperty :ref:`Color` **background_color** = ``Color(0, 0, 0, 0)`` :ref:`🔗` Sets the background :ref:`Color` of this **TextEdit**. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_caret_background_color: .. rst-class:: classref-themeproperty :ref:`Color` **caret_background_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗` :ref:`Color` of the text behind the caret when using a block caret. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_caret_color: .. rst-class:: classref-themeproperty :ref:`Color` **caret_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗` :ref:`Color` of the caret. This can be set to a fully transparent color to hide the caret entirely. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_current_line_color: .. rst-class:: classref-themeproperty :ref:`Color` **current_line_color** = ``Color(0.25, 0.25, 0.26, 0.8)`` :ref:`🔗` Background :ref:`Color` of the line containing the caret. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_font_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗` Sets the font :ref:`Color`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_font_outline_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_outline_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗` The tint of text outline of the **TextEdit**. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_font_placeholder_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_placeholder_color** = ``Color(0.875, 0.875, 0.875, 0.6)`` :ref:`🔗` Font color for :ref:`placeholder_text`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_font_readonly_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_readonly_color** = ``Color(0.875, 0.875, 0.875, 0.5)`` :ref:`🔗` Sets the font :ref:`Color` when :ref:`editable` is disabled. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_font_selected_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_selected_color** = ``Color(0, 0, 0, 0)`` :ref:`🔗` Sets the :ref:`Color` of the selected text. If equal to ``Color(0, 0, 0, 0)``, it will be ignored. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_search_result_border_color: .. rst-class:: classref-themeproperty :ref:`Color` **search_result_border_color** = ``Color(0.3, 0.3, 0.3, 0.4)`` :ref:`🔗` :ref:`Color` of the border around text that matches the search query. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_search_result_color: .. rst-class:: classref-themeproperty :ref:`Color` **search_result_color** = ``Color(0.3, 0.3, 0.3, 1)`` :ref:`🔗` :ref:`Color` behind the text that matches the search query. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_selection_color: .. rst-class:: classref-themeproperty :ref:`Color` **selection_color** = ``Color(0.5, 0.5, 0.5, 1)`` :ref:`🔗` Sets the highlight :ref:`Color` of text selections. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_color_word_highlighted_color: .. rst-class:: classref-themeproperty :ref:`Color` **word_highlighted_color** = ``Color(0.5, 0.5, 0.5, 0.25)`` :ref:`🔗` Sets the highlight :ref:`Color` of multiple occurrences. :ref:`highlight_all_occurrences` has to be enabled. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_constant_caret_width: .. rst-class:: classref-themeproperty :ref:`int` **caret_width** = ``1`` :ref:`🔗` The caret's width in pixels. Greater values can be used to improve accessibility by ensuring the caret is easily visible, or to ensure consistency with a large font size. If set to ``0`` or lower, the caret width is automatically set to 1 pixel and multiplied by the display scaling factor. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_constant_line_spacing: .. rst-class:: classref-themeproperty :ref:`int` **line_spacing** = ``4`` :ref:`🔗` Additional vertical spacing between lines (in pixels), spacing is added to line descent. This value can be negative. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_constant_outline_size: .. rst-class:: classref-themeproperty :ref:`int` **outline_size** = ``0`` :ref:`🔗` The size of the text outline. \ **Note:** If using a font with :ref:`FontFile.multichannel_signed_distance_field` enabled, its :ref:`FontFile.msdf_pixel_range` must be set to at least *twice* the value of :ref:`outline_size` for outline rendering to look correct. Otherwise, the outline may appear to be cut off earlier than intended. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_font_font: .. rst-class:: classref-themeproperty :ref:`Font` **font** :ref:`🔗` Sets the default :ref:`Font`. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_font_size_font_size: .. rst-class:: classref-themeproperty :ref:`int` **font_size** :ref:`🔗` Sets default font size. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_icon_space: .. rst-class:: classref-themeproperty :ref:`Texture2D` **space** :ref:`🔗` Sets a custom :ref:`Texture2D` for space text characters. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_icon_tab: .. rst-class:: classref-themeproperty :ref:`Texture2D` **tab** :ref:`🔗` Sets a custom :ref:`Texture2D` for tab text characters. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_style_focus: .. rst-class:: classref-themeproperty :ref:`StyleBox` **focus** :ref:`🔗` Sets the :ref:`StyleBox` when in focus. The :ref:`focus` :ref:`StyleBox` is displayed *over* the base :ref:`StyleBox`, so a partially transparent :ref:`StyleBox` should be used to ensure the base :ref:`StyleBox` remains visible. A :ref:`StyleBox` that represents an outline or an underline works well for this purpose. To disable the focus visual effect, assign a :ref:`StyleBoxEmpty` resource. Note that disabling the focus visual effect will harm keyboard/controller navigation usability, so this is not recommended for accessibility reasons. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_style_normal: .. rst-class:: classref-themeproperty :ref:`StyleBox` **normal** :ref:`🔗` Sets the :ref:`StyleBox` of this **TextEdit**. .. rst-class:: classref-item-separator ---- .. _class_TextEdit_theme_style_read_only: .. rst-class:: classref-themeproperty :ref:`StyleBox` **read_only** :ref:`🔗` Sets the :ref:`StyleBox` of this **TextEdit** when :ref:`editable` is disabled. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)` .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)` .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)` .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)` .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)` .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)` .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)` .. |void| replace:: :abbr:`void (No return value.)`