App FeaturePython/it: Difference between revisions

From FreeCAD Documentation
(Created page with "Queste proprietà corrispondono alle proprietà di base del viewprovider di base, {{incode|Gui::ViewProviderDocumentObject}}, che viene ereditato da tutti...")
(Updating to match new version of source page)
Line 31: Line 31:
{{TitleProperty|Base}}
{{TitleProperty|Base}}


<div class="mw-translate-fuzzy">
* {{PropertyData|Label|String}}: il nome di questo oggetto modificabile dall'utente, è una stringa UTF8 arbitraria.

====Proprietà dati nascoste====

* {{PropertyData|Expression Engine|ExpressionEngine}}: un elenco di espressioni. Di default, è vuota {{value|[]}}.
* {{PropertyData|Expression Engine|ExpressionEngine}}: un elenco di espressioni. Di default, è vuota {{value|[]}}.
* {{PropertyData|Label2|String}}: una descrizione di questo oggetto più lunga e modificabile dall'utente, è una stringa UTF8 arbitraria che può includere nuove righe. Di default, è una stringa vuota {{value|""}}.
* {{PropertyData|Label2|String}}: una descrizione di questo oggetto più lunga e modificabile dall'utente, è una stringa UTF8 arbitraria che può includere nuove righe. Di default, è una stringa vuota {{value|""}}.
* {{PropertyData|Proxy|PythonObject}}: una classe personalizzata associata a questo oggetto.
* {{PropertyData|Proxy|PythonObject}}: una classe personalizzata associata a questo oggetto.
* {{PropertyData|Visibility|Bool}}: se visualizzare l'oggetto o no.
* {{PropertyData|Visibility|Bool}}: se visualizzare l'oggetto o no.
</div>


===Vista===
===Vista===
Line 44: Line 42:
Queste proprietà corrispondono alle proprietà di base del [[viewprovider/it|viewprovider]] di base, {{incode|Gui::ViewProviderDocumentObject}}, che viene ereditato da tutti i viewprovider nel software.
Queste proprietà corrispondono alle proprietà di base del [[viewprovider/it|viewprovider]] di base, {{incode|Gui::ViewProviderDocumentObject}}, che viene ereditato da tutti i viewprovider nel software.


{{TitleProperty|Base}}

<div class="mw-translate-fuzzy">
* {{PropertyView|Proxy|PythonObject}}: una classe di provider di visualizzazione personalizzata associata a questo oggetto.
</div>

<div class="mw-translate-fuzzy">
{{TitleProperty|Display Options}}
{{TitleProperty|Display Options}}
* {{PropertyView|Display Mode|Enumeration}}: di default è vuota.
* {{PropertyView|Display Mode|Enumeration}}: di default è vuota.
* {{PropertyView|Show In Tree|Bool}}: se è {{TRUE}}, l'oggetto appare nella [[tree view/it|vista ad albero]]. Altrimenti, è impostato come invisibile.
* {{PropertyView|Show In Tree|Bool}}: se è {{TRUE}}, l'oggetto appare nella [[tree view/it|vista ad albero]]. Altrimenti, è impostato come invisibile.
* {{PropertyView|Visibility|Bool}}: se è {{TRUE}}, l'oggetto appare nella [[3D view/it|vista 3D]]; altrimenti, è invisibile. Questa proprietà può essere attivata e disattivata premendo la barra {{KEY|Spazio}} sulla tastiera.
* {{PropertyView|Visibility|Bool}}: se è {{TRUE}}, l'oggetto appare nella [[3D view/it|vista 3D]]; altrimenti, è invisibile. Questa proprietà può essere attivata e disattivata premendo la barra {{KEY|Spazio}} sulla tastiera.
</div>


{{TitleProperty|Selection}}
{{TitleProperty|Selection}}


<div class="mw-translate-fuzzy">
* {{PropertyView|On Top When Selected|Enumeration}}: {{value|Disabled}} (default), {{value|Enabled}}, {{value|Object}}, {{value|Element}}.
* {{PropertyView|On Top When Selected|Enumeration}}: {{value|Disabled}} (default), {{value|Enabled}}, {{value|Object}}, {{value|Element}}.
* {{PropertyView|Selection Style|Enumeration}}: {{value|Shape}} (default), {{value|BoundBox}}. Se l'opzione è {{value|Shape}}, nella [[3D view/it|vista 3D]] verrà evidenziata l'intera forma (vertici, bordi e facce); se è {{value|BoundBox}} verrà evidenziato solo il riquadro di delimitazione.
* {{PropertyView|Selection Style|Enumeration}}: {{value|Shape}} (default), {{value|BoundBox}}. Se l'opzione è {{value|Shape}}, nella [[3D view/it|vista 3D]] verrà evidenziata l'intera forma (vertici, bordi e facce); se è {{value|BoundBox}} verrà evidenziato solo il riquadro di delimitazione.
</div>

