Tree view/ru: Difference between revisions

From FreeCAD Documentation
(Created page with "Поскольку в древе проекта перечислены объекты, которые могут быть видны в 3D-виде, многи...")
(Updating to match new version of source page)
 
(43 intermediate revisions by 3 users not shown)
Line 2: Line 2:
{{TOCright}}
{{TOCright}}


<span id="Introduction"></span>
== Введение ==
== Введение ==


<div class="mw-translate-fuzzy">
[[Tree_view/ru|Древо проекта]] появляется на вкладке {{MenuCommand|Модель}} [[Combo_view/ru|комбо панели]], одной из самых важных панелей [[Interface/ru|интерфейса]]; оно показывает все пользовательские объекты, которые являются частью документа FreeCAD. Древо проекта представляет собой [[Document_structure/ru|структуру документа]] и указывает, какая информация сохраняется на диске.
[[Tree_view/ru|Древо проекта]] появляется на вкладке {{MenuCommand|Модель}} [[Combo_view/ru|комбо панели]], одной из самых важных панелей [[Interface/ru|интерфейса]]; оно показывает все пользовательские объекты, которые являются частью документа FreeCAD. Древо проекта представляет собой [[Document_structure/ru|структуру документа]] и указывает, какая информация сохраняется на диске.
</div>


Эти объекты не обязательно должны быть геометрическими фигурами, видимыми в [[3D_view/ru|3D-виде]], но также могут быть вспомогательными объектами данных, созданными с помощью любого из [[Workbenches/ru|верстаков]].
Эти объекты не обязательно должны быть геометрическими фигурами, видимыми в [[3D_view/ru|3D-виде]], но также могут быть вспомогательными объектами данных, созданными с помощью любого из [[Workbenches/ru|верстаков]].
Line 12: Line 15:
{{Caption|Древо проекта, показывающее различные элементы документа}}
{{Caption|Древо проекта, показывающее различные элементы документа}}


<span id="Working_with_the_tree_view"></span>
== Работа с древом проекта ==
== Работа с древом проекта ==


<div class="mw-translate-fuzzy">
По умолчанию всякий раз, когда создается новый объект, он добавляется в конец списка древа проекта. Древовидное представление позволяет управлять объектами, чтобы сохранить их организованными; оно позволяет создавать [[Std_Group/ru|группы]], перемещать объекты внутри групп, перемещать группы внутри других групп, переименовывать объекты, копировать объекты, удалять объекты и другие операции в контекстном меню (щелчок правой кнопкой мыши), которые зависят от текущего выбранного объекта и текущего активного рабочего верстака.
По умолчанию всякий раз, когда создается новый объект, он добавляется в конец списка древа проекта. Древовидное представление позволяет управлять объектами, чтобы сохранить их организованными; оно позволяет создавать [[Std_Group/ru|группы]], перемещать объекты внутри групп, перемещать группы внутри других групп, переименовывать объекты, копировать объекты, удалять объекты и другие операции в контекстном меню (щелчок правой кнопкой мыши), которые зависят от текущего выбранного объекта и текущего активного рабочего верстака.
</div>


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


[[File:FreeCAD_Tree_view_parametric_history.png|x300px]]
[[File:FreeCAD_Tree_view_parametric_history_1.png|x304px]] [[File:FreeCAD_Tree_view_parametric_history_2.png|x304px]]

[[File:FreeCAD_Tree_view_parametric_history_3.png|x304px]]


<div class="mw-translate-fuzzy">
{{Caption|Самый верхний объект создается путем выполнения параметрических операций над объектами, которые сами были созданы предыдущими операциями. Разворачивание списка в древе на много уровней, раскрывает исходные элементы, которые были использованы для создания элементов твердых тел.}}
{{Caption|Самый верхний объект создается путем выполнения параметрических операций над объектами, которые сами были созданы предыдущими операциями. Разворачивание списка в древе на много уровней, раскрывает исходные элементы, которые были использованы для создания элементов твердых тел.}}
</div>

=== Tree view columns ===

By default the tree view only displays a single column with the labels and icons of objects. A second column with descriptions can optionally be displayed as well, column headings are then also added.

