Donate

LinkImportAll

LinkMakeGroup

Std Base

Description

The Std VarSet command creates a VarSet. A VarSet is a set of properties that can be used as variables in expressions.

The Add Property dialog box

Usage

1. Do one of the following:
   • To create a new VarSet: press the Variable Set button.
   • To edit an existing VarSet: double-click the set in the Tree View.
2. The Add Property dialog box opens.
3. Enter a Name for the property.
   • The name must be unique for the VarSet.
   • Only alphanumeric characters and underscores (A to Z, a to z, 0 to 9 and _) are allowed.
   • The first character may not be a digit.
   • FreeCAD uses the UpperCamelCase convention for its property names, meaning each word starts with a capital letter, and there are no spaces or underscores. When the Property View displays such a name, spaces are inserted between the words, making the name easier to read. It is advisable to follow this convention.
4. Enter a Group name for the property or select a group from the list. Group names have the same restrictions as property names.
5. Select the property Type from the list. See below for the most common types.
6. Enter a Value for the property. This input accepts units for properties that have units. You can also specify an expression.
7. 1.0 and below: Optionally check the Add another checkbox if you want to add more properties.
8. Optionally enter a Tooltip for the property.
9. Press the OK button.
10. The dialog box reopens (1.0 and below: only if the Add another checkbox has been checked) and a new property can be added.
11. Press the Cancel button when done.

Common property types

FreeCAD supports many property types. The table below lists some of the most common types. See FeaturePython Custom Properties for more information.

Notes

• Properties can also be added to existing VarSets in the Expression editor by checking the Store in Variable Set… checkbox.
• A property can be removed from a VarSet via the context menu of the Property View.
• A group name can be changed via the same menu.
• 1.0 and below: The command cannot set the list of allowed items of an App::PropertyEnumeration property. This can be done via Python code or in the Property View. The steps for the latter option are:
  1. Select Show hidden in the context menu of the Property View.
  2. Expand the node of the property.
  3. Click in the Enum field.
  4. Press the … button that appears.
  5. Enter values in the List dialog box that opens.
  6. Press the OK button.
• VarSets can also be edited with the commands from the DynamicData Workbench. Properties can be renamed, regrouped, retyped, and their tooltip updated. This external workbench can be installed from the Addon Manager.

Scripting

import FreeCAD as App

doc = App.ActiveDocument

var_set = doc.addObject("App::VarSet", "VarSetName")
var_set.addProperty("App::PropertyInteger", "MyNumber")  # Property is added to the Base group.
var_set.MyNumber = 123
var_set.addProperty("App::PropertyString", "MyText", group="SomeGroup", doc="Some tooltip information")
var_set.MyText = "Abc"

doc.recompute()

LinkImportAll

LinkMakeGroup

Std Base