Donate

문서구조

작업대

Index

소개

The Property View appears in the lower section of the Model panel (if the Combo View is active) or as a stand-alone panel.

Generally, the Property View is intended to deal with the properties one object at a time. The values shown in the Property View belong to the selected object. Despite this, some properties like colors can be set for multiple selected objects. If no element is selected the Property View is empty.

Not all properties can be modified, some are read-only.

The Data properties of a Part Box

Property types

A property is a piece of information like a number or a text string that is attached to a FreeCAD document or an object in the document. Many property types are available. Some of the most common types are:

App::PropertyAngle
App::PropertyBool
App::PropertyDistance
App::PropertyFloat
App::PropertyInteger
App::PropertyLength
App::PropertyPlacement
App::PropertyString
App::PropertyVector

View and Data properties

The Property View has two tabs giving access to two classes of properties:

• Data properties, related to the "physical" parameters of the object. The Data properties define the essential characteristics of the object. They exist at all times, even when FreeCAD is used in console mode, or as a library. This means that if you load a document in console mode, you can edit the radius of a circle or the length of a line, even if you cannot see the result on the screen.
• View properties, related to the "visual" appearance of the object. The View properties are tied to the ViewObject of the object, and are only accessible when the graphical user interface (GUI) is loaded. They are not accessible when using FreeCAD in console mode, or as a headless library. By default changes to View properties are not added to the undo stack and cannot be undone and redone with Std Undo and Std Redo. But it is possible to change this by setting the fine-tuning parameter AutoTransactionView to true.

Basic properties

Different objects may have different properties. However, many objects have the same properties because they are derived from the same internal class.

Most geometrical objects that can be created and displayed in the 3D View are derived from a Part::Feature. See Part Feature for the basic properties these objects have.

For 2D geometry, most objects are derived from a Part::Part2DObject (itself derived from a Part::Feature) which is the base of Sketches, and most Draft objects. See Part Part2DObject for the basic properties these objects have.

Context menu

To display the context menu of the Property View right-click the background, or right-click a property.

Right-clicking the background shows three options:

• Add Property: adds a dynamic property to the object.

• Expand/Collapse Properties: introduced in 1.1

Property groups collapse/expand when you click their name. Property nodes collapse/expand when you click the symbol (usually an arrow) in front of their name.

• Expand to Default: property groups are expanded and property nodes are collapsed for the current object.

• Expand All: property groups and property nodes are expanded for the current object.

• Collapse All: property groups and property nodes are collapsed for the current object.

• Default Expand: when an objects is selected, property groups appear expanded and property nodes appear collapsed.

• Auto Expand: when an objects is selected, property groups and property nodes appear expanded.

• Auto Collapse: when an objects is selected, property groups and property nodes appear collapsed.

• Show Hidden: if active, hidden Data and View properties are shown.

When right-clicking a property the following additional options are available:

• Copy: copies the property value to the clipboard.

• Rename Property Group: renames the property group of selected properties. Only available for dynamic properties. Dynamic properties are those added by the user.

• Rename Property: renames the selected property. Idem. introduced in 1.1

• Edit Property Tooltip: edits the tooltip of the selected property. Idem. introduced in 1.1

• Delete Property: deletes selected properties. Idem.

• Expression: brings up the Expression Editor, which allows using expressions in the property value.

• Status:

If a status value is followed by an asterisk (*) it is static and cannot be changed.

• Hidden: if active, sets the property as hidden, meaning that it will only be displayed in the Property View if Show Hidden is active.

• Output: if active, sets the property as output.

• NoRecompute: if active, modifying the property doesn't touch its container for recompute.

• ReadOnly: if active, sets the property as read-only. The property won't be editable in the Property View. It may however still be possible to change the property via a dialog.

• Transient: if active, sets the property as transient. The value of a transient property is not saved to file. When opening a file, it is instantiated with its default value.

• Touched: if active, the object becomes touched, and ready for recompute.

• EvalOnRestore: if active, the property is evaluated when the document is restored.

• CopyOnChange: if active, the property is copied when changed in a Link. The Link's 데이터Link Copy On Change property must be set to Tracking or Enabled for this to work. This is related to Variant Links.

Scripting

See FeaturePython Custom Properties.

Preferences

See Combo view.

문서구조

작업대

Index