Tree View
=========

*Tree View* is an important part of the :doc:`DEXi <DEXi>` :doc:`model
window <DEXiIntModWin>` and its :doc:`Model
Page <DEXiIntTabMod>`. It shows the
:doc:`structure <DEXiGlosTree>` of the currently edited :doc:`DEXi
model <DEXiIntModel>`.

.. image:: images/TreeView.png
   :alt: Tree View

In Tree View, you can:

-  Select a single attribute by clicking it or using keyboard arrows.
-  Invoke :ref:`Model Page commands <DEXiIntTabMod_cmd>`. Most of these
   commands refer to the currently selected attribute.
-  Move attributes and subtrees shown in the Tree View using standard
   drag-and-drop mouse commands.
-  Expand and collapse the display of sub-trees by clicking the symbols
   |+| and |-|, respectively.

Status
------

While editing the model, the status of its
:doc:`attributes <DEXiGlosAttr>` is shown in Tree View using the
following symbols:

|Basic Incomplete| Incomplete basic attribute: an attribute having an
undefined :doc:`scale <DEXiGlosScale>`.

|Basic Complete| Completely defined basic attribute.

|Aggregate Undef| Aggregate attribute whose :doc:`utility
function <DEXiGlosFunct>` cannot be constructed due to undefined
:doc:`scales <DEXiGlosScale>` of its own and/or its descendants.

|Aggregate New| Aggregate attribute with an undefined :doc:`utility
function <DEXiGlosFunct>` (but everything is ready for its
construction).

|Aggregate Incomplete| Aggregate attribute with a partially or
incompletely defined :doc:`utility function <DEXiGlosFunct>`.

|Aggregate Complete| Aggregate attribute with a fully defined (100%
:doc:`determined <DEXiGlosFunctDef>`) :doc:`utility
function <DEXiGlosFunct>`.

|linked| :doc:`Linked attribute <DEXiGlosLink>`.

Remark
------

Usually, the goal is to completely define all :doc:`DEXi
model <DEXiIntModel>` components. In Tree View, this is indicated
by "all green" status symbols. Occasionally and only with a good reason,
it is acceptable to leave a partially defined utility function
|incomplete| and/or to have a linked attribute |linked|.

.. |+| image:: images/expand.png
.. |-| image:: images/collapse.png
.. |Basic Incomplete| image:: images/b_new.png
.. |Basic Complete| image:: images/b_ok.png
.. |Aggregate Undef| image:: images/a_forb.png
.. |Aggregate New| image:: images/a_new.png
.. |Aggregate Incomplete| image:: images/a_incmpl.png
.. |Aggregate Complete| image:: images/a_ok.png
.. |linked| image:: images/a_lnk.png
.. |incomplete| image:: images/a_incmpl.png

.. toctree::
  :hidden: