Std Group/de: Difference between revisions

From FreeCAD Documentation
(Created page with "== Vererbung ==")
No edit summary
Line 79: Line 79:
{{Caption|Simplified diagram of the relationships between the core objects in the program. The {{incode|App::DocumentObjectGroup}} class is a simple container which uses the Group extension to be able to hold any type of object.}}
{{Caption|Simplified diagram of the relationships between the core objects in the program. The {{incode|App::DocumentObjectGroup}} class is a simple container which uses the Group extension to be able to hold any type of object.}}


==Scripting==
== Skripten ==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">

Revision as of 06:19, 26 July 2020

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

Standard 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 zurkategoriesierung und Organisation der Objekte im Modell verwendet, um eine logische Struktur zu erhalten. Std Gruppen kann 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 Strukturwerkzeugleiste, die in allen Arbeitsbereichen zugänglich ist.

Um 3D-Objekte zu einer einzelnen Einheit zu gruppieren, um Baugruppen zu erzeugen, sollte stattdessen Standard Teil verwendet werden.

Verschiedene Elemente innerhalb Standart Gruppe in der Baumansicht.

Anwendung

  1. Auf den Namen des Dokumentes in der Baumansicht klicken, das Kontextmenü mit einem Rechtsklick öffnen und Erstelle Gruppe wählen.
  2. Oder die Schaltfläche Gruppe in der Strukturwerkzeugleiste betätigen. Es wird eine leere Gruppe erstellt.
  3. Um Objekte einer Gruppe hinzuzufügen, werden sie in der Baumansicht gewählt und mit Drag & Drop auf die Gruppe gezogen.
  4. Um Objekte aus einer Gruppe zu entfernen, werden sie aus der Gruppe auf die Dokumentbezeichnung oben in der Baumansicht gezogen .

Hinweise

  • The Group object does not affect the positions in the 3D view of the elements that it contains; it is essentially just a folder that is used to keep the tree view organized.
  • The Group can also be created from the Python console, and sub-classed to create special "groups", as indicated in the Scripting section.

Eigenschaften

A Std Group is internally called App DocumentObjectGroup (App::DocumentObjectGroup class), and is derived from the basic App DocumentObject (App::DocumentObject class), therefore it shares all the latter's properties.

In addition to the properties described in App FeaturePython, which is the most basic instance of an App DocumentObject, the App DocumentObjectGroup has the DatenGroup property.

These are the properties available in the property editor. Hidden properties can be shown by using the Show all command in the context menu of the property editor.

Daten

Base

  • Daten-EigenschaftBezeichnung (String): der Name dieses Objekts, vom Benutzer als beliebige UTF8-Zeichenkette veränderbar.
  • DatenGruppe (LinkList): eine Liste referenzierter Objekte. Ein leerer Wert [] ist vorgegeben.

Hidden properties Data

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

Ansicht

Base

Siehe App FeaturePython zu grundlegenden Ansichtseigenschaften.

Versteckte Eigenschaften

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

Vererbung

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.

Skripten

Das folgende Kommando erstellt eine Gruppe im aktiven Dokument:

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.

Links