Tree view/ru

Введение
Древо проекта появляется на вкладке комбо панели, одной из самых важных панелей интерфейса; оно показывает все пользовательские объекты, которые являются частью документа FreeCAD. Древо проекта представляет собой структуру документа и указывает, какая информация сохраняется на диске.

Эти объекты не обязательно должны быть геометрическими фигурами, видимыми в 3D-виде, но также могут быть вспомогательными объектами данных, созданными с помощью любого из верстаков.



Работа с древом проекта
По умолчанию всякий раз, когда создается новый объект, он добавляется в конец списка древа проекта. Древовидное представление позволяет управлять объектами, чтобы сохранить их организованными; оно позволяет создавать группы, перемещать объекты внутри групп, перемещать группы внутри других групп, переименовывать объекты, копировать объекты, удалять объекты и другие операции в контекстном меню (щелчок правой кнопкой мыши), которые зависят от текущего выбранного объекта и текущего активного рабочего верстака.

Многие операции создают объекты, которые зависят от ранее существовавшего объекта. В этом случае древовидное представление показывает эту связь, поглощая более старый объект внутри нового объекта. Разворачивание и сворачивание объектов в древовидном представлении показывает параметрическую историю этого объекта. Объекты, которые находятся глубже внутри других, являются более старыми, в то время как объекты, которые находятся снаружи, являются более новыми и являются производными от более старых объектов. Изменяя внутренние объекты, параметрические операции распространяются до самого верха, порождая новый результат.





Действия
expressions and link actions were added in version 0.19.

Since the tree view lists objects that may be visible in the 3D view, many of the actions are the same to those that can be executed from the 3D view.

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:
 * : 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:
 * : Copy active document, Copy all documents.

In addition, Link actions are available.
 * : Make Link.
 * : Simple group, Group with links, Group with transform links.

Выбор документа
If you select the active document and right click, in addition to and, the following commands appear:
 * : if active, the tree view will show hidden items.
 * : shows an input field to search objects inside the selected document.
 * : closes the selected document by calling the application's method.
 * : if active, the document's objects will not recompute automatically.
 * : if active, the document will allow recompute of only some objects.
 * : marks all objects of the document as touched, and ready for recompute.
 * : creates a group in the selected document by using the document's method.

Выбор объектов
Once objects are added to the document then in addition to the previous actions, right clicking on an empty part of the tree view will show additional commands; these depend on the type of object and the active workbench.

For example, with the Draft Workbench active, first select an object, then right click on an empty place in the tree view:
 * : makes the object visible or invisible in the 3D view.
 * : makes the selected objects visible.
 * : makes the selected objects invisible.
 * : makes the object no longer selectable in the 3D view; use again this command to cancel its effect. It sets the object's attribute to  or . Change the property by toggling  in the property editor.
 * : selects all instances of this object in the tree view.
 * : launches the dialog to change color and sizes of lines and vertices, and color of faces.
 * : assigns a random color to the object. It sets the object's attribute to a tuple  with tree random floats between 0 and 1. Change the property by modifying  in the property editor.
 * : disabled if the right-click is not on the object.
 * : copies an object into memory.
 * : pastes the copied object into the document; the copy is added to the end of the tree view.
 * : removes the object from the document, and from the tree view, by calling the document's method.
 * : additional contextual commands provided by the Draft Workbench.

If an object is selected, for example, a Draft Line, and a right click is made in the same object additional commands may be available:
 * : launches the transform widget to move or rotate the object.
 * : sets the colors of the object.
 * : specific command for a Draft Line.
 * : if active, the selected object will be set as hidden.
 * : marks the selected object as touched, and ready for recompute.
 * : recomputes the selected object.
 * : starts editing the name of the selected object. This allows changing the attribute, but not the  attribute, as the latter is read-only.

Overlay icons
One or more smaller overlay icons can be displayed on top of an object's default icon in the tree view. The available overlay icons and their meaning are listed below.

[[File:FreeCAD_Tree_view_recompute.png]] White check mark on blue background
This indicates that the object has to be recomputed, due to changes made to the model or because the user marked the object in the tree view context menu to be recomputed. In most cases recomputes are triggered automatically, but sometimes they are delayed for performance reasons.

[[File:FreeCAD_Tree_view_tip.png]] White arrow on green background
This indicates 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 typically shown for sketches, geometric primitives, such as box, cylinder, etc. and Datum geometry. It indicates that the object is not attached to anything. It has no Attachment Offset and gets its position and alignment 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
This is only used for sketches and indicates that 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
This indicates that the object has an error that needs to be fixed. After recomputing the whole document a tooltip describing the error is shown when you hover the mouse over the object in the tree view. Note: All other objects depending on an object in such an error state will not be properly recomputed, thus they may still show some old state.