123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127 |
- :github_url: hide
- .. DO NOT EDIT THIS FILE!!!
- .. Generated automatically from Godot engine sources.
- .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
- .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/RichTextLabel.xml.
- .. _class_RichTextLabel:
- RichTextLabel
- =============
- **Inherits:** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
- A control for displaying text that can contain different font styles, images, and basic formatting.
- .. rst-class:: classref-introduction-group
- Description
- -----------
- 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.
- \ **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.
- \ **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]``.
- \ **Note:** ``push_*/pop_*`` functions won't affect BBCode.
- \ **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.
- .. rst-class:: classref-introduction-group
- Tutorials
- ---------
- - :doc:`BBCode in RichTextLabel <../tutorials/ui/bbcode_in_richtextlabel>`
- - `GUI Rich Text/BBcode Demo <https://godotengine.org/asset-library/asset/132>`__
- - `OS Test Demo <https://godotengine.org/asset-library/asset/677>`__
- .. rst-class:: classref-reftable-group
- Properties
- ----------
- .. table::
- :widths: auto
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` | :ref:`autowrap_mode<class_RichTextLabel_property_autowrap_mode>` | ``3`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`bbcode_enabled<class_RichTextLabel_property_bbcode_enabled>` | ``false`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | clip_contents | ``true`` (overrides :ref:`Control<class_Control_property_clip_contents>`) |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`context_menu_enabled<class_RichTextLabel_property_context_menu_enabled>` | ``false`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`Array<class_Array>` | :ref:`custom_effects<class_RichTextLabel_property_custom_effects>` | ``[]`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`deselect_on_focus_loss_enabled<class_RichTextLabel_property_deselect_on_focus_loss_enabled>` | ``true`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`drag_and_drop_selection_enabled<class_RichTextLabel_property_drag_and_drop_selection_enabled>` | ``true`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`fit_content<class_RichTextLabel_property_fit_content>` | ``false`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`hint_underlined<class_RichTextLabel_property_hint_underlined>` | ``true`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`language<class_RichTextLabel_property_language>` | ``""`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`meta_underlined<class_RichTextLabel_property_meta_underlined>` | ``true`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`progress_bar_delay<class_RichTextLabel_property_progress_bar_delay>` | ``1000`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`scroll_active<class_RichTextLabel_property_scroll_active>` | ``true`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`scroll_following<class_RichTextLabel_property_scroll_following>` | ``false`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`selection_enabled<class_RichTextLabel_property_selection_enabled>` | ``false`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`shortcut_keys_enabled<class_RichTextLabel_property_shortcut_keys_enabled>` | ``true`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` | :ref:`structured_text_bidi_override<class_RichTextLabel_property_structured_text_bidi_override>` | ``0`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`Array<class_Array>` | :ref:`structured_text_bidi_override_options<class_RichTextLabel_property_structured_text_bidi_override_options>` | ``[]`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`tab_size<class_RichTextLabel_property_tab_size>` | ``4`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`text<class_RichTextLabel_property_text>` | ``""`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`TextDirection<enum_Control_TextDirection>` | :ref:`text_direction<class_RichTextLabel_property_text_direction>` | ``0`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`threaded<class_RichTextLabel_property_threaded>` | ``false`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`visible_characters<class_RichTextLabel_property_visible_characters>` | ``-1`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`VisibleCharactersBehavior<enum_TextServer_VisibleCharactersBehavior>` | :ref:`visible_characters_behavior<class_RichTextLabel_property_visible_characters_behavior>` | ``0`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- | :ref:`float<class_float>` | :ref:`visible_ratio<class_RichTextLabel_property_visible_ratio>` | ``1.0`` |
- +-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+
- .. rst-class:: classref-reftable-group
- Methods
- -------
- .. table::
- :widths: auto
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | 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) **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`add_text<class_RichTextLabel_method_add_text>` **(** :ref:`String<class_String>` text **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`append_text<class_RichTextLabel_method_append_text>` **(** :ref:`String<class_String>` bbcode **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`clear<class_RichTextLabel_method_clear>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`deselect<class_RichTextLabel_method_deselect>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_character_line<class_RichTextLabel_method_get_character_line>` **(** :ref:`int<class_int>` character **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_character_paragraph<class_RichTextLabel_method_get_character_paragraph>` **(** :ref:`int<class_int>` character **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_content_height<class_RichTextLabel_method_get_content_height>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_content_width<class_RichTextLabel_method_get_content_width>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_line_count<class_RichTextLabel_method_get_line_count>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`float<class_float>` | :ref:`get_line_offset<class_RichTextLabel_method_get_line_offset>` **(** :ref:`int<class_int>` line **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`PopupMenu<class_PopupMenu>` | :ref:`get_menu<class_RichTextLabel_method_get_menu>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_paragraph_count<class_RichTextLabel_method_get_paragraph_count>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`float<class_float>` | :ref:`get_paragraph_offset<class_RichTextLabel_method_get_paragraph_offset>` **(** :ref:`int<class_int>` paragraph **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`get_parsed_text<class_RichTextLabel_method_get_parsed_text>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`get_selected_text<class_RichTextLabel_method_get_selected_text>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_selection_from<class_RichTextLabel_method_get_selection_from>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_selection_to<class_RichTextLabel_method_get_selection_to>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_total_character_count<class_RichTextLabel_method_get_total_character_count>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`VScrollBar<class_VScrollBar>` | :ref:`get_v_scroll_bar<class_RichTextLabel_method_get_v_scroll_bar>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_visible_line_count<class_RichTextLabel_method_get_visible_line_count>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_visible_paragraph_count<class_RichTextLabel_method_get_visible_paragraph_count>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`install_effect<class_RichTextLabel_method_install_effect>` **(** :ref:`Variant<class_Variant>` effect **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`is_menu_visible<class_RichTextLabel_method_is_menu_visible>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`is_ready<class_RichTextLabel_method_is_ready>` **(** **)** |const| |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`menu_option<class_RichTextLabel_method_menu_option>` **(** :ref:`int<class_int>` option **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`newline<class_RichTextLabel_method_newline>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`parse_bbcode<class_RichTextLabel_method_parse_bbcode>` **(** :ref:`String<class_String>` bbcode **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Dictionary<class_Dictionary>` | :ref:`parse_expressions_for_values<class_RichTextLabel_method_parse_expressions_for_values>` **(** :ref:`PackedStringArray<class_PackedStringArray>` expressions **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`pop<class_RichTextLabel_method_pop>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`pop_all<class_RichTextLabel_method_pop_all>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`pop_context<class_RichTextLabel_method_pop_context>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_bgcolor<class_RichTextLabel_method_push_bgcolor>` **(** :ref:`Color<class_Color>` bgcolor **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_bold<class_RichTextLabel_method_push_bold>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_bold_italics<class_RichTextLabel_method_push_bold_italics>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_cell<class_RichTextLabel_method_push_cell>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_color<class_RichTextLabel_method_push_color>` **(** :ref:`Color<class_Color>` color **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_context<class_RichTextLabel_method_push_context>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_customfx<class_RichTextLabel_method_push_customfx>` **(** :ref:`RichTextEffect<class_RichTextEffect>` effect, :ref:`Dictionary<class_Dictionary>` env **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | 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) **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_fgcolor<class_RichTextLabel_method_push_fgcolor>` **(** :ref:`Color<class_Color>` fgcolor **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_font<class_RichTextLabel_method_push_font>` **(** :ref:`Font<class_Font>` font, :ref:`int<class_int>` font_size=0 **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_font_size<class_RichTextLabel_method_push_font_size>` **(** :ref:`int<class_int>` font_size **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_hint<class_RichTextLabel_method_push_hint>` **(** :ref:`String<class_String>` description **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_indent<class_RichTextLabel_method_push_indent>` **(** :ref:`int<class_int>` level **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_italics<class_RichTextLabel_method_push_italics>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_language<class_RichTextLabel_method_push_language>` **(** :ref:`String<class_String>` language **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | 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="•" **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_meta<class_RichTextLabel_method_push_meta>` **(** :ref:`Variant<class_Variant>` data **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_mono<class_RichTextLabel_method_push_mono>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_normal<class_RichTextLabel_method_push_normal>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_outline_color<class_RichTextLabel_method_push_outline_color>` **(** :ref:`Color<class_Color>` color **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_outline_size<class_RichTextLabel_method_push_outline_size>` **(** :ref:`int<class_int>` outline_size **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | 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() **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_strikethrough<class_RichTextLabel_method_push_strikethrough>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | 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 **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`push_underline<class_RichTextLabel_method_push_underline>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`remove_paragraph<class_RichTextLabel_method_remove_paragraph>` **(** :ref:`int<class_int>` paragraph **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`scroll_to_line<class_RichTextLabel_method_scroll_to_line>` **(** :ref:`int<class_int>` line **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`scroll_to_paragraph<class_RichTextLabel_method_scroll_to_paragraph>` **(** :ref:`int<class_int>` paragraph **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`scroll_to_selection<class_RichTextLabel_method_scroll_to_selection>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`select_all<class_RichTextLabel_method_select_all>` **(** **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`set_cell_border_color<class_RichTextLabel_method_set_cell_border_color>` **(** :ref:`Color<class_Color>` color **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`set_cell_padding<class_RichTextLabel_method_set_cell_padding>` **(** :ref:`Rect2<class_Rect2>` padding **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | 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 **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | 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 **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | 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 **)** |
- +-------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- .. rst-class:: classref-reftable-group
- Theme Properties
- ----------------
- .. table::
- :widths: auto
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Color<class_Color>` | :ref:`default_color<class_RichTextLabel_theme_color_default_color>` | ``Color(1, 1, 1, 1)`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Color<class_Color>` | :ref:`font_outline_color<class_RichTextLabel_theme_color_font_outline_color>` | ``Color(1, 1, 1, 1)`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Color<class_Color>` | :ref:`font_selected_color<class_RichTextLabel_theme_color_font_selected_color>` | ``Color(0, 0, 0, 0)`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Color<class_Color>` | :ref:`font_shadow_color<class_RichTextLabel_theme_color_font_shadow_color>` | ``Color(0, 0, 0, 0)`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Color<class_Color>` | :ref:`selection_color<class_RichTextLabel_theme_color_selection_color>` | ``Color(0.1, 0.1, 1, 0.8)`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Color<class_Color>` | :ref:`table_border<class_RichTextLabel_theme_color_table_border>` | ``Color(0, 0, 0, 0)`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Color<class_Color>` | :ref:`table_even_row_bg<class_RichTextLabel_theme_color_table_even_row_bg>` | ``Color(0, 0, 0, 0)`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Color<class_Color>` | :ref:`table_odd_row_bg<class_RichTextLabel_theme_color_table_odd_row_bg>` | ``Color(0, 0, 0, 0)`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`line_separation<class_RichTextLabel_theme_constant_line_separation>` | ``0`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`outline_size<class_RichTextLabel_theme_constant_outline_size>` | ``0`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`shadow_offset_x<class_RichTextLabel_theme_constant_shadow_offset_x>` | ``1`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`shadow_offset_y<class_RichTextLabel_theme_constant_shadow_offset_y>` | ``1`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`shadow_outline_size<class_RichTextLabel_theme_constant_shadow_outline_size>` | ``1`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`table_h_separation<class_RichTextLabel_theme_constant_table_h_separation>` | ``3`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`table_v_separation<class_RichTextLabel_theme_constant_table_v_separation>` | ``3`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`text_highlight_h_padding<class_RichTextLabel_theme_constant_text_highlight_h_padding>` | ``3`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`text_highlight_v_padding<class_RichTextLabel_theme_constant_text_highlight_v_padding>` | ``3`` |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Font<class_Font>` | :ref:`bold_font<class_RichTextLabel_theme_font_bold_font>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Font<class_Font>` | :ref:`bold_italics_font<class_RichTextLabel_theme_font_bold_italics_font>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Font<class_Font>` | :ref:`italics_font<class_RichTextLabel_theme_font_italics_font>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Font<class_Font>` | :ref:`mono_font<class_RichTextLabel_theme_font_mono_font>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`Font<class_Font>` | :ref:`normal_font<class_RichTextLabel_theme_font_normal_font>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`bold_font_size<class_RichTextLabel_theme_font_size_bold_font_size>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`bold_italics_font_size<class_RichTextLabel_theme_font_size_bold_italics_font_size>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`italics_font_size<class_RichTextLabel_theme_font_size_italics_font_size>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`mono_font_size<class_RichTextLabel_theme_font_size_mono_font_size>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`int<class_int>` | :ref:`normal_font_size<class_RichTextLabel_theme_font_size_normal_font_size>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`StyleBox<class_StyleBox>` | :ref:`focus<class_RichTextLabel_theme_style_focus>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- | :ref:`StyleBox<class_StyleBox>` | :ref:`normal<class_RichTextLabel_theme_style_normal>` | |
- +---------------------------------+----------------------------------------------------------------------------------------------+-----------------------------+
- .. rst-class:: classref-section-separator
- ----
- .. rst-class:: classref-descriptions-group
- Signals
- -------
- .. _class_RichTextLabel_signal_finished:
- .. rst-class:: classref-signal
- **finished** **(** **)**
- Triggered when the document is fully loaded.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_signal_meta_clicked:
- .. rst-class:: classref-signal
- **meta_clicked** **(** :ref:`Variant<class_Variant>` meta **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_signal_meta_hover_ended:
- .. rst-class:: classref-signal
- **meta_hover_ended** **(** :ref:`Variant<class_Variant>` meta **)**
- Triggers when the mouse exits a meta tag.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_signal_meta_hover_started:
- .. rst-class:: classref-signal
- **meta_hover_started** **(** :ref:`Variant<class_Variant>` meta **)**
- Triggers when the mouse enters a meta tag.
- .. rst-class:: classref-section-separator
- ----
- .. rst-class:: classref-descriptions-group
- Enumerations
- ------------
- .. _enum_RichTextLabel_ListType:
- .. rst-class:: classref-enumeration
- enum **ListType**:
- .. _class_RichTextLabel_constant_LIST_NUMBERS:
- .. rst-class:: classref-enumeration-constant
- :ref:`ListType<enum_RichTextLabel_ListType>` **LIST_NUMBERS** = ``0``
- Each list item has a number marker.
- .. _class_RichTextLabel_constant_LIST_LETTERS:
- .. rst-class:: classref-enumeration-constant
- :ref:`ListType<enum_RichTextLabel_ListType>` **LIST_LETTERS** = ``1``
- Each list item has a letter marker.
- .. _class_RichTextLabel_constant_LIST_ROMAN:
- .. rst-class:: classref-enumeration-constant
- :ref:`ListType<enum_RichTextLabel_ListType>` **LIST_ROMAN** = ``2``
- Each list item has a roman number marker.
- .. _class_RichTextLabel_constant_LIST_DOTS:
- .. rst-class:: classref-enumeration-constant
- :ref:`ListType<enum_RichTextLabel_ListType>` **LIST_DOTS** = ``3``
- Each list item has a filled circle marker.
- .. rst-class:: classref-item-separator
- ----
- .. _enum_RichTextLabel_MenuItems:
- .. rst-class:: classref-enumeration
- enum **MenuItems**:
- .. _class_RichTextLabel_constant_MENU_COPY:
- .. rst-class:: classref-enumeration-constant
- :ref:`MenuItems<enum_RichTextLabel_MenuItems>` **MENU_COPY** = ``0``
- Copies the selected text.
- .. _class_RichTextLabel_constant_MENU_SELECT_ALL:
- .. rst-class:: classref-enumeration-constant
- :ref:`MenuItems<enum_RichTextLabel_MenuItems>` **MENU_SELECT_ALL** = ``1``
- Selects the whole **RichTextLabel** text.
- .. _class_RichTextLabel_constant_MENU_MAX:
- .. rst-class:: classref-enumeration-constant
- :ref:`MenuItems<enum_RichTextLabel_MenuItems>` **MENU_MAX** = ``2``
- Represents the size of the :ref:`MenuItems<enum_RichTextLabel_MenuItems>` enum.
- .. rst-class:: classref-section-separator
- ----
- .. rst-class:: classref-descriptions-group
- Property Descriptions
- ---------------------
- .. _class_RichTextLabel_property_autowrap_mode:
- .. rst-class:: classref-property
- :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` **autowrap_mode** = ``3``
- .. rst-class:: classref-property-setget
- - void **set_autowrap_mode** **(** :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` value **)**
- - :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` **get_autowrap_mode** **(** **)**
- 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>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_bbcode_enabled:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **bbcode_enabled** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_use_bbcode** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_using_bbcode** **(** **)**
- If ``true``, the label uses BBCode formatting.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_context_menu_enabled:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **context_menu_enabled** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_context_menu_enabled** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_context_menu_enabled** **(** **)**
- If ``true``, a right-click displays the context menu.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_custom_effects:
- .. rst-class:: classref-property
- :ref:`Array<class_Array>` **custom_effects** = ``[]``
- .. rst-class:: classref-property-setget
- - void **set_effects** **(** :ref:`Array<class_Array>` value **)**
- - :ref:`Array<class_Array>` **get_effects** **(** **)**
- The currently installed custom effects. This is an array of :ref:`RichTextEffect<class_RichTextEffect>`\ s.
- To add a custom effect, it's more convenient to use :ref:`install_effect<class_RichTextLabel_method_install_effect>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_deselect_on_focus_loss_enabled:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **deselect_on_focus_loss_enabled** = ``true``
- .. rst-class:: classref-property-setget
- - void **set_deselect_on_focus_loss_enabled** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_deselect_on_focus_loss_enabled** **(** **)**
- If ``true``, the selected text will be deselected when focus is lost.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_drag_and_drop_selection_enabled:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **drag_and_drop_selection_enabled** = ``true``
- .. rst-class:: classref-property-setget
- - void **set_drag_and_drop_selection_enabled** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_drag_and_drop_selection_enabled** **(** **)**
- If ``true``, allow drag and drop of selected text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_fit_content:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **fit_content** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_fit_content** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_fit_content_enabled** **(** **)**
- If ``true``, the label's minimum size will be automatically updated to fit its content, matching the behavior of :ref:`Label<class_Label>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_hint_underlined:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **hint_underlined** = ``true``
- .. rst-class:: classref-property-setget
- - void **set_hint_underline** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_hint_underlined** **(** **)**
- If ``true``, the label underlines hint tags such as ``[hint=description]{text}[/hint]``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_language:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **language** = ``""``
- .. rst-class:: classref-property-setget
- - void **set_language** **(** :ref:`String<class_String>` value **)**
- - :ref:`String<class_String>` **get_language** **(** **)**
- Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_meta_underlined:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **meta_underlined** = ``true``
- .. rst-class:: classref-property-setget
- - void **set_meta_underline** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_meta_underlined** **(** **)**
- If ``true``, the label underlines meta tags such as ``[url]{text}[/url]``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_progress_bar_delay:
- .. rst-class:: classref-property
- :ref:`int<class_int>` **progress_bar_delay** = ``1000``
- .. rst-class:: classref-property-setget
- - void **set_progress_bar_delay** **(** :ref:`int<class_int>` value **)**
- - :ref:`int<class_int>` **get_progress_bar_delay** **(** **)**
- The delay after which the loading progress bar is displayed, in milliseconds. Set to ``-1`` to disable progress bar entirely.
- \ **Note:** Progress bar is displayed only if :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_scroll_active:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **scroll_active** = ``true``
- .. rst-class:: classref-property-setget
- - void **set_scroll_active** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_scroll_active** **(** **)**
- 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>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_scroll_following:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **scroll_following** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_scroll_follow** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_scroll_following** **(** **)**
- If ``true``, the window scrolls down to display new content automatically.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_selection_enabled:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **selection_enabled** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_selection_enabled** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_selection_enabled** **(** **)**
- If ``true``, the label allows text selection.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_shortcut_keys_enabled:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **shortcut_keys_enabled** = ``true``
- .. rst-class:: classref-property-setget
- - void **set_shortcut_keys_enabled** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_shortcut_keys_enabled** **(** **)**
- If ``true``, shortcut keys for context menu items are enabled, even if the context menu is disabled.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_structured_text_bidi_override:
- .. rst-class:: classref-property
- :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **structured_text_bidi_override** = ``0``
- .. rst-class:: classref-property-setget
- - void **set_structured_text_bidi_override** **(** :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` value **)**
- - :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **get_structured_text_bidi_override** **(** **)**
- Set BiDi algorithm override for the structured text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_structured_text_bidi_override_options:
- .. rst-class:: classref-property
- :ref:`Array<class_Array>` **structured_text_bidi_override_options** = ``[]``
- .. rst-class:: classref-property-setget
- - void **set_structured_text_bidi_override_options** **(** :ref:`Array<class_Array>` value **)**
- - :ref:`Array<class_Array>` **get_structured_text_bidi_override_options** **(** **)**
- Set additional options for BiDi override.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_tab_size:
- .. rst-class:: classref-property
- :ref:`int<class_int>` **tab_size** = ``4``
- .. rst-class:: classref-property-setget
- - void **set_tab_size** **(** :ref:`int<class_int>` value **)**
- - :ref:`int<class_int>` **get_tab_size** **(** **)**
- The number of spaces associated with a single tab length. Does not affect ``\t`` in text tags, only indent tags.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_text:
- .. rst-class:: classref-property
- :ref:`String<class_String>` **text** = ``""``
- .. rst-class:: classref-property-setget
- - void **set_text** **(** :ref:`String<class_String>` value **)**
- - :ref:`String<class_String>` **get_text** **(** **)**
- 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.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_text_direction:
- .. rst-class:: classref-property
- :ref:`TextDirection<enum_Control_TextDirection>` **text_direction** = ``0``
- .. rst-class:: classref-property-setget
- - void **set_text_direction** **(** :ref:`TextDirection<enum_Control_TextDirection>` value **)**
- - :ref:`TextDirection<enum_Control_TextDirection>` **get_text_direction** **(** **)**
- Base text writing direction.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_threaded:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **threaded** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_threaded** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_threaded** **(** **)**
- If ``true``, text processing is done in a background thread.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_visible_characters:
- .. rst-class:: classref-property
- :ref:`int<class_int>` **visible_characters** = ``-1``
- .. rst-class:: classref-property-setget
- - void **set_visible_characters** **(** :ref:`int<class_int>` value **)**
- - :ref:`int<class_int>` **get_visible_characters** **(** **)**
- 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.
- \ **Note:** Setting this property updates :ref:`visible_ratio<class_RichTextLabel_property_visible_ratio>` accordingly.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_visible_characters_behavior:
- .. rst-class:: classref-property
- :ref:`VisibleCharactersBehavior<enum_TextServer_VisibleCharactersBehavior>` **visible_characters_behavior** = ``0``
- .. rst-class:: classref-property-setget
- - void **set_visible_characters_behavior** **(** :ref:`VisibleCharactersBehavior<enum_TextServer_VisibleCharactersBehavior>` value **)**
- - :ref:`VisibleCharactersBehavior<enum_TextServer_VisibleCharactersBehavior>` **get_visible_characters_behavior** **(** **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_property_visible_ratio:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **visible_ratio** = ``1.0``
- .. rst-class:: classref-property-setget
- - void **set_visible_ratio** **(** :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_visible_ratio** **(** **)**
- 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.
- \ **Note:** Setting this property updates :ref:`visible_characters<class_RichTextLabel_property_visible_characters>` accordingly.
- .. rst-class:: classref-section-separator
- ----
- .. rst-class:: classref-descriptions-group
- Method Descriptions
- -------------------
- .. _class_RichTextLabel_method_add_image:
- .. rst-class:: classref-method
- 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) **)**
- 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.
- If ``width`` or ``height`` is set to 0, the image size will be adjusted in order to keep the original aspect ratio.
- If ``width`` and ``height`` are not set, but ``region`` is, the region's rect will be used.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_add_text:
- .. rst-class:: classref-method
- void **add_text** **(** :ref:`String<class_String>` text **)**
- Adds raw non-BBCode-parsed text to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_append_text:
- .. rst-class:: classref-method
- void **append_text** **(** :ref:`String<class_String>` bbcode **)**
- Parses ``bbcode`` and adds tags to the tag stack as needed.
- \ **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>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_clear:
- .. rst-class:: classref-method
- void **clear** **(** **)**
- Clears the tag stack.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_deselect:
- .. rst-class:: classref-method
- void **deselect** **(** **)**
- Clears the current selection.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_character_line:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_character_line** **(** :ref:`int<class_int>` character **)**
- Returns the line number of the character position provided.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_character_paragraph:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_character_paragraph** **(** :ref:`int<class_int>` character **)**
- Returns the paragraph number of the character position provided.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_content_height:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_content_height** **(** **)** |const|
- Returns the height of the content.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_content_width:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_content_width** **(** **)** |const|
- Returns the width of the content.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_line_count:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_line_count** **(** **)** |const|
- Returns the total number of lines in the text. Wrapped text is counted as multiple lines.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_line_offset:
- .. rst-class:: classref-method
- :ref:`float<class_float>` **get_line_offset** **(** :ref:`int<class_int>` line **)**
- Returns the vertical offset of the line found at the provided index.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_menu:
- .. rst-class:: classref-method
- :ref:`PopupMenu<class_PopupMenu>` **get_menu** **(** **)** |const|
- Returns the :ref:`PopupMenu<class_PopupMenu>` of this **RichTextLabel**. By default, this menu is displayed when right-clicking on the **RichTextLabel**.
- 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:
- .. tabs::
- .. code-tab:: gdscript
- func _ready():
- var menu = get_menu()
- # Remove "Select All" item.
- menu.remove_item(MENU_SELECT_ALL)
- # Add custom items.
- menu.add_separator()
- menu.add_item("Duplicate Text", MENU_MAX + 1)
- # Connect callback.
- menu.id_pressed.connect(_on_item_pressed)
-
- func _on_item_pressed(id):
- if id == MENU_MAX + 1:
- add_text("\n" + get_parsed_text())
- .. code-tab:: csharp
- public override void _Ready()
- {
- var menu = GetMenu();
- // Remove "Select All" item.
- menu.RemoveItem(RichTextLabel.MenuItems.SelectAll);
- // Add custom items.
- menu.AddSeparator();
- menu.AddItem("Duplicate Text", RichTextLabel.MenuItems.Max + 1);
- // Add event handler.
- menu.IdPressed += OnItemPressed;
- }
-
- public void OnItemPressed(int id)
- {
- if (id == TextEdit.MenuItems.Max + 1)
- {
- AddText("\n" + GetParsedText());
- }
- }
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_paragraph_count:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_paragraph_count** **(** **)** |const|
- Returns the total number of paragraphs (newlines or ``p`` tags in the tag stack's text tags). Considers wrapped text as one paragraph.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_paragraph_offset:
- .. rst-class:: classref-method
- :ref:`float<class_float>` **get_paragraph_offset** **(** :ref:`int<class_int>` paragraph **)**
- Returns the vertical offset of the paragraph found at the provided index.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_parsed_text:
- .. rst-class:: classref-method
- :ref:`String<class_String>` **get_parsed_text** **(** **)** |const|
- Returns the text without BBCode mark-up.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_selected_text:
- .. rst-class:: classref-method
- :ref:`String<class_String>` **get_selected_text** **(** **)** |const|
- Returns the current selection text. Does not include BBCodes.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_selection_from:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_selection_from** **(** **)** |const|
- Returns the current selection first character index if a selection is active, ``-1`` otherwise. Does not include BBCodes.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_selection_to:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_selection_to** **(** **)** |const|
- Returns the current selection last character index if a selection is active, ``-1`` otherwise. Does not include BBCodes.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_total_character_count:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_total_character_count** **(** **)** |const|
- Returns the total number of characters from text tags. Does not include BBCodes.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_v_scroll_bar:
- .. rst-class:: classref-method
- :ref:`VScrollBar<class_VScrollBar>` **get_v_scroll_bar** **(** **)**
- Returns the vertical scrollbar.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_visible_line_count:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_visible_line_count** **(** **)** |const|
- Returns the number of visible lines.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_get_visible_paragraph_count:
- .. rst-class:: classref-method
- :ref:`int<class_int>` **get_visible_paragraph_count** **(** **)** |const|
- Returns the number of visible paragraphs. A paragraph is considered visible if at least one of its lines is visible.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_install_effect:
- .. rst-class:: classref-method
- void **install_effect** **(** :ref:`Variant<class_Variant>` effect **)**
- Installs a custom effect. ``effect`` should be a valid :ref:`RichTextEffect<class_RichTextEffect>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_is_menu_visible:
- .. rst-class:: classref-method
- :ref:`bool<class_bool>` **is_menu_visible** **(** **)** |const|
- Returns whether the menu is visible. Use this instead of ``get_menu().visible`` to improve performance (so the creation of the menu is avoided).
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_is_ready:
- .. rst-class:: classref-method
- :ref:`bool<class_bool>` **is_ready** **(** **)** |const|
- If :ref:`threaded<class_RichTextLabel_property_threaded>` is enabled, returns ``true`` if the background thread has finished text processing, otherwise always return ``true``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_menu_option:
- .. rst-class:: classref-method
- void **menu_option** **(** :ref:`int<class_int>` option **)**
- Executes a given action as defined in the :ref:`MenuItems<enum_RichTextLabel_MenuItems>` enum.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_newline:
- .. rst-class:: classref-method
- void **newline** **(** **)**
- Adds a newline tag to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_parse_bbcode:
- .. rst-class:: classref-method
- void **parse_bbcode** **(** :ref:`String<class_String>` bbcode **)**
- The assignment version of :ref:`append_text<class_RichTextLabel_method_append_text>`. Clears the tag stack and inserts the new content.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_parse_expressions_for_values:
- .. rst-class:: classref-method
- :ref:`Dictionary<class_Dictionary>` **parse_expressions_for_values** **(** :ref:`PackedStringArray<class_PackedStringArray>` expressions **)**
- Parses BBCode parameter ``expressions`` into a dictionary.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_pop:
- .. rst-class:: classref-method
- void **pop** **(** **)**
- Terminates the current tag. Use after ``push_*`` methods to close BBCodes manually. Does not need to follow ``add_*`` methods.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_pop_all:
- .. rst-class:: classref-method
- void **pop_all** **(** **)**
- Terminates all tags opened by ``push_*`` methods.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_pop_context:
- .. rst-class:: classref-method
- void **pop_context** **(** **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_bgcolor:
- .. rst-class:: classref-method
- void **push_bgcolor** **(** :ref:`Color<class_Color>` bgcolor **)**
- Adds a ``[bgcolor]`` tag to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_bold:
- .. rst-class:: classref-method
- void **push_bold** **(** **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_bold_italics:
- .. rst-class:: classref-method
- void **push_bold_italics** **(** **)**
- Adds a ``[font]`` tag with a bold italics font to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_cell:
- .. rst-class:: classref-method
- void **push_cell** **(** **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_color:
- .. rst-class:: classref-method
- void **push_color** **(** :ref:`Color<class_Color>` color **)**
- Adds a ``[color]`` tag to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_context:
- .. rst-class:: classref-method
- void **push_context** **(** **)**
- Adds a context marker to the tag stack. See :ref:`pop_context<class_RichTextLabel_method_pop_context>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_customfx:
- .. rst-class:: classref-method
- void **push_customfx** **(** :ref:`RichTextEffect<class_RichTextEffect>` effect, :ref:`Dictionary<class_Dictionary>` env **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_dropcap:
- .. rst-class:: classref-method
- 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) **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_fgcolor:
- .. rst-class:: classref-method
- void **push_fgcolor** **(** :ref:`Color<class_Color>` fgcolor **)**
- Adds a ``[fgcolor]`` tag to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_font:
- .. rst-class:: classref-method
- void **push_font** **(** :ref:`Font<class_Font>` font, :ref:`int<class_int>` font_size=0 **)**
- Adds a ``[font]`` tag to the tag stack. Overrides default fonts for its duration.
- Passing ``0`` to ``font_size`` will use the existing default font size.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_font_size:
- .. rst-class:: classref-method
- void **push_font_size** **(** :ref:`int<class_int>` font_size **)**
- Adds a ``[font_size]`` tag to the tag stack. Overrides default font size for its duration.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_hint:
- .. rst-class:: classref-method
- void **push_hint** **(** :ref:`String<class_String>` description **)**
- Adds a ``[hint]`` tag to the tag stack. Same as BBCode ``[hint=something]{text}[/hint]``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_indent:
- .. rst-class:: classref-method
- void **push_indent** **(** :ref:`int<class_int>` level **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_italics:
- .. rst-class:: classref-method
- void **push_italics** **(** **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_language:
- .. rst-class:: classref-method
- void **push_language** **(** :ref:`String<class_String>` language **)**
- Adds language code used for text shaping algorithm and Open-Type font features.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_list:
- .. rst-class:: classref-method
- void **push_list** **(** :ref:`int<class_int>` level, :ref:`ListType<enum_RichTextLabel_ListType>` type, :ref:`bool<class_bool>` capitalize, :ref:`String<class_String>` bullet="•" **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_meta:
- .. rst-class:: classref-method
- void **push_meta** **(** :ref:`Variant<class_Variant>` data **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_mono:
- .. rst-class:: classref-method
- void **push_mono** **(** **)**
- Adds a ``[font]`` tag with a monospace font to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_normal:
- .. rst-class:: classref-method
- void **push_normal** **(** **)**
- Adds a ``[font]`` tag with a normal font to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_outline_color:
- .. rst-class:: classref-method
- void **push_outline_color** **(** :ref:`Color<class_Color>` color **)**
- Adds a ``[outline_color]`` tag to the tag stack. Adds text outline for its duration.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_outline_size:
- .. rst-class:: classref-method
- void **push_outline_size** **(** :ref:`int<class_int>` outline_size **)**
- Adds a ``[outline_size]`` tag to the tag stack. Overrides default text outline size for its duration.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_paragraph:
- .. rst-class:: classref-method
- 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() **)**
- Adds a ``[p]`` tag to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_strikethrough:
- .. rst-class:: classref-method
- void **push_strikethrough** **(** **)**
- Adds a ``[s]`` tag to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_table:
- .. rst-class:: classref-method
- void **push_table** **(** :ref:`int<class_int>` columns, :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` inline_align=0, :ref:`int<class_int>` align_to_row=-1 **)**
- Adds a ``[table=columns,inline_align]`` tag to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_push_underline:
- .. rst-class:: classref-method
- void **push_underline** **(** **)**
- Adds a ``[u]`` tag to the tag stack.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_remove_paragraph:
- .. rst-class:: classref-method
- :ref:`bool<class_bool>` **remove_paragraph** **(** :ref:`int<class_int>` paragraph **)**
- Removes a paragraph of content from the label. Returns ``true`` if the paragraph exists.
- The ``paragraph`` argument is the index of the paragraph to remove, it can take values in the interval ``[0, get_paragraph_count() - 1]``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_scroll_to_line:
- .. rst-class:: classref-method
- void **scroll_to_line** **(** :ref:`int<class_int>` line **)**
- Scrolls the window's top line to match ``line``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_scroll_to_paragraph:
- .. rst-class:: classref-method
- void **scroll_to_paragraph** **(** :ref:`int<class_int>` paragraph **)**
- Scrolls the window's top line to match first line of the ``paragraph``.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_scroll_to_selection:
- .. rst-class:: classref-method
- void **scroll_to_selection** **(** **)**
- Scrolls to the beginning of the current selection.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_select_all:
- .. rst-class:: classref-method
- void **select_all** **(** **)**
- Select all the text.
- If :ref:`selection_enabled<class_RichTextLabel_property_selection_enabled>` is ``false``, no selection will occur.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_set_cell_border_color:
- .. rst-class:: classref-method
- void **set_cell_border_color** **(** :ref:`Color<class_Color>` color **)**
- Sets color of a table cell border.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_set_cell_padding:
- .. rst-class:: classref-method
- void **set_cell_padding** **(** :ref:`Rect2<class_Rect2>` padding **)**
- Sets inner padding of a table cell.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_set_cell_row_background_color:
- .. rst-class:: classref-method
- void **set_cell_row_background_color** **(** :ref:`Color<class_Color>` odd_row_bg, :ref:`Color<class_Color>` even_row_bg **)**
- Sets color of a table cell. Separate colors for alternating rows can be specified.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_set_cell_size_override:
- .. rst-class:: classref-method
- void **set_cell_size_override** **(** :ref:`Vector2<class_Vector2>` min_size, :ref:`Vector2<class_Vector2>` max_size **)**
- Sets minimum and maximum size overrides for a table cell.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_method_set_table_column_expand:
- .. rst-class:: classref-method
- void **set_table_column_expand** **(** :ref:`int<class_int>` column, :ref:`bool<class_bool>` expand, :ref:`int<class_int>` ratio=1 **)**
- 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.
- For example, 2 columns with ratios 3 and 4 plus 70 pixels in available width would expand 30 and 40 pixels, respectively.
- If ``expand`` is ``false``, the column will not contribute to the total ratio.
- .. rst-class:: classref-section-separator
- ----
- .. rst-class:: classref-descriptions-group
- Theme Property Descriptions
- ---------------------------
- .. _class_RichTextLabel_theme_color_default_color:
- .. rst-class:: classref-themeproperty
- :ref:`Color<class_Color>` **default_color** = ``Color(1, 1, 1, 1)``
- The default text color.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_color_font_outline_color:
- .. rst-class:: classref-themeproperty
- :ref:`Color<class_Color>` **font_outline_color** = ``Color(1, 1, 1, 1)``
- The default tint of text outline.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_color_font_selected_color:
- .. rst-class:: classref-themeproperty
- :ref:`Color<class_Color>` **font_selected_color** = ``Color(0, 0, 0, 0)``
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_color_font_shadow_color:
- .. rst-class:: classref-themeproperty
- :ref:`Color<class_Color>` **font_shadow_color** = ``Color(0, 0, 0, 0)``
- The color of the font's shadow.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_color_selection_color:
- .. rst-class:: classref-themeproperty
- :ref:`Color<class_Color>` **selection_color** = ``Color(0.1, 0.1, 1, 0.8)``
- The color of the selection box.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_color_table_border:
- .. rst-class:: classref-themeproperty
- :ref:`Color<class_Color>` **table_border** = ``Color(0, 0, 0, 0)``
- The default cell border color.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_color_table_even_row_bg:
- .. rst-class:: classref-themeproperty
- :ref:`Color<class_Color>` **table_even_row_bg** = ``Color(0, 0, 0, 0)``
- The default background color for even rows.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_color_table_odd_row_bg:
- .. rst-class:: classref-themeproperty
- :ref:`Color<class_Color>` **table_odd_row_bg** = ``Color(0, 0, 0, 0)``
- The default background color for odd rows.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_constant_line_separation:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **line_separation** = ``0``
- The vertical space between lines.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_constant_outline_size:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **outline_size** = ``0``
- The size of the text outline.
- \ **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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_constant_shadow_offset_x:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **shadow_offset_x** = ``1``
- The horizontal offset of the font's shadow.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_constant_shadow_offset_y:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **shadow_offset_y** = ``1``
- The vertical offset of the font's shadow.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_constant_shadow_outline_size:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **shadow_outline_size** = ``1``
- The size of the shadow outline.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_constant_table_h_separation:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **table_h_separation** = ``3``
- The horizontal separation of elements in a table.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_constant_table_v_separation:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **table_v_separation** = ``3``
- The vertical separation of elements in a table.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_constant_text_highlight_h_padding:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **text_highlight_h_padding** = ``3``
- The horizontal padding around a highlighting and background color box.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_constant_text_highlight_v_padding:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **text_highlight_v_padding** = ``3``
- The vertical padding around a highlighting and background color box.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_bold_font:
- .. rst-class:: classref-themeproperty
- :ref:`Font<class_Font>` **bold_font**
- The font used for bold text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_bold_italics_font:
- .. rst-class:: classref-themeproperty
- :ref:`Font<class_Font>` **bold_italics_font**
- The font used for bold italics text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_italics_font:
- .. rst-class:: classref-themeproperty
- :ref:`Font<class_Font>` **italics_font**
- The font used for italics text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_mono_font:
- .. rst-class:: classref-themeproperty
- :ref:`Font<class_Font>` **mono_font**
- The font used for monospace text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_normal_font:
- .. rst-class:: classref-themeproperty
- :ref:`Font<class_Font>` **normal_font**
- The default text font.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_size_bold_font_size:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **bold_font_size**
- The font size used for bold text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_size_bold_italics_font_size:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **bold_italics_font_size**
- The font size used for bold italics text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_size_italics_font_size:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **italics_font_size**
- The font size used for italics text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_size_mono_font_size:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **mono_font_size**
- The font size used for monospace text.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_font_size_normal_font_size:
- .. rst-class:: classref-themeproperty
- :ref:`int<class_int>` **normal_font_size**
- The default text font size.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_style_focus:
- .. rst-class:: classref-themeproperty
- :ref:`StyleBox<class_StyleBox>` **focus**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_RichTextLabel_theme_style_normal:
- .. rst-class:: classref-themeproperty
- :ref:`StyleBox<class_StyleBox>` **normal**
- The normal background for the **RichTextLabel**.
- .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
- .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
- .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
- .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
- .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
- .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
- .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
|