Property editor/it

Descrizione
L'editore delle proprietà è uno dei più importanti strumenti di FreeCAD, ed è indispensabile in quanto permette di gestire le proprietà degli oggetti presenti nel documento.

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.

Generalmente il Property Editor è destinato a trattare un solo oggetto alla volta. I valori riportati nel Property Editor appartengono all'oggetto attivo del documento attivo (se si lavora su più documenti si deve stare attenti a quale documento è realmente attivo ). Quando non è selezionato nessun elemento (o non vi sono elementi), l'editor delle proprietà è vuoto.

In genere, tutte le proprietà sono modificabili, ma talvolta, secondo lo specifico status, alcune proprietà possono essere visualizzate in modalità di sola lettura.



Definizione di proprietà
Una proprietà è un'informazione come un numero o una stringa di testo che è allegata ad un documento di FreeCAD o ad un oggetto in un documento. Le proprietà possono essere visualizzate e modificate con l'editor delle proprietà.

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.

In FreeCAD gli oggetti script personalizzati possono avere proprietà dei seguenti tipi:

Some of the most commonly used property types are:

Oggetti diversi possono avere proprietà differenti. Tuttavia, alcune proprietà sono comuni a tutti gli oggetti, ad esempio, la posizione e la rotazione di un oggetto che sono delle proprietà Dati manipolabili.

View and Data properties
Ci sono due tipi di dati delle proprietà delle operazioni e sono contenuti nelle corrispondenti schede:
 * Le proprietà : riguardano la visualizzazione delle caratteristiche dell'oggetto selezionato.
 * Le proprietà : riguardano i dati fisici dell'oggetto selezionato.

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



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.

Vista



 * : Indica se deve essere visualizzata una casella (riquadro di delimitazione) che mostra l'ingombro complessivo dell'oggetto. Valore Falso o Vero (predefinito, Falso).
 * : Indica se i punti di controllo delle funzioni devono essere visualizzati. Valore Falso o Vero (predefinito, Falso).
 * : Imposta la precisione della rappresentazione poligonale del modello nella vista 3D (tassellatura). Valori più bassi = migliore qualità. Il valore è in percentuale della dimensione dell'oggetto (deviazione in mm = (w+h+d)/3* valore in Percentuale /100, dove w, h, d sono le dimensioni del riquadro di delimitazione).
 * :Modalità di visualizzazione della funzione, Flat lines, Shaded, Wireframe, Points [[IMAGE:Vue_DisplayModePartDesign_fr_00.png|96px]]. (Default, Flat lines).
 * : Illuminazione One side, Two side [[IMAGE:Vue_Lighting_fr_00.png|96px]]. (Default, Two side).
 * : Dà il colore della linea (bordi) (Default, 25, 25, 25).
 * : Dà lo spessore della linea (bordi) (Default, 2).
 * : Fornisce il colore dei punti (estremità della funzione) (Default, 25, 25, 25).
 * : Dà la dimensione dei punti (Default, 2).
 * : Consente la selezione della funzione. Valore Falso o Vero (predefinito, Vero).
 * : Dà il colore della forma (default, 204, 204, 204).
 * : Imposta il grado di trasparenza nella funzione da 0 a 100 (Default, 0).
 * : Determina la visibilità della funzione (come la barra ). Valore Falso o Vero (predefinito, Vero).

Dati


Placement controlla il posizionamento della parte rispetto al sistema di coordinate. NOTA: le proprietà di posizionamento non influenzano le dimensioni fisiche della funzione, ma semplicemente la sua posizione nello spazio! Se si seleziona il titolo Placement, alla sua destra appare un pulsante ccon. Cliccando su questi, si apre la finestra delle opzioni per il Posizionamento.


 * : L'argomento Angolo specifica l'angolo da utilizzare con l'opzione Axis. In questa opzione si stabilisce un angolo, poi sotto, con l'opzione Axis, si imposta l'asse sul quale si vuole utilizzare questo angolo. L'operazione viene ruotata dell'angolo specificato, attorno all'asse specificato. Un esempio di utilizzo potrebbe essere quando si crea una operazione rivoluzione, ma poi serve ruotare l'intera operazione di un certo valore, per allinearla con una diversa operazione preesistente.


 * : Questa opzione specifica l'asse o gli assi su cui l'operazione creata deve essere ruotata. Il valore di rotazione esatto viene dalla opzione angolo (sopra). Questa opzione ha tre argomenti, che vengono passati come numeri alle rispettive caselle di testo X, Y, Z dello strumento. Inserendo un valore in più di uno degli assi si causa la rotazione della parte del corrispondente angolo per ogni asse. Per esempio, con un angolo impostato pari a 15°, specificando un valore di 1,0 per X, e di 2,0 per Y causa una rotazione finale del pezzo di 15° sull'asse X e di 30° sull'asse Y.


 * : Questa opzione specifica il punto base, ovvero, il punto a cui tutte le dimensioni si riferiscono. Questa opzione ha tre argomenti, che vengono passati come numeri alle rispettive caselle di testo X, Y, Z dello strumento. Inserendo un valore in una o più caselle si produce una traslazione della parte sull'asse corrispondente, pari al numero di unità indicate.


 * : Label è il nome attribuito all'operazione, questo nome può essere modificato a discrezione.