App DocumentObject

From FreeCAD Documentation
Revision as of 15:28, 26 December 2019 by David69 (talk | contribs) (Created page with "Certains des DocumentObjects les plus importants sont les suivants: * La classe App FeaturePython, un objet vide qui peut être utilisé à différent...")
Other languages:

Introduction

Un objet App DocumentObject, ou officiellement App::DocumentObject, est la classe de base de toutes les classes d'objets gérées dans le document.

Diagramme simplifié des relations entre les objets centraux du programme. La classe App::DocumentObject est la classe de base de pratiquement tous les objets du logiciel.

Utilisation

App DocumentObject est un objet interne. Il ne peut donc pas être créé à partir de l'interface graphique. Il n'est pas destiné à être utilisé directement; il est plutôt destiné à être sous-classé par des classes qui gèrent différents types de données. Par conséquent, presque chaque objet du logiciel, c'est-à-dire chaque élément qui a une icône et qui peut être répertorié dans vue en arborescence, est un "DocumentObject".

Certains des DocumentObjects les plus importants sont les suivants:

  • La classe App FeaturePython, un objet vide qui peut être utilisé à différentes fins, en fonction des propriétés ajoutées.
  • La classe App GeoFeature , l'objet de base de tous les objets géométriques, c'est-à-dire des objets qui ont une propriété Placement qui définit leur position dans la [[3D view/fr|vue 3D] ].
  • La classe Part Feature, dérivée d'App GeoFeature, et la classe parent d'objets avec 2D et 3D topological shapes.

Propriétés

Voir Propriétés pour tous les types de propriétés que les objets crées par script peuvent avoir.

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

  • DonnéesExpression Engine (ExpressionEngine): a list of expressions.
  • DonnéesLabel (String): the user editable name of this object, it is an arbitrary UTF8 string.
  • DonnéesLabel2 (String): a longer, user editable description of this object, it is an arbitrary UTF8 string.
  • DonnéesVisibility (Bool): whether to display the object or not.

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

Script

Voir aussi: Débuter avec les scripts et Objets créés par script.

Voir Part Feature pour les informations générales sur l'ajout d'objets au programme.

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"