To enable the description column right click the tree view and in the context menu select:<br>
{{MenuCommand|Tree settings → Show description column}} {{Version|0.21}}

=== Edit object label ===

Select an object in the first column and press {{KEY|F2}} (on Windows and Linux), or {{KEY|Enter}} (on macOS), to edit its {{PropertyData|Label}} property. This property can also be edited via the context menu option {{MenuCommand|Rename}} or in the [[Property_editor|Property editor]].

=== Edit object description ===

An object can optionally have a description. This information is stored in its {{PropertyData|Label2}} property. If the description column is displayed you can edit this property by selecting an object in that column and pressing {{KEY|F2}} (on Windows and Linux), or {{KEY|Enter}} (on macOS). The property can also be changed in the [[Property_editor|Property editor]].


== Действия ==
=== Context menu ===


The options in the context menu of the tree view depend on the selected object(s) and the currently active workbench. To display this menu right-click the background of the list, right-click an object in the list, or select multiple objects in the list and then right-click one of them.
{{Emphasis|Примечание:}} выражения и действия ссылок были добавлены в версии 0.19.


<span id="Keyboard_shortcuts"></span>
Поскольку в древе проекта перечислены объекты, которые могут быть видны в [[3D_view/ru|3D-виде]], многие действия совпадают с теми, которые могут быть выполнены из [[3D_view/ru|3D-вида]].
<div class="mw-translate-fuzzy">
=== Действия с клавиатуры ===
</div>


The following keyboard shortcuts are available when the focus is on the tree view:
When the application starts, the default [[Start_Workbench|Start Workbench]] is active, and no document has been created, right clicking on the [[Tree_view|tree view]] shows only one command:
* {{KEY|Ctrl}}+{{KEY|F}}: opens a search box at the bottom of the tree, allowing to search and reach objects using their names or labels.
* {{MenuCommand|Expression actions}}: [[Std_Expressions|Copy selected]], [[Std_Expressions|Copy active document]], [[Std_Expressions|Copy all documents]], Paste. These allow working with various documents, but are disabled if no document is present.
* Expand and collapse actions using {{KEY|Alt}}+{{KEY|Arrow}} combinations: {{Version|0.20}}
** {{KEY|Alt}}+{{KEY|Left}}: collapses selected item(s).
** {{KEY|Alt}}+{{KEY|Right}}: expands selected item(s).
** {{KEY|Alt}}+{{KEY|Up}}: expands selected item(s) with all their tier-1 children collapsed (deeper children remain unchanged).
** {{KEY|Alt}}+{{KEY|Down}}: expands selected item(s) with all their tier-1 children expanded as well (deeper children remain unchanged).


<span id="Overlay_icons"></span>
Once a new document has been created the following become active:
==Накладные иконки==
* {{MenuCommand|Expression actions}}: [[Std_Expressions|Copy active document]], [[Std_Expressions|Copy all documents]].


<div class="mw-translate-fuzzy">
In addition, [[Std_LinkMake|Link]] actions are available.
Одна или несколько небольших накладных иконок могут отображаться поверх иконки по умолчанию на объекте в древе проекта. Доступные накладные иконки и их значение перечислены ниже. {{Version|0.19}}
* {{MenuCommand|Link actions}}: [[Std_LinkMake|Make Link]].
</div>
** {{MenuCommand|Make Link group}}: [[Std_LinkMakeGroup|Simple group]], [[Std_LinkMakeGroup|Group with links]], [[Std_LinkMakeGroup|Group with transform links]].


<span id="File:FreeCAD_Tree_view_recompute.png_White_check_mark_on_blue_background"></span>
=== Выбор документа ===
=== [[File:FreeCAD_Tree_view_recompute.png]] Белая галочка на синем фоне ===


