瀏覽代碼

Improve RichTextLabel `install_effect()` documentation

(cherry picked from commit 78fff7292cfd5938f316dfaea7cc11e4fc570ca3)
Hugo Locurcio 1 年之前
父節點
當前提交
a35a0935fb
共有 2 個文件被更改,包括 23 次插入2 次删除
  1. 1 1
      doc/classes/RichTextEffect.xml
  2. 22 1
      doc/classes/RichTextLabel.xml

+ 1 - 1
doc/classes/RichTextEffect.xml

@@ -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]

+ 22 - 1
doc/classes/RichTextLabel.xml

@@ -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">