App FeaturePython
Einführung
Ein Anwendung FormelementPython Objekt oder formal ein App::FeaturePython
, ist eine einfache Instanz des Anwendung DokumentObjekt in Python.
Hierbei handelt es sich um ein einfaches Objekt, das standardmäßig nicht viele Eigenschaften hat, z.B. weder Platzierung noch topologische Form. Dieses Objekt ist für allgemeine Zwecke bestimmt; je nach den Eigenschaften, die ihm zugeordnet sind, kann es zur Verwaltung verschiedener Datentypen verwendet werden.
Vereinfachtes Diagramm der Beziehungen zwischen den Kernobjekten im Programm. Die Klasse App::FeaturePython
ist eine einfache Implementierung der Klasse App::DocumentObject
, die für jeden Zweck verwendet werden kann, da sie standardmäßig keinen TopoForm hat.
Anwendung
Die Anwendung FormelementPython ist ein internes Objekt, so dass es nicht über die grafische Oberfläche erstellt werden kann. Es ist dazu gedacht, durch Klassen unterteilt zu werden, die verschiedene Arten von Daten verarbeiten.
Siehe Skripten für weitere Information.
Eigenschaften
Eine Anwendung FormelementPython (App::DocumentObjectGroup
Klasse) stammt aus einer Anwendung DokumentObjekt (App::DocumentObject
Klasse). Deshalb hat es die meisten Eigenschaften mit letzterem gemein.
Zusätzlich zu den in Anwendung DokumentObjekt beschriebenen Eigenschaften verfügt FormelementPython über einen grundlegenden Ansichtsanbieter, so dass es in der Baumansicht angezeigt wird.
Siehe Eigenschaft für alle Eigenschaftstypen, die geskriptete Objekte haben können.
Diese Eigenschaften stehen im Eigenschaftseditor zur Verfügung. Versteckte Eigenschaften werden durch den Befehl Alle anzeigen im Kontextmenü des Eigenschaftseditors angezeigt.
Daten
- Daten (Hidden)Proxy (
PythonObject
): a custom class associated with this object. - DatenLabel (
String
): der Nutzer editierbare Name dieses Objekts, es ist eine arbitrary UTF8 Zeichenfolge. - DatenLabel2 (
String
): eine längere, vom Benutzer bearbeitbare Beschreibung dieses Objekts, es ist eine beliebige UTF8 Zeichenkette, die Zeilenumbrüche enthalten kann. Standardmäßig ist es eine leere Zeichenkette""
. - DatenProxy (
PythonObject
): eine benutzerdefinierte Klasse, die mit diesem Objekt verknüpft ist. - Daten (Hidden)Visibility (
Bool
): ob das Objekt angezeigt werden soll oder nicht.
Ansicht
Diese Eigenschaften entsprechen den grundlegenden Eigenschaften der Basis Ansichtsanbieter, Gui::ViewProviderDocumentObject
, die von allen Ansichtsanbietern in der Software geerbt wird.
Basis
- Ansicht (Hidden)Proxy (
PythonObject
): a custom view provider class associated with this object. This property only exist for those classes that are able to assign a custom class.
- AnsichtDisplay Mode (
Aufzählung
): sie ist standardmäßig leer. - AnsichtOn Top When Selected (
Aufzählung
):Deaktiviert
(Standard),Aktiviert
,Objekt
,Element
. - AnsichtSelection Style (
Aufzählung
):Form
(Standard),BindungBox
. Wenn die Option istForm
, die ganze Form (Knoten, Ecken, und Flächen) wird dies hervorgehoben in der 3D Ansicht; wenn dies istBindungBox
nur die BindungBox wird hervorgehoben sein. - AnsichtShow In Tree (
Bool
): wenn diestrue
ist, erscheint das Objekt in der Baumansicht. Andernfalls wird sie als ausgeblendet gesetzt. - AnsichtVisibility (
Bool
): wenn diestrue
ist, erscheint das Objekt in der Baumansicht. Andernfalls wird sie als ausgeblendet gesetzt. Standardmäßig kann diese Eigenschaft durch Drücken der Leertaste Leiste in der Tastatur ein- und ausgeschaltet werden.
Selection
- AnsichtOn Top When Selected (
Enumeration
): it controls the way in which the selection occurs in the 3D view if the object has a Shape, and there are many objects partially covered by others. It defaults toDisabled
, meaning that no special highlighting will occur;Enabled
means that the object will appear on top of any other object when selected;Object
means that the object will appear on top only if the entire object is selected in the tree view;Element
means that the object will appear on top only if a subelement (vertex, edge, face) is selected in the 3D view. - AnsichtSelection Style (
Enumeration
): it controls the way the object is highlighted if it has a Shape. If it isShape
, the entire shape (vertices, edges, and faces) will be highlighted in the 3D view; if it isBoundBox
a bounding box will appear surrounding the object and will be highlighted.
Skripten
Siehe auch: FreeCAD Skripten Grundlagen, und geskriptete Objekte.
Siehe Part Formelement für die allgemeinen Informationen über das Hinzufügen von Objekten zum Programm.
Eine Anwendung FormelementPython wird mit der addObject()
Methode des Dokuments erstellt.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::FeaturePython", "Name")
obj.Label = "Custom label"
Beispielsweise , die Entwurf Text, Entwurf Abmessung, und Arbeitsebenen proxy Elemente der Entwurf Arbeitsbereich sind App::FeaturePython
Objekte mit einem benutzerdefinierten Symbol und zusätzlichen Eigenschaften. Sie enthalten Daten, aber keine tatsächliche Part TopoForm.
Wenn das gewünschte Objekt eine Platzierung, eine Form, einen Anhang oder andere komplexe Eigenschaften haben soll, ist es besser, eine der komplexeren Klassen zu erstellen, zum Beispiel App GeoFeature, Part Formelement, oder Part Teil2DObjekt.
- Core: App DocumentObject
- Basic: App FeaturePython, App GeoFeature, Part Feature, Mesh Feature, Fem FemMeshObject
- Internal shapes: Part TopoShape, Mesh MeshObject, Fem FemMesh
- Structure: App DocumentObjectGroup (Std Group), App Part (Std Part), App Link (Std LinkMake)
- Derived: Part Part2DObject, Sketcher SketchObject, PartDesign Body, PartDesign Feature
- Erste Schritte
- Installation: Herunterladen, Windows, Linux, Mac, Zusätzlicher Komponenten, Docker, AppImage, Ubuntu Snap
- Grundlagen: Über FreeCAD, Graphische Oberfläche, Mausbedienung, Auswahlmethoden, Objektname, Programmeinstellungen, Arbeitsbereiche, Dokumentstruktur, Objekteigenschaften, Hilf FreeCAD, Spende
- Hilfe: Tutorien, Video Tutorien
- Arbeitsbereiche: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework