Tree view/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(147 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


== Introduction ==
== Introduction ==


<div class="mw-translate-fuzzy">
The [[tree view|tree view]] appears in the {{MenuCommand|Model}} tab of the [[combo view|combo view]]; it shows all user defined objects that are part of a FreeCAD document. The tree view is a representation of the [[document structure|document's structure]], and indicates what information is saved to disk.
La [[Tree_view/fr|vue en arborescence]] apparaît dans l'onglet {{MenuCommand|Modèle}} de la [[Combo_view/fr|vue combinée]], l'un des panneaux les plus importants de l'[[Interface/fr|interface]]. Elle montre tous les objets définis par l'utilisateur qui font partie d'un document FreeCAD. L'arborescence est une représentation de la [[Document_structure/fr|structure d'un document]] et indique quelles informations sont enregistrées sur le disque.
</div>


Ces objets ne doivent pas nécessairement être des formes géométriques visibles dans la [[3D_view/fr|Vue 3D]] mais peuvent également prendre en charge des objets de données créés avec l'un des [[Workbenches/fr|ateliers]].
These objects don't necessarily have to be geometrical shapes visible in the [[3D view|3D view]], but can also be supporting data objects created with any of the [[workbenches|workbenches]].


[[File:FreeCAD_Tree_view.png]]
[[File:FreeCAD_Tree_view.png]]


{{Caption|The tree view showing various elements in the document.}}
{{Caption|La vue en arborescence montrant divers éléments du document.}}


<span id="Working_with_the_tree_view"></span>
== Working with the tree view ==
== Travailler avec la vue en arborescence ==


<div class="mw-translate-fuzzy">
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 which also depends on the currently active workbench.
Par défaut, chaque fois qu'un nouvel objet est créé, il est ajouté à la fin de la liste dans l'arborescence. L'arborescence permet de gérer les objets pour les garder organisés. Elle permet de créer des [[Std_Group/fr|groupes]], de déplacer des objets à l'intérieur de groupes, de déplacer des groupes à l'intérieur d'autres groupes, de réétiqueter des objets, de copier des objets, de supprimer des objets et d'autres opérations dans le menu contextuel (clic droit) qui dépendent de l'objet actuellement sélectionné et du plan de travail actuellement actif.
</div>


De nombreuses opérations créent des objets qui dépendent d'un objet déjà existant. Dans ce cas, l'arborescence montre cette relation en absorbant l'objet plus ancien à l'intérieur du nouvel objet. Le développement et la réduction des objets dans l'arborescence montrent l'historique paramétrique de cet objet. Les objets qui sont plus profondément à l'intérieur des autres sont plus anciens, tandis que les objets qui sont à l'extérieur sont plus récents et sont dérivés des objets plus anciens. En modifiant les objets intérieurs, les opérations paramétriques se propagent jusqu'au sommet, générant un nouveau résultat.
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|L'objet au sommet est créé en effectuant des opérations paramétriques sur des objets qui ont eux-mêmes été créés par des opérations précédentes.<br>
[[File:FreeCAD_Tree_view_parametric_history_3.png|x304px]]
L'expansion complète de l'arboresence révèle les éléments d'origine qui ont été utilisés pour créer les solides partiels.}}


<span id="Tree_view_columns"></span>
{{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.}}
=== Colonnes de la vue en arborescence ===


Par défaut, la vue en arborescence n'affiche qu'une seule colonne avec les étiquettes et les icônes des objets. Une deuxième colonne avec des descriptions peut être affichée en option, et des en-têtes de colonne sont également ajoutés.
== Actions ==


Pour activer la colonne de description, cliquez avec le bouton droit de la souris sur la vue en arborescence et sélectionnez dans le menu contextuel :<br>
{{Emphasis|Note:}} expressions and link actions were added in version 0.19.
{{MenuCommand|Paramètres de la vue en arborescence → Afficher la colonne de description}} {{Version/fr|0.21}}


<span id="Edit_object_label"></span>
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]].
=== Modifier l'étiquette de l'objet ===


<div class="mw-translate-fuzzy">
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:
Sélectionnez un objet dans la première colonne et appuyez sur {{KEY|F2}} (sous Windows et Linux) ou {{KEY|Entrée}} (sous macOS) pour modifier sa propriété {{PropertyData|Label}}. Cette propriété peut également être modifiée via l'action du menu contextuel décrite ci-dessous ou dans l'[[Property_editor/fr|éditeur de propriétés]].
* {{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.
</div>


<span id="Edit_object_description"></span>
Once a new document has been created the following become active:
=== Modifier la description de l'objet ===
* {{MenuCommand|Expression actions}}: [[Std_Expressions|Copy active document]], [[Std_Expressions|Copy all documents]].


Un objet peut éventuellement être accompagné d'une description. Cette information est enregistrée dans sa propriété {{PropertyData|Label2}}. Si la colonne de description est affichée, vous pouvez modifier cette propriété en sélectionnant un objet dans cette colonne et en appuyant sur {{KEY|F2}} (sous Windows et Linux) ou {{KEY|Entrée}} (sous macOS). La propriété peut également être modifiée dans l'[[Property_editor/fr|éditeur de propriétés]].
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]].


=== Selecting the document ===
=== 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 [[recompute|recompute]] automatically.
** {{MenuCommand|Allow partial recomputes}}: if active, the document will allow [[recompute|recompute]] of only some objects.
* {{MenuCommand|Mark to recompute}}: marks all objects of the document as touched, and ready for [[recompute|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="Keyboard_shortcuts"></span>
=== Selecting objects ===
<div class="mw-translate-fuzzy">
=== Actions du clavier ===
</div>


<div class="mw-translate-fuzzy">
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.
Les actions clavier suivantes sont disponibles lorsque le curseur est sur la vue en arborescence :
* {{KEY|Ctrl}}+{{KEY|F}} : ouvre une boîte de recherche au bas de l'arbre, permettant de rechercher et d'atteindre des objets en utilisant leurs noms ou leurs étiquettes.
* Actions d'expansion et de réduction à l'aide des combinaisons {{KEY|Alt}}+{{KEY|Flèche}} : {{Version/fr|0.20}}
** {{KEY|Alt}}+{{KEY|Flèche gauche}} : réduit le(s) élément(s) sélectionné(s).
** {{KEY|Alt}}+{{KEY|Flèche droit}} : développe le(s) élément(s) sélectionné(s).
** {{KEY|Alt}}+{{KEY|Flèche haut}} : développe le ou les éléments sélectionnés avec tous leurs enfants de niveau 1 réduits (les enfants plus profonds restent inchangés).
** {{KEY|Alt}}+{{KEY|Flèche bas}} : développe le ou les éléments sélectionnés avec tous leurs enfants de niveau 1 également développés (les enfants plus profonds restent inchangés).
</div>


<span id="Overlay_icons"></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:
== Icônes de superposition ==
* {{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]].


<div class="mw-translate-fuzzy">
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:
Une ou plusieurs petites icônes de superposition peuvent être affichées au-dessus de l'icône par défaut d'un objet dans l'arborescence. Les icônes superposées disponibles et leur signification sont énumérées ci-dessous.
* {{MenuCommand|Transform}}: launches the transform widget to move or rotate the object.
</div>
* {{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 [[recompute|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_recompute.png_White_check_mark_on_blue_background"></span>
{{Interface}}
=== [[File:FreeCAD_Tree_view_recompute.png]] Marque blanche sur fond bleu ===
{{Userdocnavi}}

Cela indique que l'objet doit être [[Std_Refresh/fr|recalculé]] en raison de modifications apportées au modèle ou parce que l'utilisateur a marqué l'objet dans le menu contextuel de la vue arborescente pour qu'il soit recalculé. Dans la plupart des cas, les recalculs sont déclenchés automatiquement, mais ils sont parfois retardés pour des raisons de performance.

<span id="File:FreeCAD_Tree_view_error.png_White_exclamation_mark_on_red_background"></span>
=== [[File:FreeCAD_Tree_view_error.png]] Point d'exclamation blanc sur fond rouge ===

Cela indique que l'objet présente une erreur qui doit être corrigée. Après avoir recalculé l'ensemble du document, une info-bulle décrivant l'erreur est affichée lorsque vous passez la souris sur l'objet dans l'arborescence. Remarque: tous les autres objets dépendant d'un objet dans un tel état d'erreur ne seront pas correctement recalculés, ils peuvent donc encore présenter un ancien état.

<span id="File:FreeCAD_Tree_view_tip.png_White_arrow_on_green_background"></span>
=== [[File:FreeCAD_Tree_view_tip.png]] Flèche blanche sur fond vert ===

Ceci indique ce qu'on appelle le [[PartDesign_Body/fr#Tip_.28fonction_r.C3.A9sultante.29|Tip]] d'un corps. C'est généralement la dernière fonction d'un [[PartDesign_Body/fr|PartDesign Corps]] et représente le corps entier pour le monde extérieur au corps, par exemple lorsque le corps est exporté ou utilisé dans des [[Part_Boolean/fr|Part opérations booléennes]]. Le Tip peut être modifié par l'utilisateur.

<span id="File:FreeCAD_Tree_view_unattached.png_Purple_chain_link"></span>
<div class="mw-translate-fuzzy">
=== [[File:FreeCAD_Tree_view_unattached.png]] Maillon de chaîne violet sur fond blanc ===
</div>

Cela est généralement indiqué pour les [[Sketch/fr|esquisses]], les primitives géométriques, telles que la boîte, le cylindre, etc. et un [[Datum/fr|Datum]] géométrique. Elle indique que l'objet n'est pas attaché à quelque chose. Il n'a pas de décalage d'ancrage et obtient sa position et son alignement uniquement à partir de sa propriété [[Placement/fr|Placement]].

Il existe un [[Basic_Attachment_Tutorial/fr|Tutoriel Les bases pour l'ancrage]] expliquant comment gérer ces objets.

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

<div class="mw-translate-fuzzy">
Ceci n'est utilisé que pour des [[Sketch/fr|esquisses]] et indique que l'esquisse n'est pas entièrement contrainte. Dans l'[[Sketcher_Workbench/fr|atelier Sketcher]], le nombre de degrés de liberté restants est indiqué dans les messages du solveur.
</div>

<span id="File:FreeCAD_Tree_view_hidden.png_Eye_symbol"></span>
=== [[File:FreeCAD_Tree_view_hidden.png]] Symbole de l'oeil ===

Ceci indique que l'objet sera caché dans la vue en arborescence si l'option du menu contextuel {{MenuCommand|Afficher les éléments masqués dans la vue en arborescence}} n'est pas cochée.

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


{{Interface navi{{#translation:}}}}
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Revision as of 10:23, 21 April 2024

Introduction

La vue en arborescence apparaît dans l'onglet Modèle de la vue combinée, l'un des panneaux les plus importants de l'interface. Elle montre tous les objets définis par l'utilisateur qui font partie d'un document FreeCAD. L'arborescence est une représentation de la structure d'un document et indique quelles informations sont enregistrées sur le disque.

Ces objets ne doivent pas nécessairement être des formes géométriques visibles dans la Vue 3D mais peuvent également prendre en charge des objets de données créés avec l'un des ateliers.

La vue en arborescence montrant divers éléments du document.

Travailler avec la vue en arborescence

Par défaut, chaque fois qu'un nouvel objet est créé, il est ajouté à la fin de la liste dans l'arborescence. L'arborescence permet de gérer les objets pour les garder organisés. Elle permet de créer des groupes, de déplacer des objets à l'intérieur de groupes, de déplacer des groupes à l'intérieur d'autres groupes, de réétiqueter des objets, de copier des objets, de supprimer des objets et d'autres opérations dans le menu contextuel (clic droit) qui dépendent de l'objet actuellement sélectionné et du plan de travail actuellement actif.

De nombreuses opérations créent des objets qui dépendent d'un objet déjà existant. Dans ce cas, l'arborescence montre cette relation en absorbant l'objet plus ancien à l'intérieur du nouvel objet. Le développement et la réduction des objets dans l'arborescence montrent l'historique paramétrique de cet objet. Les objets qui sont plus profondément à l'intérieur des autres sont plus anciens, tandis que les objets qui sont à l'extérieur sont plus récents et sont dérivés des objets plus anciens. En modifiant les objets intérieurs, les opérations paramétriques se propagent jusqu'au sommet, générant un nouveau résultat.

L'objet au sommet est créé en effectuant des opérations paramétriques sur des objets qui ont eux-mêmes été créés par des opérations précédentes.
L'expansion complète de l'arboresence révèle les éléments d'origine qui ont été utilisés pour créer les solides partiels.

Colonnes de la vue en arborescence

Par défaut, la vue en arborescence n'affiche qu'une seule colonne avec les étiquettes et les icônes des objets. Une deuxième colonne avec des descriptions peut être affichée en option, et des en-têtes de colonne sont également ajoutés.

Pour activer la colonne de description, cliquez avec le bouton droit de la souris sur la vue en arborescence et sélectionnez dans le menu contextuel :
Paramètres de la vue en arborescence → Afficher la colonne de description introduit dans la version 0.21

Modifier l'étiquette de l'objet

Sélectionnez un objet dans la première colonne et appuyez sur F2 (sous Windows et Linux) ou Entrée (sous macOS) pour modifier sa propriété DonnéesLabel. Cette propriété peut également être modifiée via l'action du menu contextuel décrite ci-dessous ou dans l'éditeur de propriétés.

Modifier la description de l'objet

Un objet peut éventuellement être accompagné d'une description. Cette information est enregistrée dans sa propriété DonnéesLabel2. Si la colonne de description est affichée, vous pouvez modifier cette propriété en sélectionnant un objet dans cette colonne et en appuyant sur F2 (sous Windows et Linux) ou Entrée (sous macOS). La propriété peut également être modifiée dans l'éditeur de propriétés.

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.

Actions du clavier

Les actions clavier suivantes sont disponibles lorsque le curseur est sur la vue en arborescence :

  • Ctrl+F : ouvre une boîte de recherche au bas de l'arbre, permettant de rechercher et d'atteindre des objets en utilisant leurs noms ou leurs étiquettes.
  • Actions d'expansion et de réduction à l'aide des combinaisons Alt+Flèche : introduit dans la version 0.20
    • Alt+Flèche gauche : réduit le(s) élément(s) sélectionné(s).
    • Alt+Flèche droit : développe le(s) élément(s) sélectionné(s).
    • Alt+Flèche haut : développe le ou les éléments sélectionnés avec tous leurs enfants de niveau 1 réduits (les enfants plus profonds restent inchangés).
    • Alt+Flèche bas : développe le ou les éléments sélectionnés avec tous leurs enfants de niveau 1 également développés (les enfants plus profonds restent inchangés).

Icônes de superposition

Une ou plusieurs petites icônes de superposition peuvent être affichées au-dessus de l'icône par défaut d'un objet dans l'arborescence. Les icônes superposées disponibles et leur signification sont énumérées ci-dessous.

Marque blanche sur fond bleu

Cela indique que l'objet doit être recalculé en raison de modifications apportées au modèle ou parce que l'utilisateur a marqué l'objet dans le menu contextuel de la vue arborescente pour qu'il soit recalculé. Dans la plupart des cas, les recalculs sont déclenchés automatiquement, mais ils sont parfois retardés pour des raisons de performance.

Point d'exclamation blanc sur fond rouge

Cela indique que l'objet présente une erreur qui doit être corrigée. Après avoir recalculé l'ensemble du document, une info-bulle décrivant l'erreur est affichée lorsque vous passez la souris sur l'objet dans l'arborescence. Remarque: tous les autres objets dépendant d'un objet dans un tel état d'erreur ne seront pas correctement recalculés, ils peuvent donc encore présenter un ancien état.

Flèche blanche sur fond vert

Ceci indique ce qu'on appelle le Tip d'un corps. C'est généralement la dernière fonction d'un PartDesign Corps et représente le corps entier pour le monde extérieur au corps, par exemple lorsque le corps est exporté ou utilisé dans des Part opérations booléennes. Le Tip peut être modifié par l'utilisateur.

Maillon de chaîne violet sur fond blanc

Cela est généralement indiqué pour les esquisses, les primitives géométriques, telles que la boîte, le cylindre, etc. et un Datum géométrique. Elle indique que l'objet n'est pas attaché à quelque chose. Il n'a pas de décalage d'ancrage et obtient sa position et son alignement uniquement à partir de sa propriété Placement.

Il existe un Tutoriel Les bases pour l'ancrage expliquant comment gérer ces objets.

X jaune

Ceci n'est utilisé que pour des esquisses et indique que l'esquisse n'est pas entièrement contrainte. Dans l'atelier Sketcher, le nombre de degrés de liberté restants est indiqué dans les messages du solveur.

Symbole de l'oeil

Ceci indique que l'objet sera caché dans la vue en arborescence si l'option du menu contextuel Afficher les éléments masqués dans la vue en arborescence n'est pas cochée.

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.