diff options
| author | Rémi Verschelde <rverschelde@gmail.com> | 2019-08-15 02:54:48 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-08-15 02:54:48 +0200 |
| commit | c78bf816ff4d679cd645460603b21c83d24f3571 (patch) | |
| tree | 3ce7df924adeae062174ccc180988c19ce6d9e2a /doc | |
| parent | d998daeaa72130d72f87b8648cb2e70be82982ea (diff) | |
| parent | d4d03e5de9189d2c81a19a40362b8c23f9a8893f (diff) | |
Merge pull request #31376 from zzwx-forks/master
Documentation note that Node::add_child() fails if child already has a parent
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/classes/Node.xml | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/classes/Node.xml b/doc/classes/Node.xml index 889ce4d3eb..097fa1f6e5 100644 --- a/doc/classes/Node.xml +++ b/doc/classes/Node.xml @@ -122,6 +122,12 @@ <description> Adds a child node. Nodes can have any number of children, but every child must have a unique name. Child nodes are automatically deleted when the parent node is deleted, so an entire scene can be removed by deleting its topmost node. 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. + [b]Note:[/b] If the child node already has a parent, the function will fail. Use [method remove_child] first to remove the node from its current parent. For example: + [codeblock] + if child_node.get_parent(): + child_node.get_parent().remove_child(child_node) + add_child(child_node) + [/codeblock] </description> </method> <method name="add_child_below_node"> |