Tree view/it

Introduzione
La vista ad albero appare nella scheda della vista combinata; mostra tutti gli oggetti definiti dall'utente che fanno parte di un documento di FreeCAD. La vista ad albero è una rappresentazione della struttura del documento e indica quali informazioni vengono salvate sul disco.

Questi oggetti non devono necessariamente essere forme geometriche visibili nella vista 3D, ma possono anche oggetti dati di supporto creati con qualsiasi ambiente.



Lavorare con la vista ad albero
Per impostazione predefinita, ogni volta che viene creato un nuovo oggetto, questo viene aggiunto alla fine dell'elenco nella vista ad albero. La vista ad albero consente di gestire gli oggetti per mantenerli organizzati; consente di creare dei gruppi, spostare gli oggetti all'interno dei gruppi, spostare dei gruppi all'interno di altri gruppi, rinominare oggetti, copiare oggetti, eliminare oggetti e altre operazioni del menu contestuale che dipende anche dall'ambiente attualmente attivo.

Molte operazioni creano oggetti che dipendono da un oggetto precedentemente esistente. In questo caso, la vista ad albero mostra questa relazione assorbendo l'oggetto più vecchio all'interno del nuovo oggetto. L'espansione e la compressione degli oggetti nella vista ad albero mostra la cronologia parametrica di quell'oggetto. Gli oggetti più profondi all'interno degli altri sono quelli più vecchi, mentre gli oggetti all'esterno sono i più recenti e sono derivati dagli oggetti più vecchi. Modificando gli oggetti interni, le operazioni parametriche si propagano fino in cima, generando un nuovo risultato.





Azioni
le espressioni e le azioni link sono state aggiunte nella versione 0.19.

Poiché la vista ad albero elenca oggetti che possono essere visibili nella vista 3D, molte delle azioni sono uguali a quelle che possono essere eseguite nella vista 3D.

All'avvio dell'applicazione, per impostazione predefinita è attivo l'ambiente Start e non viene stato creato alcun documento, facendo clic con il tasto destro del mouse sulla vista ad albero appare solo un comando:
 * : Copia selezionati, Copia il documentoattivo, Copia tutti i documenti, Incolla. Questi comandi consentono di lavorare con vari documenti, ma sono disabilitati se non è presente alcun documento.

Una volta creato un nuovo documento, diventano attivi i seguenti elementi:
 * : Copia il documento attivo, Copia tutti i documenti.

Inoltre, sono disponibili le azioni Link.
 * : Crea Link.
 * : Gruppo semplice, Gruppo con link, Gruppo con link di trasformazione.

Selezione del documento
Se si seleziona il documento attivo e si fa clic con il tasto destro, oltre a and, vengono visualizzati i seguenti comandi:
 * : se attivo, la vista ad albero mostra gli oggetti nascosti.
 * : mostra un campo di input per cercare oggetti all'interno del documento selezionato.
 * : chiude il documento selezionato chiamando il metodo dell'applicazione.
 * : se attivo, gli oggetti del documento non vengono più ricalcolati automaticamente.
 * : se attivo, il documento consente il ricalcolo solo di alcuni oggetti.
 * : contrassegna tutti gli oggetti del documento come toccati e pronti per il ricalcolo.
 * : crea un gruppo nel documento selezionato usando il metodo del documento.

Selezione degli oggetti
Una volta aggiunti gli oggetti al documento, oltre alle azioni precedenti, facendo clic con il tasto destro su una parte vuota della vista ad albero vengono mostrati dei comandi aggiuntivi; questi dipendono dal tipo di oggetto e dall'ambiente attivo.

Ad esempio, con Draft attivo, selezionare prima un oggetto, quindi fare clic con il tasto destro su un posto vuoto nella vista ad albero:
 * : rende l'oggetto visibile o invisibile nella vista 3D.
 * : rende visibili gli oggetti selezionati.
 * : nasconde gli oggetti selezionati.
 * : rende l'oggetto non più selezionabile nella Vista 3D; usare di nuovo questo comando per annullarne l'effetto. Imposta l'attributo dell'oggetto su  o . Modificare la proprietà attivando  nell'editor delle proprietà.
 * : seleziona tutte le istanze di questo oggetto nella vista ad albero.
 * : avvia la finestra di dialogo per modificare il colore e le dimensioni di linee e vertici e il colore delle facce.
 * : assegna un colore casuale all'oggetto. Imposta l'attributo dell'oggetto su una tupla  con un valore casuale compreso tra 0 e 1. Cambia la proprietà modificando  nell'editor delle proprietà.
 * : disabilitato se il cli con il tasto destro non si avviene sull'oggetto.
 * : copia un oggetto in memoria.
 * : incolla l'oggetto copiato nel documento; la copia viene aggiunta alla fine della vista ad albero.
 * : rimuove l'oggetto dal documento e dalla vista ad albero chiamando il metodo del documento.
 * : comandi contestuali aggiuntivi forniti da Draft.

Se si seleziona un oggetto, ad esempio una linea di Draft e si fa clic con il tasto destro nello stesso oggetto, possono essere disponibili comandi aggiuntivi:
 * : avvia il widget di trasformazione per spostare o ruotare l'oggetto.
 * : imposta i colori dell'oggetto.
 * : comando specifico per una linea di Draft.
 * : se attivo, l'oggetto selezionato viene impostato come nascosto.
 * : contrassegna l'oggetto selezionato come toccato e pronto per il ricalcolo.
 * : ricalcola l'oggetto selezionato.
 * : avvia la modifica del nome dell'oggetto selezionato. Ciò consente di modificare l'attributo, ma non l'attributo , poiché quest'ultimo è di sola lettura.

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]]