App DocumentObject

From FreeCAD Documentation
Revision as of 22:59, 17 January 2020 by Maker (talk | contribs) (Created page with "Siehe Eigenschaft für alle Eigenschaftstypen, die geskriptete Objekte haben können.")
Other languages:

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.

These are the basic properties that essentially all objects have. These properties can be accessed from the Python console.

  • DatenExpression Engine (ExpressionEngine): a list of expressions.
  • DatenLabel (String): the user editable name of this object, it is an arbitrary UTF8 string. By default, it is the same as the Name.
  • DatenLabel2 (String): a longer, user editable description of this object, it is an arbitrary UTF8 string that may include newlines. By default, it is an empty string "".
  • DatenVisibility (Bool): whether to display the object or not.

For derived objects, only DatenLabel will be listed in the property editor by default. The other properties will be hidden.

Scripting

See also: FreeCAD Scripting Basics, and scripted objects.

See Part Feature for the general information on adding objects to the program.

A DocumentObject is created with the addObject() method of the document. However, in general, there is no need to create this object manually. It is usually better to create one of the sub-classes, for example, App FeaturePython, Part Feature, or Part Part2DObject. 

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::DocumentObject", "Name")
obj.Label = "Custom label"
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=App_DocumentObject/de&oldid=579072"