App DocumentObject/pl: Difference between revisions
(Created page with "Zobacz stronę Właściwości dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami.") |
(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.") |
||
(7 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: |
|||
* |
* 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. |
||
* |
* 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]]. |
||
* |
* 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]]. |
||
* |
* Klasa [[Mesh_Feature/pl|Mesh Feature]], pochodna klasy App GeoFeature, i nadrzędna klasa obiektów z [[Mesh_MeshObject/pl|siatkami]] 2D i 3D. |
||
<span id="Properties"></span> |
<span id="Properties"></span> |
||
Line 35: | Line 35: | ||
Zobacz stronę [[Property/pl|Właściwości]] dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami. |
Zobacz stronę [[Property/pl|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 [[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| |
* {{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| |
* {{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| |
* {{PropertyData|Silnik wyrażeń|ExpressionEngine}}: lista wyrażeń. |
||
* {{PropertyData| |
* {{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. |
|||
= |
<span id="Scripting"></span> |
||
==Tworzenie skryptów== |
|||
{{Emphasis| |
{{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. |
|||
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:
- Klasa 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.
- Klasa App: Cechy geometrii, podstawowy obiekt wszystkich obiektów geometrycznych, czyli obiektów posiadających atrybut Umiejscowienie, który definiuje ich pozycję w widoku 3D.
- Klasa Część: cCecha, pochodna klasy App GeoFeature, i nadrzędna klasa obiektów z 2D i 3D kształtami topologicznymi.
- Klasa Mesh Feature, pochodna klasy App GeoFeature, i nadrzędna klasa obiektów z siatkami 2D i 3D.
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 coNazwa
. - 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"
- Rdzenne: App: Obiekt dokumentu
- Podstawowe: : Właściwości Python, App: Cechy geometrii, Część: Cecha, Siatka: Cecha, MES: Siatka
- Kształty wewnętrzne: Część: Kształt topologiczny, Siatka: Obiekt siatki, MES: Siatka
- Struktura: App: Obiekt grupy dokumentu (Std: Grupa), App: Część (Std: Część), App: Link
- Pochodne: Część: Part2DObject, Szkicownik: Obiekt szkicu, Projekt części: Zawartość, Projekt części: Cecha
- Jak zacząć
- Instalacja: Pobieranie programu, Windows, Linux, Mac, Dodatkowych komponentów, Docker, AppImage, Ubuntu Snap
- Podstawy: Informacje na temat FreeCAD, Interfejs użytkownika, Profil nawigacji myszką, Metody wyboru, Nazwa obiektu, Edytor ustawień, Środowiska pracy, Struktura dokumentu, Właściwości, Pomóż w rozwoju FreeCAD, Dotacje
- Pomoc: Poradniki, Wideo poradniki
- Środowiska pracy: Strona Startowa, Architektura, Assembly, CAM, Rysunek Roboczy, MES, Inspekcja, Siatka, OpenSCAD, Część, Projekt Części, Punkty, Inżynieria Wsteczna, Robot, Szkicownik, Arkusz Kalkulacyjny, Powierzchnia 3D, Rysunek Techniczny, Test Framework