Selection methods/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Les Méthodes de sélection dans FreeCAD permettent de choisir des objets dans l'Interface de FreeCAD tels que la 3D_view/fr|vue 3D...")
No edit summary
 
(64 intermediate revisions by 3 users not shown)
Line 2: Line 2:


{{Docnav/fr
{{Docnav/fr
|[[Mouse_Model/fr|Navigation par la souris]]
|[[Mouse_navigation/fr|Navigation par la souris]]
|[[Preferences_Editor/fr|Réglage des préférences]]
|[[Navigation_Cube/fr|Cube de navigation]]
}}
}}


{{TOCright}}

<span id="Overview"></span>
== Présentation ==
== Présentation ==


Les [[Selection_methods/fr|Méthodes de sélection]] dans FreeCAD permettent de choisir des objets dans l'[[Interface/fr|Interface de FreeCAD]] tels que la [[3D_view/fr|vue 3D]], la [[Tree_view/fr|vue en arborescence]], la [[Selection_view/fr|Fenêtre de sélection]] et d'autres boîtes de dialogue. Certaines méthodes de sélection sont spécifiques à l'atelier et sont documentées dans la documentation particulière de l'atelier.
Les [[Selection_methods/fr|Méthodes de sélection]] dans FreeCAD permettent de choisir des objets dans l'[[Interface/fr|interface de FreeCAD]] tels que la [[3D_view/fr|vue 3D]], la [[Tree_view/fr|vue en arborescence]], la [[Selection_view/fr|fenêtre de sélection]] et d'autres boîtes de dialogue. Certaines méthodes de sélection sont spécifiques à l'atelier et sont documentées dans la documentation particulière de l'atelier.


<span id="3D_view"></span>
{{TOCright}}
== 3D view ==
==Vue 3D==


In the [[3D_view|3D view]] there are various ways of selecting objects using the mouse pointer.
Dans la [[3D_view/fr|Vue 3D]], il existe plusieurs façons de sélectionner des objets.


<span id="Simple_selection"></span>
===Simple selection===
=== Sélection simple ===


La sélection simple avec la souris (par défaut clic gauche) et la présélection (survol) sont décrites dans la page [[Mouse_navigation/fr|Navigation par la souris]].
Simple selection with the mouse (by default left-click) and pre-selection (hover) are described in the [[Mouse_Model|mouse navigation]] page.


<span id="Repeated_clicks"></span>
===Repeated clicks===
=== Clics répétés ===


Le premier clic sélectionne un sous-élément (sommet, arête ou face) de l'objet sous la souris. Un deuxième clic sélectionne tout l'objet.
The first click selects a sub-element (vertex, edge or face) of the object under the mouse. A second click selects the whole object. {{Version|0.18}}


The third click extends the selection to its container object ([[PartDesign_Body|PartDesign Body]], [[Std_Part|Std Part]], and others). Further clicks expand the selection up the container chain. {{Version|0.19}}
Le troisième clic étend la sélection à son objet conteneur ([[PartDesign_Body/fr|PartDesign Corps]], [[Std_Part/fr|Std Part]] et autres). Des clics supplémentaires développent la sélection dans la chaîne de conteneurs.


<span id="Selection_commands"></span>
===Selection commands===
=== Commandes par sélection ===


