Std DlgParameter

Description
The Std DlgParameter command opens the Parameter Editor. In the Parameter Editor all parameters that control the behavior of FreeCAD and its workbenches can be inspected and optionally removed, added or changed.

The most common parameters are more conveniently accessible via the Preferences Editor.



Usage

 * 1) Select the  option from the menu.
 * 2) Optionally change one or more parameters. See Options.
 * 3) Optionally press the  button to immediately update the user.cfg file. This is not required as FreeCAD will automatically update that file when the application closes.
 * 4) Press the  button to close the Parameter Editor.

Left panel
The left panel shows a tree with parameter groups and sub-groups.

The following options are available in the panel's context menu:

Expand/Collapse

 * 1) If a selected group has one or more sub-groups it can be expanded or collapsed by choosing this option from the context menu. But you can also expand and collapse the tree in the usual manner.

Add sub-group

 * 1) Select a group.
 * 2) Select the  option from the context menu.
 * 3) Enter the name for the new sub-group in the dialog box that pops up.
 * 4) Press the  button.

Remove group

 * 1) Select a group.
 * 2) Select the  option from the context menu.
 * 3) Press the  button in the dialog box that pops up to confirm you want to remove the group (including all its sub-groups, and all parameters in the selected group and in its sub-groups).

Rename group

 * 1) Select a group.
 * 2) Select the  option from the context menu.
 * 3) Enter a new name.
 * 4) A group can also be renamed by double-clicking it.

Export parameter

 * 1) Select a group.
 * 2) Select the  option from the context menu.
 * 3) Enter a filename the dialog box.
 * 4) Press the  button.

Import parameter

 * 1) Select a group that does not contain any sub-groups or remove them first. Any existing parameters in the group will be lost.
 * 2) Select the  option from the context menu.
 * 3) Select a *.FCParam file in the dialog box.
 * 4) Press the  button.

Right panel
The right panel shows the parameters in the group selected in the left panel. If this group only contains sub-groups the right panel will be empty.

The following options are available in the panel's context menu:

Change value

 * 1) Select a parameter.
 * 2) Select the  option from the context menu.
 * 3) Enter a new value in the dialog box that pops up.
 * 4) Press the  button.
 * 5) A parameter's value can also be changed by double-clicking its 'Type' or 'Value' field.

Remove key

 * 1) Select a parameter.
 * 2) Select the  option from the context menu.

Rename key

 * 1) Select a parameter.
 * 2) Select the  option from the context menu.
 * 3) Enter a new name.
 * 4) A parameter can also be renamed by double-clicking its 'Name' field.

New string item

 * 1) Select the  or  option from the context menu.
 * 2) Enter a name in the dialog box that pops up.
 * 3) Press the  button.
 * 4) Enter a value in the next dialog box.
 * 5) Press the  button.

New float item

 * 1) Select the  or  option from the context menu.
 * 2) The next steps are similar to those for a New string item

New integer item

 * 1) Select the  or  option from the context menu.
 * 2) The next steps are similar to those for a New string item

New unsigned item

 * 1) Select the  or  option from the context menu.
 * 2) The next steps are similar to those for a New string item

New Boolean item

 * 1) Select the  or  option from the context menu.
 * 2) The next steps are similar to those for a New string item

Sorting
By default the groups in each tree level in the left panel are sorted alphabetically. The parameters in the right panel are sorted alphabetically as well. But the order in each panel can be reversed by clicking the 'Group' or 'Name' header respectively.

Scripting
FreeCAD Scripting Basics.

For a scripting example see Std SelBoundingBox.