class_textedit.rst 198 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/TextEdit.xml.
  6. .. _class_TextEdit:
  7. TextEdit
  8. ========
  9. **Inherits:** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  10. **Inherited By:** :ref:`CodeEdit<class_CodeEdit>`
  11. A multiline text editor.
  12. .. rst-class:: classref-introduction-group
  13. Description
  14. -----------
  15. 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<class_CodeEdit>`.
  16. \ **Note:** Most viewport, caret and edit methods contain a ``caret_index`` argument for :ref:`caret_multiple<class_TextEdit_property_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.
  17. \ **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.
  18. .. rst-class:: classref-reftable-group
  19. Properties
  20. ----------
  21. .. table::
  22. :widths: auto
  23. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  24. | :ref:`bool<class_bool>` | :ref:`caret_blink<class_TextEdit_property_caret_blink>` | ``false`` |
  25. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  26. | :ref:`float<class_float>` | :ref:`caret_blink_interval<class_TextEdit_property_caret_blink_interval>` | ``0.65`` |
  27. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  28. | :ref:`bool<class_bool>` | :ref:`caret_mid_grapheme<class_TextEdit_property_caret_mid_grapheme>` | ``true`` |
  29. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  30. | :ref:`bool<class_bool>` | :ref:`caret_move_on_right_click<class_TextEdit_property_caret_move_on_right_click>` | ``true`` |
  31. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  32. | :ref:`bool<class_bool>` | :ref:`caret_multiple<class_TextEdit_property_caret_multiple>` | ``true`` |
  33. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  34. | :ref:`CaretType<enum_TextEdit_CaretType>` | :ref:`caret_type<class_TextEdit_property_caret_type>` | ``0`` |
  35. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  36. | :ref:`bool<class_bool>` | :ref:`context_menu_enabled<class_TextEdit_property_context_menu_enabled>` | ``true`` |
  37. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  38. | :ref:`bool<class_bool>` | :ref:`deselect_on_focus_loss_enabled<class_TextEdit_property_deselect_on_focus_loss_enabled>` | ``true`` |
  39. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  40. | :ref:`bool<class_bool>` | :ref:`drag_and_drop_selection_enabled<class_TextEdit_property_drag_and_drop_selection_enabled>` | ``true`` |
  41. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  42. | :ref:`bool<class_bool>` | :ref:`draw_control_chars<class_TextEdit_property_draw_control_chars>` | ``false`` |
  43. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  44. | :ref:`bool<class_bool>` | :ref:`draw_spaces<class_TextEdit_property_draw_spaces>` | ``false`` |
  45. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  46. | :ref:`bool<class_bool>` | :ref:`draw_tabs<class_TextEdit_property_draw_tabs>` | ``false`` |
  47. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  48. | :ref:`bool<class_bool>` | :ref:`editable<class_TextEdit_property_editable>` | ``true`` |
  49. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  50. | :ref:`FocusMode<enum_Control_FocusMode>` | focus_mode | ``2`` (overrides :ref:`Control<class_Control_property_focus_mode>`) |
  51. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  52. | :ref:`bool<class_bool>` | :ref:`highlight_all_occurrences<class_TextEdit_property_highlight_all_occurrences>` | ``false`` |
  53. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  54. | :ref:`bool<class_bool>` | :ref:`highlight_current_line<class_TextEdit_property_highlight_current_line>` | ``false`` |
  55. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  56. | :ref:`String<class_String>` | :ref:`language<class_TextEdit_property_language>` | ``""`` |
  57. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  58. | :ref:`bool<class_bool>` | :ref:`middle_mouse_paste_enabled<class_TextEdit_property_middle_mouse_paste_enabled>` | ``true`` |
  59. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  60. | :ref:`bool<class_bool>` | :ref:`minimap_draw<class_TextEdit_property_minimap_draw>` | ``false`` |
  61. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  62. | :ref:`int<class_int>` | :ref:`minimap_width<class_TextEdit_property_minimap_width>` | ``80`` |
  63. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  64. | :ref:`CursorShape<enum_Control_CursorShape>` | mouse_default_cursor_shape | ``1`` (overrides :ref:`Control<class_Control_property_mouse_default_cursor_shape>`) |
  65. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  66. | :ref:`String<class_String>` | :ref:`placeholder_text<class_TextEdit_property_placeholder_text>` | ``""`` |
  67. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  68. | :ref:`bool<class_bool>` | :ref:`scroll_fit_content_height<class_TextEdit_property_scroll_fit_content_height>` | ``false`` |
  69. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  70. | :ref:`int<class_int>` | :ref:`scroll_horizontal<class_TextEdit_property_scroll_horizontal>` | ``0`` |
  71. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  72. | :ref:`bool<class_bool>` | :ref:`scroll_past_end_of_file<class_TextEdit_property_scroll_past_end_of_file>` | ``false`` |
  73. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  74. | :ref:`bool<class_bool>` | :ref:`scroll_smooth<class_TextEdit_property_scroll_smooth>` | ``false`` |
  75. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  76. | :ref:`float<class_float>` | :ref:`scroll_v_scroll_speed<class_TextEdit_property_scroll_v_scroll_speed>` | ``80.0`` |
  77. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  78. | :ref:`float<class_float>` | :ref:`scroll_vertical<class_TextEdit_property_scroll_vertical>` | ``0.0`` |
  79. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  80. | :ref:`bool<class_bool>` | :ref:`selecting_enabled<class_TextEdit_property_selecting_enabled>` | ``true`` |
  81. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  82. | :ref:`bool<class_bool>` | :ref:`shortcut_keys_enabled<class_TextEdit_property_shortcut_keys_enabled>` | ``true`` |
  83. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  84. | :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` | :ref:`structured_text_bidi_override<class_TextEdit_property_structured_text_bidi_override>` | ``0`` |
  85. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  86. | :ref:`Array<class_Array>` | :ref:`structured_text_bidi_override_options<class_TextEdit_property_structured_text_bidi_override_options>` | ``[]`` |
  87. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  88. | :ref:`SyntaxHighlighter<class_SyntaxHighlighter>` | :ref:`syntax_highlighter<class_TextEdit_property_syntax_highlighter>` | |
  89. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  90. | :ref:`String<class_String>` | :ref:`text<class_TextEdit_property_text>` | ``""`` |
  91. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  92. | :ref:`TextDirection<enum_Control_TextDirection>` | :ref:`text_direction<class_TextEdit_property_text_direction>` | ``0`` |
  93. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  94. | :ref:`bool<class_bool>` | :ref:`virtual_keyboard_enabled<class_TextEdit_property_virtual_keyboard_enabled>` | ``true`` |
  95. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  96. | :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` | :ref:`wrap_mode<class_TextEdit_property_wrap_mode>` | ``0`` |
  97. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  98. .. rst-class:: classref-reftable-group
  99. Methods
  100. -------
  101. .. table::
  102. :widths: auto
  103. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  104. | void | :ref:`_backspace<class_TextEdit_method__backspace>` **(** :ref:`int<class_int>` caret_index **)** |virtual| |
  105. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  106. | void | :ref:`_copy<class_TextEdit_method__copy>` **(** :ref:`int<class_int>` caret_index **)** |virtual| |
  107. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  108. | void | :ref:`_cut<class_TextEdit_method__cut>` **(** :ref:`int<class_int>` caret_index **)** |virtual| |
  109. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  110. | void | :ref:`_handle_unicode_input<class_TextEdit_method__handle_unicode_input>` **(** :ref:`int<class_int>` unicode_char, :ref:`int<class_int>` caret_index **)** |virtual| |
  111. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  112. | void | :ref:`_paste<class_TextEdit_method__paste>` **(** :ref:`int<class_int>` caret_index **)** |virtual| |
  113. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  114. | void | :ref:`_paste_primary_clipboard<class_TextEdit_method__paste_primary_clipboard>` **(** :ref:`int<class_int>` caret_index **)** |virtual| |
  115. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  116. | :ref:`int<class_int>` | :ref:`add_caret<class_TextEdit_method_add_caret>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` col **)** |
  117. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  118. | void | :ref:`add_caret_at_carets<class_TextEdit_method_add_caret_at_carets>` **(** :ref:`bool<class_bool>` below **)** |
  119. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  120. | void | :ref:`add_gutter<class_TextEdit_method_add_gutter>` **(** :ref:`int<class_int>` at=-1 **)** |
  121. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  122. | void | :ref:`add_selection_for_next_occurrence<class_TextEdit_method_add_selection_for_next_occurrence>` **(** **)** |
  123. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  124. | void | :ref:`adjust_carets_after_edit<class_TextEdit_method_adjust_carets_after_edit>` **(** :ref:`int<class_int>` caret, :ref:`int<class_int>` from_line, :ref:`int<class_int>` from_col, :ref:`int<class_int>` to_line, :ref:`int<class_int>` to_col **)** |
  125. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  126. | void | :ref:`adjust_viewport_to_caret<class_TextEdit_method_adjust_viewport_to_caret>` **(** :ref:`int<class_int>` caret_index=0 **)** |
  127. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  128. | void | :ref:`backspace<class_TextEdit_method_backspace>` **(** :ref:`int<class_int>` caret_index=-1 **)** |
  129. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  130. | void | :ref:`begin_complex_operation<class_TextEdit_method_begin_complex_operation>` **(** **)** |
  131. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  132. | void | :ref:`center_viewport_to_caret<class_TextEdit_method_center_viewport_to_caret>` **(** :ref:`int<class_int>` caret_index=0 **)** |
  133. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  134. | void | :ref:`clear<class_TextEdit_method_clear>` **(** **)** |
  135. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  136. | void | :ref:`clear_undo_history<class_TextEdit_method_clear_undo_history>` **(** **)** |
  137. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  138. | void | :ref:`copy<class_TextEdit_method_copy>` **(** :ref:`int<class_int>` caret_index=-1 **)** |
  139. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  140. | void | :ref:`cut<class_TextEdit_method_cut>` **(** :ref:`int<class_int>` caret_index=-1 **)** |
  141. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  142. | void | :ref:`delete_selection<class_TextEdit_method_delete_selection>` **(** :ref:`int<class_int>` caret_index=-1 **)** |
  143. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  144. | void | :ref:`deselect<class_TextEdit_method_deselect>` **(** :ref:`int<class_int>` caret_index=-1 **)** |
  145. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  146. | void | :ref:`end_action<class_TextEdit_method_end_action>` **(** **)** |
  147. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  148. | void | :ref:`end_complex_operation<class_TextEdit_method_end_complex_operation>` **(** **)** |
  149. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  150. | :ref:`int<class_int>` | :ref:`get_caret_column<class_TextEdit_method_get_caret_column>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  151. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  152. | :ref:`int<class_int>` | :ref:`get_caret_count<class_TextEdit_method_get_caret_count>` **(** **)** |const| |
  153. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  154. | :ref:`Vector2<class_Vector2>` | :ref:`get_caret_draw_pos<class_TextEdit_method_get_caret_draw_pos>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  155. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  156. | :ref:`PackedInt32Array<class_PackedInt32Array>` | :ref:`get_caret_index_edit_order<class_TextEdit_method_get_caret_index_edit_order>` **(** **)** |
  157. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  158. | :ref:`int<class_int>` | :ref:`get_caret_line<class_TextEdit_method_get_caret_line>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  159. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  160. | :ref:`int<class_int>` | :ref:`get_caret_wrap_index<class_TextEdit_method_get_caret_wrap_index>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  161. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  162. | :ref:`int<class_int>` | :ref:`get_first_non_whitespace_column<class_TextEdit_method_get_first_non_whitespace_column>` **(** :ref:`int<class_int>` line **)** |const| |
  163. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  164. | :ref:`int<class_int>` | :ref:`get_first_visible_line<class_TextEdit_method_get_first_visible_line>` **(** **)** |const| |
  165. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  166. | :ref:`int<class_int>` | :ref:`get_gutter_count<class_TextEdit_method_get_gutter_count>` **(** **)** |const| |
  167. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  168. | :ref:`String<class_String>` | :ref:`get_gutter_name<class_TextEdit_method_get_gutter_name>` **(** :ref:`int<class_int>` gutter **)** |const| |
  169. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  170. | :ref:`GutterType<enum_TextEdit_GutterType>` | :ref:`get_gutter_type<class_TextEdit_method_get_gutter_type>` **(** :ref:`int<class_int>` gutter **)** |const| |
  171. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  172. | :ref:`int<class_int>` | :ref:`get_gutter_width<class_TextEdit_method_get_gutter_width>` **(** :ref:`int<class_int>` gutter **)** |const| |
  173. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  174. | :ref:`HScrollBar<class_HScrollBar>` | :ref:`get_h_scroll_bar<class_TextEdit_method_get_h_scroll_bar>` **(** **)** |const| |
  175. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  176. | :ref:`int<class_int>` | :ref:`get_indent_level<class_TextEdit_method_get_indent_level>` **(** :ref:`int<class_int>` line **)** |const| |
  177. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  178. | :ref:`int<class_int>` | :ref:`get_last_full_visible_line<class_TextEdit_method_get_last_full_visible_line>` **(** **)** |const| |
  179. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  180. | :ref:`int<class_int>` | :ref:`get_last_full_visible_line_wrap_index<class_TextEdit_method_get_last_full_visible_line_wrap_index>` **(** **)** |const| |
  181. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  182. | :ref:`int<class_int>` | :ref:`get_last_unhidden_line<class_TextEdit_method_get_last_unhidden_line>` **(** **)** |const| |
  183. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  184. | :ref:`String<class_String>` | :ref:`get_line<class_TextEdit_method_get_line>` **(** :ref:`int<class_int>` line **)** |const| |
  185. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  186. | :ref:`Color<class_Color>` | :ref:`get_line_background_color<class_TextEdit_method_get_line_background_color>` **(** :ref:`int<class_int>` line **)** |const| |
  187. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  188. | :ref:`Vector2i<class_Vector2i>` | :ref:`get_line_column_at_pos<class_TextEdit_method_get_line_column_at_pos>` **(** :ref:`Vector2i<class_Vector2i>` position, :ref:`bool<class_bool>` allow_out_of_bounds=true **)** |const| |
  189. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  190. | :ref:`int<class_int>` | :ref:`get_line_count<class_TextEdit_method_get_line_count>` **(** **)** |const| |
  191. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  192. | :ref:`Texture2D<class_Texture2D>` | :ref:`get_line_gutter_icon<class_TextEdit_method_get_line_gutter_icon>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const| |
  193. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  194. | :ref:`Color<class_Color>` | :ref:`get_line_gutter_item_color<class_TextEdit_method_get_line_gutter_item_color>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const| |
  195. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  196. | :ref:`Variant<class_Variant>` | :ref:`get_line_gutter_metadata<class_TextEdit_method_get_line_gutter_metadata>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const| |
  197. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  198. | :ref:`String<class_String>` | :ref:`get_line_gutter_text<class_TextEdit_method_get_line_gutter_text>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const| |
  199. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  200. | :ref:`int<class_int>` | :ref:`get_line_height<class_TextEdit_method_get_line_height>` **(** **)** |const| |
  201. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  202. | :ref:`int<class_int>` | :ref:`get_line_width<class_TextEdit_method_get_line_width>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=-1 **)** |const| |
  203. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  204. | :ref:`int<class_int>` | :ref:`get_line_wrap_count<class_TextEdit_method_get_line_wrap_count>` **(** :ref:`int<class_int>` line **)** |const| |
  205. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  206. | :ref:`int<class_int>` | :ref:`get_line_wrap_index_at_column<class_TextEdit_method_get_line_wrap_index_at_column>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const| |
  207. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  208. | :ref:`PackedStringArray<class_PackedStringArray>` | :ref:`get_line_wrapped_text<class_TextEdit_method_get_line_wrapped_text>` **(** :ref:`int<class_int>` line **)** |const| |
  209. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  210. | :ref:`Vector2<class_Vector2>` | :ref:`get_local_mouse_pos<class_TextEdit_method_get_local_mouse_pos>` **(** **)** |const| |
  211. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  212. | :ref:`PopupMenu<class_PopupMenu>` | :ref:`get_menu<class_TextEdit_method_get_menu>` **(** **)** |const| |
  213. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  214. | :ref:`int<class_int>` | :ref:`get_minimap_line_at_pos<class_TextEdit_method_get_minimap_line_at_pos>` **(** :ref:`Vector2i<class_Vector2i>` position **)** |const| |
  215. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  216. | :ref:`int<class_int>` | :ref:`get_minimap_visible_lines<class_TextEdit_method_get_minimap_visible_lines>` **(** **)** |const| |
  217. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  218. | :ref:`Vector2i<class_Vector2i>` | :ref:`get_next_visible_line_index_offset_from<class_TextEdit_method_get_next_visible_line_index_offset_from>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index, :ref:`int<class_int>` visible_amount **)** |const| |
  219. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  220. | :ref:`int<class_int>` | :ref:`get_next_visible_line_offset_from<class_TextEdit_method_get_next_visible_line_offset_from>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` visible_amount **)** |const| |
  221. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  222. | :ref:`Vector2i<class_Vector2i>` | :ref:`get_pos_at_line_column<class_TextEdit_method_get_pos_at_line_column>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const| |
  223. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  224. | :ref:`Rect2i<class_Rect2i>` | :ref:`get_rect_at_line_column<class_TextEdit_method_get_rect_at_line_column>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const| |
  225. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  226. | :ref:`int<class_int>` | :ref:`get_saved_version<class_TextEdit_method_get_saved_version>` **(** **)** |const| |
  227. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  228. | :ref:`float<class_float>` | :ref:`get_scroll_pos_for_line<class_TextEdit_method_get_scroll_pos_for_line>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=0 **)** |const| |
  229. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  230. | :ref:`String<class_String>` | :ref:`get_selected_text<class_TextEdit_method_get_selected_text>` **(** :ref:`int<class_int>` caret_index=-1 **)** |
  231. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  232. | :ref:`int<class_int>` | :ref:`get_selection_column<class_TextEdit_method_get_selection_column>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  233. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  234. | :ref:`int<class_int>` | :ref:`get_selection_from_column<class_TextEdit_method_get_selection_from_column>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  235. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  236. | :ref:`int<class_int>` | :ref:`get_selection_from_line<class_TextEdit_method_get_selection_from_line>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  237. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  238. | :ref:`int<class_int>` | :ref:`get_selection_line<class_TextEdit_method_get_selection_line>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  239. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  240. | :ref:`SelectionMode<enum_TextEdit_SelectionMode>` | :ref:`get_selection_mode<class_TextEdit_method_get_selection_mode>` **(** **)** |const| |
  241. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  242. | :ref:`int<class_int>` | :ref:`get_selection_to_column<class_TextEdit_method_get_selection_to_column>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  243. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  244. | :ref:`int<class_int>` | :ref:`get_selection_to_line<class_TextEdit_method_get_selection_to_line>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  245. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  246. | :ref:`int<class_int>` | :ref:`get_tab_size<class_TextEdit_method_get_tab_size>` **(** **)** |const| |
  247. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  248. | :ref:`int<class_int>` | :ref:`get_total_gutter_width<class_TextEdit_method_get_total_gutter_width>` **(** **)** |const| |
  249. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  250. | :ref:`int<class_int>` | :ref:`get_total_visible_line_count<class_TextEdit_method_get_total_visible_line_count>` **(** **)** |const| |
  251. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  252. | :ref:`VScrollBar<class_VScrollBar>` | :ref:`get_v_scroll_bar<class_TextEdit_method_get_v_scroll_bar>` **(** **)** |const| |
  253. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  254. | :ref:`int<class_int>` | :ref:`get_version<class_TextEdit_method_get_version>` **(** **)** |const| |
  255. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  256. | :ref:`int<class_int>` | :ref:`get_visible_line_count<class_TextEdit_method_get_visible_line_count>` **(** **)** |const| |
  257. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  258. | :ref:`int<class_int>` | :ref:`get_visible_line_count_in_range<class_TextEdit_method_get_visible_line_count_in_range>` **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` to_line **)** |const| |
  259. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  260. | :ref:`String<class_String>` | :ref:`get_word_at_pos<class_TextEdit_method_get_word_at_pos>` **(** :ref:`Vector2<class_Vector2>` position **)** |const| |
  261. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  262. | :ref:`String<class_String>` | :ref:`get_word_under_caret<class_TextEdit_method_get_word_under_caret>` **(** :ref:`int<class_int>` caret_index=-1 **)** |const| |
  263. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  264. | :ref:`bool<class_bool>` | :ref:`has_ime_text<class_TextEdit_method_has_ime_text>` **(** **)** |const| |
  265. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  266. | :ref:`bool<class_bool>` | :ref:`has_redo<class_TextEdit_method_has_redo>` **(** **)** |const| |
  267. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  268. | :ref:`bool<class_bool>` | :ref:`has_selection<class_TextEdit_method_has_selection>` **(** :ref:`int<class_int>` caret_index=-1 **)** |const| |
  269. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  270. | :ref:`bool<class_bool>` | :ref:`has_undo<class_TextEdit_method_has_undo>` **(** **)** |const| |
  271. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  272. | void | :ref:`insert_line_at<class_TextEdit_method_insert_line_at>` **(** :ref:`int<class_int>` line, :ref:`String<class_String>` text **)** |
  273. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  274. | void | :ref:`insert_text_at_caret<class_TextEdit_method_insert_text_at_caret>` **(** :ref:`String<class_String>` text, :ref:`int<class_int>` caret_index=-1 **)** |
  275. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  276. | :ref:`bool<class_bool>` | :ref:`is_caret_visible<class_TextEdit_method_is_caret_visible>` **(** :ref:`int<class_int>` caret_index=0 **)** |const| |
  277. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  278. | :ref:`bool<class_bool>` | :ref:`is_dragging_cursor<class_TextEdit_method_is_dragging_cursor>` **(** **)** |const| |
  279. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  280. | :ref:`bool<class_bool>` | :ref:`is_gutter_clickable<class_TextEdit_method_is_gutter_clickable>` **(** :ref:`int<class_int>` gutter **)** |const| |
  281. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  282. | :ref:`bool<class_bool>` | :ref:`is_gutter_drawn<class_TextEdit_method_is_gutter_drawn>` **(** :ref:`int<class_int>` gutter **)** |const| |
  283. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  284. | :ref:`bool<class_bool>` | :ref:`is_gutter_overwritable<class_TextEdit_method_is_gutter_overwritable>` **(** :ref:`int<class_int>` gutter **)** |const| |
  285. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  286. | :ref:`bool<class_bool>` | :ref:`is_line_gutter_clickable<class_TextEdit_method_is_line_gutter_clickable>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const| |
  287. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  288. | :ref:`bool<class_bool>` | :ref:`is_line_wrapped<class_TextEdit_method_is_line_wrapped>` **(** :ref:`int<class_int>` line **)** |const| |
  289. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  290. | :ref:`bool<class_bool>` | :ref:`is_menu_visible<class_TextEdit_method_is_menu_visible>` **(** **)** |const| |
  291. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  292. | :ref:`bool<class_bool>` | :ref:`is_mouse_over_selection<class_TextEdit_method_is_mouse_over_selection>` **(** :ref:`bool<class_bool>` edges, :ref:`int<class_int>` caret_index=-1 **)** |const| |
  293. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  294. | :ref:`bool<class_bool>` | :ref:`is_overtype_mode_enabled<class_TextEdit_method_is_overtype_mode_enabled>` **(** **)** |const| |
  295. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  296. | void | :ref:`menu_option<class_TextEdit_method_menu_option>` **(** :ref:`int<class_int>` option **)** |
  297. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  298. | void | :ref:`merge_gutters<class_TextEdit_method_merge_gutters>` **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` to_line **)** |
  299. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  300. | void | :ref:`merge_overlapping_carets<class_TextEdit_method_merge_overlapping_carets>` **(** **)** |
  301. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  302. | void | :ref:`paste<class_TextEdit_method_paste>` **(** :ref:`int<class_int>` caret_index=-1 **)** |
  303. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  304. | void | :ref:`paste_primary_clipboard<class_TextEdit_method_paste_primary_clipboard>` **(** :ref:`int<class_int>` caret_index=-1 **)** |
  305. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  306. | void | :ref:`redo<class_TextEdit_method_redo>` **(** **)** |
  307. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  308. | void | :ref:`remove_caret<class_TextEdit_method_remove_caret>` **(** :ref:`int<class_int>` caret **)** |
  309. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  310. | void | :ref:`remove_gutter<class_TextEdit_method_remove_gutter>` **(** :ref:`int<class_int>` gutter **)** |
  311. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  312. | void | :ref:`remove_secondary_carets<class_TextEdit_method_remove_secondary_carets>` **(** **)** |
  313. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  314. | void | :ref:`remove_text<class_TextEdit_method_remove_text>` **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` from_column, :ref:`int<class_int>` to_line, :ref:`int<class_int>` to_column **)** |
  315. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  316. | :ref:`Vector2i<class_Vector2i>` | :ref:`search<class_TextEdit_method_search>` **(** :ref:`String<class_String>` text, :ref:`int<class_int>` flags, :ref:`int<class_int>` from_line, :ref:`int<class_int>` from_colum **)** |const| |
  317. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  318. | void | :ref:`select<class_TextEdit_method_select>` **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` from_column, :ref:`int<class_int>` to_line, :ref:`int<class_int>` to_column, :ref:`int<class_int>` caret_index=0 **)** |
  319. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  320. | void | :ref:`select_all<class_TextEdit_method_select_all>` **(** **)** |
  321. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  322. | void | :ref:`select_word_under_caret<class_TextEdit_method_select_word_under_caret>` **(** :ref:`int<class_int>` caret_index=-1 **)** |
  323. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  324. | void | :ref:`set_caret_column<class_TextEdit_method_set_caret_column>` **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` adjust_viewport=true, :ref:`int<class_int>` caret_index=0 **)** |
  325. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  326. | void | :ref:`set_caret_line<class_TextEdit_method_set_caret_line>` **(** :ref:`int<class_int>` line, :ref:`bool<class_bool>` adjust_viewport=true, :ref:`bool<class_bool>` can_be_hidden=true, :ref:`int<class_int>` wrap_index=0, :ref:`int<class_int>` caret_index=0 **)** |
  327. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  328. | void | :ref:`set_gutter_clickable<class_TextEdit_method_set_gutter_clickable>` **(** :ref:`int<class_int>` gutter, :ref:`bool<class_bool>` clickable **)** |
  329. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  330. | void | :ref:`set_gutter_custom_draw<class_TextEdit_method_set_gutter_custom_draw>` **(** :ref:`int<class_int>` column, :ref:`Callable<class_Callable>` draw_callback **)** |
  331. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  332. | void | :ref:`set_gutter_draw<class_TextEdit_method_set_gutter_draw>` **(** :ref:`int<class_int>` gutter, :ref:`bool<class_bool>` draw **)** |
  333. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  334. | void | :ref:`set_gutter_name<class_TextEdit_method_set_gutter_name>` **(** :ref:`int<class_int>` gutter, :ref:`String<class_String>` name **)** |
  335. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  336. | void | :ref:`set_gutter_overwritable<class_TextEdit_method_set_gutter_overwritable>` **(** :ref:`int<class_int>` gutter, :ref:`bool<class_bool>` overwritable **)** |
  337. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  338. | void | :ref:`set_gutter_type<class_TextEdit_method_set_gutter_type>` **(** :ref:`int<class_int>` gutter, :ref:`GutterType<enum_TextEdit_GutterType>` type **)** |
  339. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  340. | void | :ref:`set_gutter_width<class_TextEdit_method_set_gutter_width>` **(** :ref:`int<class_int>` gutter, :ref:`int<class_int>` width **)** |
  341. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  342. | void | :ref:`set_line<class_TextEdit_method_set_line>` **(** :ref:`int<class_int>` line, :ref:`String<class_String>` new_text **)** |
  343. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  344. | void | :ref:`set_line_as_center_visible<class_TextEdit_method_set_line_as_center_visible>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=0 **)** |
  345. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  346. | void | :ref:`set_line_as_first_visible<class_TextEdit_method_set_line_as_first_visible>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=0 **)** |
  347. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  348. | void | :ref:`set_line_as_last_visible<class_TextEdit_method_set_line_as_last_visible>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=0 **)** |
  349. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  350. | void | :ref:`set_line_background_color<class_TextEdit_method_set_line_background_color>` **(** :ref:`int<class_int>` line, :ref:`Color<class_Color>` color **)** |
  351. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  352. | void | :ref:`set_line_gutter_clickable<class_TextEdit_method_set_line_gutter_clickable>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`bool<class_bool>` clickable **)** |
  353. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  354. | void | :ref:`set_line_gutter_icon<class_TextEdit_method_set_line_gutter_icon>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`Texture2D<class_Texture2D>` icon **)** |
  355. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  356. | void | :ref:`set_line_gutter_item_color<class_TextEdit_method_set_line_gutter_item_color>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`Color<class_Color>` color **)** |
  357. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  358. | void | :ref:`set_line_gutter_metadata<class_TextEdit_method_set_line_gutter_metadata>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`Variant<class_Variant>` metadata **)** |
  359. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  360. | void | :ref:`set_line_gutter_text<class_TextEdit_method_set_line_gutter_text>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`String<class_String>` text **)** |
  361. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  362. | void | :ref:`set_overtype_mode_enabled<class_TextEdit_method_set_overtype_mode_enabled>` **(** :ref:`bool<class_bool>` enabled **)** |
  363. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  364. | void | :ref:`set_search_flags<class_TextEdit_method_set_search_flags>` **(** :ref:`int<class_int>` flags **)** |
  365. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  366. | void | :ref:`set_search_text<class_TextEdit_method_set_search_text>` **(** :ref:`String<class_String>` search_text **)** |
  367. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  368. | void | :ref:`set_selection_mode<class_TextEdit_method_set_selection_mode>` **(** :ref:`SelectionMode<enum_TextEdit_SelectionMode>` mode, :ref:`int<class_int>` line=-1, :ref:`int<class_int>` column=-1, :ref:`int<class_int>` caret_index=0 **)** |
  369. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  370. | void | :ref:`set_tab_size<class_TextEdit_method_set_tab_size>` **(** :ref:`int<class_int>` size **)** |
  371. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  372. | void | :ref:`set_tooltip_request_func<class_TextEdit_method_set_tooltip_request_func>` **(** :ref:`Callable<class_Callable>` callback **)** |
  373. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  374. | void | :ref:`start_action<class_TextEdit_method_start_action>` **(** :ref:`EditAction<enum_TextEdit_EditAction>` action **)** |
  375. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  376. | void | :ref:`swap_lines<class_TextEdit_method_swap_lines>` **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` to_line **)** |
  377. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  378. | void | :ref:`tag_saved_version<class_TextEdit_method_tag_saved_version>` **(** **)** |
  379. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  380. | void | :ref:`undo<class_TextEdit_method_undo>` **(** **)** |
  381. +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  382. .. rst-class:: classref-reftable-group
  383. Theme Properties
  384. ----------------
  385. .. table::
  386. :widths: auto
  387. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  388. | :ref:`Color<class_Color>` | :ref:`background_color<class_TextEdit_theme_color_background_color>` | ``Color(0, 0, 0, 0)`` |
  389. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  390. | :ref:`Color<class_Color>` | :ref:`caret_background_color<class_TextEdit_theme_color_caret_background_color>` | ``Color(0, 0, 0, 1)`` |
  391. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  392. | :ref:`Color<class_Color>` | :ref:`caret_color<class_TextEdit_theme_color_caret_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  393. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  394. | :ref:`Color<class_Color>` | :ref:`current_line_color<class_TextEdit_theme_color_current_line_color>` | ``Color(0.25, 0.25, 0.26, 0.8)`` |
  395. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  396. | :ref:`Color<class_Color>` | :ref:`font_color<class_TextEdit_theme_color_font_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  397. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  398. | :ref:`Color<class_Color>` | :ref:`font_outline_color<class_TextEdit_theme_color_font_outline_color>` | ``Color(1, 1, 1, 1)`` |
  399. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  400. | :ref:`Color<class_Color>` | :ref:`font_placeholder_color<class_TextEdit_theme_color_font_placeholder_color>` | ``Color(0.875, 0.875, 0.875, 0.6)`` |
  401. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  402. | :ref:`Color<class_Color>` | :ref:`font_readonly_color<class_TextEdit_theme_color_font_readonly_color>` | ``Color(0.875, 0.875, 0.875, 0.5)`` |
  403. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  404. | :ref:`Color<class_Color>` | :ref:`font_selected_color<class_TextEdit_theme_color_font_selected_color>` | ``Color(0, 0, 0, 0)`` |
  405. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  406. | :ref:`Color<class_Color>` | :ref:`search_result_border_color<class_TextEdit_theme_color_search_result_border_color>` | ``Color(0.3, 0.3, 0.3, 0.4)`` |
  407. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  408. | :ref:`Color<class_Color>` | :ref:`search_result_color<class_TextEdit_theme_color_search_result_color>` | ``Color(0.3, 0.3, 0.3, 1)`` |
  409. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  410. | :ref:`Color<class_Color>` | :ref:`selection_color<class_TextEdit_theme_color_selection_color>` | ``Color(0.5, 0.5, 0.5, 1)`` |
  411. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  412. | :ref:`Color<class_Color>` | :ref:`word_highlighted_color<class_TextEdit_theme_color_word_highlighted_color>` | ``Color(0.5, 0.5, 0.5, 0.25)`` |
  413. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  414. | :ref:`int<class_int>` | :ref:`caret_width<class_TextEdit_theme_constant_caret_width>` | ``1`` |
  415. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  416. | :ref:`int<class_int>` | :ref:`line_spacing<class_TextEdit_theme_constant_line_spacing>` | ``4`` |
  417. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  418. | :ref:`int<class_int>` | :ref:`outline_size<class_TextEdit_theme_constant_outline_size>` | ``0`` |
  419. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  420. | :ref:`Font<class_Font>` | :ref:`font<class_TextEdit_theme_font_font>` | |
  421. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  422. | :ref:`int<class_int>` | :ref:`font_size<class_TextEdit_theme_font_size_font_size>` | |
  423. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  424. | :ref:`Texture2D<class_Texture2D>` | :ref:`space<class_TextEdit_theme_icon_space>` | |
  425. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  426. | :ref:`Texture2D<class_Texture2D>` | :ref:`tab<class_TextEdit_theme_icon_tab>` | |
  427. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  428. | :ref:`StyleBox<class_StyleBox>` | :ref:`focus<class_TextEdit_theme_style_focus>` | |
  429. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  430. | :ref:`StyleBox<class_StyleBox>` | :ref:`normal<class_TextEdit_theme_style_normal>` | |
  431. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  432. | :ref:`StyleBox<class_StyleBox>` | :ref:`read_only<class_TextEdit_theme_style_read_only>` | |
  433. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  434. .. rst-class:: classref-section-separator
  435. ----
  436. .. rst-class:: classref-descriptions-group
  437. Signals
  438. -------
  439. .. _class_TextEdit_signal_caret_changed:
  440. .. rst-class:: classref-signal
  441. **caret_changed** **(** **)**
  442. Emitted when the caret changes position.
  443. .. rst-class:: classref-item-separator
  444. ----
  445. .. _class_TextEdit_signal_gutter_added:
  446. .. rst-class:: classref-signal
  447. **gutter_added** **(** **)**
  448. Emitted when a gutter is added.
  449. .. rst-class:: classref-item-separator
  450. ----
  451. .. _class_TextEdit_signal_gutter_clicked:
  452. .. rst-class:: classref-signal
  453. **gutter_clicked** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)**
  454. Emitted when a gutter is clicked.
  455. .. rst-class:: classref-item-separator
  456. ----
  457. .. _class_TextEdit_signal_gutter_removed:
  458. .. rst-class:: classref-signal
  459. **gutter_removed** **(** **)**
  460. Emitted when a gutter is removed.
  461. .. rst-class:: classref-item-separator
  462. ----
  463. .. _class_TextEdit_signal_lines_edited_from:
  464. .. rst-class:: classref-signal
  465. **lines_edited_from** **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` to_line **)**
  466. Emitted immediately when the text changes.
  467. When text is added ``from_line`` will be less then ``to_line``. On a remove ``to_line`` will be less then ``from_line``.
  468. .. rst-class:: classref-item-separator
  469. ----
  470. .. _class_TextEdit_signal_text_changed:
  471. .. rst-class:: classref-signal
  472. **text_changed** **(** **)**
  473. Emitted when the text changes.
  474. .. rst-class:: classref-item-separator
  475. ----
  476. .. _class_TextEdit_signal_text_set:
  477. .. rst-class:: classref-signal
  478. **text_set** **(** **)**
  479. Emitted when :ref:`clear<class_TextEdit_method_clear>` is called or :ref:`text<class_TextEdit_property_text>` is set.
  480. .. rst-class:: classref-section-separator
  481. ----
  482. .. rst-class:: classref-descriptions-group
  483. Enumerations
  484. ------------
  485. .. _enum_TextEdit_MenuItems:
  486. .. rst-class:: classref-enumeration
  487. enum **MenuItems**:
  488. .. _class_TextEdit_constant_MENU_CUT:
  489. .. rst-class:: classref-enumeration-constant
  490. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_CUT** = ``0``
  491. Cuts (copies and clears) the selected text.
  492. .. _class_TextEdit_constant_MENU_COPY:
  493. .. rst-class:: classref-enumeration-constant
  494. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_COPY** = ``1``
  495. Copies the selected text.
  496. .. _class_TextEdit_constant_MENU_PASTE:
  497. .. rst-class:: classref-enumeration-constant
  498. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_PASTE** = ``2``
  499. Pastes the clipboard text over the selected text (or at the cursor's position).
  500. .. _class_TextEdit_constant_MENU_CLEAR:
  501. .. rst-class:: classref-enumeration-constant
  502. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_CLEAR** = ``3``
  503. Erases the whole **TextEdit** text.
  504. .. _class_TextEdit_constant_MENU_SELECT_ALL:
  505. .. rst-class:: classref-enumeration-constant
  506. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_SELECT_ALL** = ``4``
  507. Selects the whole **TextEdit** text.
  508. .. _class_TextEdit_constant_MENU_UNDO:
  509. .. rst-class:: classref-enumeration-constant
  510. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_UNDO** = ``5``
  511. Undoes the previous action.
  512. .. _class_TextEdit_constant_MENU_REDO:
  513. .. rst-class:: classref-enumeration-constant
  514. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_REDO** = ``6``
  515. Redoes the previous action.
  516. .. _class_TextEdit_constant_MENU_SUBMENU_TEXT_DIR:
  517. .. rst-class:: classref-enumeration-constant
  518. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_SUBMENU_TEXT_DIR** = ``7``
  519. ID of "Text Writing Direction" submenu.
  520. .. _class_TextEdit_constant_MENU_DIR_INHERITED:
  521. .. rst-class:: classref-enumeration-constant
  522. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DIR_INHERITED** = ``8``
  523. Sets text direction to inherited.
  524. .. _class_TextEdit_constant_MENU_DIR_AUTO:
  525. .. rst-class:: classref-enumeration-constant
  526. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DIR_AUTO** = ``9``
  527. Sets text direction to automatic.
  528. .. _class_TextEdit_constant_MENU_DIR_LTR:
  529. .. rst-class:: classref-enumeration-constant
  530. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DIR_LTR** = ``10``
  531. Sets text direction to left-to-right.
  532. .. _class_TextEdit_constant_MENU_DIR_RTL:
  533. .. rst-class:: classref-enumeration-constant
  534. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DIR_RTL** = ``11``
  535. Sets text direction to right-to-left.
  536. .. _class_TextEdit_constant_MENU_DISPLAY_UCC:
  537. .. rst-class:: classref-enumeration-constant
  538. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DISPLAY_UCC** = ``12``
  539. Toggles control character display.
  540. .. _class_TextEdit_constant_MENU_SUBMENU_INSERT_UCC:
  541. .. rst-class:: classref-enumeration-constant
  542. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_SUBMENU_INSERT_UCC** = ``13``
  543. ID of "Insert Control Character" submenu.
  544. .. _class_TextEdit_constant_MENU_INSERT_LRM:
  545. .. rst-class:: classref-enumeration-constant
  546. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_LRM** = ``14``
  547. Inserts left-to-right mark (LRM) character.
  548. .. _class_TextEdit_constant_MENU_INSERT_RLM:
  549. .. rst-class:: classref-enumeration-constant
  550. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_RLM** = ``15``
  551. Inserts right-to-left mark (RLM) character.
  552. .. _class_TextEdit_constant_MENU_INSERT_LRE:
  553. .. rst-class:: classref-enumeration-constant
  554. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_LRE** = ``16``
  555. Inserts start of left-to-right embedding (LRE) character.
  556. .. _class_TextEdit_constant_MENU_INSERT_RLE:
  557. .. rst-class:: classref-enumeration-constant
  558. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_RLE** = ``17``
  559. Inserts start of right-to-left embedding (RLE) character.
  560. .. _class_TextEdit_constant_MENU_INSERT_LRO:
  561. .. rst-class:: classref-enumeration-constant
  562. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_LRO** = ``18``
  563. Inserts start of left-to-right override (LRO) character.
  564. .. _class_TextEdit_constant_MENU_INSERT_RLO:
  565. .. rst-class:: classref-enumeration-constant
  566. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_RLO** = ``19``
  567. Inserts start of right-to-left override (RLO) character.
  568. .. _class_TextEdit_constant_MENU_INSERT_PDF:
  569. .. rst-class:: classref-enumeration-constant
  570. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_PDF** = ``20``
  571. Inserts pop direction formatting (PDF) character.
  572. .. _class_TextEdit_constant_MENU_INSERT_ALM:
  573. .. rst-class:: classref-enumeration-constant
  574. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_ALM** = ``21``
  575. Inserts Arabic letter mark (ALM) character.
  576. .. _class_TextEdit_constant_MENU_INSERT_LRI:
  577. .. rst-class:: classref-enumeration-constant
  578. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_LRI** = ``22``
  579. Inserts left-to-right isolate (LRI) character.
  580. .. _class_TextEdit_constant_MENU_INSERT_RLI:
  581. .. rst-class:: classref-enumeration-constant
  582. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_RLI** = ``23``
  583. Inserts right-to-left isolate (RLI) character.
  584. .. _class_TextEdit_constant_MENU_INSERT_FSI:
  585. .. rst-class:: classref-enumeration-constant
  586. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_FSI** = ``24``
  587. Inserts first strong isolate (FSI) character.
  588. .. _class_TextEdit_constant_MENU_INSERT_PDI:
  589. .. rst-class:: classref-enumeration-constant
  590. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_PDI** = ``25``
  591. Inserts pop direction isolate (PDI) character.
  592. .. _class_TextEdit_constant_MENU_INSERT_ZWJ:
  593. .. rst-class:: classref-enumeration-constant
  594. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_ZWJ** = ``26``
  595. Inserts zero width joiner (ZWJ) character.
  596. .. _class_TextEdit_constant_MENU_INSERT_ZWNJ:
  597. .. rst-class:: classref-enumeration-constant
  598. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_ZWNJ** = ``27``
  599. Inserts zero width non-joiner (ZWNJ) character.
  600. .. _class_TextEdit_constant_MENU_INSERT_WJ:
  601. .. rst-class:: classref-enumeration-constant
  602. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_WJ** = ``28``
  603. Inserts word joiner (WJ) character.
  604. .. _class_TextEdit_constant_MENU_INSERT_SHY:
  605. .. rst-class:: classref-enumeration-constant
  606. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_SHY** = ``29``
  607. Inserts soft hyphen (SHY) character.
  608. .. _class_TextEdit_constant_MENU_MAX:
  609. .. rst-class:: classref-enumeration-constant
  610. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_MAX** = ``30``
  611. Represents the size of the :ref:`MenuItems<enum_TextEdit_MenuItems>` enum.
  612. .. rst-class:: classref-item-separator
  613. ----
  614. .. _enum_TextEdit_EditAction:
  615. .. rst-class:: classref-enumeration
  616. enum **EditAction**:
  617. .. _class_TextEdit_constant_ACTION_NONE:
  618. .. rst-class:: classref-enumeration-constant
  619. :ref:`EditAction<enum_TextEdit_EditAction>` **ACTION_NONE** = ``0``
  620. No current action.
  621. .. _class_TextEdit_constant_ACTION_TYPING:
  622. .. rst-class:: classref-enumeration-constant
  623. :ref:`EditAction<enum_TextEdit_EditAction>` **ACTION_TYPING** = ``1``
  624. A typing action.
  625. .. _class_TextEdit_constant_ACTION_BACKSPACE:
  626. .. rst-class:: classref-enumeration-constant
  627. :ref:`EditAction<enum_TextEdit_EditAction>` **ACTION_BACKSPACE** = ``2``
  628. A backwards delete action.
  629. .. _class_TextEdit_constant_ACTION_DELETE:
  630. .. rst-class:: classref-enumeration-constant
  631. :ref:`EditAction<enum_TextEdit_EditAction>` **ACTION_DELETE** = ``3``
  632. A forward delete action.
  633. .. rst-class:: classref-item-separator
  634. ----
  635. .. _enum_TextEdit_SearchFlags:
  636. .. rst-class:: classref-enumeration
  637. enum **SearchFlags**:
  638. .. _class_TextEdit_constant_SEARCH_MATCH_CASE:
  639. .. rst-class:: classref-enumeration-constant
  640. :ref:`SearchFlags<enum_TextEdit_SearchFlags>` **SEARCH_MATCH_CASE** = ``1``
  641. Match case when searching.
  642. .. _class_TextEdit_constant_SEARCH_WHOLE_WORDS:
  643. .. rst-class:: classref-enumeration-constant
  644. :ref:`SearchFlags<enum_TextEdit_SearchFlags>` **SEARCH_WHOLE_WORDS** = ``2``
  645. Match whole words when searching.
  646. .. _class_TextEdit_constant_SEARCH_BACKWARDS:
  647. .. rst-class:: classref-enumeration-constant
  648. :ref:`SearchFlags<enum_TextEdit_SearchFlags>` **SEARCH_BACKWARDS** = ``4``
  649. Search from end to beginning.
  650. .. rst-class:: classref-item-separator
  651. ----
  652. .. _enum_TextEdit_CaretType:
  653. .. rst-class:: classref-enumeration
  654. enum **CaretType**:
  655. .. _class_TextEdit_constant_CARET_TYPE_LINE:
  656. .. rst-class:: classref-enumeration-constant
  657. :ref:`CaretType<enum_TextEdit_CaretType>` **CARET_TYPE_LINE** = ``0``
  658. Vertical line caret.
  659. .. _class_TextEdit_constant_CARET_TYPE_BLOCK:
  660. .. rst-class:: classref-enumeration-constant
  661. :ref:`CaretType<enum_TextEdit_CaretType>` **CARET_TYPE_BLOCK** = ``1``
  662. Block caret.
  663. .. rst-class:: classref-item-separator
  664. ----
  665. .. _enum_TextEdit_SelectionMode:
  666. .. rst-class:: classref-enumeration
  667. enum **SelectionMode**:
  668. .. _class_TextEdit_constant_SELECTION_MODE_NONE:
  669. .. rst-class:: classref-enumeration-constant
  670. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_NONE** = ``0``
  671. Not selecting.
  672. .. _class_TextEdit_constant_SELECTION_MODE_SHIFT:
  673. .. rst-class:: classref-enumeration-constant
  674. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_SHIFT** = ``1``
  675. Select as if ``shift`` is pressed.
  676. .. _class_TextEdit_constant_SELECTION_MODE_POINTER:
  677. .. rst-class:: classref-enumeration-constant
  678. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_POINTER** = ``2``
  679. Select single characters as if the user single clicked.
  680. .. _class_TextEdit_constant_SELECTION_MODE_WORD:
  681. .. rst-class:: classref-enumeration-constant
  682. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_WORD** = ``3``
  683. Select whole words as if the user double clicked.
  684. .. _class_TextEdit_constant_SELECTION_MODE_LINE:
  685. .. rst-class:: classref-enumeration-constant
  686. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_LINE** = ``4``
  687. Select whole lines as if the user tripped clicked.
  688. .. rst-class:: classref-item-separator
  689. ----
  690. .. _enum_TextEdit_LineWrappingMode:
  691. .. rst-class:: classref-enumeration
  692. enum **LineWrappingMode**:
  693. .. _class_TextEdit_constant_LINE_WRAPPING_NONE:
  694. .. rst-class:: classref-enumeration-constant
  695. :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` **LINE_WRAPPING_NONE** = ``0``
  696. Line wrapping is disabled.
  697. .. _class_TextEdit_constant_LINE_WRAPPING_BOUNDARY:
  698. .. rst-class:: classref-enumeration-constant
  699. :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` **LINE_WRAPPING_BOUNDARY** = ``1``
  700. Line wrapping occurs at the control boundary, beyond what would normally be visible.
  701. .. rst-class:: classref-item-separator
  702. ----
  703. .. _enum_TextEdit_GutterType:
  704. .. rst-class:: classref-enumeration
  705. enum **GutterType**:
  706. .. _class_TextEdit_constant_GUTTER_TYPE_STRING:
  707. .. rst-class:: classref-enumeration-constant
  708. :ref:`GutterType<enum_TextEdit_GutterType>` **GUTTER_TYPE_STRING** = ``0``
  709. Draw a string.
  710. .. _class_TextEdit_constant_GUTTER_TYPE_ICON:
  711. .. rst-class:: classref-enumeration-constant
  712. :ref:`GutterType<enum_TextEdit_GutterType>` **GUTTER_TYPE_ICON** = ``1``
  713. Draw an icon.
  714. .. _class_TextEdit_constant_GUTTER_TYPE_CUSTOM:
  715. .. rst-class:: classref-enumeration-constant
  716. :ref:`GutterType<enum_TextEdit_GutterType>` **GUTTER_TYPE_CUSTOM** = ``2``
  717. Custom draw.
  718. .. rst-class:: classref-section-separator
  719. ----
  720. .. rst-class:: classref-descriptions-group
  721. Property Descriptions
  722. ---------------------
  723. .. _class_TextEdit_property_caret_blink:
  724. .. rst-class:: classref-property
  725. :ref:`bool<class_bool>` **caret_blink** = ``false``
  726. .. rst-class:: classref-property-setget
  727. - void **set_caret_blink_enabled** **(** :ref:`bool<class_bool>` value **)**
  728. - :ref:`bool<class_bool>` **is_caret_blink_enabled** **(** **)**
  729. Sets if the caret should blink.
  730. .. rst-class:: classref-item-separator
  731. ----
  732. .. _class_TextEdit_property_caret_blink_interval:
  733. .. rst-class:: classref-property
  734. :ref:`float<class_float>` **caret_blink_interval** = ``0.65``
  735. .. rst-class:: classref-property-setget
  736. - void **set_caret_blink_interval** **(** :ref:`float<class_float>` value **)**
  737. - :ref:`float<class_float>` **get_caret_blink_interval** **(** **)**
  738. Duration (in seconds) of a caret's blinking cycle.
  739. .. rst-class:: classref-item-separator
  740. ----
  741. .. _class_TextEdit_property_caret_mid_grapheme:
  742. .. rst-class:: classref-property
  743. :ref:`bool<class_bool>` **caret_mid_grapheme** = ``true``
  744. .. rst-class:: classref-property-setget
  745. - void **set_caret_mid_grapheme_enabled** **(** :ref:`bool<class_bool>` value **)**
  746. - :ref:`bool<class_bool>` **is_caret_mid_grapheme_enabled** **(** **)**
  747. Allow moving caret, selecting and removing the individual composite character components.
  748. \ **Note:** :kbd:`Backspace` is always removing individual composite character components.
  749. .. rst-class:: classref-item-separator
  750. ----
  751. .. _class_TextEdit_property_caret_move_on_right_click:
  752. .. rst-class:: classref-property
  753. :ref:`bool<class_bool>` **caret_move_on_right_click** = ``true``
  754. .. rst-class:: classref-property-setget
  755. - void **set_move_caret_on_right_click_enabled** **(** :ref:`bool<class_bool>` value **)**
  756. - :ref:`bool<class_bool>` **is_move_caret_on_right_click_enabled** **(** **)**
  757. If ``true``, a right-click moves the caret at the mouse position before displaying the context menu.
  758. If ``false``, the context menu disregards mouse location.
  759. .. rst-class:: classref-item-separator
  760. ----
  761. .. _class_TextEdit_property_caret_multiple:
  762. .. rst-class:: classref-property
  763. :ref:`bool<class_bool>` **caret_multiple** = ``true``
  764. .. rst-class:: classref-property-setget
  765. - void **set_multiple_carets_enabled** **(** :ref:`bool<class_bool>` value **)**
  766. - :ref:`bool<class_bool>` **is_multiple_carets_enabled** **(** **)**
  767. Sets if multiple carets are allowed.
  768. .. rst-class:: classref-item-separator
  769. ----
  770. .. _class_TextEdit_property_caret_type:
  771. .. rst-class:: classref-property
  772. :ref:`CaretType<enum_TextEdit_CaretType>` **caret_type** = ``0``
  773. .. rst-class:: classref-property-setget
  774. - void **set_caret_type** **(** :ref:`CaretType<enum_TextEdit_CaretType>` value **)**
  775. - :ref:`CaretType<enum_TextEdit_CaretType>` **get_caret_type** **(** **)**
  776. Set the type of caret to draw.
  777. .. rst-class:: classref-item-separator
  778. ----
  779. .. _class_TextEdit_property_context_menu_enabled:
  780. .. rst-class:: classref-property
  781. :ref:`bool<class_bool>` **context_menu_enabled** = ``true``
  782. .. rst-class:: classref-property-setget
  783. - void **set_context_menu_enabled** **(** :ref:`bool<class_bool>` value **)**
  784. - :ref:`bool<class_bool>` **is_context_menu_enabled** **(** **)**
  785. If ``true``, a right-click displays the context menu.
  786. .. rst-class:: classref-item-separator
  787. ----
  788. .. _class_TextEdit_property_deselect_on_focus_loss_enabled:
  789. .. rst-class:: classref-property
  790. :ref:`bool<class_bool>` **deselect_on_focus_loss_enabled** = ``true``
  791. .. rst-class:: classref-property-setget
  792. - void **set_deselect_on_focus_loss_enabled** **(** :ref:`bool<class_bool>` value **)**
  793. - :ref:`bool<class_bool>` **is_deselect_on_focus_loss_enabled** **(** **)**
  794. If ``true``, the selected text will be deselected when focus is lost.
  795. .. rst-class:: classref-item-separator
  796. ----
  797. .. _class_TextEdit_property_drag_and_drop_selection_enabled:
  798. .. rst-class:: classref-property
  799. :ref:`bool<class_bool>` **drag_and_drop_selection_enabled** = ``true``
  800. .. rst-class:: classref-property-setget
  801. - void **set_drag_and_drop_selection_enabled** **(** :ref:`bool<class_bool>` value **)**
  802. - :ref:`bool<class_bool>` **is_drag_and_drop_selection_enabled** **(** **)**
  803. If ``true``, allow drag and drop of selected text.
  804. .. rst-class:: classref-item-separator
  805. ----
  806. .. _class_TextEdit_property_draw_control_chars:
  807. .. rst-class:: classref-property
  808. :ref:`bool<class_bool>` **draw_control_chars** = ``false``
  809. .. rst-class:: classref-property-setget
  810. - void **set_draw_control_chars** **(** :ref:`bool<class_bool>` value **)**
  811. - :ref:`bool<class_bool>` **get_draw_control_chars** **(** **)**
  812. If ``true``, control characters are displayed.
  813. .. rst-class:: classref-item-separator
  814. ----
  815. .. _class_TextEdit_property_draw_spaces:
  816. .. rst-class:: classref-property
  817. :ref:`bool<class_bool>` **draw_spaces** = ``false``
  818. .. rst-class:: classref-property-setget
  819. - void **set_draw_spaces** **(** :ref:`bool<class_bool>` value **)**
  820. - :ref:`bool<class_bool>` **is_drawing_spaces** **(** **)**
  821. If ``true``, the "space" character will have a visible representation.
  822. .. rst-class:: classref-item-separator
  823. ----
  824. .. _class_TextEdit_property_draw_tabs:
  825. .. rst-class:: classref-property
  826. :ref:`bool<class_bool>` **draw_tabs** = ``false``
  827. .. rst-class:: classref-property-setget
  828. - void **set_draw_tabs** **(** :ref:`bool<class_bool>` value **)**
  829. - :ref:`bool<class_bool>` **is_drawing_tabs** **(** **)**
  830. If ``true``, the "tab" character will have a visible representation.
  831. .. rst-class:: classref-item-separator
  832. ----
  833. .. _class_TextEdit_property_editable:
  834. .. rst-class:: classref-property
  835. :ref:`bool<class_bool>` **editable** = ``true``
  836. .. rst-class:: classref-property-setget
  837. - void **set_editable** **(** :ref:`bool<class_bool>` value **)**
  838. - :ref:`bool<class_bool>` **is_editable** **(** **)**
  839. If ``false``, existing text cannot be modified and new text cannot be added.
  840. .. rst-class:: classref-item-separator
  841. ----
  842. .. _class_TextEdit_property_highlight_all_occurrences:
  843. .. rst-class:: classref-property
  844. :ref:`bool<class_bool>` **highlight_all_occurrences** = ``false``
  845. .. rst-class:: classref-property-setget
  846. - void **set_highlight_all_occurrences** **(** :ref:`bool<class_bool>` value **)**
  847. - :ref:`bool<class_bool>` **is_highlight_all_occurrences_enabled** **(** **)**
  848. If ``true``, all occurrences of the selected text will be highlighted.
  849. .. rst-class:: classref-item-separator
  850. ----
  851. .. _class_TextEdit_property_highlight_current_line:
  852. .. rst-class:: classref-property
  853. :ref:`bool<class_bool>` **highlight_current_line** = ``false``
  854. .. rst-class:: classref-property-setget
  855. - void **set_highlight_current_line** **(** :ref:`bool<class_bool>` value **)**
  856. - :ref:`bool<class_bool>` **is_highlight_current_line_enabled** **(** **)**
  857. If ``true``, the line containing the cursor is highlighted.
  858. .. rst-class:: classref-item-separator
  859. ----
  860. .. _class_TextEdit_property_language:
  861. .. rst-class:: classref-property
  862. :ref:`String<class_String>` **language** = ``""``
  863. .. rst-class:: classref-property-setget
  864. - void **set_language** **(** :ref:`String<class_String>` value **)**
  865. - :ref:`String<class_String>` **get_language** **(** **)**
  866. Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
  867. .. rst-class:: classref-item-separator
  868. ----
  869. .. _class_TextEdit_property_middle_mouse_paste_enabled:
  870. .. rst-class:: classref-property
  871. :ref:`bool<class_bool>` **middle_mouse_paste_enabled** = ``true``
  872. .. rst-class:: classref-property-setget
  873. - void **set_middle_mouse_paste_enabled** **(** :ref:`bool<class_bool>` value **)**
  874. - :ref:`bool<class_bool>` **is_middle_mouse_paste_enabled** **(** **)**
  875. If ``false``, using middle mouse button to paste clipboard will be disabled.
  876. \ **Note:** This method is only implemented on Linux.
  877. .. rst-class:: classref-item-separator
  878. ----
  879. .. _class_TextEdit_property_minimap_draw:
  880. .. rst-class:: classref-property
  881. :ref:`bool<class_bool>` **minimap_draw** = ``false``
  882. .. rst-class:: classref-property-setget
  883. - void **set_draw_minimap** **(** :ref:`bool<class_bool>` value **)**
  884. - :ref:`bool<class_bool>` **is_drawing_minimap** **(** **)**
  885. If ``true``, a minimap is shown, providing an outline of your source code.
  886. .. rst-class:: classref-item-separator
  887. ----
  888. .. _class_TextEdit_property_minimap_width:
  889. .. rst-class:: classref-property
  890. :ref:`int<class_int>` **minimap_width** = ``80``
  891. .. rst-class:: classref-property-setget
  892. - void **set_minimap_width** **(** :ref:`int<class_int>` value **)**
  893. - :ref:`int<class_int>` **get_minimap_width** **(** **)**
  894. The width, in pixels, of the minimap.
  895. .. rst-class:: classref-item-separator
  896. ----
  897. .. _class_TextEdit_property_placeholder_text:
  898. .. rst-class:: classref-property
  899. :ref:`String<class_String>` **placeholder_text** = ``""``
  900. .. rst-class:: classref-property-setget
  901. - void **set_placeholder** **(** :ref:`String<class_String>` value **)**
  902. - :ref:`String<class_String>` **get_placeholder** **(** **)**
  903. Text shown when the **TextEdit** is empty. It is **not** the **TextEdit**'s default value (see :ref:`text<class_TextEdit_property_text>`).
  904. .. rst-class:: classref-item-separator
  905. ----
  906. .. _class_TextEdit_property_scroll_fit_content_height:
  907. .. rst-class:: classref-property
  908. :ref:`bool<class_bool>` **scroll_fit_content_height** = ``false``
  909. .. rst-class:: classref-property-setget
  910. - void **set_fit_content_height_enabled** **(** :ref:`bool<class_bool>` value **)**
  911. - :ref:`bool<class_bool>` **is_fit_content_height_enabled** **(** **)**
  912. If ``true``, **TextEdit** will disable vertical scroll and fit minimum height to the number of visible lines.
  913. .. rst-class:: classref-item-separator
  914. ----
  915. .. _class_TextEdit_property_scroll_horizontal:
  916. .. rst-class:: classref-property
  917. :ref:`int<class_int>` **scroll_horizontal** = ``0``
  918. .. rst-class:: classref-property-setget
  919. - void **set_h_scroll** **(** :ref:`int<class_int>` value **)**
  920. - :ref:`int<class_int>` **get_h_scroll** **(** **)**
  921. If there is a horizontal scrollbar, this determines the current horizontal scroll value in pixels.
  922. .. rst-class:: classref-item-separator
  923. ----
  924. .. _class_TextEdit_property_scroll_past_end_of_file:
  925. .. rst-class:: classref-property
  926. :ref:`bool<class_bool>` **scroll_past_end_of_file** = ``false``
  927. .. rst-class:: classref-property-setget
  928. - void **set_scroll_past_end_of_file_enabled** **(** :ref:`bool<class_bool>` value **)**
  929. - :ref:`bool<class_bool>` **is_scroll_past_end_of_file_enabled** **(** **)**
  930. Allow scrolling past the last line into "virtual" space.
  931. .. rst-class:: classref-item-separator
  932. ----
  933. .. _class_TextEdit_property_scroll_smooth:
  934. .. rst-class:: classref-property
  935. :ref:`bool<class_bool>` **scroll_smooth** = ``false``
  936. .. rst-class:: classref-property-setget
  937. - void **set_smooth_scroll_enabled** **(** :ref:`bool<class_bool>` value **)**
  938. - :ref:`bool<class_bool>` **is_smooth_scroll_enabled** **(** **)**
  939. Scroll smoothly over the text rather then jumping to the next location.
  940. .. rst-class:: classref-item-separator
  941. ----
  942. .. _class_TextEdit_property_scroll_v_scroll_speed:
  943. .. rst-class:: classref-property
  944. :ref:`float<class_float>` **scroll_v_scroll_speed** = ``80.0``
  945. .. rst-class:: classref-property-setget
  946. - void **set_v_scroll_speed** **(** :ref:`float<class_float>` value **)**
  947. - :ref:`float<class_float>` **get_v_scroll_speed** **(** **)**
  948. Sets the scroll speed with the minimap or when :ref:`scroll_smooth<class_TextEdit_property_scroll_smooth>` is enabled.
  949. .. rst-class:: classref-item-separator
  950. ----
  951. .. _class_TextEdit_property_scroll_vertical:
  952. .. rst-class:: classref-property
  953. :ref:`float<class_float>` **scroll_vertical** = ``0.0``
  954. .. rst-class:: classref-property-setget
  955. - void **set_v_scroll** **(** :ref:`float<class_float>` value **)**
  956. - :ref:`float<class_float>` **get_v_scroll** **(** **)**
  957. If there is a vertical scrollbar, this determines the current vertical scroll value in line numbers, starting at 0 for the top line.
  958. .. rst-class:: classref-item-separator
  959. ----
  960. .. _class_TextEdit_property_selecting_enabled:
  961. .. rst-class:: classref-property
  962. :ref:`bool<class_bool>` **selecting_enabled** = ``true``
  963. .. rst-class:: classref-property-setget
  964. - void **set_selecting_enabled** **(** :ref:`bool<class_bool>` value **)**
  965. - :ref:`bool<class_bool>` **is_selecting_enabled** **(** **)**
  966. If ``true``, text can be selected.
  967. If ``false``, text can not be selected by the user or by the :ref:`select<class_TextEdit_method_select>` or :ref:`select_all<class_TextEdit_method_select_all>` methods.
  968. .. rst-class:: classref-item-separator
  969. ----
  970. .. _class_TextEdit_property_shortcut_keys_enabled:
  971. .. rst-class:: classref-property
  972. :ref:`bool<class_bool>` **shortcut_keys_enabled** = ``true``
  973. .. rst-class:: classref-property-setget
  974. - void **set_shortcut_keys_enabled** **(** :ref:`bool<class_bool>` value **)**
  975. - :ref:`bool<class_bool>` **is_shortcut_keys_enabled** **(** **)**
  976. If ``true``, shortcut keys for context menu items are enabled, even if the context menu is disabled.
  977. .. rst-class:: classref-item-separator
  978. ----
  979. .. _class_TextEdit_property_structured_text_bidi_override:
  980. .. rst-class:: classref-property
  981. :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **structured_text_bidi_override** = ``0``
  982. .. rst-class:: classref-property-setget
  983. - void **set_structured_text_bidi_override** **(** :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` value **)**
  984. - :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **get_structured_text_bidi_override** **(** **)**
  985. Set BiDi algorithm override for the structured text.
  986. .. rst-class:: classref-item-separator
  987. ----
  988. .. _class_TextEdit_property_structured_text_bidi_override_options:
  989. .. rst-class:: classref-property
  990. :ref:`Array<class_Array>` **structured_text_bidi_override_options** = ``[]``
  991. .. rst-class:: classref-property-setget
  992. - void **set_structured_text_bidi_override_options** **(** :ref:`Array<class_Array>` value **)**
  993. - :ref:`Array<class_Array>` **get_structured_text_bidi_override_options** **(** **)**
  994. Set additional options for BiDi override.
  995. .. rst-class:: classref-item-separator
  996. ----
  997. .. _class_TextEdit_property_syntax_highlighter:
  998. .. rst-class:: classref-property
  999. :ref:`SyntaxHighlighter<class_SyntaxHighlighter>` **syntax_highlighter**
  1000. .. rst-class:: classref-property-setget
  1001. - void **set_syntax_highlighter** **(** :ref:`SyntaxHighlighter<class_SyntaxHighlighter>` value **)**
  1002. - :ref:`SyntaxHighlighter<class_SyntaxHighlighter>` **get_syntax_highlighter** **(** **)**
  1003. Sets the :ref:`SyntaxHighlighter<class_SyntaxHighlighter>` to use.
  1004. .. rst-class:: classref-item-separator
  1005. ----
  1006. .. _class_TextEdit_property_text:
  1007. .. rst-class:: classref-property
  1008. :ref:`String<class_String>` **text** = ``""``
  1009. .. rst-class:: classref-property-setget
  1010. - void **set_text** **(** :ref:`String<class_String>` value **)**
  1011. - :ref:`String<class_String>` **get_text** **(** **)**
  1012. String value of the **TextEdit**.
  1013. .. rst-class:: classref-item-separator
  1014. ----
  1015. .. _class_TextEdit_property_text_direction:
  1016. .. rst-class:: classref-property
  1017. :ref:`TextDirection<enum_Control_TextDirection>` **text_direction** = ``0``
  1018. .. rst-class:: classref-property-setget
  1019. - void **set_text_direction** **(** :ref:`TextDirection<enum_Control_TextDirection>` value **)**
  1020. - :ref:`TextDirection<enum_Control_TextDirection>` **get_text_direction** **(** **)**
  1021. Base text writing direction.
  1022. .. rst-class:: classref-item-separator
  1023. ----
  1024. .. _class_TextEdit_property_virtual_keyboard_enabled:
  1025. .. rst-class:: classref-property
  1026. :ref:`bool<class_bool>` **virtual_keyboard_enabled** = ``true``
  1027. .. rst-class:: classref-property-setget
  1028. - void **set_virtual_keyboard_enabled** **(** :ref:`bool<class_bool>` value **)**
  1029. - :ref:`bool<class_bool>` **is_virtual_keyboard_enabled** **(** **)**
  1030. If ``true``, the native virtual keyboard is shown when focused on platforms that support it.
  1031. .. rst-class:: classref-item-separator
  1032. ----
  1033. .. _class_TextEdit_property_wrap_mode:
  1034. .. rst-class:: classref-property
  1035. :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` **wrap_mode** = ``0``
  1036. .. rst-class:: classref-property-setget
  1037. - void **set_line_wrapping_mode** **(** :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` value **)**
  1038. - :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` **get_line_wrapping_mode** **(** **)**
  1039. Sets the line wrapping mode to use.
  1040. .. rst-class:: classref-section-separator
  1041. ----
  1042. .. rst-class:: classref-descriptions-group
  1043. Method Descriptions
  1044. -------------------
  1045. .. _class_TextEdit_method__backspace:
  1046. .. rst-class:: classref-method
  1047. void **_backspace** **(** :ref:`int<class_int>` caret_index **)** |virtual|
  1048. Override this method to define what happens when the user presses the backspace key.
  1049. .. rst-class:: classref-item-separator
  1050. ----
  1051. .. _class_TextEdit_method__copy:
  1052. .. rst-class:: classref-method
  1053. void **_copy** **(** :ref:`int<class_int>` caret_index **)** |virtual|
  1054. Override this method to define what happens when the user performs a copy operation.
  1055. .. rst-class:: classref-item-separator
  1056. ----
  1057. .. _class_TextEdit_method__cut:
  1058. .. rst-class:: classref-method
  1059. void **_cut** **(** :ref:`int<class_int>` caret_index **)** |virtual|
  1060. Override this method to define what happens when the user performs a cut operation.
  1061. .. rst-class:: classref-item-separator
  1062. ----
  1063. .. _class_TextEdit_method__handle_unicode_input:
  1064. .. rst-class:: classref-method
  1065. void **_handle_unicode_input** **(** :ref:`int<class_int>` unicode_char, :ref:`int<class_int>` caret_index **)** |virtual|
  1066. Override this method to define what happens when the user types in the provided key ``unicode_char``.
  1067. .. rst-class:: classref-item-separator
  1068. ----
  1069. .. _class_TextEdit_method__paste:
  1070. .. rst-class:: classref-method
  1071. void **_paste** **(** :ref:`int<class_int>` caret_index **)** |virtual|
  1072. Override this method to define what happens when the user performs a paste operation.
  1073. .. rst-class:: classref-item-separator
  1074. ----
  1075. .. _class_TextEdit_method__paste_primary_clipboard:
  1076. .. rst-class:: classref-method
  1077. void **_paste_primary_clipboard** **(** :ref:`int<class_int>` caret_index **)** |virtual|
  1078. Override this method to define what happens when the user performs a paste operation with middle mouse button.
  1079. \ **Note:** This method is only implemented on Linux.
  1080. .. rst-class:: classref-item-separator
  1081. ----
  1082. .. _class_TextEdit_method_add_caret:
  1083. .. rst-class:: classref-method
  1084. :ref:`int<class_int>` **add_caret** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` col **)**
  1085. Adds a new caret at the given location. Returns the index of the new caret, or ``-1`` if the location is invalid.
  1086. .. rst-class:: classref-item-separator
  1087. ----
  1088. .. _class_TextEdit_method_add_caret_at_carets:
  1089. .. rst-class:: classref-method
  1090. void **add_caret_at_carets** **(** :ref:`bool<class_bool>` below **)**
  1091. Adds an additional caret above or below every caret. If ``below`` is true the new caret will be added below and above otherwise.
  1092. .. rst-class:: classref-item-separator
  1093. ----
  1094. .. _class_TextEdit_method_add_gutter:
  1095. .. rst-class:: classref-method
  1096. void **add_gutter** **(** :ref:`int<class_int>` at=-1 **)**
  1097. 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.
  1098. .. rst-class:: classref-item-separator
  1099. ----
  1100. .. _class_TextEdit_method_add_selection_for_next_occurrence:
  1101. .. rst-class:: classref-method
  1102. void **add_selection_for_next_occurrence** **(** **)**
  1103. Adds a selection and a caret for the next occurrence of the current selection. If there is no active selection, selects word under caret.
  1104. .. rst-class:: classref-item-separator
  1105. ----
  1106. .. _class_TextEdit_method_adjust_carets_after_edit:
  1107. .. rst-class:: classref-method
  1108. void **adjust_carets_after_edit** **(** :ref:`int<class_int>` caret, :ref:`int<class_int>` from_line, :ref:`int<class_int>` from_col, :ref:`int<class_int>` to_line, :ref:`int<class_int>` to_col **)**
  1109. Reposition the carets affected by the edit. This assumes edits are applied in edit order, see :ref:`get_caret_index_edit_order<class_TextEdit_method_get_caret_index_edit_order>`.
  1110. .. rst-class:: classref-item-separator
  1111. ----
  1112. .. _class_TextEdit_method_adjust_viewport_to_caret:
  1113. .. rst-class:: classref-method
  1114. void **adjust_viewport_to_caret** **(** :ref:`int<class_int>` caret_index=0 **)**
  1115. Adjust the viewport so the caret is visible.
  1116. .. rst-class:: classref-item-separator
  1117. ----
  1118. .. _class_TextEdit_method_backspace:
  1119. .. rst-class:: classref-method
  1120. void **backspace** **(** :ref:`int<class_int>` caret_index=-1 **)**
  1121. Called when the user presses the backspace key. Can be overridden with :ref:`_backspace<class_TextEdit_method__backspace>`.
  1122. .. rst-class:: classref-item-separator
  1123. ----
  1124. .. _class_TextEdit_method_begin_complex_operation:
  1125. .. rst-class:: classref-method
  1126. void **begin_complex_operation** **(** **)**
  1127. Starts a multipart edit. All edits will be treated as one action until :ref:`end_complex_operation<class_TextEdit_method_end_complex_operation>` is called.
  1128. .. rst-class:: classref-item-separator
  1129. ----
  1130. .. _class_TextEdit_method_center_viewport_to_caret:
  1131. .. rst-class:: classref-method
  1132. void **center_viewport_to_caret** **(** :ref:`int<class_int>` caret_index=0 **)**
  1133. Centers the viewport on the line the editing caret is at. This also resets the :ref:`scroll_horizontal<class_TextEdit_property_scroll_horizontal>` value to ``0``.
  1134. .. rst-class:: classref-item-separator
  1135. ----
  1136. .. _class_TextEdit_method_clear:
  1137. .. rst-class:: classref-method
  1138. void **clear** **(** **)**
  1139. Performs a full reset of **TextEdit**, including undo history.
  1140. .. rst-class:: classref-item-separator
  1141. ----
  1142. .. _class_TextEdit_method_clear_undo_history:
  1143. .. rst-class:: classref-method
  1144. void **clear_undo_history** **(** **)**
  1145. Clears the undo history.
  1146. .. rst-class:: classref-item-separator
  1147. ----
  1148. .. _class_TextEdit_method_copy:
  1149. .. rst-class:: classref-method
  1150. void **copy** **(** :ref:`int<class_int>` caret_index=-1 **)**
  1151. Copies the current text selection. Can be overridden with :ref:`_copy<class_TextEdit_method__copy>`.
  1152. .. rst-class:: classref-item-separator
  1153. ----
  1154. .. _class_TextEdit_method_cut:
  1155. .. rst-class:: classref-method
  1156. void **cut** **(** :ref:`int<class_int>` caret_index=-1 **)**
  1157. Cut's the current selection. Can be overridden with :ref:`_cut<class_TextEdit_method__cut>`.
  1158. .. rst-class:: classref-item-separator
  1159. ----
  1160. .. _class_TextEdit_method_delete_selection:
  1161. .. rst-class:: classref-method
  1162. void **delete_selection** **(** :ref:`int<class_int>` caret_index=-1 **)**
  1163. Deletes the selected text.
  1164. .. rst-class:: classref-item-separator
  1165. ----
  1166. .. _class_TextEdit_method_deselect:
  1167. .. rst-class:: classref-method
  1168. void **deselect** **(** :ref:`int<class_int>` caret_index=-1 **)**
  1169. Deselects the current selection.
  1170. .. rst-class:: classref-item-separator
  1171. ----
  1172. .. _class_TextEdit_method_end_action:
  1173. .. rst-class:: classref-method
  1174. void **end_action** **(** **)**
  1175. Marks the end of steps in the current action started with :ref:`start_action<class_TextEdit_method_start_action>`.
  1176. .. rst-class:: classref-item-separator
  1177. ----
  1178. .. _class_TextEdit_method_end_complex_operation:
  1179. .. rst-class:: classref-method
  1180. void **end_complex_operation** **(** **)**
  1181. Ends a multipart edit, started with :ref:`begin_complex_operation<class_TextEdit_method_begin_complex_operation>`. If called outside a complex operation, the current operation is pushed onto the undo/redo stack.
  1182. .. rst-class:: classref-item-separator
  1183. ----
  1184. .. _class_TextEdit_method_get_caret_column:
  1185. .. rst-class:: classref-method
  1186. :ref:`int<class_int>` **get_caret_column** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1187. Returns the column the editing caret is at.
  1188. .. rst-class:: classref-item-separator
  1189. ----
  1190. .. _class_TextEdit_method_get_caret_count:
  1191. .. rst-class:: classref-method
  1192. :ref:`int<class_int>` **get_caret_count** **(** **)** |const|
  1193. Returns the number of carets in this **TextEdit**.
  1194. .. rst-class:: classref-item-separator
  1195. ----
  1196. .. _class_TextEdit_method_get_caret_draw_pos:
  1197. .. rst-class:: classref-method
  1198. :ref:`Vector2<class_Vector2>` **get_caret_draw_pos** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1199. Returns the caret pixel draw position.
  1200. .. rst-class:: classref-item-separator
  1201. ----
  1202. .. _class_TextEdit_method_get_caret_index_edit_order:
  1203. .. rst-class:: classref-method
  1204. :ref:`PackedInt32Array<class_PackedInt32Array>` **get_caret_index_edit_order** **(** **)**
  1205. 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<class_TextEdit_method_insert_text_at_caret>` are applied.
  1206. .. rst-class:: classref-item-separator
  1207. ----
  1208. .. _class_TextEdit_method_get_caret_line:
  1209. .. rst-class:: classref-method
  1210. :ref:`int<class_int>` **get_caret_line** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1211. Returns the line the editing caret is on.
  1212. .. rst-class:: classref-item-separator
  1213. ----
  1214. .. _class_TextEdit_method_get_caret_wrap_index:
  1215. .. rst-class:: classref-method
  1216. :ref:`int<class_int>` **get_caret_wrap_index** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1217. Returns the wrap index the editing caret is on.
  1218. .. rst-class:: classref-item-separator
  1219. ----
  1220. .. _class_TextEdit_method_get_first_non_whitespace_column:
  1221. .. rst-class:: classref-method
  1222. :ref:`int<class_int>` **get_first_non_whitespace_column** **(** :ref:`int<class_int>` line **)** |const|
  1223. Returns the first column containing a non-whitespace character.
  1224. .. rst-class:: classref-item-separator
  1225. ----
  1226. .. _class_TextEdit_method_get_first_visible_line:
  1227. .. rst-class:: classref-method
  1228. :ref:`int<class_int>` **get_first_visible_line** **(** **)** |const|
  1229. Returns the first visible line.
  1230. .. rst-class:: classref-item-separator
  1231. ----
  1232. .. _class_TextEdit_method_get_gutter_count:
  1233. .. rst-class:: classref-method
  1234. :ref:`int<class_int>` **get_gutter_count** **(** **)** |const|
  1235. Returns the number of gutters registered.
  1236. .. rst-class:: classref-item-separator
  1237. ----
  1238. .. _class_TextEdit_method_get_gutter_name:
  1239. .. rst-class:: classref-method
  1240. :ref:`String<class_String>` **get_gutter_name** **(** :ref:`int<class_int>` gutter **)** |const|
  1241. Returns the name of the gutter at the given index.
  1242. .. rst-class:: classref-item-separator
  1243. ----
  1244. .. _class_TextEdit_method_get_gutter_type:
  1245. .. rst-class:: classref-method
  1246. :ref:`GutterType<enum_TextEdit_GutterType>` **get_gutter_type** **(** :ref:`int<class_int>` gutter **)** |const|
  1247. Returns the type of the gutter at the given index.
  1248. .. rst-class:: classref-item-separator
  1249. ----
  1250. .. _class_TextEdit_method_get_gutter_width:
  1251. .. rst-class:: classref-method
  1252. :ref:`int<class_int>` **get_gutter_width** **(** :ref:`int<class_int>` gutter **)** |const|
  1253. Returns the width of the gutter at the given index.
  1254. .. rst-class:: classref-item-separator
  1255. ----
  1256. .. _class_TextEdit_method_get_h_scroll_bar:
  1257. .. rst-class:: classref-method
  1258. :ref:`HScrollBar<class_HScrollBar>` **get_h_scroll_bar** **(** **)** |const|
  1259. Returns the :ref:`HScrollBar<class_HScrollBar>` used by **TextEdit**.
  1260. .. rst-class:: classref-item-separator
  1261. ----
  1262. .. _class_TextEdit_method_get_indent_level:
  1263. .. rst-class:: classref-method
  1264. :ref:`int<class_int>` **get_indent_level** **(** :ref:`int<class_int>` line **)** |const|
  1265. Returns the number of spaces and ``tab * tab_size`` before the first char.
  1266. .. rst-class:: classref-item-separator
  1267. ----
  1268. .. _class_TextEdit_method_get_last_full_visible_line:
  1269. .. rst-class:: classref-method
  1270. :ref:`int<class_int>` **get_last_full_visible_line** **(** **)** |const|
  1271. Returns the last visible line. Use :ref:`get_last_full_visible_line_wrap_index<class_TextEdit_method_get_last_full_visible_line_wrap_index>` for the wrap index.
  1272. .. rst-class:: classref-item-separator
  1273. ----
  1274. .. _class_TextEdit_method_get_last_full_visible_line_wrap_index:
  1275. .. rst-class:: classref-method
  1276. :ref:`int<class_int>` **get_last_full_visible_line_wrap_index** **(** **)** |const|
  1277. Returns the last visible wrap index of the last visible line.
  1278. .. rst-class:: classref-item-separator
  1279. ----
  1280. .. _class_TextEdit_method_get_last_unhidden_line:
  1281. .. rst-class:: classref-method
  1282. :ref:`int<class_int>` **get_last_unhidden_line** **(** **)** |const|
  1283. Returns the last unhidden line in the entire **TextEdit**.
  1284. .. rst-class:: classref-item-separator
  1285. ----
  1286. .. _class_TextEdit_method_get_line:
  1287. .. rst-class:: classref-method
  1288. :ref:`String<class_String>` **get_line** **(** :ref:`int<class_int>` line **)** |const|
  1289. Returns the text of a specific line.
  1290. .. rst-class:: classref-item-separator
  1291. ----
  1292. .. _class_TextEdit_method_get_line_background_color:
  1293. .. rst-class:: classref-method
  1294. :ref:`Color<class_Color>` **get_line_background_color** **(** :ref:`int<class_int>` line **)** |const|
  1295. Returns the current background color of the line. ``Color(0, 0, 0, 0)`` is returned if no color is set.
  1296. .. rst-class:: classref-item-separator
  1297. ----
  1298. .. _class_TextEdit_method_get_line_column_at_pos:
  1299. .. rst-class:: classref-method
  1300. :ref:`Vector2i<class_Vector2i>` **get_line_column_at_pos** **(** :ref:`Vector2i<class_Vector2i>` position, :ref:`bool<class_bool>` allow_out_of_bounds=true **)** |const|
  1301. 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``.
  1302. .. rst-class:: classref-item-separator
  1303. ----
  1304. .. _class_TextEdit_method_get_line_count:
  1305. .. rst-class:: classref-method
  1306. :ref:`int<class_int>` **get_line_count** **(** **)** |const|
  1307. Returns the number of lines in the text.
  1308. .. rst-class:: classref-item-separator
  1309. ----
  1310. .. _class_TextEdit_method_get_line_gutter_icon:
  1311. .. rst-class:: classref-method
  1312. :ref:`Texture2D<class_Texture2D>` **get_line_gutter_icon** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const|
  1313. Returns the icon currently in ``gutter`` at ``line``.
  1314. .. rst-class:: classref-item-separator
  1315. ----
  1316. .. _class_TextEdit_method_get_line_gutter_item_color:
  1317. .. rst-class:: classref-method
  1318. :ref:`Color<class_Color>` **get_line_gutter_item_color** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const|
  1319. Returns the color currently in ``gutter`` at ``line``.
  1320. .. rst-class:: classref-item-separator
  1321. ----
  1322. .. _class_TextEdit_method_get_line_gutter_metadata:
  1323. .. rst-class:: classref-method
  1324. :ref:`Variant<class_Variant>` **get_line_gutter_metadata** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const|
  1325. Returns the metadata currently in ``gutter`` at ``line``.
  1326. .. rst-class:: classref-item-separator
  1327. ----
  1328. .. _class_TextEdit_method_get_line_gutter_text:
  1329. .. rst-class:: classref-method
  1330. :ref:`String<class_String>` **get_line_gutter_text** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const|
  1331. Returns the text currently in ``gutter`` at ``line``.
  1332. .. rst-class:: classref-item-separator
  1333. ----
  1334. .. _class_TextEdit_method_get_line_height:
  1335. .. rst-class:: classref-method
  1336. :ref:`int<class_int>` **get_line_height** **(** **)** |const|
  1337. Returns the maximum value of the line height among all lines.
  1338. \ **Note:** The return value is influenced by :ref:`line_spacing<class_TextEdit_theme_constant_line_spacing>` and :ref:`font_size<class_TextEdit_theme_font_size_font_size>`. And it will not be less than ``1``.
  1339. .. rst-class:: classref-item-separator
  1340. ----
  1341. .. _class_TextEdit_method_get_line_width:
  1342. .. rst-class:: classref-method
  1343. :ref:`int<class_int>` **get_line_width** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=-1 **)** |const|
  1344. Returns the width in pixels of the ``wrap_index`` on ``line``.
  1345. .. rst-class:: classref-item-separator
  1346. ----
  1347. .. _class_TextEdit_method_get_line_wrap_count:
  1348. .. rst-class:: classref-method
  1349. :ref:`int<class_int>` **get_line_wrap_count** **(** :ref:`int<class_int>` line **)** |const|
  1350. Returns the number of times the given line is wrapped.
  1351. .. rst-class:: classref-item-separator
  1352. ----
  1353. .. _class_TextEdit_method_get_line_wrap_index_at_column:
  1354. .. rst-class:: classref-method
  1355. :ref:`int<class_int>` **get_line_wrap_index_at_column** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const|
  1356. Returns the wrap index of the given line column.
  1357. .. rst-class:: classref-item-separator
  1358. ----
  1359. .. _class_TextEdit_method_get_line_wrapped_text:
  1360. .. rst-class:: classref-method
  1361. :ref:`PackedStringArray<class_PackedStringArray>` **get_line_wrapped_text** **(** :ref:`int<class_int>` line **)** |const|
  1362. Returns an array of :ref:`String<class_String>`\ s representing each wrapped index.
  1363. .. rst-class:: classref-item-separator
  1364. ----
  1365. .. _class_TextEdit_method_get_local_mouse_pos:
  1366. .. rst-class:: classref-method
  1367. :ref:`Vector2<class_Vector2>` **get_local_mouse_pos** **(** **)** |const|
  1368. Returns the local mouse position adjusted for the text direction.
  1369. .. rst-class:: classref-item-separator
  1370. ----
  1371. .. _class_TextEdit_method_get_menu:
  1372. .. rst-class:: classref-method
  1373. :ref:`PopupMenu<class_PopupMenu>` **get_menu** **(** **)** |const|
  1374. Returns the :ref:`PopupMenu<class_PopupMenu>` of this **TextEdit**. By default, this menu is displayed when right-clicking on the **TextEdit**.
  1375. You can add custom menu items or remove standard ones. Make sure your IDs don't conflict with the standard ones (see :ref:`MenuItems<enum_TextEdit_MenuItems>`). For example:
  1376. .. tabs::
  1377. .. code-tab:: gdscript
  1378. func _ready():
  1379. var menu = get_menu()
  1380. # Remove all items after "Redo".
  1381. menu.item_count = menu.get_item_index(MENU_REDO) + 1
  1382. # Add custom items.
  1383. menu.add_separator()
  1384. menu.add_item("Insert Date", MENU_MAX + 1)
  1385. # Connect callback.
  1386. menu.id_pressed.connect(_on_item_pressed)
  1387. func _on_item_pressed(id):
  1388. if id == MENU_MAX + 1:
  1389. insert_text_at_caret(Time.get_date_string_from_system())
  1390. .. code-tab:: csharp
  1391. public override void _Ready()
  1392. {
  1393. var menu = GetMenu();
  1394. // Remove all items after "Redo".
  1395. menu.ItemCount = menu.GetItemIndex(TextEdit.MenuItems.Redo) + 1;
  1396. // Add custom items.
  1397. menu.AddSeparator();
  1398. menu.AddItem("Insert Date", TextEdit.MenuItems.Max + 1);
  1399. // Add event handler.
  1400. menu.IdPressed += OnItemPressed;
  1401. }
  1402. public void OnItemPressed(int id)
  1403. {
  1404. if (id == TextEdit.MenuItems.Max + 1)
  1405. {
  1406. InsertTextAtCaret(Time.GetDateStringFromSystem());
  1407. }
  1408. }
  1409. \ **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<class_Window_property_visible>` property.
  1410. .. rst-class:: classref-item-separator
  1411. ----
  1412. .. _class_TextEdit_method_get_minimap_line_at_pos:
  1413. .. rst-class:: classref-method
  1414. :ref:`int<class_int>` **get_minimap_line_at_pos** **(** :ref:`Vector2i<class_Vector2i>` position **)** |const|
  1415. Returns the equivalent minimap line at ``position``.
  1416. .. rst-class:: classref-item-separator
  1417. ----
  1418. .. _class_TextEdit_method_get_minimap_visible_lines:
  1419. .. rst-class:: classref-method
  1420. :ref:`int<class_int>` **get_minimap_visible_lines** **(** **)** |const|
  1421. Returns the number of lines that may be drawn on the minimap.
  1422. .. rst-class:: classref-item-separator
  1423. ----
  1424. .. _class_TextEdit_method_get_next_visible_line_index_offset_from:
  1425. .. rst-class:: classref-method
  1426. :ref:`Vector2i<class_Vector2i>` **get_next_visible_line_index_offset_from** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index, :ref:`int<class_int>` visible_amount **)** |const|
  1427. Similar to :ref:`get_next_visible_line_offset_from<class_TextEdit_method_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.
  1428. .. rst-class:: classref-item-separator
  1429. ----
  1430. .. _class_TextEdit_method_get_next_visible_line_offset_from:
  1431. .. rst-class:: classref-method
  1432. :ref:`int<class_int>` **get_next_visible_line_offset_from** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` visible_amount **)** |const|
  1433. 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.
  1434. .. rst-class:: classref-item-separator
  1435. ----
  1436. .. _class_TextEdit_method_get_pos_at_line_column:
  1437. .. rst-class:: classref-method
  1438. :ref:`Vector2i<class_Vector2i>` **get_pos_at_line_column** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const|
  1439. 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.
  1440. \ **Note:** The Y position corresponds to the bottom side of the line. Use :ref:`get_rect_at_line_column<class_TextEdit_method_get_rect_at_line_column>` to get the top side position.
  1441. .. rst-class:: classref-item-separator
  1442. ----
  1443. .. _class_TextEdit_method_get_rect_at_line_column:
  1444. .. rst-class:: classref-method
  1445. :ref:`Rect2i<class_Rect2i>` **get_rect_at_line_column** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const|
  1446. 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.
  1447. \ **Note:** The Y position of the returned rect corresponds to the top side of the line, unlike :ref:`get_pos_at_line_column<class_TextEdit_method_get_pos_at_line_column>` which returns the bottom side.
  1448. .. rst-class:: classref-item-separator
  1449. ----
  1450. .. _class_TextEdit_method_get_saved_version:
  1451. .. rst-class:: classref-method
  1452. :ref:`int<class_int>` **get_saved_version** **(** **)** |const|
  1453. Returns the last tagged saved version from :ref:`tag_saved_version<class_TextEdit_method_tag_saved_version>`.
  1454. .. rst-class:: classref-item-separator
  1455. ----
  1456. .. _class_TextEdit_method_get_scroll_pos_for_line:
  1457. .. rst-class:: classref-method
  1458. :ref:`float<class_float>` **get_scroll_pos_for_line** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=0 **)** |const|
  1459. Returns the scroll position for ``wrap_index`` of ``line``.
  1460. .. rst-class:: classref-item-separator
  1461. ----
  1462. .. _class_TextEdit_method_get_selected_text:
  1463. .. rst-class:: classref-method
  1464. :ref:`String<class_String>` **get_selected_text** **(** :ref:`int<class_int>` caret_index=-1 **)**
  1465. Returns the text inside the selection.
  1466. .. rst-class:: classref-item-separator
  1467. ----
  1468. .. _class_TextEdit_method_get_selection_column:
  1469. .. rst-class:: classref-method
  1470. :ref:`int<class_int>` **get_selection_column** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1471. Returns the original start column of the selection.
  1472. .. rst-class:: classref-item-separator
  1473. ----
  1474. .. _class_TextEdit_method_get_selection_from_column:
  1475. .. rst-class:: classref-method
  1476. :ref:`int<class_int>` **get_selection_from_column** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1477. Returns the selection begin column.
  1478. .. rst-class:: classref-item-separator
  1479. ----
  1480. .. _class_TextEdit_method_get_selection_from_line:
  1481. .. rst-class:: classref-method
  1482. :ref:`int<class_int>` **get_selection_from_line** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1483. Returns the selection begin line.
  1484. .. rst-class:: classref-item-separator
  1485. ----
  1486. .. _class_TextEdit_method_get_selection_line:
  1487. .. rst-class:: classref-method
  1488. :ref:`int<class_int>` **get_selection_line** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1489. Returns the original start line of the selection.
  1490. .. rst-class:: classref-item-separator
  1491. ----
  1492. .. _class_TextEdit_method_get_selection_mode:
  1493. .. rst-class:: classref-method
  1494. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **get_selection_mode** **(** **)** |const|
  1495. Returns the current selection mode.
  1496. .. rst-class:: classref-item-separator
  1497. ----
  1498. .. _class_TextEdit_method_get_selection_to_column:
  1499. .. rst-class:: classref-method
  1500. :ref:`int<class_int>` **get_selection_to_column** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1501. Returns the selection end column.
  1502. .. rst-class:: classref-item-separator
  1503. ----
  1504. .. _class_TextEdit_method_get_selection_to_line:
  1505. .. rst-class:: classref-method
  1506. :ref:`int<class_int>` **get_selection_to_line** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1507. Returns the selection end line.
  1508. .. rst-class:: classref-item-separator
  1509. ----
  1510. .. _class_TextEdit_method_get_tab_size:
  1511. .. rst-class:: classref-method
  1512. :ref:`int<class_int>` **get_tab_size** **(** **)** |const|
  1513. Returns the **TextEdit**'s' tab size.
  1514. .. rst-class:: classref-item-separator
  1515. ----
  1516. .. _class_TextEdit_method_get_total_gutter_width:
  1517. .. rst-class:: classref-method
  1518. :ref:`int<class_int>` **get_total_gutter_width** **(** **)** |const|
  1519. Returns the total width of all gutters and internal padding.
  1520. .. rst-class:: classref-item-separator
  1521. ----
  1522. .. _class_TextEdit_method_get_total_visible_line_count:
  1523. .. rst-class:: classref-method
  1524. :ref:`int<class_int>` **get_total_visible_line_count** **(** **)** |const|
  1525. Returns the number of lines that may be drawn.
  1526. .. rst-class:: classref-item-separator
  1527. ----
  1528. .. _class_TextEdit_method_get_v_scroll_bar:
  1529. .. rst-class:: classref-method
  1530. :ref:`VScrollBar<class_VScrollBar>` **get_v_scroll_bar** **(** **)** |const|
  1531. Returns the :ref:`VScrollBar<class_VScrollBar>` of the **TextEdit**.
  1532. .. rst-class:: classref-item-separator
  1533. ----
  1534. .. _class_TextEdit_method_get_version:
  1535. .. rst-class:: classref-method
  1536. :ref:`int<class_int>` **get_version** **(** **)** |const|
  1537. Returns the current version of the **TextEdit**. The version is a count of recorded operations by the undo/redo history.
  1538. .. rst-class:: classref-item-separator
  1539. ----
  1540. .. _class_TextEdit_method_get_visible_line_count:
  1541. .. rst-class:: classref-method
  1542. :ref:`int<class_int>` **get_visible_line_count** **(** **)** |const|
  1543. Returns the number of visible lines, including wrapped text.
  1544. .. rst-class:: classref-item-separator
  1545. ----
  1546. .. _class_TextEdit_method_get_visible_line_count_in_range:
  1547. .. rst-class:: classref-method
  1548. :ref:`int<class_int>` **get_visible_line_count_in_range** **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` to_line **)** |const|
  1549. Returns the total number of visible + wrapped lines between the two lines.
  1550. .. rst-class:: classref-item-separator
  1551. ----
  1552. .. _class_TextEdit_method_get_word_at_pos:
  1553. .. rst-class:: classref-method
  1554. :ref:`String<class_String>` **get_word_at_pos** **(** :ref:`Vector2<class_Vector2>` position **)** |const|
  1555. Returns the word at ``position``.
  1556. .. rst-class:: classref-item-separator
  1557. ----
  1558. .. _class_TextEdit_method_get_word_under_caret:
  1559. .. rst-class:: classref-method
  1560. :ref:`String<class_String>` **get_word_under_caret** **(** :ref:`int<class_int>` caret_index=-1 **)** |const|
  1561. Returns a :ref:`String<class_String>` text with the word under the caret's location.
  1562. .. rst-class:: classref-item-separator
  1563. ----
  1564. .. _class_TextEdit_method_has_ime_text:
  1565. .. rst-class:: classref-method
  1566. :ref:`bool<class_bool>` **has_ime_text** **(** **)** |const|
  1567. Returns if the user has IME text.
  1568. .. rst-class:: classref-item-separator
  1569. ----
  1570. .. _class_TextEdit_method_has_redo:
  1571. .. rst-class:: classref-method
  1572. :ref:`bool<class_bool>` **has_redo** **(** **)** |const|
  1573. Returns ``true`` if a "redo" action is available.
  1574. .. rst-class:: classref-item-separator
  1575. ----
  1576. .. _class_TextEdit_method_has_selection:
  1577. .. rst-class:: classref-method
  1578. :ref:`bool<class_bool>` **has_selection** **(** :ref:`int<class_int>` caret_index=-1 **)** |const|
  1579. Returns ``true`` if the user has selected text.
  1580. .. rst-class:: classref-item-separator
  1581. ----
  1582. .. _class_TextEdit_method_has_undo:
  1583. .. rst-class:: classref-method
  1584. :ref:`bool<class_bool>` **has_undo** **(** **)** |const|
  1585. Returns ``true`` if an "undo" action is available.
  1586. .. rst-class:: classref-item-separator
  1587. ----
  1588. .. _class_TextEdit_method_insert_line_at:
  1589. .. rst-class:: classref-method
  1590. void **insert_line_at** **(** :ref:`int<class_int>` line, :ref:`String<class_String>` text **)**
  1591. Inserts a new line with ``text`` at ``line``.
  1592. .. rst-class:: classref-item-separator
  1593. ----
  1594. .. _class_TextEdit_method_insert_text_at_caret:
  1595. .. rst-class:: classref-method
  1596. void **insert_text_at_caret** **(** :ref:`String<class_String>` text, :ref:`int<class_int>` caret_index=-1 **)**
  1597. Insert the specified text at the caret position.
  1598. .. rst-class:: classref-item-separator
  1599. ----
  1600. .. _class_TextEdit_method_is_caret_visible:
  1601. .. rst-class:: classref-method
  1602. :ref:`bool<class_bool>` **is_caret_visible** **(** :ref:`int<class_int>` caret_index=0 **)** |const|
  1603. Returns ``true`` if the caret is visible on the screen.
  1604. .. rst-class:: classref-item-separator
  1605. ----
  1606. .. _class_TextEdit_method_is_dragging_cursor:
  1607. .. rst-class:: classref-method
  1608. :ref:`bool<class_bool>` **is_dragging_cursor** **(** **)** |const|
  1609. Returns ``true`` if the user is dragging their mouse for scrolling or selecting.
  1610. .. rst-class:: classref-item-separator
  1611. ----
  1612. .. _class_TextEdit_method_is_gutter_clickable:
  1613. .. rst-class:: classref-method
  1614. :ref:`bool<class_bool>` **is_gutter_clickable** **(** :ref:`int<class_int>` gutter **)** |const|
  1615. Returns whether the gutter is clickable.
  1616. .. rst-class:: classref-item-separator
  1617. ----
  1618. .. _class_TextEdit_method_is_gutter_drawn:
  1619. .. rst-class:: classref-method
  1620. :ref:`bool<class_bool>` **is_gutter_drawn** **(** :ref:`int<class_int>` gutter **)** |const|
  1621. Returns whether the gutter is currently drawn.
  1622. .. rst-class:: classref-item-separator
  1623. ----
  1624. .. _class_TextEdit_method_is_gutter_overwritable:
  1625. .. rst-class:: classref-method
  1626. :ref:`bool<class_bool>` **is_gutter_overwritable** **(** :ref:`int<class_int>` gutter **)** |const|
  1627. Returns whether the gutter is overwritable.
  1628. .. rst-class:: classref-item-separator
  1629. ----
  1630. .. _class_TextEdit_method_is_line_gutter_clickable:
  1631. .. rst-class:: classref-method
  1632. :ref:`bool<class_bool>` **is_line_gutter_clickable** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter **)** |const|
  1633. Returns whether the gutter on the given line is clickable.
  1634. .. rst-class:: classref-item-separator
  1635. ----
  1636. .. _class_TextEdit_method_is_line_wrapped:
  1637. .. rst-class:: classref-method
  1638. :ref:`bool<class_bool>` **is_line_wrapped** **(** :ref:`int<class_int>` line **)** |const|
  1639. Returns if the given line is wrapped.
  1640. .. rst-class:: classref-item-separator
  1641. ----
  1642. .. _class_TextEdit_method_is_menu_visible:
  1643. .. rst-class:: classref-method
  1644. :ref:`bool<class_bool>` **is_menu_visible** **(** **)** |const|
  1645. Returns whether the menu is visible. Use this instead of ``get_menu().visible`` to improve performance (so the creation of the menu is avoided).
  1646. .. rst-class:: classref-item-separator
  1647. ----
  1648. .. _class_TextEdit_method_is_mouse_over_selection:
  1649. .. rst-class:: classref-method
  1650. :ref:`bool<class_bool>` **is_mouse_over_selection** **(** :ref:`bool<class_bool>` edges, :ref:`int<class_int>` caret_index=-1 **)** |const|
  1651. Returns whether the mouse is over selection. If ``edges`` is ``true``, the edges are considered part of the selection.
  1652. .. rst-class:: classref-item-separator
  1653. ----
  1654. .. _class_TextEdit_method_is_overtype_mode_enabled:
  1655. .. rst-class:: classref-method
  1656. :ref:`bool<class_bool>` **is_overtype_mode_enabled** **(** **)** |const|
  1657. Returns whether the user is in overtype mode.
  1658. .. rst-class:: classref-item-separator
  1659. ----
  1660. .. _class_TextEdit_method_menu_option:
  1661. .. rst-class:: classref-method
  1662. void **menu_option** **(** :ref:`int<class_int>` option **)**
  1663. Executes a given action as defined in the :ref:`MenuItems<enum_TextEdit_MenuItems>` enum.
  1664. .. rst-class:: classref-item-separator
  1665. ----
  1666. .. _class_TextEdit_method_merge_gutters:
  1667. .. rst-class:: classref-method
  1668. void **merge_gutters** **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` to_line **)**
  1669. Merge the gutters from ``from_line`` into ``to_line``. Only overwritable gutters will be copied.
  1670. .. rst-class:: classref-item-separator
  1671. ----
  1672. .. _class_TextEdit_method_merge_overlapping_carets:
  1673. .. rst-class:: classref-method
  1674. void **merge_overlapping_carets** **(** **)**
  1675. Merges any overlapping carets. Will favor the newest caret, or the caret with a selection.
  1676. \ **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.
  1677. .. rst-class:: classref-item-separator
  1678. ----
  1679. .. _class_TextEdit_method_paste:
  1680. .. rst-class:: classref-method
  1681. void **paste** **(** :ref:`int<class_int>` caret_index=-1 **)**
  1682. Paste at the current location. Can be overridden with :ref:`_paste<class_TextEdit_method__paste>`.
  1683. .. rst-class:: classref-item-separator
  1684. ----
  1685. .. _class_TextEdit_method_paste_primary_clipboard:
  1686. .. rst-class:: classref-method
  1687. void **paste_primary_clipboard** **(** :ref:`int<class_int>` caret_index=-1 **)**
  1688. Pastes the primary clipboard.
  1689. .. rst-class:: classref-item-separator
  1690. ----
  1691. .. _class_TextEdit_method_redo:
  1692. .. rst-class:: classref-method
  1693. void **redo** **(** **)**
  1694. Perform redo operation.
  1695. .. rst-class:: classref-item-separator
  1696. ----
  1697. .. _class_TextEdit_method_remove_caret:
  1698. .. rst-class:: classref-method
  1699. void **remove_caret** **(** :ref:`int<class_int>` caret **)**
  1700. Removes the given caret index.
  1701. \ **Note:** This can result in adjustment of all other caret indices.
  1702. .. rst-class:: classref-item-separator
  1703. ----
  1704. .. _class_TextEdit_method_remove_gutter:
  1705. .. rst-class:: classref-method
  1706. void **remove_gutter** **(** :ref:`int<class_int>` gutter **)**
  1707. Removes the gutter from this **TextEdit**.
  1708. .. rst-class:: classref-item-separator
  1709. ----
  1710. .. _class_TextEdit_method_remove_secondary_carets:
  1711. .. rst-class:: classref-method
  1712. void **remove_secondary_carets** **(** **)**
  1713. Removes all additional carets.
  1714. .. rst-class:: classref-item-separator
  1715. ----
  1716. .. _class_TextEdit_method_remove_text:
  1717. .. rst-class:: classref-method
  1718. void **remove_text** **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` from_column, :ref:`int<class_int>` to_line, :ref:`int<class_int>` to_column **)**
  1719. Removes text between the given positions.
  1720. \ **Note:** This does not adjust the caret or selection, which as a result it can end up in an invalid position.
  1721. .. rst-class:: classref-item-separator
  1722. ----
  1723. .. _class_TextEdit_method_search:
  1724. .. rst-class:: classref-method
  1725. :ref:`Vector2i<class_Vector2i>` **search** **(** :ref:`String<class_String>` text, :ref:`int<class_int>` flags, :ref:`int<class_int>` from_line, :ref:`int<class_int>` from_colum **)** |const|
  1726. Perform a search inside the text. Search flags can be specified in the :ref:`SearchFlags<enum_TextEdit_SearchFlags>` enum.
  1727. In the returned vector, ``x`` is the column, ``y`` is the line. If no results are found, both are equal to ``-1``.
  1728. .. tabs::
  1729. .. code-tab:: gdscript
  1730. var result = search("print", SEARCH_WHOLE_WORDS, 0, 0)
  1731. if result.x != -1:
  1732. # Result found.
  1733. var line_number = result.y
  1734. var column_number = result.x
  1735. .. code-tab:: csharp
  1736. Vector2I result = Search("print", (uint)TextEdit.SearchFlags.WholeWords, 0, 0);
  1737. if (result.X != -1)
  1738. {
  1739. // Result found.
  1740. int lineNumber = result.Y;
  1741. int columnNumber = result.X;
  1742. }
  1743. .. rst-class:: classref-item-separator
  1744. ----
  1745. .. _class_TextEdit_method_select:
  1746. .. rst-class:: classref-method
  1747. void **select** **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` from_column, :ref:`int<class_int>` to_line, :ref:`int<class_int>` to_column, :ref:`int<class_int>` caret_index=0 **)**
  1748. Perform selection, from line/column to line/column.
  1749. If :ref:`selecting_enabled<class_TextEdit_property_selecting_enabled>` is ``false``, no selection will occur.
  1750. .. rst-class:: classref-item-separator
  1751. ----
  1752. .. _class_TextEdit_method_select_all:
  1753. .. rst-class:: classref-method
  1754. void **select_all** **(** **)**
  1755. Select all the text.
  1756. If :ref:`selecting_enabled<class_TextEdit_property_selecting_enabled>` is ``false``, no selection will occur.
  1757. .. rst-class:: classref-item-separator
  1758. ----
  1759. .. _class_TextEdit_method_select_word_under_caret:
  1760. .. rst-class:: classref-method
  1761. void **select_word_under_caret** **(** :ref:`int<class_int>` caret_index=-1 **)**
  1762. Selects the word under the caret.
  1763. .. rst-class:: classref-item-separator
  1764. ----
  1765. .. _class_TextEdit_method_set_caret_column:
  1766. .. rst-class:: classref-method
  1767. void **set_caret_column** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` adjust_viewport=true, :ref:`int<class_int>` caret_index=0 **)**
  1768. Moves the caret to the specified ``column`` index.
  1769. If ``adjust_viewport`` is ``true``, the viewport will center at the caret position after the move occurs.
  1770. \ **Note:** If supporting multiple carets this will not check for any overlap. See :ref:`merge_overlapping_carets<class_TextEdit_method_merge_overlapping_carets>`.
  1771. .. rst-class:: classref-item-separator
  1772. ----
  1773. .. _class_TextEdit_method_set_caret_line:
  1774. .. rst-class:: classref-method
  1775. void **set_caret_line** **(** :ref:`int<class_int>` line, :ref:`bool<class_bool>` adjust_viewport=true, :ref:`bool<class_bool>` can_be_hidden=true, :ref:`int<class_int>` wrap_index=0, :ref:`int<class_int>` caret_index=0 **)**
  1776. Moves the caret to the specified ``line`` index.
  1777. If ``adjust_viewport`` is ``true``, the viewport will center at the caret position after the move occurs.
  1778. If ``can_be_hidden`` is ``true``, the specified ``line`` can be hidden.
  1779. \ **Note:** If supporting multiple carets this will not check for any overlap. See :ref:`merge_overlapping_carets<class_TextEdit_method_merge_overlapping_carets>`.
  1780. .. rst-class:: classref-item-separator
  1781. ----
  1782. .. _class_TextEdit_method_set_gutter_clickable:
  1783. .. rst-class:: classref-method
  1784. void **set_gutter_clickable** **(** :ref:`int<class_int>` gutter, :ref:`bool<class_bool>` clickable **)**
  1785. Sets the gutter as clickable. This will change the mouse cursor to a pointing hand when hovering over the gutter.
  1786. .. rst-class:: classref-item-separator
  1787. ----
  1788. .. _class_TextEdit_method_set_gutter_custom_draw:
  1789. .. rst-class:: classref-method
  1790. void **set_gutter_custom_draw** **(** :ref:`int<class_int>` column, :ref:`Callable<class_Callable>` draw_callback **)**
  1791. Set a custom draw method for the gutter. The callback method must take the following args: ``line: int, gutter: int, Area: Rect2``.
  1792. .. rst-class:: classref-item-separator
  1793. ----
  1794. .. _class_TextEdit_method_set_gutter_draw:
  1795. .. rst-class:: classref-method
  1796. void **set_gutter_draw** **(** :ref:`int<class_int>` gutter, :ref:`bool<class_bool>` draw **)**
  1797. Sets whether the gutter should be drawn.
  1798. .. rst-class:: classref-item-separator
  1799. ----
  1800. .. _class_TextEdit_method_set_gutter_name:
  1801. .. rst-class:: classref-method
  1802. void **set_gutter_name** **(** :ref:`int<class_int>` gutter, :ref:`String<class_String>` name **)**
  1803. Sets the name of the gutter.
  1804. .. rst-class:: classref-item-separator
  1805. ----
  1806. .. _class_TextEdit_method_set_gutter_overwritable:
  1807. .. rst-class:: classref-method
  1808. void **set_gutter_overwritable** **(** :ref:`int<class_int>` gutter, :ref:`bool<class_bool>` overwritable **)**
  1809. Sets the gutter to overwritable. See :ref:`merge_gutters<class_TextEdit_method_merge_gutters>`.
  1810. .. rst-class:: classref-item-separator
  1811. ----
  1812. .. _class_TextEdit_method_set_gutter_type:
  1813. .. rst-class:: classref-method
  1814. void **set_gutter_type** **(** :ref:`int<class_int>` gutter, :ref:`GutterType<enum_TextEdit_GutterType>` type **)**
  1815. Sets the type of gutter.
  1816. .. rst-class:: classref-item-separator
  1817. ----
  1818. .. _class_TextEdit_method_set_gutter_width:
  1819. .. rst-class:: classref-method
  1820. void **set_gutter_width** **(** :ref:`int<class_int>` gutter, :ref:`int<class_int>` width **)**
  1821. Set the width of the gutter.
  1822. .. rst-class:: classref-item-separator
  1823. ----
  1824. .. _class_TextEdit_method_set_line:
  1825. .. rst-class:: classref-method
  1826. void **set_line** **(** :ref:`int<class_int>` line, :ref:`String<class_String>` new_text **)**
  1827. Sets the text for a specific line.
  1828. .. rst-class:: classref-item-separator
  1829. ----
  1830. .. _class_TextEdit_method_set_line_as_center_visible:
  1831. .. rst-class:: classref-method
  1832. void **set_line_as_center_visible** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=0 **)**
  1833. Positions the ``wrap_index`` of ``line`` at the center of the viewport.
  1834. .. rst-class:: classref-item-separator
  1835. ----
  1836. .. _class_TextEdit_method_set_line_as_first_visible:
  1837. .. rst-class:: classref-method
  1838. void **set_line_as_first_visible** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=0 **)**
  1839. Positions the ``wrap_index`` of ``line`` at the top of the viewport.
  1840. .. rst-class:: classref-item-separator
  1841. ----
  1842. .. _class_TextEdit_method_set_line_as_last_visible:
  1843. .. rst-class:: classref-method
  1844. void **set_line_as_last_visible** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` wrap_index=0 **)**
  1845. Positions the ``wrap_index`` of ``line`` at the bottom of the viewport.
  1846. .. rst-class:: classref-item-separator
  1847. ----
  1848. .. _class_TextEdit_method_set_line_background_color:
  1849. .. rst-class:: classref-method
  1850. void **set_line_background_color** **(** :ref:`int<class_int>` line, :ref:`Color<class_Color>` color **)**
  1851. Sets the current background color of the line. Set to ``Color(0, 0, 0, 0)`` for no color.
  1852. .. rst-class:: classref-item-separator
  1853. ----
  1854. .. _class_TextEdit_method_set_line_gutter_clickable:
  1855. .. rst-class:: classref-method
  1856. void **set_line_gutter_clickable** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`bool<class_bool>` clickable **)**
  1857. If ``clickable`` is ``true``, makes the ``gutter`` on ``line`` clickable. See :ref:`gutter_clicked<class_TextEdit_signal_gutter_clicked>`.
  1858. .. rst-class:: classref-item-separator
  1859. ----
  1860. .. _class_TextEdit_method_set_line_gutter_icon:
  1861. .. rst-class:: classref-method
  1862. void **set_line_gutter_icon** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`Texture2D<class_Texture2D>` icon **)**
  1863. Sets the icon for ``gutter`` on ``line`` to ``icon``.
  1864. .. rst-class:: classref-item-separator
  1865. ----
  1866. .. _class_TextEdit_method_set_line_gutter_item_color:
  1867. .. rst-class:: classref-method
  1868. void **set_line_gutter_item_color** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`Color<class_Color>` color **)**
  1869. Sets the color for ``gutter`` on ``line`` to ``color``.
  1870. .. rst-class:: classref-item-separator
  1871. ----
  1872. .. _class_TextEdit_method_set_line_gutter_metadata:
  1873. .. rst-class:: classref-method
  1874. void **set_line_gutter_metadata** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`Variant<class_Variant>` metadata **)**
  1875. Sets the metadata for ``gutter`` on ``line`` to ``metadata``.
  1876. .. rst-class:: classref-item-separator
  1877. ----
  1878. .. _class_TextEdit_method_set_line_gutter_text:
  1879. .. rst-class:: classref-method
  1880. void **set_line_gutter_text** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` gutter, :ref:`String<class_String>` text **)**
  1881. Sets the text for ``gutter`` on ``line`` to ``text``.
  1882. .. rst-class:: classref-item-separator
  1883. ----
  1884. .. _class_TextEdit_method_set_overtype_mode_enabled:
  1885. .. rst-class:: classref-method
  1886. void **set_overtype_mode_enabled** **(** :ref:`bool<class_bool>` enabled **)**
  1887. If ``true``, sets the user into overtype mode. When the user types in this mode, it will override existing text.
  1888. .. rst-class:: classref-item-separator
  1889. ----
  1890. .. _class_TextEdit_method_set_search_flags:
  1891. .. rst-class:: classref-method
  1892. void **set_search_flags** **(** :ref:`int<class_int>` flags **)**
  1893. Sets the search ``flags``. This is used with :ref:`set_search_text<class_TextEdit_method_set_search_text>` to highlight occurrences of the searched text. Search flags can be specified from the :ref:`SearchFlags<enum_TextEdit_SearchFlags>` enum.
  1894. .. rst-class:: classref-item-separator
  1895. ----
  1896. .. _class_TextEdit_method_set_search_text:
  1897. .. rst-class:: classref-method
  1898. void **set_search_text** **(** :ref:`String<class_String>` search_text **)**
  1899. Sets the search text. See :ref:`set_search_flags<class_TextEdit_method_set_search_flags>`.
  1900. .. rst-class:: classref-item-separator
  1901. ----
  1902. .. _class_TextEdit_method_set_selection_mode:
  1903. .. rst-class:: classref-method
  1904. void **set_selection_mode** **(** :ref:`SelectionMode<enum_TextEdit_SelectionMode>` mode, :ref:`int<class_int>` line=-1, :ref:`int<class_int>` column=-1, :ref:`int<class_int>` caret_index=0 **)**
  1905. Sets the current selection mode.
  1906. .. rst-class:: classref-item-separator
  1907. ----
  1908. .. _class_TextEdit_method_set_tab_size:
  1909. .. rst-class:: classref-method
  1910. void **set_tab_size** **(** :ref:`int<class_int>` size **)**
  1911. Sets the tab size for the **TextEdit** to use.
  1912. .. rst-class:: classref-item-separator
  1913. ----
  1914. .. _class_TextEdit_method_set_tooltip_request_func:
  1915. .. rst-class:: classref-method
  1916. void **set_tooltip_request_func** **(** :ref:`Callable<class_Callable>` callback **)**
  1917. Provide custom tooltip text. The callback method must take the following args: ``hovered_word: String``.
  1918. .. rst-class:: classref-item-separator
  1919. ----
  1920. .. _class_TextEdit_method_start_action:
  1921. .. rst-class:: classref-method
  1922. void **start_action** **(** :ref:`EditAction<enum_TextEdit_EditAction>` action **)**
  1923. Starts an action, will end the current action if ``action`` is different.
  1924. An action will also end after a call to :ref:`end_action<class_TextEdit_method_end_action>`, after :ref:`ProjectSettings.gui/timers/text_edit_idle_detect_sec<class_ProjectSettings_property_gui/timers/text_edit_idle_detect_sec>` is triggered or a new undoable step outside the :ref:`start_action<class_TextEdit_method_start_action>` and :ref:`end_action<class_TextEdit_method_end_action>` calls.
  1925. .. rst-class:: classref-item-separator
  1926. ----
  1927. .. _class_TextEdit_method_swap_lines:
  1928. .. rst-class:: classref-method
  1929. void **swap_lines** **(** :ref:`int<class_int>` from_line, :ref:`int<class_int>` to_line **)**
  1930. Swaps the two lines.
  1931. .. rst-class:: classref-item-separator
  1932. ----
  1933. .. _class_TextEdit_method_tag_saved_version:
  1934. .. rst-class:: classref-method
  1935. void **tag_saved_version** **(** **)**
  1936. Tag the current version as saved.
  1937. .. rst-class:: classref-item-separator
  1938. ----
  1939. .. _class_TextEdit_method_undo:
  1940. .. rst-class:: classref-method
  1941. void **undo** **(** **)**
  1942. Perform undo operation.
  1943. .. rst-class:: classref-section-separator
  1944. ----
  1945. .. rst-class:: classref-descriptions-group
  1946. Theme Property Descriptions
  1947. ---------------------------
  1948. .. _class_TextEdit_theme_color_background_color:
  1949. .. rst-class:: classref-themeproperty
  1950. :ref:`Color<class_Color>` **background_color** = ``Color(0, 0, 0, 0)``
  1951. Sets the background :ref:`Color<class_Color>` of this **TextEdit**.
  1952. .. rst-class:: classref-item-separator
  1953. ----
  1954. .. _class_TextEdit_theme_color_caret_background_color:
  1955. .. rst-class:: classref-themeproperty
  1956. :ref:`Color<class_Color>` **caret_background_color** = ``Color(0, 0, 0, 1)``
  1957. :ref:`Color<class_Color>` of the text behind the caret when using a block caret.
  1958. .. rst-class:: classref-item-separator
  1959. ----
  1960. .. _class_TextEdit_theme_color_caret_color:
  1961. .. rst-class:: classref-themeproperty
  1962. :ref:`Color<class_Color>` **caret_color** = ``Color(0.875, 0.875, 0.875, 1)``
  1963. :ref:`Color<class_Color>` of the caret. This can be set to a fully transparent color to hide the caret entirely.
  1964. .. rst-class:: classref-item-separator
  1965. ----
  1966. .. _class_TextEdit_theme_color_current_line_color:
  1967. .. rst-class:: classref-themeproperty
  1968. :ref:`Color<class_Color>` **current_line_color** = ``Color(0.25, 0.25, 0.26, 0.8)``
  1969. Background :ref:`Color<class_Color>` of the line containing the caret.
  1970. .. rst-class:: classref-item-separator
  1971. ----
  1972. .. _class_TextEdit_theme_color_font_color:
  1973. .. rst-class:: classref-themeproperty
  1974. :ref:`Color<class_Color>` **font_color** = ``Color(0.875, 0.875, 0.875, 1)``
  1975. Sets the font :ref:`Color<class_Color>`.
  1976. .. rst-class:: classref-item-separator
  1977. ----
  1978. .. _class_TextEdit_theme_color_font_outline_color:
  1979. .. rst-class:: classref-themeproperty
  1980. :ref:`Color<class_Color>` **font_outline_color** = ``Color(1, 1, 1, 1)``
  1981. The tint of text outline of the **TextEdit**.
  1982. .. rst-class:: classref-item-separator
  1983. ----
  1984. .. _class_TextEdit_theme_color_font_placeholder_color:
  1985. .. rst-class:: classref-themeproperty
  1986. :ref:`Color<class_Color>` **font_placeholder_color** = ``Color(0.875, 0.875, 0.875, 0.6)``
  1987. Font color for :ref:`placeholder_text<class_TextEdit_property_placeholder_text>`.
  1988. .. rst-class:: classref-item-separator
  1989. ----
  1990. .. _class_TextEdit_theme_color_font_readonly_color:
  1991. .. rst-class:: classref-themeproperty
  1992. :ref:`Color<class_Color>` **font_readonly_color** = ``Color(0.875, 0.875, 0.875, 0.5)``
  1993. Sets the font :ref:`Color<class_Color>` when :ref:`editable<class_TextEdit_property_editable>` is disabled.
  1994. .. rst-class:: classref-item-separator
  1995. ----
  1996. .. _class_TextEdit_theme_color_font_selected_color:
  1997. .. rst-class:: classref-themeproperty
  1998. :ref:`Color<class_Color>` **font_selected_color** = ``Color(0, 0, 0, 0)``
  1999. Sets the :ref:`Color<class_Color>` of the selected text. If equal to ``Color(0, 0, 0, 0)``, it will be ignored.
  2000. .. rst-class:: classref-item-separator
  2001. ----
  2002. .. _class_TextEdit_theme_color_search_result_border_color:
  2003. .. rst-class:: classref-themeproperty
  2004. :ref:`Color<class_Color>` **search_result_border_color** = ``Color(0.3, 0.3, 0.3, 0.4)``
  2005. :ref:`Color<class_Color>` of the border around text that matches the search query.
  2006. .. rst-class:: classref-item-separator
  2007. ----
  2008. .. _class_TextEdit_theme_color_search_result_color:
  2009. .. rst-class:: classref-themeproperty
  2010. :ref:`Color<class_Color>` **search_result_color** = ``Color(0.3, 0.3, 0.3, 1)``
  2011. :ref:`Color<class_Color>` behind the text that matches the search query.
  2012. .. rst-class:: classref-item-separator
  2013. ----
  2014. .. _class_TextEdit_theme_color_selection_color:
  2015. .. rst-class:: classref-themeproperty
  2016. :ref:`Color<class_Color>` **selection_color** = ``Color(0.5, 0.5, 0.5, 1)``
  2017. Sets the highlight :ref:`Color<class_Color>` of text selections.
  2018. .. rst-class:: classref-item-separator
  2019. ----
  2020. .. _class_TextEdit_theme_color_word_highlighted_color:
  2021. .. rst-class:: classref-themeproperty
  2022. :ref:`Color<class_Color>` **word_highlighted_color** = ``Color(0.5, 0.5, 0.5, 0.25)``
  2023. Sets the highlight :ref:`Color<class_Color>` of multiple occurrences. :ref:`highlight_all_occurrences<class_TextEdit_property_highlight_all_occurrences>` has to be enabled.
  2024. .. rst-class:: classref-item-separator
  2025. ----
  2026. .. _class_TextEdit_theme_constant_caret_width:
  2027. .. rst-class:: classref-themeproperty
  2028. :ref:`int<class_int>` **caret_width** = ``1``
  2029. 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.
  2030. .. rst-class:: classref-item-separator
  2031. ----
  2032. .. _class_TextEdit_theme_constant_line_spacing:
  2033. .. rst-class:: classref-themeproperty
  2034. :ref:`int<class_int>` **line_spacing** = ``4``
  2035. Sets the spacing between the lines.
  2036. .. rst-class:: classref-item-separator
  2037. ----
  2038. .. _class_TextEdit_theme_constant_outline_size:
  2039. .. rst-class:: classref-themeproperty
  2040. :ref:`int<class_int>` **outline_size** = ``0``
  2041. The size of the text outline.
  2042. \ **Note:** If using a font with :ref:`FontFile.multichannel_signed_distance_field<class_FontFile_property_multichannel_signed_distance_field>` enabled, its :ref:`FontFile.msdf_pixel_range<class_FontFile_property_msdf_pixel_range>` must be set to at least *twice* the value of :ref:`outline_size<class_TextEdit_theme_constant_outline_size>` for outline rendering to look correct. Otherwise, the outline may appear to be cut off earlier than intended.
  2043. .. rst-class:: classref-item-separator
  2044. ----
  2045. .. _class_TextEdit_theme_font_font:
  2046. .. rst-class:: classref-themeproperty
  2047. :ref:`Font<class_Font>` **font**
  2048. Sets the default :ref:`Font<class_Font>`.
  2049. .. rst-class:: classref-item-separator
  2050. ----
  2051. .. _class_TextEdit_theme_font_size_font_size:
  2052. .. rst-class:: classref-themeproperty
  2053. :ref:`int<class_int>` **font_size**
  2054. Sets default font size.
  2055. .. rst-class:: classref-item-separator
  2056. ----
  2057. .. _class_TextEdit_theme_icon_space:
  2058. .. rst-class:: classref-themeproperty
  2059. :ref:`Texture2D<class_Texture2D>` **space**
  2060. Sets a custom :ref:`Texture2D<class_Texture2D>` for space text characters.
  2061. .. rst-class:: classref-item-separator
  2062. ----
  2063. .. _class_TextEdit_theme_icon_tab:
  2064. .. rst-class:: classref-themeproperty
  2065. :ref:`Texture2D<class_Texture2D>` **tab**
  2066. Sets a custom :ref:`Texture2D<class_Texture2D>` for tab text characters.
  2067. .. rst-class:: classref-item-separator
  2068. ----
  2069. .. _class_TextEdit_theme_style_focus:
  2070. .. rst-class:: classref-themeproperty
  2071. :ref:`StyleBox<class_StyleBox>` **focus**
  2072. Sets the :ref:`StyleBox<class_StyleBox>` when in focus. The ``focus`` :ref:`StyleBox<class_StyleBox>` is displayed *over* the base :ref:`StyleBox<class_StyleBox>`, so a partially transparent :ref:`StyleBox<class_StyleBox>` should be used to ensure the base :ref:`StyleBox<class_StyleBox>` remains visible. A :ref:`StyleBox<class_StyleBox>` that represents an outline or an underline works well for this purpose. To disable the focus visual effect, assign a :ref:`StyleBoxEmpty<class_StyleBoxEmpty>` resource. Note that disabling the focus visual effect will harm keyboard/controller navigation usability, so this is not recommended for accessibility reasons.
  2073. .. rst-class:: classref-item-separator
  2074. ----
  2075. .. _class_TextEdit_theme_style_normal:
  2076. .. rst-class:: classref-themeproperty
  2077. :ref:`StyleBox<class_StyleBox>` **normal**
  2078. Sets the :ref:`StyleBox<class_StyleBox>` of this **TextEdit**.
  2079. .. rst-class:: classref-item-separator
  2080. ----
  2081. .. _class_TextEdit_theme_style_read_only:
  2082. .. rst-class:: classref-themeproperty
  2083. :ref:`StyleBox<class_StyleBox>` **read_only**
  2084. Sets the :ref:`StyleBox<class_StyleBox>` of this **TextEdit** when :ref:`editable<class_TextEdit_property_editable>` is disabled.
  2085. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  2086. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  2087. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  2088. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  2089. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  2090. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`