Improve RichTextLabel `install_effect()` documentation

(cherry picked from commit 78fff7292c)
This commit is contained in:
Hugo Locurcio 2023-12-19 17:29:49 +01:00 committed by Yuri Sizov
parent e11165d7f1
commit c72c69379a
2 changed files with 23 additions and 2 deletions

View File

@ -4,7 +4,7 @@
A custom effect for a [RichTextLabel].
</brief_description>
<description>
A custom effect for a [RichTextLabel].
A custom effect for a [RichTextLabel], which can be loaded in the [RichTextLabel] inspector or using [method RichTextLabel.install_effect].
[b]Note:[/b] For a [RichTextEffect] to be usable, a BBCode tag must be defined as a member variable called [code]bbcode[/code] in the script.
[codeblocks]
[gdscript]

View File

@ -218,7 +218,28 @@
<return type="void" />
<param index="0" name="effect" type="Variant" />
<description>
Installs a custom effect. [param effect] should be a valid [RichTextEffect].
Installs a custom effect. This can also be done in the RichTextLabel inspector using the [member custom_effects] property. [param effect] should be a valid [RichTextEffect].
Example RichTextEffect:
[codeblock]
# effect.gd
class_name MyCustomEffect
extends RichTextEffect
var bbcode = "my_custom_effect"
# ...
[/codeblock]
Registering the above effect in RichTextLabel from script:
[codeblock]
# rich_text_label.gd
extends RichTextLabel
func _ready():
install_effect(MyCustomEffect.new())
# Alternatively, if not using `class_name` in the script that extends RichTextEffect:
install_effect(preload("res://effect.gd").new())
[/codeblock]
</description>
</method>
<method name="is_menu_visible" qualifiers="const">