Std Workbench: Difference between revisions

From FreeCAD Documentation
m (formatting)
mNo edit summary
(27 intermediate revisions by 5 users not shown)
Line 2: Line 2:
<translate>
<translate>


<!--T:1-->
<!--T:31-->
{{Docnav
{{UnfinishedDocu}}
|[[Std_RandomColor|RandomColor]]
|[[Std_TreeSyncView|TreeSyncView]]
|[[Std_View_Menu|Std View Menu]]
|IconL=Std_RandomColor.svg
|IconR=Std_TreeSyncView.svg
|IconC=Freecad.svg
}}


<!--T:2-->
<!--T:2-->
<!--Empty=1 to suppress icon-->
{{GuiCommand
{{GuiCommand
|Name=Std Workbench
|Name=Std Workbench
|Empty=1
|MenuLocation=[[Std View Menu|View]] → Workbench
|MenuLocation=View → Workbench
|Workbenches=All
|SeeAlso=[[Workbenches| Workbenches]]
|Workbenches=[[Workbenches|Workbenches]]
|SeeAlso=
}}
}}


== Description == <!--T:5-->
==Description== <!--T:5-->


<!--T:6-->
<!--T:6-->
This command is used to activate the graphical user interface (GUI) and the tools of a specific workbench.
The '''Std Workbench''' command activates a selected [[Workbenches|workbench]] including its graphical user interface (GUI).


<!--T:8-->
<!--T:26-->
[[Image:FreeCAD_interface_base_divisions.svg|800px]]
There are also two special options available: '''None''' (no workbench) and '''Complete''' {{Obsolete|0.17}}
{{Caption|The Workbench dropdown list indicated by number 10 in the standard [[interface|interface]]}}


== Usage == <!--T:3-->
==Usage== <!--T:3-->


<!--T:9-->
<!--T:9-->
# There are several ways to invoke the command:
Often the project starts in a workbench, for example with '''Sketch''', then continues in a different workbench, for example with '''Part''', to create objects.
#* Select a workbench from the '''Workbench dropdown list''' in the Workbench toolbar. This option is not available if the current workbench is {{incode|<none>}} (no workbench).
You can switch from the current workbench to a new one with one of the following ways:
#* Select a workbench from the {{MenuCommand|View → Workbench}} sub-menu.


=== From the View menu === <!--T:10-->
==Notes== <!--T:8-->
* In the top menu, open the {{Button|'''View'''}} → {{Button|'''Workbench'''}} menu and select a workbench. This menu is always available, even when you have previously selected the '''Complete''' or '''None''' workbench.


=== From the drop-down menu === <!--T:11-->
<!--T:27-->
* Additional [[External_Workbenches|External Workbenches]] can be downloaded with the [[Image:AddonManager.svg|24px]] [[Addon_Manager|Addon Manager]].
* In the top menu, open the drop-down menu and select a workbench. This menu is not available when you have previously selected the '''Complete''' or '''None''' workbench.


=== Via Python console === <!--T:12-->
==Preferences== <!--T:32-->


<!--T:13-->
<!--T:33-->
* The start up workbench can be changed in the preferences: {{MenuCommand|Edit → Preferences... → General → General → Start up}}. See [[Preferences_Editor#General|Preferences Editor]].
* Type the command in the Python console, for example: to invoke the Draft workbench type:
:{{incode|Gui.activateWorkbench ("DraftWorkbench")}}


== Examples == <!--T:14-->
==Scripting== <!--T:34-->


<!--T:16-->
<!--T:35-->
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].
[[Image: WorkbenchStd1.png]]


<!--T:15-->
<!--T:36-->
To change the worbench use the {{incode|activateWorkbench}} method of the FreeCADGui module. This method is not available if FreeCAD is in console mode.
{{Caption|Using the the Workbench drop-down menu}}


</translate>
<!--T:18-->
{{Code|code=
[[Image: WorkbenchStd2.png]]
import FreeCADGui


FreeCADGui.activateWorkbench("PartDesignWorkbench")
<!--T:17-->
}}
{{Caption|Invoking a different workbench using the Python console}}
<translate>


<!--T:20-->
[[Image: WorkbenchStd3.png]]


<!--T:19-->
<!--T:37-->
{{Docnav
{{Caption|'''Tip:''' If the Python console is open you will see that FreeCAD records the actions it executes in python code. Theoretically, the user can change something in the interface and see the comparable python code generated. This is a very useful way to learn python, FreeCAD, and how to automate redundant tasks (see [[Macros]] for more details).}}
|[[Std_RandomColor|RandomColor]]

|[[Std_TreeSyncView|TreeSyncView]]
== Other references == <!--T:21-->
|[[Std_View_Menu|Std View Menu]]
For a general description of the workbenches, see the page [[Workbenches| Workbenches]].
|IconL=Std_RandomColor.svg

|IconR=Std_TreeSyncView.svg
<!--T:23-->
|IconC=Freecad.svg
{{Std Base}}
}}

<!--T:25-->
{{Userdocnavi}}


</translate>
</translate>
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Interface navi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 14:57, 6 January 2021

Std Workbench

Menu location
View → Workbench
Workbenches
Workbenches
Default shortcut
None
Introduced in version
-
See also
None

Description

The Std Workbench command activates a selected workbench including its graphical user interface (GUI).

The Workbench dropdown list indicated by number 10 in the standard interface

Usage

  1. There are several ways to invoke the command:
    • Select a workbench from the Workbench dropdown list in the Workbench toolbar. This option is not available if the current workbench is <none> (no workbench).
    • Select a workbench from the View → Workbench sub-menu.

Notes

Preferences

  • The start up workbench can be changed in the preferences: Edit → Preferences... → General → General → Start up. See Preferences Editor.

Scripting

See also: FreeCAD Scripting Basics.

To change the worbench use the activateWorkbench method of the FreeCADGui module. This method is not available if FreeCAD is in console mode.

import FreeCADGui

FreeCADGui.activateWorkbench("PartDesignWorkbench")