diff options
| author | Rémi Verschelde <rverschelde@gmail.com> | 2020-02-27 19:44:27 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-02-27 19:44:27 +0100 |
| commit | 2b3431e2b7706894d1aeb865f7b4ef93345bbbd4 (patch) | |
| tree | 63f8c94449accfc3eb0e5475aebb875623c873ed /doc/classes | |
| parent | ed0f1940cbdbe470da85f446f315ee12897038a1 (diff) | |
| parent | 393a3c3122ac3b54044190ba7bdd081d6703db64 (diff) | |
Merge pull request #36581 from Calinou/doc-improve-add-child-below-node
Improve the `Node.add_child_below_node()` documentation
Diffstat (limited to 'doc/classes')
| -rw-r--r-- | doc/classes/Node.xml | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/doc/classes/Node.xml b/doc/classes/Node.xml index 3ddc3af200..eb15bc2ad9 100644 --- a/doc/classes/Node.xml +++ b/doc/classes/Node.xml @@ -129,21 +129,23 @@ child_node.get_parent().remove_child(child_node) add_child(child_node) [/codeblock] + If you need the child node to be added below a specific node in the list of children, use [method add_child_below_node] instead of this method. [b]Note:[/b] If you want a child to be persisted to a [PackedScene], you must set [member owner] in addition to calling [method add_child]. This is typically relevant for [url=https://godot.readthedocs.io/en/latest/tutorials/misc/running_code_in_the_editor.html]tool scripts[/url] and [url=https://godot.readthedocs.io/en/latest/tutorials/plugins/editor/index.html]editor plugins[/url]. If [method add_child] is called without setting [member owner], the newly added [Node] will not be visible in the scene tree, though it will be visible in the 2D/3D view. </description> </method> <method name="add_child_below_node"> <return type="void"> </return> - <argument index="0" name="node" type="Node"> + <argument index="0" name="preceding_node" type="Node"> </argument> - <argument index="1" name="child_node" type="Node"> + <argument index="1" name="node" type="Node"> </argument> <argument index="2" name="legible_unique_name" type="bool" default="false"> </argument> <description> - Adds a child node. The child is placed below the given node in the list of children. + Adds a child node below the [code]preceding_node[/code]. If [code]legible_unique_name[/code] is [code]true[/code], the child node will have an human-readable name based on the name of the node being instanced instead of its type. + Use [method add_child] instead of this method if you don't need the child node to be added below a specific node in the list of children. </description> </method> <method name="add_to_group"> |