App DocumentObject/de: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Userdocnavi/de}}")
No edit summary
Line 5: Line 5:
[[File:Px.svg|32px]]
[[File:Px.svg|32px]]


Ein Objekt [[App_DocumentObject|Anwendung DokumentObjekt]] oder formal ein {{incode|App::DocumentObject}} ist die Basisklasse aller im Dokument behandelten Objektklassen.
Ein Objekt [[App_DocumentObject/de|Anwendung DokumentObjekt]] oder formal ein {{incode|App::DocumentObject}} ist die Basisklasse aller im Dokument behandelten Objektklassen.


Im Allgemeinen ist ein "Dokumentobjekt" jedes "Ding", das in der [[tree view/de|Baumansicht]] erscheinen kann und das beim Öffnen eines Dokuments gespeichert und wiederhergestellt wird.
Im Allgemeinen ist ein "Dokumentobjekt" jedes "Ding", das in der [[tree view/de|Baumansicht]] erscheinen kann und das beim Öffnen eines Dokuments gespeichert und wiederhergestellt wird.

Revision as of 03:19, 18 January 2020

Einleitung

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

Im Allgemeinen ist ein "Dokumentobjekt" jedes "Ding", das in der Baumansicht erscheinen kann und das beim Öffnen eines Dokuments gespeichert und wiederhergestellt wird.

Baumansicht mit verschiedenen Objekten im Dokument. Jedes von ihnen wird letztlich abgeleitet aus der App::DocumentObject Klasse.

Vereinfachtes Diagramm der Beziehungen zwischen den Kernobjekten im Programm. Die Klasse App::DocumentObject ist die Basisklasse von im Wesentlichen allen Objekten in der Software.

Kurzanleitung

Das Anwendung DokumentObjekt 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 in der Software.

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 Platzierung haben, die ihre Position in der 3D Ansicht definiert.
  • Die Klasse Part Feature, abgeleitet von App GeoFeature, und die übergeordnete Klasse von Objekten mit 2D und 3D topologische Formen.
  • Die Klasse Mesh Feature, abgeleitet von App GeoFeature, und die übergeordnete Klasse von Objekten mit 2D und 3D meshes.

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.

  • DatenExpression Engine/de (ExpressionEngine): eine Liste von Ausdrücken.
  • DatenLabel (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 auch: FreeCAD Skripten Grundlagen, und geskriptete Objekte.

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

Ein DokumentObjekt wird mit der Methode addObject() des Dokuments erstellt. In der Regel ist es jedoch nicht notwendig, dieses Objekt manuell zu erstellen. In der Regel ist es besser, eine der Unterklassen zu erstellen, zum Beispiel App FeaturePython, Part Feature oder Part Part2DObject.

import FreeCAD as App

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