Tree view/fr

Introduction
La vue en arborescence apparaît dans l'onglet de la 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.







Étiquettes et attributs
Dans la colonne Étiquettes et attributs, les étiquettes et les icônes des objets sont affichées.

Selecting an object in this column and pressing (on Windows and Linux), or  (on macOS), allows to edit the object's  property in situ without detour via the context menu action described below or the Property editor.

Description
La colonne Description affiche des informations supplémentaires sur les objets, si elles sont disponibles. Ces informations sont stockées dans la propriété.

This information is stored in an object's property which can be edited in situ by selecting the object in this column and pressing  (on Windows and Linux), or  (on macOS), or via the Property editor.

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

Application start
Lorsque l'application démarre, l'atelier Start par défaut est actif et aucun document n'a été créé, un clic droit sur la vue en arborescence affiche un sous-menu avec quatre commandes : Elles permettent de travailler avec divers documents, mais sont désactivées si aucun document n'est présent.
 * Copier la sélection
 * Copier le document actif
 * Copier tous les documents
 * Coller
 * Coller

New document
Une fois un nouveau document créé, les éléments suivants deviennent actifs :
 * Copier le document actif
 * Copier tous les documents
 * Copier tous les documents



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é.
 * : si actif, les objets du document ne seront pas recalculés automatiquement.
 * : si 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é.



Sélection d'objets
Une fois que les objets ont été ajoutés au document, un clic droit sur ceux-ci fait apparaître des commandes supplémentaires. Celles-ci dépendent du nombre d'objets sélectionnés, de leur type et également du plan de travail actif. Dans la plupart des cas et avec la plupart des ateliers (sauf l'atelier Start), les commandes suivantes sont alors disponibles :
 * : lance une boîte de dialogue permettant de modifier les propriétés visuelles de l'objet entier.
 * : attribue une couleur aléatoire à l'objet.
 * : désactivé.
 * : copie un objet en mémoire.
 * : colle l'objet copié dans le document ; la copie est ajoutée à la fin de l'arborescence.
 * : supprime l'objet du document.
 * : si cette case est cochée, l'objet sera masqué dans l'arborescence.
 * : tous les objets dépendants seront ajoutés à la sélection. De cette façon, vous pouvez voir les dépendances et, par exemple, supprimer tous les objets dépendants en une seule fois.
 * : marque l'objet sélectionné comme pris en compte, et prêt pour le recalcul.
 * : recalcule l'objet sélectionné.
 * : lance l'édition de l'étiquette de l'objet sélectionné, et non du nom qui est en lecture seule. Cette option n'est disponible que si un seul objet est sélectionné.

Comme exemple d'extension du menu contextuel, si un Part Cube est cliqué du bouton droit de la souris alors que l'atelier Part est actif, les commandes supplémentaires suivantes sont disponibles :
 * : active le mode d'édition de l'objet.
 * : lance le widget de transformation pour déplacer ou faire tourner l'objet.
 * : lance une boîte de dialogue pour attacher l'objet à un ou plusieurs autres objets.
 * : définit la couleur des faces sélectionnées de l'objet.
 * : rend l'objet visible ou invisible dans la Vue 3D.
 * : rend visible l'objet sélectionné.
 * : rend l'objet sélectionné invisible.
 * : fait basculer la sélection de l'objet dans la Vue 3D.
 * : sélectionne toutes les instances de cet objet dans l'arborescence.
 * : crée une variable dans la console Python faisant référence à l'objet



Actions du clavier
Les actions clavier suivantes sont disponibles lorsque le curseur est sur l'arborescence :
 * + : ouvre une boîte de recherche au bas de l'arbre, permettant de rechercher et d'atteindre des objets en utilisant leurs noms ou leurs étiquettes.
 * Actions d'expansion et de réduction à l'aide des combinaisons + :
 * + : réduit le(s) élément(s) sélectionné(s).
 * + : développe le(s) élément(s) sélectionné(s).
 * + : développe le ou les éléments sélectionnés avec tous leurs enfants de niveau 1 réduits (les enfants plus profonds restent inchangés).
 * + : développe le ou les éléments sélectionnés avec tous leurs enfants de niveau 1 également développés (les enfants plus profonds restent inchangés).



Icônes de superposition
Une ou plusieurs petites icônes de superposition peuvent être affichées au-dessus de l'icône par défaut d'un objet dans l'arborescence. Les icônes superposées disponibles et leur signification sont énumérées ci-dessous.



[[File:FreeCAD_Tree_view_recompute.png]] Marque blanche sur fond bleu
Cela indique que l'objet doit être recalculé en raison de modifications apportées au modèle ou parce que l'utilisateur a marqué l'objet dans le menu contextuel de la vue arborescente pour qu'il soit recalculé. Dans la plupart des cas, les recalculs sont déclenchés automatiquement, mais ils sont parfois retardés pour des raisons de performance.



[[File:FreeCAD_Tree_view_tip.png]] Flèche blanche sur fond vert
Ceci indique ce qu'on appelle le Tip d'un corps. C'est généralement la dernière fonction d'un PartDesign Corps et représente le corps entier pour le monde extérieur au corps, par exemple lorsque le corps est exporté ou utilisé dans des Part opérations booléennes. Le Tip peut être modifié par l'utilisateur.



[[File:FreeCAD_Tree_view_unattached.png]] Maillon de chaîne violet sur fond blanc
Cela est généralement indiqué pour les esquisses, les primitives géométriques, telles que la boîte, le cylindre, etc. et un Datum géométrique. Elle indique que l'objet n'est pas attaché à quelque chose. Il n'a pas de décalage d'ancrage et obtient sa position et son alignement uniquement à partir de sa propriété Placement.

Il existe un Tutoriel Les bases pour l'ancrage expliquant comment gérer ces objets.



[[File:FreeCAD_Tree_view_notfullyconstrained.png]] X jaune
Ceci n'est utilisé que pour des esquisses et indique que l'esquisse n'est pas entièrement contrainte. Dans l'atelier Sketcher, le nombre de degrés de liberté restants est indiqué dans les messages du solveur.



[[File:FreeCAD_Tree_view_error.png]] Point d'exclamation blanc sur fond rouge
Cela indique que l'objet présente une erreur qui doit être corrigée. Après avoir recalculé l'ensemble du document, une info-bulle décrivant l'erreur est affichée lorsque vous passez la souris sur l'objet dans l'arborescence. Remarque: tous les autres objets dépendant d'un objet dans un tel état d'erreur ne seront pas correctement recalculés, ils peuvent donc encore présenter un ancien état.



[[File:FreeCAD_Tree_view_hidden.png]] Symbole de l'oeil
Cela indique que l'objet sera masqué dans la vue en arborescence parce que son option du menu contextuel est cochée. Cocher puis décocher l'option du menu contextuel du document, ou reouvrir le document, permet de mettre à jour la vue en arborescence.