View source for Att NodeGroup

[[category:Attributes]]
''New to [[Analytica 6.5]]''

== Attribute Att_NodeGroup ==

Used to group multiple nodes on a diagram into a single unit. The node group selects together when you click on any node in the group, and moves as a unit.  The attribute gets set when you select '''Group nodes''' on the [[Right mouse button menus]] for nodes in edit mode.

A node group has one "primary" node, which is displayed in the [[Attribute panel]] when the group is selected, and which is the target of any UI command that operates on the selected node.

A group is created by setting the <code>Att_NodeGroup</code> of each node in the group to the same name. One node is marked as the primary node by placing an astrisk (<code>*</code>) in front of the name.  For example:

 Module Module_A 
 Att_NodeGroup: *group1
 ...
 &nbsp;
 Variable X
 Att_NodeGroup: group1
 ...
 &nbsp;
 FormNode Fo12345
 Original: X
 Att_NodeGroup: group1
 ...

== Nested groups ==
When a group is then grouped again into a larger group, the attribute is set to a comma-separated list, where the first entry specifies the group name. The remaining entries have no effect other than providing information so that '''Ungroup nodes''' can restore the original grouping.  For example, when the above group is grouped with Variable B, with B set to be the primary node, you might have:

 Module Module_A 
 Att_NodeGroup: group2,*group1
 ...
 &nbsp;
 Variable X
 Att_NodeGroup: group2,group1
 ...
 &nbsp;
 FormNode Fo12345
 Original: X
 Att_NodeGroup: group2,group1
 ...
 &nbsp;
 Variable B
 Att_NodeGroup: *group2

== See also ==
* [[Right mouse button menus]]