2
0

class_textedit.rst 208 KB

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