Tree view/fr

Introduction
La vue en arborescence apparaît dans l'onglet de Vue combinée, l'un des panneaux les plus importants de l'interface. Elle montre tous les objets définis par l'utilisateur qui font partie d'un document FreeCAD. L'arborescence est une représentation de la Structure d'un document et indique quelles informations sont enregistrées sur le disque.

Ces objets ne doivent pas nécessairement être des formes géométriques visibles dans la Vue 3D mais peuvent également prendre en charge des objets de données créés avec l'un des ateliers.



Travailler avec la vue en arborescence
Par défaut, chaque fois qu'un nouvel objet est créé, il est ajouté à la fin de la liste dans l'arborescence. L'arborescence permet de gérer les objets pour les garder organisés. Elle permet de créer des groupes, de déplacer des objets à l'intérieur de groupes, de déplacer des groupes à l'intérieur d'autres groupes, de renommer des objets, de copier des objets, de supprimer des objets et d'autres opérations dans le menu contextuel (clic droit) qui dépendent de l'objet actuellement sélectionné et du plan de travail actuellement actif.

De nombreuses opérations créent des objets qui dépendent d'un objet déjà existant. Dans ce cas, l'arborescence montre cette relation en absorbant l'objet plus ancien à l'intérieur du nouvel objet. Le développement et la réduction des objets dans l'arborescence montrent l'historique paramétrique de cet objet. Les objets qui sont plus profondément à l'intérieur des autres sont plus anciens, tandis que les objets qui sont à l'extérieur sont plus récents et sont dérivés des objets plus anciens. En modifiant les objets intérieurs, les opérations paramétriques se propagent jusqu'au sommet, générant un nouveau résultat.





Actions
des expressions et des actions de liaison ont été ajoutées dans la version 0.19.

Étant donné que l'arborescence répertorie les objets pouvant être visibles dans la vue 3D, de nombreuses actions sont identiques à celles qui peuvent être exécutées à partir de la vue 3D.

Lorsque l'application démarre, la valeur par défaut de l'Atelier Start est active, aucun document n'a été créé, un clic droit sur la vue en arborescence affiche une seule commande:
 * : Copy selected, Copy active document, Copy all documents, Coller. Celles-ci permettent de travailler avec divers documents mais sont désactivées si aucun document n'est présent.

Une fois un nouveau document créé, les éléments suivants deviennent actifs:
 * : Copy active document, Copy all documents.

De plus, les actions Liens sont disponibles.
 * : Make Link.
 * : Simple group, Group with links, Group with transform links.

Sélection du document
Si vous sélectionnez le document actif et cliquez avec le bouton droit, en plus de et, les commandes suivantes apparaissent:
 * : si elle est active, l'arborescence affichera les éléments masqués.
 * : affiche un champ de saisie pour rechercher des objets à l'intérieur du document sélectionné.
 * : ferme le document sélectionné en appelant la méthode de l'application.
 * : s'il est actif, les objets du document ne seront pas recalculés automatiquement.
 * : s'il est actif, le document n'autorisera le recalcul que pour certains objets.
 * : marque tous les objets du document comme touchés et prêts pour recalcul.
 * : crée un groupe dans le document sélectionné en utilisant la méthode du document.

Sélection d'objets
Une fois les objets ajoutés au document, en plus des actions précédentes, un clic droit sur une partie vide de l'arborescence affichera des commandes supplémentaires. Ceux-ci dépendent du type d'objet et de l'atelier actif.

Par exemple, avec Atelier Draft actif, sélectionnez d'abord un objet, puis cliquez avec le bouton droit sur un emplacement vide dans l'arborescence:
 * : rend l'objet visible ou invisible dans la vue 3D.
 * : rend les objets sélectionnés visibles.
 * : rend les objets sélectionnés invisibles.
 * : rend l'objet non sélectionnable dans la vue 3D. Utilisez à nouveau cette commande pour annuler son effet. Il définit l'attribut de l'objet sur  ou . Modifiez la propriété en basculant  dans l'Éditeur de propriétés.
 * : sélectionne toutes les instances de cet objet dans l'arborescence.
 * : ouvre la boîte de dialogue pour changer la couleur et la taille des lignes et des sommets et la couleur des faces.
 * : attribue une couleur aléatoire à l'objet. Il définit l'attribut de l'objet sur un tuple  avec des arborescences aléatoires entre 0 et 1. Modifiez la propriété en modifiant  dans l'Éditeur de propriétés.
 * : désactivé si le clic droit n'est pas sur l'objet.
 * : copie un objet en mémoire.
 * : pastes the copied object into the document; the copy is added to the end of the tree view.
 * : supprime l'objet du document et de l'arborescence en appelant la méthode du document.
 * : commandes contextuelles supplémentaires fournies par l'Atelier Draft.

Si un objet est sélectionné, par exemple, une Draft Ligne et qu'un clic droit est effectué dans le même objet, des commandes supplémentaires peuvent être disponibles:
 * : lance le widget de transformation pour déplacer ou faire pivoter l'objet.
 * : définit les couleurs de l'objet.
 * : commande spécifique pour une Draft Ligne
 * : si actif, l'objet sélectionné sera défini comme masqué.
 * : marque l'objet sélectionné comme coché et prêt pour être recalculer.
 * : recalcule l'objet sélectionné.
 * : commence à modifier le nom de l'objet sélectionné. Cela permet de modifier l'attribut mais pas l'attribut  car ce dernier est en lecture seule.

Overlay icons
The icons in the tree view can have different overlays, which means that another even smaller icon is put on top of the tree view icon.
 * [[File:FreeCAD_Tree_view_recompute.png]] White hook on blue background: This object has to be recomputed, due to changes made to the model or because the user marked the object in the context menu to be recomputed. In most cases the recompute is triggered automatically, but sometimes the recomputes are delayed due to performance reasons. You then have to Recompute manually.
 * [[File:FreeCAD_Tree_view_tip.png]] White arrow on green background: This is the so called Tip of a body. It is usually the last feature in a PartDesign Body and represents the whole body to the world outside of the body, e.g. when the body is exported or used in Part boolean operations. The tip can be changed by the user.
 * [[File:FreeCAD_Tree_view_unattached.png]] Purple chain link on white background: This is usually shown for sketches, geometric primitives, such as cube, cylinder, etc. or Datum geometry and indicates, that the object is not attached to anything. It has no AttachmentOffset and gets its position and alignement solely from its Placement property. There is a Basic Attachment Tutorial explaining how to handle such objects.
 * [[File:FreeCAD_Tree_view_notfullyconstrained.png]] Yellow X: The sketch is not fully constrained. Inside of Sketcher the number of remaining degrees of freedom is shown in the solver messages.
 * [[File:FreeCAD_Tree_view_error.png]] White exclamation mark on red background: An error occurred and has to be removed. If you recompute the whole document a tooltip describing the error is shown when you hover with the mouse over that error. Note: All other objects depending on an object in such error state are not recomputed either, thus they may still show some old state.
 * It is possible that multiple overlays are shown at the same time, example: [[File:FreeCAD_Tree_view_multiple.png]]