Property editor/pl

Wprowadzenie
The property editor appears when the tab of the combo view is active; it allows managing the publicly exposed properties of the objects in the document.

Ogólnie rzecz biorąc, edytor właściwości jest przeznaczony do obsługi tylko jednego obiektu w tym samym czasie. Wartości wyświetlane w edytorze właściwości należą do wybranego obiektu aktywnego dokumentu. Mimo to, niektóre właściwości, takie jak kolory, mogą być ustawione dla wielu zaznaczonych obiektów. Jeśli nie ma zaznaczonych elementów, edytor właściwości będzie pusty.

Nie wszystkie właściwości mogą być zawsze modyfikowane. W zależności od określonego statusu właściwości, niektóre z nich będą niewidoczne (nie wymienione) lub będą tylko do odczytu (nie edytowalne).



Typy właściwości
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.

Custom scripted objects can use any of the property types defined in the base system. See the full list in Property.

Some of the most commonly used property types are:

Różne obiekty mogą mieć różne typy właściwości. Jednak wiele obiektów ma te same typy, ponieważ pochodzą one z tej samej klasy wewnętrznej. Na przykład, większość obiektów opisujących kształty geometryczne (linie, okręgi, prostokąty, bryły, importowane części itp.) ma właściwość Położenie, która określa ich położenie w widoku 3D.

View and Data properties
Istnieją dwie klasy właściwości obiektu dostępne poprzez zakładki w edytorze właściwości:
 * właściwości związane z wizualnym wyglądem obiektu. Właściwości są związane z  (atrybut obiektu ) i są dostępne tylko wtedy, gdy załadowany jest graficzny interfejs użytkownika (GUI). Nie są one dostępne przy korzystaniu z FreeCAD w trybie konsolowym lub jako biblioteka zasobów własnych.

For this reason, properties are considered to be more "real", as they truly define the geometry of a shape. On the other hand, properties are less important because they only affect the appearance of the geometry. For example, a circle of 10 mm radius is different from a circle of 5 mm radius; the color of the circle (view property) doesn't affect its shape, but the radius does (data property). In many instances in this documentation, the word "property" is understood to refer to a "Data property".

Basic properties
The most basic scripted object won't show any property in the property editor, except for its  attribute. The is a user editable string that identifies the object in the tree view. On the other hand, the attribute of an object is assigned at the moment of its creation and cannot be changed; this attribute is read-only, and is not displayed in the property editor either.

A basic parametric object is created as follow



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

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

Actions
Actions in the property view were implemented in 0.19.

Right clicking in an empty space of the view, or with a property selected, shows only one command:
 * : if active, in addition to the standard properties that appear already, it shows all the hidden Data and View properties in their respective tabs.
 * Data: "Proxy", "Label2", "Expression Engine", and "Visibility".
 * View: "Proxy".

When the option is active, and one property is selected, more actions are available with a second right click:
 * : deactivates the command, hiding the additional Data and View properties.
 * : adds a dynamic property to the object; this works with both C++ and Python scripted objects.
 * : brings up the formula editor, which allows using expressions in the property value.
 * : if active, sets the property as hidden, meaning that it will only be displayed if is active.
 * : if active, sets the property as output.
 * : if active, sets the property as not recomputed when the document is recomputed; this is useful when a property should be kept unaffected by other updates.
 * : if active, sets the property to be read-only; it won't be editable any more until this switch is turned off.
 * : if active, sets the property as transient.
 * : if active, it becomes touched, and ready for recompute.
 * : if active, it is evaluated when the document is restored.

View



 * : Indicates if a box showing the overall extent of the object is to be displayed. Value False, or True (Default, False).
 * : Indicates if the feature control points are to be displayed. Value False, or True (Default, False).
 * : Sets the accuracy of the polygonal representation of the model in the 3d view (tessellation). Lower values = better quality. The value is in percent of object's size (deviation in mm = (w+h+d)/3*valueInPercent/100, where w,h,d are the bounding box dimensions).
 * : Display mode of the feature, Flat lines, Shaded, Wireframe, Points [[IMAGE:Vue_DisplayModePartDesign_fr_00.png|96px]]. (Default, Flat lines).
 * : Lighting One side, Two side [[IMAGE:Vue_Lighting_fr_00.png|96px]]. (Default, Two side).
 * : Gives the color of the line (edges) (Default, 25, 25, 25).
 * : Gives the thickness of the line (edges) (Default, 2).
 * : Gives the color of the points (ends of the feature) (Default, 25, 25, 25).
 * : Gives the size of the points (Default, 2).
 * : Allows selection of the feature. Value False, ou True (Default, True).
 * : Give the color shape (default, 204, 204, 204).
 * : Sets the degree of transparency in the feature of 0 to 100 (Default, 0).
 * : Determines the visibility of the feature (like the bar ). Value False, or True (Default, True).

Data


Summary of the data below. Every feature has a placement that can be controlled through the Data Properties table. It controls the placement of the part with respect to the coordinate system. NOTE: The placement properties do not affect the physical dimensions of the feature, but merely its position in space! If you select the title Placement, a button with appears to the right. Clicking this button, opens the Tasks_Placement options window.

Specifies the angle to be used with the axis property (below). An angle is set here, and the axis that the angle acts upon is set with the axis property. The feature is rotated by the specified angle, about the specified axis. A usage example might be if you created a revolution feature as required, but then needed to rotate the whole feature by some amount, in order to allow it to line-up with another pre-existing feature.

This property specifies the axis/axes about which the feature is to be rotated. The exact value of rotation comes from the angle property (above). This property takes three arguments, which are passed as numbers in the x, y, and z boxes in the tool. Setting a value for more than one of the axes will cause the part to be rotated in each axis, by the angle value multiplied by the value for the axis. For example, with an angle of 15° set, specifying a value of 1.0 for x, and 2.0 for y will cause the finished part to be rotated 15° in the x-axis AND 30° in the y-axis.

This property specifies the base point to which all dimensions refer. This takes three arguments, which are passed as numbers to the x, y, and z boxes in the tool. Setting a value for more than one of the boxes will cause the part to be translated by the number of units along the corresponding axis.

The Label is the name given to the object (feature), this name can be changed as desired.