Donate

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, es kann daher nicht von der grafischen Oberfläche aus erstellt werden. Es ist auch nicht dafür vorgesehen, selbst eingesetzt zu werden. Es definiert lediglich das grundlegende Verhalten und die Eigenschaften von Objekten im Programm.

Einige der wichtigsten Dokumentobjekte 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 besitzen, die ihre Position in der 3D-Ansicht bestimmt.
• Die Klasse Part Feature (Part-Formelement), abgeleitet vom App GeoFeature, ist die übergeordnete Klasse von Objekten mit 2D- und 3D-TopoFormen.
• Die Klasse Mesh Feature (Mesh-Formelement), abgeleitet von App GeoFeature, ist die übergeordnete Klasse von Objekten mit 2D- und 3D-Netzobjekten.

Eigenschaften

Siehe Objekteigenschaften für alle Arten von Eigenschaften, die skriptgenerierte Objekte besitzen können.

Siehe Part-Formelement für Erklärungen zu den folgend gelisteten Eigenschaften.

Daten

Base

• Daten-EigenschaftLabel (String)
• Daten-Eigenschaft (ausgeblendet)Label2 (String)
• Daten-Eigenschaft (ausgeblendet)Expression Engine (ExpressionEngine)
• Daten-Eigenschaft (ausgeblendet)Visibility (Bool)

Skripten

Siehe auch: Grundlagen der Skripterstellung in FreeCAD und Skriptgenerierte Objekte.

Siehe Part Formelement für allgemeine Informationen zum Hinzufügen von Objekten zu einem Dokument.

Ein Dokumentobjekt wird mit der Methode addObject() des Dokuments erstellt. Im Allgemeinen ist es jedoch nicht erforderlich, dieses Objekt von Hand zu erstellen. In der Regel ist es besser, eine der komplexeren Klassen als Unterklasse abzuleiten, z.B. App FeaturePython, App GeoFeature, Part Feature, Part Part2DObjekt, usw.

import FreeCAD as App

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