Std Group/de: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(41 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/de
{{Docnav/de
|[[Std Part/de|Baugruppe]]
|[[Std_Part/de|Baugruppe]]
|[[PartDesign Body/de|Körper]]
|[[Std_LinkMake/de|LinkMake]]
|[[Std_Base/de|Std Base]]
|[[PartDesign_Workbench/de|PartDesign-Arbeitsbereich]]
|IconL=Std_Part.svg
|IconL=Std_Part.svg
|IconR=Std_LinkMake.svg
|IconC=Workbench_PartDesign.svg
|IconR=PartDesign Body.svg
|IconC=Freecad.svg
}}
}}


Line 18: Line 18:
|SeeAlso=[[Std_Part/de|Standard Teil]], [[Draft_SelectGroup/de|Wähle Gruppe]], [[Draft_AddToGroup/de|zur Gruppe hinzufügen]]}}
|SeeAlso=[[Std_Part/de|Standard Teil]], [[Draft_SelectGroup/de|Wähle Gruppe]], [[Draft_AddToGroup/de|zur Gruppe hinzufügen]]}}


<span id="Description"></span>
==Beschreibung==
==Beschreibung==


[[Std_Group|Standard Gruppe]], intern [[App_DocumentObjectGroup|App DocumentObjectGroup]] genannt, ist ein allgemein verwendeter Behälter für die Gruppierung unterschiedlicher Objekttypen in der [[tree_view|Baumansicht]] unabhängig von ihrem Datentyp. Er wird als einfacher Ordner zurkategoriesierung und Organisation der Objekte im Modell verwendet, um eine logische Struktur zu erhalten. Std Gruppen kann in anderen Std Gruppen eingebettet werden.
Eine [[Std_Group/de|Std Gruppe]], intern [[App_DocumentObjectGroup/de|App-DocumentObjectGroup]] genannt, ist ein allgemein verwendeter Behälter für die Gruppierung unterschiedlicher Objekttypen in der [[Tree_view/de|Baumansicht]], unabhängig von ihrem Datentyp. Er wird als einfacher Ordner zur Kategoriesierung und Organisation der Objekte im Modell verwendet, um eine logische Struktur zu erhalten. Std Gruppen können in anderen Std Gruppen eingebettet werden.


Das Std Group Werkzeug ist nicht durch einen speziellen Arbeitbereich definiert, sondern durch das Basissystem. Daher befindet es sich in der {{MenuCommand|Strukturwerkzeugleiste}}, die in allen [[Workbenches/de|Arbeitsbereichen]] zugänglich ist.
Das Werkzeug Std Group ist nicht durch einen speziellen Arbeitbereich definiert, sondern durch das Basissystem. Daher befindet es sich in der {{MenuCommand|Structure}}-Werkzeugleiste, die in allen [[Workbenches/de|Arbeitsbereichen]] zugänglich ist.


Um 3D-Objekte zu einer einzelnen Einheit zu gruppieren, um Baugruppen zu erzeugen, sollte stattdessen [[Std_Part/de|Standard Teil]] verwendet werden.
Um 3D-Objekte zu einer einzelnen Einheit zu gruppieren und damit eine Baugruppe zu erstellen, sollte stattdessen [[Std_Part/de|Std Teil]] verwendet werden.


[[File:Std_Group_example.png]]
[[File:Std_Group_example.png]]


{{Caption|Verschiedene Elemente innerhalb Standart Gruppe in der Baumansicht.}}
{{Caption|Verschiedene Elemente innerhalb von Std Gruppen in der Baumansicht.}}


<span id="Usage"></span>
==Anwendung==
==Anwendung==


# Es gibt mehrere Möglichkeiten eine Gruppe anzulegen:
# Auf den Namen des Dokumentes in der [[tree_view/de|Baumansicht]] klicken, das Kontextmenü mit einem Rechtsklick öffnen und {{Button|Erstelle Gruppe}} wählen.
#* Ein Rechtsklick auf den Namen des Dokuments in der [[Tree_view/de|Baumansicht]] und im Kontextmenü {{MenuCommand|Gruppe erstellen...}} auswählen.
# Oder die Schaltfläche {{Button|[[Image:Std_Group.svg|16px]] [[Std_Group/de|Gruppe]]}} in der Strukturwerkzeugleiste betätigen. Es wird eine leere Gruppe erstellt.
#* Die Schaltfläche {{Button|[[Image:Std_Group.svg|16px]] [[Std_Group/de|Gruppe erstellen]]}} drücken.
# Um Objekte einer Gruppe hinzuzufügen, werden sie in der [[tree_view/de|Baumansicht]] gewählt und mit Drag & Drop auf die Gruppe gezogen.
# Eine leere Gruppe wird erstellt.
# Um Objekte aus einer Gruppe zu entfernen, werden sie aus der Gruppe auf die Dokumentbezeichnung oben in der [[tree_view/de|Baumansicht]] gezogen .
# Objekte werden einer Gruppe hinzugefügt, indem sie in der [[Tree_view/de|Baumansicht]] ausgewählt und auf die Gruppe gezogen und abgelegt werden.

