|
|
| Menu location |
|---|
| None |
| Workbenches |
| All |
| Default shortcut |
| None |
| Introduced in version |
| 1.0 |
| See also |
| Spreadsheet Workbench, DynamicData Workbench |
Описание
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
- 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.
- To create a new VarSet: press the
- The Add Property dialog box opens.
- Enter a Name for the property.
- The name must be unique for the VarSet.
- Only alphanumeric characters and underscores (
AtoZ,atoz,0to9and_) 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.
- Enter a Group name for the property or select a group from the list. Group names have the same restrictions as property names.
- Select the property Type from the list. See below for the most common types.
- Enter a Value for the property. This input accepts units for properties that have units. You can also specify an expression.
- 1.0 and below: Optionally check the Add another checkbox if you want to add more properties.
- Optionally enter a Tooltip for the property.
- Press the OK button.
- The dialog box reopens (1.0 and below: only if the Add another checkbox has been checked) and a new property can be added.
- 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.
| Property type | Default unit (if any) | Remark |
|---|---|---|
App::PropertyLength |
mm | Similar to App::PropertyDistance but cannot be negative
|
App::PropertyAngle |
° (or deg) | |
App::PropertyFloat |
Decimal number | |
App::PropertyInteger |
Whole number | |
App::PropertyBool |
true or false, can be used in conditional expressions
| |
App::PropertyString |
Text string | |
App::PropertyEnumeration |
Text-based option list |
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::PropertyEnumerationproperty. This can be done via Python code or in the Property View. The steps for the latter option are:- Select Show hidden in the context menu of the Property View.
- Expand the node of the property.
- Click in the Enum field.
- Press the … button that appears.
- Enter values in the List dialog box that opens.
- 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()
Эта страница получена от https://wiki.freecad.org/Std_VarSet