App DocumentObject/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "'''Obiekt Dokumentu''', lub formalnie {{incode|App::DocumentObject}}, jest klasą bazową wszystkich klas obiektów obsługiwanych w dokumencie.")
(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.")
 
(15 intermediate revisions by the same user not shown)
Line 9: Line 9:
'''Obiekt Dokumentu''', lub formalnie {{incode|App::DocumentObject}}, jest klasą bazową wszystkich klas obiektów obsługiwanych w dokumencie.
'''Obiekt Dokumentu''', lub formalnie {{incode|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 [[Tree_view/pl|widoku drzewa]] i która jest zapisywana i przywracana podczas otwierania dokumentu.
In general terms, a "DocumentObject" is any "thing" that can appear in the [[Tree_view|Tree view]], and which is saved and restored when opening a document.


[[File:App_DocumentObject_example.png]]
[[File:App_DocumentObject_example.png]]


{{Caption|Tree view showing different objects in the document. Each of them is a "document object", ultimately derived from the base {{incode|App::DocumentObject}} class.}}
{{Caption|Widok drzewa pokazujący różne obiekty w dokumencie. Każdy z nich jest "obiektem dokumentu", wywodzącym się z klasy bazowej {{incode|App::DocumentObject}}.}}


[[File:FreeCAD_core_objects.svg|800px]]
[[File:FreeCAD_core_objects.svg|800px]]


{{Caption|Simplified diagram of the relationships between the core objects in FreeCAD}}
{{Caption|Uproszczony diagram zależności pomiędzy podstawowymi obiektami w programie FreeCAD.}}


== Usage ==
<span id="Usage"></span>
==Użycie==


[[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.
The [[App_DocumentObject|App DocumentObject]] is an internal class, so it cannot be created from the graphical interface, nor is it meant to be used by itself. It just defines the basic behavior and properties of objects in the program.


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"