App DocumentObject/de: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
Line 22: Line 22:
Das [[App_DocumentObject/de|App DocumentObject]] ist eine interne Klasse, kann also weder von der grafischen Oberfläche aus erstellt werden, noch ist sie für sich selbst gedacht. Sie definiert lediglich das grundlegende Verhalten und die Eigenschaften von Objekten im Programm.
Das [[App_DocumentObject/de|App DocumentObject]] ist eine interne Klasse, kann also weder von der grafischen Oberfläche aus erstellt werden, noch ist sie für sich selbst gedacht. Sie definiert lediglich das grundlegende Verhalten und die Eigenschaften von Objekten im Programm.


<div class="mw-translate-fuzzy">
Einige der wichtigsten DocumentObjects sind die folgenden:
Einige der wichtigsten DocumentObjects sind die folgenden:
* Die Klasse [[App_FeaturePython/de|App FeaturePython]], ein leeres Objekt, das je nach den hinzugefügten Eigenschaften für verschiedene Zwecke verwendet werden kann.
* Die Klasse [[App_FeaturePython/de|App FeaturePython]], ein leeres Objekt, das je nach den hinzugefügten Eigenschaften für verschiedene Zwecke verwendet werden kann.
* Die Klasse [[App_GeoFeature/de|App GeoFeature]], das Basisobjekt aller geometrischen Objekte, d.h. von Objekten, die eine Eigenschaft [[Placement/de|Platzierung]] haben, die ihre Position in der [[3D view/de|3D Ansicht]] definiert.
* Die Klasse [[App_GeoFeature/de|App GeoFeature]], das Basisobjekt aller geometrischen Objekte, d.h. von Objekten, die eine Eigenschaft [[Placement/de|Placement]] haben, die ihre Position in der [[3D_view/de|3D-Ansicht]] definiert.
* Die Klasse [[Part_Feature/de|Part Formelement]], abgeleitet von App GeoFeature, und die übergeordnete Klasse von Objekten mit 2D und 3D [[Part_TopoShape/de|topologische Formen]].
* Die Klasse [[Part_Feature/de|Part Feature]] (Part Formelement), abgeleitet von App GeoFeature, und die übergeordnete Klasse von Objekten mit 2- und 3-dimensionalen [[Part_TopoShape/de|topologischen Formen]].
* Die Klasse [[Mesh_Feature/de|Polygonnetz Formelement]], abgeleitet von App GeoFeature, und die übergeordnete Klasse von Objekten mit 2D und 3D [[Mesh_MeshObject/de|Polygonnetze]].
* Die Klasse [[Mesh_Feature/de|Mesh Feature]] (Mesh Formelement), abgeleitet von App GeoFeature, und die übergeordnete Klasse von Objekten mit 2D- und 3D-[[Mesh_MeshObject/de|Polygonnetzen]].
</div>


==Eigenschaften==
==Eigenschaften==

Revision as of 16:48, 26 August 2022

Einleitung

Ein App DocumentObject oder formal ein App::DocumentObject ist die Basisklasse aller im Dokument behandelten Objektklassen.

Allgemein ausgedrückt ist ein "DocumentObject" jedes "Ding", das in der Baumansicht erscheinen kann und das gespeichert und beim Öffnen eines Dokuments wiederhergestellt wird.

Baumansicht, die verschiedene Objekte im Dokument anzeigt. Jedes von ihnen ist ein "Dokumentobjekt", das letztlich von der Basisklasse App::DocumentObject abgeleitet ist.

Vereinfachtes Diagramm der Beziehungen zwischen den Kernobjekten in FreeCAD

Anwendung

Das App DocumentObject ist eine interne Klasse, kann also weder von der grafischen Oberfläche aus erstellt werden, noch ist sie für sich selbst gedacht. Sie definiert lediglich das grundlegende Verhalten und die Eigenschaften von Objekten im Programm.

Einige der wichtigsten DocumentObjects sind die folgenden:

  • Die Klasse App FeaturePython, ein leeres Objekt, das je nach den hinzugefügten Eigenschaften für verschiedene Zwecke verwendet werden kann.
  • Die Klasse App GeoFeature, das Basisobjekt aller geometrischen Objekte, d.h. von Objekten, die eine Eigenschaft Placement haben, die ihre Position in der 3D-Ansicht definiert.
  • Die Klasse Part Feature (Part Formelement), abgeleitet von App GeoFeature, und die übergeordnete Klasse von Objekten mit 2- und 3-dimensionalen topologischen Formen.
  • Die Klasse Mesh Feature (Mesh Formelement), abgeleitet von App GeoFeature, und die übergeordnete Klasse von Objekten mit 2D- und 3D-Polygonnetzen.

Eigenschaften

Siehe Eigenschaft für alle Eigenschaftstypen, die geskriptete Objekte haben können.

Dies sind die grundlegenden Eigenschaften, die im Wesentlichen alle Objekte haben. Auf diese Eigenschaften kann über die Python Konsole zugegriffen werden.

  • Daten-EigenschaftExpression Engine (ExpressionEngine): eine Liste von Ausdrücken.
  • Daten-EigenschaftLabel (String): der vom Benutzer editierbare Name dieses Objekts, es ist ein beliebiger UTF8-String. Standardmäßig ist es derselbe wie der Name.
  • Daten-EigenschaftLabel2 (String): eine längere, vom Benutzer editierbare Beschreibung dieses Objekts, es ist eine beliebige UTF8-Zeichenfolge, der Zeilenumbrüche enthalten kann. Standardmäßig ist es eine leere Zeichenfolge "".
  • Daten-EigenschaftVisibility (Bool): whether to display the object or not.

Für abgeleitete Objekte wird standardmäßig nur Daten-EigenschaftLabel im Eigenschafteneditor aufgelistet. Die anderen Eigenschaften werden ausgeblendet.

Skripten

Siehe Part Formelement für die allgemeinen Informationen über das Hinzufügen von Objekten zum Programm.

Ein DokumentObjekt wird mit der addObject() Methode des Dokuments erstellt. Im Allgemeinen ist es jedoch nicht erforderlich, dieses Objekt zu erstellen. In der Regel ist es besser, eine der komplexeren Klassen unterzuordnen, z.B. App FeaturePython, App GeoFeature, Part Formelement, Part Teil2DObjekt, usw.

import FreeCAD as App

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