App DocumentObject/it: Difference between revisions

From FreeCAD Documentation
(Created page with "== Utilizzo ==")
(Created page with "== Proprietà ==")
Line 20: Line 20:
* The [[Part_Feature|Part Feature]] class, derived from App GeoFeature, and the parent class of objects with 2D and 3D shapes.
* The [[Part_Feature|Part Feature]] class, derived from App GeoFeature, and the parent class of objects with 2D and 3D shapes.


== Properties ==
== Proprietà ==


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

Revision as of 21:43, 16 December 2019

Other languages:

Introduzione

Un oggetto App DocumentObject, o formalmente un App::DocumentObject, è la classe di base di tutte le classi di oggetti gestite nel documento.

Diagramma semplificato delle relazioni tra gli oggetti principali del programma. La classe App::DocumentObject è la classe base essenzialmente di tutti gli oggetti nel software.

Utilizzo

The App DocumentObject is an internal object, so it cannot be created from the graphical interface. It is not meant to be used directly; rather, it is meant to be sub-classed by classes that will handle different types of data. Therefore, almost every object in the software, that is, every element that has an icon and that can be listed in the tree view, is a "DocumentObject".

Some of the most important DocumentObjects are the following:

  • The App FeaturePython class, an empty object that can be used for different purposes, depending on the added properties.
  • The App GeoFeature class, the base object of all geometrical objects, that is, of objects that have a Placement property that defines their position in the 3D view.
  • The Part Feature class, derived from App GeoFeature, and the parent class of objects with 2D and 3D shapes.

Proprietà

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

  • DatiExpression Engine: a list of expressions.
  • DatiLabel: the user editable name of this object, it is an arbitrary UTF8 string.
  • DatiLabel2: a longer, user editable description of this object, it is an arbitrary UTF8 string.
  • DatiVisibility: whether to display the object or not.

For derived objects, only DatiLabel 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"