App DocumentObject/pl: Difference between revisions

From FreeCAD Documentation
No edit summary
(Created page with "Obiekt dokumentu tworzy się za pomocą metody {{incode|addObject()}} dokumentu. Jednakże, ogólnie rzecz biorąc, nie ma potrzeby ręcznego tworzenia tego obiektu. Zazwyczaj lepiej jest podklasować jedną z bardziej złożonych klas, na przykład App: Właściwości Python, App: Cechy geometrii, Część: Cecha, Część: Część na obiekt 2D, itd.")
 
(9 intermediate revisions by the same user not shown)
Line 24: Line 24:
[[App_DocumentObject/pl|Obiekt dokumentu]] jest klasą wewnętrzną, więc nie może być tworzona z poziomu interfejsu graficznego, ani nie jest przeznaczona do samodzielnego użytku. Definiuje ona jedynie podstawowe zachowanie i właściwości obiektów w programie.
[[App_DocumentObject/pl|Obiekt dokumentu]] jest klasą wewnętrzną, więc nie może być tworzona z poziomu interfejsu graficznego, ani nie jest przeznaczona do samodzielnego użytku. Definiuje ona jedynie podstawowe zachowanie i właściwości obiektów w programie.


Niektóre z najważniejszych obiektów dokumentu to:
Some of the most important DocumentObjects are the following:
* The [[App_FeaturePython|App FeaturePython]] class, an empty object that can be used for different purposes, depending on the added properties.
* Klasa [[App_FeaturePython/pl|App: Właściwości Python]], pusty obiekt, który może być używany do różnych celów, w zależności od dodanych atrybutów.
* The [[App_GeoFeature|App GeoFeature]] class, the base object of all geometrical objects, that is, of objects that have a [[Placement|Placement]] property that defines their position in the [[3D_view|3D view]].
* Klasa [[App_GeoFeature/pl|App: Cechy geometrii]], podstawowy obiekt wszystkich obiektów geometrycznych, czyli obiektów posiadających atrybut [[Placement/pl|Umiejscowienie]], który definiuje ich pozycję w [[3D_view/pl|widoku 3D]].
* The [[Part_Feature|Part Feature]] class, derived from App GeoFeature, and the parent class of objects with 2D and 3D [[Part_TopoShape|topological shapes]].
* Klasa [[Part_Feature/pl|Część: cCecha]], pochodna klasy App GeoFeature, i nadrzędna klasa obiektów z 2D i 3D [[Part_TopoShape/pl|kształtami topologicznymi]].
* The [[Mesh_Feature|Mesh Feature]] class, derived from App GeoFeature, and the parent class of objects with 2D and 3D [[Mesh_MeshObject|meshes]].
* Klasa [[Mesh_Feature/pl|Mesh Feature]], pochodna klasy App GeoFeature, i nadrzędna klasa obiektów z [[Mesh_MeshObject/pl|siatkami]] 2D i 3D.


== Properties ==
<span id="Properties"></span>
==Właściwości==


Zobacz stronę [[Property/pl|Właściwości]] dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami.
See [[Property|Property]] for all property types that scripted objects can have.


Są to podstawowe właściwości, które posiadają zasadniczo wszystkie obiekty. Dostęp do tych właściwości można uzyskać z [[Python_console/pl|Konsoli Python]].
These are the basic properties that essentially all objects have. These properties can be accessed from the [[Python console|Python console]].


