Std Group/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "Std: Grupa")
 
No edit summary
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav
{{Docnav/pl
|[[Std_Part|Part]]
|[[Std_Part/pl|Część]]
|[[Std_LinkMake|LinkMake]]
|[[Std_LinkMake/pl|Utwórz łącze]]
|[[Std_Base|Std Base]]
|[[Std_Base/pl|Narzędzia standardowe]]
|IconL=Std_Part.svg
|IconL=Std_Part.svg
|IconR=Std_LinkMake.svg
|IconR=Std_LinkMake.svg
Line 9: Line 9:
}}
}}


{{GuiCommand
{{GuiCommand/pl
|Name=Std Group
|Name=Std Group
|Name/pl=Std: Grupa
|MenuLocation=[[Tree_view|Tree view]] → Right click on the document name → Create group
|MenuLocation=[[Tree_view/pl|Widok drzewa]] → Kliknij prawym przyciskiem myszki nazwę dokumentu → Utwórz grupę ...
|Workbenches=All
|Workbenches=wszystkie
|Shortcut=
|Shortcut=
|Version=
|Version=
|SeeAlso=[[Std_Part|Std Part]], [[Draft_SelectGroup|Draft SelectGroup]], [[Draft_AddToGroup|Draft AddToGroup]]
|SeeAlso=[[Std_Part/pl|Część]], [[Draft_SelectGroup/pl|Wybierz grupę]], [[Draft_AddToGroup/pl|Dodaj do grupy]]
}}
}}


==Description==
<span id="Description"></span>
==Opis==


[[Std_Group|Std Group]] (internally called [[App_DocumentObjectGroup|App DocumentObjectGroup]]) is a general purpose container that allows you to group different types of objects in the [[tree_view|tree view]], regardless of their data type. It is used as a simple folder to categorize and organize the objects in your model, in order to keep a logical structure. Std Groups may be nested inside other Std Groups.
Obiekt '''Std: Grupa''' ''(wewnętrznie nazywany [[App_DocumentObjectGroup/pl|App DocumentObjectGroup]])'' jest kontenerem ogólnego przeznaczenia, który pozwala na grupowanie różnych typów obiektów w oknie [[Tree_view/pl|Widoku drzewa]], niezależnie od ich typu danych. Jest on używany jako prosty folder do kategoryzowania i organizowania obiektów w modelu w celu zachowania logicznej struktury. Obiekty Std: Grupa mogą być zagnieżdżone wewnątrz innych obiektów Std: Grupa.


The Std Group tool is not defined by a particular workbench, but by the base system, thus it is found in the {{MenuCommand|structure toolbar}} that is available in all [[Workbenches|workbenches]].
Narzędzie Std: Grupa nie jest zdefiniowane przez konkretne środowisko pracy, lecz przez system bazowy, a więc znajduje się na {{MenuCommand|pasku narzędzi konstrukcji}}, który jest dostępny we wszystkich [[Workbenches/pl|środowiskach pracy]].


To group 3D objects as a single unit, with the intention of creating assemblies, use [[Std_Part|Std Part]] instead.
Aby zgrupować obiekty 3D jako pojedynczą jednostkę, z zamiarem tworzenia złożeń, należy użyć obiektu [[Std_Part/pl|Std: Część]].


[[File:Std_Group_example.png]]
[[File:Std_Group_example.png]]


{{Caption|Various elements inside Std Groups in the tree view.}}
{{Caption|Różne elementy wewnątrz obiektu Std: Grupa w widoku drzewa.}}


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


