====== Tree Controls ======
Tree controls are used to display hierarchical data.  They are used primarily in the [[bank_select_level_3|Bank Selection]], [[exam_edit_layout|Exam Layout]] and when working with [[competency_entry|Competencies]].

=== Expand a Tree ===
The image below is from Exam Layout.  It show a collapsed Exam with its Sections.  To expand collapsed nodes, click the arrow next to the node.

{{:treecollapsed.png?200|}}

=== Collapse a Tree ===
The image below is from Exam Layout.  It show an expanded Exam with its Sections.  To collapse an expanded node, click the arrow next to the node.

{{:treeexpanded.png?200|}}

=== Context Menus ===
Some trees like on Exam Layout support right-click context menus.  To open a context menu, right click the node on the tree.

{{:treecontext.png?200|}}

=== Drag and Drop ===
Some trees support drag and drop functionality to help reorder nodes in the tree.  For example, the Exam layout tree supports drag and drop to reorder Items on the Exam.

To drag and drop:
  * Select a node by clicking the mouse button down on the node.
  * While holding the mouse button down, **Drag** the node to another part of the tree.  When doing this, drop points are shown via a dashed line.
  * When the node is in position, **Drop** the node by releasing the mouse button.

{{:treedrag.png?200|}}

Note: If dragging a node to an area that is invalid, like dragging an Item to drop directly on an Exam, a "Not Allowed" symbol is displayed over the node.

{{:not_allowed_sign.jpg?50|}}