* Pour sélectionner tous les objets : [[Std_SelectAll/fr|Std Tout sélectionner]].
Mouse drag selection to select multiple objects or sub-elements (vertices or faces) is available using [[Std_SelectAll|Std SelectAll]], [[Std_BoxSelection|Std BoxSelection]], [[Part_BoxSelection|Part BoxSelection]], and [[Std_BoxElementSelection|Std BoxElementSelection]].
* Pour sélectionner par une boîte plusieurs objets principaux : [[Std_BoxSelection/fr|Std Sélection par boîte]].
* Pour sélectionner plusieurs faces par une boîte : [[Std_BoxElementSelection/fr|Std Sélection d'éléments par boîte]] ou [[Part_BoxSelection/fr|Part Sélection par boîte]].


<span id="Selection_view"></span>
The Box selection modes revert to the default [[Std_SelectAll|Std SelectAll]], after any selection. (What does this mean??)
==Fenêtre de sélection==


La [[Selection_view/fr|fenêtre de sélection]] affiche les noms des objets sélectionnés y compris leur nom complet dans un objet, par exemple {{incode|Unnamed#Body.Box001.Face17}}.
==Selection view==


Elle permet également d'effectuer certaines actions comme [[Std_ViewFitSelection/fr|Std Affichage de la sélection]] et d'envoyer l'objet à la [[Python_console/fr|Console Python]].
The [[Selection_view|selection view]] shows the names of the objects being selected, including their full name within an object, for example, {{incode|Unnamed#Body.Box001.Face17}}.


<span id="Object_export"></span>
It also allows to perform some actions like [[Std_ViewFitSelection|Std ViewFitSelection]], and sending the object to the [[Python_console|Python console]].
===Exportation d'objets===


''Cela devrait être dans la page [[Selection_view/fr|Fenêtre de sélection]].''
===Object export===


Sélectionnez un objet complexe, par exemple un [[PartDesign_Body/fr|PartDesign Corps]] ou [[Std_Part/fr|Std Part]], puis dans la [[Selection_view/fr|fenêtre de sélection]] sélectionnez à nouveau l'objet puis appuyez sur {{KEY|Ctrl}} + {{KEY|C}} au clavier pour ouvrir la boîte de dialogue {{MenuCommand|Sélection des objets}}. Cela permet de copier l'objet sélectionné avec tous ou seulement certains des objets de dépendance de cet objet. Par exemple, pour un [[Std_Part/fr|Std Part]], les objets possibles à sélectionner incluent [[Std_Part/fr|Std Part]] lui-même, mais aussi son origine, ses trois axes de base (XYZ) et ses trois plans de base (XY, YZ, XZ).
''This should be in the [[selection view]] page.''


Après avoir appuyé sur {{Button|OK}}, les objets sélectionnés sont copiés en mémoire puis peuvent être collés dans le document pour dupliquer uniquement ces objets.
Select any complex object, for example, a [[PartDesign_Body|PartDesign Body]] or [[Std_Part|Std Part]], then in the [[selection_view|selection view]] select again the object, and then press {{KEY|Ctrl}} + {{KEY|C}} in the keyboard to open the {{MenuCommand|Object selection}} dialog. This allows copying the selected object together with all or only some of that object's dependency objects. For example, for a [[Std_Part|Std Part]] the possible objects to select include the [[Std_Part|Std Part]] itself, but also its Origin, its three base axes (XYZ), and its three base planes (XY, YZ, XZ).

After pressing {{Button|OK}}, the selected objects are copied into memory, and then can be pasted in the document to duplicate these objects only.


[[File:ObjectSelection.png]]
[[File:ObjectSelection.png]]


{{Caption|Object selection dialog that is launched from the [[Selection_view|selection view]].}}
{{Caption|Boîte de dialogue de sélection d'objet lancée depuis la [[Selection_view/fr|fenêtre de sélection]].}}


<span id="Tree_view"></span>
==Tree view==
==Vue en arborescence==


Dans la [[Tree_view/fr|Vue en arborescence]], les éléments peuvent être sélectionnés ou désélectionnés, un par un, en maintenant la touche {{KEY|Ctrl}} et en cliquant avec la souris.
In the [[tree_view|tree view]] items can be selected, or deselected, one at a time, by holding the {{KEY|Ctrl}} key and clicking with the mouse.


Une série d'éléments peut être sélectionnée en cliquant sur le premier élément, en maintenant la touche {{KEY|Maj}} enfoncée et en cliquant sur le dernier élément.
A range of items can be selected by clicking on the first item, holding {{KEY|Shift}}, and clicking on the last item.


La sélection d'un seul élément affichera également ses propriétés dans l'[[Property_editor/fr|éditeur de propriétés]].
Selecting a single item will also show its properties in the [[property_editor|property editor]].


Un double clic ouvrira le [[Task_Panel/fr|panneau des tâches]] associé contenant des actions. Veillez à fermer ce panneau de tâches avant de lancer une autre commande ou de passer à un autre poste de travail.
Double clicking will open any associated [[task_panel|task panel]] containing actions. Make sure to close this task panel before executing another command or switching to any other workbench.


D'autres méthodes sont disponibles en ouvrant le menu contextuel (clic droit) en fonction de l'objet sélectionné ou de l'atelier actif. Voir les informations dans la [[Tree_view/fr|Vue en arborescence]].
More methods are available by opening the context menu (right-click), depending on the object selected or the active workbench; see the information in [[tree_view|tree view]].


==Scripting==
<span id="Scripting"></span>
==Script==


La sélection d'objets est en soi une tâche graphique et n'est donc disponible que lorsque l'interface utilisateur graphique est chargée.
Selecting objects is inherently a graphical task and therefore it is only available when the graphical user interface is loaded.


These commands can be used in [[Macros|macros]] or from the [[Python_console|Python console]].
Ces méthodes peuvent être utilisées dans des [[Macros/fr|macros]] ou depuis la [[Python_console/fr|Console Python]].


{{Code|code=
{{Code|code=
Line 75: Line 85:
}}
}}


La méthode {{incode|addSelectionGate}} empêche l'utilisateur de sélectionner des objets non spécifiés dans la chaîne de sélection. Un symbole [[Image:Button_invalid.svg|16px]] apparaît lorsque le pointeur se trouve sur un élément ne faisant pas partie du groupe spécifié.
The command {{incode|addSelectionGate}} restricts the user from selecting objects not specified in the selection string. A symbol appears when the pointer is over an item not in the specified group.


{{Code|code=
{{Code|code=
Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Edge")
Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Edge")

#### or
Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Face")

#### or
Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Vertex")
}}
}}


Pour quitter la commande {{incode|SelectionGate()}} :
See the [[Source_documentation|Source documentation]] and [[Std_PythonHelp|Std PythonHelp]] for more help on using these tools.


{{Code|code=
{{Docnav/fr
Gui.Selection.removeSelectionGate()
|[[Mouse_Model/fr|Navigation par la souris]]
|[[Preferences_Editor/fr|Réglage des préférences]]
}}
}}


Voir la [[Source_documentation/fr|Documentation du code source]] et la [[Std_PythonHelp/fr|Std Documentation des modules Python]] pour plus d'aide sur l'utilisation de ces outils.


{{Docnav/fr
|[[Mouse_navigation/fr|Navigation par la souris]]
|[[Navigation_Cube/fr|Cube de navigation]]
}}


{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 02:17, 21 May 2023

Présentation

Les Méthodes de sélection dans FreeCAD permettent de choisir des objets dans l'interface de FreeCAD tels que la vue 3D, la vue en arborescence, la fenêtre de sélection et d'autres boîtes de dialogue. Certaines méthodes de sélection sont spécifiques à l'atelier et sont documentées dans la documentation particulière de l'atelier.

Vue 3D

Dans la Vue 3D, il existe plusieurs façons de sélectionner des objets.

Sélection simple

La sélection simple avec la souris (par défaut clic gauche) et la présélection (survol) sont décrites dans la page Navigation par la souris.

Clics répétés

Le premier clic sélectionne un sous-élément (sommet, arête ou face) de l'objet sous la souris. Un deuxième clic sélectionne tout l'objet.

Le troisième clic étend la sélection à son objet conteneur (PartDesign Corps, Std Part et autres). Des clics supplémentaires développent la sélection dans la chaîne de conteneurs.

Commandes par sélection

Fenêtre de sélection

La fenêtre de sélection affiche les noms des objets sélectionnés y compris leur nom complet dans un objet, par exemple Unnamed#Body.Box001.Face17.

Elle permet également d'effectuer certaines actions comme Std Affichage de la sélection et d'envoyer l'objet à la Console Python.

Exportation d'objets

Cela devrait être dans la page Fenêtre de sélection.

Sélectionnez un objet complexe, par exemple un PartDesign Corps ou Std Part, puis dans la fenêtre de sélection sélectionnez à nouveau l'objet puis appuyez sur Ctrl + C au clavier pour ouvrir la boîte de dialogue Sélection des objets. Cela permet de copier l'objet sélectionné avec tous ou seulement certains des objets de dépendance de cet objet. Par exemple, pour un Std Part, les objets possibles à sélectionner incluent Std Part lui-même, mais aussi son origine, ses trois axes de base (XYZ) et ses trois plans de base (XY, YZ, XZ).

Après avoir appuyé sur OK, les objets sélectionnés sont copiés en mémoire puis peuvent être collés dans le document pour dupliquer uniquement ces objets.

Boîte de dialogue de sélection d'objet lancée depuis la fenêtre de sélection.

Vue en arborescence

Dans la Vue en arborescence, les éléments peuvent être sélectionnés ou désélectionnés, un par un, en maintenant la touche Ctrl et en cliquant avec la souris.

Une série d'éléments peut être sélectionnée en cliquant sur le premier élément, en maintenant la touche Maj enfoncée et en cliquant sur le dernier élément.

La sélection d'un seul élément affichera également ses propriétés dans l'éditeur de propriétés.

Un double clic ouvrira le panneau des tâches associé contenant des actions. Veillez à fermer ce panneau de tâches avant de lancer une autre commande ou de passer à un autre poste de travail.

D'autres méthodes sont disponibles en ouvrant le menu contextuel (clic droit) en fonction de l'objet sélectionné ou de l'atelier actif. Voir les informations dans la Vue en arborescence.

Script

La sélection d'objets est en soi une tâche graphique et n'est donc disponible que lorsque l'interface utilisateur graphique est chargée.

Ces méthodes peuvent être utilisées dans des macros ou depuis la Console Python.

import FreeCADGui as Gui

Gui.Selection.addSelection
Gui.Selection.addSelectionGate
Gui.Selection.Filter

La méthode addSelectionGate empêche l'utilisateur de sélectionner des objets non spécifiés dans la chaîne de sélection. Un symbole apparaît lorsque le pointeur se trouve sur un élément ne faisant pas partie du groupe spécifié.

Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Edge")

#### or
Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Face")

#### or
Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Vertex")

Pour quitter la commande SelectionGate() :

Gui.Selection.removeSelectionGate()

Voir la Documentation du code source et la Std Documentation des modules Python pour plus d'aide sur l'utilisation de ces outils.