Parent a Node in Nodes Panel

The parenting feature enables you to create a hierarchy of nodes that can be moved and even cloned together.

Only nodes with NodeBaseMovable (such as item type nodes and the Layer3D node) can be used for parenting.

Guidelines about parenting

• Multiple nodes can share the same parent.

• The hierarchy can have more than one level. A child node can be the parent for another node.

• The parent node appears in the node table, so that is easy to search and group nodes by parent information.

• You should always set useLocalMatrix to True for nodes where for child nodes are not implicitly active (such as ItemTrendPopup). Otherwise, you cannot move the children together with their parent.

Parenting a node

We can add a parent in two different ways.

Choose a parent from Node properties

1. In the Nodes panel, select the child node.

   

2. In the Property panel, select the parent field and select Browse (…) to open a selection dialog.

   

3. On the Select a Node of type dialog, select the parent node from the node selection list.

   

4. Click OK.

   Alternatively, you can directly insert the parent name or use copy and paste tool.

Choose a parent from user interface

5. Right-click a 2D node, to see the Parent To option.

   

6. Select Choose From Panel or Choose From List.

   • Choose From Panel — Opens a dialog where you can apply filters to find the desired parent more easily. You can unparent the node if it has a parent.

   • Choose From List — Choose a parent from a list of all possible nodes that can act as a parent.

Parenting and unparenting is supported for both single selection and multi-selection, allowing you to assign the same parent to multiple 2D nodes at the same time.

When multiple nodes are selected, an additional option appears:

• First Selected — Sets the first selected node as the parent for all others.

  

Note: When parenting or unparenting is done through the user interface, the on-screen positions of 2D nodes remain exactly the same.