Sketcher_ToggleActiveConstraint.md

---

• GuiCommand: Name:Sketcher ToggleActiveConstraint Workbenches:Sketcher MenuLocation:Sketch → Sketcher constraints → Toggle activate/deactivate constraint SeeAlso:Sketcher Toggle driving constraints Version:0.19

---

Sketcher ToggleActiveConstraint/pt-br

Description

[ ToggleActiveConstraint

allows you to activate and deactivate an already placed constraint. This allows you to keep the constraint in the background but temporarily test another arrangement of the existing geometry.

The [ Toggle driving constraint tool is similar in that it disables the effect of the constraint; however, with this tool, the constraint does not keep its old value. On the other hand, with [ ToggleActiveConstraint you can re-activate the old constraint immediately.

Usage

1. Select an already placed constraint, then press [ ToggleActiveConstraint.
2. Alternatively, got to the task panel, to the Constraints section, select the constraint, then open the context menu (right-click), and select Deactivate.
3. To activate the constraint again, select it, and press [ ToggleActiveConstraint again.

Examples

*Fully constrained sketch.*

Left: deactivated constraint; the sketch is no longer fully constrained. Right: the unconstrained geometry can be moved around; the older constraint is still available, and can be re-activated to return to the fully constrained sketch.

*Task panel with the deactivated constraint.*

Scripting

See also:

FreeCAD Scripting Basics.

The active status of a constraint can be controlled in macros and from the Python console.

SketchObject.toggleActive(index)

Use the toggleActive method of an existing Sketcher SketchObject, and the index of the constraint to activate it or deactivate it. The index starts from 0 all the way to N-1, where N is the total number of constraints.

Example:

import FreeCAD as App

sketch = App.ActiveDocument.Sketch
sketch.toggleActive(3)

{{Sketcher Tools navi

}}

---

documentation index > Sketcher > Sketcher ToggleActiveConstraint/pt-br