App: Właściwości Python

From FreeCAD Documentation
This page is a translated version of the page App FeaturePython and the translation is 100% complete.
Other languages:

Wprowadzenie

Obiekt App: Właściwości Python, lub formalnie App::FeaturePython, jest prostą instancją App: Obiekt dokumentu w środowisku Python.

Jest to prosty obiekt, który domyślnie nie ma wielu właściwości, na przykład nie ma umiejscowienia lub kształtu topologicznego. W zależności od przypisanych mu właściwości, może być używany do zarządzania różnymi typami danych.

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

Użycie

App: Właściwości Python jest obiektem wewnętrznym, więc nie można go utworzyć z poziomu interfejsu graficznego. Jest on przeznaczony do tworzenia klas podrzędnych, które będą obsługiwać różne typy danych.

Na przykład obiekty Adnotacja wieloliniowa, Wymiar i Pośrednia płaszczyzna robocza w środowisku pracy Rysunek Roboczy są obiektami App::FeaturePython z niestandardową ikoną i dodatkowymi właściwościami. Przechowują one dane, ale nie rzeczywisty obiekt kształtu topologicznego.

Jeśli pożądany obiekt ma mieć umiejscowienie, kształt, dołączenie lub inne złożone właściwości, lepiej jest utworzyć jedną z bardziej złożonych klas, na przykład App: Cechy geometrii, Część: Cecha lub Część: Część na obiekt 2D.

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.

Klasa App: Właściwości Python (App::FeaturePython) jest pochodną podstawowej klasy App: Obiekt dokumentu (App::DocumentObject) i dziedziczy wszystkie jej właściwości. Posiada również kilka dodatkowych właściwości.

Są to właściwości dostępne w edytorze właściwości. Ukryte właściwości można wyświetlić za pomocą polecenia Wyświetl wszystko w menu kontekstowym edytora właściwości.

Dane

Podstawa

  • DANE (ukryte)Proxy (PythonObject): niestandardowa klasa powiązana z tym obiektem.
  • DANELabel (String): edytowalna przez użytkownika nazwa tego obiektu, jest to dowolny ciąg UTF8.
  • DANE (ukryte)Label2 (String): dłuższy, edytowalny przez użytkownika opis tego obiektu, jest to dowolny ciąg UTF8, który może zawierać nowe linie. Domyślnie jest to pusty ciąg "".
  • DANEExpressionEngine (ukryte): lista wyrażeń. Domyślnie jest pusta [].
  • DANE (ukryte)Visibility (Bool): czy obiekt ma być wyświetlany czy nie.

Widok

Podstawa

  • WIDOK (ukryte)Proxy (PythonObject): niestandardowa klasa Dostawca widoku powiązana z tym obiektem.

Opcje wyświetlania

  • WIDOKDisplay Mode (Enumeration): domyślnie jest puste.
  • WIDOKShow In Tree (Bool): wartość domyślna to PRAWDA, w którym to przypadku obiekt pojawi się w oknie widoku drzewa. W przeciwnym razie obiekt zostanie ukryty w oknie drzewa. Gdy obiekt w drzewie jest niewidoczny, można go ponownie zobaczyć, otwierając menu kontekstowe nad nazwą dokumentu (prawym przyciskiem myszki) i wybierając Pokaż elementy ukryte w widoku drzewa. Następnie można wybrać ukryty element i przełączyć właściwość WIDOKPokaż w drzewie z powrotem na wartość PRAWDA.
  • WIDOKVisibility (Bool): wartość domyślna to PRAWDA, w którym to przypadku obiekt będzie widoczny w oknie 3D view, jeśli posiada kształt, w przeciwnym razie będzie niewidoczny. Domyślnie właściwość ta może być włączana i wyłączana poprzez zaznaczenie obiektu i naciśnięcie przycisku Spacja.

Wybieranie

  • WIDOKOn Top When Selected (Enumeration): kontroluje sposób, w jaki zaznaczenie pojawia się w oknie widoku 3D, jeśli obiekt ma kształt, a istnieje wiele obiektów częściowo zakrytych przez inne. Domyślnie Wyłączone, co oznacza, że nie pojawi się żadne specjalne podświetlenie. Włączone oznacza, że obiekt pojawi się na wierzchu każdego innego obiektu po wybraniu. Object oznacza, że obiekt pojawi się na wierzchu tylko wtedy, gdy cały obiekt zostanie wybrany w oknie Widoku drzewa. Element oznacza, że obiekt pojawi się na wierzchu tylko wtedy, gdy element podrzędny (wierzchołek, krawędź, ściana) zostanie wybrany w oknie widoku 3D.
  • WIDOKSelection Style (Enumeration): kontroluje sposób podświetlenia obiektu, jeśli ma on kształt. Jeśli jest to kształt, cały kształt (wierzchołki, krawędzie i ściany) zostanie podświetlony w oknie widoku 3D; jeśli jest to Ramka otaczająca, pojawi się obwiednia otaczająca obiekt i zostanie podświetlona.

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 App: Właściwości Python jest tworzony za pomocą metody dokumentu addObject(). 

import FreeCAD as App

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


Obiekty dokumentu
Centrum użytkownika
Retrieved from "http://wiki.freecad.org/index.php?title=App_FeaturePython/pl&oldid=1340320"