Std Group/it: Difference between revisions

From FreeCAD Documentation
(Created page with "Questo comando consente di creare un gruppo nella vista ad albero. <br /> Può essere utilizzato per organizzare la struttura del modello.")
No edit summary
 
(107 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
{{Docnav/it
|[[Std_Part/it|Parte]]
|[[Std_LinkMake/it|Crea link]]
|[[Std_Base/it|Menu di Base]]
|IconL=Std_Part.svg
|IconR=Std_LinkMake.svg
|IconC=Freecad.svg
}}


{{GuiCommand/it
|Name=Std_Group|Name/it=Crea Gruppo
|MenuLocation=Vista ad albero → Cliccare col destro sul nome del documento → Crea gruppo
||Workbenches=Tutti
|Shortcut=
|Version=
|SeeAlso=[[Std_Part/it|Parte]], [[Draft_SelectGroup/it|Seleziona gruppo]], [[Draft_AddToGroup/it|Aggiungi al gruppo]]
}}


<span id="Description"></span>
{{GuiCommand/it|Name=Std_Group|Name/it=Crea Gruppo|MenuLocation=Vista struttura → Cliccare col destro sul nome del documento||Workbenches=Tutti|Shortcut=|SeeAlso=[[Draft_SelectGroup/it|Seleziona gruppo]], [[Draft_AddToGroup/it|Aggiungi al gruppo]]}}

==Descrizione==
==Descrizione==


Un [[Std_Group/it|Gruppo]] (chiamato internamente [[App_DocumentObjectGroup/it|App DocumentObjectGroup]]) è un contenitore per scopi generici che consente di raggruppare diversi tipi di oggetti nella [[Tree_view/it|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 possono essere nidificati all'interno di altri gruppi.


Lo strumento Gruppo non è definito da un particolare ambiente di lavoro, ma dal sistema base; di conseguenza lo si ritrova nella {{MenuCommand|barra degli strumenti struttura}}, che è disponibile in tutti gli [[Workbenches/it|ambienti di lavoro]].
Questo comando consente di creare un gruppo nella vista ad albero.
<br />
Può essere utilizzato per organizzare la struttura del modello.


Per raggruppare gli oggetti 3D come una singola unità, con l'intenzione di creare degli assiemi, utilizzare [[Std_Part/it|Parte]].
==Use==


[[File:Std_Group_example.png]]


{{Caption|Vari elementi all'interno di Gruppo nella vista ad albero.}}
Right-click on the name of your FreeCAD-document in the tree-view and choose "create group".
<br />
A group will be created automatically and give the icon of a directory and an automatically chosen name.
<br />
You can rename the group by right-clicking on the group and choosing "rename" or using "F2" on your keyboard.
<br />
Push FreeCAD-objects into the group or pull them out of the group by clicking on the desired object,
<br />
keep left-mouse button pressed and using drag&drop-style to drag the object to desired new location.
<br />
As long as there is a "circle with a diagonal line"-sign below the cursor you can't drop your object here.
<br />
As soon as the sign changes to a "plus"-symbol it is possible to drop your object here.
<br />


<span id="Usage"></span>
# Right click on active document or on existing group in the [[Document structure|Tree View]] and select {{KEY|Create Group...}}
==Utilizzo==
# Drag-n-drop objects into the group


# Effettuare una delle seguenti operazioni:
#* Fare clic con il pulsante destro del mouse sul nome del documento nella [[Tree_view|Vista ad albero]] e nel menu contestuale scegliere {{MenuCommand|Crea gruppo...}}.
#* Premere il pulsante {{Button|[[Image:Std_Group.svg|16px]] [[Std_Group|Crea gruppo]]}}.
# Viene creato un gruppo vuoto.
# Per aggiungere oggetti al gruppo, selezionarli nella [[Tree_view|Vista ad albero]] e trascinarli e rilasciarli nel gruppo.
# Per rimuovere gli oggetti dal gruppo, trascinarli fuori dal gruppo e sull'etichetta del documento nella parte superiore della [[Tree_view|Vista ad albero]].
# Gli oggetti possono anche essere aggiunti e rimossi modificando la proprietà {{PropertyData|Group}} del gruppo.


<span id="Properties"></span>
[[Image:group_with_objects.png|300px]]
== Proprietà ==


Il [[Std_Group/it|Gruppo]] è internamente chiamato [[App_DocumentObjectGroup/it|App DocumentObjectGroup]] ({{incode|App::DocumentObjectGroup}} class), è derivato dall'oggetto base [[App_DocumentObject/it|App DocumentObject]] ({{incode|App::DocumentObject}} class), pertanto eredita tutte le sue proprietà.
==Options==


Il Gruppo ha le stesse proprietà di [[App_FeaturePython/it#Proprietà|App FeaturePython]], che è l'istanza più semplice di un [[App_DocumentObject/it|App DocumentObject]]. Ha anche le seguenti proprietà aggiuntive nell'[[Property_editor/it|editor di proprietà]]. Le proprietà nascoste possono essere visualizzate utilizzando il comando {{MenuCommand|Mostra tutto}} nel menu contestuale dell'[[Property_editor/it|editor di proprietà]].
* To rename the group select a group and press {{KEY|F2}}, or right click a group and select {{KEY|Rename}}


<span id="Data"></span>
==Properties==
=== Dati ===


{{TitleProperty|Base}}
* {{PropertyData|Label}}: Name of the group


* {{PropertyData|Group|LinkList}}: un elenco di oggetti referenziati. Per impostazione predefinita, è vuoto {{value|[]}}.
==Scripting==
* {{PropertyData|_ Group Touched|Bool|Hidden}}: se il gruppo è touched o meno.


<span id="Scripting"></span>
Following command adds new group to the active document:
== Script ==

{{Emphasis|Vedere anche:}} [[FreeCAD_Scripting_Basics/it|Script di base per FreeCAD]], e [[Scripted_objects/it|script di oggetti]].

Vedi [[Part_Feature/it|Funzione Part]] per le informazioni generali su come aggiungere oggetti al documento.

Un Gruppo ([[App_DocumentObjectGroup|App DocumentObjectGroup]]) è creato con il metodo del documento {{incode|addObject()}}. Una volta che un Gruppo esiste, altri oggetti possono essere aggiunti ad esso con i metodi {{incode|addObject()}} o {{incode|addObjects()}}.


{{Code|code=
{{Code|code=
import FreeCAD as App
App.ActiveDocument.addObject("App::DocumentObjectGroup","Group")

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

obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")

group.addObjects([obj1, obj2])
App.ActiveDocument.recompute()
}}
}}
==Limitations==


Questo {{incode|App::DocumentObjectGroup}} di base non ha un oggetto Proxy, quindi non può essere pienamente utilizzato per la sotto-classe.
Command needs an open FreeCAD-document to work.


Per la sottoclasse [[Python/it|Python]], è necessario creare un oggetto {{incode|App::DocumentObjectGroupPython}}.
==Links==


{{Code|code=
* [[Arch tutorial#Organizing your model|Use case in Arch Tutorial]]
import FreeCAD as App
* [[Document_structure|Document structure]]
* [http://www.freecadweb.org/wiki/index.php?title=Arch_tutorial#Organizing_your_model Organizing your model]
* [[Ways_To_Organize_Objects|Organize objects in the document]]


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


Per esempio, un [[FEM Analysis/it|Analisi FEM]] è un oggetto {{incode|App::DocumentObjectGroupPython}} con un'icona personalizzata e proprietà aggiuntive.


<span id="Links"></span>
==Link==


* [[Arch tutorial/it#Organizzare il modello|Esempio di utilizzo in Arch Tutorial]]
{{clear}}
* [[Document_structure/it|Struttura del documento]]
<languages/>
* [http://www.freecadweb.org/wiki/index.php?title=Arch_tutorial#Organizing_your_model Esempio di organizzazione del modello]


{{Docnav/it
|[[Std_Part/it|Parte]]
|[[Std_LinkMake/it|Crea link]]
|[[Std_Base/it|Menu di Base]]
|IconL=Std_Part.svg
|IconR=Std_LinkMake.svg
|IconC=Freecad.svg
}}

{{Std_Base_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 13:51, 18 June 2023

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
Parte, Seleziona gruppo, Aggiungi al gruppo

Descrizione

Un Gruppo (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 possono essere nidificati all'interno di altri gruppi.

Lo strumento Gruppo 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.

Vari elementi all'interno di Gruppo nella vista ad albero.

Utilizzo

  1. Effettuare una delle seguenti operazioni:
    • Fare clic con il pulsante destro del mouse sul nome del documento nella Vista ad albero e nel menu contestuale scegliere Crea gruppo....
    • Premere il pulsante Crea gruppo.
  2. Viene creato un gruppo vuoto.
  3. Per aggiungere oggetti al gruppo, selezionarli nella Vista ad albero e trascinarli e rilasciarli nel gruppo.
  4. Per rimuovere gli oggetti dal gruppo, trascinarli fuori dal gruppo e sull'etichetta del documento nella parte superiore della Vista ad albero.
  5. Gli oggetti possono anche essere aggiunti e rimossi modificando la proprietà DatiGroup del gruppo.

Proprietà

Il Gruppo è internamente chiamato App DocumentObjectGroup (App::DocumentObjectGroup class), è derivato dall'oggetto base App DocumentObject (App::DocumentObject class), pertanto eredita tutte le sue proprietà.

Il Gruppo ha le stesse proprietà di App FeaturePython, che è l'istanza più semplice di un App DocumentObject. Ha anche le seguenti proprietà aggiuntive nell'editor di proprietà. Le proprietà nascoste possono essere visualizzate utilizzando il comando Mostra tutto nel menu contestuale dell'editor di proprietà.

Dati

Base

  • DatiGroup (LinkList): un elenco di oggetti referenziati. Per impostazione predefinita, è vuoto [].
  • Dati (Hidden)_ Group Touched (Bool): se il gruppo è touched o meno.

Script

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

Vedi Funzione Part per le informazioni generali su come aggiungere oggetti al documento.

Un Gruppo (App DocumentObjectGroup) è creato con il metodo del documento addObject(). Una volta che un Gruppo esiste, altri oggetti possono essere aggiunti ad esso con i metodi addObject() o addObjects().

import FreeCAD as App

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

obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")

group.addObjects([obj1, obj2])
App.ActiveDocument.recompute()

Questo App::DocumentObjectGroup di base non ha un oggetto Proxy, quindi non può essere pienamente utilizzato per la sotto-classe.

Per la sottoclasse Python, è necessario creare un oggetto App::DocumentObjectGroupPython.

import FreeCAD as App

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

Per esempio, un Analisi FEM è un oggetto App::DocumentObjectGroupPython con un'icona personalizzata e proprietà aggiuntive.

Link