# Objekte werden aus einer Gruppe entfernt, indem sie aus der Gruppe herausgezogen und auf der Dokumentbezeichnung ganz oben in der [[Tree_view/de|Baumansicht]] abgelegt werden.
=== Hinweise ===
# Objekte können auch hinzugefügt und entfernt werden, indem die {{PropertyData/de|Group}} der Gruppe bearbeitet wird.

* Das Gruppenobjekt beeinflusst nicht die Positionen der enthaltenen Elemente in der [[3D_view/de|3D-Ansicht]]. Im wesentlichen ist es nur ein Ordner zur Organisation der [[tree_view/de|Baumansicht]].
* Die Gruppe kann auch aus der [[Python console/de|Pythonkonsole]] als Unterklasse erstellt werden, um besondere "Grupppen" zu erzeugen, wie im Abschnitt [[Std_Group/de#Skripten|Skripten]] dargestellt.


<span id="Properties"></span>
==Eigenschaften==
==Eigenschaften==


Eine [[Std_Group/de|Std Group]] wird intern [[App_DocumentObjectGroup|App DocumentObjectGroup]] ({{incode|App::DocumentObjectGroup}} Klasse) genannt und stammt aus einer [[App_DocumentObject/de|Anwendung DokumentObjekt]] ({{incode|App::DocumentObject}} Klasse). Deshalb hat es die meisten Eigenschaften mit letzterem gemein.
Die [[Std_Group/de|Std Gruppe]] wird intern [[App_DocumentObjectGroup/de|App-DocumentObjectGroup]] genannt (Klasse {{incode|App::DocumentObjectGroup}}) und wird von einem [[App_DocumentObject/de|App-DocumentObject]] (Klasse {{incode|App::DocumentObject}}) abgeleitet und erbt all seine Eigenschaften.

In addition to the properties described in [[App_FeaturePython|App FeaturePython]], which is the most basic instance of an [[App_DocumentObject|App DocumentObject]], the App DocumentObjectGroup has the {{PropertyData|Group}} property.


Die Std Gruppe hat dieselben Eigenschaften wie ein [[App_FeaturePython/de#Eigenschaften|App-FeaturePython]], das die grundlegendste Instanz eines [[App_DocumentObject/de|App-DocumentObject]]s ist. Es zeigt auch die folgenden zusätzlichen Eigenschaften im [[Property_editor/de|Eigenschafteneditor]]. Verdeckte Eigenschaften können mit dem Befehl {{MenuCommand|Alle anzeigen}} im Kontextmenü des [[Property_editor|Eigenschafteneditors]] angezeigt werden.
These are the properties available in the [[property editor|property editor]]. Hidden properties can be shown by using the {{MenuCommand|Show all}} command in the context menu of the [[property editor|property editor]].


<span id="Data"></span>
=== Daten ===
=== Daten ===


{{TitleProperty|Base}}
{{TitleProperty|Base}}


* {{PropertyData/de|Bezeichnung|String}}: der Name dieses Objekts, vom Benutzer als beliebige UTF8-Zeichenkette veränderbar.
* {{PropertyData/de|Group|LinkList}}: Eine Liste referenzierter Objekte. Voreingestellt ist eine leere Liste {{value|[]}}.
* {{PropertyData|Gruppe|LinkList}}: eine Liste referenzierter Objekte. Ein leerer Wert {{value|[]}} ist vorgegeben.
* {{PropertyData/de|_ Group Touched|Bool|Hidden}}: Gibt an, ob die Gruppe -?- (touched) ist oder nicht.


<span id="Scripting"></span>
==== Ausgeblendete Dateneigenschaften ====
== Skripten ==


{{Emphasis|Siehe auch:}} [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]] und [[Scripted_objects/de|Skriptgenerierte Objekte]].
* {{PropertyView/de|Proxy|PythonObject}}: eine benutzerdefinierte Klasse, die mit diesem Objekt verknüpft ist. Das gibt es nur für die [[Python/de|Python]] Version. Siehe [[Std_Group/de#Skripten|Skripten]].


Siehe [[Part_Feature/de|Part Formelemente]] zu allgemeinen Informationen über das Hinzufügen von Objekten zum Dokument.
=== Ansicht ===


Eine 'Std Gruppe' ([[App_DocumentObjectGroup/de|App-DocumentObjectGroup]]) wird mit der Methode {{incode|addObject()}} des Dokuments erstellt. Sobald eine Gruppe existiert, können weitere Objekte mit den Methoden {{incode|addObject()}} oder {{incode|addObjects()}} zur Gruppe hinzugefügt werden.
{{TitleProperty|Base}}

Siehe [[App_FeaturePython/de|App FeaturePython]] zu grundlegenden Ansichtseigenschaften.

==== Ansicht ausgeblendeter Eigenschaften ====

* {{PropertyView|Proxy|PythonObject}}: eine benutzerdefinierte Providerklasse, die mit diesem Objekt verknüpft ist. Das gibt es nur für die [[Python/de|Python]] Version. Siehe [[Std_Group/de#Skripten|Skripten]].

== Vererbung ==

[[Std Group/de|Standard Gruppe]] ist formell eine Instanz der Klasse {{incode|App::DocumentObjectGroup}}, deren Elternteil die Basisklasse [[App_DocumentObject|App DocumentObject]]({{incode|App::DocumentObject}}) ist und um eine Gruppen-Erweiterung erweitert wird.

[[File:FreeCAD_core_objects.svg|800px]]

{{Caption|Vereinfachtes Diagramm der Beziehungen zwischen den Kernobjekten im Programm. Die {{incode|App::DocumentObjectGroup}} Klasse ist ein einfacher Behälter der der die Gruppenerweiterung nutzt, um alle Typen von Objekten aufzunehmen.}}

== Skripten ==

{{Emphasis|Siehe auch:}} [[FreeCAD Scripting Basics/de|FreeCAD Grundlagen Skripten]] und [[scripted objects/de|Skriptgenerierte Objekte]].

Siehe [[Part_Feature/de|Part Formelemente]] zu allgemeinen Informationen über das Hinzufügen von Objekten zum Dokument.


A Std Group ([[App_DocumentObjectGroup|App DocumentObjectGroup]]) is created with the {{incode|addObject()}} method of the document. Once a Group exists, other objects can be added to it with the {{incode|addObject()}} or {{incode|addObjects()}} methods of this Group.
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App


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


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


obj.addObjects([bod1, bod2])
group.addObjects([obj1, obj2])
App.ActiveDocument.recompute()
App.ActiveDocument.recompute()
}}
}}


This basic {{incode|App::DocumentObjectGroup}} doesn't have a Proxy object so it can't be fully used for sub-classing.
Diese grundlegende {{incode|App::DocumentObjectGroup}} hat kein Proxyobjekt und kann daher nicht vollständig zur Erstellung von Unterklassen verwendet werden.


Therefore, for [[Python|Python]] subclassing, you should create the {{incode|App::DocumentObjectGroupPython}} object.
Für die Instanziierung von Unterklassen mit [[Python/de|Python]] sollte ein {{incode|App::DocumentObjectGroupPython}}-Objekt erstellt werden.


{{Code|code=
{{Code|code=
Line 111: Line 91:
}}
}}


For example, a [[FEM Analysis|FEM Analysis]] is an {{incode|App::DocumentObjectGroupPython}} object with a custom icon and additional properties.
Zum Beispiel ist ein [[FEM Analysis/de|FEM Analyse]] ein {{incode|App::DocumentObjectGroupPython}}-Objekt mit einem benutzerdefinierten Icon und zusätzlichen Eigenschaften.


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


Line 121: Line 102:


{{Docnav/de
{{Docnav/de
|[[Std Part/de|Baugruppe]]
|[[Std_Part/de|Baugruppe]]
|[[PartDesign Body/de|Körper erstellen]]
|[[Std_LinkMake/de|LinkMake]]
|[[Std_Base/de|Std Base]]
|[[PartDesign_Workbench/de|PartDesign-Arbeitsbereich]]
|IconL=Std_Part.svg
|IconL=Std_Part.svg
|IconR=Std_LinkMake.svg
|IconC=Workbench_PartDesign.svg
|IconR=PartDesign Body.svg
|IconC=Freecad.svg
}}
}}


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


{{Std Base navi{{#translation:}}}}

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

Latest revision as of 14:59, 3 February 2023

Std Gruppe

Menüeintrag
Baumansicht → Rechtsklick auf den Dokumentennamen
Arbeitsbereich
Alle
Standardtastenkürzel
Keiner
Eingeführt in Version
-
Siehe auch
Standard Teil, Wähle Gruppe, zur Gruppe hinzufügen

Beschreibung

Eine Std Gruppe, intern App-DocumentObjectGroup genannt, ist ein allgemein verwendeter Behälter für die Gruppierung unterschiedlicher Objekttypen in der Baumansicht, unabhängig von ihrem Datentyp. Er wird als einfacher Ordner zur Kategoriesierung und Organisation der Objekte im Modell verwendet, um eine logische Struktur zu erhalten. Std Gruppen können in anderen Std Gruppen eingebettet werden.

Das Werkzeug Std Group ist nicht durch einen speziellen Arbeitbereich definiert, sondern durch das Basissystem. Daher befindet es sich in der Structure-Werkzeugleiste, die in allen Arbeitsbereichen zugänglich ist.

Um 3D-Objekte zu einer einzelnen Einheit zu gruppieren und damit eine Baugruppe zu erstellen, sollte stattdessen Std Teil verwendet werden.

Verschiedene Elemente innerhalb von Std Gruppen in der Baumansicht.

Anwendung

  1. Es gibt mehrere Möglichkeiten eine Gruppe anzulegen:
    • Ein Rechtsklick auf den Namen des Dokuments in der Baumansicht und im Kontextmenü Gruppe erstellen... auswählen.
    • Die Schaltfläche Gruppe erstellen drücken.
  2. Eine leere Gruppe wird erstellt.
  3. Objekte werden einer Gruppe hinzugefügt, indem sie in der Baumansicht ausgewählt und auf die Gruppe gezogen und abgelegt werden.
  4. Objekte werden aus einer Gruppe entfernt, indem sie aus der Gruppe herausgezogen und auf der Dokumentbezeichnung ganz oben in der Baumansicht abgelegt werden.
  5. Objekte können auch hinzugefügt und entfernt werden, indem die Daten-EigenschaftGroup der Gruppe bearbeitet wird.

Eigenschaften

Die Std Gruppe wird intern App-DocumentObjectGroup genannt (Klasse App::DocumentObjectGroup) und wird von einem App-DocumentObject (Klasse App::DocumentObject) abgeleitet und erbt all seine Eigenschaften.

Die Std Gruppe hat dieselben Eigenschaften wie ein App-FeaturePython, das die grundlegendste Instanz eines App-DocumentObjects ist. Es zeigt auch die folgenden zusätzlichen Eigenschaften im Eigenschafteneditor. Verdeckte Eigenschaften können mit dem Befehl Alle anzeigen im Kontextmenü des Eigenschafteneditors angezeigt werden.

Daten

Base

  • Daten-EigenschaftGroup (LinkList): Eine Liste referenzierter Objekte. Voreingestellt ist eine leere Liste [].
  • Daten-Eigenschaft (versteckt)_ Group Touched (Bool): Gibt an, ob die Gruppe -?- (touched) ist oder nicht.

Skripten

Siehe auch: FreeCAD Grundlagen Skripten und Skriptgenerierte Objekte.

Siehe Part Formelemente zu allgemeinen Informationen über das Hinzufügen von Objekten zum Dokument.

Eine 'Std Gruppe' (App-DocumentObjectGroup) wird mit der Methode addObject() des Dokuments erstellt. Sobald eine Gruppe existiert, können weitere Objekte mit den Methoden addObject() oder addObjects() zur Gruppe hinzugefügt werden.

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()

Diese grundlegende App::DocumentObjectGroup hat kein Proxyobjekt und kann daher nicht vollständig zur Erstellung von Unterklassen verwendet werden.

Für die Instanziierung von Unterklassen mit Python sollte ein App::DocumentObjectGroupPython-Objekt erstellt werden.

import FreeCAD as App

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

Zum Beispiel ist ein FEM Analyse ein App::DocumentObjectGroupPython-Objekt mit einem benutzerdefinierten Icon und zusätzlichen Eigenschaften.

Verweise