Std Edit/en: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 12: Line 12:
{{GuiCommand
{{GuiCommand
|Name=Std Edit
|Name=Std Edit
|MenuLocation={{StdMenu|[[Std_Edit_Menu|Edit]]}} → Toggle Editmode
|MenuLocation=Edit → Toggle Edit mode
|Workbenches=All
|Workbenches=All
|Shortcut=-
|Version=-
|SeeAlso=-
}}
}}


== Description ==
==Description==


The '''Std Edit''' command activates or deactivates an object's edit mode.
The [[Image:Std_Edit.svg|24px]] [[Std_Edit|Edit]] command allows to enter or leave the edit mode of a selected object. An object must be either selected (then it enters edit mode) or in edit mode (then it leaves edit mode) for this command to work.


==Usage==
The behaviour that occurs when entering edit mode depends on the object type. Some object types don't define any edit mode behaviour, in that case the standard behaviour (a transform widget) is used.


# If no object is in edit mode: select a single object.
You can also perform the same action by double-clicking an object in the [[Tree view]].
# Select the {{MenuCommand|Edit → [[Image:Std_Edit.svg|16px]] Toggle Edit mode}} option from the menu.
# Either the edit mode of the selected object is activated or the existing edit mode deactivated.


== Scripting ==
==Notes==


* Not all object types have an edit mode.
This enters edit mode of a determined object:
* The functionality available in edit mode depends on the object type.
* Edit mode can also be activated by double clicking an object in the [[Tree_view|Tree view]].

==Scripting==

{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].

To activate an object's edit mode use the {{incode|setEdit}} method of the document object.


{{Code|code=
{{Code|code=
import FreeCADGui

FreeCADGui.ActiveDocument.setEdit("myObjectName",0)
FreeCADGui.ActiveDocument.setEdit("myObjectName",0)
}}
}}

This closes the edit mode:
To deactivate an object's edit mode use the {{incode|resetEdit}} method of the document object.


{{Code|code=
{{Code|code=
FreeCADGui.ActiveDocument.resetEdit()
import FreeCADGui

FreeCADGui.ActiveDocument.resetEdit()
}}
}}


Line 48: Line 60:
|IconC=Freecad.svg
|IconC=Freecad.svg
}}
}}

{{clear}}


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

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

Revision as of 21:22, 23 March 2020

Std Edit

Menu location
Edit → Toggle Edit mode
Workbenches
All
Default shortcut
None
Introduced in version
-
See also
None

Description

The Std Edit command activates or deactivates an object's edit mode.

Usage

  1. If no object is in edit mode: select a single object.
  2. Select the Edit → Toggle Edit mode option from the menu.
  3. Either the edit mode of the selected object is activated or the existing edit mode deactivated.

Notes

  • Not all object types have an edit mode.
  • The functionality available in edit mode depends on the object type.
  • Edit mode can also be activated by double clicking an object in the Tree view.

Scripting

See also: FreeCAD Scripting Basics.

To activate an object's edit mode use the setEdit method of the document object.

import FreeCADGui

FreeCADGui.ActiveDocument.setEdit("myObjectName",0)

To deactivate an object's edit mode use the resetEdit method of the document object.

import FreeCADGui

FreeCADGui.ActiveDocument.resetEdit()