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 réétiqueter 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.





Colonnes de la vue en arborescence
Par défaut, la vue en arborescence n'affiche qu'une seule colonne avec les étiquettes et les icônes des objets. Une deuxième colonne avec des descriptions peut être affichée en option, et des en-têtes de colonne sont également ajoutés.

Pour activer la colonne de description, cliquez avec le bouton droit de la souris sur la vue en arborescence et sélectionnez dans le menu contextuel :



Modifier l'étiquette de l'objet
Sélectionnez un objet dans la première colonne et appuyez sur (sous Windows et Linux) ou  (sous macOS) pour modifier sa propriété. Cette propriété peut également être modifiée via l'action du menu contextuel décrite ci-dessous ou dans l'éditeur de propriétés.

Edit object description
Ces informations sont enregistées dans la propriété d'un objet, qui peut être modifiée in situ en sélectionnant l'objet dans cette colonne et en appuyant sur  (sous Windows et Linux), ou  (sous macOS), ou via l'éditeur de propriétés.

Actions
Étant donné que la vue en 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.



Lancement de l'application
Lorsque l'application démarre, que l'atelier Start par défaut est actif et qu'aucun document n'a été créé, le menu contextuel de la vue en arborescence ne comporte qu'une seule entrée : Elles permettent de travailler avec divers documents, mais sont désactivées si aucun document n'est présent.
 * . Lorsque le curseur est déplacé sur cette entrée, un sous-menu contenant quatre commandes s'ouvre :
 * Copier la sélection
 * Copier le document actif
 * Copier tous les documents
 * Coller



Nouveau document
Une fois qu'un nouveau document a été créé, un clic droit sur l'arrière-plan ouvre le menu contextuel qui contient désormais deux entrées :
 * comme ci-dessus mais avec ces deux entrées activées :
 * Copier le document actif
 * Copier tous les documents
 * - un sous-menu avec deux entrées :
 * - un autre sous-menu contenant trois commandes :
 * Groupe simple
 * Groupe avec liens
 * Groupe avec liens de transformation
 * Créer un lien



Sélection du document
Si vous sélectionnez le document et cliquez avec le bouton droit, en plus de et, le menu contextuel contient les commandes suivantes :
 * : si elle est active, la vue en 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é.
 * : tous les objets dépendants seront ajoutés à la sélection. De cette manière, il est possible de voir les dépendances et, par exemple, de supprimer tous les objets dépendants en une seule fois. Disponible uniquement pour les objets avec des liens et pour les documents.
 * : si actif, les objets du document ne seront pas recalculés automatiquement.
 * : si actif, le document n'autorisera le recalcul que pour certains objets. Uniquement disponible si est activé.
 * : 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.
 * : permet d'activer la visibilité des objets dans l'arborescence.
 * : 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 la vue en 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
Ceci indique que l'objet sera caché dans la vue en arborescence si l'option du menu contextuel n'est pas cochée.