Tree view/es: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 29: Line 29:


In the Labels & Attributes column the labels and icons of the objects are displayed.
In the Labels & Attributes column the labels and icons of the objects are displayed.

Selecting an object in this column and pressing {{KEY|F2}} (on Windows and Linux), or {{KEY|Enter}} (on macOS), allows to edit the object's {{PropertyData|Label}} property in situ without detour via the context menu action described below or the [[Property_editor|Property editor]].


=== Description ===
=== Description ===


The Description column displays further information about objects, if available. This information is stored in the {{PropertyData|Label2}} property.
The Description column displays further information about objects, if available.

This information is stored in an object's {{PropertyData|Label2}} property which can be edited in situ by selecting the object in this column and pressing {{KEY|F2}} (on Windows and Linux), or {{KEY|Enter}} (on macOS), or via the [[Property_editor|Property editor]].


<span id="Actions"></span>
<span id="Actions"></span>
== Acciones ==
== Acciones ==


Since the tree view lists objects that may be visible in the [[3D_view|3D view]], many of the actions are the same as those that can be executed from the [[3D_view|3D view]].
Since the tree view lists objects that may be visible in the [[3D_view|3D view]], many of the actions are the same as those that can be executed from the [[3D_view|3D view]]. The actions can be started from a {{MenuCommand|Context menu}} that can be accessed by right clicking either the background or an object.


===Application start===
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 one sub-menu with four commands:

* {{MenuCommand|Expression actions}}:
When the application starts, the default [[Start_Workbench|Start Workbench]] is active, and no document has been created, the context menu of the [[Tree_view|tree view]] has only one entry:
* {{MenuCommand|Expression actions}}. When the cursor is moved onto it, a sub-menu opens containing four commands:
** [[Std_Expressions|Copy selected]]
** [[Std_Expressions|Copy selected]]
** [[Std_Expressions|Copy active document]]
** [[Std_Expressions|Copy active document]]
Line 47: Line 53:
These allow working with various documents, but are disabled if no document is present.
These allow working with various documents, but are disabled if no document is present.


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

* {{MenuCommand|Expression actions}}:
Once a new document has been created right clicking the background opens the context menu now containing two entries:
* {{MenuCommand|Expression actions}} as above but with these two entries activated:
** [[Std_Expressions|Copy active document]]
** [[Std_Expressions|Copy active document]]
** [[Std_Expressions|Copy all documents]]
** [[Std_Expressions|Copy all documents]]
* {{MenuCommand|Link actions}} - a sub-menu with two entries:

** {{MenuCommand|Make Link group}} - another sub-menu containing three commands:
In addition, [[Std_LinkMake|Link]] actions are available.
* {{MenuCommand|Link actions}}:
** {{MenuCommand|Make Link group}}:
*** [[Std_LinkMakeGroup|Simple group]]
*** [[Std_LinkMakeGroup|Simple group]]
*** [[Std_LinkMakeGroup|Group with links]]
*** [[Std_LinkMakeGroup|Group with links]]
Line 63: Line 69:
=== Seleccionar el documento ===
=== Seleccionar el documento ===


