Selection methods in FreeCAD allow picking objects in the FreeCAD Interface: such as 3D view, tree view, selection view, and other dialogs. Some selection methods are workbench specific and are documented in the particular workbench documentation.
In the 3D view there are various ways of selecting objects.
Simple selection with the mouse (by default left-click) and pre-selection (hover) are described in the mouse navigation page.
The first click selects a sub-element (vertex, edge or face) of the object under the mouse. A second click selects the whole object.
- To select all objects: Std SelectAll.
- To box select multiple main objects: Std BoxSelection.
- To box select multiple faces: Std BoxElementSelection or Part BoxSelection.
The selection view shows the names of the objects being selected, including their full name within an object, for example,
This should be in the selection view page.
Select any complex object, for example, a PartDesign Body or Std Part, then in the selection view select again the object, and then press + in the keyboard to open the 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 the possible objects to select include the Std Part itself, but also its Origin, its three base axes (XYZ), and its three base planes (XY, YZ, XZ).
After pressing, the selected objects are copied into memory, and then can be pasted in the document to duplicate these objects only.
Object selection dialog that is launched from the selection view.
In the tree view items can be selected, or deselected, one at a time, by holding the key and clicking with the mouse.
A range of items can be selected by clicking on the first item, holding, and clicking on the last item.
Selecting a single item will also show its properties in the property editor.
Double clicking will open any associated task panel containing actions. Make sure to close this task panel before executing another command or switching to any other workbench.
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.
Selecting objects is inherently a graphical task and therefore it is only available when the graphical user interface is loaded.
import FreeCADGui as Gui
Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Edge")
Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Face")
Gui.Selection.addSelectionGate("SELECT Part::Feature SUBELEMENT Vertex")