Tree view/es: Difference between revisions

From FreeCAD Documentation
(Created page with "Hay un Tutorial Básico de Adjuntos que explica cómo manejar tales objetos.")
(Updating to match new version of source page)
 
(17 intermediate revisions by 3 users not shown)
Line 2: Line 2:
{{TOCright}}
{{TOCright}}


<span id="Introduction"></span>
== Introducción ==
== Introducción ==


<div class="mw-translate-fuzzy">
La [[Tree_view/es|vista árbol]] aparece en la pestaña {{MenuCommand|Modelo}} de la [[Combo_view/es|vista combo]], uno de los paneles más importantes de la [[Interface/es|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 [[document structure/es|estructura del documento]], e indica qué información se guarda en el disco.
La [[Tree_view/es|vista de árbol]] aparece en la pestaña {{MenuCommand|Modelo}} de la [[Combo_view/es|vista combo]], uno de los paneles más importantes de la [[Interface/es|interfaz]]; muestra todos los objetos definidos por el usuario que forman parte de un documento de FreeCAD. La vista de árbol es una representación de la [[document structure/es|estructura del documento]], e indica qué información se guarda en el disco.
</div>


Estos objetos no tienen que ser necesariamente formas geométricas visibles en la [[3D_view/es|Vista 3D]], sino que también pueden ser objetos de datos de apoyo creados con cualquiera de los [[Workbenches/es|Ambientes de trabajo]].
Estos objetos no tienen que ser necesariamente formas geométricas visibles en la [[3D_view/es|Vista 3D]], sino que también pueden ser objetos de datos de apoyo creados con cualquiera de los [[Workbenches/es|Ambientes de trabajo]].
Line 12: Line 15:
{{Caption|La vista de árbol que muestra varios elementos del documento.}}
{{Caption|La vista de árbol que muestra varios elementos del documento.}}


<span id="Working_with_the_tree_view"></span>
== Trabajando con el vista arbol ==
== Trabajando con la vista de árbol ==


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 [[Std_Group|groups]], moving objects inside groups, moving groups inside other groups, renaming objects, copying objects, deleting objects, and other operations in the contextual menu (right click) which depend on the currently selected object and the currently active workbench.
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 [[Std_Group|groups]], moving objects inside groups, moving groups inside other groups, relabeling objects, copying objects, deleting objects, and using options from its [[#Context_menu|context menu]].


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


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


{{Caption|The topmost object is created by doing parametric operations on objects which themselves were created by previous operations.<br>
[[File:FreeCAD_Tree_view_parametric_history_3.png|x304px]]
Fully expanding the tree reveals the original elements that were used to create the partial solids.}}


=== Tree view columns ===
{{Caption|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.}}


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.
== Acciones ==


To enable the description column right click the tree view and in the context menu select:<br>
{{Emphasis|Note:}} expressions and link actions were added in version 0.19.
{{MenuCommand|Tree settings → Show description column}} {{Version|0.21}}


=== Edit object label ===
Since the tree view lists objects that may be visible in the [[3D_view|3D view]], many of the actions are the same to those that can be executed from the [[3D_view|3D view]].


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]].
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:
* {{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.


=== Edit object description ===
Once a new document has been created the following become active:
* {{MenuCommand|Expression actions}}: [[Std_Expressions|Copy active document]], [[Std_Expressions|Copy all documents]].


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]].
In addition, [[Std_LinkMake|Link]] actions are available.
* {{MenuCommand|Link actions}}: [[Std_LinkMake|Make Link]].
** {{MenuCommand|Make Link group}}: [[Std_LinkMakeGroup|Simple group]], [[Std_LinkMakeGroup|Group with links]], [[Std_LinkMakeGroup|Group with transform links]].


=== Seleccionar el documento ===
=== 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.
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.


=== Seleccionar de objetos ===
=== Keyboard shortcuts ===


The following keyboard shortcuts are available when the focus is on the tree view:
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.
* {{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.

* Expand and collapse actions using {{KEY|Alt}}+{{KEY|Arrow}} combinations: {{Version|0.20}}
For example, with the [[Draft_Workbench|Draft Workbench]] active, first select an object, then right click on an empty place in the tree view:
** {{KEY|Alt}}+{{KEY|Left}}: collapses selected item(s).
* {{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.
** {{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).
* {{MenuCommand|[[Std_HideSelection|Hide selection]]}}: makes the selected objects invisible.
** {{KEY|Alt}}+{{KEY|Down}}: expands selected item(s) with all their tier-1 children expanded as well (deeper children remain unchanged).
* {{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]].

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="Overlay_icons"></span>
== Iconos superpuestos ==
== Iconos superpuestos ==


<div class="mw-translate-fuzzy">
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. {{Version/es|0.19}}
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. {{Version/es|0.19}}
</div>


<span id="File:FreeCAD_Tree_view_recompute.png_White_check_mark_on_blue_background"></span>
=== [[File:FreeCAD_Tree_view_recompute.png]] Marca de verificación blanca sobre fondo azul ===
=== [[File:FreeCAD_Tree_view_recompute.png]] Marca de verificación blanca sobre fondo azul ===


Esto indica que el objeto tiene que ser [[Std_Refresh/es|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.
Esto indica que el objeto tiene que ser [[Std_Refresh/es|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.


<span id="File:FreeCAD_Tree_view_error.png_White_exclamation_mark_on_red_background"></span>
=== [[File:FreeCAD_Tree_view_error.png]] 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.

<span id="File:FreeCAD_Tree_view_tip.png_White_arrow_on_green_background"></span>
=== [[File:FreeCAD_Tree_view_tip.png]] Flecha blanca sobre fondo verde ===
=== [[File:FreeCAD_Tree_view_tip.png]] Flecha blanca sobre fondo verde ===


Indica la llamada [[PartDesign_Body/es#punta|Punta]] de un cuerpo. Suele ser la última característica de un [[PartDesign_Body/es|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 [[Part_Boolean/es|Pieza booleano]]. La punta puede ser cambiada por el usuario.
Indica la llamada [[PartDesign_Body/es#punta|Punta]] de un cuerpo. Suele ser la última característica de un [[PartDesign_Body/es|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 [[Part_Boolean/es|Pieza booleano]]. La punta puede ser cambiada por el usuario.


<span id="File:FreeCAD_Tree_view_unattached.png_Purple_chain_link"></span>
<div class="mw-translate-fuzzy">
=== [[File:FreeCAD_Tree_view_unattached.png]] Cadena de eslabones púrpura sobre fondo blanco ===
=== [[File:FreeCAD_Tree_view_unattached.png]] Cadena de eslabones púrpura sobre fondo blanco ===
</div>


Se muestra normalmente para [[Sketch/es|bocetos]], primitivas geométricas, como caja, cilindro, etc. y geometría [[Datum/es|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 [[Placement/es|Colocación]].
Se muestra normalmente para [[Sketch/es|bocetos]], primitivas geométricas, como caja, cilindro, etc. y geometría [[Datum/es|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 [[Placement/es|Colocación]].
Line 96: Line 87:
Hay un [[Basic_Attachment_Tutorial/es|Tutorial Básico de Adjuntos]] que explica cómo manejar tales objetos.
Hay un [[Basic_Attachment_Tutorial/es|Tutorial Básico de Adjuntos]] que explica cómo manejar tales objetos.


<span id="File:FreeCAD_Tree_view_notfullyconstrained.png_Yellow_X"></span>
=== [[File:FreeCAD_Tree_view_notfullyconstrained.png]] Amarillo X ===
=== [[File:FreeCAD_Tree_view_notfullyconstrained.png]] Amarillo X ===


<div class="mw-translate-fuzzy">
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.
Esto sólo se utiliza para [[Sketch/es|bocetos]] e indica que el sketch no está completamente restringido. Dentro de [[Sketcher_Workbench/es|Croquizador]] el número de grados de libertad restantes se muestra en los mensajes del solucionador.
</div>


=== [[File:FreeCAD_Tree_view_error.png]] Signo de exclamación blanco sobre fondo rojo ===
=== [[File:FreeCAD_Tree_view_hidden.png]] Eye symbol ===

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_frozen.png]] Cyan ice crystal ===

{{Version|1.0}}

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

=== [[File:FreeCAD_Tree_view_suppressed.png]] Red backslash ===

{{Version|1.0}}


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

Introducción

La vista de á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 de á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 la vista de árbol

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, relabeling objects, copying objects, deleting objects, and using options from its context menu.

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.
Fully expanding the tree reveals the original elements that were used to create the partial solids.

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 DatosLabel 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 DatosLabel2 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.

Keyboard shortcuts

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).

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.

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.

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.

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.