If you select the active document and right click, in addition to {{MenuCommand|Expression actions}} and {{MenuCommand|Link actions}}, the following commands appear:
If you select the document and right click, in addition to {{MenuCommand|Expression actions}} and {{MenuCommand|Link actions}}, the context menu contains the following commands:
* {{MenuCommand|Show hidden items}}: if active, the tree view will show hidden items.
* {{MenuCommand|Show items hidden in tree view}}: if active, the tree view will show hidden items.
* {{MenuCommand|Search}}: shows an input field to search objects inside the selected document.
* {{MenuCommand|Search}}: shows an input field to search objects inside the selected document.
* {{MenuCommand|Close document}}: closes the selected document.
* {{MenuCommand|Close document}}: closes the selected document.
* {{MenuCommand|Add dependent objects to selection}}: all dependent objects will be added to the selection. This way one can see the dependencies and e.g. delete all dependent objects at once. Only available for objects with links and for documents.
* {{MenuCommand|Skip recomputes}}: if active, the document's objects will not [[Std_Refresh|recompute]] automatically.
* {{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|Allow partial recomputes}}: if active, the document will allow [[Std_Refresh|recompute]] of only some objects. Only available if {{MenuCommand|Skip recomputes}} is activated.
* {{MenuCommand|Mark to recompute}}: marks all objects of the document as touched, and ready for [[Std_Refresh|recompute]].
* {{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.
* {{MenuCommand|[[Std_Group|Create group]]}}: creates a [[Std_Group|group]] in the selected document.
Line 82: Line 89:
* {{MenuCommand|[[Std_Paste|Paste]]}}: pastes the copied object into the document; the copy is added to the end of the tree view.
* {{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.
* {{MenuCommand|[[Std_Delete|Delete]]}}: removes the object from the document.
* {{MenuCommand|[[#Eye_symbol|Hide item]]}}: If checked the object will be hidden in the Tree view.
* {{MenuCommand|[[#Eye_symbol|Toggle visibility in tree view]]}}: toggles the Tree view visibility of objects.
* {{MenuCommand|Add dependent objects to selection}}: all dependent objects will be added to the selection. This way one can see the dependencies and e.g. delete all dependent objects at once. This option is only available if one of the selected objects has links. {{Version|0.20}}
* {{MenuCommand|Mark to recompute}}: marks the selected object as touched, and ready for [[Std_Refresh|recompute]].
* {{MenuCommand|Mark to recompute}}: marks the selected object as touched, and ready for [[Std_Refresh|recompute]].
* {{MenuCommand|Recompute object}}: recomputes the selected object.
* {{MenuCommand|Recompute object}}: recomputes the selected object.
Line 146: Line 152:
=== [[File:FreeCAD_Tree_view_hidden.png]] Eye symbol ===
=== [[File:FreeCAD_Tree_view_hidden.png]] Eye symbol ===


This indicates that the object will be hidden in the Tree view because its {{MenuCommand|Hide item}} context menu option is checked. Check and then uncheck the {{MenuCommand|Show hidden items}} context menu option of the document, or reopen the document, to update the Tree view.
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.





Revision as of 16:16, 2 June 2023

Introducción

La vista árbol aparece en la pestaña Modelo de la vista combo, uno de los paneles más importantes de la interfaz; muestra todos los objetos definidos por el usuario que forman parte de un documento de FreeCAD. La vista árbol es una representación de la estructura del documento, e indica qué información se guarda en el disco.

Estos objetos no tienen que ser necesariamente formas geométricas visibles en la Vista 3D, sino que también pueden ser objetos de datos de apoyo creados con cualquiera de los Ambientes de trabajo.

La vista de árbol que muestra varios elementos del documento.

Trabajando con el vista arbol

By default, whenever a new object is created, it is added to the end of the list in the tree view. 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 context menu (right click) which depend on the currently selected object and 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.

Labels & Attributes

In the Labels & Attributes column the labels and icons of the objects are displayed.

Selecting an object in this column and pressing F2 (on Windows and Linux), or Enter (on macOS), allows to edit the object's DatosLabel property in situ without detour via the context menu action described below or the Property editor.

Description

The Description column displays further information about objects, if available.

This information is stored in an object's DatosLabel2 property which can be edited in situ by selecting the object in this column and pressing F2 (on Windows and Linux), or Enter (on macOS), or via the Property editor.

Acciones

Since the tree view lists objects that may be visible in the 3D view, many of the actions are the same as those that can be executed from the 3D view. The actions can be started from a Context menu that can be accessed by right clicking either the background or an object.

Application start

When the application starts, the default Start Workbench is active, and no document has been created, the context menu of the tree view has only one entry:

These allow working with various documents, but are disabled if no document is present.

New document

Once a new document has been created right clicking the background opens the context menu now containing two entries:

Seleccionar el documento

If you select the document and right click, in addition to Expression actions and Link actions, the context menu contains the following commands:

  • Show items hidden in tree view: if active, the tree view will show hidden items.
  • Search: shows an input field to search objects inside the selected document.
  • Close document: closes the selected document.
  • Add dependent objects to selection: all dependent objects will be added to the selection. This way one can see the dependencies and e.g. delete all dependent objects at once. Only available for objects with links and for documents.
  • Skip recomputes: if active, the document's objects will not recompute automatically.
  • Allow partial recomputes: if active, the document will allow recompute of only some objects. Only available if Skip recomputes is activated.
  • Mark to recompute: marks all objects of the document as touched, and ready for recompute.
  • Create group: creates a group in the selected document.

Seleccionar de objetos

Once objects are added to the document right clicking them will show additional commands. These depend on the number of selected objects, their type and also on the active workbench. In most cases and with most workbenches (except the Start Workbench) the following commands are then available:

  • Appearance: launches a dialog to change the visual properties of the whole object.
  • Random color: assigns a random color to the object.
  • Cut: disabled.
  • Copy: copies an object into memory.
  • Paste: pastes the copied object into the document; the copy is added to the end of the tree view.
  • Delete: removes the object from the document.
  • Toggle visibility in tree view: toggles the Tree view visibility of objects.
  • Mark to recompute: marks the selected object as touched, and ready for recompute.
  • Recompute object: recomputes the selected object.
  • Rename: starts editing the label of the selected object, not the name which is read-only. This option is only available if a single object is selected.

As an example of context menu extension, if a Part Box is right clicked while the Part Workbench is active the following additional commands are available:

Keyboard actions

The following keyboard actions 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).

Iconos superpuestos

Se pueden mostrar uno o varios iconos superpuestos más pequeños sobre el icono por defecto de un objeto en la vista de árbol. Los iconos superpuestos disponibles y su significado se enumeran a continuación. introducido en la versión 0.19

Marca de verificación blanca sobre fondo azul

Esto indica que el objeto tiene que ser recalculado, debido a los cambios realizados en el modelo o porque el usuario marcó el objeto en el menú contextual de la vista de árbol para ser recalculado. En la mayoría de los casos los recálculos se activan automáticamente, pero a veces se retrasan por razones de rendimiento.

Flecha blanca sobre fondo verde

Indica la llamada Punta de un cuerpo. Suele ser la última característica de un DiseñoPieza Cuerpo y representa todo el cuerpo para el mundo exterior al cuerpo, por ejemplo, cuando el cuerpo se exporta o se utiliza en operaciones Pieza booleano. La punta puede ser cambiada por el usuario.

Cadena de eslabones púrpura sobre fondo blanco

Se muestra normalmente para bocetos, primitivas geométricas, como caja, cilindro, etc. y geometría Referencia. Indica que el objeto no está unido a nada. No tiene desplazamiento de fijación y obtiene su posición y alineación únicamente de su propiedad Colocación.

Hay un Tutorial Básico de Adjuntos que explica cómo manejar tales objetos.

Amarillo X

Esto sólo se utiliza para bocetos e indica que el sketch no está completamente restringido. Dentro de Croquizador el número de grados de libertad restantes se muestra en los mensajes del solucionador.

Signo de exclamación blanco sobre fondo rojo

Esto indica que el objeto tiene un error que debe ser corregido. Después de volver a calcular todo el documento, se muestra un punto herramienta que describe el error cuando se pasa el ratón por encima del objeto en la vista de árbol. Nota: Todos los demás objetos que dependan de un objeto en ese estado de error no se volverán a calcular correctamente, por lo que pueden seguir mostrando algún estado antiguo.

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.