* {{PropertyData|Label|String}}: the user editable name of this object, it is an arbitrary UTF8 string. By default, it is the same as the {{incode|Name}}.
* {{PropertyData|Etykieta|String}}: użytkownik może edytować nazwę tego obiektu, jest to dowolny ciąg znaków UTF8. Domyślnie jest to samo co {{incode|Nazwa}}.
* {{PropertyData|Label2|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 {{value|""}}.
* {{PropertyData|Etykieta2|String}}: dłuższy, użytkownik może edytować opis tego obiektu, jest to dowolny ciąg znaków UTF8, który może zawierać nowe linie. Domyślnie jest to pusty ciąg znaków {{value|""}}.
* {{PropertyData|Expression Engine|ExpressionEngine}}: a list of expressions.
* {{PropertyData|Silnik wyrażeń|ExpressionEngine}}: lista wyrażeń.
* {{PropertyData|Visibility|Bool}}: whether to display the object or not.
* {{PropertyData|Widoczność|Bool}}: definiuje czy wyświetlać obiekt czy nie.


Dla obiektów pochodnych, tylko {{PropertyData|Etykieta}} będzie domyślnie wyświetlane w [[property_editor/pl|edytorze właściwości]]. Pozostałe właściwości będą ukryte.
For derived objects, only {{PropertyData|Label}} will be listed in the [[property editor|property editor]] by default. The other properties will be hidden.


== Scripting ==
<span id="Scripting"></span>
==Tworzenie skryptów==


{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]] and [[Scripted_objects|scripted objects]].
{{Emphasis|Zobacz również:}} [[FreeCAD_Scripting_Basics/pl|Podstawy tworzenia skryptów FreeCAD]], oraz [[Scripted_objects/pl|Obiekty skryptowe]].


Ogólne informacje na temat dodawania obiektów do dokumentu można znaleźć na stronie [[Part_Feature/pl|Część: właściwość]].
See [[Part_Feature|Part Feature]] for the general information on adding objects to the document.


A DocumentObject is created with the {{incode|addObject()}} method of the document. However, in general, there is no need to create this object manually. It is usually better to subclass one of the more complex classes, for example, [[App_FeaturePython|App FeaturePython]], [[App_GeoFeature|App GeoFeature]], [[Part_Feature|Part Feature]], [[Part_Part2DObject|Part Part2DObject]], etc.
Obiekt dokumentu tworzy się za pomocą metody {{incode|addObject()}} dokumentu. Jednakże, ogólnie rzecz biorąc, nie ma potrzeby ręcznego tworzenia tego obiektu. Zazwyczaj lepiej jest podklasować jedną z bardziej złożonych klas, na przykład [[App_FeaturePython/pl|App: Właściwości Python]], [[App_GeoFeature/pl|App: Cechy geometrii]], [[Part_Feature/pl|Część: Cecha]], [[Part_Part2DObject/pl|Część: Część na obiekt 2D]], itd.


{{Code|code=
{{Code|code=

Latest revision as of 14:48, 30 March 2024

Wprowadzenie

Obiekt Dokumentu, lub formalnie App::DocumentObject, jest klasą bazową wszystkich klas obiektów obsługiwanych w dokumencie.

Ogólnie rzecz biorąc, "ObiektDokumentu" to dowolna "rzecz", która może pojawić się w widoku drzewa i która jest zapisywana i przywracana podczas otwierania dokumentu.

Widok drzewa pokazujący różne obiekty w dokumencie. Każdy z nich jest "obiektem dokumentu", wywodzącym się z klasy bazowej App::DocumentObject.

Uproszczony diagram zależności pomiędzy podstawowymi obiektami w programie FreeCAD.

Użycie

Obiekt dokumentu jest klasą wewnętrzną, więc nie może być tworzona z poziomu interfejsu graficznego, ani nie jest przeznaczona do samodzielnego użytku. Definiuje ona jedynie podstawowe zachowanie i właściwości obiektów w programie.

Niektóre z najważniejszych obiektów dokumentu to:

Właściwości

Zobacz stronę Właściwości dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami.

Są to podstawowe właściwości, które posiadają zasadniczo wszystkie obiekty. Dostęp do tych właściwości można uzyskać z Konsoli Python.

  • DANEEtykieta (String): użytkownik może edytować nazwę tego obiektu, jest to dowolny ciąg znaków UTF8. Domyślnie jest to samo co Nazwa.
  • DANEEtykieta2 (String): dłuższy, użytkownik może edytować opis tego obiektu, jest to dowolny ciąg znaków UTF8, który może zawierać nowe linie. Domyślnie jest to pusty ciąg znaków "".
  • DANESilnik wyrażeń (ExpressionEngine): lista wyrażeń.
  • DANEWidoczność (Bool): definiuje czy wyświetlać obiekt czy nie.

Dla obiektów pochodnych, tylko DANEEtykieta będzie domyślnie wyświetlane w edytorze właściwości. Pozostałe właściwości będą ukryte.

Tworzenie skryptów

Zobacz również: Podstawy tworzenia skryptów FreeCAD, oraz Obiekty skryptowe.

Ogólne informacje na temat dodawania obiektów do dokumentu można znaleźć na stronie Część: właściwość.

Obiekt dokumentu tworzy się za pomocą metody addObject() dokumentu. Jednakże, ogólnie rzecz biorąc, nie ma potrzeby ręcznego tworzenia tego obiektu. Zazwyczaj lepiej jest podklasować jedną z bardziej złożonych klas, na przykład App: Właściwości Python, App: Cechy geometrii, Część: Cecha, Część: Część na obiekt 2D, itd.

import FreeCAD as App

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