# Wykonaj jedną z następujących czynności:
# Click on the name of the document in the [[tree_view|tree view]], open the context menu (right click), and choose {{Button|Create group}}.
#* Kliknij prawym przyciskiem myszy nazwę dokumentu w [[Tree_view/pl|Widoku Drzewa]] i w menu kontekstowym wybierz pozycje {{MenuCommand|Utwórz grupę ...}}.
# Alternatively, press the {{Button|[[Image:Std_Group.svg|16px]] [[Std_Group|Group]]}} button in the structure toolbar. An empty Group is created.
#* Naciśnij przycisk {{Button|[[Image:Std_Group.svg|16px]] [[Std_Group/pl|Utwórz grupę]]}}.
# To add objects to a Group, select them in [[tree_view|tree view]], and then drag and drop them over the Group.
# Utworzona zostanie pusta grupa.
# To remove objects from a Group, drag them out of the Group, and onto the document label at the top of the [[tree_view|tree view]].
# Aby dodać obiekty do grupy, wybierz je w oknie [[Tree_view/pl|Widoku drzewa]], a następnie przeciągnij i upuść na grupę.
# Aby usunąć obiekty z Grupy, przeciągnij je poza Grupę na etykietę dokumentu w górnej części okna [[Tree_view/pl|Widoku drzewa]].
# Obiekty mogą być również dodawane i usuwane poprzez edycję właściwości {{PropertyData|Grupa}}.


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