Это означает, что объект должен быть [[Std_Refresh/ru|пересчитан]] из-за изменений, внесенных в модель, или из-за того, что пользователь пометил объект в контекстном меню древа проекта для пересчёта. В большинстве случаев пересчёт запускается автоматически, но иногда он задерживается по причинам производительности.
If you select the active document and right click, in addition to {{MenuCommand|Expression actions}} and {{MenuCommand|Link actions}}, the following commands appear:
* {{MenuCommand|Show hidden items}}: if active, the tree view will show hidden items.
* {{MenuCommand|Search}}: shows an input field to search objects inside the selected document.
* {{MenuCommand|Close document}}: closes the selected document by calling the application's {{incode|closeDocument()}} method.
* {{MenuCommand|Skip recomputes}}: if active, the document's objects will not [[Std_Refresh|recompute]] automatically.
** {{MenuCommand|Allow partial recomputes}}: if active, the document will allow [[Std_Refresh|recompute]] of only some objects.
* {{MenuCommand|Mark to recompute}}: marks all objects of the document as touched, and ready for [[Std_Refresh|recompute]].
* {{MenuCommand|[[Std_Group|Create group]]}}: creates a [[Std_Group|group]] in the selected document by using the document's {{incode|addObject()}} method.


<span id="File:FreeCAD_Tree_view_error.png_White_exclamation_mark_on_red_background"></span>
=== Выбор объектов ===
=== [[File:FreeCAD_Tree_view_error.png]] Белый восклицательный знак на красном фоне ===


Это указывает на то, что объект имеет ошибку, которую необходимо исправить. После повторного вычисления всего документа при наведении курсора мыши на объект в древе проекта появляется всплывающая подсказка с описанием ошибки. '''Примечание:''' Все остальные объекты, зависящие от объекта в таком состоянии ошибки, не будут правильно пересчитаны, поэтому они всё ещё могут показывать какое-то устаревшее состояние.
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.


<span id="File:FreeCAD_Tree_view_tip.png_White_arrow_on_green_background"></span>
For example, with the [[Draft_Workbench|Draft Workbench]] active, first select an object, then right click on an empty place in the tree view:
=== [[File:FreeCAD_Tree_view_tip.png]] Белая стрелка на зелёном фоне ===
* {{MenuCommand|[[Std_ToggleVisibility|Toggle visibility]]}}: makes the object visible or invisible in the [[3D_view|3D view]].
* {{MenuCommand|[[Std_ShowSelection|Show selection]]}}: makes the selected objects visible.
* {{MenuCommand|[[Std_HideSelection|Hide selection]]}}: makes the selected objects invisible.
* {{MenuCommand|[[Std_ToggleSelectability|Toggle selectability]]}}: makes the object no longer selectable in the [[3D_view|3D view]]; use again this command to cancel its effect. It sets the object's {{incode|Selectable}} attribute to {{TRUE}} or {{FALSE}}. Change the property by toggling {{PropertyView|Selectable}} in the [[Property_editor|property editor]].
* {{MenuCommand|[[Std_TreeSelectAllInstances|Select all instances]]}}: selects all instances of this object in the tree view.
* {{MenuCommand|[[Std_SetAppearance|Appearance]]}}: launches the dialog to change color and sizes of lines and vertices, and color of faces.
* {{MenuCommand|[[Std_RandomColor|Random color]]}}: assigns a random color to the object. It sets the object's {{incode|ShapeColor}} attribute to a tuple {{incode|(r,g,b)}} with tree random floats between 0 and 1. Change the property by modifying {{PropertyView|Shape Color}} in the [[Property_editor|property editor]].
* {{MenuCommand|[[Std_Cut|Cut]]}}: disabled if the right-click is not on the object.
* {{MenuCommand|[[Std_Copy|Copy]]}}: copies an object into memory.
* {{MenuCommand|[[Std_Paste|Paste]]}}: pastes the copied object into the document; the copy is added to the end of the tree view.
* {{MenuCommand|[[Std_Delete|Delete]]}}: removes the object from the document, and from the tree view, by calling the document's {{incode|removeObject()}} method.
* {{MenuCommand|Utilities}}: {{Emphasis|(optional)}} additional contextual commands provided by the [[Draft_Workbench|Draft Workbench]].


