Std Group/it: Difference between revisions

From FreeCAD Documentation
(Created page with "=== Dati ===")
(Created page with "====Proprietà dati nascoste====")
Line 57: Line 57:
* {{PropertyData|Group|LinkList}}: un elenco di oggetti referenziati. Di default, è vuoto {{value|[]}}.
* {{PropertyData|Group|LinkList}}: un elenco di oggetti referenziati. Di default, è vuoto {{value|[]}}.


====Proprietà dati nascoste====
==== Hidden properties Data ====


* {{PropertyData|Proxy|PythonObject}}: a custom class associated with this object. This only exists for the [[Python|Python]] version. See [[Std_Group#Scripting|Scripting]].
* {{PropertyData|Proxy|PythonObject}}: a custom class associated with this object. This only exists for the [[Python|Python]] version. See [[Std_Group#Scripting|Scripting]].

Revision as of 21:16, 15 December 2020

Crea Gruppo

Posizione nel menu
Vista ad albero → Cliccare col destro sul nome del documento → Crea gruppo
Ambiente
Tutti
Avvio veloce
Nessuno
Introdotto nella versione
-
Vedere anche
Std Part, Seleziona gruppo, Aggiungi al gruppo

Descrizione

Un Std Group (chiamato internamente App DocumentObjectGroup) è un contenitore per scopi generici che consente di raggruppare diversi tipi di oggetti nella vista ad albero, indipendentemente dal tipo di dati. È usato come una semplice cartella per classificare e organizzare gli oggetti nel modello, al fine di mantenere una struttura logica. I gruppi standard possono essere nidificati all'interno di altri gruppi standard.

Lo strumento Gruppo standard non è definito da un particolare ambiente di lavoro, ma dal sistema base; di conseguenza lo si ritrova nella barra degli strumenti struttura, che è disponibile in tutti gli ambienti di lavoro.

Per raggruppare gli oggetti 3D come una singola unità, con l'intenzione di creare degli assiemi, utilizzare Parte standard.

Vari elementi all'interno di Std Group nella vista ad albero.

Utilizzo

  1. Fare clic sul nome del documento nella vista ad albero, aprire il menu di scelta rapida (clic con il tasto destro) e scegliere Crea gruppo.
  2. In alternativa premere il pulsante Gruppo nella barra degli strumenti della struttura. Viene creato un gruppo vuoto.
  3. Per aggiungere degli oggetti a un gruppo, selezionarli nella vista ad albero, quindi trascinarli e rilasciarli sul gruppo.
  4. Per rimuovere degli oggetti da un gruppo, trascinarli fuori dal gruppo, sull'etichetta del documento nella parte superiore della vista ad albero.

Note

  • L'oggetto Gruppo non influisce sulle posizioni nella Vista 3D degli elementi che contiene; è essenzialmente solo una cartella che viene utilizzata per mantenere organizzata la vista ad albero.
  • Il Gruppo può anche essere creato nella Python console e sotto-classificato per creare speciali "gruppi" come indicato nella sezione Script.

Proprietà

Un Gruppo standard è internamente chiamato App DocumentObjectGroup (App::DocumentObjectGroup class), è derivato dall'oggetto base App DocumentObject (App::DocumentObject class), pertanto condivide tutte le proprietà di quest'ultimo.

Oltre alle proprietà descritte in App FeaturePython, che è l'istanza più elementare di un App DocumentObject, l'App DocumentObjectGroup ha la proprietà DatiGroup.

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

Dati

Base

  • DatiLabel (String): il nome modificabile dall'utente di questo oggetto, è una stringa UTF8 arbitraria.
  • DatiGroup (LinkList): un elenco di oggetti referenziati. Di default, è vuoto [].

Proprietà dati nascoste

  • DatiProxy (PythonObject): a custom class associated with this object. This only exists for the Python version. See Scripting.

View

Base

See App FeaturePython for the basic view properties.

Hidden properties View

  • VistaProxy (PythonObject): a custom view provider class associated with this object. This only exists for the Python version. See Scripting.

Inheritance

A Std Group is formally an instance of the class App::DocumentObjectGroup, whose parent is the basic App DocumentObject (App::DocumentObject class), and is augmented with a Group extension.

Simplified diagram of the relationships between the core objects in the program. The App::DocumentObjectGroup class is a simple container which uses the Group extension to be able to hold any type of object.

Script

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

See Part Feature for the general information on adding objects to the document.

A Std Group (App DocumentObjectGroup) is created with the addObject() method of the document. Once a Group exists, other objects can be added to it with the addObject() or addObjects() methods of this Group.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::DocumentObjectGroup", "Group")

bod1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
bod2 = App.ActiveDocument.addObject("Part::Box", "Box")

obj.addObjects([bod1, bod2])
App.ActiveDocument.recompute()

This basic App::DocumentObjectGroup doesn't have a Proxy object so it can't be fully used for sub-classing.

Therefore, for Python subclassing, you should create the App::DocumentObjectGroupPython object.

import FreeCAD as App

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

For example, a FEM Analysis is an App::DocumentObjectGroupPython object with a custom icon and additional properties.

Link