Std Gruppe

From FreeCAD Documentation
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
This page is a translated version of the page Std Group and the translation is 100% complete.

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