class_codeedit.rst 118 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/CodeEdit.xml.
  6. .. _class_CodeEdit:
  7. CodeEdit
  8. ========
  9. **Inherits:** :ref:`TextEdit<class_TextEdit>` **<** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  10. Multiline text control intended for editing code.
  11. Description
  12. -----------
  13. CodeEdit is a specialised :ref:`TextEdit<class_TextEdit>` designed for editing plain text code files. It contains a bunch of features commonly found in code editors such as line numbers, line folding, code completion, indent management and string / comment management.
  14. \ **Note:** By default ``CodeEdit`` always use left-to-right text direction to correctly display source code.
  15. Properties
  16. ----------
  17. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  18. | :ref:`bool<class_bool>` | :ref:`auto_brace_completion_enabled<class_CodeEdit_property_auto_brace_completion_enabled>` | ``false`` |
  19. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  20. | :ref:`bool<class_bool>` | :ref:`auto_brace_completion_highlight_matching<class_CodeEdit_property_auto_brace_completion_highlight_matching>` | ``false`` |
  21. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  22. | :ref:`Dictionary<class_Dictionary>` | :ref:`auto_brace_completion_pairs<class_CodeEdit_property_auto_brace_completion_pairs>` | ``{ "\"": "\"", "'": "'", "(": ")", "[": "]", "{": "}" }`` |
  23. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  24. | :ref:`bool<class_bool>` | :ref:`code_completion_enabled<class_CodeEdit_property_code_completion_enabled>` | ``false`` |
  25. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  26. | :ref:`String[]<class_String>` | :ref:`code_completion_prefixes<class_CodeEdit_property_code_completion_prefixes>` | ``[]`` |
  27. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  28. | :ref:`String[]<class_String>` | :ref:`delimiter_comments<class_CodeEdit_property_delimiter_comments>` | ``[]`` |
  29. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  30. | :ref:`String[]<class_String>` | :ref:`delimiter_strings<class_CodeEdit_property_delimiter_strings>` | ``["' '", "\" \""]`` |
  31. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  32. | :ref:`bool<class_bool>` | :ref:`gutters_draw_bookmarks<class_CodeEdit_property_gutters_draw_bookmarks>` | ``false`` |
  33. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  34. | :ref:`bool<class_bool>` | :ref:`gutters_draw_breakpoints_gutter<class_CodeEdit_property_gutters_draw_breakpoints_gutter>` | ``false`` |
  35. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  36. | :ref:`bool<class_bool>` | :ref:`gutters_draw_executing_lines<class_CodeEdit_property_gutters_draw_executing_lines>` | ``false`` |
  37. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  38. | :ref:`bool<class_bool>` | :ref:`gutters_draw_fold_gutter<class_CodeEdit_property_gutters_draw_fold_gutter>` | ``false`` |
  39. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  40. | :ref:`bool<class_bool>` | :ref:`gutters_draw_line_numbers<class_CodeEdit_property_gutters_draw_line_numbers>` | ``false`` |
  41. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  42. | :ref:`bool<class_bool>` | :ref:`gutters_zero_pad_line_numbers<class_CodeEdit_property_gutters_zero_pad_line_numbers>` | ``false`` |
  43. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  44. | :ref:`bool<class_bool>` | :ref:`indent_automatic<class_CodeEdit_property_indent_automatic>` | ``false`` |
  45. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  46. | :ref:`String[]<class_String>` | :ref:`indent_automatic_prefixes<class_CodeEdit_property_indent_automatic_prefixes>` | ``[":", "{", "[", "("]`` |
  47. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  48. | :ref:`int<class_int>` | :ref:`indent_size<class_CodeEdit_property_indent_size>` | ``4`` |
  49. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  50. | :ref:`bool<class_bool>` | :ref:`indent_use_spaces<class_CodeEdit_property_indent_use_spaces>` | ``false`` |
  51. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  52. | :ref:`LayoutDirection<enum_Control_LayoutDirection>` | layout_direction | ``2`` (overrides :ref:`Control<class_Control_property_layout_direction>`) |
  53. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  54. | :ref:`bool<class_bool>` | :ref:`line_folding<class_CodeEdit_property_line_folding>` | ``false`` |
  55. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  56. | :ref:`int[]<class_int>` | :ref:`line_length_guidelines<class_CodeEdit_property_line_length_guidelines>` | ``[]`` |
  57. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  58. | :ref:`bool<class_bool>` | :ref:`symbol_lookup_on_click<class_CodeEdit_property_symbol_lookup_on_click>` | ``false`` |
  59. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  60. | :ref:`TextDirection<enum_Control_TextDirection>` | text_direction | ``1`` (overrides :ref:`TextEdit<class_TextEdit_property_text_direction>`) |
  61. +------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  62. Methods
  63. -------
  64. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  65. | void | :ref:`_confirm_code_completion<class_CodeEdit_method__confirm_code_completion>` **(** :ref:`bool<class_bool>` replace **)** |virtual| |
  66. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  67. | :ref:`Array<class_Array>` | :ref:`_filter_code_completion_candidates<class_CodeEdit_method__filter_code_completion_candidates>` **(** :ref:`Dictionary[]<class_Dictionary>` candidates **)** |virtual| |const| |
  68. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  69. | void | :ref:`_request_code_completion<class_CodeEdit_method__request_code_completion>` **(** :ref:`bool<class_bool>` force **)** |virtual| |
  70. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  71. | void | :ref:`add_auto_brace_completion_pair<class_CodeEdit_method_add_auto_brace_completion_pair>` **(** :ref:`String<class_String>` start_key, :ref:`String<class_String>` end_key **)** |
  72. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  73. | void | :ref:`add_code_completion_option<class_CodeEdit_method_add_code_completion_option>` **(** :ref:`CodeCompletionKind<enum_CodeEdit_CodeCompletionKind>` type, :ref:`String<class_String>` display_text, :ref:`String<class_String>` insert_text, :ref:`Color<class_Color>` text_color=Color(1, 1, 1, 1), :ref:`Resource<class_Resource>` icon=null, :ref:`Variant<class_Variant>` value=0 **)** |
  74. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  75. | void | :ref:`add_comment_delimiter<class_CodeEdit_method_add_comment_delimiter>` **(** :ref:`String<class_String>` start_key, :ref:`String<class_String>` end_key, :ref:`bool<class_bool>` line_only=false **)** |
  76. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  77. | void | :ref:`add_string_delimiter<class_CodeEdit_method_add_string_delimiter>` **(** :ref:`String<class_String>` start_key, :ref:`String<class_String>` end_key, :ref:`bool<class_bool>` line_only=false **)** |
  78. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  79. | :ref:`bool<class_bool>` | :ref:`can_fold_line<class_CodeEdit_method_can_fold_line>` **(** :ref:`int<class_int>` line **)** |const| |
  80. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  81. | void | :ref:`cancel_code_completion<class_CodeEdit_method_cancel_code_completion>` **(** **)** |
  82. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  83. | void | :ref:`clear_bookmarked_lines<class_CodeEdit_method_clear_bookmarked_lines>` **(** **)** |
  84. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  85. | void | :ref:`clear_breakpointed_lines<class_CodeEdit_method_clear_breakpointed_lines>` **(** **)** |
  86. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  87. | void | :ref:`clear_comment_delimiters<class_CodeEdit_method_clear_comment_delimiters>` **(** **)** |
  88. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  89. | void | :ref:`clear_executing_lines<class_CodeEdit_method_clear_executing_lines>` **(** **)** |
  90. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  91. | void | :ref:`clear_string_delimiters<class_CodeEdit_method_clear_string_delimiters>` **(** **)** |
  92. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  93. | void | :ref:`confirm_code_completion<class_CodeEdit_method_confirm_code_completion>` **(** :ref:`bool<class_bool>` replace=false **)** |
  94. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  95. | void | :ref:`do_indent<class_CodeEdit_method_do_indent>` **(** **)** |
  96. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  97. | void | :ref:`do_unindent<class_CodeEdit_method_do_unindent>` **(** **)** |
  98. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  99. | void | :ref:`fold_all_lines<class_CodeEdit_method_fold_all_lines>` **(** **)** |
  100. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  101. | void | :ref:`fold_line<class_CodeEdit_method_fold_line>` **(** :ref:`int<class_int>` line **)** |
  102. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  103. | :ref:`String<class_String>` | :ref:`get_auto_brace_completion_close_key<class_CodeEdit_method_get_auto_brace_completion_close_key>` **(** :ref:`String<class_String>` open_key **)** |const| |
  104. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  105. | :ref:`Array<class_Array>` | :ref:`get_bookmarked_lines<class_CodeEdit_method_get_bookmarked_lines>` **(** **)** |const| |
  106. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  107. | :ref:`Array<class_Array>` | :ref:`get_breakpointed_lines<class_CodeEdit_method_get_breakpointed_lines>` **(** **)** |const| |
  108. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  109. | :ref:`Dictionary<class_Dictionary>` | :ref:`get_code_completion_option<class_CodeEdit_method_get_code_completion_option>` **(** :ref:`int<class_int>` index **)** |const| |
  110. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  111. | :ref:`Dictionary[]<class_Dictionary>` | :ref:`get_code_completion_options<class_CodeEdit_method_get_code_completion_options>` **(** **)** |const| |
  112. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  113. | :ref:`int<class_int>` | :ref:`get_code_completion_selected_index<class_CodeEdit_method_get_code_completion_selected_index>` **(** **)** |const| |
  114. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  115. | :ref:`String<class_String>` | :ref:`get_delimiter_end_key<class_CodeEdit_method_get_delimiter_end_key>` **(** :ref:`int<class_int>` delimiter_index **)** |const| |
  116. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  117. | :ref:`Vector2<class_Vector2>` | :ref:`get_delimiter_end_position<class_CodeEdit_method_get_delimiter_end_position>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const| |
  118. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  119. | :ref:`String<class_String>` | :ref:`get_delimiter_start_key<class_CodeEdit_method_get_delimiter_start_key>` **(** :ref:`int<class_int>` delimiter_index **)** |const| |
  120. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  121. | :ref:`Vector2<class_Vector2>` | :ref:`get_delimiter_start_position<class_CodeEdit_method_get_delimiter_start_position>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const| |
  122. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  123. | :ref:`Array<class_Array>` | :ref:`get_executing_lines<class_CodeEdit_method_get_executing_lines>` **(** **)** |const| |
  124. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  125. | :ref:`int[]<class_int>` | :ref:`get_folded_lines<class_CodeEdit_method_get_folded_lines>` **(** **)** |const| |
  126. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  127. | :ref:`String<class_String>` | :ref:`get_text_for_code_completion<class_CodeEdit_method_get_text_for_code_completion>` **(** **)** |const| |
  128. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  129. | :ref:`String<class_String>` | :ref:`get_text_for_symbol_lookup<class_CodeEdit_method_get_text_for_symbol_lookup>` **(** **)** |
  130. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  131. | :ref:`bool<class_bool>` | :ref:`has_auto_brace_completion_close_key<class_CodeEdit_method_has_auto_brace_completion_close_key>` **(** :ref:`String<class_String>` close_key **)** |const| |
  132. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  133. | :ref:`bool<class_bool>` | :ref:`has_auto_brace_completion_open_key<class_CodeEdit_method_has_auto_brace_completion_open_key>` **(** :ref:`String<class_String>` open_key **)** |const| |
  134. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  135. | :ref:`bool<class_bool>` | :ref:`has_comment_delimiter<class_CodeEdit_method_has_comment_delimiter>` **(** :ref:`String<class_String>` start_key **)** |const| |
  136. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  137. | :ref:`bool<class_bool>` | :ref:`has_string_delimiter<class_CodeEdit_method_has_string_delimiter>` **(** :ref:`String<class_String>` start_key **)** |const| |
  138. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  139. | void | :ref:`indent_lines<class_CodeEdit_method_indent_lines>` **(** **)** |
  140. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  141. | :ref:`int<class_int>` | :ref:`is_in_comment<class_CodeEdit_method_is_in_comment>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column=-1 **)** |const| |
  142. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  143. | :ref:`int<class_int>` | :ref:`is_in_string<class_CodeEdit_method_is_in_string>` **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column=-1 **)** |const| |
  144. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  145. | :ref:`bool<class_bool>` | :ref:`is_line_bookmarked<class_CodeEdit_method_is_line_bookmarked>` **(** :ref:`int<class_int>` line **)** |const| |
  146. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  147. | :ref:`bool<class_bool>` | :ref:`is_line_breakpointed<class_CodeEdit_method_is_line_breakpointed>` **(** :ref:`int<class_int>` line **)** |const| |
  148. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  149. | :ref:`bool<class_bool>` | :ref:`is_line_executing<class_CodeEdit_method_is_line_executing>` **(** :ref:`int<class_int>` line **)** |const| |
  150. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  151. | :ref:`bool<class_bool>` | :ref:`is_line_folded<class_CodeEdit_method_is_line_folded>` **(** :ref:`int<class_int>` line **)** |const| |
  152. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  153. | void | :ref:`remove_comment_delimiter<class_CodeEdit_method_remove_comment_delimiter>` **(** :ref:`String<class_String>` start_key **)** |
  154. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  155. | void | :ref:`remove_string_delimiter<class_CodeEdit_method_remove_string_delimiter>` **(** :ref:`String<class_String>` start_key **)** |
  156. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  157. | void | :ref:`request_code_completion<class_CodeEdit_method_request_code_completion>` **(** :ref:`bool<class_bool>` force=false **)** |
  158. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  159. | void | :ref:`set_code_completion_selected_index<class_CodeEdit_method_set_code_completion_selected_index>` **(** :ref:`int<class_int>` index **)** |
  160. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  161. | void | :ref:`set_code_hint<class_CodeEdit_method_set_code_hint>` **(** :ref:`String<class_String>` code_hint **)** |
  162. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  163. | void | :ref:`set_code_hint_draw_below<class_CodeEdit_method_set_code_hint_draw_below>` **(** :ref:`bool<class_bool>` draw_below **)** |
  164. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  165. | void | :ref:`set_line_as_bookmarked<class_CodeEdit_method_set_line_as_bookmarked>` **(** :ref:`int<class_int>` line, :ref:`bool<class_bool>` bookmarked **)** |
  166. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  167. | void | :ref:`set_line_as_breakpoint<class_CodeEdit_method_set_line_as_breakpoint>` **(** :ref:`int<class_int>` line, :ref:`bool<class_bool>` breakpointed **)** |
  168. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  169. | void | :ref:`set_line_as_executing<class_CodeEdit_method_set_line_as_executing>` **(** :ref:`int<class_int>` line, :ref:`bool<class_bool>` executing **)** |
  170. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  171. | void | :ref:`set_symbol_lookup_word_as_valid<class_CodeEdit_method_set_symbol_lookup_word_as_valid>` **(** :ref:`bool<class_bool>` valid **)** |
  172. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  173. | void | :ref:`toggle_foldable_line<class_CodeEdit_method_toggle_foldable_line>` **(** :ref:`int<class_int>` line **)** |
  174. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  175. | void | :ref:`unfold_all_lines<class_CodeEdit_method_unfold_all_lines>` **(** **)** |
  176. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  177. | void | :ref:`unfold_line<class_CodeEdit_method_unfold_line>` **(** :ref:`int<class_int>` line **)** |
  178. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  179. | void | :ref:`unindent_lines<class_CodeEdit_method_unindent_lines>` **(** **)** |
  180. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  181. | void | :ref:`update_code_completion_options<class_CodeEdit_method_update_code_completion_options>` **(** :ref:`bool<class_bool>` force **)** |
  182. +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  183. Theme Properties
  184. ----------------
  185. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  186. | :ref:`Color<class_Color>` | :ref:`background_color<class_CodeEdit_theme_color_background_color>` | ``Color(0, 0, 0, 0)`` |
  187. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  188. | :ref:`Color<class_Color>` | :ref:`bookmark_color<class_CodeEdit_theme_color_bookmark_color>` | ``Color(0.5, 0.64, 1, 0.8)`` |
  189. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  190. | :ref:`Color<class_Color>` | :ref:`brace_mismatch_color<class_CodeEdit_theme_color_brace_mismatch_color>` | ``Color(1, 0.2, 0.2, 1)`` |
  191. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  192. | :ref:`Color<class_Color>` | :ref:`breakpoint_color<class_CodeEdit_theme_color_breakpoint_color>` | ``Color(0.9, 0.29, 0.3, 1)`` |
  193. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  194. | :ref:`Color<class_Color>` | :ref:`caret_background_color<class_CodeEdit_theme_color_caret_background_color>` | ``Color(0, 0, 0, 1)`` |
  195. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  196. | :ref:`Color<class_Color>` | :ref:`caret_color<class_CodeEdit_theme_color_caret_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  197. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  198. | :ref:`Color<class_Color>` | :ref:`code_folding_color<class_CodeEdit_theme_color_code_folding_color>` | ``Color(0.8, 0.8, 0.8, 0.8)`` |
  199. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  200. | :ref:`Color<class_Color>` | :ref:`completion_background_color<class_CodeEdit_theme_color_completion_background_color>` | ``Color(0.17, 0.16, 0.2, 1)`` |
  201. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  202. | :ref:`Color<class_Color>` | :ref:`completion_existing_color<class_CodeEdit_theme_color_completion_existing_color>` | ``Color(0.87, 0.87, 0.87, 0.13)`` |
  203. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  204. | :ref:`Color<class_Color>` | :ref:`completion_font_color<class_CodeEdit_theme_color_completion_font_color>` | ``Color(0.67, 0.67, 0.67, 1)`` |
  205. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  206. | :ref:`Color<class_Color>` | :ref:`completion_scroll_color<class_CodeEdit_theme_color_completion_scroll_color>` | ``Color(1, 1, 1, 0.29)`` |
  207. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  208. | :ref:`Color<class_Color>` | :ref:`completion_scroll_hovered_color<class_CodeEdit_theme_color_completion_scroll_hovered_color>` | ``Color(1, 1, 1, 0.4)`` |
  209. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  210. | :ref:`Color<class_Color>` | :ref:`completion_selected_color<class_CodeEdit_theme_color_completion_selected_color>` | ``Color(0.26, 0.26, 0.27, 1)`` |
  211. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  212. | :ref:`Color<class_Color>` | :ref:`current_line_color<class_CodeEdit_theme_color_current_line_color>` | ``Color(0.25, 0.25, 0.26, 0.8)`` |
  213. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  214. | :ref:`Color<class_Color>` | :ref:`executing_line_color<class_CodeEdit_theme_color_executing_line_color>` | ``Color(0.98, 0.89, 0.27, 1)`` |
  215. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  216. | :ref:`Color<class_Color>` | :ref:`font_color<class_CodeEdit_theme_color_font_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  217. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  218. | :ref:`Color<class_Color>` | :ref:`font_outline_color<class_CodeEdit_theme_color_font_outline_color>` | ``Color(1, 1, 1, 1)`` |
  219. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  220. | :ref:`Color<class_Color>` | :ref:`font_placeholder_color<class_CodeEdit_theme_color_font_placeholder_color>` | ``Color(0.875, 0.875, 0.875, 0.6)`` |
  221. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  222. | :ref:`Color<class_Color>` | :ref:`font_readonly_color<class_CodeEdit_theme_color_font_readonly_color>` | ``Color(0.875, 0.875, 0.875, 0.5)`` |
  223. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  224. | :ref:`Color<class_Color>` | :ref:`font_selected_color<class_CodeEdit_theme_color_font_selected_color>` | ``Color(0, 0, 0, 1)`` |
  225. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  226. | :ref:`Color<class_Color>` | :ref:`line_length_guideline_color<class_CodeEdit_theme_color_line_length_guideline_color>` | ``Color(0.3, 0.5, 0.8, 0.1)`` |
  227. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  228. | :ref:`Color<class_Color>` | :ref:`line_number_color<class_CodeEdit_theme_color_line_number_color>` | ``Color(0.67, 0.67, 0.67, 0.4)`` |
  229. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  230. | :ref:`Color<class_Color>` | :ref:`search_result_border_color<class_CodeEdit_theme_color_search_result_border_color>` | ``Color(0.3, 0.3, 0.3, 0.4)`` |
  231. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  232. | :ref:`Color<class_Color>` | :ref:`search_result_color<class_CodeEdit_theme_color_search_result_color>` | ``Color(0.3, 0.3, 0.3, 1)`` |
  233. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  234. | :ref:`Color<class_Color>` | :ref:`selection_color<class_CodeEdit_theme_color_selection_color>` | ``Color(0.5, 0.5, 0.5, 1)`` |
  235. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  236. | :ref:`Color<class_Color>` | :ref:`word_highlighted_color<class_CodeEdit_theme_color_word_highlighted_color>` | ``Color(0.8, 0.9, 0.9, 0.15)`` |
  237. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  238. | :ref:`int<class_int>` | :ref:`completion_lines<class_CodeEdit_theme_constant_completion_lines>` | ``7`` |
  239. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  240. | :ref:`int<class_int>` | :ref:`completion_max_width<class_CodeEdit_theme_constant_completion_max_width>` | ``50`` |
  241. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  242. | :ref:`int<class_int>` | :ref:`completion_scroll_width<class_CodeEdit_theme_constant_completion_scroll_width>` | ``6`` |
  243. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  244. | :ref:`int<class_int>` | :ref:`line_spacing<class_CodeEdit_theme_constant_line_spacing>` | ``4`` |
  245. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  246. | :ref:`int<class_int>` | :ref:`outline_size<class_CodeEdit_theme_constant_outline_size>` | ``0`` |
  247. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  248. | :ref:`Font<class_Font>` | :ref:`font<class_CodeEdit_theme_font_font>` | |
  249. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  250. | :ref:`int<class_int>` | :ref:`font_size<class_CodeEdit_theme_font_size_font_size>` | |
  251. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  252. | :ref:`Texture2D<class_Texture2D>` | :ref:`bookmark<class_CodeEdit_theme_icon_bookmark>` | |
  253. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  254. | :ref:`Texture2D<class_Texture2D>` | :ref:`breakpoint<class_CodeEdit_theme_icon_breakpoint>` | |
  255. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  256. | :ref:`Texture2D<class_Texture2D>` | :ref:`can_fold<class_CodeEdit_theme_icon_can_fold>` | |
  257. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  258. | :ref:`Texture2D<class_Texture2D>` | :ref:`executing_line<class_CodeEdit_theme_icon_executing_line>` | |
  259. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  260. | :ref:`Texture2D<class_Texture2D>` | :ref:`folded<class_CodeEdit_theme_icon_folded>` | |
  261. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  262. | :ref:`Texture2D<class_Texture2D>` | :ref:`folded_eol_icon<class_CodeEdit_theme_icon_folded_eol_icon>` | |
  263. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  264. | :ref:`Texture2D<class_Texture2D>` | :ref:`space<class_CodeEdit_theme_icon_space>` | |
  265. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  266. | :ref:`Texture2D<class_Texture2D>` | :ref:`tab<class_CodeEdit_theme_icon_tab>` | |
  267. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  268. | :ref:`StyleBox<class_StyleBox>` | :ref:`completion<class_CodeEdit_theme_style_completion>` | |
  269. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  270. | :ref:`StyleBox<class_StyleBox>` | :ref:`focus<class_CodeEdit_theme_style_focus>` | |
  271. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  272. | :ref:`StyleBox<class_StyleBox>` | :ref:`normal<class_CodeEdit_theme_style_normal>` | |
  273. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  274. | :ref:`StyleBox<class_StyleBox>` | :ref:`read_only<class_CodeEdit_theme_style_read_only>` | |
  275. +-----------------------------------+----------------------------------------------------------------------------------------------------+-------------------------------------+
  276. Signals
  277. -------
  278. .. _class_CodeEdit_signal_breakpoint_toggled:
  279. - **breakpoint_toggled** **(** :ref:`int<class_int>` line **)**
  280. Emitted when a breakpoint is added or removed from a line. If the line is moved via backspace a removed is emitted at the old line.
  281. ----
  282. .. _class_CodeEdit_signal_code_completion_requested:
  283. - **code_completion_requested** **(** **)**
  284. Emitted when the user requests code completion.
  285. ----
  286. .. _class_CodeEdit_signal_symbol_lookup:
  287. - **symbol_lookup** **(** :ref:`String<class_String>` symbol, :ref:`int<class_int>` line, :ref:`int<class_int>` column **)**
  288. Emitted when the user has clicked on a valid symbol.
  289. ----
  290. .. _class_CodeEdit_signal_symbol_validate:
  291. - **symbol_validate** **(** :ref:`String<class_String>` symbol **)**
  292. Emitted when the user hovers over a symbol. The symbol should be validated and responded to, by calling :ref:`set_symbol_lookup_word_as_valid<class_CodeEdit_method_set_symbol_lookup_word_as_valid>`.
  293. Enumerations
  294. ------------
  295. .. _enum_CodeEdit_CodeCompletionKind:
  296. .. _class_CodeEdit_constant_KIND_CLASS:
  297. .. _class_CodeEdit_constant_KIND_FUNCTION:
  298. .. _class_CodeEdit_constant_KIND_SIGNAL:
  299. .. _class_CodeEdit_constant_KIND_VARIABLE:
  300. .. _class_CodeEdit_constant_KIND_MEMBER:
  301. .. _class_CodeEdit_constant_KIND_ENUM:
  302. .. _class_CodeEdit_constant_KIND_CONSTANT:
  303. .. _class_CodeEdit_constant_KIND_NODE_PATH:
  304. .. _class_CodeEdit_constant_KIND_FILE_PATH:
  305. .. _class_CodeEdit_constant_KIND_PLAIN_TEXT:
  306. enum **CodeCompletionKind**:
  307. - **KIND_CLASS** = **0** --- Marks the option as a class.
  308. - **KIND_FUNCTION** = **1** --- Marks the option as a function.
  309. - **KIND_SIGNAL** = **2** --- Marks the option as a Godot signal.
  310. - **KIND_VARIABLE** = **3** --- Marks the option as a variable.
  311. - **KIND_MEMBER** = **4** --- Marks the option as a member.
  312. - **KIND_ENUM** = **5** --- Marks the option as a enum entry.
  313. - **KIND_CONSTANT** = **6** --- Marks the option as a constant.
  314. - **KIND_NODE_PATH** = **7** --- Marks the option as a Godot node path.
  315. - **KIND_FILE_PATH** = **8** --- Marks the option as a file path.
  316. - **KIND_PLAIN_TEXT** = **9** --- Marks the option as unclassified or plain text.
  317. Property Descriptions
  318. ---------------------
  319. .. _class_CodeEdit_property_auto_brace_completion_enabled:
  320. - :ref:`bool<class_bool>` **auto_brace_completion_enabled**
  321. +-----------+------------------------------------------+
  322. | *Default* | ``false`` |
  323. +-----------+------------------------------------------+
  324. | *Setter* | set_auto_brace_completion_enabled(value) |
  325. +-----------+------------------------------------------+
  326. | *Getter* | is_auto_brace_completion_enabled() |
  327. +-----------+------------------------------------------+
  328. Sets whether brace pairs should be autocompleted.
  329. ----
  330. .. _class_CodeEdit_property_auto_brace_completion_highlight_matching:
  331. - :ref:`bool<class_bool>` **auto_brace_completion_highlight_matching**
  332. +-----------+----------------------------------------------+
  333. | *Default* | ``false`` |
  334. +-----------+----------------------------------------------+
  335. | *Setter* | set_highlight_matching_braces_enabled(value) |
  336. +-----------+----------------------------------------------+
  337. | *Getter* | is_highlight_matching_braces_enabled() |
  338. +-----------+----------------------------------------------+
  339. Highlight mismatching brace pairs.
  340. ----
  341. .. _class_CodeEdit_property_auto_brace_completion_pairs:
  342. - :ref:`Dictionary<class_Dictionary>` **auto_brace_completion_pairs**
  343. +-----------+------------------------------------------------------------+
  344. | *Default* | ``{ "\"": "\"", "'": "'", "(": ")", "[": "]", "{": "}" }`` |
  345. +-----------+------------------------------------------------------------+
  346. | *Setter* | set_auto_brace_completion_pairs(value) |
  347. +-----------+------------------------------------------------------------+
  348. | *Getter* | get_auto_brace_completion_pairs() |
  349. +-----------+------------------------------------------------------------+
  350. Sets the brace pairs to be autocompleted.
  351. ----
  352. .. _class_CodeEdit_property_code_completion_enabled:
  353. - :ref:`bool<class_bool>` **code_completion_enabled**
  354. +-----------+------------------------------------+
  355. | *Default* | ``false`` |
  356. +-----------+------------------------------------+
  357. | *Setter* | set_code_completion_enabled(value) |
  358. +-----------+------------------------------------+
  359. | *Getter* | is_code_completion_enabled() |
  360. +-----------+------------------------------------+
  361. Sets whether code completion is allowed.
  362. ----
  363. .. _class_CodeEdit_property_code_completion_prefixes:
  364. - :ref:`String[]<class_String>` **code_completion_prefixes**
  365. +-----------+-------------------------------------+
  366. | *Default* | ``[]`` |
  367. +-----------+-------------------------------------+
  368. | *Setter* | set_code_completion_prefixes(value) |
  369. +-----------+-------------------------------------+
  370. | *Getter* | get_code_comletion_prefixes() |
  371. +-----------+-------------------------------------+
  372. Sets prefixes that will trigger code completion.
  373. ----
  374. .. _class_CodeEdit_property_delimiter_comments:
  375. - :ref:`String[]<class_String>` **delimiter_comments**
  376. +-----------+-------------------------------+
  377. | *Default* | ``[]`` |
  378. +-----------+-------------------------------+
  379. | *Setter* | set_comment_delimiters(value) |
  380. +-----------+-------------------------------+
  381. | *Getter* | get_comment_delimiters() |
  382. +-----------+-------------------------------+
  383. Sets the comment delimiters. All existing comment delimiters will be removed.
  384. ----
  385. .. _class_CodeEdit_property_delimiter_strings:
  386. - :ref:`String[]<class_String>` **delimiter_strings**
  387. +-----------+------------------------------+
  388. | *Default* | ``["' '", "\" \""]`` |
  389. +-----------+------------------------------+
  390. | *Setter* | set_string_delimiters(value) |
  391. +-----------+------------------------------+
  392. | *Getter* | get_string_delimiters() |
  393. +-----------+------------------------------+
  394. Sets the string delimiters. All existing string delimiters will be removed.
  395. ----
  396. .. _class_CodeEdit_property_gutters_draw_bookmarks:
  397. - :ref:`bool<class_bool>` **gutters_draw_bookmarks**
  398. +-----------+----------------------------------+
  399. | *Default* | ``false`` |
  400. +-----------+----------------------------------+
  401. | *Setter* | set_draw_bookmarks_gutter(value) |
  402. +-----------+----------------------------------+
  403. | *Getter* | is_drawing_bookmarks_gutter() |
  404. +-----------+----------------------------------+
  405. Sets if bookmarked should be drawn in the gutter. This gutter is shared with breakpoints and executing lines.
  406. ----
  407. .. _class_CodeEdit_property_gutters_draw_breakpoints_gutter:
  408. - :ref:`bool<class_bool>` **gutters_draw_breakpoints_gutter**
  409. +-----------+------------------------------------+
  410. | *Default* | ``false`` |
  411. +-----------+------------------------------------+
  412. | *Setter* | set_draw_breakpoints_gutter(value) |
  413. +-----------+------------------------------------+
  414. | *Getter* | is_drawing_breakpoints_gutter() |
  415. +-----------+------------------------------------+
  416. Sets if breakpoints should be drawn in the gutter. This gutter is shared with bookmarks and executing lines.
  417. ----
  418. .. _class_CodeEdit_property_gutters_draw_executing_lines:
  419. - :ref:`bool<class_bool>` **gutters_draw_executing_lines**
  420. +-----------+----------------------------------------+
  421. | *Default* | ``false`` |
  422. +-----------+----------------------------------------+
  423. | *Setter* | set_draw_executing_lines_gutter(value) |
  424. +-----------+----------------------------------------+
  425. | *Getter* | is_drawing_executing_lines_gutter() |
  426. +-----------+----------------------------------------+
  427. Sets if executing lines should be marked in the gutter. This gutter is shared with breakpoints and bookmarks lines.
  428. ----
  429. .. _class_CodeEdit_property_gutters_draw_fold_gutter:
  430. - :ref:`bool<class_bool>` **gutters_draw_fold_gutter**
  431. +-----------+-----------------------------+
  432. | *Default* | ``false`` |
  433. +-----------+-----------------------------+
  434. | *Setter* | set_draw_fold_gutter(value) |
  435. +-----------+-----------------------------+
  436. | *Getter* | is_drawing_fold_gutter() |
  437. +-----------+-----------------------------+
  438. Sets if foldable lines icons should be drawn in the gutter.
  439. ----
  440. .. _class_CodeEdit_property_gutters_draw_line_numbers:
  441. - :ref:`bool<class_bool>` **gutters_draw_line_numbers**
  442. +-----------+--------------------------------+
  443. | *Default* | ``false`` |
  444. +-----------+--------------------------------+
  445. | *Setter* | set_draw_line_numbers(value) |
  446. +-----------+--------------------------------+
  447. | *Getter* | is_draw_line_numbers_enabled() |
  448. +-----------+--------------------------------+
  449. Sets if line numbers should be drawn in the gutter.
  450. ----
  451. .. _class_CodeEdit_property_gutters_zero_pad_line_numbers:
  452. - :ref:`bool<class_bool>` **gutters_zero_pad_line_numbers**
  453. +-----------+-------------------------------------+
  454. | *Default* | ``false`` |
  455. +-----------+-------------------------------------+
  456. | *Setter* | set_line_numbers_zero_padded(value) |
  457. +-----------+-------------------------------------+
  458. | *Getter* | is_line_numbers_zero_padded() |
  459. +-----------+-------------------------------------+
  460. Sets if line numbers drawn in the gutter are zero padded.
  461. ----
  462. .. _class_CodeEdit_property_indent_automatic:
  463. - :ref:`bool<class_bool>` **indent_automatic**
  464. +-----------+--------------------------------+
  465. | *Default* | ``false`` |
  466. +-----------+--------------------------------+
  467. | *Setter* | set_auto_indent_enabled(value) |
  468. +-----------+--------------------------------+
  469. | *Getter* | is_auto_indent_enabled() |
  470. +-----------+--------------------------------+
  471. Sets whether automatic indent are enabled, this will add an extra indent if a prefix or brace is found.
  472. ----
  473. .. _class_CodeEdit_property_indent_automatic_prefixes:
  474. - :ref:`String[]<class_String>` **indent_automatic_prefixes**
  475. +-----------+---------------------------------+
  476. | *Default* | ``[":", "{", "[", "("]`` |
  477. +-----------+---------------------------------+
  478. | *Setter* | set_auto_indent_prefixes(value) |
  479. +-----------+---------------------------------+
  480. | *Getter* | get_auto_indent_prefixes() |
  481. +-----------+---------------------------------+
  482. Prefixes to trigger an automatic indent.
  483. ----
  484. .. _class_CodeEdit_property_indent_size:
  485. - :ref:`int<class_int>` **indent_size**
  486. +-----------+------------------------+
  487. | *Default* | ``4`` |
  488. +-----------+------------------------+
  489. | *Setter* | set_indent_size(value) |
  490. +-----------+------------------------+
  491. | *Getter* | get_indent_size() |
  492. +-----------+------------------------+
  493. Size of tabs, if ``indent_use_spaces`` is enabled the amount of spaces to use.
  494. ----
  495. .. _class_CodeEdit_property_indent_use_spaces:
  496. - :ref:`bool<class_bool>` **indent_use_spaces**
  497. +-----------+--------------------------------+
  498. | *Default* | ``false`` |
  499. +-----------+--------------------------------+
  500. | *Setter* | set_indent_using_spaces(value) |
  501. +-----------+--------------------------------+
  502. | *Getter* | is_indent_using_spaces() |
  503. +-----------+--------------------------------+
  504. Use spaces instead of tabs for indentation.
  505. ----
  506. .. _class_CodeEdit_property_line_folding:
  507. - :ref:`bool<class_bool>` **line_folding**
  508. +-----------+---------------------------------+
  509. | *Default* | ``false`` |
  510. +-----------+---------------------------------+
  511. | *Setter* | set_line_folding_enabled(value) |
  512. +-----------+---------------------------------+
  513. | *Getter* | is_line_folding_enabled() |
  514. +-----------+---------------------------------+
  515. Sets whether line folding is allowed.
  516. ----
  517. .. _class_CodeEdit_property_line_length_guidelines:
  518. - :ref:`int[]<class_int>` **line_length_guidelines**
  519. +-----------+-----------------------------------+
  520. | *Default* | ``[]`` |
  521. +-----------+-----------------------------------+
  522. | *Setter* | set_line_length_guidelines(value) |
  523. +-----------+-----------------------------------+
  524. | *Getter* | get_line_length_guidelines() |
  525. +-----------+-----------------------------------+
  526. Draws vertical lines at the provided columns. The first entry is considered a main hard guideline and is draw more prominently
  527. ----
  528. .. _class_CodeEdit_property_symbol_lookup_on_click:
  529. - :ref:`bool<class_bool>` **symbol_lookup_on_click**
  530. +-----------+-------------------------------------------+
  531. | *Default* | ``false`` |
  532. +-----------+-------------------------------------------+
  533. | *Setter* | set_symbol_lookup_on_click_enabled(value) |
  534. +-----------+-------------------------------------------+
  535. | *Getter* | is_symbol_lookup_on_click_enabled() |
  536. +-----------+-------------------------------------------+
  537. Set when a validated word from :ref:`symbol_validate<class_CodeEdit_signal_symbol_validate>` is clicked, the :ref:`symbol_lookup<class_CodeEdit_signal_symbol_lookup>` should be emitted.
  538. Method Descriptions
  539. -------------------
  540. .. _class_CodeEdit_method__confirm_code_completion:
  541. - void **_confirm_code_completion** **(** :ref:`bool<class_bool>` replace **)** |virtual|
  542. Override this method to define how the selected entry should be inserted. If ``replace`` is true, any existing text should be replaced.
  543. ----
  544. .. _class_CodeEdit_method__filter_code_completion_candidates:
  545. - :ref:`Array<class_Array>` **_filter_code_completion_candidates** **(** :ref:`Dictionary[]<class_Dictionary>` candidates **)** |virtual| |const|
  546. Override this method to define what items in ``candidates`` should be displayed.
  547. Both ``candidates`` and the return is a :ref:`Array<class_Array>` of :ref:`Dictionary<class_Dictionary>`, see :ref:`get_code_completion_option<class_CodeEdit_method_get_code_completion_option>` for :ref:`Dictionary<class_Dictionary>` content.
  548. ----
  549. .. _class_CodeEdit_method__request_code_completion:
  550. - void **_request_code_completion** **(** :ref:`bool<class_bool>` force **)** |virtual|
  551. Override this method to define what happens when the user requests code completion. If ``force`` is true, any checks should be bypassed.
  552. ----
  553. .. _class_CodeEdit_method_add_auto_brace_completion_pair:
  554. - void **add_auto_brace_completion_pair** **(** :ref:`String<class_String>` start_key, :ref:`String<class_String>` end_key **)**
  555. Adds a brace pair.
  556. Both the start and end keys must be symbols. Only the start key has to be unique.
  557. ----
  558. .. _class_CodeEdit_method_add_code_completion_option:
  559. - void **add_code_completion_option** **(** :ref:`CodeCompletionKind<enum_CodeEdit_CodeCompletionKind>` type, :ref:`String<class_String>` display_text, :ref:`String<class_String>` insert_text, :ref:`Color<class_Color>` text_color=Color(1, 1, 1, 1), :ref:`Resource<class_Resource>` icon=null, :ref:`Variant<class_Variant>` value=0 **)**
  560. Submits an item to the queue of potential candidates for the autocomplete menu. Call :ref:`update_code_completion_options<class_CodeEdit_method_update_code_completion_options>` to update the list.
  561. \ **Note:** This list will replace all current candidates.
  562. ----
  563. .. _class_CodeEdit_method_add_comment_delimiter:
  564. - void **add_comment_delimiter** **(** :ref:`String<class_String>` start_key, :ref:`String<class_String>` end_key, :ref:`bool<class_bool>` line_only=false **)**
  565. Adds a comment delimiter.
  566. Both the start and end keys must be symbols. Only the start key has to be unique.
  567. Line only denotes if the region should continue until the end of the line or carry over on to the next line. If the end key is blank this is automatically set to ``true``.
  568. ----
  569. .. _class_CodeEdit_method_add_string_delimiter:
  570. - void **add_string_delimiter** **(** :ref:`String<class_String>` start_key, :ref:`String<class_String>` end_key, :ref:`bool<class_bool>` line_only=false **)**
  571. Adds a string delimiter.
  572. Both the start and end keys must be symbols. Only the start key has to be unique.
  573. Line only denotes if the region should continue until the end of the line or carry over on to the next line. If the end key is blank this is automatically set to ``true``.
  574. ----
  575. .. _class_CodeEdit_method_can_fold_line:
  576. - :ref:`bool<class_bool>` **can_fold_line** **(** :ref:`int<class_int>` line **)** |const|
  577. Returns if the given line is foldable, that is, it has indented lines right below it or a comment / string block.
  578. ----
  579. .. _class_CodeEdit_method_cancel_code_completion:
  580. - void **cancel_code_completion** **(** **)**
  581. Cancels the autocomplete menu.
  582. ----
  583. .. _class_CodeEdit_method_clear_bookmarked_lines:
  584. - void **clear_bookmarked_lines** **(** **)**
  585. Clears all bookmarked lines.
  586. ----
  587. .. _class_CodeEdit_method_clear_breakpointed_lines:
  588. - void **clear_breakpointed_lines** **(** **)**
  589. Clears all breakpointed lines.
  590. ----
  591. .. _class_CodeEdit_method_clear_comment_delimiters:
  592. - void **clear_comment_delimiters** **(** **)**
  593. Removes all comment delimiters.
  594. ----
  595. .. _class_CodeEdit_method_clear_executing_lines:
  596. - void **clear_executing_lines** **(** **)**
  597. Clears all executed lines.
  598. ----
  599. .. _class_CodeEdit_method_clear_string_delimiters:
  600. - void **clear_string_delimiters** **(** **)**
  601. Removes all string delimiters.
  602. ----
  603. .. _class_CodeEdit_method_confirm_code_completion:
  604. - void **confirm_code_completion** **(** :ref:`bool<class_bool>` replace=false **)**
  605. Inserts the selected entry into the text. If ``replace`` is true, any existing text is replaced rather then merged.
  606. ----
  607. .. _class_CodeEdit_method_do_indent:
  608. - void **do_indent** **(** **)**
  609. Perform an indent as if the user activated the "ui_text_indent" action.
  610. ----
  611. .. _class_CodeEdit_method_do_unindent:
  612. - void **do_unindent** **(** **)**
  613. Perform an unindent as if the user activated the "ui_text_unindent" action.
  614. ----
  615. .. _class_CodeEdit_method_fold_all_lines:
  616. - void **fold_all_lines** **(** **)**
  617. Folds all lines that are possible to be folded (see :ref:`can_fold_line<class_CodeEdit_method_can_fold_line>`).
  618. ----
  619. .. _class_CodeEdit_method_fold_line:
  620. - void **fold_line** **(** :ref:`int<class_int>` line **)**
  621. Folds the given line, if possible (see :ref:`can_fold_line<class_CodeEdit_method_can_fold_line>`).
  622. ----
  623. .. _class_CodeEdit_method_get_auto_brace_completion_close_key:
  624. - :ref:`String<class_String>` **get_auto_brace_completion_close_key** **(** :ref:`String<class_String>` open_key **)** |const|
  625. Gets the matching auto brace close key for ``open_key``.
  626. ----
  627. .. _class_CodeEdit_method_get_bookmarked_lines:
  628. - :ref:`Array<class_Array>` **get_bookmarked_lines** **(** **)** |const|
  629. Gets all bookmarked lines.
  630. ----
  631. .. _class_CodeEdit_method_get_breakpointed_lines:
  632. - :ref:`Array<class_Array>` **get_breakpointed_lines** **(** **)** |const|
  633. Gets all breakpointed lines.
  634. ----
  635. .. _class_CodeEdit_method_get_code_completion_option:
  636. - :ref:`Dictionary<class_Dictionary>` **get_code_completion_option** **(** :ref:`int<class_int>` index **)** |const|
  637. Gets the completion option at ``index``. The return :ref:`Dictionary<class_Dictionary>` has the following key-values:
  638. \ ``kind``: :ref:`CodeCompletionKind<enum_CodeEdit_CodeCompletionKind>`\
  639. \ ``display_text``: Text that is shown on the autocomplete menu.
  640. \ ``insert_text``: Text that is to be inserted when this item is selected.
  641. \ ``font_color``: Color of the text on the autocomplete menu.
  642. \ ``icon``: Icon to draw on the autocomplete menu.
  643. \ ``default_value``: Value of the symbol.
  644. ----
  645. .. _class_CodeEdit_method_get_code_completion_options:
  646. - :ref:`Dictionary[]<class_Dictionary>` **get_code_completion_options** **(** **)** |const|
  647. Gets all completion options, see :ref:`get_code_completion_option<class_CodeEdit_method_get_code_completion_option>` for return content.
  648. ----
  649. .. _class_CodeEdit_method_get_code_completion_selected_index:
  650. - :ref:`int<class_int>` **get_code_completion_selected_index** **(** **)** |const|
  651. Gets the index of the current selected completion option.
  652. ----
  653. .. _class_CodeEdit_method_get_delimiter_end_key:
  654. - :ref:`String<class_String>` **get_delimiter_end_key** **(** :ref:`int<class_int>` delimiter_index **)** |const|
  655. Gets the end key for a string or comment region index.
  656. ----
  657. .. _class_CodeEdit_method_get_delimiter_end_position:
  658. - :ref:`Vector2<class_Vector2>` **get_delimiter_end_position** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const|
  659. If ``line`` ``column`` is in a string or comment, returns the end position of the region. If not or no end could be found, both :ref:`Vector2<class_Vector2>` values will be ``-1``.
  660. ----
  661. .. _class_CodeEdit_method_get_delimiter_start_key:
  662. - :ref:`String<class_String>` **get_delimiter_start_key** **(** :ref:`int<class_int>` delimiter_index **)** |const|
  663. Gets the start key for a string or comment region index.
  664. ----
  665. .. _class_CodeEdit_method_get_delimiter_start_position:
  666. - :ref:`Vector2<class_Vector2>` **get_delimiter_start_position** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column **)** |const|
  667. If ``line`` ``column`` is in a string or comment, returns the start position of the region. If not or no start could be found, both :ref:`Vector2<class_Vector2>` values will be ``-1``.
  668. ----
  669. .. _class_CodeEdit_method_get_executing_lines:
  670. - :ref:`Array<class_Array>` **get_executing_lines** **(** **)** |const|
  671. Gets all executing lines.
  672. ----
  673. .. _class_CodeEdit_method_get_folded_lines:
  674. - :ref:`int[]<class_int>` **get_folded_lines** **(** **)** |const|
  675. Returns all lines that are current folded.
  676. ----
  677. .. _class_CodeEdit_method_get_text_for_code_completion:
  678. - :ref:`String<class_String>` **get_text_for_code_completion** **(** **)** |const|
  679. Returns the full text with char ``0xFFFF`` at the caret location.
  680. ----
  681. .. _class_CodeEdit_method_get_text_for_symbol_lookup:
  682. - :ref:`String<class_String>` **get_text_for_symbol_lookup** **(** **)**
  683. Returns the full text with char ``0xFFFF`` at the cursor location.
  684. ----
  685. .. _class_CodeEdit_method_has_auto_brace_completion_close_key:
  686. - :ref:`bool<class_bool>` **has_auto_brace_completion_close_key** **(** :ref:`String<class_String>` close_key **)** |const|
  687. Returns ``true`` if close key ``close_key`` exists.
  688. ----
  689. .. _class_CodeEdit_method_has_auto_brace_completion_open_key:
  690. - :ref:`bool<class_bool>` **has_auto_brace_completion_open_key** **(** :ref:`String<class_String>` open_key **)** |const|
  691. Returns ``true`` if open key ``open_key`` exists.
  692. ----
  693. .. _class_CodeEdit_method_has_comment_delimiter:
  694. - :ref:`bool<class_bool>` **has_comment_delimiter** **(** :ref:`String<class_String>` start_key **)** |const|
  695. Returns ``true`` if comment ``start_key`` exists.
  696. ----
  697. .. _class_CodeEdit_method_has_string_delimiter:
  698. - :ref:`bool<class_bool>` **has_string_delimiter** **(** :ref:`String<class_String>` start_key **)** |const|
  699. Returns ``true`` if string ``start_key`` exists.
  700. ----
  701. .. _class_CodeEdit_method_indent_lines:
  702. - void **indent_lines** **(** **)**
  703. Indents selected lines, or in the case of no selection the caret line by one.
  704. ----
  705. .. _class_CodeEdit_method_is_in_comment:
  706. - :ref:`int<class_int>` **is_in_comment** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column=-1 **)** |const|
  707. Returns delimiter index if ``line`` ``column`` is in a comment. If ``column`` is not provided, will return delimiter index if the entire ``line`` is a comment. Otherwise ``-1``.
  708. ----
  709. .. _class_CodeEdit_method_is_in_string:
  710. - :ref:`int<class_int>` **is_in_string** **(** :ref:`int<class_int>` line, :ref:`int<class_int>` column=-1 **)** |const|
  711. Returns the delimiter index if ``line`` ``column`` is in a string. If ``column`` is not provided, will return the delimiter index if the entire ``line`` is a string. Otherwise ``-1``.
  712. ----
  713. .. _class_CodeEdit_method_is_line_bookmarked:
  714. - :ref:`bool<class_bool>` **is_line_bookmarked** **(** :ref:`int<class_int>` line **)** |const|
  715. Returns whether the line at the specified index is bookmarked or not.
  716. ----
  717. .. _class_CodeEdit_method_is_line_breakpointed:
  718. - :ref:`bool<class_bool>` **is_line_breakpointed** **(** :ref:`int<class_int>` line **)** |const|
  719. Returns whether the line at the specified index is breakpointed or not.
  720. ----
  721. .. _class_CodeEdit_method_is_line_executing:
  722. - :ref:`bool<class_bool>` **is_line_executing** **(** :ref:`int<class_int>` line **)** |const|
  723. Returns whether the line at the specified index is marked as executing or not.
  724. ----
  725. .. _class_CodeEdit_method_is_line_folded:
  726. - :ref:`bool<class_bool>` **is_line_folded** **(** :ref:`int<class_int>` line **)** |const|
  727. Returns whether the line at the specified index is folded or not.
  728. ----
  729. .. _class_CodeEdit_method_remove_comment_delimiter:
  730. - void **remove_comment_delimiter** **(** :ref:`String<class_String>` start_key **)**
  731. Removes the comment delimiter with ``start_key``.
  732. ----
  733. .. _class_CodeEdit_method_remove_string_delimiter:
  734. - void **remove_string_delimiter** **(** :ref:`String<class_String>` start_key **)**
  735. Removes the string delimiter with ``start_key``.
  736. ----
  737. .. _class_CodeEdit_method_request_code_completion:
  738. - void **request_code_completion** **(** :ref:`bool<class_bool>` force=false **)**
  739. Emits :ref:`code_completion_requested<class_CodeEdit_signal_code_completion_requested>`, if ``force`` is true will bypass all checks. Otherwise will check that the caret is in a word or in front of a prefix. Will ignore the request if all current options are of type file path, node path or signal.
  740. ----
  741. .. _class_CodeEdit_method_set_code_completion_selected_index:
  742. - void **set_code_completion_selected_index** **(** :ref:`int<class_int>` index **)**
  743. Sets the current selected completion option.
  744. ----
  745. .. _class_CodeEdit_method_set_code_hint:
  746. - void **set_code_hint** **(** :ref:`String<class_String>` code_hint **)**
  747. Sets the code hint text. Pass an empty string to clear.
  748. ----
  749. .. _class_CodeEdit_method_set_code_hint_draw_below:
  750. - void **set_code_hint_draw_below** **(** :ref:`bool<class_bool>` draw_below **)**
  751. Sets if the code hint should draw below the text.
  752. ----
  753. .. _class_CodeEdit_method_set_line_as_bookmarked:
  754. - void **set_line_as_bookmarked** **(** :ref:`int<class_int>` line, :ref:`bool<class_bool>` bookmarked **)**
  755. Sets the line as bookmarked.
  756. ----
  757. .. _class_CodeEdit_method_set_line_as_breakpoint:
  758. - void **set_line_as_breakpoint** **(** :ref:`int<class_int>` line, :ref:`bool<class_bool>` breakpointed **)**
  759. Sets the line as breakpointed.
  760. ----
  761. .. _class_CodeEdit_method_set_line_as_executing:
  762. - void **set_line_as_executing** **(** :ref:`int<class_int>` line, :ref:`bool<class_bool>` executing **)**
  763. Sets the line as executing.
  764. ----
  765. .. _class_CodeEdit_method_set_symbol_lookup_word_as_valid:
  766. - void **set_symbol_lookup_word_as_valid** **(** :ref:`bool<class_bool>` valid **)**
  767. Sets the symbol emitted by :ref:`symbol_validate<class_CodeEdit_signal_symbol_validate>` as a valid lookup.
  768. ----
  769. .. _class_CodeEdit_method_toggle_foldable_line:
  770. - void **toggle_foldable_line** **(** :ref:`int<class_int>` line **)**
  771. Toggle the folding of the code block at the given line.
  772. ----
  773. .. _class_CodeEdit_method_unfold_all_lines:
  774. - void **unfold_all_lines** **(** **)**
  775. Unfolds all lines, folded or not.
  776. ----
  777. .. _class_CodeEdit_method_unfold_line:
  778. - void **unfold_line** **(** :ref:`int<class_int>` line **)**
  779. Unfolds all lines that were previously folded.
  780. ----
  781. .. _class_CodeEdit_method_unindent_lines:
  782. - void **unindent_lines** **(** **)**
  783. Unindents selected lines, or in the case of no selection the caret line by one.
  784. ----
  785. .. _class_CodeEdit_method_update_code_completion_options:
  786. - void **update_code_completion_options** **(** :ref:`bool<class_bool>` force **)**
  787. Submits all completion options added with :ref:`add_code_completion_option<class_CodeEdit_method_add_code_completion_option>`. Will try to force the autoccomplete menu to popup, if ``force`` is ``true``.
  788. \ **Note:** This will replace all current candidates.
  789. Theme Property Descriptions
  790. ---------------------------
  791. .. _class_CodeEdit_theme_color_background_color:
  792. - :ref:`Color<class_Color>` **background_color**
  793. +-----------+-----------------------+
  794. | *Default* | ``Color(0, 0, 0, 0)`` |
  795. +-----------+-----------------------+
  796. Sets the background :ref:`Color<class_Color>`.
  797. ----
  798. .. _class_CodeEdit_theme_color_bookmark_color:
  799. - :ref:`Color<class_Color>` **bookmark_color**
  800. +-----------+------------------------------+
  801. | *Default* | ``Color(0.5, 0.64, 1, 0.8)`` |
  802. +-----------+------------------------------+
  803. :ref:`Color<class_Color>` of the bookmark icon for bookmarked lines.
  804. ----
  805. .. _class_CodeEdit_theme_color_brace_mismatch_color:
  806. - :ref:`Color<class_Color>` **brace_mismatch_color**
  807. +-----------+---------------------------+
  808. | *Default* | ``Color(1, 0.2, 0.2, 1)`` |
  809. +-----------+---------------------------+
  810. :ref:`Color<class_Color>` of the text to highlight mismatched braces.
  811. ----
  812. .. _class_CodeEdit_theme_color_breakpoint_color:
  813. - :ref:`Color<class_Color>` **breakpoint_color**
  814. +-----------+------------------------------+
  815. | *Default* | ``Color(0.9, 0.29, 0.3, 1)`` |
  816. +-----------+------------------------------+
  817. :ref:`Color<class_Color>` of the breakpoint icon for bookmarked lines.
  818. ----
  819. .. _class_CodeEdit_theme_color_caret_background_color:
  820. - :ref:`Color<class_Color>` **caret_background_color**
  821. +-----------+-----------------------+
  822. | *Default* | ``Color(0, 0, 0, 1)`` |
  823. +-----------+-----------------------+
  824. :ref:`Color<class_Color>` of the text behind the caret when block caret is enabled.
  825. ----
  826. .. _class_CodeEdit_theme_color_caret_color:
  827. - :ref:`Color<class_Color>` **caret_color**
  828. +-----------+-----------------------------------+
  829. | *Default* | ``Color(0.875, 0.875, 0.875, 1)`` |
  830. +-----------+-----------------------------------+
  831. :ref:`Color<class_Color>` of the caret.
  832. ----
  833. .. _class_CodeEdit_theme_color_code_folding_color:
  834. - :ref:`Color<class_Color>` **code_folding_color**
  835. +-----------+-------------------------------+
  836. | *Default* | ``Color(0.8, 0.8, 0.8, 0.8)`` |
  837. +-----------+-------------------------------+
  838. :ref:`Color<class_Color>` for all icons related to line folding.
  839. ----
  840. .. _class_CodeEdit_theme_color_completion_background_color:
  841. - :ref:`Color<class_Color>` **completion_background_color**
  842. +-----------+-------------------------------+
  843. | *Default* | ``Color(0.17, 0.16, 0.2, 1)`` |
  844. +-----------+-------------------------------+
  845. Sets the background :ref:`Color<class_Color>` for the code completion popup.
  846. ----
  847. .. _class_CodeEdit_theme_color_completion_existing_color:
  848. - :ref:`Color<class_Color>` **completion_existing_color**
  849. +-----------+-----------------------------------+
  850. | *Default* | ``Color(0.87, 0.87, 0.87, 0.13)`` |
  851. +-----------+-----------------------------------+
  852. Background highlight :ref:`Color<class_Color>` for matching text in code completion options.
  853. ----
  854. .. _class_CodeEdit_theme_color_completion_font_color:
  855. - :ref:`Color<class_Color>` **completion_font_color**
  856. +-----------+--------------------------------+
  857. | *Default* | ``Color(0.67, 0.67, 0.67, 1)`` |
  858. +-----------+--------------------------------+
  859. Font :ref:`Color<class_Color>` for the code completion popup.
  860. ----
  861. .. _class_CodeEdit_theme_color_completion_scroll_color:
  862. - :ref:`Color<class_Color>` **completion_scroll_color**
  863. +-----------+--------------------------+
  864. | *Default* | ``Color(1, 1, 1, 0.29)`` |
  865. +-----------+--------------------------+
  866. :ref:`Color<class_Color>` of the scrollbar in the code completion popup.
  867. ----
  868. .. _class_CodeEdit_theme_color_completion_scroll_hovered_color:
  869. - :ref:`Color<class_Color>` **completion_scroll_hovered_color**
  870. +-----------+-------------------------+
  871. | *Default* | ``Color(1, 1, 1, 0.4)`` |
  872. +-----------+-------------------------+
  873. :ref:`Color<class_Color>` of the scrollbar in the code completion popup when hovered.
  874. ----
  875. .. _class_CodeEdit_theme_color_completion_selected_color:
  876. - :ref:`Color<class_Color>` **completion_selected_color**
  877. +-----------+--------------------------------+
  878. | *Default* | ``Color(0.26, 0.26, 0.27, 1)`` |
  879. +-----------+--------------------------------+
  880. Background highlight :ref:`Color<class_Color>` for the current selected option item in the code completion popup.
  881. ----
  882. .. _class_CodeEdit_theme_color_current_line_color:
  883. - :ref:`Color<class_Color>` **current_line_color**
  884. +-----------+----------------------------------+
  885. | *Default* | ``Color(0.25, 0.25, 0.26, 0.8)`` |
  886. +-----------+----------------------------------+
  887. Background :ref:`Color<class_Color>` of the line containing the caret.
  888. ----
  889. .. _class_CodeEdit_theme_color_executing_line_color:
  890. - :ref:`Color<class_Color>` **executing_line_color**
  891. +-----------+--------------------------------+
  892. | *Default* | ``Color(0.98, 0.89, 0.27, 1)`` |
  893. +-----------+--------------------------------+
  894. :ref:`Color<class_Color>` of the executing icon for executing lines.
  895. ----
  896. .. _class_CodeEdit_theme_color_font_color:
  897. - :ref:`Color<class_Color>` **font_color**
  898. +-----------+-----------------------------------+
  899. | *Default* | ``Color(0.875, 0.875, 0.875, 1)`` |
  900. +-----------+-----------------------------------+
  901. Sets the font :ref:`Color<class_Color>`.
  902. ----
  903. .. _class_CodeEdit_theme_color_font_outline_color:
  904. - :ref:`Color<class_Color>` **font_outline_color**
  905. +-----------+-----------------------+
  906. | *Default* | ``Color(1, 1, 1, 1)`` |
  907. +-----------+-----------------------+
  908. The tint of text outline of the ``CodeEdit``.
  909. ----
  910. .. _class_CodeEdit_theme_color_font_placeholder_color:
  911. - :ref:`Color<class_Color>` **font_placeholder_color**
  912. +-----------+-------------------------------------+
  913. | *Default* | ``Color(0.875, 0.875, 0.875, 0.6)`` |
  914. +-----------+-------------------------------------+
  915. Font color for :ref:`TextEdit.placeholder_text<class_TextEdit_property_placeholder_text>`.
  916. ----
  917. .. _class_CodeEdit_theme_color_font_readonly_color:
  918. - :ref:`Color<class_Color>` **font_readonly_color**
  919. +-----------+-------------------------------------+
  920. | *Default* | ``Color(0.875, 0.875, 0.875, 0.5)`` |
  921. +-----------+-------------------------------------+
  922. Sets the font :ref:`Color<class_Color>` when :ref:`TextEdit.editable<class_TextEdit_property_editable>` is disabled.
  923. ----
  924. .. _class_CodeEdit_theme_color_font_selected_color:
  925. - :ref:`Color<class_Color>` **font_selected_color**
  926. +-----------+-----------------------+
  927. | *Default* | ``Color(0, 0, 0, 1)`` |
  928. +-----------+-----------------------+
  929. Sets the :ref:`Color<class_Color>` of the selected text. :ref:`TextEdit.override_selected_font_color<class_TextEdit_property_override_selected_font_color>` has to be enabled.
  930. ----
  931. .. _class_CodeEdit_theme_color_line_length_guideline_color:
  932. - :ref:`Color<class_Color>` **line_length_guideline_color**
  933. +-----------+-------------------------------+
  934. | *Default* | ``Color(0.3, 0.5, 0.8, 0.1)`` |
  935. +-----------+-------------------------------+
  936. :ref:`Color<class_Color>` of the main line length guideline, secondary guidelines will have 50% alpha applied.
  937. ----
  938. .. _class_CodeEdit_theme_color_line_number_color:
  939. - :ref:`Color<class_Color>` **line_number_color**
  940. +-----------+----------------------------------+
  941. | *Default* | ``Color(0.67, 0.67, 0.67, 0.4)`` |
  942. +-----------+----------------------------------+
  943. Sets the :ref:`Color<class_Color>` of line numbers.
  944. ----
  945. .. _class_CodeEdit_theme_color_search_result_border_color:
  946. - :ref:`Color<class_Color>` **search_result_border_color**
  947. +-----------+-------------------------------+
  948. | *Default* | ``Color(0.3, 0.3, 0.3, 0.4)`` |
  949. +-----------+-------------------------------+
  950. :ref:`Color<class_Color>` of the border around text that matches the search query.
  951. ----
  952. .. _class_CodeEdit_theme_color_search_result_color:
  953. - :ref:`Color<class_Color>` **search_result_color**
  954. +-----------+-----------------------------+
  955. | *Default* | ``Color(0.3, 0.3, 0.3, 1)`` |
  956. +-----------+-----------------------------+
  957. :ref:`Color<class_Color>` behind the text that matches the search query.
  958. ----
  959. .. _class_CodeEdit_theme_color_selection_color:
  960. - :ref:`Color<class_Color>` **selection_color**
  961. +-----------+-----------------------------+
  962. | *Default* | ``Color(0.5, 0.5, 0.5, 1)`` |
  963. +-----------+-----------------------------+
  964. Sets the highlight :ref:`Color<class_Color>` of text selections.
  965. ----
  966. .. _class_CodeEdit_theme_color_word_highlighted_color:
  967. - :ref:`Color<class_Color>` **word_highlighted_color**
  968. +-----------+--------------------------------+
  969. | *Default* | ``Color(0.8, 0.9, 0.9, 0.15)`` |
  970. +-----------+--------------------------------+
  971. Sets the highlight :ref:`Color<class_Color>` of multiple occurrences. :ref:`TextEdit.highlight_all_occurrences<class_TextEdit_property_highlight_all_occurrences>` has to be enabled.
  972. ----
  973. .. _class_CodeEdit_theme_constant_completion_lines:
  974. - :ref:`int<class_int>` **completion_lines**
  975. +-----------+-------+
  976. | *Default* | ``7`` |
  977. +-----------+-------+
  978. Max number of options to display in the code completion popup at any one time.
  979. ----
  980. .. _class_CodeEdit_theme_constant_completion_max_width:
  981. - :ref:`int<class_int>` **completion_max_width**
  982. +-----------+--------+
  983. | *Default* | ``50`` |
  984. +-----------+--------+
  985. Max width of options in the code completion popup. Options longer then this will be cut off.
  986. ----
  987. .. _class_CodeEdit_theme_constant_completion_scroll_width:
  988. - :ref:`int<class_int>` **completion_scroll_width**
  989. +-----------+-------+
  990. | *Default* | ``6`` |
  991. +-----------+-------+
  992. Width of the scrollbar in the code completion popup.
  993. ----
  994. .. _class_CodeEdit_theme_constant_line_spacing:
  995. - :ref:`int<class_int>` **line_spacing**
  996. +-----------+-------+
  997. | *Default* | ``4`` |
  998. +-----------+-------+
  999. Sets the spacing between the lines.
  1000. ----
  1001. .. _class_CodeEdit_theme_constant_outline_size:
  1002. - :ref:`int<class_int>` **outline_size**
  1003. +-----------+-------+
  1004. | *Default* | ``0`` |
  1005. +-----------+-------+
  1006. The size of the text outline.
  1007. ----
  1008. .. _class_CodeEdit_theme_font_font:
  1009. - :ref:`Font<class_Font>` **font**
  1010. Sets the default :ref:`Font<class_Font>`.
  1011. ----
  1012. .. _class_CodeEdit_theme_font_size_font_size:
  1013. - :ref:`int<class_int>` **font_size**
  1014. Sets default font size.
  1015. ----
  1016. .. _class_CodeEdit_theme_icon_bookmark:
  1017. - :ref:`Texture2D<class_Texture2D>` **bookmark**
  1018. Sets a custom :ref:`Texture2D<class_Texture2D>` to draw in the bookmark gutter for bookmarked lines.
  1019. ----
  1020. .. _class_CodeEdit_theme_icon_breakpoint:
  1021. - :ref:`Texture2D<class_Texture2D>` **breakpoint**
  1022. Sets a custom :ref:`Texture2D<class_Texture2D>` to draw in the breakpoint gutter for breakpointed lines.
  1023. ----
  1024. .. _class_CodeEdit_theme_icon_can_fold:
  1025. - :ref:`Texture2D<class_Texture2D>` **can_fold**
  1026. Sets a custom :ref:`Texture2D<class_Texture2D>` to draw in the line folding gutter when a line can be folded.
  1027. ----
  1028. .. _class_CodeEdit_theme_icon_executing_line:
  1029. - :ref:`Texture2D<class_Texture2D>` **executing_line**
  1030. Icon to draw in the executing gutter for executing lines.
  1031. ----
  1032. .. _class_CodeEdit_theme_icon_folded:
  1033. - :ref:`Texture2D<class_Texture2D>` **folded**
  1034. Sets a custom :ref:`Texture2D<class_Texture2D>` to draw in the line folding gutter when a line is folded and can be unfolded.
  1035. ----
  1036. .. _class_CodeEdit_theme_icon_folded_eol_icon:
  1037. - :ref:`Texture2D<class_Texture2D>` **folded_eol_icon**
  1038. Sets a custom :ref:`Texture2D<class_Texture2D>` to draw at the end of a folded line.
  1039. ----
  1040. .. _class_CodeEdit_theme_icon_space:
  1041. - :ref:`Texture2D<class_Texture2D>` **space**
  1042. Sets a custom :ref:`Texture2D<class_Texture2D>` for space text characters.
  1043. ----
  1044. .. _class_CodeEdit_theme_icon_tab:
  1045. - :ref:`Texture2D<class_Texture2D>` **tab**
  1046. Sets a custom :ref:`Texture2D<class_Texture2D>` for tab text characters.
  1047. ----
  1048. .. _class_CodeEdit_theme_style_completion:
  1049. - :ref:`StyleBox<class_StyleBox>` **completion**
  1050. :ref:`StyleBox<class_StyleBox>` for the code completion popup.
  1051. ----
  1052. .. _class_CodeEdit_theme_style_focus:
  1053. - :ref:`StyleBox<class_StyleBox>` **focus**
  1054. Sets the :ref:`StyleBox<class_StyleBox>` when in focus. The ``focus`` :ref:`StyleBox<class_StyleBox>` is displayed *over* the base :ref:`StyleBox<class_StyleBox>`, so a partially transparent :ref:`StyleBox<class_StyleBox>` should be used to ensure the base :ref:`StyleBox<class_StyleBox>` remains visible. A :ref:`StyleBox<class_StyleBox>` that represents an outline or an underline works well for this purpose. To disable the focus visual effect, assign a :ref:`StyleBoxEmpty<class_StyleBoxEmpty>` resource. Note that disabling the focus visual effect will harm keyboard/controller navigation usability, so this is not recommended for accessibility reasons.
  1055. ----
  1056. .. _class_CodeEdit_theme_style_normal:
  1057. - :ref:`StyleBox<class_StyleBox>` **normal**
  1058. Sets the :ref:`StyleBox<class_StyleBox>`.
  1059. ----
  1060. .. _class_CodeEdit_theme_style_read_only:
  1061. - :ref:`StyleBox<class_StyleBox>` **read_only**
  1062. Sets the :ref:`StyleBox<class_StyleBox>` when :ref:`TextEdit.editable<class_TextEdit_property_editable>` is disabled.
  1063. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  1064. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  1065. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  1066. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  1067. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  1068. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`