Tree view

From FreeCAD Documentation
Revision as of 22:27, 26 September 2019 by Vocx (talk | contribs) (More options for the right click)

Introduction

The tree view appears in the Model tab of the combo view; it shows all user defined objects that are part of a FreeCAD document. The tree view is a representation of the document's structure, and indicates what information is saved to disk.

These objects don't necessarily have to be geometrical shapes visible in the 3D view, but can also be supporting data objects created with any of the workbenches.

The tree view showing various elements in the document.

Working with the tree view

By default, whenever a new object is created, it is added to the end of the list in the tree view. Then, the tree view allows managing the objects to keep them organized; it permits creating groups, moving objects inside groups, moving groups inside other groups, renaming objects, copying objects, deleting objects, and other operations in the contextual menu which also depends on the currently active workbench.

Many operations create objects that are dependent on a previously existing object. In this case, the tree view shows this relationship by absorbing the older object inside the new object. Expanding and collapsing the objects in the tree view shows the parametric history of that object. Objects that are deeper inside others are older, while objects that are outside are newer, and are derived from the older objects. By modifying the interior objects, the parametric operations propagate all the way to the top, generating a new result.

The topmost object is created by doing parametric operations on objects which themselves were created by previous operations. Expanding the tree many levels reveals the original elements that were used to create the partial solids.

Actions

When the application starts, the default Start Workbench is active, and no document has been created, right clicking on the tree view shows only one command:

  • Expression actions: Copy selected, Copy active document, Copy all documents, Paste. These allow working with various documents, but are disabled if no document is present.

Once a new document has been created the following become active:

  • Expression actions: Copy active document, Copy all documents.

In addition, Link actions are available.

  • Link actions: Make Link.
    • Make Link group: Simple group, Group with links, Group with transform links.

Once objects are added to the document, then in addition to the previous menus, right clicking on an empty part of the tree view will show additional options. These depend on the type of object and the active workbench. For example, with the Draft Workbench:

  • Toggle visibility: make visible or invisible in the 3D view.
  • Show selection:
  • Hide selection:
  • Toggle selectability:
  • Select all instances:
  • Appearance:
  • Random color:
  • Cut:
  • Copy:
  • Paste:
  • Delete:
  • Utilities:


Template:Interface