class_richtextlabel.rst 151 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127
  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/RichTextLabel.xml.
  6. .. _class_RichTextLabel:
  7. RichTextLabel
  8. =============
  9. **Inherits:** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  10. A control for displaying text that can contain different font styles, images, and basic formatting.
  11. .. rst-class:: classref-introduction-group
  12. Description
  13. -----------
  14. A control for displaying text that can contain custom fonts, images, and basic formatting. **RichTextLabel** manages these as an internal tag stack. It also adapts itself to given width/heights.
  15. \ **Note:** Assignments to :ref:`text<class_RichTextLabel_property_text>` clear the tag stack and reconstruct it from the property's contents. Any edits made to :ref:`text<class_RichTextLabel_property_text>` will erase previous edits made from other manual sources such as :ref:`append_text<class_RichTextLabel_method_append_text>` and the ``push_*`` / :ref:`pop<class_RichTextLabel_method_pop>` methods.
  16. \ **Note:** RichTextLabel doesn't support entangled BBCode tags. For example, instead of using ``[b]bold[i]bold italic[/b]italic[/i]``, use ``[b]bold[i]bold italic[/i][/b][i]italic[/i]``.
  17. \ **Note:** ``push_*/pop_*`` functions won't affect BBCode.
  18. \ **Note:** Unlike :ref:`Label<class_Label>`, **RichTextLabel** doesn't have a *property* to horizontally align text to the center. Instead, enable :ref:`bbcode_enabled<class_RichTextLabel_property_bbcode_enabled>` and surround the text in a ``[center]`` tag as follows: ``[center]Example[/center]``. There is currently no built-in way to vertically align text either, but this can be emulated by relying on anchors/containers and the :ref:`fit_content<class_RichTextLabel_property_fit_content>` property.
  19. .. rst-class:: classref-introduction-group
  20. Tutorials
  21. ---------
  22. - :doc:`BBCode in RichTextLabel <../tutorials/ui/bbcode_in_richtextlabel>`
  23. - `GUI Rich Text/BBcode Demo <https://godotengine.org/asset-library/asset/132>`__
  24. - `OS Test Demo <https://godotengine.org/asset-library/asset/677>`__
  25. .. rst-class:: classref-reftable-group
  26. Properties
  27. ----------
  28. .. table::
  29. :widths: auto
  30. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  31. | :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` | :ref:`autowrap_mode<class_RichTextLabel_property_autowrap_mode>` | ``3`` |
  32. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  33. | :ref:`bool<class_bool>` | :ref:`bbcode_enabled<class_RichTextLabel_property_bbcode_enabled>` | ``false`` |
  34. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  35. | :ref:`bool<class_bool>` | clip_contents | ``true`` (overrides :ref:`Control<class_Control_property_clip_contents>`) |
  36. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  37. | :ref:`bool<class_bool>` | :ref:`context_menu_enabled<class_RichTextLabel_property_context_menu_enabled>` | ``false`` |
  38. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  39. | :ref:`Array<class_Array>` | :ref:`custom_effects<class_RichTextLabel_property_custom_effects>` | ``[]`` |
  40. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  41. | :ref:`bool<class_bool>` | :ref:`deselect_on_focus_loss_enabled<class_RichTextLabel_property_deselect_on_focus_loss_enabled>` | ``true`` |
  42. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  43. | :ref:`bool<class_bool>` | :ref:`drag_and_drop_selection_enabled<class_RichTextLabel_property_drag_and_drop_selection_enabled>` | ``true`` |
  44. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  45. | :ref:`bool<class_bool>` | :ref:`fit_content<class_RichTextLabel_property_fit_content>` | ``false`` |
  46. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  47. | :ref:`bool<class_bool>` | :ref:`hint_underlined<class_RichTextLabel_property_hint_underlined>` | ``true`` |
  48. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  49. | :ref:`String<class_String>` | :ref:`language<class_RichTextLabel_property_language>` | ``""`` |
  50. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  51. | :ref:`bool<class_bool>` | :ref:`meta_underlined<class_RichTextLabel_property_meta_underlined>` | ``true`` |
  52. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  53. | :ref:`int<class_int>` | :ref:`progress_bar_delay<class_RichTextLabel_property_progress_bar_delay>` | ``1000`` |
  54. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  55. | :ref:`bool<class_bool>` | :ref:`scroll_active<class_RichTextLabel_property_scroll_active>` | ``true`` |
  56. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  57. | :ref:`bool<class_bool>` | :ref:`scroll_following<class_RichTextLabel_property_scroll_following>` | ``false`` |
  58. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  59. | :ref:`bool<class_bool>` | :ref:`selection_enabled<class_RichTextLabel_property_selection_enabled>` | ``false`` |
  60. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  61. | :ref:`bool<class_bool>` | :ref:`shortcut_keys_enabled<class_RichTextLabel_property_shortcut_keys_enabled>` | ``true`` |
  62. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  63. | :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` | :ref:`structured_text_bidi_override<class_RichTextLabel_property_structured_text_bidi_override>` | ``0`` |
  64. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  65. | :ref:`Array<class_Array>` | :ref:`structured_text_bidi_override_options<class_RichTextLabel_property_structured_text_bidi_override_options>` | ``[]`` |
  66. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  67. | :ref:`int<class_int>` | :ref:`tab_size<class_RichTextLabel_property_tab_size>` | ``4`` |
  68. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  69. | :ref:`String<class_String>` | :ref:`text<class_RichTextLabel_property_text>` | ``""`` |
  70. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  71. | :ref:`TextDirection<enum_Control_TextDirection>` | :ref:`text_direction<class_RichTextLabel_property_text_direction>` | ``0`` |
  72. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  73. | :ref:`bool<class_bool>` | :ref:`threaded<class_RichTextLabel_property_threaded>` | ``false`` |
  74. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  75. | :ref:`int<class_int>` | :ref:`visible_characters<class_RichTextLabel_property_visible_characters>` | ``-1`` |
  76. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  77. | :ref:`VisibleCharactersBehavior<enum_TextServer_VisibleCharactersBehavior>` | :ref:`visible_characters_behavior<class_RichTextLabel_property_visible_characters_behavior>` | ``0`` |
  78. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  79. | :ref:`float<class_float>` | :ref:`visible_ratio<class_RichTextLabel_property_visible_ratio>` | ``1.0`` |
  80. +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
  81. .. rst-class:: classref-reftable-group
  82. Methods
  83. -------
  84. .. table::
  85. :widths: auto
  86. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  87. | void | :ref:`add_image<class_RichTextLabel_method_add_image>` **(** :ref:`Texture2D<class_Texture2D>` image, :ref:`int<class_int>` width=0, :ref:`int<class_int>` height=0, :ref:`Color<class_Color>` color=Color(1, 1, 1, 1), :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` inline_align=5, :ref:`Rect2<class_Rect2>` region=Rect2(0, 0, 0, 0) **)** |
  88. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  89. | void | :ref:`add_text<class_RichTextLabel_method_add_text>` **(** :ref:`String<class_String>` text **)** |
  90. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  91. | void | :ref:`append_text<class_RichTextLabel_method_append_text>` **(** :ref:`String<class_String>` bbcode **)** |
  92. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  93. | void | :ref:`clear<class_RichTextLabel_method_clear>` **(** **)** |
  94. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  95. | void | :ref:`deselect<class_RichTextLabel_method_deselect>` **(** **)** |
  96. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  97. | :ref:`int<class_int>` | :ref:`get_character_line<class_RichTextLabel_method_get_character_line>` **(** :ref:`int<class_int>` character **)** |
  98. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  99. | :ref:`int<class_int>` | :ref:`get_character_paragraph<class_RichTextLabel_method_get_character_paragraph>` **(** :ref:`int<class_int>` character **)** |
  100. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  101. | :ref:`int<class_int>` | :ref:`get_content_height<class_RichTextLabel_method_get_content_height>` **(** **)** |const| |
  102. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  103. | :ref:`int<class_int>` | :ref:`get_content_width<class_RichTextLabel_method_get_content_width>` **(** **)** |const| |
  104. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  105. | :ref:`int<class_int>` | :ref:`get_line_count<class_RichTextLabel_method_get_line_count>` **(** **)** |const| |
  106. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  107. | :ref:`float<class_float>` | :ref:`get_line_offset<class_RichTextLabel_method_get_line_offset>` **(** :ref:`int<class_int>` line **)** |
  108. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  109. | :ref:`PopupMenu<class_PopupMenu>` | :ref:`get_menu<class_RichTextLabel_method_get_menu>` **(** **)** |const| |
  110. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  111. | :ref:`int<class_int>` | :ref:`get_paragraph_count<class_RichTextLabel_method_get_paragraph_count>` **(** **)** |const| |
  112. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  113. | :ref:`float<class_float>` | :ref:`get_paragraph_offset<class_RichTextLabel_method_get_paragraph_offset>` **(** :ref:`int<class_int>` paragraph **)** |
  114. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  115. | :ref:`String<class_String>` | :ref:`get_parsed_text<class_RichTextLabel_method_get_parsed_text>` **(** **)** |const| |
  116. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  117. | :ref:`String<class_String>` | :ref:`get_selected_text<class_RichTextLabel_method_get_selected_text>` **(** **)** |const| |
  118. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  119. | :ref:`int<class_int>` | :ref:`get_selection_from<class_RichTextLabel_method_get_selection_from>` **(** **)** |const| |
  120. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  121. | :ref:`int<class_int>` | :ref:`get_selection_to<class_RichTextLabel_method_get_selection_to>` **(** **)** |const| |
  122. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  123. | :ref:`int<class_int>` | :ref:`get_total_character_count<class_RichTextLabel_method_get_total_character_count>` **(** **)** |const| |
  124. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  125. | :ref:`VScrollBar<class_VScrollBar>` | :ref:`get_v_scroll_bar<class_RichTextLabel_method_get_v_scroll_bar>` **(** **)** |
  126. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  127. | :ref:`int<class_int>` | :ref:`get_visible_line_count<class_RichTextLabel_method_get_visible_line_count>` **(** **)** |const| |
  128. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  129. | :ref:`int<class_int>` | :ref:`get_visible_paragraph_count<class_RichTextLabel_method_get_visible_paragraph_count>` **(** **)** |const| |
  130. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  131. | void | :ref:`install_effect<class_RichTextLabel_method_install_effect>` **(** :ref:`Variant<class_Variant>` effect **)** |
  132. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  133. | :ref:`bool<class_bool>` | :ref:`is_menu_visible<class_RichTextLabel_method_is_menu_visible>` **(** **)** |const| |
  134. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  135. | :ref:`bool<class_bool>` | :ref:`is_ready<class_RichTextLabel_method_is_ready>` **(** **)** |const| |
  136. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  137. | void | :ref:`menu_option<class_RichTextLabel_method_menu_option>` **(** :ref:`int<class_int>` option **)** |
  138. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  139. | void | :ref:`newline<class_RichTextLabel_method_newline>` **(** **)** |
  140. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  141. | void | :ref:`parse_bbcode<class_RichTextLabel_method_parse_bbcode>` **(** :ref:`String<class_String>` bbcode **)** |
  142. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  143. | :ref:`Dictionary<class_Dictionary>` | :ref:`parse_expressions_for_values<class_RichTextLabel_method_parse_expressions_for_values>` **(** :ref:`PackedStringArray<class_PackedStringArray>` expressions **)** |
  144. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  145. | void | :ref:`pop<class_RichTextLabel_method_pop>` **(** **)** |
  146. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  147. | void | :ref:`pop_all<class_RichTextLabel_method_pop_all>` **(** **)** |
  148. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  149. | void | :ref:`pop_context<class_RichTextLabel_method_pop_context>` **(** **)** |
  150. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  151. | void | :ref:`push_bgcolor<class_RichTextLabel_method_push_bgcolor>` **(** :ref:`Color<class_Color>` bgcolor **)** |
  152. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  153. | void | :ref:`push_bold<class_RichTextLabel_method_push_bold>` **(** **)** |
  154. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  155. | void | :ref:`push_bold_italics<class_RichTextLabel_method_push_bold_italics>` **(** **)** |
  156. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  157. | void | :ref:`push_cell<class_RichTextLabel_method_push_cell>` **(** **)** |
  158. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  159. | void | :ref:`push_color<class_RichTextLabel_method_push_color>` **(** :ref:`Color<class_Color>` color **)** |
  160. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  161. | void | :ref:`push_context<class_RichTextLabel_method_push_context>` **(** **)** |
  162. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  163. | void | :ref:`push_customfx<class_RichTextLabel_method_push_customfx>` **(** :ref:`RichTextEffect<class_RichTextEffect>` effect, :ref:`Dictionary<class_Dictionary>` env **)** |
  164. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  165. | void | :ref:`push_dropcap<class_RichTextLabel_method_push_dropcap>` **(** :ref:`String<class_String>` string, :ref:`Font<class_Font>` font, :ref:`int<class_int>` size, :ref:`Rect2<class_Rect2>` dropcap_margins=Rect2(0, 0, 0, 0), :ref:`Color<class_Color>` color=Color(1, 1, 1, 1), :ref:`int<class_int>` outline_size=0, :ref:`Color<class_Color>` outline_color=Color(0, 0, 0, 0) **)** |
  166. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  167. | void | :ref:`push_fgcolor<class_RichTextLabel_method_push_fgcolor>` **(** :ref:`Color<class_Color>` fgcolor **)** |
  168. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  169. | void | :ref:`push_font<class_RichTextLabel_method_push_font>` **(** :ref:`Font<class_Font>` font, :ref:`int<class_int>` font_size=0 **)** |
  170. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  171. | void | :ref:`push_font_size<class_RichTextLabel_method_push_font_size>` **(** :ref:`int<class_int>` font_size **)** |
  172. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  173. | void | :ref:`push_hint<class_RichTextLabel_method_push_hint>` **(** :ref:`String<class_String>` description **)** |
  174. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  175. | void | :ref:`push_indent<class_RichTextLabel_method_push_indent>` **(** :ref:`int<class_int>` level **)** |
  176. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  177. | void | :ref:`push_italics<class_RichTextLabel_method_push_italics>` **(** **)** |
  178. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  179. | void | :ref:`push_language<class_RichTextLabel_method_push_language>` **(** :ref:`String<class_String>` language **)** |
  180. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  181. | void | :ref:`push_list<class_RichTextLabel_method_push_list>` **(** :ref:`int<class_int>` level, :ref:`ListType<enum_RichTextLabel_ListType>` type, :ref:`bool<class_bool>` capitalize, :ref:`String<class_String>` bullet="•" **)** |
  182. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  183. | void | :ref:`push_meta<class_RichTextLabel_method_push_meta>` **(** :ref:`Variant<class_Variant>` data **)** |
  184. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  185. | void | :ref:`push_mono<class_RichTextLabel_method_push_mono>` **(** **)** |
  186. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  187. | void | :ref:`push_normal<class_RichTextLabel_method_push_normal>` **(** **)** |
  188. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  189. | void | :ref:`push_outline_color<class_RichTextLabel_method_push_outline_color>` **(** :ref:`Color<class_Color>` color **)** |
  190. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  191. | void | :ref:`push_outline_size<class_RichTextLabel_method_push_outline_size>` **(** :ref:`int<class_int>` outline_size **)** |
  192. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  193. | void | :ref:`push_paragraph<class_RichTextLabel_method_push_paragraph>` **(** :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` alignment, :ref:`TextDirection<enum_Control_TextDirection>` base_direction=0, :ref:`String<class_String>` language="", :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` st_parser=0, |bitfield|\<:ref:`JustificationFlag<enum_TextServer_JustificationFlag>`\> justification_flags=163, :ref:`PackedFloat32Array<class_PackedFloat32Array>` tab_stops=PackedFloat32Array() **)** |
  194. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  195. | void | :ref:`push_strikethrough<class_RichTextLabel_method_push_strikethrough>` **(** **)** |
  196. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  197. | void | :ref:`push_table<class_RichTextLabel_method_push_table>` **(** :ref:`int<class_int>` columns, :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` inline_align=0, :ref:`int<class_int>` align_to_row=-1 **)** |
  198. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  199. | void | :ref:`push_underline<class_RichTextLabel_method_push_underline>` **(** **)** |
  200. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  201. | :ref:`bool<class_bool>` | :ref:`remove_paragraph<class_RichTextLabel_method_remove_paragraph>` **(** :ref:`int<class_int>` paragraph **)** |
  202. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  203. | void | :ref:`scroll_to_line<class_RichTextLabel_method_scroll_to_line>` **(** :ref:`int<class_int>` line **)** |
  204. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  205. | void | :ref:`scroll_to_paragraph<class_RichTextLabel_method_scroll_to_paragraph>` **(** :ref:`int<class_int>` paragraph **)** |
  206. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  207. | void | :ref:`scroll_to_selection<class_RichTextLabel_method_scroll_to_selection>` **(** **)** |
  208. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  209. | void | :ref:`select_all<class_RichTextLabel_method_select_all>` **(** **)** |
  210. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  211. | void | :ref:`set_cell_border_color<class_RichTextLabel_method_set_cell_border_color>` **(** :ref:`Color<class_Color>` color **)** |
  212. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  213. | void | :ref:`set_cell_padding<class_RichTextLabel_method_set_cell_padding>` **(** :ref:`Rect2<class_Rect2>` padding **)** |
  214. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  215. | void | :ref:`set_cell_row_background_color<class_RichTextLabel_method_set_cell_row_background_color>` **(** :ref:`Color<class_Color>` odd_row_bg, :ref:`Color<class_Color>` even_row_bg **)** |
  216. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  217. | void | :ref:`set_cell_size_override<class_RichTextLabel_method_set_cell_size_override>` **(** :ref:`Vector2<class_Vector2>` min_size, :ref:`Vector2<class_Vector2>` max_size **)** |
  218. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  219. | void | :ref:`set_table_column_expand<class_RichTextLabel_method_set_table_column_expand>` **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` expand, :ref:`int<class_int>` ratio=1 **)** |
  220. +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  221. .. rst-class:: classref-reftable-group
  222. Theme Properties
  223. ----------------
  224. .. table::
  225. :widths: auto
  226. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  227. | :ref:`Color<class_Color>` | :ref:`default_color<class_RichTextLabel_theme_color_default_color>` | ``Color(1, 1, 1, 1)`` |
  228. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  229. | :ref:`Color<class_Color>` | :ref:`font_outline_color<class_RichTextLabel_theme_color_font_outline_color>` | ``Color(1, 1, 1, 1)`` |
  230. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  231. | :ref:`Color<class_Color>` | :ref:`font_selected_color<class_RichTextLabel_theme_color_font_selected_color>` | ``Color(0, 0, 0, 0)`` |
  232. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  233. | :ref:`Color<class_Color>` | :ref:`font_shadow_color<class_RichTextLabel_theme_color_font_shadow_color>` | ``Color(0, 0, 0, 0)`` |
  234. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  235. | :ref:`Color<class_Color>` | :ref:`selection_color<class_RichTextLabel_theme_color_selection_color>` | ``Color(0.1, 0.1, 1, 0.8)`` |
  236. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  237. | :ref:`Color<class_Color>` | :ref:`table_border<class_RichTextLabel_theme_color_table_border>` | ``Color(0, 0, 0, 0)`` |
  238. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  239. | :ref:`Color<class_Color>` | :ref:`table_even_row_bg<class_RichTextLabel_theme_color_table_even_row_bg>` | ``Color(0, 0, 0, 0)`` |
  240. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  241. | :ref:`Color<class_Color>` | :ref:`table_odd_row_bg<class_RichTextLabel_theme_color_table_odd_row_bg>` | ``Color(0, 0, 0, 0)`` |
  242. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  243. | :ref:`int<class_int>` | :ref:`line_separation<class_RichTextLabel_theme_constant_line_separation>` | ``0`` |
  244. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  245. | :ref:`int<class_int>` | :ref:`outline_size<class_RichTextLabel_theme_constant_outline_size>` | ``0`` |
  246. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  247. | :ref:`int<class_int>` | :ref:`shadow_offset_x<class_RichTextLabel_theme_constant_shadow_offset_x>` | ``1`` |
  248. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  249. | :ref:`int<class_int>` | :ref:`shadow_offset_y<class_RichTextLabel_theme_constant_shadow_offset_y>` | ``1`` |
  250. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  251. | :ref:`int<class_int>` | :ref:`shadow_outline_size<class_RichTextLabel_theme_constant_shadow_outline_size>` | ``1`` |
  252. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  253. | :ref:`int<class_int>` | :ref:`table_h_separation<class_RichTextLabel_theme_constant_table_h_separation>` | ``3`` |
  254. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  255. | :ref:`int<class_int>` | :ref:`table_v_separation<class_RichTextLabel_theme_constant_table_v_separation>` | ``3`` |
  256. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  257. | :ref:`int<class_int>` | :ref:`text_highlight_h_padding<class_RichTextLabel_theme_constant_text_highlight_h_padding>` | ``3`` |
  258. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  259. | :ref:`int<class_int>` | :ref:`text_highlight_v_padding<class_RichTextLabel_theme_constant_text_highlight_v_padding>` | ``3`` |
  260. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  261. | :ref:`Font<class_Font>` | :ref:`bold_font<class_RichTextLabel_theme_font_bold_font>` | |
  262. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  263. | :ref:`Font<class_Font>` | :ref:`bold_italics_font<class_RichTextLabel_theme_font_bold_italics_font>` | |
  264. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  265. | :ref:`Font<class_Font>` | :ref:`italics_font<class_RichTextLabel_theme_font_italics_font>` | |
  266. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  267. | :ref:`Font<class_Font>` | :ref:`mono_font<class_RichTextLabel_theme_font_mono_font>` | |
  268. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  269. | :ref:`Font<class_Font>` | :ref:`normal_font<class_RichTextLabel_theme_font_normal_font>` | |
  270. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  271. | :ref:`int<class_int>` | :ref:`bold_font_size<class_RichTextLabel_theme_font_size_bold_font_size>` | |
  272. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  273. | :ref:`int<class_int>` | :ref:`bold_italics_font_size<class_RichTextLabel_theme_font_size_bold_italics_font_size>` | |
  274. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  275. | :ref:`int<class_int>` | :ref:`italics_font_size<class_RichTextLabel_theme_font_size_italics_font_size>` | |
  276. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  277. | :ref:`int<class_int>` | :ref:`mono_font_size<class_RichTextLabel_theme_font_size_mono_font_size>` | |
  278. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  279. | :ref:`int<class_int>` | :ref:`normal_font_size<class_RichTextLabel_theme_font_size_normal_font_size>` | |
  280. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  281. | :ref:`StyleBox<class_StyleBox>` | :ref:`focus<class_RichTextLabel_theme_style_focus>` | |
  282. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  283. | :ref:`StyleBox<class_StyleBox>` | :ref:`normal<class_RichTextLabel_theme_style_normal>` | |
  284. +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
  285. .. rst-class:: classref-section-separator
  286. ----
  287. .. rst-class:: classref-descriptions-group
  288. Signals
  289. -------
  290. .. _class_RichTextLabel_signal_finished:
  291. .. rst-class:: classref-signal
  292. **finished** **(** **)**
  293. Triggered when the document is fully loaded.
  294. .. rst-class:: classref-item-separator
  295. ----
  296. .. _class_RichTextLabel_signal_meta_clicked:
  297. .. rst-class:: classref-signal
  298. **meta_clicked** **(** :ref:`Variant<class_Variant>` meta **)**
  299. Triggered when the user clicks on content between meta tags. If the meta is defined in text, e.g. ``[url={"data"="hi"}]hi[/url]``, then the parameter for this signal will be a :ref:`String<class_String>` type. If a particular type or an object is desired, the :ref:`push_meta<class_RichTextLabel_method_push_meta>` method must be used to manually insert the data into the tag stack.
  300. .. rst-class:: classref-item-separator
  301. ----
  302. .. _class_RichTextLabel_signal_meta_hover_ended:
  303. .. rst-class:: classref-signal
  304. **meta_hover_ended** **(** :ref:`Variant<class_Variant>` meta **)**
  305. Triggers when the mouse exits a meta tag.
  306. .. rst-class:: classref-item-separator
  307. ----
  308. .. _class_RichTextLabel_signal_meta_hover_started:
  309. .. rst-class:: classref-signal
  310. **meta_hover_started** **(** :ref:`Variant<class_Variant>` meta **)**
  311. Triggers when the mouse enters a meta tag.
  312. .. rst-class:: classref-section-separator
  313. ----
  314. .. rst-class:: classref-descriptions-group
  315. Enumerations
  316. ------------
  317. .. _enum_RichTextLabel_ListType:
  318. .. rst-class:: classref-enumeration
  319. enum **ListType**:
  320. .. _class_RichTextLabel_constant_LIST_NUMBERS:
  321. .. rst-class:: classref-enumeration-constant
  322. :ref:`ListType<enum_RichTextLabel_ListType>` **LIST_NUMBERS** = ``0``
  323. Each list item has a number marker.
  324. .. _class_RichTextLabel_constant_LIST_LETTERS:
  325. .. rst-class:: classref-enumeration-constant
  326. :ref:`ListType<enum_RichTextLabel_ListType>` **LIST_LETTERS** = ``1``
  327. Each list item has a letter marker.
  328. .. _class_RichTextLabel_constant_LIST_ROMAN:
  329. .. rst-class:: classref-enumeration-constant
  330. :ref:`ListType<enum_RichTextLabel_ListType>` **LIST_ROMAN** = ``2``
  331. Each list item has a roman number marker.
  332. .. _class_RichTextLabel_constant_LIST_DOTS:
  333. .. rst-class:: classref-enumeration-constant
  334. :ref:`ListType<enum_RichTextLabel_ListType>` **LIST_DOTS** = ``3``
  335. Each list item has a filled circle marker.
  336. .. rst-class:: classref-item-separator
  337. ----
  338. .. _enum_RichTextLabel_MenuItems:
  339. .. rst-class:: classref-enumeration
  340. enum **MenuItems**:
  341. .. _class_RichTextLabel_constant_MENU_COPY:
  342. .. rst-class:: classref-enumeration-constant
  343. :ref:`MenuItems<enum_RichTextLabel_MenuItems>` **MENU_COPY** = ``0``
  344. Copies the selected text.
  345. .. _class_RichTextLabel_constant_MENU_SELECT_ALL:
  346. .. rst-class:: classref-enumeration-constant
  347. :ref:`MenuItems<enum_RichTextLabel_MenuItems>` **MENU_SELECT_ALL** = ``1``
  348. Selects the whole **RichTextLabel** text.
  349. .. _class_RichTextLabel_constant_MENU_MAX:
  350. .. rst-class:: classref-enumeration-constant
  351. :ref:`MenuItems<enum_RichTextLabel_MenuItems>` **MENU_MAX** = ``2``
  352. Represents the size of the :ref:`MenuItems<enum_RichTextLabel_MenuItems>` enum.
  353. .. rst-class:: classref-section-separator
  354. ----
  355. .. rst-class:: classref-descriptions-group
  356. Property Descriptions
  357. ---------------------
  358. .. _class_RichTextLabel_property_autowrap_mode:
  359. .. rst-class:: classref-property
  360. :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` **autowrap_mode** = ``3``
  361. .. rst-class:: classref-property-setget
  362. - void **set_autowrap_mode** **(** :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` value **)**
  363. - :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` **get_autowrap_mode** **(** **)**
  364. If set to something other than :ref:`TextServer.AUTOWRAP_OFF<class_TextServer_constant_AUTOWRAP_OFF>`, the text gets wrapped inside the node's bounding rectangle. To see how each mode behaves, see :ref:`AutowrapMode<enum_TextServer_AutowrapMode>`.
  365. .. rst-class:: classref-item-separator
  366. ----
  367. .. _class_RichTextLabel_property_bbcode_enabled:
  368. .. rst-class:: classref-property
  369. :ref:`bool<class_bool>` **bbcode_enabled** = ``false``
  370. .. rst-class:: classref-property-setget
  371. - void **set_use_bbcode** **(** :ref:`bool<class_bool>` value **)**
  372. - :ref:`bool<class_bool>` **is_using_bbcode** **(** **)**
  373. If ``true``, the label uses BBCode formatting.
  374. .. rst-class:: classref-item-separator
  375. ----
  376. .. _class_RichTextLabel_property_context_menu_enabled:
  377. .. rst-class:: classref-property
  378. :ref:`bool<class_bool>` **context_menu_enabled** = ``false``
  379. .. rst-class:: classref-property-setget
  380. - void **set_context_menu_enabled** **(** :ref:`bool<class_bool>` value **)**
  381. - :ref:`bool<class_bool>` **is_context_menu_enabled** **(** **)**
  382. If ``true``, a right-click displays the context menu.
  383. .. rst-class:: classref-item-separator
  384. ----
  385. .. _class_RichTextLabel_property_custom_effects:
  386. .. rst-class:: classref-property
  387. :ref:`Array<class_Array>` **custom_effects** = ``[]``
  388. .. rst-class:: classref-property-setget
  389. - void **set_effects** **(** :ref:`Array<class_Array>` value **)**
  390. - :ref:`Array<class_Array>` **get_effects** **(** **)**
  391. The currently installed custom effects. This is an array of :ref:`RichTextEffect<class_RichTextEffect>`\ s.
  392. To add a custom effect, it's more convenient to use :ref:`install_effect<class_RichTextLabel_method_install_effect>`.
  393. .. rst-class:: classref-item-separator
  394. ----
  395. .. _class_RichTextLabel_property_deselect_on_focus_loss_enabled:
  396. .. rst-class:: classref-property
  397. :ref:`bool<class_bool>` **deselect_on_focus_loss_enabled** = ``true``
  398. .. rst-class:: classref-property-setget
  399. - void **set_deselect_on_focus_loss_enabled** **(** :ref:`bool<class_bool>` value **)**
  400. - :ref:`bool<class_bool>` **is_deselect_on_focus_loss_enabled** **(** **)**
  401. If ``true``, the selected text will be deselected when focus is lost.
  402. .. rst-class:: classref-item-separator
  403. ----
  404. .. _class_RichTextLabel_property_drag_and_drop_selection_enabled:
  405. .. rst-class:: classref-property
  406. :ref:`bool<class_bool>` **drag_and_drop_selection_enabled** = ``true``
  407. .. rst-class:: classref-property-setget
  408. - void **set_drag_and_drop_selection_enabled** **(** :ref:`bool<class_bool>` value **)**
  409. - :ref:`bool<class_bool>` **is_drag_and_drop_selection_enabled** **(** **)**
  410. If ``true``, allow drag and drop of selected text.
  411. .. rst-class:: classref-item-separator
  412. ----
  413. .. _class_RichTextLabel_property_fit_content:
  414. .. rst-class:: classref-property
  415. :ref:`bool<class_bool>` **fit_content** = ``false``
  416. .. rst-class:: classref-property-setget
  417. - void **set_fit_content** **(** :ref:`bool<class_bool>` value **)**
  418. - :ref:`bool<class_bool>` **is_fit_content_enabled** **(** **)**
  419. If ``true``, the label's minimum size will be automatically updated to fit its content, matching the behavior of :ref:`Label<class_Label>`.
  420. .. rst-class:: classref-item-separator
  421. ----
  422. .. _class_RichTextLabel_property_hint_underlined:
  423. .. rst-class:: classref-property
  424. :ref:`bool<class_bool>` **hint_underlined** = ``true``
  425. .. rst-class:: classref-property-setget
  426. - void **set_hint_underline** **(** :ref:`bool<class_bool>` value **)**
  427. - :ref:`bool<class_bool>` **is_hint_underlined** **(** **)**
  428. If ``true``, the label underlines hint tags such as ``[hint=description]{text}[/hint]``.
  429. .. rst-class:: classref-item-separator
  430. ----
  431. .. _class_RichTextLabel_property_language:
  432. .. rst-class:: classref-property
  433. :ref:`String<class_String>` **language** = ``""``
  434. .. rst-class:: classref-property-setget
  435. - void **set_language** **(** :ref:`String<class_String>` value **)**
  436. - :ref:`String<class_String>` **get_language** **(** **)**
  437. Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
  438. .. rst-class:: classref-item-separator
  439. ----
  440. .. _class_RichTextLabel_property_meta_underlined:
  441. .. rst-class:: classref-property
  442. :ref:`bool<class_bool>` **meta_underlined** = ``true``
  443. .. rst-class:: classref-property-setget
  444. - void **set_meta_underline** **(** :ref:`bool<class_bool>` value **)**
  445. - :ref:`bool<class_bool>` **is_meta_underlined** **(** **)**
  446. If ``true``, the label underlines meta tags such as ``[url]{text}[/url]``.
  447. .. rst-class:: classref-item-separator
  448. ----
  449. .. _class_RichTextLabel_property_progress_bar_delay:
  450. .. rst-class:: classref-property
  451. :ref:`int<class_int>` **progress_bar_delay** = ``1000``
  452. .. rst-class:: classref-property-setget
  453. - void **set_progress_bar_delay** **(** :ref:`int<class_int>` value **)**
  454. - :ref:`int<class_int>` **get_progress_bar_delay** **(** **)**
  455. The delay after which the loading progress bar is displayed, in milliseconds. Set to ``-1`` to disable progress bar entirely.
  456. \ **Note:** Progress bar is displayed only if :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled.
  457. .. rst-class:: classref-item-separator
  458. ----
  459. .. _class_RichTextLabel_property_scroll_active:
  460. .. rst-class:: classref-property
  461. :ref:`bool<class_bool>` **scroll_active** = ``true``
  462. .. rst-class:: classref-property-setget
  463. - void **set_scroll_active** **(** :ref:`bool<class_bool>` value **)**
  464. - :ref:`bool<class_bool>` **is_scroll_active** **(** **)**
  465. If ``true``, the scrollbar is visible. Setting this to ``false`` does not block scrolling completely. See :ref:`scroll_to_line<class_RichTextLabel_method_scroll_to_line>`.
  466. .. rst-class:: classref-item-separator
  467. ----
  468. .. _class_RichTextLabel_property_scroll_following:
  469. .. rst-class:: classref-property
  470. :ref:`bool<class_bool>` **scroll_following** = ``false``
  471. .. rst-class:: classref-property-setget
  472. - void **set_scroll_follow** **(** :ref:`bool<class_bool>` value **)**
  473. - :ref:`bool<class_bool>` **is_scroll_following** **(** **)**
  474. If ``true``, the window scrolls down to display new content automatically.
  475. .. rst-class:: classref-item-separator
  476. ----
  477. .. _class_RichTextLabel_property_selection_enabled:
  478. .. rst-class:: classref-property
  479. :ref:`bool<class_bool>` **selection_enabled** = ``false``
  480. .. rst-class:: classref-property-setget
  481. - void **set_selection_enabled** **(** :ref:`bool<class_bool>` value **)**
  482. - :ref:`bool<class_bool>` **is_selection_enabled** **(** **)**
  483. If ``true``, the label allows text selection.
  484. .. rst-class:: classref-item-separator
  485. ----
  486. .. _class_RichTextLabel_property_shortcut_keys_enabled:
  487. .. rst-class:: classref-property
  488. :ref:`bool<class_bool>` **shortcut_keys_enabled** = ``true``
  489. .. rst-class:: classref-property-setget
  490. - void **set_shortcut_keys_enabled** **(** :ref:`bool<class_bool>` value **)**
  491. - :ref:`bool<class_bool>` **is_shortcut_keys_enabled** **(** **)**
  492. If ``true``, shortcut keys for context menu items are enabled, even if the context menu is disabled.
  493. .. rst-class:: classref-item-separator
  494. ----
  495. .. _class_RichTextLabel_property_structured_text_bidi_override:
  496. .. rst-class:: classref-property
  497. :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **structured_text_bidi_override** = ``0``
  498. .. rst-class:: classref-property-setget
  499. - void **set_structured_text_bidi_override** **(** :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` value **)**
  500. - :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **get_structured_text_bidi_override** **(** **)**
  501. Set BiDi algorithm override for the structured text.
  502. .. rst-class:: classref-item-separator
  503. ----
  504. .. _class_RichTextLabel_property_structured_text_bidi_override_options:
  505. .. rst-class:: classref-property
  506. :ref:`Array<class_Array>` **structured_text_bidi_override_options** = ``[]``
  507. .. rst-class:: classref-property-setget
  508. - void **set_structured_text_bidi_override_options** **(** :ref:`Array<class_Array>` value **)**
  509. - :ref:`Array<class_Array>` **get_structured_text_bidi_override_options** **(** **)**
  510. Set additional options for BiDi override.
  511. .. rst-class:: classref-item-separator
  512. ----
  513. .. _class_RichTextLabel_property_tab_size:
  514. .. rst-class:: classref-property
  515. :ref:`int<class_int>` **tab_size** = ``4``
  516. .. rst-class:: classref-property-setget
  517. - void **set_tab_size** **(** :ref:`int<class_int>` value **)**
  518. - :ref:`int<class_int>` **get_tab_size** **(** **)**
  519. The number of spaces associated with a single tab length. Does not affect ``\t`` in text tags, only indent tags.
  520. .. rst-class:: classref-item-separator
  521. ----
  522. .. _class_RichTextLabel_property_text:
  523. .. rst-class:: classref-property
  524. :ref:`String<class_String>` **text** = ``""``
  525. .. rst-class:: classref-property-setget
  526. - void **set_text** **(** :ref:`String<class_String>` value **)**
  527. - :ref:`String<class_String>` **get_text** **(** **)**
  528. The label's text in BBCode format. Is not representative of manual modifications to the internal tag stack. Erases changes made by other methods when edited.
  529. \ **Note:** If :ref:`bbcode_enabled<class_RichTextLabel_property_bbcode_enabled>` is ``true``, it is unadvised to use the ``+=`` operator with ``text`` (e.g. ``text += "some string"``) as it replaces the whole text and can cause slowdowns. It will also erase all BBCode that was added to stack using ``push_*`` methods. Use :ref:`append_text<class_RichTextLabel_method_append_text>` for adding text instead, unless you absolutely need to close a tag that was opened in an earlier method call.
  530. .. rst-class:: classref-item-separator
  531. ----
  532. .. _class_RichTextLabel_property_text_direction:
  533. .. rst-class:: classref-property
  534. :ref:`TextDirection<enum_Control_TextDirection>` **text_direction** = ``0``
  535. .. rst-class:: classref-property-setget
  536. - void **set_text_direction** **(** :ref:`TextDirection<enum_Control_TextDirection>` value **)**
  537. - :ref:`TextDirection<enum_Control_TextDirection>` **get_text_direction** **(** **)**
  538. Base text writing direction.
  539. .. rst-class:: classref-item-separator
  540. ----
  541. .. _class_RichTextLabel_property_threaded:
  542. .. rst-class:: classref-property
  543. :ref:`bool<class_bool>` **threaded** = ``false``
  544. .. rst-class:: classref-property-setget
  545. - void **set_threaded** **(** :ref:`bool<class_bool>` value **)**
  546. - :ref:`bool<class_bool>` **is_threaded** **(** **)**
  547. If ``true``, text processing is done in a background thread.
  548. .. rst-class:: classref-item-separator
  549. ----
  550. .. _class_RichTextLabel_property_visible_characters:
  551. .. rst-class:: classref-property
  552. :ref:`int<class_int>` **visible_characters** = ``-1``
  553. .. rst-class:: classref-property-setget
  554. - void **set_visible_characters** **(** :ref:`int<class_int>` value **)**
  555. - :ref:`int<class_int>` **get_visible_characters** **(** **)**
  556. The number of characters to display. If set to ``-1``, all characters are displayed. This can be useful when animating the text appearing in a dialog box.
  557. \ **Note:** Setting this property updates :ref:`visible_ratio<class_RichTextLabel_property_visible_ratio>` accordingly.
  558. .. rst-class:: classref-item-separator
  559. ----
  560. .. _class_RichTextLabel_property_visible_characters_behavior:
  561. .. rst-class:: classref-property
  562. :ref:`VisibleCharactersBehavior<enum_TextServer_VisibleCharactersBehavior>` **visible_characters_behavior** = ``0``
  563. .. rst-class:: classref-property-setget
  564. - void **set_visible_characters_behavior** **(** :ref:`VisibleCharactersBehavior<enum_TextServer_VisibleCharactersBehavior>` value **)**
  565. - :ref:`VisibleCharactersBehavior<enum_TextServer_VisibleCharactersBehavior>` **get_visible_characters_behavior** **(** **)**
  566. Sets the clipping behavior when :ref:`visible_characters<class_RichTextLabel_property_visible_characters>` or :ref:`visible_ratio<class_RichTextLabel_property_visible_ratio>` is set. See :ref:`VisibleCharactersBehavior<enum_TextServer_VisibleCharactersBehavior>` for more info.
  567. .. rst-class:: classref-item-separator
  568. ----
  569. .. _class_RichTextLabel_property_visible_ratio:
  570. .. rst-class:: classref-property
  571. :ref:`float<class_float>` **visible_ratio** = ``1.0``
  572. .. rst-class:: classref-property-setget
  573. - void **set_visible_ratio** **(** :ref:`float<class_float>` value **)**
  574. - :ref:`float<class_float>` **get_visible_ratio** **(** **)**
  575. The fraction of characters to display, relative to the total number of characters (see :ref:`get_total_character_count<class_RichTextLabel_method_get_total_character_count>`). If set to ``1.0``, all characters are displayed. If set to ``0.5``, only half of the characters will be displayed. This can be useful when animating the text appearing in a dialog box.
  576. \ **Note:** Setting this property updates :ref:`visible_characters<class_RichTextLabel_property_visible_characters>` accordingly.
  577. .. rst-class:: classref-section-separator
  578. ----
  579. .. rst-class:: classref-descriptions-group
  580. Method Descriptions
  581. -------------------
  582. .. _class_RichTextLabel_method_add_image:
  583. .. rst-class:: classref-method
  584. void **add_image** **(** :ref:`Texture2D<class_Texture2D>` image, :ref:`int<class_int>` width=0, :ref:`int<class_int>` height=0, :ref:`Color<class_Color>` color=Color(1, 1, 1, 1), :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` inline_align=5, :ref:`Rect2<class_Rect2>` region=Rect2(0, 0, 0, 0) **)**
  585. Adds an image's opening and closing tags to the tag stack, optionally providing a ``width`` and ``height`` to resize the image, a ``color`` to tint the image and a ``region`` to only use parts of the image.
  586. If ``width`` or ``height`` is set to 0, the image size will be adjusted in order to keep the original aspect ratio.
  587. If ``width`` and ``height`` are not set, but ``region`` is, the region's rect will be used.
  588. .. rst-class:: classref-item-separator
  589. ----
  590. .. _class_RichTextLabel_method_add_text:
  591. .. rst-class:: classref-method
  592. void **add_text** **(** :ref:`String<class_String>` text **)**
  593. Adds raw non-BBCode-parsed text to the tag stack.
  594. .. rst-class:: classref-item-separator
  595. ----
  596. .. _class_RichTextLabel_method_append_text:
  597. .. rst-class:: classref-method
  598. void **append_text** **(** :ref:`String<class_String>` bbcode **)**
  599. Parses ``bbcode`` and adds tags to the tag stack as needed.
  600. \ **Note:** Using this method, you can't close a tag that was opened in a previous :ref:`append_text<class_RichTextLabel_method_append_text>` call. This is done to improve performance, especially when updating large RichTextLabels since rebuilding the whole BBCode every time would be slower. If you absolutely need to close a tag in a future method call, append the :ref:`text<class_RichTextLabel_property_text>` instead of using :ref:`append_text<class_RichTextLabel_method_append_text>`.
  601. .. rst-class:: classref-item-separator
  602. ----
  603. .. _class_RichTextLabel_method_clear:
  604. .. rst-class:: classref-method
  605. void **clear** **(** **)**
  606. Clears the tag stack.
  607. \ **Note:** This method will not modify :ref:`text<class_RichTextLabel_property_text>`, but setting :ref:`text<class_RichTextLabel_property_text>` to an empty string also clears the stack.
  608. .. rst-class:: classref-item-separator
  609. ----
  610. .. _class_RichTextLabel_method_deselect:
  611. .. rst-class:: classref-method
  612. void **deselect** **(** **)**
  613. Clears the current selection.
  614. .. rst-class:: classref-item-separator
  615. ----
  616. .. _class_RichTextLabel_method_get_character_line:
  617. .. rst-class:: classref-method
  618. :ref:`int<class_int>` **get_character_line** **(** :ref:`int<class_int>` character **)**
  619. Returns the line number of the character position provided.
  620. \ **Note:** If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, this method returns a value for the loaded part of the document. Use :ref:`is_ready<class_RichTextLabel_method_is_ready>` or :ref:`finished<class_RichTextLabel_signal_finished>` to determine whether document is fully loaded.
  621. .. rst-class:: classref-item-separator
  622. ----
  623. .. _class_RichTextLabel_method_get_character_paragraph:
  624. .. rst-class:: classref-method
  625. :ref:`int<class_int>` **get_character_paragraph** **(** :ref:`int<class_int>` character **)**
  626. Returns the paragraph number of the character position provided.
  627. \ **Note:** If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, this method returns a value for the loaded part of the document. Use :ref:`is_ready<class_RichTextLabel_method_is_ready>` or :ref:`finished<class_RichTextLabel_signal_finished>` to determine whether document is fully loaded.
  628. .. rst-class:: classref-item-separator
  629. ----
  630. .. _class_RichTextLabel_method_get_content_height:
  631. .. rst-class:: classref-method
  632. :ref:`int<class_int>` **get_content_height** **(** **)** |const|
  633. Returns the height of the content.
  634. \ **Note:** If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, this method returns a value for the loaded part of the document. Use :ref:`is_ready<class_RichTextLabel_method_is_ready>` or :ref:`finished<class_RichTextLabel_signal_finished>` to determine whether document is fully loaded.
  635. .. rst-class:: classref-item-separator
  636. ----
  637. .. _class_RichTextLabel_method_get_content_width:
  638. .. rst-class:: classref-method
  639. :ref:`int<class_int>` **get_content_width** **(** **)** |const|
  640. Returns the width of the content.
  641. \ **Note:** If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, this method returns a value for the loaded part of the document. Use :ref:`is_ready<class_RichTextLabel_method_is_ready>` or :ref:`finished<class_RichTextLabel_signal_finished>` to determine whether document is fully loaded.
  642. .. rst-class:: classref-item-separator
  643. ----
  644. .. _class_RichTextLabel_method_get_line_count:
  645. .. rst-class:: classref-method
  646. :ref:`int<class_int>` **get_line_count** **(** **)** |const|
  647. Returns the total number of lines in the text. Wrapped text is counted as multiple lines.
  648. \ **Note:** If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, this method returns a value for the loaded part of the document. Use :ref:`is_ready<class_RichTextLabel_method_is_ready>` or :ref:`finished<class_RichTextLabel_signal_finished>` to determine whether document is fully loaded.
  649. .. rst-class:: classref-item-separator
  650. ----
  651. .. _class_RichTextLabel_method_get_line_offset:
  652. .. rst-class:: classref-method
  653. :ref:`float<class_float>` **get_line_offset** **(** :ref:`int<class_int>` line **)**
  654. Returns the vertical offset of the line found at the provided index.
  655. \ **Note:** If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, this method returns a value for the loaded part of the document. Use :ref:`is_ready<class_RichTextLabel_method_is_ready>` or :ref:`finished<class_RichTextLabel_signal_finished>` to determine whether document is fully loaded.
  656. .. rst-class:: classref-item-separator
  657. ----
  658. .. _class_RichTextLabel_method_get_menu:
  659. .. rst-class:: classref-method
  660. :ref:`PopupMenu<class_PopupMenu>` **get_menu** **(** **)** |const|
  661. Returns the :ref:`PopupMenu<class_PopupMenu>` of this **RichTextLabel**. By default, this menu is displayed when right-clicking on the **RichTextLabel**.
  662. You can add custom menu items or remove standard ones. Make sure your IDs don't conflict with the standard ones (see :ref:`MenuItems<enum_RichTextLabel_MenuItems>`). For example:
  663. .. tabs::
  664. .. code-tab:: gdscript
  665. func _ready():
  666. var menu = get_menu()
  667. # Remove "Select All" item.
  668. menu.remove_item(MENU_SELECT_ALL)
  669. # Add custom items.
  670. menu.add_separator()
  671. menu.add_item("Duplicate Text", MENU_MAX + 1)
  672. # Connect callback.
  673. menu.id_pressed.connect(_on_item_pressed)
  674. func _on_item_pressed(id):
  675. if id == MENU_MAX + 1:
  676. add_text("\n" + get_parsed_text())
  677. .. code-tab:: csharp
  678. public override void _Ready()
  679. {
  680. var menu = GetMenu();
  681. // Remove "Select All" item.
  682. menu.RemoveItem(RichTextLabel.MenuItems.SelectAll);
  683. // Add custom items.
  684. menu.AddSeparator();
  685. menu.AddItem("Duplicate Text", RichTextLabel.MenuItems.Max + 1);
  686. // Add event handler.
  687. menu.IdPressed += OnItemPressed;
  688. }
  689. public void OnItemPressed(int id)
  690. {
  691. if (id == TextEdit.MenuItems.Max + 1)
  692. {
  693. AddText("\n" + GetParsedText());
  694. }
  695. }
  696. \ **Warning:** This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their :ref:`Window.visible<class_Window_property_visible>` property.
  697. .. rst-class:: classref-item-separator
  698. ----
  699. .. _class_RichTextLabel_method_get_paragraph_count:
  700. .. rst-class:: classref-method
  701. :ref:`int<class_int>` **get_paragraph_count** **(** **)** |const|
  702. Returns the total number of paragraphs (newlines or ``p`` tags in the tag stack's text tags). Considers wrapped text as one paragraph.
  703. .. rst-class:: classref-item-separator
  704. ----
  705. .. _class_RichTextLabel_method_get_paragraph_offset:
  706. .. rst-class:: classref-method
  707. :ref:`float<class_float>` **get_paragraph_offset** **(** :ref:`int<class_int>` paragraph **)**
  708. Returns the vertical offset of the paragraph found at the provided index.
  709. \ **Note:** If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, this method returns a value for the loaded part of the document. Use :ref:`is_ready<class_RichTextLabel_method_is_ready>` or :ref:`finished<class_RichTextLabel_signal_finished>` to determine whether document is fully loaded.
  710. .. rst-class:: classref-item-separator
  711. ----
  712. .. _class_RichTextLabel_method_get_parsed_text:
  713. .. rst-class:: classref-method
  714. :ref:`String<class_String>` **get_parsed_text** **(** **)** |const|
  715. Returns the text without BBCode mark-up.
  716. .. rst-class:: classref-item-separator
  717. ----
  718. .. _class_RichTextLabel_method_get_selected_text:
  719. .. rst-class:: classref-method
  720. :ref:`String<class_String>` **get_selected_text** **(** **)** |const|
  721. Returns the current selection text. Does not include BBCodes.
  722. .. rst-class:: classref-item-separator
  723. ----
  724. .. _class_RichTextLabel_method_get_selection_from:
  725. .. rst-class:: classref-method
  726. :ref:`int<class_int>` **get_selection_from** **(** **)** |const|
  727. Returns the current selection first character index if a selection is active, ``-1`` otherwise. Does not include BBCodes.
  728. .. rst-class:: classref-item-separator
  729. ----
  730. .. _class_RichTextLabel_method_get_selection_to:
  731. .. rst-class:: classref-method
  732. :ref:`int<class_int>` **get_selection_to** **(** **)** |const|
  733. Returns the current selection last character index if a selection is active, ``-1`` otherwise. Does not include BBCodes.
  734. .. rst-class:: classref-item-separator
  735. ----
  736. .. _class_RichTextLabel_method_get_total_character_count:
  737. .. rst-class:: classref-method
  738. :ref:`int<class_int>` **get_total_character_count** **(** **)** |const|
  739. Returns the total number of characters from text tags. Does not include BBCodes.
  740. .. rst-class:: classref-item-separator
  741. ----
  742. .. _class_RichTextLabel_method_get_v_scroll_bar:
  743. .. rst-class:: classref-method
  744. :ref:`VScrollBar<class_VScrollBar>` **get_v_scroll_bar** **(** **)**
  745. Returns the vertical scrollbar.
  746. \ **Warning:** This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their :ref:`CanvasItem.visible<class_CanvasItem_property_visible>` property.
  747. .. rst-class:: classref-item-separator
  748. ----
  749. .. _class_RichTextLabel_method_get_visible_line_count:
  750. .. rst-class:: classref-method
  751. :ref:`int<class_int>` **get_visible_line_count** **(** **)** |const|
  752. Returns the number of visible lines.
  753. \ **Note:** If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, this method returns a value for the loaded part of the document. Use :ref:`is_ready<class_RichTextLabel_method_is_ready>` or :ref:`finished<class_RichTextLabel_signal_finished>` to determine whether document is fully loaded.
  754. .. rst-class:: classref-item-separator
  755. ----
  756. .. _class_RichTextLabel_method_get_visible_paragraph_count:
  757. .. rst-class:: classref-method
  758. :ref:`int<class_int>` **get_visible_paragraph_count** **(** **)** |const|
  759. Returns the number of visible paragraphs. A paragraph is considered visible if at least one of its lines is visible.
  760. \ **Note:** If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, this method returns a value for the loaded part of the document. Use :ref:`is_ready<class_RichTextLabel_method_is_ready>` or :ref:`finished<class_RichTextLabel_signal_finished>` to determine whether document is fully loaded.
  761. .. rst-class:: classref-item-separator
  762. ----
  763. .. _class_RichTextLabel_method_install_effect:
  764. .. rst-class:: classref-method
  765. void **install_effect** **(** :ref:`Variant<class_Variant>` effect **)**
  766. Installs a custom effect. ``effect`` should be a valid :ref:`RichTextEffect<class_RichTextEffect>`.
  767. .. rst-class:: classref-item-separator
  768. ----
  769. .. _class_RichTextLabel_method_is_menu_visible:
  770. .. rst-class:: classref-method
  771. :ref:`bool<class_bool>` **is_menu_visible** **(** **)** |const|
  772. Returns whether the menu is visible. Use this instead of ``get_menu().visible`` to improve performance (so the creation of the menu is avoided).
  773. .. rst-class:: classref-item-separator
  774. ----
  775. .. _class_RichTextLabel_method_is_ready:
  776. .. rst-class:: classref-method
  777. :ref:`bool<class_bool>` **is_ready** **(** **)** |const|
  778. If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, returns ``true`` if the background thread has finished text processing, otherwise always return ``true``.
  779. .. rst-class:: classref-item-separator
  780. ----
  781. .. _class_RichTextLabel_method_menu_option:
  782. .. rst-class:: classref-method
  783. void **menu_option** **(** :ref:`int<class_int>` option **)**
  784. Executes a given action as defined in the :ref:`MenuItems<enum_RichTextLabel_MenuItems>` enum.
  785. .. rst-class:: classref-item-separator
  786. ----
  787. .. _class_RichTextLabel_method_newline:
  788. .. rst-class:: classref-method
  789. void **newline** **(** **)**
  790. Adds a newline tag to the tag stack.
  791. .. rst-class:: classref-item-separator
  792. ----
  793. .. _class_RichTextLabel_method_parse_bbcode:
  794. .. rst-class:: classref-method
  795. void **parse_bbcode** **(** :ref:`String<class_String>` bbcode **)**
  796. The assignment version of :ref:`append_text<class_RichTextLabel_method_append_text>`. Clears the tag stack and inserts the new content.
  797. .. rst-class:: classref-item-separator
  798. ----
  799. .. _class_RichTextLabel_method_parse_expressions_for_values:
  800. .. rst-class:: classref-method
  801. :ref:`Dictionary<class_Dictionary>` **parse_expressions_for_values** **(** :ref:`PackedStringArray<class_PackedStringArray>` expressions **)**
  802. Parses BBCode parameter ``expressions`` into a dictionary.
  803. .. rst-class:: classref-item-separator
  804. ----
  805. .. _class_RichTextLabel_method_pop:
  806. .. rst-class:: classref-method
  807. void **pop** **(** **)**
  808. Terminates the current tag. Use after ``push_*`` methods to close BBCodes manually. Does not need to follow ``add_*`` methods.
  809. .. rst-class:: classref-item-separator
  810. ----
  811. .. _class_RichTextLabel_method_pop_all:
  812. .. rst-class:: classref-method
  813. void **pop_all** **(** **)**
  814. Terminates all tags opened by ``push_*`` methods.
  815. .. rst-class:: classref-item-separator
  816. ----
  817. .. _class_RichTextLabel_method_pop_context:
  818. .. rst-class:: classref-method
  819. void **pop_context** **(** **)**
  820. Terminates tags opened after the last :ref:`push_context<class_RichTextLabel_method_push_context>` call (including context marker), or all tags if there's no context marker on the stack.
  821. .. rst-class:: classref-item-separator
  822. ----
  823. .. _class_RichTextLabel_method_push_bgcolor:
  824. .. rst-class:: classref-method
  825. void **push_bgcolor** **(** :ref:`Color<class_Color>` bgcolor **)**
  826. Adds a ``[bgcolor]`` tag to the tag stack.
  827. .. rst-class:: classref-item-separator
  828. ----
  829. .. _class_RichTextLabel_method_push_bold:
  830. .. rst-class:: classref-method
  831. void **push_bold** **(** **)**
  832. Adds a ``[font]`` tag with a bold font to the tag stack. This is the same as adding a ``[b]`` tag if not currently in a ``[i]`` tag.
  833. .. rst-class:: classref-item-separator
  834. ----
  835. .. _class_RichTextLabel_method_push_bold_italics:
  836. .. rst-class:: classref-method
  837. void **push_bold_italics** **(** **)**
  838. Adds a ``[font]`` tag with a bold italics font to the tag stack.
  839. .. rst-class:: classref-item-separator
  840. ----
  841. .. _class_RichTextLabel_method_push_cell:
  842. .. rst-class:: classref-method
  843. void **push_cell** **(** **)**
  844. Adds a ``[cell]`` tag to the tag stack. Must be inside a ``[table]`` tag. See :ref:`push_table<class_RichTextLabel_method_push_table>` for details.
  845. .. rst-class:: classref-item-separator
  846. ----
  847. .. _class_RichTextLabel_method_push_color:
  848. .. rst-class:: classref-method
  849. void **push_color** **(** :ref:`Color<class_Color>` color **)**
  850. Adds a ``[color]`` tag to the tag stack.
  851. .. rst-class:: classref-item-separator
  852. ----
  853. .. _class_RichTextLabel_method_push_context:
  854. .. rst-class:: classref-method
  855. void **push_context** **(** **)**
  856. Adds a context marker to the tag stack. See :ref:`pop_context<class_RichTextLabel_method_pop_context>`.
  857. .. rst-class:: classref-item-separator
  858. ----
  859. .. _class_RichTextLabel_method_push_customfx:
  860. .. rst-class:: classref-method
  861. void **push_customfx** **(** :ref:`RichTextEffect<class_RichTextEffect>` effect, :ref:`Dictionary<class_Dictionary>` env **)**
  862. Adds a custom effect tag to the tag stack. The effect does not need to be in :ref:`custom_effects<class_RichTextLabel_property_custom_effects>`. The environment is directly passed to the effect.
  863. .. rst-class:: classref-item-separator
  864. ----
  865. .. _class_RichTextLabel_method_push_dropcap:
  866. .. rst-class:: classref-method
  867. void **push_dropcap** **(** :ref:`String<class_String>` string, :ref:`Font<class_Font>` font, :ref:`int<class_int>` size, :ref:`Rect2<class_Rect2>` dropcap_margins=Rect2(0, 0, 0, 0), :ref:`Color<class_Color>` color=Color(1, 1, 1, 1), :ref:`int<class_int>` outline_size=0, :ref:`Color<class_Color>` outline_color=Color(0, 0, 0, 0) **)**
  868. Adds a ``[dropcap]`` tag to the tag stack. Drop cap (dropped capital) is a decorative element at the beginning of a paragraph that is larger than the rest of the text.
  869. .. rst-class:: classref-item-separator
  870. ----
  871. .. _class_RichTextLabel_method_push_fgcolor:
  872. .. rst-class:: classref-method
  873. void **push_fgcolor** **(** :ref:`Color<class_Color>` fgcolor **)**
  874. Adds a ``[fgcolor]`` tag to the tag stack.
  875. .. rst-class:: classref-item-separator
  876. ----
  877. .. _class_RichTextLabel_method_push_font:
  878. .. rst-class:: classref-method
  879. void **push_font** **(** :ref:`Font<class_Font>` font, :ref:`int<class_int>` font_size=0 **)**
  880. Adds a ``[font]`` tag to the tag stack. Overrides default fonts for its duration.
  881. Passing ``0`` to ``font_size`` will use the existing default font size.
  882. .. rst-class:: classref-item-separator
  883. ----
  884. .. _class_RichTextLabel_method_push_font_size:
  885. .. rst-class:: classref-method
  886. void **push_font_size** **(** :ref:`int<class_int>` font_size **)**
  887. Adds a ``[font_size]`` tag to the tag stack. Overrides default font size for its duration.
  888. .. rst-class:: classref-item-separator
  889. ----
  890. .. _class_RichTextLabel_method_push_hint:
  891. .. rst-class:: classref-method
  892. void **push_hint** **(** :ref:`String<class_String>` description **)**
  893. Adds a ``[hint]`` tag to the tag stack. Same as BBCode ``[hint=something]{text}[/hint]``.
  894. .. rst-class:: classref-item-separator
  895. ----
  896. .. _class_RichTextLabel_method_push_indent:
  897. .. rst-class:: classref-method
  898. void **push_indent** **(** :ref:`int<class_int>` level **)**
  899. Adds an ``[indent]`` tag to the tag stack. Multiplies ``level`` by current :ref:`tab_size<class_RichTextLabel_property_tab_size>` to determine new margin length.
  900. .. rst-class:: classref-item-separator
  901. ----
  902. .. _class_RichTextLabel_method_push_italics:
  903. .. rst-class:: classref-method
  904. void **push_italics** **(** **)**
  905. Adds a ``[font]`` tag with an italics font to the tag stack. This is the same as adding an ``[i]`` tag if not currently in a ``[b]`` tag.
  906. .. rst-class:: classref-item-separator
  907. ----
  908. .. _class_RichTextLabel_method_push_language:
  909. .. rst-class:: classref-method
  910. void **push_language** **(** :ref:`String<class_String>` language **)**
  911. Adds language code used for text shaping algorithm and Open-Type font features.
  912. .. rst-class:: classref-item-separator
  913. ----
  914. .. _class_RichTextLabel_method_push_list:
  915. .. rst-class:: classref-method
  916. void **push_list** **(** :ref:`int<class_int>` level, :ref:`ListType<enum_RichTextLabel_ListType>` type, :ref:`bool<class_bool>` capitalize, :ref:`String<class_String>` bullet="•" **)**
  917. Adds ``[ol]`` or ``[ul]`` tag to the tag stack. Multiplies ``level`` by current :ref:`tab_size<class_RichTextLabel_property_tab_size>` to determine new margin length.
  918. .. rst-class:: classref-item-separator
  919. ----
  920. .. _class_RichTextLabel_method_push_meta:
  921. .. rst-class:: classref-method
  922. void **push_meta** **(** :ref:`Variant<class_Variant>` data **)**
  923. Adds a meta tag to the tag stack. Similar to the BBCode ``[url=something]{text}[/url]``, but supports non-:ref:`String<class_String>` metadata types.
  924. .. rst-class:: classref-item-separator
  925. ----
  926. .. _class_RichTextLabel_method_push_mono:
  927. .. rst-class:: classref-method
  928. void **push_mono** **(** **)**
  929. Adds a ``[font]`` tag with a monospace font to the tag stack.
  930. .. rst-class:: classref-item-separator
  931. ----
  932. .. _class_RichTextLabel_method_push_normal:
  933. .. rst-class:: classref-method
  934. void **push_normal** **(** **)**
  935. Adds a ``[font]`` tag with a normal font to the tag stack.
  936. .. rst-class:: classref-item-separator
  937. ----
  938. .. _class_RichTextLabel_method_push_outline_color:
  939. .. rst-class:: classref-method
  940. void **push_outline_color** **(** :ref:`Color<class_Color>` color **)**
  941. Adds a ``[outline_color]`` tag to the tag stack. Adds text outline for its duration.
  942. .. rst-class:: classref-item-separator
  943. ----
  944. .. _class_RichTextLabel_method_push_outline_size:
  945. .. rst-class:: classref-method
  946. void **push_outline_size** **(** :ref:`int<class_int>` outline_size **)**
  947. Adds a ``[outline_size]`` tag to the tag stack. Overrides default text outline size for its duration.
  948. .. rst-class:: classref-item-separator
  949. ----
  950. .. _class_RichTextLabel_method_push_paragraph:
  951. .. rst-class:: classref-method
  952. void **push_paragraph** **(** :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` alignment, :ref:`TextDirection<enum_Control_TextDirection>` base_direction=0, :ref:`String<class_String>` language="", :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` st_parser=0, |bitfield|\<:ref:`JustificationFlag<enum_TextServer_JustificationFlag>`\> justification_flags=163, :ref:`PackedFloat32Array<class_PackedFloat32Array>` tab_stops=PackedFloat32Array() **)**
  953. Adds a ``[p]`` tag to the tag stack.
  954. .. rst-class:: classref-item-separator
  955. ----
  956. .. _class_RichTextLabel_method_push_strikethrough:
  957. .. rst-class:: classref-method
  958. void **push_strikethrough** **(** **)**
  959. Adds a ``[s]`` tag to the tag stack.
  960. .. rst-class:: classref-item-separator
  961. ----
  962. .. _class_RichTextLabel_method_push_table:
  963. .. rst-class:: classref-method
  964. void **push_table** **(** :ref:`int<class_int>` columns, :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` inline_align=0, :ref:`int<class_int>` align_to_row=-1 **)**
  965. Adds a ``[table=columns,inline_align]`` tag to the tag stack.
  966. .. rst-class:: classref-item-separator
  967. ----
  968. .. _class_RichTextLabel_method_push_underline:
  969. .. rst-class:: classref-method
  970. void **push_underline** **(** **)**
  971. Adds a ``[u]`` tag to the tag stack.
  972. .. rst-class:: classref-item-separator
  973. ----
  974. .. _class_RichTextLabel_method_remove_paragraph:
  975. .. rst-class:: classref-method
  976. :ref:`bool<class_bool>` **remove_paragraph** **(** :ref:`int<class_int>` paragraph **)**
  977. Removes a paragraph of content from the label. Returns ``true`` if the paragraph exists.
  978. The ``paragraph`` argument is the index of the paragraph to remove, it can take values in the interval ``[0, get_paragraph_count() - 1]``.
  979. .. rst-class:: classref-item-separator
  980. ----
  981. .. _class_RichTextLabel_method_scroll_to_line:
  982. .. rst-class:: classref-method
  983. void **scroll_to_line** **(** :ref:`int<class_int>` line **)**
  984. Scrolls the window's top line to match ``line``.
  985. .. rst-class:: classref-item-separator
  986. ----
  987. .. _class_RichTextLabel_method_scroll_to_paragraph:
  988. .. rst-class:: classref-method
  989. void **scroll_to_paragraph** **(** :ref:`int<class_int>` paragraph **)**
  990. Scrolls the window's top line to match first line of the ``paragraph``.
  991. .. rst-class:: classref-item-separator
  992. ----
  993. .. _class_RichTextLabel_method_scroll_to_selection:
  994. .. rst-class:: classref-method
  995. void **scroll_to_selection** **(** **)**
  996. Scrolls to the beginning of the current selection.
  997. .. rst-class:: classref-item-separator
  998. ----
  999. .. _class_RichTextLabel_method_select_all:
  1000. .. rst-class:: classref-method
  1001. void **select_all** **(** **)**
  1002. Select all the text.
  1003. If :ref:`selection_enabled<class_RichTextLabel_property_selection_enabled>` is ``false``, no selection will occur.
  1004. .. rst-class:: classref-item-separator
  1005. ----
  1006. .. _class_RichTextLabel_method_set_cell_border_color:
  1007. .. rst-class:: classref-method
  1008. void **set_cell_border_color** **(** :ref:`Color<class_Color>` color **)**
  1009. Sets color of a table cell border.
  1010. .. rst-class:: classref-item-separator
  1011. ----
  1012. .. _class_RichTextLabel_method_set_cell_padding:
  1013. .. rst-class:: classref-method
  1014. void **set_cell_padding** **(** :ref:`Rect2<class_Rect2>` padding **)**
  1015. Sets inner padding of a table cell.
  1016. .. rst-class:: classref-item-separator
  1017. ----
  1018. .. _class_RichTextLabel_method_set_cell_row_background_color:
  1019. .. rst-class:: classref-method
  1020. void **set_cell_row_background_color** **(** :ref:`Color<class_Color>` odd_row_bg, :ref:`Color<class_Color>` even_row_bg **)**
  1021. Sets color of a table cell. Separate colors for alternating rows can be specified.
  1022. .. rst-class:: classref-item-separator
  1023. ----
  1024. .. _class_RichTextLabel_method_set_cell_size_override:
  1025. .. rst-class:: classref-method
  1026. void **set_cell_size_override** **(** :ref:`Vector2<class_Vector2>` min_size, :ref:`Vector2<class_Vector2>` max_size **)**
  1027. Sets minimum and maximum size overrides for a table cell.
  1028. .. rst-class:: classref-item-separator
  1029. ----
  1030. .. _class_RichTextLabel_method_set_table_column_expand:
  1031. .. rst-class:: classref-method
  1032. void **set_table_column_expand** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` expand, :ref:`int<class_int>` ratio=1 **)**
  1033. Edits the selected column's expansion options. If ``expand`` is ``true``, the column expands in proportion to its expansion ratio versus the other columns' ratios.
  1034. For example, 2 columns with ratios 3 and 4 plus 70 pixels in available width would expand 30 and 40 pixels, respectively.
  1035. If ``expand`` is ``false``, the column will not contribute to the total ratio.
  1036. .. rst-class:: classref-section-separator
  1037. ----
  1038. .. rst-class:: classref-descriptions-group
  1039. Theme Property Descriptions
  1040. ---------------------------
  1041. .. _class_RichTextLabel_theme_color_default_color:
  1042. .. rst-class:: classref-themeproperty
  1043. :ref:`Color<class_Color>` **default_color** = ``Color(1, 1, 1, 1)``
  1044. The default text color.
  1045. .. rst-class:: classref-item-separator
  1046. ----
  1047. .. _class_RichTextLabel_theme_color_font_outline_color:
  1048. .. rst-class:: classref-themeproperty
  1049. :ref:`Color<class_Color>` **font_outline_color** = ``Color(1, 1, 1, 1)``
  1050. The default tint of text outline.
  1051. .. rst-class:: classref-item-separator
  1052. ----
  1053. .. _class_RichTextLabel_theme_color_font_selected_color:
  1054. .. rst-class:: classref-themeproperty
  1055. :ref:`Color<class_Color>` **font_selected_color** = ``Color(0, 0, 0, 0)``
  1056. The color of selected text, used when :ref:`selection_enabled<class_RichTextLabel_property_selection_enabled>` is ``true``. If equal to ``Color(0, 0, 0, 0)``, it will be ignored.
  1057. .. rst-class:: classref-item-separator
  1058. ----
  1059. .. _class_RichTextLabel_theme_color_font_shadow_color:
  1060. .. rst-class:: classref-themeproperty
  1061. :ref:`Color<class_Color>` **font_shadow_color** = ``Color(0, 0, 0, 0)``
  1062. The color of the font's shadow.
  1063. .. rst-class:: classref-item-separator
  1064. ----
  1065. .. _class_RichTextLabel_theme_color_selection_color:
  1066. .. rst-class:: classref-themeproperty
  1067. :ref:`Color<class_Color>` **selection_color** = ``Color(0.1, 0.1, 1, 0.8)``
  1068. The color of the selection box.
  1069. .. rst-class:: classref-item-separator
  1070. ----
  1071. .. _class_RichTextLabel_theme_color_table_border:
  1072. .. rst-class:: classref-themeproperty
  1073. :ref:`Color<class_Color>` **table_border** = ``Color(0, 0, 0, 0)``
  1074. The default cell border color.
  1075. .. rst-class:: classref-item-separator
  1076. ----
  1077. .. _class_RichTextLabel_theme_color_table_even_row_bg:
  1078. .. rst-class:: classref-themeproperty
  1079. :ref:`Color<class_Color>` **table_even_row_bg** = ``Color(0, 0, 0, 0)``
  1080. The default background color for even rows.
  1081. .. rst-class:: classref-item-separator
  1082. ----
  1083. .. _class_RichTextLabel_theme_color_table_odd_row_bg:
  1084. .. rst-class:: classref-themeproperty
  1085. :ref:`Color<class_Color>` **table_odd_row_bg** = ``Color(0, 0, 0, 0)``
  1086. The default background color for odd rows.
  1087. .. rst-class:: classref-item-separator
  1088. ----
  1089. .. _class_RichTextLabel_theme_constant_line_separation:
  1090. .. rst-class:: classref-themeproperty
  1091. :ref:`int<class_int>` **line_separation** = ``0``
  1092. The vertical space between lines.
  1093. .. rst-class:: classref-item-separator
  1094. ----
  1095. .. _class_RichTextLabel_theme_constant_outline_size:
  1096. .. rst-class:: classref-themeproperty
  1097. :ref:`int<class_int>` **outline_size** = ``0``
  1098. The size of the text outline.
  1099. \ **Note:** If using a font with :ref:`FontFile.multichannel_signed_distance_field<class_FontFile_property_multichannel_signed_distance_field>` enabled, its :ref:`FontFile.msdf_pixel_range<class_FontFile_property_msdf_pixel_range>` must be set to at least *twice* the value of :ref:`outline_size<class_RichTextLabel_theme_constant_outline_size>` for outline rendering to look correct. Otherwise, the outline may appear to be cut off earlier than intended.
  1100. .. rst-class:: classref-item-separator
  1101. ----
  1102. .. _class_RichTextLabel_theme_constant_shadow_offset_x:
  1103. .. rst-class:: classref-themeproperty
  1104. :ref:`int<class_int>` **shadow_offset_x** = ``1``
  1105. The horizontal offset of the font's shadow.
  1106. .. rst-class:: classref-item-separator
  1107. ----
  1108. .. _class_RichTextLabel_theme_constant_shadow_offset_y:
  1109. .. rst-class:: classref-themeproperty
  1110. :ref:`int<class_int>` **shadow_offset_y** = ``1``
  1111. The vertical offset of the font's shadow.
  1112. .. rst-class:: classref-item-separator
  1113. ----
  1114. .. _class_RichTextLabel_theme_constant_shadow_outline_size:
  1115. .. rst-class:: classref-themeproperty
  1116. :ref:`int<class_int>` **shadow_outline_size** = ``1``
  1117. The size of the shadow outline.
  1118. .. rst-class:: classref-item-separator
  1119. ----
  1120. .. _class_RichTextLabel_theme_constant_table_h_separation:
  1121. .. rst-class:: classref-themeproperty
  1122. :ref:`int<class_int>` **table_h_separation** = ``3``
  1123. The horizontal separation of elements in a table.
  1124. .. rst-class:: classref-item-separator
  1125. ----
  1126. .. _class_RichTextLabel_theme_constant_table_v_separation:
  1127. .. rst-class:: classref-themeproperty
  1128. :ref:`int<class_int>` **table_v_separation** = ``3``
  1129. The vertical separation of elements in a table.
  1130. .. rst-class:: classref-item-separator
  1131. ----
  1132. .. _class_RichTextLabel_theme_constant_text_highlight_h_padding:
  1133. .. rst-class:: classref-themeproperty
  1134. :ref:`int<class_int>` **text_highlight_h_padding** = ``3``
  1135. The horizontal padding around a highlighting and background color box.
  1136. .. rst-class:: classref-item-separator
  1137. ----
  1138. .. _class_RichTextLabel_theme_constant_text_highlight_v_padding:
  1139. .. rst-class:: classref-themeproperty
  1140. :ref:`int<class_int>` **text_highlight_v_padding** = ``3``
  1141. The vertical padding around a highlighting and background color box.
  1142. .. rst-class:: classref-item-separator
  1143. ----
  1144. .. _class_RichTextLabel_theme_font_bold_font:
  1145. .. rst-class:: classref-themeproperty
  1146. :ref:`Font<class_Font>` **bold_font**
  1147. The font used for bold text.
  1148. .. rst-class:: classref-item-separator
  1149. ----
  1150. .. _class_RichTextLabel_theme_font_bold_italics_font:
  1151. .. rst-class:: classref-themeproperty
  1152. :ref:`Font<class_Font>` **bold_italics_font**
  1153. The font used for bold italics text.
  1154. .. rst-class:: classref-item-separator
  1155. ----
  1156. .. _class_RichTextLabel_theme_font_italics_font:
  1157. .. rst-class:: classref-themeproperty
  1158. :ref:`Font<class_Font>` **italics_font**
  1159. The font used for italics text.
  1160. .. rst-class:: classref-item-separator
  1161. ----
  1162. .. _class_RichTextLabel_theme_font_mono_font:
  1163. .. rst-class:: classref-themeproperty
  1164. :ref:`Font<class_Font>` **mono_font**
  1165. The font used for monospace text.
  1166. .. rst-class:: classref-item-separator
  1167. ----
  1168. .. _class_RichTextLabel_theme_font_normal_font:
  1169. .. rst-class:: classref-themeproperty
  1170. :ref:`Font<class_Font>` **normal_font**
  1171. The default text font.
  1172. .. rst-class:: classref-item-separator
  1173. ----
  1174. .. _class_RichTextLabel_theme_font_size_bold_font_size:
  1175. .. rst-class:: classref-themeproperty
  1176. :ref:`int<class_int>` **bold_font_size**
  1177. The font size used for bold text.
  1178. .. rst-class:: classref-item-separator
  1179. ----
  1180. .. _class_RichTextLabel_theme_font_size_bold_italics_font_size:
  1181. .. rst-class:: classref-themeproperty
  1182. :ref:`int<class_int>` **bold_italics_font_size**
  1183. The font size used for bold italics text.
  1184. .. rst-class:: classref-item-separator
  1185. ----
  1186. .. _class_RichTextLabel_theme_font_size_italics_font_size:
  1187. .. rst-class:: classref-themeproperty
  1188. :ref:`int<class_int>` **italics_font_size**
  1189. The font size used for italics text.
  1190. .. rst-class:: classref-item-separator
  1191. ----
  1192. .. _class_RichTextLabel_theme_font_size_mono_font_size:
  1193. .. rst-class:: classref-themeproperty
  1194. :ref:`int<class_int>` **mono_font_size**
  1195. The font size used for monospace text.
  1196. .. rst-class:: classref-item-separator
  1197. ----
  1198. .. _class_RichTextLabel_theme_font_size_normal_font_size:
  1199. .. rst-class:: classref-themeproperty
  1200. :ref:`int<class_int>` **normal_font_size**
  1201. The default text font size.
  1202. .. rst-class:: classref-item-separator
  1203. ----
  1204. .. _class_RichTextLabel_theme_style_focus:
  1205. .. rst-class:: classref-themeproperty
  1206. :ref:`StyleBox<class_StyleBox>` **focus**
  1207. The background used when the **RichTextLabel** is focused. 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.
  1208. .. rst-class:: classref-item-separator
  1209. ----
  1210. .. _class_RichTextLabel_theme_style_normal:
  1211. .. rst-class:: classref-themeproperty
  1212. :ref:`StyleBox<class_StyleBox>` **normal**
  1213. The normal background for the **RichTextLabel**.
  1214. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  1215. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  1216. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  1217. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  1218. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  1219. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  1220. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`