====Proprietà vista nascoste====

{{TitleProperty|Base}}

* {{PropertyView|Proxy|PythonObject}}: una classe di provider di visualizzazione personalizzata associata a questo oggetto.


== Script ==
== Script ==

Revision as of 18:59, 11 September 2020

Other languages:

Introduzione

Un oggetto App FeaturePython, o formalmente un App::FeaturePython, è una semplice istanza di App DocumentObject in Python.

Questo è un oggetto semplice che per impostazione predefinita non ha molte proprietà, ad esempio nessun posizionamentoforma topologica. Questo oggetto è per uso generale e, fornendolo di proprietà, può essere utilizzato per gestire diversi tipi di dati.

Diagramma semplificato delle relazioni tra gli oggetti principali del programma. La classe App::FeaturePython è una semplice implementazione di App::DocumentObject che può essere utilizzata per qualsiasi scopo, poiché di default non ha una forma topologica.

Utilizzo

Un App FeaturePython è un oggetto interno, quindi non può essere creato dall'interfaccia grafica. È pensato per essere sottoclassato da classi che gestiranno diversi tipi di dati.

Vedere Script per ulteriori informazioni.

Proprietà

Un oggetto App FeaturePython (classe App::FeaturePython) è derivato dall'oggetto base App DocumentObject (classe App::DocumentObject), pertanto condivide tutte le proprietà di quest'ultimo.

Oltre alle proprietà descritte in App DocumentObject, FeaturePython ha un provider di visualizzazione di base, quindi appare nella vista ad albero.

Vedere Proprietà per tutti i tipi di proprietà che possono avere gli oggetti con script.

Queste sono le proprietà disponibili nell'editor delle proprietà. Le proprietà nascoste possono essere mostrate usando il comando Mostra tutto nel menu contestuale dell'editor delle proprietà.

Dati

Base

  • DatiExpression Engine (ExpressionEngine): un elenco di espressioni. Di default, è vuota [].
  • DatiLabel2 (String): una descrizione di questo oggetto più lunga e modificabile dall'utente, è una stringa UTF8 arbitraria che può includere nuove righe. Di default, è una stringa vuota "".
  • DatiProxy (PythonObject): una classe personalizzata associata a questo oggetto.
  • DatiVisibility (Bool): se visualizzare l'oggetto o no.

Vista

Queste proprietà corrispondono alle proprietà di base del viewprovider di base, Gui::ViewProviderDocumentObject, che viene ereditato da tutti i viewprovider nel software.

Base

  • VistaProxy (PythonObject): una classe di provider di visualizzazione personalizzata associata a questo oggetto.

Display Options

  • VistaDisplay Mode (Enumeration): di default è vuota.
  • VistaShow In Tree (Bool): se è true, l'oggetto appare nella vista ad albero. Altrimenti, è impostato come invisibile.
  • VistaVisibility (Bool): se è true, l'oggetto appare nella vista 3D; altrimenti, è invisibile. Questa proprietà può essere attivata e disattivata premendo la barra Spazio sulla tastiera.

Selection

  • VistaOn Top When Selected (Enumeration): Disabled (default), Enabled, Object, Element.
  • VistaSelection Style (Enumeration): Shape (default), BoundBox. Se l'opzione è Shape, nella vista 3D verrà evidenziata l'intera forma (vertici, bordi e facce); se è BoundBox verrà evidenziato solo il riquadro di delimitazione.

Script

Vedere anche: Script di base per FreeCAD, e script di oggetti.

Vedere Part Feature per le informazioni generali sull'aggiunta di oggetti al programma.

Una App FeaturePython viene creata con il metodo addObject() del documento

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::FeaturePython", "Name")
obj.Label = "Custom label"

Per esempio, gli elemnti Testo, Dimensione, e Piano di lavoro proxy di Draft sono oggetti App::FeaturePython oggetti con un'icona personalizzata e proprietà aggiuntive. Conservano i dati ma non sono in effetti Part TopoShape.

Se l'oggetto desiderato deve avere un posizionamento, una forma, un allegato o altre proprietà complesse, è meglio creare una delle classi più complesse, ad esempio, App GeoFeature, Part Feature, o Part Part2DObject.