Obiekt '''Std: Grupa''', wewnętrznie nazywany [[App_DocumentObjectGroup/pl|App DocumentObjectGroup]] ''(klasa {{incode|App::DocumentObjectGroup}})'', jest pochodną podstawowego obiektu [[App_DocumentObject/pl|App DocumentObject]] ''(klasa {{incode|App::DocumentObject}})'' i dziedziczy wszystkie jego właściwości.
* The Group object does not affect the positions in the [[3D_view|3D view]] of the elements that it contains; it is essentially just a folder that is used to keep the [[tree_view|tree view]] organized.
* The Group can also be created from the [[Python console|Python console]], and sub-classed to create special "groups", as indicated in the [[Std_Group#Scripting|Scripting]] section.


Obiekt Std Grupa ma takie same właściwości jak [[App_FeaturePython/pl#Właściwości|App: FeaturePython]], który jest najbardziej podstawową instancją [[App_DocumentObject/pl|App DocumentObject]]. Posiada on również następujące dodatkowe właściwości w [[Property_editor/pl|edytorze właściwości]]. Ukryte właściwości można wyświetlić za pomocą polecenia {{MenuCommand|Wyświetl wszystko}} w menu kontekstowym [[Property_editor/pl|edytora właściwości]].
==Properties==


<span id="Data"></span>
A [[Std_Group|Std Group]] is internally called [[App_DocumentObjectGroup|App DocumentObjectGroup]] ({{incode|App::DocumentObjectGroup}} class), and is derived from the basic [[App_DocumentObject|App DocumentObject]] ({{incode|App::DocumentObject}} class), therefore it shares all the latter's properties.
===Dane===


{{TitleProperty|Podstawa}}
In addition to the properties described in [[App_FeaturePython|App FeaturePython]], which is the most basic instance of an [[App_DocumentObject|App DocumentObject]], the App DocumentObjectGroup has the {{PropertyData|Group}} property.


* {{PropertyData|Grupa|LinkList}}: lista obiektów, do których istnieją odniesienia. Domyślnie jest ona pusta {{value|[]}}.
These are the properties available in the [[property editor|property editor]]. Hidden properties can be shown by using the {{MenuCommand|Show all}} command in the context menu of the [[property editor|property editor]].
* {{PropertyData|_ Group Touched|Bool|Hidden}}: niezależnie od tego, czy grupa została zmodyfikowana, czy nie.


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


{{Emphasis|Zobacz również:}} [[FreeCAD_Scripting_Basics/pl|Podstawy tworzenia skryptów FreeCAD]], oraz [[Scripted_objects/pl|Obiekty skryptowe]].
{{TitleProperty|Base}}


Ogólne informacje na temat dodawania obiektów do dokumentu można znaleźć na stronie [[Part_Feature/pl|Część: właściwość]].
* {{PropertyData|Label|String}}: the user editable name of this object, it is an arbitrary UTF8 string.
* {{PropertyData|Group|LinkList}}: a list of referenced objects. By default, it is empty {{value|[]}}.


Element Std: Grupa ''([[App_DocumentObjectGroup/pl|App DocumentObjectGroup]])'' jest tworzony przy pomocy metody {{incode|addObject()}} dokumentu. Gdy istnieje element Part, inne obiekty mogą być do niego dodane za pomocą metod {{incode|addObject()}} lub {{incode|addObjects()}} tej Części.
==== Hidden properties Data ====


* {{PropertyData|Proxy|PythonObject}}: a custom class associated with this object. This only exists for the [[Python|Python]] version. See [[Std_Group#Scripting|Scripting]].

=== View ===

{{TitleProperty|Base}}

See [[App_FeaturePython|App FeaturePython]] for the basic view properties.

==== Hidden properties View ====

* {{PropertyView|Proxy|PythonObject}}: a custom view provider class associated with this object. This only exists for the [[Python|Python]] version. See [[Std_Group#Scripting|Scripting]].

== Inheritance ==

A [[Std Group|Std Group]] is formally an instance of the class {{incode|App::DocumentObjectGroup}}, whose parent is the basic [[App_DocumentObject|App DocumentObject]] ({{incode|App::DocumentObject}} class), and is augmented with a Group extension.

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

{{Caption|Simplified diagram of the relationships between the core objects in the program. The {{incode|App::DocumentObjectGroup}} class is a simple container which uses the Group extension to be able to hold any type of object.}}

==Scripting==

{{Emphasis|See also:}} [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]], and [[scripted objects|scripted objects]].

See [[Part_Feature|Part Feature]] for the general information on adding objects to the document.

A Std Group ([[App_DocumentObjectGroup|App DocumentObjectGroup]]) is created with the {{incode|addObject()}} method of the document. Once a Group exists, other objects can be added to it with the {{incode|addObject()}} or {{incode|addObjects()}} methods of this Group.
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App


doc = App.newDocument()
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::DocumentObjectGroup", "Group")
group = App.ActiveDocument.addObject("App::DocumentObjectGroup", "Group")


bod1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
bod2 = App.ActiveDocument.addObject("Part::Box", "Box")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")


obj.addObjects([bod1, bod2])
group.addObjects([obj1, obj2])
App.ActiveDocument.recompute()
App.ActiveDocument.recompute()
}}
}}


This basic {{incode|App::DocumentObjectGroup}} doesn't have a Proxy object so it can't be fully used for sub-classing.
Ten podstawowy obiekt {{incode|App::DocumentObjectGroup}} nie posiada obiektu Proxy, więc nie może być w pełni wykorzystany do tworzenia klas podrzędnych.


Therefore, for [[Python|Python]] subclassing, you should create the {{incode|App::DocumentObjectGroupPython}} object.
Dlatego też, dla klasy podrzędnej [[Python/pl|Python]], powinieneś stworzyć obiekt {{incode|App::DocumentObjectGroupPython}}.


{{Code|code=
{{Code|code=
Line 111: Line 92:
}}
}}


For example, a [[FEM Analysis|FEM Analysis]] is an {{incode|App::DocumentObjectGroupPython}} object with a custom icon and additional properties.
Na przykład [[FEM_Analysis/pl|Analiza MES]] jest obiektem {{incode|App::DocumentObjectGroupPython}} z niestandardową ikoną i dodatkowymi właściwościami.


==Links==
<span id="Links"></span>
==Odnośniki internetowe==


* [[Arch_tutorial/pl#Porządkowanie_modelu|Przypadek użycia w poradniku Architektury]]
* [[Arch tutorial#Organizing your model|Use case in Arch Tutorial]]
* [[Document_structure|Document structure]]
* [[Document_structure/pl|Struktura dokumentu]]
* [http://www.freecadweb.org/wiki/index.php?title=Arch_tutorial#Organizing_your_model Organizing your model]
* [http://www.freecadweb.org/wiki/index.php?title=Arch_tutorial#Organizing_your_model Porządkowanie modelu]




{{Docnav
{{Docnav/pl
|[[Std_Part|Part]]
|[[Std_Part/pl|Część]]
|[[Std_LinkMake|LinkMake]]
|[[Std_LinkMake/pl|Utwórz łącze]]
|[[Std_Base|Std Base]]
|[[Std_Base/pl|Narzędzia standardowe]]
|IconL=Std_Part.svg
|IconL=Std_Part.svg
|IconR=Std_LinkMake.svg
|IconR=Std_LinkMake.svg
Line 129: Line 111:
}}
}}


{{Std Base navi{{#translation:}}}}
{{Std_Base_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 15:15, 2 July 2023

Std: Grupa

Lokalizacja w menu
Widok drzewa → Kliknij prawym przyciskiem myszki nazwę dokumentu → Utwórz grupę ...
Środowisko pracy
wszystkie
Domyślny skrót
brak
Wprowadzono w wersji
-
Zobacz także
Część, Wybierz grupę, Dodaj do grupy

Opis

Obiekt Std: Grupa (wewnętrznie nazywany App DocumentObjectGroup) jest kontenerem ogólnego przeznaczenia, który pozwala na grupowanie różnych typów obiektów w oknie Widoku drzewa, niezależnie od ich typu danych. Jest on używany jako prosty folder do kategoryzowania i organizowania obiektów w modelu w celu zachowania logicznej struktury. Obiekty Std: Grupa mogą być zagnieżdżone wewnątrz innych obiektów Std: Grupa.

Narzędzie Std: Grupa nie jest zdefiniowane przez konkretne środowisko pracy, lecz przez system bazowy, a więc znajduje się na pasku narzędzi konstrukcji, który jest dostępny we wszystkich środowiskach pracy.

Aby zgrupować obiekty 3D jako pojedynczą jednostkę, z zamiarem tworzenia złożeń, należy użyć obiektu Std: Część.

Różne elementy wewnątrz obiektu Std: Grupa w widoku drzewa.

Użycie

  1. Wykonaj jedną z następujących czynności:
    • Kliknij prawym przyciskiem myszy nazwę dokumentu w Widoku Drzewa i w menu kontekstowym wybierz pozycje Utwórz grupę ....
    • Naciśnij przycisk Utwórz grupę.
  2. Utworzona zostanie pusta grupa.
  3. Aby dodać obiekty do grupy, wybierz je w oknie Widoku drzewa, a następnie przeciągnij i upuść na grupę.
  4. Aby usunąć obiekty z Grupy, przeciągnij je poza Grupę na etykietę dokumentu w górnej części okna Widoku drzewa.
  5. Obiekty mogą być również dodawane i usuwane poprzez edycję właściwości DANEGrupa.

Właściwości

Obiekt Std: Grupa, wewnętrznie nazywany App DocumentObjectGroup (klasa App::DocumentObjectGroup), jest pochodną podstawowego obiektu App DocumentObject (klasa App::DocumentObject) i dziedziczy wszystkie jego właściwości.

Obiekt Std Grupa ma takie same właściwości jak App: FeaturePython, który jest najbardziej podstawową instancją App DocumentObject. Posiada on również następujące dodatkowe właściwości 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

  • DANEGrupa (LinkList): lista obiektów, do których istnieją odniesienia. Domyślnie jest ona pusta [].
  • DANE (Hidden)_ Group Touched (Bool): niezależnie od tego, czy grupa została zmodyfikowana, czy nie.

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ść.

Element Std: Grupa (App DocumentObjectGroup) jest tworzony przy pomocy metody addObject() dokumentu. Gdy istnieje element Part, inne obiekty mogą być do niego dodane za pomocą metod addObject() lub addObjects() tej Części.

import FreeCAD as App

doc = App.newDocument()
group = App.ActiveDocument.addObject("App::DocumentObjectGroup", "Group")

obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")

group.addObjects([obj1, obj2])
App.ActiveDocument.recompute()

Ten podstawowy obiekt App::DocumentObjectGroup nie posiada obiektu Proxy, więc nie może być w pełni wykorzystany do tworzenia klas podrzędnych.

Dlatego też, dla klasy podrzędnej Python, powinieneś stworzyć obiekt App::DocumentObjectGroupPython.

import FreeCAD as App

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

Na przykład Analiza MES jest obiektem App::DocumentObjectGroupPython z niestandardową ikoną i dodatkowymi właściwościami.

Odnośniki internetowe