Это указывает на, так называемый, [[PartDesign_Body#Tip/ru|Кончик]] тела. Обычно это последняя функция в [[PartDesign_Body/ru|PartDesign Тело]] и олицетворяет всё тело целиком в окружающем мире вне тела, например, когда тело экспортируется или используется в [[Part_Boolean/ru|Булевых операциях]]. Кончик может быть изменён пользователем.
If an object is selected, for example, a [[Draft_Line|Draft Line]], and a right click is made in the same object additional commands may be available:
* {{MenuCommand|Transform}}: launches the transform widget to move or rotate the object.
* {{MenuCommand|Set colors}}: sets the colors of the object.
* {{MenuCommand|Flatten this wire}}: {{Emphasis|(Draft)}} specific command for a [[Draft_Line|Draft Line]].
* {{MenuCommand|Hide item}}: if active, the selected object will be set as hidden.
* {{MenuCommand|Mark to recompute}}: marks the selected object as touched, and ready for [[Std_Refresh|recompute]].
* {{MenuCommand|Recompute}}: recomputes the selected object.
* {{MenuCommand|Rename}}: starts editing the name of the selected object. This allows changing the {{incode|Label}} attribute, but not the {{incode|Name}} attribute, as the latter is read-only.


<span id="File:FreeCAD_Tree_view_unattached.png_Purple_chain_link"></span>
== Overlay icons ==
<div class="mw-translate-fuzzy">
=== [[File:FreeCAD_Tree_view_unattached.png]] Фиолетовое звено цепи на белом фоне ===
</div>


Это обычно показано на [[Sketch/ru|sketches(эскизах)]], геометрических примитивах, таких как коробка, цилиндр и т.п. а также [[Datum/ru|Datum(Данных)]]. Это указывает на то, что объект ни к чему не привязан. Он не имеет Привязки от Смещения и получает свое положение и выравнивание исключительно из своего свойства [[Placement/ru|Размещения]].
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. {{Version|0.19}}


Существует базовый учебник (англ) [[Basic_Attachment_Tutorial|Basic Attachment Tutorial]], объясняющий, как обращаться с такими объектами.
=== [[File:FreeCAD_Tree_view_recompute.png]] White check mark on blue background ===


<span id="File:FreeCAD_Tree_view_notfullyconstrained.png_Yellow_X"></span>
This indicates that the object has to be [[Std_Refresh|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_notfullyconstrained.png]] Жёлтый крестик ===


<div class="mw-translate-fuzzy">
=== [[File:FreeCAD_Tree_view_tip.png]] White arrow on green background ===
Это обозначение используется только для [[Sketch/ru|эскизов]] и указывает на то, что эскиз не полностью ограничен. В среде [[Sketcher_Workbench/ru|Sketcher]] количество оставшихся степеней свободы отображается в сообщениях решателя.
</div>


=== [[File:FreeCAD_Tree_view_hidden.png]] Eye symbol ===
This indicates the so called [[PartDesign_Body#Tip|Tip]] of a body. It is usually the last feature in a [[PartDesign_Body|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|Part boolean]] operations. The tip can be changed by the user.


This indicates that the object will be hidden in the Tree view if the {{MenuCommand|Show items hidden in tree view}} context menu option is unchecked.
=== [[File:FreeCAD_Tree_view_unattached.png]] Purple chain link on white background ===


=== [[File:FreeCAD_Tree_view_frozen.png]] Cyan ice crystal ===
This is typically shown for [[Sketch|sketches]], geometric primitives, such as box, cylinder, etc. and [[Datum|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|Placement]] property.


{{Version|1.0}}
There is a [[Basic_Attachment_Tutorial|Basic Attachment Tutorial]] explaining how to handle such objects.


This indicates a frozen object that is not recomputed when its parents change.
=== [[File:FreeCAD_Tree_view_notfullyconstrained.png]] Yellow X ===


=== [[File:FreeCAD_Tree_view_suppressed.png]] Red backslash ===
This is only used for [[Sketch|sketches]] and indicates that the sketch is not fully constrained. Inside of [[Sketcher_Workbench|Sketcher]] the number of remaining degrees of freedom is shown in the solver messages.


{{Version|1.0}}
=== [[File:FreeCAD_Tree_view_error.png]] White exclamation mark on red background ===


This indicates a suppressed [[PartDesign_Workbench|PartDesign]] feature.
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.





Latest revision as of 10:23, 21 April 2024

Введение

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

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

Древо проекта, показывающее различные элементы документа

Работа с древом проекта

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

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

Самый верхний объект создается путем выполнения параметрических операций над объектами, которые сами были созданы предыдущими операциями. Разворачивание списка в древе на много уровней, раскрывает исходные элементы, которые были использованы для создания элементов твердых тел.

Tree view columns

By default the tree view only displays a single column with the labels and icons of objects. A second column with descriptions can optionally be displayed as well, column headings are then also added.

To enable the description column right click the tree view and in the context menu select:
Tree settings → Show description column introduced in version 0.21

Edit object label

Select an object in the first column and press F2 (on Windows and Linux), or Enter (on macOS), to edit its ДанныеLabel property. This property can also be edited via the context menu option Rename or in the Property editor.

Edit object description

An object can optionally have a description. This information is stored in its ДанныеLabel2 property. If the description column is displayed you can edit this property by selecting an object in that column and pressing F2 (on Windows and Linux), or Enter (on macOS). The property can also be changed in the Property editor.

Context menu

The options in the context menu of the tree view depend on the selected object(s) and the currently active workbench. To display this menu right-click the background of the list, right-click an object in the list, or select multiple objects in the list and then right-click one of them.

Действия с клавиатуры

The following keyboard shortcuts are available when the focus is on the tree view:

  • Ctrl+F: opens a search box at the bottom of the tree, allowing to search and reach objects using their names or labels.
  • Expand and collapse actions using Alt+Arrow combinations: introduced in version 0.20
    • Alt+Left: collapses selected item(s).
    • Alt+Right: expands selected item(s).
    • Alt+Up: expands selected item(s) with all their tier-1 children collapsed (deeper children remain unchanged).
    • Alt+Down: expands selected item(s) with all their tier-1 children expanded as well (deeper children remain unchanged).

Накладные иконки

Одна или несколько небольших накладных иконок могут отображаться поверх иконки по умолчанию на объекте в древе проекта. Доступные накладные иконки и их значение перечислены ниже. introduced in version 0.19

Белая галочка на синем фоне

Это означает, что объект должен быть пересчитан из-за изменений, внесенных в модель, или из-за того, что пользователь пометил объект в контекстном меню древа проекта для пересчёта. В большинстве случаев пересчёт запускается автоматически, но иногда он задерживается по причинам производительности.

Белый восклицательный знак на красном фоне

Это указывает на то, что объект имеет ошибку, которую необходимо исправить. После повторного вычисления всего документа при наведении курсора мыши на объект в древе проекта появляется всплывающая подсказка с описанием ошибки. Примечание: Все остальные объекты, зависящие от объекта в таком состоянии ошибки, не будут правильно пересчитаны, поэтому они всё ещё могут показывать какое-то устаревшее состояние.

Белая стрелка на зелёном фоне

Это указывает на, так называемый, Кончик тела. Обычно это последняя функция в PartDesign Тело и олицетворяет всё тело целиком в окружающем мире вне тела, например, когда тело экспортируется или используется в Булевых операциях. Кончик может быть изменён пользователем.

Фиолетовое звено цепи на белом фоне

Это обычно показано на sketches(эскизах), геометрических примитивах, таких как коробка, цилиндр и т.п. а также Datum(Данных). Это указывает на то, что объект ни к чему не привязан. Он не имеет Привязки от Смещения и получает свое положение и выравнивание исключительно из своего свойства Размещения.

Существует базовый учебник (англ) Basic Attachment Tutorial, объясняющий, как обращаться с такими объектами.

Жёлтый крестик

Это обозначение используется только для эскизов и указывает на то, что эскиз не полностью ограничен. В среде Sketcher количество оставшихся степеней свободы отображается в сообщениях решателя.

Eye symbol

This indicates that the object will be hidden in the Tree view if the Show items hidden in tree view context menu option is unchecked.

Cyan ice crystal

introduced in version 1.0

This indicates a frozen object that is not recomputed when its parents change.

Red backslash

introduced in version 1.0

This indicates a suppressed PartDesign feature.