class_textedit.rst 251 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120
  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/4.3/doc/tools/make_rst.py.
  7. .. XML source: https://github.com/godotengine/godot/tree/4.3/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 in the order they were created.
  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>` | clip_contents | ``true`` (overrides :ref:`Control<class_Control_property_clip_contents>`) |
  43. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  44. | :ref:`bool<class_bool>` | :ref:`context_menu_enabled<class_TextEdit_property_context_menu_enabled>` | ``true`` |
  45. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  46. | :ref:`String<class_String>` | :ref:`custom_word_separators<class_TextEdit_property_custom_word_separators>` | ``""`` |
  47. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  48. | :ref:`bool<class_bool>` | :ref:`deselect_on_focus_loss_enabled<class_TextEdit_property_deselect_on_focus_loss_enabled>` | ``true`` |
  49. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  50. | :ref:`bool<class_bool>` | :ref:`drag_and_drop_selection_enabled<class_TextEdit_property_drag_and_drop_selection_enabled>` | ``true`` |
  51. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  52. | :ref:`bool<class_bool>` | :ref:`draw_control_chars<class_TextEdit_property_draw_control_chars>` | ``false`` |
  53. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  54. | :ref:`bool<class_bool>` | :ref:`draw_spaces<class_TextEdit_property_draw_spaces>` | ``false`` |
  55. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  56. | :ref:`bool<class_bool>` | :ref:`draw_tabs<class_TextEdit_property_draw_tabs>` | ``false`` |
  57. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  58. | :ref:`bool<class_bool>` | :ref:`editable<class_TextEdit_property_editable>` | ``true`` |
  59. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  60. | :ref:`FocusMode<enum_Control_FocusMode>` | focus_mode | ``2`` (overrides :ref:`Control<class_Control_property_focus_mode>`) |
  61. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  62. | :ref:`bool<class_bool>` | :ref:`highlight_all_occurrences<class_TextEdit_property_highlight_all_occurrences>` | ``false`` |
  63. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  64. | :ref:`bool<class_bool>` | :ref:`highlight_current_line<class_TextEdit_property_highlight_current_line>` | ``false`` |
  65. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  66. | :ref:`bool<class_bool>` | :ref:`indent_wrapped_lines<class_TextEdit_property_indent_wrapped_lines>` | ``false`` |
  67. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  68. | :ref:`String<class_String>` | :ref:`language<class_TextEdit_property_language>` | ``""`` |
  69. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  70. | :ref:`bool<class_bool>` | :ref:`middle_mouse_paste_enabled<class_TextEdit_property_middle_mouse_paste_enabled>` | ``true`` |
  71. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  72. | :ref:`bool<class_bool>` | :ref:`minimap_draw<class_TextEdit_property_minimap_draw>` | ``false`` |
  73. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  74. | :ref:`int<class_int>` | :ref:`minimap_width<class_TextEdit_property_minimap_width>` | ``80`` |
  75. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  76. | :ref:`CursorShape<enum_Control_CursorShape>` | mouse_default_cursor_shape | ``1`` (overrides :ref:`Control<class_Control_property_mouse_default_cursor_shape>`) |
  77. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  78. | :ref:`String<class_String>` | :ref:`placeholder_text<class_TextEdit_property_placeholder_text>` | ``""`` |
  79. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  80. | :ref:`bool<class_bool>` | :ref:`scroll_fit_content_height<class_TextEdit_property_scroll_fit_content_height>` | ``false`` |
  81. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  82. | :ref:`int<class_int>` | :ref:`scroll_horizontal<class_TextEdit_property_scroll_horizontal>` | ``0`` |
  83. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  84. | :ref:`bool<class_bool>` | :ref:`scroll_past_end_of_file<class_TextEdit_property_scroll_past_end_of_file>` | ``false`` |
  85. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  86. | :ref:`bool<class_bool>` | :ref:`scroll_smooth<class_TextEdit_property_scroll_smooth>` | ``false`` |
  87. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  88. | :ref:`float<class_float>` | :ref:`scroll_v_scroll_speed<class_TextEdit_property_scroll_v_scroll_speed>` | ``80.0`` |
  89. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  90. | :ref:`float<class_float>` | :ref:`scroll_vertical<class_TextEdit_property_scroll_vertical>` | ``0.0`` |
  91. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  92. | :ref:`bool<class_bool>` | :ref:`selecting_enabled<class_TextEdit_property_selecting_enabled>` | ``true`` |
  93. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  94. | :ref:`bool<class_bool>` | :ref:`shortcut_keys_enabled<class_TextEdit_property_shortcut_keys_enabled>` | ``true`` |
  95. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  96. | :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` | :ref:`structured_text_bidi_override<class_TextEdit_property_structured_text_bidi_override>` | ``0`` |
  97. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  98. | :ref:`Array<class_Array>` | :ref:`structured_text_bidi_override_options<class_TextEdit_property_structured_text_bidi_override_options>` | ``[]`` |
  99. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  100. | :ref:`SyntaxHighlighter<class_SyntaxHighlighter>` | :ref:`syntax_highlighter<class_TextEdit_property_syntax_highlighter>` | |
  101. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  102. | :ref:`String<class_String>` | :ref:`text<class_TextEdit_property_text>` | ``""`` |
  103. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  104. | :ref:`TextDirection<enum_Control_TextDirection>` | :ref:`text_direction<class_TextEdit_property_text_direction>` | ``0`` |
  105. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  106. | :ref:`bool<class_bool>` | :ref:`use_custom_word_separators<class_TextEdit_property_use_custom_word_separators>` | ``false`` |
  107. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  108. | :ref:`bool<class_bool>` | :ref:`use_default_word_separators<class_TextEdit_property_use_default_word_separators>` | ``true`` |
  109. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  110. | :ref:`bool<class_bool>` | :ref:`virtual_keyboard_enabled<class_TextEdit_property_virtual_keyboard_enabled>` | ``true`` |
  111. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  112. | :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` | :ref:`wrap_mode<class_TextEdit_property_wrap_mode>` | ``0`` |
  113. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
  114. .. rst-class:: classref-reftable-group
  115. Methods
  116. -------
  117. .. table::
  118. :widths: auto
  119. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  120. | |void| | :ref:`_backspace<class_TextEdit_private_method__backspace>`\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| |
  121. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  122. | |void| | :ref:`_copy<class_TextEdit_private_method__copy>`\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| |
  123. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  124. | |void| | :ref:`_cut<class_TextEdit_private_method__cut>`\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| |
  125. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  126. | |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| |
  127. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  128. | |void| | :ref:`_paste<class_TextEdit_private_method__paste>`\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| |
  129. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  130. | |void| | :ref:`_paste_primary_clipboard<class_TextEdit_private_method__paste_primary_clipboard>`\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| |
  131. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  132. | :ref:`int<class_int>` | :ref:`add_caret<class_TextEdit_method_add_caret>`\ (\ line\: :ref:`int<class_int>`, column\: :ref:`int<class_int>`\ ) |
  133. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  134. | |void| | :ref:`add_caret_at_carets<class_TextEdit_method_add_caret_at_carets>`\ (\ below\: :ref:`bool<class_bool>`\ ) |
  135. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  136. | |void| | :ref:`add_gutter<class_TextEdit_method_add_gutter>`\ (\ at\: :ref:`int<class_int>` = -1\ ) |
  137. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  138. | |void| | :ref:`add_selection_for_next_occurrence<class_TextEdit_method_add_selection_for_next_occurrence>`\ (\ ) |
  139. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  140. | |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>`\ ) |
  141. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  142. | |void| | :ref:`adjust_viewport_to_caret<class_TextEdit_method_adjust_viewport_to_caret>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |
  143. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  144. | |void| | :ref:`apply_ime<class_TextEdit_method_apply_ime>`\ (\ ) |
  145. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  146. | |void| | :ref:`backspace<class_TextEdit_method_backspace>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |
  147. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  148. | |void| | :ref:`begin_complex_operation<class_TextEdit_method_begin_complex_operation>`\ (\ ) |
  149. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  150. | |void| | :ref:`begin_multicaret_edit<class_TextEdit_method_begin_multicaret_edit>`\ (\ ) |
  151. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  152. | |void| | :ref:`cancel_ime<class_TextEdit_method_cancel_ime>`\ (\ ) |
  153. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  154. | |void| | :ref:`center_viewport_to_caret<class_TextEdit_method_center_viewport_to_caret>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |
  155. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  156. | |void| | :ref:`clear<class_TextEdit_method_clear>`\ (\ ) |
  157. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  158. | |void| | :ref:`clear_undo_history<class_TextEdit_method_clear_undo_history>`\ (\ ) |
  159. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  160. | |void| | :ref:`collapse_carets<class_TextEdit_method_collapse_carets>`\ (\ from_line\: :ref:`int<class_int>`, from_column\: :ref:`int<class_int>`, to_line\: :ref:`int<class_int>`, to_column\: :ref:`int<class_int>`, inclusive\: :ref:`bool<class_bool>` = false\ ) |
  161. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  162. | |void| | :ref:`copy<class_TextEdit_method_copy>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |
  163. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  164. | |void| | :ref:`cut<class_TextEdit_method_cut>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |
  165. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  166. | |void| | :ref:`delete_selection<class_TextEdit_method_delete_selection>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |
  167. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  168. | |void| | :ref:`deselect<class_TextEdit_method_deselect>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |
  169. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  170. | |void| | :ref:`end_action<class_TextEdit_method_end_action>`\ (\ ) |
  171. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  172. | |void| | :ref:`end_complex_operation<class_TextEdit_method_end_complex_operation>`\ (\ ) |
  173. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  174. | |void| | :ref:`end_multicaret_edit<class_TextEdit_method_end_multicaret_edit>`\ (\ ) |
  175. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  176. | :ref:`int<class_int>` | :ref:`get_caret_column<class_TextEdit_method_get_caret_column>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  177. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  178. | :ref:`int<class_int>` | :ref:`get_caret_count<class_TextEdit_method_get_caret_count>`\ (\ ) |const| |
  179. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  180. | :ref:`Vector2<class_Vector2>` | :ref:`get_caret_draw_pos<class_TextEdit_method_get_caret_draw_pos>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  181. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  182. | :ref:`PackedInt32Array<class_PackedInt32Array>` | :ref:`get_caret_index_edit_order<class_TextEdit_method_get_caret_index_edit_order>`\ (\ ) |
  183. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  184. | :ref:`int<class_int>` | :ref:`get_caret_line<class_TextEdit_method_get_caret_line>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  185. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  186. | :ref:`int<class_int>` | :ref:`get_caret_wrap_index<class_TextEdit_method_get_caret_wrap_index>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  187. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  188. | :ref:`int<class_int>` | :ref:`get_first_non_whitespace_column<class_TextEdit_method_get_first_non_whitespace_column>`\ (\ line\: :ref:`int<class_int>`\ ) |const| |
  189. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  190. | :ref:`int<class_int>` | :ref:`get_first_visible_line<class_TextEdit_method_get_first_visible_line>`\ (\ ) |const| |
  191. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  192. | :ref:`int<class_int>` | :ref:`get_gutter_count<class_TextEdit_method_get_gutter_count>`\ (\ ) |const| |
  193. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  194. | :ref:`String<class_String>` | :ref:`get_gutter_name<class_TextEdit_method_get_gutter_name>`\ (\ gutter\: :ref:`int<class_int>`\ ) |const| |
  195. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  196. | :ref:`GutterType<enum_TextEdit_GutterType>` | :ref:`get_gutter_type<class_TextEdit_method_get_gutter_type>`\ (\ gutter\: :ref:`int<class_int>`\ ) |const| |
  197. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  198. | :ref:`int<class_int>` | :ref:`get_gutter_width<class_TextEdit_method_get_gutter_width>`\ (\ gutter\: :ref:`int<class_int>`\ ) |const| |
  199. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  200. | :ref:`HScrollBar<class_HScrollBar>` | :ref:`get_h_scroll_bar<class_TextEdit_method_get_h_scroll_bar>`\ (\ ) |const| |
  201. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  202. | :ref:`int<class_int>` | :ref:`get_indent_level<class_TextEdit_method_get_indent_level>`\ (\ line\: :ref:`int<class_int>`\ ) |const| |
  203. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  204. | :ref:`int<class_int>` | :ref:`get_last_full_visible_line<class_TextEdit_method_get_last_full_visible_line>`\ (\ ) |const| |
  205. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  206. | :ref:`int<class_int>` | :ref:`get_last_full_visible_line_wrap_index<class_TextEdit_method_get_last_full_visible_line_wrap_index>`\ (\ ) |const| |
  207. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  208. | :ref:`int<class_int>` | :ref:`get_last_unhidden_line<class_TextEdit_method_get_last_unhidden_line>`\ (\ ) |const| |
  209. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  210. | :ref:`String<class_String>` | :ref:`get_line<class_TextEdit_method_get_line>`\ (\ line\: :ref:`int<class_int>`\ ) |const| |
  211. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  212. | :ref:`Color<class_Color>` | :ref:`get_line_background_color<class_TextEdit_method_get_line_background_color>`\ (\ line\: :ref:`int<class_int>`\ ) |const| |
  213. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  214. | :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| |
  215. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  216. | :ref:`int<class_int>` | :ref:`get_line_count<class_TextEdit_method_get_line_count>`\ (\ ) |const| |
  217. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  218. | :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| |
  219. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  220. | :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| |
  221. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  222. | :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| |
  223. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  224. | :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| |
  225. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  226. | :ref:`int<class_int>` | :ref:`get_line_height<class_TextEdit_method_get_line_height>`\ (\ ) |const| |
  227. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  228. | :ref:`Array<class_Array>`\[:ref:`Vector2i<class_Vector2i>`\] | :ref:`get_line_ranges_from_carets<class_TextEdit_method_get_line_ranges_from_carets>`\ (\ only_selections\: :ref:`bool<class_bool>` = false, merge_adjacent\: :ref:`bool<class_bool>` = true\ ) |const| |
  229. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  230. | :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| |
  231. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  232. | :ref:`int<class_int>` | :ref:`get_line_wrap_count<class_TextEdit_method_get_line_wrap_count>`\ (\ line\: :ref:`int<class_int>`\ ) |const| |
  233. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  234. | :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| |
  235. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  236. | :ref:`PackedStringArray<class_PackedStringArray>` | :ref:`get_line_wrapped_text<class_TextEdit_method_get_line_wrapped_text>`\ (\ line\: :ref:`int<class_int>`\ ) |const| |
  237. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  238. | :ref:`Vector2<class_Vector2>` | :ref:`get_local_mouse_pos<class_TextEdit_method_get_local_mouse_pos>`\ (\ ) |const| |
  239. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  240. | :ref:`PopupMenu<class_PopupMenu>` | :ref:`get_menu<class_TextEdit_method_get_menu>`\ (\ ) |const| |
  241. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  242. | :ref:`int<class_int>` | :ref:`get_minimap_line_at_pos<class_TextEdit_method_get_minimap_line_at_pos>`\ (\ position\: :ref:`Vector2i<class_Vector2i>`\ ) |const| |
  243. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  244. | :ref:`int<class_int>` | :ref:`get_minimap_visible_lines<class_TextEdit_method_get_minimap_visible_lines>`\ (\ ) |const| |
  245. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  246. | :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| |
  247. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  248. | :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| |
  249. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  250. | :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| |
  251. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  252. | :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| |
  253. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  254. | :ref:`int<class_int>` | :ref:`get_saved_version<class_TextEdit_method_get_saved_version>`\ (\ ) |const| |
  255. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  256. | :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| |
  257. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  258. | :ref:`String<class_String>` | :ref:`get_selected_text<class_TextEdit_method_get_selected_text>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |
  259. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  260. | :ref:`int<class_int>` | :ref:`get_selection_at_line_column<class_TextEdit_method_get_selection_at_line_column>`\ (\ line\: :ref:`int<class_int>`, column\: :ref:`int<class_int>`, include_edges\: :ref:`bool<class_bool>` = true, only_selections\: :ref:`bool<class_bool>` = true\ ) |const| |
  261. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  262. | :ref:`int<class_int>` | :ref:`get_selection_column<class_TextEdit_method_get_selection_column>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  263. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  264. | :ref:`int<class_int>` | :ref:`get_selection_from_column<class_TextEdit_method_get_selection_from_column>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  265. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  266. | :ref:`int<class_int>` | :ref:`get_selection_from_line<class_TextEdit_method_get_selection_from_line>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  267. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  268. | :ref:`int<class_int>` | :ref:`get_selection_line<class_TextEdit_method_get_selection_line>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  269. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  270. | :ref:`SelectionMode<enum_TextEdit_SelectionMode>` | :ref:`get_selection_mode<class_TextEdit_method_get_selection_mode>`\ (\ ) |const| |
  271. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  272. | :ref:`int<class_int>` | :ref:`get_selection_origin_column<class_TextEdit_method_get_selection_origin_column>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  273. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  274. | :ref:`int<class_int>` | :ref:`get_selection_origin_line<class_TextEdit_method_get_selection_origin_line>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  275. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  276. | :ref:`int<class_int>` | :ref:`get_selection_to_column<class_TextEdit_method_get_selection_to_column>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  277. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  278. | :ref:`int<class_int>` | :ref:`get_selection_to_line<class_TextEdit_method_get_selection_to_line>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  279. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  280. | :ref:`PackedInt32Array<class_PackedInt32Array>` | :ref:`get_sorted_carets<class_TextEdit_method_get_sorted_carets>`\ (\ include_ignored_carets\: :ref:`bool<class_bool>` = false\ ) |const| |
  281. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  282. | :ref:`int<class_int>` | :ref:`get_tab_size<class_TextEdit_method_get_tab_size>`\ (\ ) |const| |
  283. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  284. | :ref:`int<class_int>` | :ref:`get_total_gutter_width<class_TextEdit_method_get_total_gutter_width>`\ (\ ) |const| |
  285. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  286. | :ref:`int<class_int>` | :ref:`get_total_visible_line_count<class_TextEdit_method_get_total_visible_line_count>`\ (\ ) |const| |
  287. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  288. | :ref:`VScrollBar<class_VScrollBar>` | :ref:`get_v_scroll_bar<class_TextEdit_method_get_v_scroll_bar>`\ (\ ) |const| |
  289. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  290. | :ref:`int<class_int>` | :ref:`get_version<class_TextEdit_method_get_version>`\ (\ ) |const| |
  291. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  292. | :ref:`int<class_int>` | :ref:`get_visible_line_count<class_TextEdit_method_get_visible_line_count>`\ (\ ) |const| |
  293. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  294. | :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| |
  295. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  296. | :ref:`String<class_String>` | :ref:`get_word_at_pos<class_TextEdit_method_get_word_at_pos>`\ (\ position\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  297. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  298. | :ref:`String<class_String>` | :ref:`get_word_under_caret<class_TextEdit_method_get_word_under_caret>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |const| |
  299. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  300. | :ref:`bool<class_bool>` | :ref:`has_ime_text<class_TextEdit_method_has_ime_text>`\ (\ ) |const| |
  301. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  302. | :ref:`bool<class_bool>` | :ref:`has_redo<class_TextEdit_method_has_redo>`\ (\ ) |const| |
  303. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  304. | :ref:`bool<class_bool>` | :ref:`has_selection<class_TextEdit_method_has_selection>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |const| |
  305. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  306. | :ref:`bool<class_bool>` | :ref:`has_undo<class_TextEdit_method_has_undo>`\ (\ ) |const| |
  307. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  308. | |void| | :ref:`insert_line_at<class_TextEdit_method_insert_line_at>`\ (\ line\: :ref:`int<class_int>`, text\: :ref:`String<class_String>`\ ) |
  309. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  310. | |void| | :ref:`insert_text<class_TextEdit_method_insert_text>`\ (\ text\: :ref:`String<class_String>`, line\: :ref:`int<class_int>`, column\: :ref:`int<class_int>`, before_selection_begin\: :ref:`bool<class_bool>` = true, before_selection_end\: :ref:`bool<class_bool>` = false\ ) |
  311. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  312. | |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\ ) |
  313. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  314. | :ref:`bool<class_bool>` | :ref:`is_caret_after_selection_origin<class_TextEdit_method_is_caret_after_selection_origin>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  315. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  316. | :ref:`bool<class_bool>` | :ref:`is_caret_visible<class_TextEdit_method_is_caret_visible>`\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| |
  317. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  318. | :ref:`bool<class_bool>` | :ref:`is_dragging_cursor<class_TextEdit_method_is_dragging_cursor>`\ (\ ) |const| |
  319. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  320. | :ref:`bool<class_bool>` | :ref:`is_gutter_clickable<class_TextEdit_method_is_gutter_clickable>`\ (\ gutter\: :ref:`int<class_int>`\ ) |const| |
  321. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  322. | :ref:`bool<class_bool>` | :ref:`is_gutter_drawn<class_TextEdit_method_is_gutter_drawn>`\ (\ gutter\: :ref:`int<class_int>`\ ) |const| |
  323. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  324. | :ref:`bool<class_bool>` | :ref:`is_gutter_overwritable<class_TextEdit_method_is_gutter_overwritable>`\ (\ gutter\: :ref:`int<class_int>`\ ) |const| |
  325. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  326. | :ref:`bool<class_bool>` | :ref:`is_in_mulitcaret_edit<class_TextEdit_method_is_in_mulitcaret_edit>`\ (\ ) |const| |
  327. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  328. | :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| |
  329. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  330. | :ref:`bool<class_bool>` | :ref:`is_line_wrapped<class_TextEdit_method_is_line_wrapped>`\ (\ line\: :ref:`int<class_int>`\ ) |const| |
  331. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  332. | :ref:`bool<class_bool>` | :ref:`is_menu_visible<class_TextEdit_method_is_menu_visible>`\ (\ ) |const| |
  333. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  334. | :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| |
  335. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  336. | :ref:`bool<class_bool>` | :ref:`is_overtype_mode_enabled<class_TextEdit_method_is_overtype_mode_enabled>`\ (\ ) |const| |
  337. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  338. | |void| | :ref:`menu_option<class_TextEdit_method_menu_option>`\ (\ option\: :ref:`int<class_int>`\ ) |
  339. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  340. | |void| | :ref:`merge_gutters<class_TextEdit_method_merge_gutters>`\ (\ from_line\: :ref:`int<class_int>`, to_line\: :ref:`int<class_int>`\ ) |
  341. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  342. | |void| | :ref:`merge_overlapping_carets<class_TextEdit_method_merge_overlapping_carets>`\ (\ ) |
  343. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  344. | :ref:`bool<class_bool>` | :ref:`multicaret_edit_ignore_caret<class_TextEdit_method_multicaret_edit_ignore_caret>`\ (\ caret_index\: :ref:`int<class_int>`\ ) |const| |
  345. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  346. | |void| | :ref:`paste<class_TextEdit_method_paste>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |
  347. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  348. | |void| | :ref:`paste_primary_clipboard<class_TextEdit_method_paste_primary_clipboard>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |
  349. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  350. | |void| | :ref:`redo<class_TextEdit_method_redo>`\ (\ ) |
  351. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  352. | |void| | :ref:`remove_caret<class_TextEdit_method_remove_caret>`\ (\ caret\: :ref:`int<class_int>`\ ) |
  353. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  354. | |void| | :ref:`remove_gutter<class_TextEdit_method_remove_gutter>`\ (\ gutter\: :ref:`int<class_int>`\ ) |
  355. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  356. | |void| | :ref:`remove_line_at<class_TextEdit_method_remove_line_at>`\ (\ line\: :ref:`int<class_int>`, move_carets_down\: :ref:`bool<class_bool>` = true\ ) |
  357. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  358. | |void| | :ref:`remove_secondary_carets<class_TextEdit_method_remove_secondary_carets>`\ (\ ) |
  359. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  360. | |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>`\ ) |
  361. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  362. | :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_column\: :ref:`int<class_int>`\ ) |const| |
  363. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  364. | |void| | :ref:`select<class_TextEdit_method_select>`\ (\ origin_line\: :ref:`int<class_int>`, origin_column\: :ref:`int<class_int>`, caret_line\: :ref:`int<class_int>`, caret_column\: :ref:`int<class_int>`, caret_index\: :ref:`int<class_int>` = 0\ ) |
  365. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  366. | |void| | :ref:`select_all<class_TextEdit_method_select_all>`\ (\ ) |
  367. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  368. | |void| | :ref:`select_word_under_caret<class_TextEdit_method_select_word_under_caret>`\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |
  369. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  370. | |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\ ) |
  371. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  372. | |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\ ) |
  373. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  374. | |void| | :ref:`set_gutter_clickable<class_TextEdit_method_set_gutter_clickable>`\ (\ gutter\: :ref:`int<class_int>`, clickable\: :ref:`bool<class_bool>`\ ) |
  375. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  376. | |void| | :ref:`set_gutter_custom_draw<class_TextEdit_method_set_gutter_custom_draw>`\ (\ column\: :ref:`int<class_int>`, draw_callback\: :ref:`Callable<class_Callable>`\ ) |
  377. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  378. | |void| | :ref:`set_gutter_draw<class_TextEdit_method_set_gutter_draw>`\ (\ gutter\: :ref:`int<class_int>`, draw\: :ref:`bool<class_bool>`\ ) |
  379. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  380. | |void| | :ref:`set_gutter_name<class_TextEdit_method_set_gutter_name>`\ (\ gutter\: :ref:`int<class_int>`, name\: :ref:`String<class_String>`\ ) |
  381. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  382. | |void| | :ref:`set_gutter_overwritable<class_TextEdit_method_set_gutter_overwritable>`\ (\ gutter\: :ref:`int<class_int>`, overwritable\: :ref:`bool<class_bool>`\ ) |
  383. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  384. | |void| | :ref:`set_gutter_type<class_TextEdit_method_set_gutter_type>`\ (\ gutter\: :ref:`int<class_int>`, type\: :ref:`GutterType<enum_TextEdit_GutterType>`\ ) |
  385. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  386. | |void| | :ref:`set_gutter_width<class_TextEdit_method_set_gutter_width>`\ (\ gutter\: :ref:`int<class_int>`, width\: :ref:`int<class_int>`\ ) |
  387. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  388. | |void| | :ref:`set_line<class_TextEdit_method_set_line>`\ (\ line\: :ref:`int<class_int>`, new_text\: :ref:`String<class_String>`\ ) |
  389. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  390. | |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\ ) |
  391. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  392. | |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\ ) |
  393. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  394. | |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\ ) |
  395. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  396. | |void| | :ref:`set_line_background_color<class_TextEdit_method_set_line_background_color>`\ (\ line\: :ref:`int<class_int>`, color\: :ref:`Color<class_Color>`\ ) |
  397. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  398. | |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>`\ ) |
  399. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  400. | |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>`\ ) |
  401. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  402. | |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>`\ ) |
  403. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  404. | |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>`\ ) |
  405. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  406. | |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>`\ ) |
  407. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  408. | |void| | :ref:`set_overtype_mode_enabled<class_TextEdit_method_set_overtype_mode_enabled>`\ (\ enabled\: :ref:`bool<class_bool>`\ ) |
  409. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  410. | |void| | :ref:`set_search_flags<class_TextEdit_method_set_search_flags>`\ (\ flags\: :ref:`int<class_int>`\ ) |
  411. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  412. | |void| | :ref:`set_search_text<class_TextEdit_method_set_search_text>`\ (\ search_text\: :ref:`String<class_String>`\ ) |
  413. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  414. | |void| | :ref:`set_selection_mode<class_TextEdit_method_set_selection_mode>`\ (\ mode\: :ref:`SelectionMode<enum_TextEdit_SelectionMode>`\ ) |
  415. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  416. | |void| | :ref:`set_selection_origin_column<class_TextEdit_method_set_selection_origin_column>`\ (\ column\: :ref:`int<class_int>`, caret_index\: :ref:`int<class_int>` = 0\ ) |
  417. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  418. | |void| | :ref:`set_selection_origin_line<class_TextEdit_method_set_selection_origin_line>`\ (\ line\: :ref:`int<class_int>`, can_be_hidden\: :ref:`bool<class_bool>` = true, wrap_index\: :ref:`int<class_int>` = -1, caret_index\: :ref:`int<class_int>` = 0\ ) |
  419. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  420. | |void| | :ref:`set_tab_size<class_TextEdit_method_set_tab_size>`\ (\ size\: :ref:`int<class_int>`\ ) |
  421. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  422. | |void| | :ref:`set_tooltip_request_func<class_TextEdit_method_set_tooltip_request_func>`\ (\ callback\: :ref:`Callable<class_Callable>`\ ) |
  423. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  424. | |void| | :ref:`skip_selection_for_next_occurrence<class_TextEdit_method_skip_selection_for_next_occurrence>`\ (\ ) |
  425. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  426. | |void| | :ref:`start_action<class_TextEdit_method_start_action>`\ (\ action\: :ref:`EditAction<enum_TextEdit_EditAction>`\ ) |
  427. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  428. | |void| | :ref:`swap_lines<class_TextEdit_method_swap_lines>`\ (\ from_line\: :ref:`int<class_int>`, to_line\: :ref:`int<class_int>`\ ) |
  429. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  430. | |void| | :ref:`tag_saved_version<class_TextEdit_method_tag_saved_version>`\ (\ ) |
  431. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  432. | |void| | :ref:`undo<class_TextEdit_method_undo>`\ (\ ) |
  433. +--------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  434. .. rst-class:: classref-reftable-group
  435. Theme Properties
  436. ----------------
  437. .. table::
  438. :widths: auto
  439. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  440. | :ref:`Color<class_Color>` | :ref:`background_color<class_TextEdit_theme_color_background_color>` | ``Color(0, 0, 0, 0)`` |
  441. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  442. | :ref:`Color<class_Color>` | :ref:`caret_background_color<class_TextEdit_theme_color_caret_background_color>` | ``Color(0, 0, 0, 1)`` |
  443. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  444. | :ref:`Color<class_Color>` | :ref:`caret_color<class_TextEdit_theme_color_caret_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  445. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  446. | :ref:`Color<class_Color>` | :ref:`current_line_color<class_TextEdit_theme_color_current_line_color>` | ``Color(0.25, 0.25, 0.26, 0.8)`` |
  447. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  448. | :ref:`Color<class_Color>` | :ref:`font_color<class_TextEdit_theme_color_font_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  449. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  450. | :ref:`Color<class_Color>` | :ref:`font_outline_color<class_TextEdit_theme_color_font_outline_color>` | ``Color(0, 0, 0, 1)`` |
  451. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  452. | :ref:`Color<class_Color>` | :ref:`font_placeholder_color<class_TextEdit_theme_color_font_placeholder_color>` | ``Color(0.875, 0.875, 0.875, 0.6)`` |
  453. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  454. | :ref:`Color<class_Color>` | :ref:`font_readonly_color<class_TextEdit_theme_color_font_readonly_color>` | ``Color(0.875, 0.875, 0.875, 0.5)`` |
  455. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  456. | :ref:`Color<class_Color>` | :ref:`font_selected_color<class_TextEdit_theme_color_font_selected_color>` | ``Color(0, 0, 0, 0)`` |
  457. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  458. | :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)`` |
  459. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  460. | :ref:`Color<class_Color>` | :ref:`search_result_color<class_TextEdit_theme_color_search_result_color>` | ``Color(0.3, 0.3, 0.3, 1)`` |
  461. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  462. | :ref:`Color<class_Color>` | :ref:`selection_color<class_TextEdit_theme_color_selection_color>` | ``Color(0.5, 0.5, 0.5, 1)`` |
  463. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  464. | :ref:`Color<class_Color>` | :ref:`word_highlighted_color<class_TextEdit_theme_color_word_highlighted_color>` | ``Color(0.5, 0.5, 0.5, 0.25)`` |
  465. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  466. | :ref:`int<class_int>` | :ref:`caret_width<class_TextEdit_theme_constant_caret_width>` | ``1`` |
  467. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  468. | :ref:`int<class_int>` | :ref:`line_spacing<class_TextEdit_theme_constant_line_spacing>` | ``4`` |
  469. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  470. | :ref:`int<class_int>` | :ref:`outline_size<class_TextEdit_theme_constant_outline_size>` | ``0`` |
  471. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  472. | :ref:`Font<class_Font>` | :ref:`font<class_TextEdit_theme_font_font>` | |
  473. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  474. | :ref:`int<class_int>` | :ref:`font_size<class_TextEdit_theme_font_size_font_size>` | |
  475. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  476. | :ref:`Texture2D<class_Texture2D>` | :ref:`space<class_TextEdit_theme_icon_space>` | |
  477. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  478. | :ref:`Texture2D<class_Texture2D>` | :ref:`tab<class_TextEdit_theme_icon_tab>` | |
  479. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  480. | :ref:`StyleBox<class_StyleBox>` | :ref:`focus<class_TextEdit_theme_style_focus>` | |
  481. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  482. | :ref:`StyleBox<class_StyleBox>` | :ref:`normal<class_TextEdit_theme_style_normal>` | |
  483. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  484. | :ref:`StyleBox<class_StyleBox>` | :ref:`read_only<class_TextEdit_theme_style_read_only>` | |
  485. +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
  486. .. rst-class:: classref-section-separator
  487. ----
  488. .. rst-class:: classref-descriptions-group
  489. Signals
  490. -------
  491. .. _class_TextEdit_signal_caret_changed:
  492. .. rst-class:: classref-signal
  493. **caret_changed**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_signal_caret_changed>`
  494. Emitted when any caret changes position.
  495. .. rst-class:: classref-item-separator
  496. ----
  497. .. _class_TextEdit_signal_gutter_added:
  498. .. rst-class:: classref-signal
  499. **gutter_added**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_signal_gutter_added>`
  500. Emitted when a gutter is added.
  501. .. rst-class:: classref-item-separator
  502. ----
  503. .. _class_TextEdit_signal_gutter_clicked:
  504. .. rst-class:: classref-signal
  505. **gutter_clicked**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_signal_gutter_clicked>`
  506. Emitted when a gutter is clicked.
  507. .. rst-class:: classref-item-separator
  508. ----
  509. .. _class_TextEdit_signal_gutter_removed:
  510. .. rst-class:: classref-signal
  511. **gutter_removed**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_signal_gutter_removed>`
  512. Emitted when a gutter is removed.
  513. .. rst-class:: classref-item-separator
  514. ----
  515. .. _class_TextEdit_signal_lines_edited_from:
  516. .. rst-class:: classref-signal
  517. **lines_edited_from**\ (\ from_line\: :ref:`int<class_int>`, to_line\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_signal_lines_edited_from>`
  518. Emitted immediately when the text changes.
  519. When text is added ``from_line`` will be less than ``to_line``. On a remove ``to_line`` will be less than ``from_line``.
  520. .. rst-class:: classref-item-separator
  521. ----
  522. .. _class_TextEdit_signal_text_changed:
  523. .. rst-class:: classref-signal
  524. **text_changed**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_signal_text_changed>`
  525. Emitted when the text changes.
  526. .. rst-class:: classref-item-separator
  527. ----
  528. .. _class_TextEdit_signal_text_set:
  529. .. rst-class:: classref-signal
  530. **text_set**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_signal_text_set>`
  531. Emitted when :ref:`clear<class_TextEdit_method_clear>` is called or :ref:`text<class_TextEdit_property_text>` is set.
  532. .. rst-class:: classref-section-separator
  533. ----
  534. .. rst-class:: classref-descriptions-group
  535. Enumerations
  536. ------------
  537. .. _enum_TextEdit_MenuItems:
  538. .. rst-class:: classref-enumeration
  539. enum **MenuItems**: :ref:`๐Ÿ”—<enum_TextEdit_MenuItems>`
  540. .. _class_TextEdit_constant_MENU_CUT:
  541. .. rst-class:: classref-enumeration-constant
  542. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_CUT** = ``0``
  543. Cuts (copies and clears) the selected text.
  544. .. _class_TextEdit_constant_MENU_COPY:
  545. .. rst-class:: classref-enumeration-constant
  546. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_COPY** = ``1``
  547. Copies the selected text.
  548. .. _class_TextEdit_constant_MENU_PASTE:
  549. .. rst-class:: classref-enumeration-constant
  550. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_PASTE** = ``2``
  551. Pastes the clipboard text over the selected text (or at the cursor's position).
  552. .. _class_TextEdit_constant_MENU_CLEAR:
  553. .. rst-class:: classref-enumeration-constant
  554. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_CLEAR** = ``3``
  555. Erases the whole **TextEdit** text.
  556. .. _class_TextEdit_constant_MENU_SELECT_ALL:
  557. .. rst-class:: classref-enumeration-constant
  558. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_SELECT_ALL** = ``4``
  559. Selects the whole **TextEdit** text.
  560. .. _class_TextEdit_constant_MENU_UNDO:
  561. .. rst-class:: classref-enumeration-constant
  562. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_UNDO** = ``5``
  563. Undoes the previous action.
  564. .. _class_TextEdit_constant_MENU_REDO:
  565. .. rst-class:: classref-enumeration-constant
  566. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_REDO** = ``6``
  567. Redoes the previous action.
  568. .. _class_TextEdit_constant_MENU_SUBMENU_TEXT_DIR:
  569. .. rst-class:: classref-enumeration-constant
  570. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_SUBMENU_TEXT_DIR** = ``7``
  571. ID of "Text Writing Direction" submenu.
  572. .. _class_TextEdit_constant_MENU_DIR_INHERITED:
  573. .. rst-class:: classref-enumeration-constant
  574. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DIR_INHERITED** = ``8``
  575. Sets text direction to inherited.
  576. .. _class_TextEdit_constant_MENU_DIR_AUTO:
  577. .. rst-class:: classref-enumeration-constant
  578. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DIR_AUTO** = ``9``
  579. Sets text direction to automatic.
  580. .. _class_TextEdit_constant_MENU_DIR_LTR:
  581. .. rst-class:: classref-enumeration-constant
  582. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DIR_LTR** = ``10``
  583. Sets text direction to left-to-right.
  584. .. _class_TextEdit_constant_MENU_DIR_RTL:
  585. .. rst-class:: classref-enumeration-constant
  586. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DIR_RTL** = ``11``
  587. Sets text direction to right-to-left.
  588. .. _class_TextEdit_constant_MENU_DISPLAY_UCC:
  589. .. rst-class:: classref-enumeration-constant
  590. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_DISPLAY_UCC** = ``12``
  591. Toggles control character display.
  592. .. _class_TextEdit_constant_MENU_SUBMENU_INSERT_UCC:
  593. .. rst-class:: classref-enumeration-constant
  594. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_SUBMENU_INSERT_UCC** = ``13``
  595. ID of "Insert Control Character" submenu.
  596. .. _class_TextEdit_constant_MENU_INSERT_LRM:
  597. .. rst-class:: classref-enumeration-constant
  598. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_LRM** = ``14``
  599. Inserts left-to-right mark (LRM) character.
  600. .. _class_TextEdit_constant_MENU_INSERT_RLM:
  601. .. rst-class:: classref-enumeration-constant
  602. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_RLM** = ``15``
  603. Inserts right-to-left mark (RLM) character.
  604. .. _class_TextEdit_constant_MENU_INSERT_LRE:
  605. .. rst-class:: classref-enumeration-constant
  606. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_LRE** = ``16``
  607. Inserts start of left-to-right embedding (LRE) character.
  608. .. _class_TextEdit_constant_MENU_INSERT_RLE:
  609. .. rst-class:: classref-enumeration-constant
  610. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_RLE** = ``17``
  611. Inserts start of right-to-left embedding (RLE) character.
  612. .. _class_TextEdit_constant_MENU_INSERT_LRO:
  613. .. rst-class:: classref-enumeration-constant
  614. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_LRO** = ``18``
  615. Inserts start of left-to-right override (LRO) character.
  616. .. _class_TextEdit_constant_MENU_INSERT_RLO:
  617. .. rst-class:: classref-enumeration-constant
  618. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_RLO** = ``19``
  619. Inserts start of right-to-left override (RLO) character.
  620. .. _class_TextEdit_constant_MENU_INSERT_PDF:
  621. .. rst-class:: classref-enumeration-constant
  622. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_PDF** = ``20``
  623. Inserts pop direction formatting (PDF) character.
  624. .. _class_TextEdit_constant_MENU_INSERT_ALM:
  625. .. rst-class:: classref-enumeration-constant
  626. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_ALM** = ``21``
  627. Inserts Arabic letter mark (ALM) character.
  628. .. _class_TextEdit_constant_MENU_INSERT_LRI:
  629. .. rst-class:: classref-enumeration-constant
  630. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_LRI** = ``22``
  631. Inserts left-to-right isolate (LRI) character.
  632. .. _class_TextEdit_constant_MENU_INSERT_RLI:
  633. .. rst-class:: classref-enumeration-constant
  634. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_RLI** = ``23``
  635. Inserts right-to-left isolate (RLI) character.
  636. .. _class_TextEdit_constant_MENU_INSERT_FSI:
  637. .. rst-class:: classref-enumeration-constant
  638. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_FSI** = ``24``
  639. Inserts first strong isolate (FSI) character.
  640. .. _class_TextEdit_constant_MENU_INSERT_PDI:
  641. .. rst-class:: classref-enumeration-constant
  642. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_PDI** = ``25``
  643. Inserts pop direction isolate (PDI) character.
  644. .. _class_TextEdit_constant_MENU_INSERT_ZWJ:
  645. .. rst-class:: classref-enumeration-constant
  646. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_ZWJ** = ``26``
  647. Inserts zero width joiner (ZWJ) character.
  648. .. _class_TextEdit_constant_MENU_INSERT_ZWNJ:
  649. .. rst-class:: classref-enumeration-constant
  650. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_ZWNJ** = ``27``
  651. Inserts zero width non-joiner (ZWNJ) character.
  652. .. _class_TextEdit_constant_MENU_INSERT_WJ:
  653. .. rst-class:: classref-enumeration-constant
  654. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_WJ** = ``28``
  655. Inserts word joiner (WJ) character.
  656. .. _class_TextEdit_constant_MENU_INSERT_SHY:
  657. .. rst-class:: classref-enumeration-constant
  658. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_INSERT_SHY** = ``29``
  659. Inserts soft hyphen (SHY) character.
  660. .. _class_TextEdit_constant_MENU_MAX:
  661. .. rst-class:: classref-enumeration-constant
  662. :ref:`MenuItems<enum_TextEdit_MenuItems>` **MENU_MAX** = ``30``
  663. Represents the size of the :ref:`MenuItems<enum_TextEdit_MenuItems>` enum.
  664. .. rst-class:: classref-item-separator
  665. ----
  666. .. _enum_TextEdit_EditAction:
  667. .. rst-class:: classref-enumeration
  668. enum **EditAction**: :ref:`๐Ÿ”—<enum_TextEdit_EditAction>`
  669. .. _class_TextEdit_constant_ACTION_NONE:
  670. .. rst-class:: classref-enumeration-constant
  671. :ref:`EditAction<enum_TextEdit_EditAction>` **ACTION_NONE** = ``0``
  672. No current action.
  673. .. _class_TextEdit_constant_ACTION_TYPING:
  674. .. rst-class:: classref-enumeration-constant
  675. :ref:`EditAction<enum_TextEdit_EditAction>` **ACTION_TYPING** = ``1``
  676. A typing action.
  677. .. _class_TextEdit_constant_ACTION_BACKSPACE:
  678. .. rst-class:: classref-enumeration-constant
  679. :ref:`EditAction<enum_TextEdit_EditAction>` **ACTION_BACKSPACE** = ``2``
  680. A backwards delete action.
  681. .. _class_TextEdit_constant_ACTION_DELETE:
  682. .. rst-class:: classref-enumeration-constant
  683. :ref:`EditAction<enum_TextEdit_EditAction>` **ACTION_DELETE** = ``3``
  684. A forward delete action.
  685. .. rst-class:: classref-item-separator
  686. ----
  687. .. _enum_TextEdit_SearchFlags:
  688. .. rst-class:: classref-enumeration
  689. enum **SearchFlags**: :ref:`๐Ÿ”—<enum_TextEdit_SearchFlags>`
  690. .. _class_TextEdit_constant_SEARCH_MATCH_CASE:
  691. .. rst-class:: classref-enumeration-constant
  692. :ref:`SearchFlags<enum_TextEdit_SearchFlags>` **SEARCH_MATCH_CASE** = ``1``
  693. Match case when searching.
  694. .. _class_TextEdit_constant_SEARCH_WHOLE_WORDS:
  695. .. rst-class:: classref-enumeration-constant
  696. :ref:`SearchFlags<enum_TextEdit_SearchFlags>` **SEARCH_WHOLE_WORDS** = ``2``
  697. Match whole words when searching.
  698. .. _class_TextEdit_constant_SEARCH_BACKWARDS:
  699. .. rst-class:: classref-enumeration-constant
  700. :ref:`SearchFlags<enum_TextEdit_SearchFlags>` **SEARCH_BACKWARDS** = ``4``
  701. Search from end to beginning.
  702. .. rst-class:: classref-item-separator
  703. ----
  704. .. _enum_TextEdit_CaretType:
  705. .. rst-class:: classref-enumeration
  706. enum **CaretType**: :ref:`๐Ÿ”—<enum_TextEdit_CaretType>`
  707. .. _class_TextEdit_constant_CARET_TYPE_LINE:
  708. .. rst-class:: classref-enumeration-constant
  709. :ref:`CaretType<enum_TextEdit_CaretType>` **CARET_TYPE_LINE** = ``0``
  710. Vertical line caret.
  711. .. _class_TextEdit_constant_CARET_TYPE_BLOCK:
  712. .. rst-class:: classref-enumeration-constant
  713. :ref:`CaretType<enum_TextEdit_CaretType>` **CARET_TYPE_BLOCK** = ``1``
  714. Block caret.
  715. .. rst-class:: classref-item-separator
  716. ----
  717. .. _enum_TextEdit_SelectionMode:
  718. .. rst-class:: classref-enumeration
  719. enum **SelectionMode**: :ref:`๐Ÿ”—<enum_TextEdit_SelectionMode>`
  720. .. _class_TextEdit_constant_SELECTION_MODE_NONE:
  721. .. rst-class:: classref-enumeration-constant
  722. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_NONE** = ``0``
  723. Not selecting.
  724. .. _class_TextEdit_constant_SELECTION_MODE_SHIFT:
  725. .. rst-class:: classref-enumeration-constant
  726. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_SHIFT** = ``1``
  727. Select as if ``shift`` is pressed.
  728. .. _class_TextEdit_constant_SELECTION_MODE_POINTER:
  729. .. rst-class:: classref-enumeration-constant
  730. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_POINTER** = ``2``
  731. Select single characters as if the user single clicked.
  732. .. _class_TextEdit_constant_SELECTION_MODE_WORD:
  733. .. rst-class:: classref-enumeration-constant
  734. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_WORD** = ``3``
  735. Select whole words as if the user double clicked.
  736. .. _class_TextEdit_constant_SELECTION_MODE_LINE:
  737. .. rst-class:: classref-enumeration-constant
  738. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **SELECTION_MODE_LINE** = ``4``
  739. Select whole lines as if the user triple clicked.
  740. .. rst-class:: classref-item-separator
  741. ----
  742. .. _enum_TextEdit_LineWrappingMode:
  743. .. rst-class:: classref-enumeration
  744. enum **LineWrappingMode**: :ref:`๐Ÿ”—<enum_TextEdit_LineWrappingMode>`
  745. .. _class_TextEdit_constant_LINE_WRAPPING_NONE:
  746. .. rst-class:: classref-enumeration-constant
  747. :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` **LINE_WRAPPING_NONE** = ``0``
  748. Line wrapping is disabled.
  749. .. _class_TextEdit_constant_LINE_WRAPPING_BOUNDARY:
  750. .. rst-class:: classref-enumeration-constant
  751. :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` **LINE_WRAPPING_BOUNDARY** = ``1``
  752. Line wrapping occurs at the control boundary, beyond what would normally be visible.
  753. .. rst-class:: classref-item-separator
  754. ----
  755. .. _enum_TextEdit_GutterType:
  756. .. rst-class:: classref-enumeration
  757. enum **GutterType**: :ref:`๐Ÿ”—<enum_TextEdit_GutterType>`
  758. .. _class_TextEdit_constant_GUTTER_TYPE_STRING:
  759. .. rst-class:: classref-enumeration-constant
  760. :ref:`GutterType<enum_TextEdit_GutterType>` **GUTTER_TYPE_STRING** = ``0``
  761. 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.
  762. .. _class_TextEdit_constant_GUTTER_TYPE_ICON:
  763. .. rst-class:: classref-enumeration-constant
  764. :ref:`GutterType<enum_TextEdit_GutterType>` **GUTTER_TYPE_ICON** = ``1``
  765. 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.
  766. .. _class_TextEdit_constant_GUTTER_TYPE_CUSTOM:
  767. .. rst-class:: classref-enumeration-constant
  768. :ref:`GutterType<enum_TextEdit_GutterType>` **GUTTER_TYPE_CUSTOM** = ``2``
  769. 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.
  770. .. rst-class:: classref-section-separator
  771. ----
  772. .. rst-class:: classref-descriptions-group
  773. Property Descriptions
  774. ---------------------
  775. .. _class_TextEdit_property_autowrap_mode:
  776. .. rst-class:: classref-property
  777. :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` **autowrap_mode** = ``3`` :ref:`๐Ÿ”—<class_TextEdit_property_autowrap_mode>`
  778. .. rst-class:: classref-property-setget
  779. - |void| **set_autowrap_mode**\ (\ value\: :ref:`AutowrapMode<enum_TextServer_AutowrapMode>`\ )
  780. - :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` **get_autowrap_mode**\ (\ )
  781. 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>`.
  782. .. rst-class:: classref-item-separator
  783. ----
  784. .. _class_TextEdit_property_caret_blink:
  785. .. rst-class:: classref-property
  786. :ref:`bool<class_bool>` **caret_blink** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_caret_blink>`
  787. .. rst-class:: classref-property-setget
  788. - |void| **set_caret_blink_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  789. - :ref:`bool<class_bool>` **is_caret_blink_enabled**\ (\ )
  790. If ``true``, makes the caret blink.
  791. .. rst-class:: classref-item-separator
  792. ----
  793. .. _class_TextEdit_property_caret_blink_interval:
  794. .. rst-class:: classref-property
  795. :ref:`float<class_float>` **caret_blink_interval** = ``0.65`` :ref:`๐Ÿ”—<class_TextEdit_property_caret_blink_interval>`
  796. .. rst-class:: classref-property-setget
  797. - |void| **set_caret_blink_interval**\ (\ value\: :ref:`float<class_float>`\ )
  798. - :ref:`float<class_float>` **get_caret_blink_interval**\ (\ )
  799. The interval at which the caret blinks (in seconds).
  800. .. rst-class:: classref-item-separator
  801. ----
  802. .. _class_TextEdit_property_caret_draw_when_editable_disabled:
  803. .. rst-class:: classref-property
  804. :ref:`bool<class_bool>` **caret_draw_when_editable_disabled** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_caret_draw_when_editable_disabled>`
  805. .. rst-class:: classref-property-setget
  806. - |void| **set_draw_caret_when_editable_disabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  807. - :ref:`bool<class_bool>` **is_drawing_caret_when_editable_disabled**\ (\ )
  808. If ``true``, caret will be visible when :ref:`editable<class_TextEdit_property_editable>` is disabled.
  809. .. rst-class:: classref-item-separator
  810. ----
  811. .. _class_TextEdit_property_caret_mid_grapheme:
  812. .. rst-class:: classref-property
  813. :ref:`bool<class_bool>` **caret_mid_grapheme** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_caret_mid_grapheme>`
  814. .. rst-class:: classref-property-setget
  815. - |void| **set_caret_mid_grapheme_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  816. - :ref:`bool<class_bool>` **is_caret_mid_grapheme_enabled**\ (\ )
  817. Allow moving caret, selecting and removing the individual composite character components.
  818. \ **Note:** :kbd:`Backspace` is always removing individual composite character components.
  819. .. rst-class:: classref-item-separator
  820. ----
  821. .. _class_TextEdit_property_caret_move_on_right_click:
  822. .. rst-class:: classref-property
  823. :ref:`bool<class_bool>` **caret_move_on_right_click** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_caret_move_on_right_click>`
  824. .. rst-class:: classref-property-setget
  825. - |void| **set_move_caret_on_right_click_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  826. - :ref:`bool<class_bool>` **is_move_caret_on_right_click_enabled**\ (\ )
  827. If ``true``, a right-click moves the caret at the mouse position before displaying the context menu.
  828. If ``false``, the context menu ignores mouse location.
  829. .. rst-class:: classref-item-separator
  830. ----
  831. .. _class_TextEdit_property_caret_multiple:
  832. .. rst-class:: classref-property
  833. :ref:`bool<class_bool>` **caret_multiple** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_caret_multiple>`
  834. .. rst-class:: classref-property-setget
  835. - |void| **set_multiple_carets_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  836. - :ref:`bool<class_bool>` **is_multiple_carets_enabled**\ (\ )
  837. Sets if multiple carets are allowed.
  838. .. rst-class:: classref-item-separator
  839. ----
  840. .. _class_TextEdit_property_caret_type:
  841. .. rst-class:: classref-property
  842. :ref:`CaretType<enum_TextEdit_CaretType>` **caret_type** = ``0`` :ref:`๐Ÿ”—<class_TextEdit_property_caret_type>`
  843. .. rst-class:: classref-property-setget
  844. - |void| **set_caret_type**\ (\ value\: :ref:`CaretType<enum_TextEdit_CaretType>`\ )
  845. - :ref:`CaretType<enum_TextEdit_CaretType>` **get_caret_type**\ (\ )
  846. Set the type of caret to draw.
  847. .. rst-class:: classref-item-separator
  848. ----
  849. .. _class_TextEdit_property_context_menu_enabled:
  850. .. rst-class:: classref-property
  851. :ref:`bool<class_bool>` **context_menu_enabled** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_context_menu_enabled>`
  852. .. rst-class:: classref-property-setget
  853. - |void| **set_context_menu_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  854. - :ref:`bool<class_bool>` **is_context_menu_enabled**\ (\ )
  855. If ``true``, a right-click displays the context menu.
  856. .. rst-class:: classref-item-separator
  857. ----
  858. .. _class_TextEdit_property_custom_word_separators:
  859. .. rst-class:: classref-property
  860. :ref:`String<class_String>` **custom_word_separators** = ``""`` :ref:`๐Ÿ”—<class_TextEdit_property_custom_word_separators>`
  861. .. rst-class:: classref-property-setget
  862. - |void| **set_custom_word_separators**\ (\ value\: :ref:`String<class_String>`\ )
  863. - :ref:`String<class_String>` **get_custom_word_separators**\ (\ )
  864. The characters to consider as word delimiters if :ref:`use_custom_word_separators<class_TextEdit_property_use_custom_word_separators>` is ``true``. The characters should be defined without separation, for example ``#_!``.
  865. .. rst-class:: classref-item-separator
  866. ----
  867. .. _class_TextEdit_property_deselect_on_focus_loss_enabled:
  868. .. rst-class:: classref-property
  869. :ref:`bool<class_bool>` **deselect_on_focus_loss_enabled** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_deselect_on_focus_loss_enabled>`
  870. .. rst-class:: classref-property-setget
  871. - |void| **set_deselect_on_focus_loss_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  872. - :ref:`bool<class_bool>` **is_deselect_on_focus_loss_enabled**\ (\ )
  873. If ``true``, the selected text will be deselected when focus is lost.
  874. .. rst-class:: classref-item-separator
  875. ----
  876. .. _class_TextEdit_property_drag_and_drop_selection_enabled:
  877. .. rst-class:: classref-property
  878. :ref:`bool<class_bool>` **drag_and_drop_selection_enabled** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_drag_and_drop_selection_enabled>`
  879. .. rst-class:: classref-property-setget
  880. - |void| **set_drag_and_drop_selection_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  881. - :ref:`bool<class_bool>` **is_drag_and_drop_selection_enabled**\ (\ )
  882. If ``true``, allow drag and drop of selected text. Text can still be dropped from other sources.
  883. .. rst-class:: classref-item-separator
  884. ----
  885. .. _class_TextEdit_property_draw_control_chars:
  886. .. rst-class:: classref-property
  887. :ref:`bool<class_bool>` **draw_control_chars** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_draw_control_chars>`
  888. .. rst-class:: classref-property-setget
  889. - |void| **set_draw_control_chars**\ (\ value\: :ref:`bool<class_bool>`\ )
  890. - :ref:`bool<class_bool>` **get_draw_control_chars**\ (\ )
  891. If ``true``, control characters are displayed.
  892. .. rst-class:: classref-item-separator
  893. ----
  894. .. _class_TextEdit_property_draw_spaces:
  895. .. rst-class:: classref-property
  896. :ref:`bool<class_bool>` **draw_spaces** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_draw_spaces>`
  897. .. rst-class:: classref-property-setget
  898. - |void| **set_draw_spaces**\ (\ value\: :ref:`bool<class_bool>`\ )
  899. - :ref:`bool<class_bool>` **is_drawing_spaces**\ (\ )
  900. If ``true``, the "space" character will have a visible representation.
  901. .. rst-class:: classref-item-separator
  902. ----
  903. .. _class_TextEdit_property_draw_tabs:
  904. .. rst-class:: classref-property
  905. :ref:`bool<class_bool>` **draw_tabs** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_draw_tabs>`
  906. .. rst-class:: classref-property-setget
  907. - |void| **set_draw_tabs**\ (\ value\: :ref:`bool<class_bool>`\ )
  908. - :ref:`bool<class_bool>` **is_drawing_tabs**\ (\ )
  909. If ``true``, the "tab" character will have a visible representation.
  910. .. rst-class:: classref-item-separator
  911. ----
  912. .. _class_TextEdit_property_editable:
  913. .. rst-class:: classref-property
  914. :ref:`bool<class_bool>` **editable** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_editable>`
  915. .. rst-class:: classref-property-setget
  916. - |void| **set_editable**\ (\ value\: :ref:`bool<class_bool>`\ )
  917. - :ref:`bool<class_bool>` **is_editable**\ (\ )
  918. If ``false``, existing text cannot be modified and new text cannot be added.
  919. .. rst-class:: classref-item-separator
  920. ----
  921. .. _class_TextEdit_property_highlight_all_occurrences:
  922. .. rst-class:: classref-property
  923. :ref:`bool<class_bool>` **highlight_all_occurrences** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_highlight_all_occurrences>`
  924. .. rst-class:: classref-property-setget
  925. - |void| **set_highlight_all_occurrences**\ (\ value\: :ref:`bool<class_bool>`\ )
  926. - :ref:`bool<class_bool>` **is_highlight_all_occurrences_enabled**\ (\ )
  927. If ``true``, all occurrences of the selected text will be highlighted.
  928. .. rst-class:: classref-item-separator
  929. ----
  930. .. _class_TextEdit_property_highlight_current_line:
  931. .. rst-class:: classref-property
  932. :ref:`bool<class_bool>` **highlight_current_line** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_highlight_current_line>`
  933. .. rst-class:: classref-property-setget
  934. - |void| **set_highlight_current_line**\ (\ value\: :ref:`bool<class_bool>`\ )
  935. - :ref:`bool<class_bool>` **is_highlight_current_line_enabled**\ (\ )
  936. If ``true``, the line containing the cursor is highlighted.
  937. .. rst-class:: classref-item-separator
  938. ----
  939. .. _class_TextEdit_property_indent_wrapped_lines:
  940. .. rst-class:: classref-property
  941. :ref:`bool<class_bool>` **indent_wrapped_lines** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_indent_wrapped_lines>`
  942. .. rst-class:: classref-property-setget
  943. - |void| **set_indent_wrapped_lines**\ (\ value\: :ref:`bool<class_bool>`\ )
  944. - :ref:`bool<class_bool>` **is_indent_wrapped_lines**\ (\ )
  945. If ``true``, all wrapped lines are indented to the same amount as the unwrapped line.
  946. .. rst-class:: classref-item-separator
  947. ----
  948. .. _class_TextEdit_property_language:
  949. .. rst-class:: classref-property
  950. :ref:`String<class_String>` **language** = ``""`` :ref:`๐Ÿ”—<class_TextEdit_property_language>`
  951. .. rst-class:: classref-property-setget
  952. - |void| **set_language**\ (\ value\: :ref:`String<class_String>`\ )
  953. - :ref:`String<class_String>` **get_language**\ (\ )
  954. Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
  955. .. rst-class:: classref-item-separator
  956. ----
  957. .. _class_TextEdit_property_middle_mouse_paste_enabled:
  958. .. rst-class:: classref-property
  959. :ref:`bool<class_bool>` **middle_mouse_paste_enabled** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_middle_mouse_paste_enabled>`
  960. .. rst-class:: classref-property-setget
  961. - |void| **set_middle_mouse_paste_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  962. - :ref:`bool<class_bool>` **is_middle_mouse_paste_enabled**\ (\ )
  963. If ``false``, using middle mouse button to paste clipboard will be disabled.
  964. \ **Note:** This method is only implemented on Linux.
  965. .. rst-class:: classref-item-separator
  966. ----
  967. .. _class_TextEdit_property_minimap_draw:
  968. .. rst-class:: classref-property
  969. :ref:`bool<class_bool>` **minimap_draw** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_minimap_draw>`
  970. .. rst-class:: classref-property-setget
  971. - |void| **set_draw_minimap**\ (\ value\: :ref:`bool<class_bool>`\ )
  972. - :ref:`bool<class_bool>` **is_drawing_minimap**\ (\ )
  973. If ``true``, a minimap is shown, providing an outline of your source code. The minimap uses a fixed-width text size.
  974. .. rst-class:: classref-item-separator
  975. ----
  976. .. _class_TextEdit_property_minimap_width:
  977. .. rst-class:: classref-property
  978. :ref:`int<class_int>` **minimap_width** = ``80`` :ref:`๐Ÿ”—<class_TextEdit_property_minimap_width>`
  979. .. rst-class:: classref-property-setget
  980. - |void| **set_minimap_width**\ (\ value\: :ref:`int<class_int>`\ )
  981. - :ref:`int<class_int>` **get_minimap_width**\ (\ )
  982. The width, in pixels, of the minimap.
  983. .. rst-class:: classref-item-separator
  984. ----
  985. .. _class_TextEdit_property_placeholder_text:
  986. .. rst-class:: classref-property
  987. :ref:`String<class_String>` **placeholder_text** = ``""`` :ref:`๐Ÿ”—<class_TextEdit_property_placeholder_text>`
  988. .. rst-class:: classref-property-setget
  989. - |void| **set_placeholder**\ (\ value\: :ref:`String<class_String>`\ )
  990. - :ref:`String<class_String>` **get_placeholder**\ (\ )
  991. Text shown when the **TextEdit** is empty. It is **not** the **TextEdit**'s default value (see :ref:`text<class_TextEdit_property_text>`).
  992. .. rst-class:: classref-item-separator
  993. ----
  994. .. _class_TextEdit_property_scroll_fit_content_height:
  995. .. rst-class:: classref-property
  996. :ref:`bool<class_bool>` **scroll_fit_content_height** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_scroll_fit_content_height>`
  997. .. rst-class:: classref-property-setget
  998. - |void| **set_fit_content_height_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  999. - :ref:`bool<class_bool>` **is_fit_content_height_enabled**\ (\ )
  1000. If ``true``, **TextEdit** will disable vertical scroll and fit minimum height to the number of visible lines.
  1001. .. rst-class:: classref-item-separator
  1002. ----
  1003. .. _class_TextEdit_property_scroll_horizontal:
  1004. .. rst-class:: classref-property
  1005. :ref:`int<class_int>` **scroll_horizontal** = ``0`` :ref:`๐Ÿ”—<class_TextEdit_property_scroll_horizontal>`
  1006. .. rst-class:: classref-property-setget
  1007. - |void| **set_h_scroll**\ (\ value\: :ref:`int<class_int>`\ )
  1008. - :ref:`int<class_int>` **get_h_scroll**\ (\ )
  1009. If there is a horizontal scrollbar, this determines the current horizontal scroll value in pixels.
  1010. .. rst-class:: classref-item-separator
  1011. ----
  1012. .. _class_TextEdit_property_scroll_past_end_of_file:
  1013. .. rst-class:: classref-property
  1014. :ref:`bool<class_bool>` **scroll_past_end_of_file** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_scroll_past_end_of_file>`
  1015. .. rst-class:: classref-property-setget
  1016. - |void| **set_scroll_past_end_of_file_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  1017. - :ref:`bool<class_bool>` **is_scroll_past_end_of_file_enabled**\ (\ )
  1018. Allow scrolling past the last line into "virtual" space.
  1019. .. rst-class:: classref-item-separator
  1020. ----
  1021. .. _class_TextEdit_property_scroll_smooth:
  1022. .. rst-class:: classref-property
  1023. :ref:`bool<class_bool>` **scroll_smooth** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_scroll_smooth>`
  1024. .. rst-class:: classref-property-setget
  1025. - |void| **set_smooth_scroll_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  1026. - :ref:`bool<class_bool>` **is_smooth_scroll_enabled**\ (\ )
  1027. Scroll smoothly over the text rather than jumping to the next location.
  1028. .. rst-class:: classref-item-separator
  1029. ----
  1030. .. _class_TextEdit_property_scroll_v_scroll_speed:
  1031. .. rst-class:: classref-property
  1032. :ref:`float<class_float>` **scroll_v_scroll_speed** = ``80.0`` :ref:`๐Ÿ”—<class_TextEdit_property_scroll_v_scroll_speed>`
  1033. .. rst-class:: classref-property-setget
  1034. - |void| **set_v_scroll_speed**\ (\ value\: :ref:`float<class_float>`\ )
  1035. - :ref:`float<class_float>` **get_v_scroll_speed**\ (\ )
  1036. Sets the scroll speed with the minimap or when :ref:`scroll_smooth<class_TextEdit_property_scroll_smooth>` is enabled.
  1037. .. rst-class:: classref-item-separator
  1038. ----
  1039. .. _class_TextEdit_property_scroll_vertical:
  1040. .. rst-class:: classref-property
  1041. :ref:`float<class_float>` **scroll_vertical** = ``0.0`` :ref:`๐Ÿ”—<class_TextEdit_property_scroll_vertical>`
  1042. .. rst-class:: classref-property-setget
  1043. - |void| **set_v_scroll**\ (\ value\: :ref:`float<class_float>`\ )
  1044. - :ref:`float<class_float>` **get_v_scroll**\ (\ )
  1045. If there is a vertical scrollbar, this determines the current vertical scroll value in line numbers, starting at 0 for the top line.
  1046. .. rst-class:: classref-item-separator
  1047. ----
  1048. .. _class_TextEdit_property_selecting_enabled:
  1049. .. rst-class:: classref-property
  1050. :ref:`bool<class_bool>` **selecting_enabled** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_selecting_enabled>`
  1051. .. rst-class:: classref-property-setget
  1052. - |void| **set_selecting_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  1053. - :ref:`bool<class_bool>` **is_selecting_enabled**\ (\ )
  1054. If ``true``, text can be selected.
  1055. 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.
  1056. .. rst-class:: classref-item-separator
  1057. ----
  1058. .. _class_TextEdit_property_shortcut_keys_enabled:
  1059. .. rst-class:: classref-property
  1060. :ref:`bool<class_bool>` **shortcut_keys_enabled** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_shortcut_keys_enabled>`
  1061. .. rst-class:: classref-property-setget
  1062. - |void| **set_shortcut_keys_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  1063. - :ref:`bool<class_bool>` **is_shortcut_keys_enabled**\ (\ )
  1064. If ``true``, shortcut keys for context menu items are enabled, even if the context menu is disabled.
  1065. .. rst-class:: classref-item-separator
  1066. ----
  1067. .. _class_TextEdit_property_structured_text_bidi_override:
  1068. .. rst-class:: classref-property
  1069. :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **structured_text_bidi_override** = ``0`` :ref:`๐Ÿ”—<class_TextEdit_property_structured_text_bidi_override>`
  1070. .. rst-class:: classref-property-setget
  1071. - |void| **set_structured_text_bidi_override**\ (\ value\: :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>`\ )
  1072. - :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **get_structured_text_bidi_override**\ (\ )
  1073. Set BiDi algorithm override for the structured text.
  1074. .. rst-class:: classref-item-separator
  1075. ----
  1076. .. _class_TextEdit_property_structured_text_bidi_override_options:
  1077. .. rst-class:: classref-property
  1078. :ref:`Array<class_Array>` **structured_text_bidi_override_options** = ``[]`` :ref:`๐Ÿ”—<class_TextEdit_property_structured_text_bidi_override_options>`
  1079. .. rst-class:: classref-property-setget
  1080. - |void| **set_structured_text_bidi_override_options**\ (\ value\: :ref:`Array<class_Array>`\ )
  1081. - :ref:`Array<class_Array>` **get_structured_text_bidi_override_options**\ (\ )
  1082. Set additional options for BiDi override.
  1083. .. rst-class:: classref-item-separator
  1084. ----
  1085. .. _class_TextEdit_property_syntax_highlighter:
  1086. .. rst-class:: classref-property
  1087. :ref:`SyntaxHighlighter<class_SyntaxHighlighter>` **syntax_highlighter** :ref:`๐Ÿ”—<class_TextEdit_property_syntax_highlighter>`
  1088. .. rst-class:: classref-property-setget
  1089. - |void| **set_syntax_highlighter**\ (\ value\: :ref:`SyntaxHighlighter<class_SyntaxHighlighter>`\ )
  1090. - :ref:`SyntaxHighlighter<class_SyntaxHighlighter>` **get_syntax_highlighter**\ (\ )
  1091. Sets the :ref:`SyntaxHighlighter<class_SyntaxHighlighter>` to use.
  1092. .. rst-class:: classref-item-separator
  1093. ----
  1094. .. _class_TextEdit_property_text:
  1095. .. rst-class:: classref-property
  1096. :ref:`String<class_String>` **text** = ``""`` :ref:`๐Ÿ”—<class_TextEdit_property_text>`
  1097. .. rst-class:: classref-property-setget
  1098. - |void| **set_text**\ (\ value\: :ref:`String<class_String>`\ )
  1099. - :ref:`String<class_String>` **get_text**\ (\ )
  1100. String value of the **TextEdit**.
  1101. .. rst-class:: classref-item-separator
  1102. ----
  1103. .. _class_TextEdit_property_text_direction:
  1104. .. rst-class:: classref-property
  1105. :ref:`TextDirection<enum_Control_TextDirection>` **text_direction** = ``0`` :ref:`๐Ÿ”—<class_TextEdit_property_text_direction>`
  1106. .. rst-class:: classref-property-setget
  1107. - |void| **set_text_direction**\ (\ value\: :ref:`TextDirection<enum_Control_TextDirection>`\ )
  1108. - :ref:`TextDirection<enum_Control_TextDirection>` **get_text_direction**\ (\ )
  1109. Base text writing direction.
  1110. .. rst-class:: classref-item-separator
  1111. ----
  1112. .. _class_TextEdit_property_use_custom_word_separators:
  1113. .. rst-class:: classref-property
  1114. :ref:`bool<class_bool>` **use_custom_word_separators** = ``false`` :ref:`๐Ÿ”—<class_TextEdit_property_use_custom_word_separators>`
  1115. .. rst-class:: classref-property-setget
  1116. - |void| **set_use_custom_word_separators**\ (\ value\: :ref:`bool<class_bool>`\ )
  1117. - :ref:`bool<class_bool>` **is_custom_word_separators_enabled**\ (\ )
  1118. If ``false``, using :kbd:`Ctrl + Left` or :kbd:`Ctrl + Right` (:kbd:`Cmd + Left` or :kbd:`Cmd + Right` on macOS) bindings will use the behavior of :ref:`use_default_word_separators<class_TextEdit_property_use_default_word_separators>`. If ``true``, it will also stop the caret if a character within :ref:`custom_word_separators<class_TextEdit_property_custom_word_separators>` is detected. Useful for subword moving. This behavior also will be applied to the behavior of text selection.
  1119. .. rst-class:: classref-item-separator
  1120. ----
  1121. .. _class_TextEdit_property_use_default_word_separators:
  1122. .. rst-class:: classref-property
  1123. :ref:`bool<class_bool>` **use_default_word_separators** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_use_default_word_separators>`
  1124. .. rst-class:: classref-property-setget
  1125. - |void| **set_use_default_word_separators**\ (\ value\: :ref:`bool<class_bool>`\ )
  1126. - :ref:`bool<class_bool>` **is_default_word_separators_enabled**\ (\ )
  1127. If ``false``, using :kbd:`Ctrl + Left` or :kbd:`Ctrl + Right` (:kbd:`Cmd + Left` or :kbd:`Cmd + Right` on macOS) bindings will stop moving caret only if a space or punctuation is detected. If ``true``, it will also stop the caret if a character is part of ``!"#$%&'()*+,-./:;<=>?@[\]^`{|}~``, the Unicode General Punctuation table, or the Unicode CJK Punctuation table. Useful for subword moving. This behavior also will be applied to the behavior of text selection.
  1128. .. rst-class:: classref-item-separator
  1129. ----
  1130. .. _class_TextEdit_property_virtual_keyboard_enabled:
  1131. .. rst-class:: classref-property
  1132. :ref:`bool<class_bool>` **virtual_keyboard_enabled** = ``true`` :ref:`๐Ÿ”—<class_TextEdit_property_virtual_keyboard_enabled>`
  1133. .. rst-class:: classref-property-setget
  1134. - |void| **set_virtual_keyboard_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  1135. - :ref:`bool<class_bool>` **is_virtual_keyboard_enabled**\ (\ )
  1136. If ``true``, the native virtual keyboard is shown when focused on platforms that support it.
  1137. .. rst-class:: classref-item-separator
  1138. ----
  1139. .. _class_TextEdit_property_wrap_mode:
  1140. .. rst-class:: classref-property
  1141. :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` **wrap_mode** = ``0`` :ref:`๐Ÿ”—<class_TextEdit_property_wrap_mode>`
  1142. .. rst-class:: classref-property-setget
  1143. - |void| **set_line_wrapping_mode**\ (\ value\: :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>`\ )
  1144. - :ref:`LineWrappingMode<enum_TextEdit_LineWrappingMode>` **get_line_wrapping_mode**\ (\ )
  1145. Sets the line wrapping mode to use.
  1146. .. rst-class:: classref-section-separator
  1147. ----
  1148. .. rst-class:: classref-descriptions-group
  1149. Method Descriptions
  1150. -------------------
  1151. .. _class_TextEdit_private_method__backspace:
  1152. .. rst-class:: classref-method
  1153. |void| **_backspace**\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| :ref:`๐Ÿ”—<class_TextEdit_private_method__backspace>`
  1154. Override this method to define what happens when the user presses the backspace key.
  1155. .. rst-class:: classref-item-separator
  1156. ----
  1157. .. _class_TextEdit_private_method__copy:
  1158. .. rst-class:: classref-method
  1159. |void| **_copy**\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| :ref:`๐Ÿ”—<class_TextEdit_private_method__copy>`
  1160. Override this method to define what happens when the user performs a copy operation.
  1161. .. rst-class:: classref-item-separator
  1162. ----
  1163. .. _class_TextEdit_private_method__cut:
  1164. .. rst-class:: classref-method
  1165. |void| **_cut**\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| :ref:`๐Ÿ”—<class_TextEdit_private_method__cut>`
  1166. Override this method to define what happens when the user performs a cut operation.
  1167. .. rst-class:: classref-item-separator
  1168. ----
  1169. .. _class_TextEdit_private_method__handle_unicode_input:
  1170. .. rst-class:: classref-method
  1171. |void| **_handle_unicode_input**\ (\ unicode_char\: :ref:`int<class_int>`, caret_index\: :ref:`int<class_int>`\ ) |virtual| :ref:`๐Ÿ”—<class_TextEdit_private_method__handle_unicode_input>`
  1172. Override this method to define what happens when the user types in the provided key ``unicode_char``.
  1173. .. rst-class:: classref-item-separator
  1174. ----
  1175. .. _class_TextEdit_private_method__paste:
  1176. .. rst-class:: classref-method
  1177. |void| **_paste**\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| :ref:`๐Ÿ”—<class_TextEdit_private_method__paste>`
  1178. Override this method to define what happens when the user performs a paste operation.
  1179. .. rst-class:: classref-item-separator
  1180. ----
  1181. .. _class_TextEdit_private_method__paste_primary_clipboard:
  1182. .. rst-class:: classref-method
  1183. |void| **_paste_primary_clipboard**\ (\ caret_index\: :ref:`int<class_int>`\ ) |virtual| :ref:`๐Ÿ”—<class_TextEdit_private_method__paste_primary_clipboard>`
  1184. Override this method to define what happens when the user performs a paste operation with middle mouse button.
  1185. \ **Note:** This method is only implemented on Linux.
  1186. .. rst-class:: classref-item-separator
  1187. ----
  1188. .. _class_TextEdit_method_add_caret:
  1189. .. rst-class:: classref-method
  1190. :ref:`int<class_int>` **add_caret**\ (\ line\: :ref:`int<class_int>`, column\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_add_caret>`
  1191. Adds a new caret at the given location. Returns the index of the new caret, or ``-1`` if the location is invalid.
  1192. .. rst-class:: classref-item-separator
  1193. ----
  1194. .. _class_TextEdit_method_add_caret_at_carets:
  1195. .. rst-class:: classref-method
  1196. |void| **add_caret_at_carets**\ (\ below\: :ref:`bool<class_bool>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_add_caret_at_carets>`
  1197. Adds an additional caret above or below every caret. If ``below`` is ``true`` the new caret will be added below and above otherwise.
  1198. .. rst-class:: classref-item-separator
  1199. ----
  1200. .. _class_TextEdit_method_add_gutter:
  1201. .. rst-class:: classref-method
  1202. |void| **add_gutter**\ (\ at\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_add_gutter>`
  1203. 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.
  1204. .. rst-class:: classref-item-separator
  1205. ----
  1206. .. _class_TextEdit_method_add_selection_for_next_occurrence:
  1207. .. rst-class:: classref-method
  1208. |void| **add_selection_for_next_occurrence**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_add_selection_for_next_occurrence>`
  1209. Adds a selection and a caret for the next occurrence of the current selection. If there is no active selection, selects word under caret.
  1210. .. rst-class:: classref-item-separator
  1211. ----
  1212. .. _class_TextEdit_method_adjust_carets_after_edit:
  1213. .. rst-class:: classref-method
  1214. |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>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_adjust_carets_after_edit>`
  1215. **Deprecated:** No longer necessary since methods now adjust carets themselves.
  1216. This method does nothing.
  1217. .. rst-class:: classref-item-separator
  1218. ----
  1219. .. _class_TextEdit_method_adjust_viewport_to_caret:
  1220. .. rst-class:: classref-method
  1221. |void| **adjust_viewport_to_caret**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) :ref:`๐Ÿ”—<class_TextEdit_method_adjust_viewport_to_caret>`
  1222. Adjust the viewport so the caret is visible.
  1223. .. rst-class:: classref-item-separator
  1224. ----
  1225. .. _class_TextEdit_method_apply_ime:
  1226. .. rst-class:: classref-method
  1227. |void| **apply_ime**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_apply_ime>`
  1228. 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.
  1229. .. rst-class:: classref-item-separator
  1230. ----
  1231. .. _class_TextEdit_method_backspace:
  1232. .. rst-class:: classref-method
  1233. |void| **backspace**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_backspace>`
  1234. Called when the user presses the backspace key. Can be overridden with :ref:`_backspace<class_TextEdit_private_method__backspace>`.
  1235. .. rst-class:: classref-item-separator
  1236. ----
  1237. .. _class_TextEdit_method_begin_complex_operation:
  1238. .. rst-class:: classref-method
  1239. |void| **begin_complex_operation**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_begin_complex_operation>`
  1240. 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.
  1241. .. rst-class:: classref-item-separator
  1242. ----
  1243. .. _class_TextEdit_method_begin_multicaret_edit:
  1244. .. rst-class:: classref-method
  1245. |void| **begin_multicaret_edit**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_begin_multicaret_edit>`
  1246. Starts an edit for multiple carets. The edit must be ended with :ref:`end_multicaret_edit<class_TextEdit_method_end_multicaret_edit>`. Multicaret edits can be used to edit text at multiple carets and delay merging the carets until the end, so the caret indexes aren't affected immediately. :ref:`begin_multicaret_edit<class_TextEdit_method_begin_multicaret_edit>` and :ref:`end_multicaret_edit<class_TextEdit_method_end_multicaret_edit>` can be nested, and the merge will happen at the last :ref:`end_multicaret_edit<class_TextEdit_method_end_multicaret_edit>`.
  1247. Example usage:
  1248. ::
  1249. begin_complex_operation()
  1250. begin_multicaret_edit()
  1251. for i in range(get_caret_count()):
  1252. if multicaret_edit_ignore_caret(i):
  1253. continue
  1254. # Logic here.
  1255. end_multicaret_edit()
  1256. end_complex_operation()
  1257. .. rst-class:: classref-item-separator
  1258. ----
  1259. .. _class_TextEdit_method_cancel_ime:
  1260. .. rst-class:: classref-method
  1261. |void| **cancel_ime**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_cancel_ime>`
  1262. 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.
  1263. .. rst-class:: classref-item-separator
  1264. ----
  1265. .. _class_TextEdit_method_center_viewport_to_caret:
  1266. .. rst-class:: classref-method
  1267. |void| **center_viewport_to_caret**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) :ref:`๐Ÿ”—<class_TextEdit_method_center_viewport_to_caret>`
  1268. 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``.
  1269. .. rst-class:: classref-item-separator
  1270. ----
  1271. .. _class_TextEdit_method_clear:
  1272. .. rst-class:: classref-method
  1273. |void| **clear**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_clear>`
  1274. Performs a full reset of **TextEdit**, including undo history.
  1275. .. rst-class:: classref-item-separator
  1276. ----
  1277. .. _class_TextEdit_method_clear_undo_history:
  1278. .. rst-class:: classref-method
  1279. |void| **clear_undo_history**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_clear_undo_history>`
  1280. Clears the undo history.
  1281. .. rst-class:: classref-item-separator
  1282. ----
  1283. .. _class_TextEdit_method_collapse_carets:
  1284. .. rst-class:: classref-method
  1285. |void| **collapse_carets**\ (\ from_line\: :ref:`int<class_int>`, from_column\: :ref:`int<class_int>`, to_line\: :ref:`int<class_int>`, to_column\: :ref:`int<class_int>`, inclusive\: :ref:`bool<class_bool>` = false\ ) :ref:`๐Ÿ”—<class_TextEdit_method_collapse_carets>`
  1286. Collapse all carets in the given range to the ``from_line`` and ``from_column`` position.
  1287. \ ``inclusive`` applies to both ends.
  1288. If :ref:`is_in_mulitcaret_edit<class_TextEdit_method_is_in_mulitcaret_edit>` is ``true``, carets that are collapsed will be ``true`` for :ref:`multicaret_edit_ignore_caret<class_TextEdit_method_multicaret_edit_ignore_caret>`.
  1289. \ :ref:`merge_overlapping_carets<class_TextEdit_method_merge_overlapping_carets>` will be called if any carets were collapsed.
  1290. .. rst-class:: classref-item-separator
  1291. ----
  1292. .. _class_TextEdit_method_copy:
  1293. .. rst-class:: classref-method
  1294. |void| **copy**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_copy>`
  1295. Copies the current text selection. Can be overridden with :ref:`_copy<class_TextEdit_private_method__copy>`.
  1296. .. rst-class:: classref-item-separator
  1297. ----
  1298. .. _class_TextEdit_method_cut:
  1299. .. rst-class:: classref-method
  1300. |void| **cut**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_cut>`
  1301. Cut's the current selection. Can be overridden with :ref:`_cut<class_TextEdit_private_method__cut>`.
  1302. .. rst-class:: classref-item-separator
  1303. ----
  1304. .. _class_TextEdit_method_delete_selection:
  1305. .. rst-class:: classref-method
  1306. |void| **delete_selection**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_delete_selection>`
  1307. Deletes the selected text.
  1308. .. rst-class:: classref-item-separator
  1309. ----
  1310. .. _class_TextEdit_method_deselect:
  1311. .. rst-class:: classref-method
  1312. |void| **deselect**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_deselect>`
  1313. Deselects the current selection.
  1314. .. rst-class:: classref-item-separator
  1315. ----
  1316. .. _class_TextEdit_method_end_action:
  1317. .. rst-class:: classref-method
  1318. |void| **end_action**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_end_action>`
  1319. Marks the end of steps in the current action started with :ref:`start_action<class_TextEdit_method_start_action>`.
  1320. .. rst-class:: classref-item-separator
  1321. ----
  1322. .. _class_TextEdit_method_end_complex_operation:
  1323. .. rst-class:: classref-method
  1324. |void| **end_complex_operation**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_end_complex_operation>`
  1325. 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.
  1326. .. rst-class:: classref-item-separator
  1327. ----
  1328. .. _class_TextEdit_method_end_multicaret_edit:
  1329. .. rst-class:: classref-method
  1330. |void| **end_multicaret_edit**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_end_multicaret_edit>`
  1331. Ends an edit for multiple carets, that was started with :ref:`begin_multicaret_edit<class_TextEdit_method_begin_multicaret_edit>`. If this was the last :ref:`end_multicaret_edit<class_TextEdit_method_end_multicaret_edit>` and :ref:`merge_overlapping_carets<class_TextEdit_method_merge_overlapping_carets>` was called, carets will be merged.
  1332. .. rst-class:: classref-item-separator
  1333. ----
  1334. .. _class_TextEdit_method_get_caret_column:
  1335. .. rst-class:: classref-method
  1336. :ref:`int<class_int>` **get_caret_column**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_caret_column>`
  1337. Returns the column the editing caret is at.
  1338. .. rst-class:: classref-item-separator
  1339. ----
  1340. .. _class_TextEdit_method_get_caret_count:
  1341. .. rst-class:: classref-method
  1342. :ref:`int<class_int>` **get_caret_count**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_caret_count>`
  1343. Returns the number of carets in this **TextEdit**.
  1344. .. rst-class:: classref-item-separator
  1345. ----
  1346. .. _class_TextEdit_method_get_caret_draw_pos:
  1347. .. rst-class:: classref-method
  1348. :ref:`Vector2<class_Vector2>` **get_caret_draw_pos**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_caret_draw_pos>`
  1349. Returns the caret pixel draw position.
  1350. .. rst-class:: classref-item-separator
  1351. ----
  1352. .. _class_TextEdit_method_get_caret_index_edit_order:
  1353. .. rst-class:: classref-method
  1354. :ref:`PackedInt32Array<class_PackedInt32Array>` **get_caret_index_edit_order**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_get_caret_index_edit_order>`
  1355. **Deprecated:** Carets no longer need to be edited in any specific order. If the carets need to be sorted, use :ref:`get_sorted_carets<class_TextEdit_method_get_sorted_carets>` instead.
  1356. 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.
  1357. .. rst-class:: classref-item-separator
  1358. ----
  1359. .. _class_TextEdit_method_get_caret_line:
  1360. .. rst-class:: classref-method
  1361. :ref:`int<class_int>` **get_caret_line**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_caret_line>`
  1362. Returns the line the editing caret is on.
  1363. .. rst-class:: classref-item-separator
  1364. ----
  1365. .. _class_TextEdit_method_get_caret_wrap_index:
  1366. .. rst-class:: classref-method
  1367. :ref:`int<class_int>` **get_caret_wrap_index**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_caret_wrap_index>`
  1368. Returns the wrap index the editing caret is on.
  1369. .. rst-class:: classref-item-separator
  1370. ----
  1371. .. _class_TextEdit_method_get_first_non_whitespace_column:
  1372. .. rst-class:: classref-method
  1373. :ref:`int<class_int>` **get_first_non_whitespace_column**\ (\ line\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_first_non_whitespace_column>`
  1374. Returns the first column containing a non-whitespace character.
  1375. .. rst-class:: classref-item-separator
  1376. ----
  1377. .. _class_TextEdit_method_get_first_visible_line:
  1378. .. rst-class:: classref-method
  1379. :ref:`int<class_int>` **get_first_visible_line**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_first_visible_line>`
  1380. Returns the first visible line.
  1381. .. rst-class:: classref-item-separator
  1382. ----
  1383. .. _class_TextEdit_method_get_gutter_count:
  1384. .. rst-class:: classref-method
  1385. :ref:`int<class_int>` **get_gutter_count**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_gutter_count>`
  1386. Returns the number of gutters registered.
  1387. .. rst-class:: classref-item-separator
  1388. ----
  1389. .. _class_TextEdit_method_get_gutter_name:
  1390. .. rst-class:: classref-method
  1391. :ref:`String<class_String>` **get_gutter_name**\ (\ gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_gutter_name>`
  1392. Returns the name of the gutter at the given index.
  1393. .. rst-class:: classref-item-separator
  1394. ----
  1395. .. _class_TextEdit_method_get_gutter_type:
  1396. .. rst-class:: classref-method
  1397. :ref:`GutterType<enum_TextEdit_GutterType>` **get_gutter_type**\ (\ gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_gutter_type>`
  1398. 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.
  1399. .. rst-class:: classref-item-separator
  1400. ----
  1401. .. _class_TextEdit_method_get_gutter_width:
  1402. .. rst-class:: classref-method
  1403. :ref:`int<class_int>` **get_gutter_width**\ (\ gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_gutter_width>`
  1404. Returns the width of the gutter at the given index.
  1405. .. rst-class:: classref-item-separator
  1406. ----
  1407. .. _class_TextEdit_method_get_h_scroll_bar:
  1408. .. rst-class:: classref-method
  1409. :ref:`HScrollBar<class_HScrollBar>` **get_h_scroll_bar**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_h_scroll_bar>`
  1410. Returns the :ref:`HScrollBar<class_HScrollBar>` used by **TextEdit**.
  1411. .. rst-class:: classref-item-separator
  1412. ----
  1413. .. _class_TextEdit_method_get_indent_level:
  1414. .. rst-class:: classref-method
  1415. :ref:`int<class_int>` **get_indent_level**\ (\ line\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_indent_level>`
  1416. Returns the number of spaces and ``tab * tab_size`` before the first char.
  1417. .. rst-class:: classref-item-separator
  1418. ----
  1419. .. _class_TextEdit_method_get_last_full_visible_line:
  1420. .. rst-class:: classref-method
  1421. :ref:`int<class_int>` **get_last_full_visible_line**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_last_full_visible_line>`
  1422. 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.
  1423. .. rst-class:: classref-item-separator
  1424. ----
  1425. .. _class_TextEdit_method_get_last_full_visible_line_wrap_index:
  1426. .. rst-class:: classref-method
  1427. :ref:`int<class_int>` **get_last_full_visible_line_wrap_index**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_last_full_visible_line_wrap_index>`
  1428. Returns the last visible wrap index of the last visible line.
  1429. .. rst-class:: classref-item-separator
  1430. ----
  1431. .. _class_TextEdit_method_get_last_unhidden_line:
  1432. .. rst-class:: classref-method
  1433. :ref:`int<class_int>` **get_last_unhidden_line**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_last_unhidden_line>`
  1434. Returns the last unhidden line in the entire **TextEdit**.
  1435. .. rst-class:: classref-item-separator
  1436. ----
  1437. .. _class_TextEdit_method_get_line:
  1438. .. rst-class:: classref-method
  1439. :ref:`String<class_String>` **get_line**\ (\ line\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line>`
  1440. Returns the text of a specific line.
  1441. .. rst-class:: classref-item-separator
  1442. ----
  1443. .. _class_TextEdit_method_get_line_background_color:
  1444. .. rst-class:: classref-method
  1445. :ref:`Color<class_Color>` **get_line_background_color**\ (\ line\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_background_color>`
  1446. Returns the current background color of the line. ``Color(0, 0, 0, 0)`` is returned if no color is set.
  1447. .. rst-class:: classref-item-separator
  1448. ----
  1449. .. _class_TextEdit_method_get_line_column_at_pos:
  1450. .. rst-class:: classref-method
  1451. :ref:`Vector2i<class_Vector2i>` **get_line_column_at_pos**\ (\ position\: :ref:`Vector2i<class_Vector2i>`, allow_out_of_bounds\: :ref:`bool<class_bool>` = true\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_column_at_pos>`
  1452. 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``.
  1453. .. rst-class:: classref-item-separator
  1454. ----
  1455. .. _class_TextEdit_method_get_line_count:
  1456. .. rst-class:: classref-method
  1457. :ref:`int<class_int>` **get_line_count**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_count>`
  1458. Returns the number of lines in the text.
  1459. .. rst-class:: classref-item-separator
  1460. ----
  1461. .. _class_TextEdit_method_get_line_gutter_icon:
  1462. .. rst-class:: classref-method
  1463. :ref:`Texture2D<class_Texture2D>` **get_line_gutter_icon**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_gutter_icon>`
  1464. 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>`).
  1465. .. rst-class:: classref-item-separator
  1466. ----
  1467. .. _class_TextEdit_method_get_line_gutter_item_color:
  1468. .. rst-class:: classref-method
  1469. :ref:`Color<class_Color>` **get_line_gutter_item_color**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_gutter_item_color>`
  1470. Returns the color currently in ``gutter`` at ``line``.
  1471. .. rst-class:: classref-item-separator
  1472. ----
  1473. .. _class_TextEdit_method_get_line_gutter_metadata:
  1474. .. rst-class:: classref-method
  1475. :ref:`Variant<class_Variant>` **get_line_gutter_metadata**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_gutter_metadata>`
  1476. Returns the metadata currently in ``gutter`` at ``line``.
  1477. .. rst-class:: classref-item-separator
  1478. ----
  1479. .. _class_TextEdit_method_get_line_gutter_text:
  1480. .. rst-class:: classref-method
  1481. :ref:`String<class_String>` **get_line_gutter_text**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_gutter_text>`
  1482. 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>`).
  1483. .. rst-class:: classref-item-separator
  1484. ----
  1485. .. _class_TextEdit_method_get_line_height:
  1486. .. rst-class:: classref-method
  1487. :ref:`int<class_int>` **get_line_height**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_height>`
  1488. Returns the maximum value of the line height among all lines.
  1489. \ **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``.
  1490. .. rst-class:: classref-item-separator
  1491. ----
  1492. .. _class_TextEdit_method_get_line_ranges_from_carets:
  1493. .. rst-class:: classref-method
  1494. :ref:`Array<class_Array>`\[:ref:`Vector2i<class_Vector2i>`\] **get_line_ranges_from_carets**\ (\ only_selections\: :ref:`bool<class_bool>` = false, merge_adjacent\: :ref:`bool<class_bool>` = true\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_ranges_from_carets>`
  1495. Returns an :ref:`Array<class_Array>` of line ranges where ``x`` is the first line and ``y`` is the last line. All lines within these ranges will have a caret on them or be part of a selection. Each line will only be part of one line range, even if it has multiple carets on it.
  1496. If a selection's end column (:ref:`get_selection_to_column<class_TextEdit_method_get_selection_to_column>`) is at column ``0``, that line will not be included. If a selection begins on the line after another selection ends and ``merge_adjacent`` is ``true``, or they begin and end on the same line, one line range will include both selections.
  1497. .. rst-class:: classref-item-separator
  1498. ----
  1499. .. _class_TextEdit_method_get_line_width:
  1500. .. rst-class:: classref-method
  1501. :ref:`int<class_int>` **get_line_width**\ (\ line\: :ref:`int<class_int>`, wrap_index\: :ref:`int<class_int>` = -1\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_width>`
  1502. Returns the width in pixels of the ``wrap_index`` on ``line``.
  1503. .. rst-class:: classref-item-separator
  1504. ----
  1505. .. _class_TextEdit_method_get_line_wrap_count:
  1506. .. rst-class:: classref-method
  1507. :ref:`int<class_int>` **get_line_wrap_count**\ (\ line\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_wrap_count>`
  1508. Returns the number of times the given line is wrapped.
  1509. .. rst-class:: classref-item-separator
  1510. ----
  1511. .. _class_TextEdit_method_get_line_wrap_index_at_column:
  1512. .. rst-class:: classref-method
  1513. :ref:`int<class_int>` **get_line_wrap_index_at_column**\ (\ line\: :ref:`int<class_int>`, column\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_wrap_index_at_column>`
  1514. Returns the wrap index of the given line column.
  1515. .. rst-class:: classref-item-separator
  1516. ----
  1517. .. _class_TextEdit_method_get_line_wrapped_text:
  1518. .. rst-class:: classref-method
  1519. :ref:`PackedStringArray<class_PackedStringArray>` **get_line_wrapped_text**\ (\ line\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_line_wrapped_text>`
  1520. Returns an array of :ref:`String<class_String>`\ s representing each wrapped index.
  1521. .. rst-class:: classref-item-separator
  1522. ----
  1523. .. _class_TextEdit_method_get_local_mouse_pos:
  1524. .. rst-class:: classref-method
  1525. :ref:`Vector2<class_Vector2>` **get_local_mouse_pos**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_local_mouse_pos>`
  1526. Returns the local mouse position adjusted for the text direction.
  1527. .. rst-class:: classref-item-separator
  1528. ----
  1529. .. _class_TextEdit_method_get_menu:
  1530. .. rst-class:: classref-method
  1531. :ref:`PopupMenu<class_PopupMenu>` **get_menu**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_menu>`
  1532. Returns the :ref:`PopupMenu<class_PopupMenu>` of this **TextEdit**. By default, this menu is displayed when right-clicking on the **TextEdit**.
  1533. 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:
  1534. .. tabs::
  1535. .. code-tab:: gdscript
  1536. func _ready():
  1537. var menu = get_menu()
  1538. # Remove all items after "Redo".
  1539. menu.item_count = menu.get_item_index(MENU_REDO) + 1
  1540. # Add custom items.
  1541. menu.add_separator()
  1542. menu.add_item("Insert Date", MENU_MAX + 1)
  1543. # Connect callback.
  1544. menu.id_pressed.connect(_on_item_pressed)
  1545. func _on_item_pressed(id):
  1546. if id == MENU_MAX + 1:
  1547. insert_text_at_caret(Time.get_date_string_from_system())
  1548. .. code-tab:: csharp
  1549. public override void _Ready()
  1550. {
  1551. var menu = GetMenu();
  1552. // Remove all items after "Redo".
  1553. menu.ItemCount = menu.GetItemIndex(TextEdit.MenuItems.Redo) + 1;
  1554. // Add custom items.
  1555. menu.AddSeparator();
  1556. menu.AddItem("Insert Date", TextEdit.MenuItems.Max + 1);
  1557. // Add event handler.
  1558. menu.IdPressed += OnItemPressed;
  1559. }
  1560. public void OnItemPressed(int id)
  1561. {
  1562. if (id == TextEdit.MenuItems.Max + 1)
  1563. {
  1564. InsertTextAtCaret(Time.GetDateStringFromSystem());
  1565. }
  1566. }
  1567. \ **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.
  1568. .. rst-class:: classref-item-separator
  1569. ----
  1570. .. _class_TextEdit_method_get_minimap_line_at_pos:
  1571. .. rst-class:: classref-method
  1572. :ref:`int<class_int>` **get_minimap_line_at_pos**\ (\ position\: :ref:`Vector2i<class_Vector2i>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_minimap_line_at_pos>`
  1573. Returns the equivalent minimap line at ``position``.
  1574. .. rst-class:: classref-item-separator
  1575. ----
  1576. .. _class_TextEdit_method_get_minimap_visible_lines:
  1577. .. rst-class:: classref-method
  1578. :ref:`int<class_int>` **get_minimap_visible_lines**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_minimap_visible_lines>`
  1579. Returns the number of lines that may be drawn on the minimap.
  1580. .. rst-class:: classref-item-separator
  1581. ----
  1582. .. _class_TextEdit_method_get_next_visible_line_index_offset_from:
  1583. .. rst-class:: classref-method
  1584. :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| :ref:`๐Ÿ”—<class_TextEdit_method_get_next_visible_line_index_offset_from>`
  1585. 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.
  1586. .. rst-class:: classref-item-separator
  1587. ----
  1588. .. _class_TextEdit_method_get_next_visible_line_offset_from:
  1589. .. rst-class:: classref-method
  1590. :ref:`int<class_int>` **get_next_visible_line_offset_from**\ (\ line\: :ref:`int<class_int>`, visible_amount\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_next_visible_line_offset_from>`
  1591. 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.
  1592. .. rst-class:: classref-item-separator
  1593. ----
  1594. .. _class_TextEdit_method_get_pos_at_line_column:
  1595. .. rst-class:: classref-method
  1596. :ref:`Vector2i<class_Vector2i>` **get_pos_at_line_column**\ (\ line\: :ref:`int<class_int>`, column\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_pos_at_line_column>`
  1597. 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.
  1598. \ **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.
  1599. .. rst-class:: classref-item-separator
  1600. ----
  1601. .. _class_TextEdit_method_get_rect_at_line_column:
  1602. .. rst-class:: classref-method
  1603. :ref:`Rect2i<class_Rect2i>` **get_rect_at_line_column**\ (\ line\: :ref:`int<class_int>`, column\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_rect_at_line_column>`
  1604. 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.
  1605. \ **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.
  1606. .. rst-class:: classref-item-separator
  1607. ----
  1608. .. _class_TextEdit_method_get_saved_version:
  1609. .. rst-class:: classref-method
  1610. :ref:`int<class_int>` **get_saved_version**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_saved_version>`
  1611. Returns the last tagged saved version from :ref:`tag_saved_version<class_TextEdit_method_tag_saved_version>`.
  1612. .. rst-class:: classref-item-separator
  1613. ----
  1614. .. _class_TextEdit_method_get_scroll_pos_for_line:
  1615. .. rst-class:: classref-method
  1616. :ref:`float<class_float>` **get_scroll_pos_for_line**\ (\ line\: :ref:`int<class_int>`, wrap_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_scroll_pos_for_line>`
  1617. Returns the scroll position for ``wrap_index`` of ``line``.
  1618. .. rst-class:: classref-item-separator
  1619. ----
  1620. .. _class_TextEdit_method_get_selected_text:
  1621. .. rst-class:: classref-method
  1622. :ref:`String<class_String>` **get_selected_text**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_get_selected_text>`
  1623. Returns the text inside the selection of a caret, or all the carets if ``caret_index`` is its default value ``-1``.
  1624. .. rst-class:: classref-item-separator
  1625. ----
  1626. .. _class_TextEdit_method_get_selection_at_line_column:
  1627. .. rst-class:: classref-method
  1628. :ref:`int<class_int>` **get_selection_at_line_column**\ (\ line\: :ref:`int<class_int>`, column\: :ref:`int<class_int>`, include_edges\: :ref:`bool<class_bool>` = true, only_selections\: :ref:`bool<class_bool>` = true\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_at_line_column>`
  1629. Returns the caret index of the selection at the given ``line`` and ``column``, or ``-1`` if there is none.
  1630. If ``include_edges`` is ``false``, the position must be inside the selection and not at either end. If ``only_selections`` is ``false``, carets without a selection will also be considered.
  1631. .. rst-class:: classref-item-separator
  1632. ----
  1633. .. _class_TextEdit_method_get_selection_column:
  1634. .. rst-class:: classref-method
  1635. :ref:`int<class_int>` **get_selection_column**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_column>`
  1636. **Deprecated:** Use :ref:`get_selection_origin_column<class_TextEdit_method_get_selection_origin_column>` instead.
  1637. Returns the original start column of the selection.
  1638. .. rst-class:: classref-item-separator
  1639. ----
  1640. .. _class_TextEdit_method_get_selection_from_column:
  1641. .. rst-class:: classref-method
  1642. :ref:`int<class_int>` **get_selection_from_column**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_from_column>`
  1643. Returns the selection begin column. Returns the caret column if there is no selection.
  1644. .. rst-class:: classref-item-separator
  1645. ----
  1646. .. _class_TextEdit_method_get_selection_from_line:
  1647. .. rst-class:: classref-method
  1648. :ref:`int<class_int>` **get_selection_from_line**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_from_line>`
  1649. Returns the selection begin line. Returns the caret line if there is no selection.
  1650. .. rst-class:: classref-item-separator
  1651. ----
  1652. .. _class_TextEdit_method_get_selection_line:
  1653. .. rst-class:: classref-method
  1654. :ref:`int<class_int>` **get_selection_line**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_line>`
  1655. **Deprecated:** Use :ref:`get_selection_origin_line<class_TextEdit_method_get_selection_origin_line>` instead.
  1656. Returns the original start line of the selection.
  1657. .. rst-class:: classref-item-separator
  1658. ----
  1659. .. _class_TextEdit_method_get_selection_mode:
  1660. .. rst-class:: classref-method
  1661. :ref:`SelectionMode<enum_TextEdit_SelectionMode>` **get_selection_mode**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_mode>`
  1662. Returns the current selection mode.
  1663. .. rst-class:: classref-item-separator
  1664. ----
  1665. .. _class_TextEdit_method_get_selection_origin_column:
  1666. .. rst-class:: classref-method
  1667. :ref:`int<class_int>` **get_selection_origin_column**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_origin_column>`
  1668. Returns the origin column of the selection. This is the opposite end from the caret.
  1669. .. rst-class:: classref-item-separator
  1670. ----
  1671. .. _class_TextEdit_method_get_selection_origin_line:
  1672. .. rst-class:: classref-method
  1673. :ref:`int<class_int>` **get_selection_origin_line**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_origin_line>`
  1674. Returns the origin line of the selection. This is the opposite end from the caret.
  1675. .. rst-class:: classref-item-separator
  1676. ----
  1677. .. _class_TextEdit_method_get_selection_to_column:
  1678. .. rst-class:: classref-method
  1679. :ref:`int<class_int>` **get_selection_to_column**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_to_column>`
  1680. Returns the selection end column. Returns the caret column if there is no selection.
  1681. .. rst-class:: classref-item-separator
  1682. ----
  1683. .. _class_TextEdit_method_get_selection_to_line:
  1684. .. rst-class:: classref-method
  1685. :ref:`int<class_int>` **get_selection_to_line**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_selection_to_line>`
  1686. Returns the selection end line. Returns the caret line if there is no selection.
  1687. .. rst-class:: classref-item-separator
  1688. ----
  1689. .. _class_TextEdit_method_get_sorted_carets:
  1690. .. rst-class:: classref-method
  1691. :ref:`PackedInt32Array<class_PackedInt32Array>` **get_sorted_carets**\ (\ include_ignored_carets\: :ref:`bool<class_bool>` = false\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_sorted_carets>`
  1692. Returns the carets sorted by selection beginning from lowest line and column to highest (from top to bottom of text).
  1693. If ``include_ignored_carets`` is ``false``, carets from :ref:`multicaret_edit_ignore_caret<class_TextEdit_method_multicaret_edit_ignore_caret>` will be ignored.
  1694. .. rst-class:: classref-item-separator
  1695. ----
  1696. .. _class_TextEdit_method_get_tab_size:
  1697. .. rst-class:: classref-method
  1698. :ref:`int<class_int>` **get_tab_size**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_tab_size>`
  1699. Returns the **TextEdit**'s' tab size.
  1700. .. rst-class:: classref-item-separator
  1701. ----
  1702. .. _class_TextEdit_method_get_total_gutter_width:
  1703. .. rst-class:: classref-method
  1704. :ref:`int<class_int>` **get_total_gutter_width**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_total_gutter_width>`
  1705. Returns the total width of all gutters and internal padding.
  1706. .. rst-class:: classref-item-separator
  1707. ----
  1708. .. _class_TextEdit_method_get_total_visible_line_count:
  1709. .. rst-class:: classref-method
  1710. :ref:`int<class_int>` **get_total_visible_line_count**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_total_visible_line_count>`
  1711. Returns the number of lines that may be drawn.
  1712. .. rst-class:: classref-item-separator
  1713. ----
  1714. .. _class_TextEdit_method_get_v_scroll_bar:
  1715. .. rst-class:: classref-method
  1716. :ref:`VScrollBar<class_VScrollBar>` **get_v_scroll_bar**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_v_scroll_bar>`
  1717. Returns the :ref:`VScrollBar<class_VScrollBar>` of the **TextEdit**.
  1718. .. rst-class:: classref-item-separator
  1719. ----
  1720. .. _class_TextEdit_method_get_version:
  1721. .. rst-class:: classref-method
  1722. :ref:`int<class_int>` **get_version**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_version>`
  1723. Returns the current version of the **TextEdit**. The version is a count of recorded operations by the undo/redo history.
  1724. .. rst-class:: classref-item-separator
  1725. ----
  1726. .. _class_TextEdit_method_get_visible_line_count:
  1727. .. rst-class:: classref-method
  1728. :ref:`int<class_int>` **get_visible_line_count**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_visible_line_count>`
  1729. Returns the number of visible lines, including wrapped text.
  1730. .. rst-class:: classref-item-separator
  1731. ----
  1732. .. _class_TextEdit_method_get_visible_line_count_in_range:
  1733. .. rst-class:: classref-method
  1734. :ref:`int<class_int>` **get_visible_line_count_in_range**\ (\ from_line\: :ref:`int<class_int>`, to_line\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_visible_line_count_in_range>`
  1735. Returns the total number of visible + wrapped lines between the two lines.
  1736. .. rst-class:: classref-item-separator
  1737. ----
  1738. .. _class_TextEdit_method_get_word_at_pos:
  1739. .. rst-class:: classref-method
  1740. :ref:`String<class_String>` **get_word_at_pos**\ (\ position\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_word_at_pos>`
  1741. Returns the word at ``position``.
  1742. .. rst-class:: classref-item-separator
  1743. ----
  1744. .. _class_TextEdit_method_get_word_under_caret:
  1745. .. rst-class:: classref-method
  1746. :ref:`String<class_String>` **get_word_under_caret**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_get_word_under_caret>`
  1747. Returns a :ref:`String<class_String>` text with the word under the caret's location.
  1748. .. rst-class:: classref-item-separator
  1749. ----
  1750. .. _class_TextEdit_method_has_ime_text:
  1751. .. rst-class:: classref-method
  1752. :ref:`bool<class_bool>` **has_ime_text**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_has_ime_text>`
  1753. Returns ``true`` if the user has text in the `Input Method Editor <https://en.wikipedia.org/wiki/Input_method>`__ (IME).
  1754. .. rst-class:: classref-item-separator
  1755. ----
  1756. .. _class_TextEdit_method_has_redo:
  1757. .. rst-class:: classref-method
  1758. :ref:`bool<class_bool>` **has_redo**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_has_redo>`
  1759. Returns ``true`` if a "redo" action is available.
  1760. .. rst-class:: classref-item-separator
  1761. ----
  1762. .. _class_TextEdit_method_has_selection:
  1763. .. rst-class:: classref-method
  1764. :ref:`bool<class_bool>` **has_selection**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_has_selection>`
  1765. Returns ``true`` if the user has selected text.
  1766. .. rst-class:: classref-item-separator
  1767. ----
  1768. .. _class_TextEdit_method_has_undo:
  1769. .. rst-class:: classref-method
  1770. :ref:`bool<class_bool>` **has_undo**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_has_undo>`
  1771. Returns ``true`` if an "undo" action is available.
  1772. .. rst-class:: classref-item-separator
  1773. ----
  1774. .. _class_TextEdit_method_insert_line_at:
  1775. .. rst-class:: classref-method
  1776. |void| **insert_line_at**\ (\ line\: :ref:`int<class_int>`, text\: :ref:`String<class_String>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_insert_line_at>`
  1777. Inserts a new line with ``text`` at ``line``.
  1778. .. rst-class:: classref-item-separator
  1779. ----
  1780. .. _class_TextEdit_method_insert_text:
  1781. .. rst-class:: classref-method
  1782. |void| **insert_text**\ (\ text\: :ref:`String<class_String>`, line\: :ref:`int<class_int>`, column\: :ref:`int<class_int>`, before_selection_begin\: :ref:`bool<class_bool>` = true, before_selection_end\: :ref:`bool<class_bool>` = false\ ) :ref:`๐Ÿ”—<class_TextEdit_method_insert_text>`
  1783. Inserts the ``text`` at ``line`` and ``column``.
  1784. If ``before_selection_begin`` is ``true``, carets and selections that begin at ``line`` and ``column`` will moved to the end of the inserted text, along with all carets after it.
  1785. If ``before_selection_end`` is ``true``, selections that end at ``line`` and ``column`` will be extended to the end of the inserted text. These parameters can be used to insert text inside of or outside of selections.
  1786. .. rst-class:: classref-item-separator
  1787. ----
  1788. .. _class_TextEdit_method_insert_text_at_caret:
  1789. .. rst-class:: classref-method
  1790. |void| **insert_text_at_caret**\ (\ text\: :ref:`String<class_String>`, caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_insert_text_at_caret>`
  1791. Insert the specified text at the caret position.
  1792. .. rst-class:: classref-item-separator
  1793. ----
  1794. .. _class_TextEdit_method_is_caret_after_selection_origin:
  1795. .. rst-class:: classref-method
  1796. :ref:`bool<class_bool>` **is_caret_after_selection_origin**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_caret_after_selection_origin>`
  1797. Returns ``true`` if the caret of the selection is after the selection origin. This can be used to determine the direction of the selection.
  1798. .. rst-class:: classref-item-separator
  1799. ----
  1800. .. _class_TextEdit_method_is_caret_visible:
  1801. .. rst-class:: classref-method
  1802. :ref:`bool<class_bool>` **is_caret_visible**\ (\ caret_index\: :ref:`int<class_int>` = 0\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_caret_visible>`
  1803. Returns ``true`` if the caret is visible on the screen.
  1804. .. rst-class:: classref-item-separator
  1805. ----
  1806. .. _class_TextEdit_method_is_dragging_cursor:
  1807. .. rst-class:: classref-method
  1808. :ref:`bool<class_bool>` **is_dragging_cursor**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_dragging_cursor>`
  1809. Returns ``true`` if the user is dragging their mouse for scrolling, selecting, or text dragging.
  1810. .. rst-class:: classref-item-separator
  1811. ----
  1812. .. _class_TextEdit_method_is_gutter_clickable:
  1813. .. rst-class:: classref-method
  1814. :ref:`bool<class_bool>` **is_gutter_clickable**\ (\ gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_gutter_clickable>`
  1815. Returns whether the gutter is clickable.
  1816. .. rst-class:: classref-item-separator
  1817. ----
  1818. .. _class_TextEdit_method_is_gutter_drawn:
  1819. .. rst-class:: classref-method
  1820. :ref:`bool<class_bool>` **is_gutter_drawn**\ (\ gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_gutter_drawn>`
  1821. Returns whether the gutter is currently drawn.
  1822. .. rst-class:: classref-item-separator
  1823. ----
  1824. .. _class_TextEdit_method_is_gutter_overwritable:
  1825. .. rst-class:: classref-method
  1826. :ref:`bool<class_bool>` **is_gutter_overwritable**\ (\ gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_gutter_overwritable>`
  1827. Returns whether the gutter is overwritable.
  1828. .. rst-class:: classref-item-separator
  1829. ----
  1830. .. _class_TextEdit_method_is_in_mulitcaret_edit:
  1831. .. rst-class:: classref-method
  1832. :ref:`bool<class_bool>` **is_in_mulitcaret_edit**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_in_mulitcaret_edit>`
  1833. Returns ``true`` if a :ref:`begin_multicaret_edit<class_TextEdit_method_begin_multicaret_edit>` has been called and :ref:`end_multicaret_edit<class_TextEdit_method_end_multicaret_edit>` has not yet been called.
  1834. .. rst-class:: classref-item-separator
  1835. ----
  1836. .. _class_TextEdit_method_is_line_gutter_clickable:
  1837. .. rst-class:: classref-method
  1838. :ref:`bool<class_bool>` **is_line_gutter_clickable**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_line_gutter_clickable>`
  1839. Returns whether the gutter on the given line is clickable.
  1840. .. rst-class:: classref-item-separator
  1841. ----
  1842. .. _class_TextEdit_method_is_line_wrapped:
  1843. .. rst-class:: classref-method
  1844. :ref:`bool<class_bool>` **is_line_wrapped**\ (\ line\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_line_wrapped>`
  1845. Returns if the given line is wrapped.
  1846. .. rst-class:: classref-item-separator
  1847. ----
  1848. .. _class_TextEdit_method_is_menu_visible:
  1849. .. rst-class:: classref-method
  1850. :ref:`bool<class_bool>` **is_menu_visible**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_menu_visible>`
  1851. Returns whether the menu is visible. Use this instead of ``get_menu().visible`` to improve performance (so the creation of the menu is avoided).
  1852. .. rst-class:: classref-item-separator
  1853. ----
  1854. .. _class_TextEdit_method_is_mouse_over_selection:
  1855. .. rst-class:: classref-method
  1856. :ref:`bool<class_bool>` **is_mouse_over_selection**\ (\ edges\: :ref:`bool<class_bool>`, caret_index\: :ref:`int<class_int>` = -1\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_mouse_over_selection>`
  1857. Returns whether the mouse is over selection. If ``edges`` is ``true``, the edges are considered part of the selection.
  1858. .. rst-class:: classref-item-separator
  1859. ----
  1860. .. _class_TextEdit_method_is_overtype_mode_enabled:
  1861. .. rst-class:: classref-method
  1862. :ref:`bool<class_bool>` **is_overtype_mode_enabled**\ (\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_is_overtype_mode_enabled>`
  1863. Returns whether the user is in overtype mode.
  1864. .. rst-class:: classref-item-separator
  1865. ----
  1866. .. _class_TextEdit_method_menu_option:
  1867. .. rst-class:: classref-method
  1868. |void| **menu_option**\ (\ option\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_menu_option>`
  1869. Executes a given action as defined in the :ref:`MenuItems<enum_TextEdit_MenuItems>` enum.
  1870. .. rst-class:: classref-item-separator
  1871. ----
  1872. .. _class_TextEdit_method_merge_gutters:
  1873. .. rst-class:: classref-method
  1874. |void| **merge_gutters**\ (\ from_line\: :ref:`int<class_int>`, to_line\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_merge_gutters>`
  1875. Merge the gutters from ``from_line`` into ``to_line``. Only overwritable gutters will be copied.
  1876. .. rst-class:: classref-item-separator
  1877. ----
  1878. .. _class_TextEdit_method_merge_overlapping_carets:
  1879. .. rst-class:: classref-method
  1880. |void| **merge_overlapping_carets**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_merge_overlapping_carets>`
  1881. Merges any overlapping carets. Will favor the newest caret, or the caret with a selection.
  1882. If :ref:`is_in_mulitcaret_edit<class_TextEdit_method_is_in_mulitcaret_edit>` is ``true``, the merge will be queued to happen at the end of the multicaret edit. See :ref:`begin_multicaret_edit<class_TextEdit_method_begin_multicaret_edit>` and :ref:`end_multicaret_edit<class_TextEdit_method_end_multicaret_edit>`.
  1883. \ **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.
  1884. .. rst-class:: classref-item-separator
  1885. ----
  1886. .. _class_TextEdit_method_multicaret_edit_ignore_caret:
  1887. .. rst-class:: classref-method
  1888. :ref:`bool<class_bool>` **multicaret_edit_ignore_caret**\ (\ caret_index\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_multicaret_edit_ignore_caret>`
  1889. Returns ``true`` if the given ``caret_index`` should be ignored as part of a multicaret edit. See :ref:`begin_multicaret_edit<class_TextEdit_method_begin_multicaret_edit>` and :ref:`end_multicaret_edit<class_TextEdit_method_end_multicaret_edit>`. Carets that should be ignored are ones that were part of removed text and will likely be merged at the end of the edit, or carets that were added during the edit.
  1890. It is recommended to ``continue`` within a loop iterating on multiple carets if a caret should be ignored.
  1891. .. rst-class:: classref-item-separator
  1892. ----
  1893. .. _class_TextEdit_method_paste:
  1894. .. rst-class:: classref-method
  1895. |void| **paste**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_paste>`
  1896. Paste at the current location. Can be overridden with :ref:`_paste<class_TextEdit_private_method__paste>`.
  1897. .. rst-class:: classref-item-separator
  1898. ----
  1899. .. _class_TextEdit_method_paste_primary_clipboard:
  1900. .. rst-class:: classref-method
  1901. |void| **paste_primary_clipboard**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_paste_primary_clipboard>`
  1902. Pastes the primary clipboard.
  1903. .. rst-class:: classref-item-separator
  1904. ----
  1905. .. _class_TextEdit_method_redo:
  1906. .. rst-class:: classref-method
  1907. |void| **redo**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_redo>`
  1908. Perform redo operation.
  1909. .. rst-class:: classref-item-separator
  1910. ----
  1911. .. _class_TextEdit_method_remove_caret:
  1912. .. rst-class:: classref-method
  1913. |void| **remove_caret**\ (\ caret\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_remove_caret>`
  1914. Removes the given caret index.
  1915. \ **Note:** This can result in adjustment of all other caret indices.
  1916. .. rst-class:: classref-item-separator
  1917. ----
  1918. .. _class_TextEdit_method_remove_gutter:
  1919. .. rst-class:: classref-method
  1920. |void| **remove_gutter**\ (\ gutter\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_remove_gutter>`
  1921. Removes the gutter from this **TextEdit**.
  1922. .. rst-class:: classref-item-separator
  1923. ----
  1924. .. _class_TextEdit_method_remove_line_at:
  1925. .. rst-class:: classref-method
  1926. |void| **remove_line_at**\ (\ line\: :ref:`int<class_int>`, move_carets_down\: :ref:`bool<class_bool>` = true\ ) :ref:`๐Ÿ”—<class_TextEdit_method_remove_line_at>`
  1927. Removes the line of text at ``line``. Carets on this line will attempt to match their previous visual x position.
  1928. If ``move_carets_down`` is ``true`` carets will move to the next line down, otherwise carets will move up.
  1929. .. rst-class:: classref-item-separator
  1930. ----
  1931. .. _class_TextEdit_method_remove_secondary_carets:
  1932. .. rst-class:: classref-method
  1933. |void| **remove_secondary_carets**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_remove_secondary_carets>`
  1934. Removes all additional carets.
  1935. .. rst-class:: classref-item-separator
  1936. ----
  1937. .. _class_TextEdit_method_remove_text:
  1938. .. rst-class:: classref-method
  1939. |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>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_remove_text>`
  1940. Removes text between the given positions.
  1941. .. rst-class:: classref-item-separator
  1942. ----
  1943. .. _class_TextEdit_method_search:
  1944. .. rst-class:: classref-method
  1945. :ref:`Vector2i<class_Vector2i>` **search**\ (\ text\: :ref:`String<class_String>`, flags\: :ref:`int<class_int>`, from_line\: :ref:`int<class_int>`, from_column\: :ref:`int<class_int>`\ ) |const| :ref:`๐Ÿ”—<class_TextEdit_method_search>`
  1946. Perform a search inside the text. Search flags can be specified in the :ref:`SearchFlags<enum_TextEdit_SearchFlags>` enum.
  1947. In the returned vector, ``x`` is the column, ``y`` is the line. If no results are found, both are equal to ``-1``.
  1948. .. tabs::
  1949. .. code-tab:: gdscript
  1950. var result = search("print", SEARCH_WHOLE_WORDS, 0, 0)
  1951. if result.x != -1:
  1952. # Result found.
  1953. var line_number = result.y
  1954. var column_number = result.x
  1955. .. code-tab:: csharp
  1956. Vector2I result = Search("print", (uint)TextEdit.SearchFlags.WholeWords, 0, 0);
  1957. if (result.X != -1)
  1958. {
  1959. // Result found.
  1960. int lineNumber = result.Y;
  1961. int columnNumber = result.X;
  1962. }
  1963. .. rst-class:: classref-item-separator
  1964. ----
  1965. .. _class_TextEdit_method_select:
  1966. .. rst-class:: classref-method
  1967. |void| **select**\ (\ origin_line\: :ref:`int<class_int>`, origin_column\: :ref:`int<class_int>`, caret_line\: :ref:`int<class_int>`, caret_column\: :ref:`int<class_int>`, caret_index\: :ref:`int<class_int>` = 0\ ) :ref:`๐Ÿ”—<class_TextEdit_method_select>`
  1968. Selects text from ``origin_line`` and ``origin_column`` to ``caret_line`` and ``caret_column`` for the given ``caret_index``. This moves the selection origin and the caret. If the positions are the same, the selection will be deselected.
  1969. If :ref:`selecting_enabled<class_TextEdit_property_selecting_enabled>` is ``false``, no selection will occur.
  1970. \ **Note:** If supporting multiple carets this will not check for any overlap. See :ref:`merge_overlapping_carets<class_TextEdit_method_merge_overlapping_carets>`.
  1971. .. rst-class:: classref-item-separator
  1972. ----
  1973. .. _class_TextEdit_method_select_all:
  1974. .. rst-class:: classref-method
  1975. |void| **select_all**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_select_all>`
  1976. Select all the text.
  1977. If :ref:`selecting_enabled<class_TextEdit_property_selecting_enabled>` is ``false``, no selection will occur.
  1978. .. rst-class:: classref-item-separator
  1979. ----
  1980. .. _class_TextEdit_method_select_word_under_caret:
  1981. .. rst-class:: classref-method
  1982. |void| **select_word_under_caret**\ (\ caret_index\: :ref:`int<class_int>` = -1\ ) :ref:`๐Ÿ”—<class_TextEdit_method_select_word_under_caret>`
  1983. Selects the word under the caret.
  1984. .. rst-class:: classref-item-separator
  1985. ----
  1986. .. _class_TextEdit_method_set_caret_column:
  1987. .. rst-class:: classref-method
  1988. |void| **set_caret_column**\ (\ column\: :ref:`int<class_int>`, adjust_viewport\: :ref:`bool<class_bool>` = true, caret_index\: :ref:`int<class_int>` = 0\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_caret_column>`
  1989. Moves the caret to the specified ``column`` index.
  1990. If ``adjust_viewport`` is ``true``, the viewport will center at the caret position after the move occurs.
  1991. \ **Note:** If supporting multiple carets this will not check for any overlap. See :ref:`merge_overlapping_carets<class_TextEdit_method_merge_overlapping_carets>`.
  1992. .. rst-class:: classref-item-separator
  1993. ----
  1994. .. _class_TextEdit_method_set_caret_line:
  1995. .. rst-class:: classref-method
  1996. |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\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_caret_line>`
  1997. Moves the caret to the specified ``line`` index. The caret column will be moved to the same visual position it was at the last time :ref:`set_caret_column<class_TextEdit_method_set_caret_column>` was called, or clamped to the end of the line.
  1998. If ``adjust_viewport`` is ``true``, the viewport will center at the caret position after the move occurs.
  1999. If ``can_be_hidden`` is ``true``, the specified ``line`` can be hidden.
  2000. If ``wrap_index`` is ``-1``, the caret column will be clamped to the ``line``'s length. If ``wrap_index`` is greater than ``-1``, the column will be moved to attempt to match the visual x position on the line's ``wrap_index`` to the position from the last time :ref:`set_caret_column<class_TextEdit_method_set_caret_column>` was called.
  2001. \ **Note:** If supporting multiple carets this will not check for any overlap. See :ref:`merge_overlapping_carets<class_TextEdit_method_merge_overlapping_carets>`.
  2002. .. rst-class:: classref-item-separator
  2003. ----
  2004. .. _class_TextEdit_method_set_gutter_clickable:
  2005. .. rst-class:: classref-method
  2006. |void| **set_gutter_clickable**\ (\ gutter\: :ref:`int<class_int>`, clickable\: :ref:`bool<class_bool>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_gutter_clickable>`
  2007. Sets the gutter as clickable. This will change the mouse cursor to a pointing hand when hovering over the gutter.
  2008. .. rst-class:: classref-item-separator
  2009. ----
  2010. .. _class_TextEdit_method_set_gutter_custom_draw:
  2011. .. rst-class:: classref-method
  2012. |void| **set_gutter_custom_draw**\ (\ column\: :ref:`int<class_int>`, draw_callback\: :ref:`Callable<class_Callable>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_gutter_custom_draw>`
  2013. 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>`).
  2014. .. rst-class:: classref-item-separator
  2015. ----
  2016. .. _class_TextEdit_method_set_gutter_draw:
  2017. .. rst-class:: classref-method
  2018. |void| **set_gutter_draw**\ (\ gutter\: :ref:`int<class_int>`, draw\: :ref:`bool<class_bool>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_gutter_draw>`
  2019. Sets whether the gutter should be drawn.
  2020. .. rst-class:: classref-item-separator
  2021. ----
  2022. .. _class_TextEdit_method_set_gutter_name:
  2023. .. rst-class:: classref-method
  2024. |void| **set_gutter_name**\ (\ gutter\: :ref:`int<class_int>`, name\: :ref:`String<class_String>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_gutter_name>`
  2025. Sets the name of the gutter.
  2026. .. rst-class:: classref-item-separator
  2027. ----
  2028. .. _class_TextEdit_method_set_gutter_overwritable:
  2029. .. rst-class:: classref-method
  2030. |void| **set_gutter_overwritable**\ (\ gutter\: :ref:`int<class_int>`, overwritable\: :ref:`bool<class_bool>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_gutter_overwritable>`
  2031. Sets the gutter to overwritable. See :ref:`merge_gutters<class_TextEdit_method_merge_gutters>`.
  2032. .. rst-class:: classref-item-separator
  2033. ----
  2034. .. _class_TextEdit_method_set_gutter_type:
  2035. .. rst-class:: classref-method
  2036. |void| **set_gutter_type**\ (\ gutter\: :ref:`int<class_int>`, type\: :ref:`GutterType<enum_TextEdit_GutterType>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_gutter_type>`
  2037. Sets the type of gutter. Gutters can contain icons, text, or custom visuals. See :ref:`GutterType<enum_TextEdit_GutterType>` for options.
  2038. .. rst-class:: classref-item-separator
  2039. ----
  2040. .. _class_TextEdit_method_set_gutter_width:
  2041. .. rst-class:: classref-method
  2042. |void| **set_gutter_width**\ (\ gutter\: :ref:`int<class_int>`, width\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_gutter_width>`
  2043. Set the width of the gutter.
  2044. .. rst-class:: classref-item-separator
  2045. ----
  2046. .. _class_TextEdit_method_set_line:
  2047. .. rst-class:: classref-method
  2048. |void| **set_line**\ (\ line\: :ref:`int<class_int>`, new_text\: :ref:`String<class_String>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line>`
  2049. Sets the text for a specific ``line``.
  2050. Carets on the line will attempt to keep their visual x position.
  2051. .. rst-class:: classref-item-separator
  2052. ----
  2053. .. _class_TextEdit_method_set_line_as_center_visible:
  2054. .. rst-class:: classref-method
  2055. |void| **set_line_as_center_visible**\ (\ line\: :ref:`int<class_int>`, wrap_index\: :ref:`int<class_int>` = 0\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line_as_center_visible>`
  2056. Positions the ``wrap_index`` of ``line`` at the center of the viewport.
  2057. .. rst-class:: classref-item-separator
  2058. ----
  2059. .. _class_TextEdit_method_set_line_as_first_visible:
  2060. .. rst-class:: classref-method
  2061. |void| **set_line_as_first_visible**\ (\ line\: :ref:`int<class_int>`, wrap_index\: :ref:`int<class_int>` = 0\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line_as_first_visible>`
  2062. Positions the ``wrap_index`` of ``line`` at the top of the viewport.
  2063. .. rst-class:: classref-item-separator
  2064. ----
  2065. .. _class_TextEdit_method_set_line_as_last_visible:
  2066. .. rst-class:: classref-method
  2067. |void| **set_line_as_last_visible**\ (\ line\: :ref:`int<class_int>`, wrap_index\: :ref:`int<class_int>` = 0\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line_as_last_visible>`
  2068. Positions the ``wrap_index`` of ``line`` at the bottom of the viewport.
  2069. .. rst-class:: classref-item-separator
  2070. ----
  2071. .. _class_TextEdit_method_set_line_background_color:
  2072. .. rst-class:: classref-method
  2073. |void| **set_line_background_color**\ (\ line\: :ref:`int<class_int>`, color\: :ref:`Color<class_Color>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line_background_color>`
  2074. Sets the current background color of the line. Set to ``Color(0, 0, 0, 0)`` for no color.
  2075. .. rst-class:: classref-item-separator
  2076. ----
  2077. .. _class_TextEdit_method_set_line_gutter_clickable:
  2078. .. rst-class:: classref-method
  2079. |void| **set_line_gutter_clickable**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`, clickable\: :ref:`bool<class_bool>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line_gutter_clickable>`
  2080. If ``clickable`` is ``true``, makes the ``gutter`` on ``line`` clickable. See :ref:`gutter_clicked<class_TextEdit_signal_gutter_clicked>`.
  2081. .. rst-class:: classref-item-separator
  2082. ----
  2083. .. _class_TextEdit_method_set_line_gutter_icon:
  2084. .. rst-class:: classref-method
  2085. |void| **set_line_gutter_icon**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`, icon\: :ref:`Texture2D<class_Texture2D>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line_gutter_icon>`
  2086. 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>`).
  2087. .. rst-class:: classref-item-separator
  2088. ----
  2089. .. _class_TextEdit_method_set_line_gutter_item_color:
  2090. .. rst-class:: classref-method
  2091. |void| **set_line_gutter_item_color**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`, color\: :ref:`Color<class_Color>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line_gutter_item_color>`
  2092. Sets the color for ``gutter`` on ``line`` to ``color``.
  2093. .. rst-class:: classref-item-separator
  2094. ----
  2095. .. _class_TextEdit_method_set_line_gutter_metadata:
  2096. .. rst-class:: classref-method
  2097. |void| **set_line_gutter_metadata**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`, metadata\: :ref:`Variant<class_Variant>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line_gutter_metadata>`
  2098. Sets the metadata for ``gutter`` on ``line`` to ``metadata``.
  2099. .. rst-class:: classref-item-separator
  2100. ----
  2101. .. _class_TextEdit_method_set_line_gutter_text:
  2102. .. rst-class:: classref-method
  2103. |void| **set_line_gutter_text**\ (\ line\: :ref:`int<class_int>`, gutter\: :ref:`int<class_int>`, text\: :ref:`String<class_String>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_line_gutter_text>`
  2104. 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>`).
  2105. .. rst-class:: classref-item-separator
  2106. ----
  2107. .. _class_TextEdit_method_set_overtype_mode_enabled:
  2108. .. rst-class:: classref-method
  2109. |void| **set_overtype_mode_enabled**\ (\ enabled\: :ref:`bool<class_bool>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_overtype_mode_enabled>`
  2110. If ``true``, sets the user into overtype mode. When the user types in this mode, it will override existing text.
  2111. .. rst-class:: classref-item-separator
  2112. ----
  2113. .. _class_TextEdit_method_set_search_flags:
  2114. .. rst-class:: classref-method
  2115. |void| **set_search_flags**\ (\ flags\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_search_flags>`
  2116. 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.
  2117. .. rst-class:: classref-item-separator
  2118. ----
  2119. .. _class_TextEdit_method_set_search_text:
  2120. .. rst-class:: classref-method
  2121. |void| **set_search_text**\ (\ search_text\: :ref:`String<class_String>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_search_text>`
  2122. Sets the search text. See :ref:`set_search_flags<class_TextEdit_method_set_search_flags>`.
  2123. .. rst-class:: classref-item-separator
  2124. ----
  2125. .. _class_TextEdit_method_set_selection_mode:
  2126. .. rst-class:: classref-method
  2127. |void| **set_selection_mode**\ (\ mode\: :ref:`SelectionMode<enum_TextEdit_SelectionMode>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_selection_mode>`
  2128. Sets the current selection mode.
  2129. .. rst-class:: classref-item-separator
  2130. ----
  2131. .. _class_TextEdit_method_set_selection_origin_column:
  2132. .. rst-class:: classref-method
  2133. |void| **set_selection_origin_column**\ (\ column\: :ref:`int<class_int>`, caret_index\: :ref:`int<class_int>` = 0\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_selection_origin_column>`
  2134. Sets the selection origin column to the ``column`` for the given ``caret_index``. If the selection origin is moved to the caret position, the selection will deselect.
  2135. .. rst-class:: classref-item-separator
  2136. ----
  2137. .. _class_TextEdit_method_set_selection_origin_line:
  2138. .. rst-class:: classref-method
  2139. |void| **set_selection_origin_line**\ (\ line\: :ref:`int<class_int>`, can_be_hidden\: :ref:`bool<class_bool>` = true, wrap_index\: :ref:`int<class_int>` = -1, caret_index\: :ref:`int<class_int>` = 0\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_selection_origin_line>`
  2140. Sets the selection origin line to the ``line`` for the given ``caret_index``. If the selection origin is moved to the caret position, the selection will deselect.
  2141. If ``can_be_hidden`` is ``false``, The line will be set to the nearest unhidden line below or above.
  2142. If ``wrap_index`` is ``-1``, the selection origin column will be clamped to the ``line``'s length. If ``wrap_index`` is greater than ``-1``, the column will be moved to attempt to match the visual x position on the line's ``wrap_index`` to the position from the last time :ref:`set_selection_origin_column<class_TextEdit_method_set_selection_origin_column>` or :ref:`select<class_TextEdit_method_select>` was called.
  2143. .. rst-class:: classref-item-separator
  2144. ----
  2145. .. _class_TextEdit_method_set_tab_size:
  2146. .. rst-class:: classref-method
  2147. |void| **set_tab_size**\ (\ size\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_tab_size>`
  2148. Sets the tab size for the **TextEdit** to use.
  2149. .. rst-class:: classref-item-separator
  2150. ----
  2151. .. _class_TextEdit_method_set_tooltip_request_func:
  2152. .. rst-class:: classref-method
  2153. |void| **set_tooltip_request_func**\ (\ callback\: :ref:`Callable<class_Callable>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_set_tooltip_request_func>`
  2154. Provide custom tooltip text. The callback method must take the following args: ``hovered_word: String``.
  2155. .. rst-class:: classref-item-separator
  2156. ----
  2157. .. _class_TextEdit_method_skip_selection_for_next_occurrence:
  2158. .. rst-class:: classref-method
  2159. |void| **skip_selection_for_next_occurrence**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_skip_selection_for_next_occurrence>`
  2160. Moves a selection and a caret for the next occurrence of the current selection. If there is no active selection, moves to the next occurrence of the word under caret.
  2161. .. rst-class:: classref-item-separator
  2162. ----
  2163. .. _class_TextEdit_method_start_action:
  2164. .. rst-class:: classref-method
  2165. |void| **start_action**\ (\ action\: :ref:`EditAction<enum_TextEdit_EditAction>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_start_action>`
  2166. Starts an action, will end the current action if ``action`` is different.
  2167. 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.
  2168. .. rst-class:: classref-item-separator
  2169. ----
  2170. .. _class_TextEdit_method_swap_lines:
  2171. .. rst-class:: classref-method
  2172. |void| **swap_lines**\ (\ from_line\: :ref:`int<class_int>`, to_line\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_TextEdit_method_swap_lines>`
  2173. Swaps the two lines. Carets will be swapped with the lines.
  2174. .. rst-class:: classref-item-separator
  2175. ----
  2176. .. _class_TextEdit_method_tag_saved_version:
  2177. .. rst-class:: classref-method
  2178. |void| **tag_saved_version**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_tag_saved_version>`
  2179. Tag the current version as saved.
  2180. .. rst-class:: classref-item-separator
  2181. ----
  2182. .. _class_TextEdit_method_undo:
  2183. .. rst-class:: classref-method
  2184. |void| **undo**\ (\ ) :ref:`๐Ÿ”—<class_TextEdit_method_undo>`
  2185. Perform undo operation.
  2186. .. rst-class:: classref-section-separator
  2187. ----
  2188. .. rst-class:: classref-descriptions-group
  2189. Theme Property Descriptions
  2190. ---------------------------
  2191. .. _class_TextEdit_theme_color_background_color:
  2192. .. rst-class:: classref-themeproperty
  2193. :ref:`Color<class_Color>` **background_color** = ``Color(0, 0, 0, 0)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_background_color>`
  2194. Sets the background :ref:`Color<class_Color>` of this **TextEdit**.
  2195. .. rst-class:: classref-item-separator
  2196. ----
  2197. .. _class_TextEdit_theme_color_caret_background_color:
  2198. .. rst-class:: classref-themeproperty
  2199. :ref:`Color<class_Color>` **caret_background_color** = ``Color(0, 0, 0, 1)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_caret_background_color>`
  2200. :ref:`Color<class_Color>` of the text behind the caret when using a block caret.
  2201. .. rst-class:: classref-item-separator
  2202. ----
  2203. .. _class_TextEdit_theme_color_caret_color:
  2204. .. rst-class:: classref-themeproperty
  2205. :ref:`Color<class_Color>` **caret_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_caret_color>`
  2206. :ref:`Color<class_Color>` of the caret. This can be set to a fully transparent color to hide the caret entirely.
  2207. .. rst-class:: classref-item-separator
  2208. ----
  2209. .. _class_TextEdit_theme_color_current_line_color:
  2210. .. rst-class:: classref-themeproperty
  2211. :ref:`Color<class_Color>` **current_line_color** = ``Color(0.25, 0.25, 0.26, 0.8)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_current_line_color>`
  2212. Background :ref:`Color<class_Color>` of the line containing the caret.
  2213. .. rst-class:: classref-item-separator
  2214. ----
  2215. .. _class_TextEdit_theme_color_font_color:
  2216. .. rst-class:: classref-themeproperty
  2217. :ref:`Color<class_Color>` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_font_color>`
  2218. Sets the font :ref:`Color<class_Color>`.
  2219. .. rst-class:: classref-item-separator
  2220. ----
  2221. .. _class_TextEdit_theme_color_font_outline_color:
  2222. .. rst-class:: classref-themeproperty
  2223. :ref:`Color<class_Color>` **font_outline_color** = ``Color(0, 0, 0, 1)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_font_outline_color>`
  2224. The tint of text outline of the **TextEdit**.
  2225. .. rst-class:: classref-item-separator
  2226. ----
  2227. .. _class_TextEdit_theme_color_font_placeholder_color:
  2228. .. rst-class:: classref-themeproperty
  2229. :ref:`Color<class_Color>` **font_placeholder_color** = ``Color(0.875, 0.875, 0.875, 0.6)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_font_placeholder_color>`
  2230. Font color for :ref:`placeholder_text<class_TextEdit_property_placeholder_text>`.
  2231. .. rst-class:: classref-item-separator
  2232. ----
  2233. .. _class_TextEdit_theme_color_font_readonly_color:
  2234. .. rst-class:: classref-themeproperty
  2235. :ref:`Color<class_Color>` **font_readonly_color** = ``Color(0.875, 0.875, 0.875, 0.5)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_font_readonly_color>`
  2236. Sets the font :ref:`Color<class_Color>` when :ref:`editable<class_TextEdit_property_editable>` is disabled.
  2237. .. rst-class:: classref-item-separator
  2238. ----
  2239. .. _class_TextEdit_theme_color_font_selected_color:
  2240. .. rst-class:: classref-themeproperty
  2241. :ref:`Color<class_Color>` **font_selected_color** = ``Color(0, 0, 0, 0)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_font_selected_color>`
  2242. Sets the :ref:`Color<class_Color>` of the selected text. If equal to ``Color(0, 0, 0, 0)``, it will be ignored.
  2243. .. rst-class:: classref-item-separator
  2244. ----
  2245. .. _class_TextEdit_theme_color_search_result_border_color:
  2246. .. rst-class:: classref-themeproperty
  2247. :ref:`Color<class_Color>` **search_result_border_color** = ``Color(0.3, 0.3, 0.3, 0.4)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_search_result_border_color>`
  2248. :ref:`Color<class_Color>` of the border around text that matches the search query.
  2249. .. rst-class:: classref-item-separator
  2250. ----
  2251. .. _class_TextEdit_theme_color_search_result_color:
  2252. .. rst-class:: classref-themeproperty
  2253. :ref:`Color<class_Color>` **search_result_color** = ``Color(0.3, 0.3, 0.3, 1)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_search_result_color>`
  2254. :ref:`Color<class_Color>` behind the text that matches the search query.
  2255. .. rst-class:: classref-item-separator
  2256. ----
  2257. .. _class_TextEdit_theme_color_selection_color:
  2258. .. rst-class:: classref-themeproperty
  2259. :ref:`Color<class_Color>` **selection_color** = ``Color(0.5, 0.5, 0.5, 1)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_selection_color>`
  2260. Sets the highlight :ref:`Color<class_Color>` of text selections.
  2261. .. rst-class:: classref-item-separator
  2262. ----
  2263. .. _class_TextEdit_theme_color_word_highlighted_color:
  2264. .. rst-class:: classref-themeproperty
  2265. :ref:`Color<class_Color>` **word_highlighted_color** = ``Color(0.5, 0.5, 0.5, 0.25)`` :ref:`๐Ÿ”—<class_TextEdit_theme_color_word_highlighted_color>`
  2266. Sets the highlight :ref:`Color<class_Color>` of multiple occurrences. :ref:`highlight_all_occurrences<class_TextEdit_property_highlight_all_occurrences>` has to be enabled.
  2267. .. rst-class:: classref-item-separator
  2268. ----
  2269. .. _class_TextEdit_theme_constant_caret_width:
  2270. .. rst-class:: classref-themeproperty
  2271. :ref:`int<class_int>` **caret_width** = ``1`` :ref:`๐Ÿ”—<class_TextEdit_theme_constant_caret_width>`
  2272. 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.
  2273. .. rst-class:: classref-item-separator
  2274. ----
  2275. .. _class_TextEdit_theme_constant_line_spacing:
  2276. .. rst-class:: classref-themeproperty
  2277. :ref:`int<class_int>` **line_spacing** = ``4`` :ref:`๐Ÿ”—<class_TextEdit_theme_constant_line_spacing>`
  2278. Sets the spacing between the lines.
  2279. .. rst-class:: classref-item-separator
  2280. ----
  2281. .. _class_TextEdit_theme_constant_outline_size:
  2282. .. rst-class:: classref-themeproperty
  2283. :ref:`int<class_int>` **outline_size** = ``0`` :ref:`๐Ÿ”—<class_TextEdit_theme_constant_outline_size>`
  2284. The size of the text outline.
  2285. \ **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.
  2286. .. rst-class:: classref-item-separator
  2287. ----
  2288. .. _class_TextEdit_theme_font_font:
  2289. .. rst-class:: classref-themeproperty
  2290. :ref:`Font<class_Font>` **font** :ref:`๐Ÿ”—<class_TextEdit_theme_font_font>`
  2291. Sets the default :ref:`Font<class_Font>`.
  2292. .. rst-class:: classref-item-separator
  2293. ----
  2294. .. _class_TextEdit_theme_font_size_font_size:
  2295. .. rst-class:: classref-themeproperty
  2296. :ref:`int<class_int>` **font_size** :ref:`๐Ÿ”—<class_TextEdit_theme_font_size_font_size>`
  2297. Sets default font size.
  2298. .. rst-class:: classref-item-separator
  2299. ----
  2300. .. _class_TextEdit_theme_icon_space:
  2301. .. rst-class:: classref-themeproperty
  2302. :ref:`Texture2D<class_Texture2D>` **space** :ref:`๐Ÿ”—<class_TextEdit_theme_icon_space>`
  2303. Sets a custom :ref:`Texture2D<class_Texture2D>` for space text characters.
  2304. .. rst-class:: classref-item-separator
  2305. ----
  2306. .. _class_TextEdit_theme_icon_tab:
  2307. .. rst-class:: classref-themeproperty
  2308. :ref:`Texture2D<class_Texture2D>` **tab** :ref:`๐Ÿ”—<class_TextEdit_theme_icon_tab>`
  2309. Sets a custom :ref:`Texture2D<class_Texture2D>` for tab text characters.
  2310. .. rst-class:: classref-item-separator
  2311. ----
  2312. .. _class_TextEdit_theme_style_focus:
  2313. .. rst-class:: classref-themeproperty
  2314. :ref:`StyleBox<class_StyleBox>` **focus** :ref:`๐Ÿ”—<class_TextEdit_theme_style_focus>`
  2315. 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.
  2316. .. rst-class:: classref-item-separator
  2317. ----
  2318. .. _class_TextEdit_theme_style_normal:
  2319. .. rst-class:: classref-themeproperty
  2320. :ref:`StyleBox<class_StyleBox>` **normal** :ref:`๐Ÿ”—<class_TextEdit_theme_style_normal>`
  2321. Sets the :ref:`StyleBox<class_StyleBox>` of this **TextEdit**.
  2322. .. rst-class:: classref-item-separator
  2323. ----
  2324. .. _class_TextEdit_theme_style_read_only:
  2325. .. rst-class:: classref-themeproperty
  2326. :ref:`StyleBox<class_StyleBox>` **read_only** :ref:`๐Ÿ”—<class_TextEdit_theme_style_read_only>`
  2327. Sets the :ref:`StyleBox<class_StyleBox>` of this **TextEdit** when :ref:`editable<class_TextEdit_property_editable>` is disabled.
  2328. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  2329. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  2330. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  2331. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  2332. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  2333. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  2334. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  2335. .. |void| replace:: :abbr:`void (No return value.)`