Improve RichTextLabel `install_effect()` documentation

This commit is contained in:
Hugo Locurcio 2023-12-19 17:29:49 +01:00
parent 1f5d4a62e9
commit 78fff7292c
No known key found for this signature in database
GPG Key ID: 39E8F8BE30B0A49C
2 changed files with 23 additions and 2 deletions

View File

@ -4,7 +4,7 @@
A custom effect for a [RichTextLabel]. A custom effect for a [RichTextLabel].
</brief_description> </brief_description>
<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. [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] [codeblocks]
[gdscript skip-lint] [gdscript skip-lint]

View File

@ -225,7 +225,28 @@
<return type="void" /> <return type="void" />
<param index="0" name="effect" type="Variant" /> <param index="0" name="effect" type="Variant" />
<description> <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> </description>
</method> </method>
<method name="is_menu_visible" qualifiers="const"> <method name="is_menu_visible" qualifiers="const">