1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216 |
- <?xml version="1.0" encoding="UTF-8" ?>
- <class name="TextEdit" inherits="Control" version="4.0">
- <brief_description>
- Multiline text editing control.
- </brief_description>
- <description>
- TextEdit is meant for editing large, multiline text. It also has facilities for editing code, such as syntax highlighting support and multiple levels of undo/redo.
- [b]Note:[/b] When holding down [kbd]Alt[/kbd], the vertical scroll wheel will scroll 5 times as fast as it would normally do. This also works in the Godot script editor.
- </description>
- <tutorials>
- </tutorials>
- <methods>
- <method name="_backspace" qualifiers="virtual">
- <return type="void" />
- <description>
- Override this method to define what happens when the user presses the backspace key.
- </description>
- </method>
- <method name="_copy" qualifiers="virtual">
- <return type="void" />
- <description>
- Override this method to define what happens when the user performs a copy operation.
- </description>
- </method>
- <method name="_cut" qualifiers="virtual">
- <return type="void" />
- <description>
- Override this method to define what happens when the user performs a cut operation.
- </description>
- </method>
- <method name="_handle_unicode_input" qualifiers="virtual">
- <return type="void" />
- <argument index="0" name="unicode" type="int" />
- <description>
- Override this method to define what happens when the types in the provided key [code]unicode[/code].
- </description>
- </method>
- <method name="_paste" qualifiers="virtual">
- <return type="void" />
- <description>
- Override this method to define what happens when the user performs a paste operation.
- </description>
- </method>
- <method name="add_gutter">
- <return type="void" />
- <argument index="0" name="at" type="int" default="-1" />
- <description>
- Register a new gutter to this [TextEdit]. Use [code]at[/code] to have a specific gutter order. A value of [code]-1[/code] appends the gutter to the right.
- </description>
- </method>
- <method name="adjust_viewport_to_caret">
- <return type="void" />
- <description>
- Adjust the viewport so the caret is visible.
- </description>
- </method>
- <method name="backspace">
- <return type="void" />
- <description>
- Called when the user presses the backspace key. Can be overridden with [method _backspace].
- </description>
- </method>
- <method name="begin_complex_operation">
- <return type="void" />
- <description>
- Starts a multipart edit. All edits will be treated as one action until [method end_complex_operation] is called.
- </description>
- </method>
- <method name="center_viewport_to_caret">
- <return type="void" />
- <description>
- Centers the viewport on the line the editing caret is at. This also resets the [member scroll_horizontal] value to [code]0[/code].
- </description>
- </method>
- <method name="clear">
- <return type="void" />
- <description>
- Performs a full reset of [TextEdit], including undo history.
- </description>
- </method>
- <method name="clear_opentype_features">
- <return type="void" />
- <description>
- Removes all OpenType features.
- </description>
- </method>
- <method name="clear_undo_history">
- <return type="void" />
- <description>
- Clears the undo history.
- </description>
- </method>
- <method name="copy">
- <return type="void" />
- <description>
- Copies the current text selection. Can be overridden with [method _copy].
- </description>
- </method>
- <method name="cut">
- <return type="void" />
- <description>
- Cut's the current selection. Can be overridden with [method _cut].
- </description>
- </method>
- <method name="delete_selection">
- <return type="void" />
- <description>
- Deletes the selected text.
- </description>
- </method>
- <method name="deselect">
- <return type="void" />
- <description>
- Deselects the current selection.
- </description>
- </method>
- <method name="end_complex_operation">
- <return type="void" />
- <description>
- Ends a multipart edit, started with [method begin_complex_operation]. If called outside a complex operation, the current operation is pushed onto the undo/redo stack.
- </description>
- </method>
- <method name="get_caret_column" qualifiers="const">
- <return type="int" />
- <description>
- Returns the column the editing caret is at.
- </description>
- </method>
- <method name="get_caret_draw_pos" qualifiers="const">
- <return type="Vector2" />
- <description>
- Returns the caret pixel draw position.
- </description>
- </method>
- <method name="get_caret_line" qualifiers="const">
- <return type="int" />
- <description>
- Returns the line the editing caret is on.
- </description>
- </method>
- <method name="get_caret_wrap_index" qualifiers="const">
- <return type="int" />
- <description>
- Returns the wrap index the editing caret is on.
- </description>
- </method>
- <method name="get_first_non_whitespace_column" qualifiers="const">
- <return type="int" />
- <argument index="0" name="line" type="int" />
- <description>
- Returns the first column containing a non-whitespace character.
- </description>
- </method>
- <method name="get_first_visible_line" qualifiers="const">
- <return type="int" />
- <description>
- Returns the first visible line.
- </description>
- </method>
- <method name="get_gutter_count" qualifiers="const">
- <return type="int" />
- <description>
- Returns the total amount of gutters registered.
- </description>
- </method>
- <method name="get_gutter_name" qualifiers="const">
- <return type="String" />
- <argument index="0" name="gutter" type="int" />
- <description>
- Returns the name of the gutter at the given index.
- </description>
- </method>
- <method name="get_gutter_type" qualifiers="const">
- <return type="int" enum="TextEdit.GutterType" />
- <argument index="0" name="gutter" type="int" />
- <description>
- Returns the type of the gutter at the given index.
- </description>
- </method>
- <method name="get_gutter_width" qualifiers="const">
- <return type="int" />
- <argument index="0" name="gutter" type="int" />
- <description>
- Returns the width of the gutter at the given index.
- </description>
- </method>
- <method name="get_indent_level" qualifiers="const">
- <return type="int" />
- <argument index="0" name="line" type="int" />
- <description>
- Returns the amount of spaces and [code]tab * tab_size[/code] before the first char.
- </description>
- </method>
- <method name="get_last_full_visible_line" qualifiers="const">
- <return type="int" />
- <description>
- Return the last visible line. Use [method get_last_full_visible_line_wrap_index] for the wrap index.
- </description>
- </method>
- <method name="get_last_full_visible_line_wrap_index" qualifiers="const">
- <return type="int" />
- <description>
- Returns the last visible wrap index of the last visible line.
- </description>
- </method>
- <method name="get_last_unhidden_line" qualifiers="const">
- <return type="int" />
- <description>
- Returns the last unhidden line in the entire [TextEdit].
- </description>
- </method>
- <method name="get_line" qualifiers="const">
- <return type="String" />
- <argument index="0" name="line" type="int" />
- <description>
- Returns the text of a specific line.
- </description>
- </method>
- <method name="get_line_background_color" qualifiers="const">
- <return type="Color" />
- <argument index="0" name="line" type="int" />
- <description>
- Returns the current background color of the line. [code]Color(0, 0, 0, 0)[/code] is returned if no color is set.
- </description>
- </method>
- <method name="get_line_column_at_pos" qualifiers="const">
- <return type="Vector2i" />
- <argument index="0" name="position" type="Vector2i" />
- <description>
- Returns the line and column at the given position. In the returned vector, [code]x[/code] is the column, [code]y[/code] is the line.
- </description>
- </method>
- <method name="get_line_count" qualifiers="const">
- <return type="int" />
- <description>
- Returns the amount of total lines in the text.
- </description>
- </method>
- <method name="get_line_gutter_icon" qualifiers="const">
- <return type="Texture2D" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <description>
- Returns the icon currently in [code]gutter[/code] at [code]line[/code].
- </description>
- </method>
- <method name="get_line_gutter_item_color" qualifiers="const">
- <return type="Color" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <description>
- Returns the color currently in [code]gutter[/code] at [code]line[/code].
- </description>
- </method>
- <method name="get_line_gutter_metadata" qualifiers="const">
- <return type="Variant" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <description>
- Returns the metadata currently in [code]gutter[/code] at [code]line[/code].
- </description>
- </method>
- <method name="get_line_gutter_text" qualifiers="const">
- <return type="String" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <description>
- Returns the text currently in [code]gutter[/code] at [code]line[/code].
- </description>
- </method>
- <method name="get_line_height" qualifiers="const">
- <return type="int" />
- <description>
- Returns the height of a largest line.
- </description>
- </method>
- <method name="get_line_width" qualifiers="const">
- <return type="int" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="wrap_index" type="int" default="-1" />
- <description>
- Returns the width in pixels of the [code]wrap_index[/code] on [code]line[/code].
- </description>
- </method>
- <method name="get_line_wrap_count" qualifiers="const">
- <return type="int" />
- <argument index="0" name="line" type="int" />
- <description>
- Returns the number of times the given line is wrapped.
- </description>
- </method>
- <method name="get_line_wrap_index_at_column" qualifiers="const">
- <return type="int" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="column" type="int" />
- <description>
- Returns the wrap index of the given line column.
- </description>
- </method>
- <method name="get_line_wrapped_text" qualifiers="const">
- <return type="PackedStringArray" />
- <argument index="0" name="line" type="int" />
- <description>
- Returns an array of [String]s representing each wrapped index.
- </description>
- </method>
- <method name="get_local_mouse_pos" qualifiers="const">
- <return type="Vector2" />
- <description>
- Returns the local mouse position adjusted for the text direction.
- </description>
- </method>
- <method name="get_menu" qualifiers="const">
- <return type="PopupMenu" />
- <description>
- Returns the [PopupMenu] of this [TextEdit]. By default, this menu is displayed when right-clicking on the [TextEdit].
- </description>
- </method>
- <method name="get_minimap_line_at_pos" qualifiers="const">
- <return type="int" />
- <argument index="0" name="position" type="Vector2i" />
- <description>
- Returns the equivalent minimap line at [code]position[/code]
- </description>
- </method>
- <method name="get_minimap_visible_lines" qualifiers="const">
- <return type="int" />
- <description>
- Returns the total amount of lines that can be draw on the minimap.
- </description>
- </method>
- <method name="get_next_visible_line_index_offset_from" qualifiers="const">
- <return type="Vector2i" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="wrap_index" type="int" />
- <argument index="2" name="visible_amount" type="int" />
- <description>
- Similar to [method get_next_visible_line_offset_from], but takes into account the line wrap indexes. In the returned vector, [code]x[/code] is the line, [code]y[/code] is the wrap index.
- </description>
- </method>
- <method name="get_next_visible_line_offset_from" qualifiers="const">
- <return type="int" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="visible_amount" type="int" />
- <description>
- Returns the count to the next visible line from [code]line[/code] to [code]line + visible_amount[/code]. Can also count backwards. For example if a [TextEdit] has 5 lines with lines 2 and 3 hidden, calling this with [code]line = 1, visible_amount = 1[/code] would return 3.
- </description>
- </method>
- <method name="get_opentype_feature" qualifiers="const">
- <return type="int" />
- <argument index="0" name="tag" type="String" />
- <description>
- Returns OpenType feature [code]tag[/code].
- </description>
- </method>
- <method name="get_saved_version" qualifiers="const">
- <return type="int" />
- <description>
- Returns the last tagged saved version from [method tag_saved_version]
- </description>
- </method>
- <method name="get_scroll_pos_for_line" qualifiers="const">
- <return type="float" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="wrap_index" type="int" default="0" />
- <description>
- Returns the scroll position for [code]wrap_index[/code] of [code]line[/code].
- </description>
- </method>
- <method name="get_selected_text" qualifiers="const">
- <return type="String" />
- <description>
- Returns the text inside the selection.
- </description>
- </method>
- <method name="get_selection_column" qualifiers="const">
- <return type="int" />
- <description>
- Returns the original start column of the selection.
- </description>
- </method>
- <method name="get_selection_from_column" qualifiers="const">
- <return type="int" />
- <description>
- Returns the selection begin column.
- </description>
- </method>
- <method name="get_selection_from_line" qualifiers="const">
- <return type="int" />
- <description>
- Returns the selection begin line.
- </description>
- </method>
- <method name="get_selection_line" qualifiers="const">
- <return type="int" />
- <description>
- Returns the original start line of the selection.
- </description>
- </method>
- <method name="get_selection_mode" qualifiers="const">
- <return type="int" enum="TextEdit.SelectionMode" />
- <description>
- Returns the current selection mode.
- </description>
- </method>
- <method name="get_selection_to_column" qualifiers="const">
- <return type="int" />
- <description>
- Returns the selection end column.
- </description>
- </method>
- <method name="get_selection_to_line" qualifiers="const">
- <return type="int" />
- <description>
- Returns the selection end line.
- </description>
- </method>
- <method name="get_tab_size" qualifiers="const">
- <return type="int" />
- <description>
- Returns the [TextEdit]'s' tab size.
- </description>
- </method>
- <method name="get_total_gutter_width" qualifiers="const">
- <return type="int" />
- <description>
- Returns the total width of all gutters and internal padding.
- </description>
- </method>
- <method name="get_total_visible_line_count" qualifiers="const">
- <return type="int" />
- <description>
- Returns the total amount of lines that could be draw.
- </description>
- </method>
- <method name="get_version" qualifiers="const">
- <return type="int" />
- <description>
- Returns the current version of the [TextEdit]. The version is a count of recorded operations by the undo/redo history.
- </description>
- </method>
- <method name="get_visible_line_count" qualifiers="const">
- <return type="int" />
- <description>
- Returns the number of visible lines, including wrapped text.
- </description>
- </method>
- <method name="get_word_at_pos" qualifiers="const">
- <return type="String" />
- <argument index="0" name="position" type="Vector2" />
- <description>
- Returns the word at [code]position[/code].
- </description>
- </method>
- <method name="get_word_under_caret" qualifiers="const">
- <return type="String" />
- <description>
- Returns a [String] text with the word under the caret's location.
- </description>
- </method>
- <method name="has_ime_text" qualifiers="const">
- <return type="bool" />
- <description>
- Returns if the user has IME text.
- </description>
- </method>
- <method name="has_selection" qualifiers="const">
- <return type="bool" />
- <description>
- Returns [code]true[/code] if the user has selected text.
- </description>
- </method>
- <method name="insert_line_at">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="text" type="String" />
- <description>
- Inserts a new line with [code]text[/code] at [code]line[/code].
- </description>
- </method>
- <method name="insert_text_at_caret">
- <return type="void" />
- <argument index="0" name="text" type="String" />
- <description>
- Insert the specified text at the caret position.
- </description>
- </method>
- <method name="is_caret_visible" qualifiers="const">
- <return type="bool" />
- <description>
- Returns [code]true[/code] if the caret is visible on the screen.
- </description>
- </method>
- <method name="is_dragging_cursor" qualifiers="const">
- <return type="bool" />
- <description>
- Returns [code]true[/code] if the user is dragging their mouse for scrolling or selecting.
- </description>
- </method>
- <method name="is_gutter_clickable" qualifiers="const">
- <return type="bool" />
- <argument index="0" name="gutter" type="int" />
- <description>
- Returns whether the gutter is clickable.
- </description>
- </method>
- <method name="is_gutter_drawn" qualifiers="const">
- <return type="bool" />
- <argument index="0" name="gutter" type="int" />
- <description>
- Returns whether the gutter is currently drawn.
- </description>
- </method>
- <method name="is_gutter_overwritable" qualifiers="const">
- <return type="bool" />
- <argument index="0" name="gutter" type="int" />
- <description>
- Returns whether the gutter is overwritable.
- </description>
- </method>
- <method name="is_line_gutter_clickable" qualifiers="const">
- <return type="bool" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <description>
- Returns whether the gutter on the given line is clickable.
- </description>
- </method>
- <method name="is_line_wrapped" qualifiers="const">
- <return type="bool" />
- <argument index="0" name="line" type="int" />
- <description>
- Returns if the given line is wrapped.
- </description>
- </method>
- <method name="is_menu_visible" qualifiers="const">
- <return type="bool" />
- <description>
- Returns whether the menu is visible. Use this instead of [code]get_menu().visible[/code] to improve performance (so the creation of the menu is avoided).
- </description>
- </method>
- <method name="is_overtype_mode_enabled" qualifiers="const">
- <return type="bool" />
- <description>
- Returns whether the user is in overtype mode.
- </description>
- </method>
- <method name="menu_option">
- <return type="void" />
- <argument index="0" name="option" type="int" />
- <description>
- Triggers a right-click menu action by the specified index. See [enum MenuItems] for a list of available indexes.
- </description>
- </method>
- <method name="merge_gutters">
- <return type="void" />
- <argument index="0" name="from_line" type="int" />
- <argument index="1" name="to_line" type="int" />
- <description>
- Merge the gutters from [code]from_line[/code] into [code]to_line[/code]. Only overwritable gutters will be copied.
- </description>
- </method>
- <method name="paste">
- <return type="void" />
- <description>
- Paste at the current location. Can be overridden with [method _paste].
- </description>
- </method>
- <method name="redo">
- <return type="void" />
- <description>
- Perform redo operation.
- </description>
- </method>
- <method name="remove_gutter">
- <return type="void" />
- <argument index="0" name="gutter" type="int" />
- <description>
- Removes the gutter from this [TextEdit].
- </description>
- </method>
- <method name="remove_text">
- <return type="void" />
- <argument index="0" name="from_line" type="int" />
- <argument index="1" name="from_column" type="int" />
- <argument index="2" name="to_line" type="int" />
- <argument index="3" name="to_column" type="int" />
- <description>
- Removes text between the given positions.
- [b]Note:[/b]This does not adjust the caret or selection, which as a result it can end up in an invalid position.
- </description>
- </method>
- <method name="search" qualifiers="const">
- <return type="Vector2i" />
- <argument index="0" name="text" type="String" />
- <argument index="1" name="flags" type="int" />
- <argument index="2" name="from_line" type="int" />
- <argument index="3" name="from_colum" type="int" />
- <description>
- Perform a search inside the text. Search flags can be specified in the [enum SearchFlags] enum.
- In the returned vector, [code]x[/code] is the column, [code]y[/code] is the line. If no results are found, both are equal to [code]-1[/code].
- [codeblocks]
- [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
- [/gdscript]
- [csharp]
- Vector2i result = Search("print", (uint)TextEdit.SearchFlags.WholeWords, 0, 0);
- if (result.Length > 0)
- {
- // Result found.
- int lineNumber = result.y;
- int columnNumber = result.x;
- }
- [/csharp]
- [/codeblocks]
- </description>
- </method>
- <method name="select">
- <return type="void" />
- <argument index="0" name="from_line" type="int" />
- <argument index="1" name="from_column" type="int" />
- <argument index="2" name="to_line" type="int" />
- <argument index="3" name="to_column" type="int" />
- <description>
- Perform selection, from line/column to line/column.
- If [member selecting_enabled] is [code]false[/code], no selection will occur.
- </description>
- </method>
- <method name="select_all">
- <return type="void" />
- <description>
- Select all the text.
- If [member selecting_enabled] is [code]false[/code], no selection will occur.
- </description>
- </method>
- <method name="select_word_under_caret">
- <return type="void" />
- <description>
- Selects the word under the caret.
- </description>
- </method>
- <method name="set_caret_column">
- <return type="void" />
- <argument index="0" name="column" type="int" />
- <argument index="1" name="adjust_viewport" type="bool" default="true" />
- <description>
- Moves the caret to the specified [code]column[/code] index.
- If [code]adjust_viewport[/code] is [code]true[/code], the viewport will center at the caret position after the move occurs.
- </description>
- </method>
- <method name="set_caret_line">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="adjust_viewport" type="bool" default="true" />
- <argument index="2" name="can_be_hidden" type="bool" default="true" />
- <argument index="3" name="wrap_index" type="int" default="0" />
- <description>
- Moves the caret to the specified [code]line[/code] index.
- If [code]adjust_viewport[/code] is [code]true[/code], the viewport will center at the caret position after the move occurs.
- If [code]can_be_hidden[/code] is [code]true[/code], the specified [code]line[/code] can be hidden.
- </description>
- </method>
- <method name="set_gutter_clickable">
- <return type="void" />
- <argument index="0" name="gutter" type="int" />
- <argument index="1" name="clickable" type="bool" />
- <description>
- Sets the gutter as clickable. This will change the mouse cursor to a pointing hand when hovering over the gutter.
- </description>
- </method>
- <method name="set_gutter_custom_draw">
- <return type="void" />
- <argument index="0" name="column" type="int" />
- <argument index="1" name="object" type="Object" />
- <argument index="2" name="callback" type="StringName" />
- <description>
- Set a custom draw method for the gutter. The callback method must take the following args: [code]line: int, gutter: int, Area: Rect2[/code].
- </description>
- </method>
- <method name="set_gutter_draw">
- <return type="void" />
- <argument index="0" name="gutter" type="int" />
- <argument index="1" name="draw" type="bool" />
- <description>
- Sets whether the gutter should be drawn.
- </description>
- </method>
- <method name="set_gutter_name">
- <return type="void" />
- <argument index="0" name="gutter" type="int" />
- <argument index="1" name="name" type="String" />
- <description>
- Sets the name of the gutter.
- </description>
- </method>
- <method name="set_gutter_overwritable">
- <return type="void" />
- <argument index="0" name="gutter" type="int" />
- <argument index="1" name="overwritable" type="bool" />
- <description>
- Sets the gutter to overwritable. See [method merge_gutters].
- </description>
- </method>
- <method name="set_gutter_type">
- <return type="void" />
- <argument index="0" name="gutter" type="int" />
- <argument index="1" name="type" type="int" enum="TextEdit.GutterType" />
- <description>
- Sets the type of gutter.
- </description>
- </method>
- <method name="set_gutter_width">
- <return type="void" />
- <argument index="0" name="gutter" type="int" />
- <argument index="1" name="width" type="int" />
- <description>
- Set the width of the gutter.
- </description>
- </method>
- <method name="set_line">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="new_text" type="String" />
- <description>
- Sets the text for a specific line.
- </description>
- </method>
- <method name="set_line_as_center_visible">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="wrap_index" type="int" default="0" />
- <description>
- Positions the [code]wrap_index[/code] of [code]line[/code] at the center of the viewport.
- </description>
- </method>
- <method name="set_line_as_first_visible">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="wrap_index" type="int" default="0" />
- <description>
- Positions the [code]wrap_index[/code] of [code]line[/code] at the top of the viewport.
- </description>
- </method>
- <method name="set_line_as_last_visible">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="wrap_index" type="int" default="0" />
- <description>
- Positions the [code]wrap_index[/code] of [code]line[/code] at the bottom of the viewport.
- </description>
- </method>
- <method name="set_line_background_color">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="color" type="Color" />
- <description>
- Sets the current background color of the line. Set to [code]Color(0, 0, 0, 0)[/code] for no color.
- </description>
- </method>
- <method name="set_line_gutter_clickable">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <argument index="2" name="clickable" type="bool" />
- <description>
- Sets the [code]gutter[/code] on [code]line[/code] as clickable.
- </description>
- </method>
- <method name="set_line_gutter_icon">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <argument index="2" name="icon" type="Texture2D" />
- <description>
- Sets the icon for [code]gutter[/code] on [code]line[/code].
- </description>
- </method>
- <method name="set_line_gutter_item_color">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <argument index="2" name="color" type="Color" />
- <description>
- Sets the color for [code]gutter[/code] on [code]line[/code].
- </description>
- </method>
- <method name="set_line_gutter_metadata">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <argument index="2" name="metadata" type="Variant" />
- <description>
- Sets the metadata for [code]gutter[/code] on [code]line[/code].
- </description>
- </method>
- <method name="set_line_gutter_text">
- <return type="void" />
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <argument index="2" name="text" type="String" />
- <description>
- Sets the text for [code]gutter[/code] on [code]line[/code].
- </description>
- </method>
- <method name="set_opentype_feature">
- <return type="void" />
- <argument index="0" name="tag" type="String" />
- <argument index="1" name="value" type="int" />
- <description>
- Sets OpenType feature [code]tag[/code]. More info: [url=https://docs.microsoft.com/en-us/typography/opentype/spec/featuretags]OpenType feature tags[/url].
- </description>
- </method>
- <method name="set_overtype_mode_enabled">
- <return type="void" />
- <argument index="0" name="enabled" type="bool" />
- <description>
- If [code]true[/code], sets the user into overtype mode. When the user types in this mode, it will override existing text.
- </description>
- </method>
- <method name="set_search_flags">
- <return type="void" />
- <argument index="0" name="flags" type="int" />
- <description>
- Sets the search flags. This is used with [method set_search_text] to highlight occurrences of the searched text. Search flags can be specified from the [enum SearchFlags] enum.
- </description>
- </method>
- <method name="set_search_text">
- <return type="void" />
- <argument index="0" name="search_text" type="String" />
- <description>
- Sets the search text. See [method set_search_flags].
- </description>
- </method>
- <method name="set_selection_mode">
- <return type="void" />
- <argument index="0" name="mode" type="int" enum="TextEdit.SelectionMode" />
- <argument index="1" name="line" type="int" default="-1" />
- <argument index="2" name="column" type="int" default="-1" />
- <description>
- Sets the current selection mode.
- </description>
- </method>
- <method name="set_tab_size">
- <return type="void" />
- <argument index="0" name="size" type="int" />
- <description>
- Sets the tab size for the [TextEdit] to use.
- </description>
- </method>
- <method name="set_tooltip_request_func">
- <return type="void" />
- <argument index="0" name="object" type="Object" />
- <argument index="1" name="callback" type="StringName" />
- <argument index="2" name="data" type="Variant" />
- <description>
- Provide custom tooltip text. The callback method must take the following args: [code]hovered_word: String, data: Variant[/code]
- </description>
- </method>
- <method name="swap_lines">
- <return type="void" />
- <argument index="0" name="from_line" type="int" />
- <argument index="1" name="to_line" type="int" />
- <description>
- Swaps the two lines.
- </description>
- </method>
- <method name="tag_saved_version">
- <return type="void" />
- <description>
- Tag the current version as saved.
- </description>
- </method>
- <method name="undo">
- <return type="void" />
- <description>
- Perform undo operation.
- </description>
- </method>
- </methods>
- <members>
- <member name="caret_blink" type="bool" setter="set_caret_blink_enabled" getter="is_caret_blink_enabled" default="false">
- Sets if the caret should blink.
- </member>
- <member name="caret_blink_speed" type="float" setter="set_caret_blink_speed" getter="get_caret_blink_speed" default="0.65">
- Duration (in seconds) of a caret's blinking cycle.
- </member>
- <member name="caret_mid_grapheme" type="bool" setter="set_caret_mid_grapheme_enabled" getter="is_caret_mid_grapheme_enabled" default="false">
- Allow moving caret, selecting and removing the individual composite character components.
- Note: [kbd]Backspace[/kbd] is always removing individual composite character components.
- </member>
- <member name="caret_move_on_right_click" type="bool" setter="set_move_caret_on_right_click_enabled" getter="is_move_caret_on_right_click_enabled" default="true">
- If [code]true[/code], a right-click moves the caret at the mouse position before displaying the context menu.
- If [code]false[/code], the context menu disregards mouse location.
- </member>
- <member name="caret_type" type="int" setter="set_caret_type" getter="get_caret_type" enum="TextEdit.CaretType" default="0">
- Set the type of caret to draw.
- </member>
- <member name="context_menu_enabled" type="bool" setter="set_context_menu_enabled" getter="is_context_menu_enabled" default="true">
- If [code]true[/code], a right-click displays the context menu.
- </member>
- <member name="draw_control_chars" type="bool" setter="set_draw_control_chars" getter="get_draw_control_chars" default="false">
- If [code]true[/code], control characters are displayed.
- </member>
- <member name="draw_spaces" type="bool" setter="set_draw_spaces" getter="is_drawing_spaces" default="false">
- If [code]true[/code], the "space" character will have a visible representation.
- </member>
- <member name="draw_tabs" type="bool" setter="set_draw_tabs" getter="is_drawing_tabs" default="false">
- If [code]true[/code], the "tab" character will have a visible representation.
- </member>
- <member name="editable" type="bool" setter="set_editable" getter="is_editable" default="true">
- If [code]false[/code], existing text cannot be modified and new text cannot be added.
- </member>
- <member name="focus_mode" type="int" setter="set_focus_mode" getter="get_focus_mode" override="true" enum="Control.FocusMode" default="2" />
- <member name="highlight_all_occurrences" type="bool" setter="set_highlight_all_occurrences" getter="is_highlight_all_occurrences_enabled" default="false">
- If [code]true[/code], all occurrences of the selected text will be highlighted.
- </member>
- <member name="highlight_current_line" type="bool" setter="set_highlight_current_line" getter="is_highlight_current_line_enabled" default="false">
- If [code]true[/code], the line containing the cursor is highlighted.
- </member>
- <member name="language" type="String" setter="set_language" getter="get_language" default="""">
- Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
- </member>
- <member name="minimap_draw" type="bool" setter="draw_minimap" getter="is_drawing_minimap" default="false">
- If [code]true[/code], a minimap is shown, providing an outline of your source code.
- </member>
- <member name="minimap_width" type="int" setter="set_minimap_width" getter="get_minimap_width" default="80">
- The width, in pixels, of the minimap.
- </member>
- <member name="mouse_default_cursor_shape" type="int" setter="set_default_cursor_shape" getter="get_default_cursor_shape" override="true" enum="Control.CursorShape" default="1" />
- <member name="override_selected_font_color" type="bool" setter="set_override_selected_font_color" getter="is_overriding_selected_font_color" default="false">
- If [code]true[/code], custom [code]font_selected_color[/code] will be used for selected text.
- </member>
- <member name="scroll_horizontal" type="int" setter="set_h_scroll" getter="get_h_scroll" default="0">
- If there is a horizontal scrollbar, this determines the current horizontal scroll value in pixels.
- </member>
- <member name="scroll_past_end_of_file" type="bool" setter="set_scroll_past_end_of_file_enabled" getter="is_scroll_past_end_of_file_enabled" default="false">
- Allow scrolling past the last line into "virtual" space.
- </member>
- <member name="scroll_smooth" type="bool" setter="set_smooth_scroll_enable" getter="is_smooth_scroll_enabled" default="false">
- Scroll smoothly over the text rather then jumping to the next location.
- </member>
- <member name="scroll_v_scroll_speed" type="float" setter="set_v_scroll_speed" getter="get_v_scroll_speed" default="80.0">
- Sets the scroll speed with the minimap or when [member scroll_smooth] is enabled.
- </member>
- <member name="scroll_vertical" type="float" setter="set_v_scroll" getter="get_v_scroll" default="0.0">
- If there is a vertical scrollbar, this determines the current vertical scroll value in line numbers, starting at 0 for the top line.
- </member>
- <member name="selecting_enabled" type="bool" setter="set_selecting_enabled" getter="is_selecting_enabled" default="true">
- If [code]true[/code], text can be selected.
- If [code]false[/code], text can not be selected by the user or by the [method select] or [method select_all] methods.
- </member>
- <member name="shortcut_keys_enabled" type="bool" setter="set_shortcut_keys_enabled" getter="is_shortcut_keys_enabled" default="true">
- If [code]true[/code], shortcut keys for context menu items are enabled, even if the context menu is disabled.
- </member>
- <member name="structured_text_bidi_override" type="int" setter="set_structured_text_bidi_override" getter="get_structured_text_bidi_override" enum="Control.StructuredTextParser" default="0">
- Set BiDi algorithm override for the structured text.
- </member>
- <member name="structured_text_bidi_override_options" type="Array" setter="set_structured_text_bidi_override_options" getter="get_structured_text_bidi_override_options" default="[]">
- Set additional options for BiDi override.
- </member>
- <member name="syntax_highlighter" type="SyntaxHighlighter" setter="set_syntax_highlighter" getter="get_syntax_highlighter">
- Sets the [SyntaxHighlighter] to use.
- </member>
- <member name="text" type="String" setter="set_text" getter="get_text" default="""">
- String value of the [TextEdit].
- </member>
- <member name="text_direction" type="int" setter="set_text_direction" getter="get_text_direction" enum="Control.TextDirection" default="0">
- Base text writing direction.
- </member>
- <member name="virtual_keyboard_enabled" type="bool" setter="set_virtual_keyboard_enabled" getter="is_virtual_keyboard_enabled" default="true">
- If [code]true[/code], the native virtual keyboard is shown when focused on platforms that support it.
- </member>
- <member name="wrap_mode" type="int" setter="set_line_wrapping_mode" getter="get_line_wrapping_mode" enum="TextEdit.LineWrappingMode" default="0">
- Sets the line wrapping mode to use.
- </member>
- </members>
- <signals>
- <signal name="caret_changed">
- <description>
- Emitted when the caret changes position.
- </description>
- </signal>
- <signal name="gutter_added">
- <description>
- Emitted when a gutter is added.
- </description>
- </signal>
- <signal name="gutter_clicked">
- <argument index="0" name="line" type="int" />
- <argument index="1" name="gutter" type="int" />
- <description>
- Emitted when a gutter is clicked.
- </description>
- </signal>
- <signal name="gutter_removed">
- <description>
- Emitted when a gutter is removed.
- </description>
- </signal>
- <signal name="lines_edited_from">
- <argument index="0" name="from_line" type="int" />
- <argument index="1" name="to_line" type="int" />
- <description>
- Emitted immediately when the text changes.
- When text is added [code]from_line[/code] will be less then [code]to_line[/code]. On a remove [code]to_line[/code] will be less then [code]from_line[/code].
- </description>
- </signal>
- <signal name="text_changed">
- <description>
- Emitted when the text changes.
- </description>
- </signal>
- <signal name="text_set">
- <description>
- Emitted when [method clear] is called or [member text] is set.
- </description>
- </signal>
- </signals>
- <constants>
- <constant name="MENU_CUT" value="0" enum="MenuItems">
- Cuts (copies and clears) the selected text.
- </constant>
- <constant name="MENU_COPY" value="1" enum="MenuItems">
- Copies the selected text.
- </constant>
- <constant name="MENU_PASTE" value="2" enum="MenuItems">
- Pastes the clipboard text over the selected text (or at the cursor's position).
- </constant>
- <constant name="MENU_CLEAR" value="3" enum="MenuItems">
- Erases the whole [TextEdit] text.
- </constant>
- <constant name="MENU_SELECT_ALL" value="4" enum="MenuItems">
- Selects the whole [TextEdit] text.
- </constant>
- <constant name="MENU_UNDO" value="5" enum="MenuItems">
- Undoes the previous action.
- </constant>
- <constant name="MENU_REDO" value="6" enum="MenuItems">
- Redoes the previous action.
- </constant>
- <constant name="MENU_DIR_INHERITED" value="7" enum="MenuItems">
- Sets text direction to inherited.
- </constant>
- <constant name="MENU_DIR_AUTO" value="8" enum="MenuItems">
- Sets text direction to automatic.
- </constant>
- <constant name="MENU_DIR_LTR" value="9" enum="MenuItems">
- Sets text direction to left-to-right.
- </constant>
- <constant name="MENU_DIR_RTL" value="10" enum="MenuItems">
- Sets text direction to right-to-left.
- </constant>
- <constant name="MENU_DISPLAY_UCC" value="11" enum="MenuItems">
- Toggles control character display.
- </constant>
- <constant name="MENU_INSERT_LRM" value="12" enum="MenuItems">
- Inserts left-to-right mark (LRM) character.
- </constant>
- <constant name="MENU_INSERT_RLM" value="13" enum="MenuItems">
- Inserts right-to-left mark (RLM) character.
- </constant>
- <constant name="MENU_INSERT_LRE" value="14" enum="MenuItems">
- Inserts start of left-to-right embedding (LRE) character.
- </constant>
- <constant name="MENU_INSERT_RLE" value="15" enum="MenuItems">
- Inserts start of right-to-left embedding (RLE) character.
- </constant>
- <constant name="MENU_INSERT_LRO" value="16" enum="MenuItems">
- Inserts start of left-to-right override (LRO) character.
- </constant>
- <constant name="MENU_INSERT_RLO" value="17" enum="MenuItems">
- Inserts start of right-to-left override (RLO) character.
- </constant>
- <constant name="MENU_INSERT_PDF" value="18" enum="MenuItems">
- Inserts pop direction formatting (PDF) character.
- </constant>
- <constant name="MENU_INSERT_ALM" value="19" enum="MenuItems">
- Inserts Arabic letter mark (ALM) character.
- </constant>
- <constant name="MENU_INSERT_LRI" value="20" enum="MenuItems">
- Inserts left-to-right isolate (LRI) character.
- </constant>
- <constant name="MENU_INSERT_RLI" value="21" enum="MenuItems">
- Inserts right-to-left isolate (RLI) character.
- </constant>
- <constant name="MENU_INSERT_FSI" value="22" enum="MenuItems">
- Inserts first strong isolate (FSI) character.
- </constant>
- <constant name="MENU_INSERT_PDI" value="23" enum="MenuItems">
- Inserts pop direction isolate (PDI) character.
- </constant>
- <constant name="MENU_INSERT_ZWJ" value="24" enum="MenuItems">
- Inserts zero width joiner (ZWJ) character.
- </constant>
- <constant name="MENU_INSERT_ZWNJ" value="25" enum="MenuItems">
- Inserts zero width non-joiner (ZWNJ) character.
- </constant>
- <constant name="MENU_INSERT_WJ" value="26" enum="MenuItems">
- Inserts word joiner (WJ) character.
- </constant>
- <constant name="MENU_INSERT_SHY" value="27" enum="MenuItems">
- Inserts soft hyphen (SHY) character.
- </constant>
- <constant name="MENU_MAX" value="28" enum="MenuItems">
- Represents the size of the [enum MenuItems] enum.
- </constant>
- <constant name="SEARCH_MATCH_CASE" value="1" enum="SearchFlags">
- Match case when searching.
- </constant>
- <constant name="SEARCH_WHOLE_WORDS" value="2" enum="SearchFlags">
- Match whole words when searching.
- </constant>
- <constant name="SEARCH_BACKWARDS" value="4" enum="SearchFlags">
- Search from end to beginning.
- </constant>
- <constant name="CARET_TYPE_LINE" value="0" enum="CaretType">
- Vertical line caret.
- </constant>
- <constant name="CARET_TYPE_BLOCK" value="1" enum="CaretType">
- Block caret.
- </constant>
- <constant name="SELECTION_MODE_NONE" value="0" enum="SelectionMode">
- Not selecting.
- </constant>
- <constant name="SELECTION_MODE_SHIFT" value="1" enum="SelectionMode">
- Select as if [code]shift[/code] is pressed.
- </constant>
- <constant name="SELECTION_MODE_POINTER" value="2" enum="SelectionMode">
- Select single characters as if the user single clicked.
- </constant>
- <constant name="SELECTION_MODE_WORD" value="3" enum="SelectionMode">
- Select whole words as if the user double clicked.
- </constant>
- <constant name="SELECTION_MODE_LINE" value="4" enum="SelectionMode">
- Select whole lines as if the user tripped clicked.
- </constant>
- <constant name="LINE_WRAPPING_NONE" value="0" enum="LineWrappingMode">
- Line wrapping is disabled.
- </constant>
- <constant name="LINE_WRAPPING_BOUNDARY" value="1" enum="LineWrappingMode">
- Line wrapping occurs at the control boundary, beyond what would normally be visible.
- </constant>
- <constant name="GUTTER_TYPE_STRING" value="0" enum="GutterType">
- Draw a string.
- </constant>
- <constant name="GUTTER_TYPE_ICON" value="1" enum="GutterType">
- Draw an icon.
- </constant>
- <constant name="GUTTER_TYPE_CUSTOM" value="2" enum="GutterType">
- Custom draw.
- </constant>
- </constants>
- <theme_items>
- <theme_item name="background_color" data_type="color" type="Color" default="Color(0, 0, 0, 0)">
- Sets the background [Color] of this [TextEdit].
- </theme_item>
- <theme_item name="caret_background_color" data_type="color" type="Color" default="Color(0, 0, 0, 1)">
- [Color] of the text behind the caret when using a block caret.
- </theme_item>
- <theme_item name="caret_color" data_type="color" type="Color" default="Color(0.88, 0.88, 0.88, 1)">
- [Color] of the caret.
- </theme_item>
- <theme_item name="current_line_color" data_type="color" type="Color" default="Color(0.25, 0.25, 0.26, 0.8)">
- Background [Color] of the line containing the caret.
- </theme_item>
- <theme_item name="focus" data_type="style" type="StyleBox">
- Sets the [StyleBox] when in focus.
- </theme_item>
- <theme_item name="font" data_type="font" type="Font">
- Sets the default [Font].
- </theme_item>
- <theme_item name="font_color" data_type="color" type="Color" default="Color(0.88, 0.88, 0.88, 1)">
- Sets the font [Color].
- </theme_item>
- <theme_item name="font_outline_color" data_type="color" type="Color" default="Color(1, 1, 1, 1)">
- The tint of text outline of the [TextEdit].
- </theme_item>
- <theme_item name="font_readonly_color" data_type="color" type="Color" default="Color(0.88, 0.88, 0.88, 0.5)">
- Sets the font [Color] when [member editable] is disabled.
- </theme_item>
- <theme_item name="font_selected_color" data_type="color" type="Color" default="Color(0, 0, 0, 1)">
- Sets the [Color] of the selected text. [member override_selected_font_color] has to be enabled.
- </theme_item>
- <theme_item name="font_size" data_type="font_size" type="int">
- Sets default font size.
- </theme_item>
- <theme_item name="line_spacing" data_type="constant" type="int" default="4">
- Sets the spacing between the lines.
- </theme_item>
- <theme_item name="normal" data_type="style" type="StyleBox">
- Sets the [StyleBox] of this [TextEdit].
- </theme_item>
- <theme_item name="outline_size" data_type="constant" type="int" default="0">
- The size of the text outline.
- </theme_item>
- <theme_item name="read_only" data_type="style" type="StyleBox">
- Sets the [StyleBox] of this [TextEdit] when [member editable] is disabled.
- </theme_item>
- <theme_item name="selection_color" data_type="color" type="Color" default="Color(0.49, 0.49, 0.49, 1)">
- Sets the highlight [Color] of text selections.
- </theme_item>
- <theme_item name="space" data_type="icon" type="Texture2D">
- Sets a custom [Texture2D] for space text characters.
- </theme_item>
- <theme_item name="tab" data_type="icon" type="Texture2D">
- Sets a custom [Texture2D] for tab text characters.
- </theme_item>
- <theme_item name="word_highlighted_color" data_type="color" type="Color" default="Color(0.8, 0.9, 0.9, 0.15)">
- Sets the highlight [Color] of multiple occurrences. [member highlight_all_occurrences] has to be enabled.
- </theme_item>
- </theme_items>
- </class>
|