Klasa `Class.UIListLayout` układa elementy UI wierszami lub kolumnami wewnątrz
kontenera UI rodzica, w zależności od
`Class.UIListLayout.FillDirection|FillDirection`. Właściwości
`Class.GuiObject.Position|Position` i `Class.GuiObject.Rotation|Rotation`
każdego elementu `Class.GuiObject` są ignorowane lub nadpisywane
przez układ listy, podczas gdy każdy z elementów zachowuje zdefiniowane
`Class.GuiObject.Size|Size`, chyba że układ jest skonfigurowany tak, aby
wykorzystywać układ elastyczny. Zobacz [List and Flex Layouts](/ui/list-flex-layouts)
po więcej informacji.

<img src="../../../assets/engine-api/classes/UIListLayout/FillDirection.png"
width="720" alt="UIListLayouts ilustrujące kierunek wypełnienia, poziomy
lub pionowy." />

Aby kontrolować kolejność układu elementów rodzeństwa, ustaw
`Class.UIListLayout.SortOrder|SortOrder` na `Enum.SortOrder.Name` lub
`Enum.SortOrder.LayoutOrder`, a następnie zmień nazwy elementów
w porządku alfanumerycznym lub ustaw wartość `Class.GuiObject.LayoutOrder|LayoutOrder`
odpowiednio. `Class.UIListLayout` automatycznie przearanżuje elementy,
 gdy elementy są dodawane/usuwane, lub jeśli nazwa `Class.Instance.Name|Name`
 lub `Class.GuiObject.LayoutOrder|LayoutOrder` rodzeństwa ulegnie zmianie.

<img src="../../../assets/engine-api/classes/UIListLayout/SortOrder.png"
width="720" alt="Przykłady układu listy ilustrujące sortowanie numeryczne LayoutOrder
lub sortowanie alfanumeryczne według nazwy." />

Margines między rodzeństwem kontrolowany jest przez właściwość
`Class.UIListLayout.Padding|Padding`, a zawijanie wewnątrz granic
kontenera rodzica przez boolean `Class.UIListLayout.Wraps|Wraps`.
Wyrównanie rodzeństwa w kontenerze rodzica kontrolowane jest przez
`Class.UIListLayout.HorizontalAlignment|HorizontalAlignment` oraz
`Class.UIListLayout.VerticalAlignment|VerticalAlignment`, chyba że układ
jest skonfigurowany tak, aby wykorzystywać
[flex layout](/ui/list-flex-layouts#flex-layouts).

Uwaga, że użycie listy układu z włączoną opcją [flex‑enabled](/ui/list-flex-layouts#flex-layouts)
ma wpływ na wydajność, ponieważ wymagane są dodatkowe obliczenia do
obliczenia rozmiarów podstaw elastycznych, rozmiarów elastycznych
i zawijania linii. Flex jest włączony w `Class.UIListLayout`, gdy
następujące właściwości są ustawione, lub gdy jakiekolwiek rodzeństwo
`Class.GuiObject` ma `Class.UIFlexItem` jako rodzica:

- `Class.UIListLayout.HorizontalFlex|HorizontalFlex` i/lub
  `Class.UIListLayout.VerticalFlex|VerticalFlex` **nie są** ustawione na
  `Enum.UIFlexAlignment.None`.
- `Class.UIListLayout.ItemLineAlignment|ItemLineAlignment` **nie jest** ustawione na
  `Enum.ItemLineAlignment.Automatic`.
- `Class.UIListLayout.Wraps|Wraps` jest `true`.


UIListLayout

Gdy kierunek wypełnienia układu listy `Class.UIListLayout.FillDirection|FillDirection`
jest ustawiony na `Enum.FillDirection.Horizontal`, właściwość
`Class.UIListLayout.HorizontalFlex|HorizontalFlex` określa, jak
rozdzielać dodatkową przestrzeń poziomą w kontenerze rodzica.

<table size="small">
  <thead>
    <tr>
      <th>Ustawienie</th>
      <th>Zachowanie rodzeństwa</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>Enum.UIFlexAlignment.None|None</code></td>
      <td>Brak elastycznego zachowania; rodzeństwo zachowuje swoją zdefiniowaną szerokość.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.Fill|Fill</code></td>
      <td>Rodzeństwo zmienia rozmiar poziomy, aby wypełnić cały kontener rodzica, nadpisując swoją
definiowaną szerokość. Liczba rodzeństwa w wierszu pozostaje bez zmian; na przykład, jeśli trzy
rodzeństwa mieszczą się poziomo w szerokości kontenera pod ustawieniem <code>Enum.UIFlexAlignment.None|None</code>,
te trzy rodzeństwa zmienią rozmiar, aby wypełnić całą szerokość.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceAround|SpaceAround</code></td>
      <td>Rodzeństwo zachowuje swoją zdefiniowaną szerokość. Równy odstęp jest dodawany po obu
stronach każdego rodzeństwa.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceBetween|SpaceBetween</code></td>
      <td>Rodzeństwo zachowuje swoją zdefiniowaną szerokość. Równy odstęp\jest dodawany <b>między</b> rodzeństwem, ale nie jest dodawana dodatkowa przestrzeń <b>wokół</b> rodzeństwa.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceEvenly|SpaceEvenly</code></td>
      <td>Rodzeństwo zachowuje swoją zdefiniowaną szerokość. Równy odstęp jest dodawany zarówno <b>między</b> jak i <b>wokół</b> rodzeństwa.</td>
    </tr>
  </tbody>
</table>

<img src="../../../assets/engine-api/classes/UIListLayout/HorizontalFlex-Options.png" width="800" alt="Przykłady UIListLayout pokazujące, jak każda opcja HorizontalFlex wpływa na rozmiar
i odstępy obiektów UI rodzeństwa." />

##### Zachowanie w kierunku przeciwnym

W **pionowych** układach list (`Class.UIListLayout.FillDirection|FillDirection` ustawiony na
`Enum.FillDirection.Vertical`), właściwość `Class.UIListLayout.HorizontalFlex|HorizontalFlex`
określa, jak rozdzielać rodzeństwo w **poziomym kierunku przeciwnym**. W
takich układach, ustawienie `Enum.UIFlexAlignment.Fill` sprawia, że rodzeństwo wypełnia
całą przestrzeń poziomą, podczas gdy pionowe odstępy są dostosowywane zgodnie z
`Class.UIListLayout.VerticalFlex|VerticalFlex`.

<img src="../../../assets/engine-api/classes/UIListLayout/HorizontalFlex-Cross-Direction.png" width="720" alt="Diagram pokazujący, jak HorizontalFlex wpływa na poziomy rozmiar obiektów UI rodzeństwa, gdy kierunek wypełnienia UIListLayout jest ustawiony na pionowy." />

##### Interakcja z AutomaticSize

Jeśli `Class.GuiObject.AutomaticSize` jest włączona dla dziecka `Class.UIListLayout`
w kierunku `Class.UIListLayout.FillDirection|FillDirection`, jest to interpretowane jako
"automatyczna podstawa elastyczna" i określa rozmiar `Class.GuiObject`,
z którego może się rozwijać lub kurczyć.

Jeśli `Class.GuiObject.AutomaticSize` jest włączona dla dziecka `Class.UIListLayout`
w **kierunku przeciwnym**, jest to interpretowane jako
"automatyczny rozmiar krzyżowy" i określa minimalny rozmiar potrzebny do
pomieszczenia całej zawartości dziecka w kierunku przeciwnym.


UIListLayout.HorizontalFlex

Kontroluje, jak rozdzielać dodatkową przestrzeń poziomą.


W [elastycznym układzie](/ui/list-flex-layouts#flex-layouts) definiuje
the **wyrównanie w kierunku przeciwnym** rodzeństwa w obrębie linii. Zobacz
`Enum.ItemLineAlignment` dla wizualnych przykładów.

<table size="small">
  <thead>
    <tr>
      <th>Ustawienie</th>
      <th>Zachowanie rodzeństwa</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>Enum.ItemLineAlignment.Automatic|Automatic</code></td>
      <td>Wyrównuje rodzeństwo układu lub konkretnego <code>Class.UIFlexItem</code> rodzica do
układu <code>Class.UIListLayout.HorizontalAlignment|HorizontalAlignment</code> lub
<code>Class.UIListLayout.VerticalAlignment|VerticalAlignment</code>, w zależności od jego
<code>Class.UIListLayout.FillDirection|FillDirection</code>.</td>
    </tr>
    <tr>
      <td><code>Enum.ItemLineAlignment.Start|Start</code></td>
      <td>Wyrównuje rodzeństwo układu lub konkretnego <code>Class.UIFlexItem</code> rodzica do
<b>góry</b> linii w przypadku poziomego wypełnienia lub do<b>lewej</b> linii w przypadku pionowego wypełnienia.</td>
    </tr>
    <tr>
      <td><code>Enum.ItemLineAlignment.Center|Center</code></td>
      <td>Wyrównuje rodzeństwo układu lub konkretnego <code>Class.UIFlexItem</code> rodzica do
<b>centrum</b> linii w przypadku poziomego lub pionowego wypełnienia.</td>
    </tr>
    <tr>
      <td><code>Enum.ItemLineAlignment.End|End</code></td>
      <td>Wyrównuje rodzeństwo układu lub konkretnego <code>Class.UIFlexItem</code> rodzica do
<b>dół</b> linii w przypadku poziomego wypełnienia lub do<b>prawej</b> linii w przypadku pionowego wypełnienia.</td>
    </tr>
    <tr>
      <td><code>Enum.ItemLineAlignment.Stretch|Stretch</code></td>
      <td>Rozciąga rodzeństwo układu lub konkretnego <code>Class.UIFlexItem</code> rodzica, aby
wypełnić całą przestrzeń w kierunku przeciwnym linii w przypadku poziomego lub pionowego wypełnienia.</td>
    </tr>
  </tbody>
</table>

<img src="../../../assets/engine-api/classes/UIListLayout/ItemLineAlignment.png" width="720" alt="Przykłady opcji dla ItemLineAlignment w poziomym kierunku wypełnienia." />


UIListLayout.ItemLineAlignment

W elastycznym układzie definiuje **wyrównanie w kierunku przeciwnym**
rodzeństwa w obrębie linii.


Określa ilość wolnej przestrzeni między każdym elementem, ustawioną na skalę
( procent rozmiaru rodzica w danym kierunku) lub przesunięcie (statyczna wartość
odstępu podobna do rozmiaru piksela).


UIListLayout.Padding

Ilość wolnej przestrzeni między każdym elementem.


Gdy kierunek wypełnienia układu listy `Class.UIListLayout.FillDirection|FillDirection`
jest ustawiony na `Enum.FillDirection.Vertical`, właściwość
`Class.UIListLayout.VerticalFlex|VerticalFlex` określa, jak
rozdzielać dodatkową przestrzeń pionową w kontenerze rodzica.

<table size="small">
  <thead>
    <tr>
      <th>Ustawienie</th>
      <th>Zachowanie rodzeństwa</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>Enum.UIFlexAlignment.None|None</code></td>
      <td>Brak elastycznego zachowania; rodzeństwo zachowuje swoją zdefiniowaną wysokość.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.Fill|Fill</code></td>
      <td>Rodzeństwo zmienia rozmiar pionowo, aby wypełnić cały kontener rodzica, nadpisując
swoją zdefiniowaną wysokość. Liczba rodzeństwa w kolumnie pozostaje bez
zmian; na przykład, jeśli trzy rodzeństwa mieszczą się pionowo w wysokości
kontenera pod ustawieniem <code>Enum.UIFlexAlignment.None|None</code>, te trzy rodzeństwa
zmienią rozmiar, aby wypełnić całą wysokość.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceAround|SpaceAround</code></td>
      <td>Rodzeństwo zachowuje swoją zdefiniowaną wysokość. Równy odstęp jest dodawany
a po obu stronach każdego rodzeństwa.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceBetween|SpaceBetween</code></td>
      <td>Rodzeństwo zachowuje swoją zdefiniowaną wysokość. Równy odstęp jest dodawany <b>między</b>
rodzeństwem, ale nie jest dodawana dodatkowa przestrzeń <b>wokół</b> rodzeństwa.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceEvenly|SpaceEvenly</code></td>
      <td>Rodzeństwo zachowuje swoją zdefiniowaną wysokość. Równy odstęp jest dodawany zarówno <b>między</b> jak i <b>wokół</b> rodzeństwa.</td>
    </tr>
  </tbody>
</table>

<img src="../../../assets/engine-api/classes/UIListLayout/VerticalFlex-Options.png" width="800" alt="Przykłady UIListLayout pokazujące, jak każda opcja VerticalFlex wpływa na rozmiar i
ostępy obiektów UI rodzeństwa." />

##### Zachowanie w kierunku przeciwnym

W **poziomych** układach list (`Class.UIListLayout.FillDirection|FillDirection` ustawionym na
`Enum.FillDirection.Horizontal`), właściwość `Class.UIListLayout.VerticalFlex|VerticalFlex`
określa, jak rozdzielać rodzeństwo w **pionowym kierunku przeciwnym**. W
takich układach, ustawienie `Enum.UIFlexAlignment.Fill` sprawia, że rodzeństwo wypełnia
całą przestrzeń pionową, podczas gdy poziome odstępy są dostosowywane zgodnie z
`Class.UIListLayout.HorizontalFlex|HorizontalFlex`.

<img src="../../../assets/engine-api/classes/UIListLayout/VerticalFlex-Cross-Direction.png" width="720" alt="Diagram pokazujący, jak VerticalFlex wpływa na pionowy rozmiar obiektów UI rodzeństwa, gdy kierunek wypełnienia UIListLayout jest ustawiony na poziomy." />

##### Interakcja z AutomaticSize

Jeśli `Class.GuiObject.AutomaticSize` jest włączona dla dziecka `Class.UIListLayout`
w kierunku `Class.UIListLayout.FillDirection|FillDirection`, jest to interpretowane jako
"automatyczna podstawa elastyczna" i określa rozmiar `Class.GuiObject`,
z którego może się rozwijać lub kurczyć.

Jeśli `Class.GuiObject.AutomaticSize` jest włączona dla dziecka `Class.UIListLayout`
w **kierunku przeciwnym**, jest to interpretowane jako
"automatyczny rozmiar krzyżowy" i określa minimalny rozmiar potrzebny do
pomieszczenia całej zawartości dziecka w kierunku przeciwnym.


UIListLayout.VerticalFlex

Kontroluje, jak rozdzielać dodatkową przestrzeń pionową.


Kontroluje, czy rodzeństwo w kontenerze rodzica zawija się do innej linii,
 gdy ich domyślny rozmiar przekroczy szerokość/wysokość granic kontenera.

<img src="../../../assets/engine-api/classes/UIListLayout/Wraps.png" width="800" alt="Diagram pokazujący, jak Wraps wpływa na dystrybucję rodzeństwa wewnątrz granic kontenera rodzica." />


UIListLayout.Wraps

Kontroluje, czy rodzeństwo w kontenerze rodzica zawija się.


Układa elementy UI wierszami lub kolumnami wewnątrz kontenera UI
rodzica.


Klasa bazowa dla układów UI w stylu siatki.


Ten przykład kodu demonstruje sortowanie danych za pomocą
`Class.UIGridStyleLayout.SortOrder` i `Class.GuiObject.LayoutOrder`.

Metoda ApplyLayout wymusza ponowne ułożenie siostrzanych elementów UI
w przypadku, gdy mogą ulec zmianie kryteria sortowania (na przykład
kiedy `Class.UIGridStyleLayout.SortOrder` jest ustawiona na Custom, a
temperaturze `Class.UIGridStyleLayout:SetCustomSortFunction()` zmieniono).
Ponowne ułożenia zachodzą automatycznie, gdy elementy UI są dodawane/usuwane,
lub gdy zmienia się ich `Class.Instance.Name` lub `Class.GuiObject.LayoutOrder`.

Sposób, w jaki siostrzane elementy UI są układane, zależy od
implementacji tej klasy abstrakcyjnej. Innymi słowy, konkretna klasa
jak `Class.UIListLayout` lub `Class.UIGridLayout` odpowiada za
efektywne rozmieszczenie elementów.


UIGridStyleLayout:ApplyLayout

Wymusza ponowne ułożenie siostrzanych elementów UI.


Ta metoda jest przestarzała. Użyj zamiast tego `Class.UIGridStyleLayout.SortOrder`.

Funkcja powinna przyjmować dwa argumenty (każdy z nich będzie dzieckiem
`Class.Instance` do porównania) i zwracać true, jeśli a występuje przed b,
inaczej zwracać false. Innymi słowy, użyj tej funkcji w taki sam sposób,
w jaki użyłbyś funkcji '
 funkcja. Sortowanie powinno być deterministyczne, w przeciwnym razie sortowanie się nie powiedzie
i wypadnie do kolejności nazw.


UIGridStyleLayout:SetCustomSortFunction

function

Ustawia funkcję używaną do określenia kolejności elementów, gdy SortOrder
jest ustawione na Custom.


UIGridStyleLayout

Właściwość **AbsoluteContentSize** klasy `Class.UIGridStyleLayout`
ujawnia, ile przestrzeni zajmują elementy siatki, w tym wszelkie
odstępy utworzone przez siatkę. Ta właściwość jest szczególnie przydatna do
rozmiarowania kontenerów siatek, takich jak `Class.Frame|Frames`, aby
upewnić się, że nie są one większe niż sama siatka.

Ta właściwość aktualizuje się natychmiast po jej odczytaniu. Nie wywoła
wydarzenia `Class.Object.Changed` natychmiast po zmianie UI, ale jeśli
wartość zostanie odczytana, stanie się aktualna, a wydarzenie
`Class.Object.Changed` zostanie wywołane przy następnym kroku renderowania.


UIGridStyleLayout.AbsoluteContentSize

Absolutny rozmiar przestrzeni zajmowanej przez układ siatki.


Właściwość **FillDirection** określa oś, wzdłuż której układane są
elementy UI. `Enum.FillDirection.Horizontal` ustawia obiekty od lewej
do prawej, podczas gdy `Enum.FillDirection.Vertical` ustawia obiekty od
góry do dołu. Aby odwrócić elementy, na przykład w celu ułożenia ich od
prawej do lewej, trzeba odwrócić sortowanie; na przykład negując wartości
`Class.GuiObject.LayoutOrder` obiektów UI dziecięcych, gdy
`Class.UIGridStyleLayout.SortOrder` jest ustawione na
`Enum.SortOrder.LayoutOrder`.

<img src="../../../assets/engine-api/classes/UIListLayout/FillDirection.png" width="720" />


UIGridStyleLayout.FillDirection

Określa oś, wzdłuż której układane są obiekty UI.


Właściwość **HorizontalAlignment** określa wyrównanie osi **X**
elementów UI w siatce, podobnie jak `Class.TextLabel.TextXAlignment`
robi z `Class.TextLabel.Text`.


UIGridStyleLayout.HorizontalAlignment

Określa poziome wyrównanie elementów UI w obrębie elementu nadrzędnego.


Właściwość **SortOrder** określa kolejność, w jakiej obiekty UI dziecięce
są umieszczane w układzie.

Dla `Enum.SortOrder.LayoutOrder` stosowane jest rosnące sortowanie na
właściwości `Class.GuiObject.LayoutOrder|LayoutOrder` obiektów UI
dziecięcych. Jeśli dwie dzieci mają tę samą wartość
`Class.GuiObject.LayoutOrder|LayoutOrder`, to obiekt, który
został dodany wcześniej do obiektu nadrzędnego, ma pierwszeństwo.

Dla `Enum.SortOrder.Name` stosowane jest alfanumeryczne sortowanie na
`Class.Instance.Name` obiektów UI dziecięcych.

<img src="../../../assets/engine-api/classes/UIListLayout/SortOrder.png" width="720" />


UIGridStyleLayout.SortOrder

Określa kolejność, w jakiej obiekty UI dziecięce są umieszczane w układzie.


Właściwość **VerticalAlignment** określa wyrównanie osi **Y**
sieci elementów UI, podobnie jak `Class.TextLabel.TextYAlignment` robi
z `Class.TextLabel.Text`.


UIGridStyleLayout.VerticalAlignment

Określa pionowe wyrównanie elementów UI w obrębie elementu nadrzędnego.


UILayout

Klasa bazowa dla klas ograniczeń UI i układu; dziedziczy z
`Class.UIBase`.


UIComponent

Klasa bazowa dla klas ograniczeń UI i układu.


`Class.UIBase` jest klasą bazową dla klas układu UI i ograniczeń.


UIBase

`Instance` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox,
które mogą być częścią drzewa `Class.DataModel`.

Nie jest możliwe bezpośrednie tworzenie obiektów `Instance` jako korzenia, ale specjalny
konstruktor `Datatype.Instance.new()` tworzy obiekty za pomocą kodu, biorąc
nazwę klasy jako parametr i zwracając stworzony obiekt.

Demonstruje wykrywanie zmian w przodkach instancji przez podłączenie do
`Class.Instance.AncestryChanged` event.

Rodzic ChangingPart jest ustawiany na różne wartości w czasie. Rodzicem
tej części jest przodek części, więc event `Class.Instance.AncestryChanged`
wyzwoli się za każdym razem, gdy się zmieni.


Wyzwala się, gdy ta instancja zmienia rodzica lub gdy zmienia się
rodzic jakiegokolwiek z jej przodków.

Możesz użyć tego zdarzenia, aby śledzić usunięcie instancji w Studio,
najlepiej ręczne usunięcie w Eksploratorze lub przez wtyczkę. Jeśli musisz
wykrywać, kiedy instancja zostaje zniszczona za pomocą `Class.Instance:Destroy()`,
zamiast tego użyj zdarzenia `Class.Instance.Destroying`.

Instance.AncestryChanged

child

Instancja, której zmieniła się właściwość `Class.Instance.Parent|Parent`,
która może być tą instancją lub dalszym przodkiem, **nie**koniecznie
dowolna instancja, do której jest podłączony handler.

parent

Wyzwala się, gdy zmienia się właściwość `Class.Instance.Parent` tego obiektu
lub jednego z jego przodków.

To zdarzenie wyzwala się, gdy jakikolwiek atrybut na instancji zostaje
zmieniony, w tym kiedy atrybut jest ustawiany na `nil`. Nazwa zmienionego
atrybutu jest przekazywana do podłączonej funkcji.

Na przykład poniższy fragment kodu łączy funkcję `attributeChanged()`
, aby uruchomić ją, gdy zmienia się jeden z atrybutów części:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "zmieniono")
end

part.AttributeChanged:Connect(attributeChanged)
```
Zobacz także `Class.Instance:GetAttributeChangedSignal()`, które zwraca
zdarzenie, które wyzwala się, gdy zmienia się określony atrybut.

Instance.AttributeChanged

attribute

Nazwa atrybutu, który został zmieniony.

Wyzwala się, gdy jakikolwiek atrybut zostaje zmieniony w `Class.Instance`.

Ten fragment kodu wypisuje nazwy obiektów, które są dodawane do Workspace:

Wyzwala się po dodaniu obiektu jako dziecka do tego `Class.Instance`.

Uwaga, przy używaniu tej metody na kliencie w celu wykrycia obiektów
tworzonych przez serwer, konieczne jest użycie `Class.Instance:WaitForChild()`
przy indeksowaniu potomków tych obiektów. Dzieje się tak, ponieważ obiekt i jego
potomstwo nie są gwarantowane do replikacji z serwera do klienta
jednocześnie. Na przykład:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Użyj WaitForChild(), ponieważ potomkowie mogą jeszcze nie zostać
	local head = child:WaitForChild("Head")
end)
```
Uwaga, to zdarzenie działa tylko dla bezpośrednich dzieci
`Class.Instance`. Aby zdarzenie, które obejmuje wszystkie potomków,
 używasz `Class.Instance.DescendantAdded`.

Zobacz także `Class.Instance.ChildRemoved`.

Instance.ChildAdded

Wyzwala się po dodaniu obiektu jako dziecka do tego `Class.Instance`.

Instance.childAdded

Ten fragment kodu drukuje nazwy obiektów, gdy są one usuwane z
Workspace:

Wyzwala się po usunięciu dziecka z tego `Class.Instance`.

Usunięcie odnosi się do sytuacji, gdy rodzic obiektu zmienia się z
tego `Class.Instance` na coś innego niż ten `Class.Instance`. Uwaga, to
zdarzenie również wyzwoli się, gdy dziecko zostanie zniszczone (przy użyciu
`Class.Instance:Destroy()`), ponieważ funkcja niszcząca ustawia rodzica
obiektu na `nil`.

To zdarzenie działa tylko dla bezpośrednich dzieci `Class.Instance`.
W przypadku zdarzenia, które obejmuje wszystkich potomków,
 używasz `Class.Instance.DescendantRemoving`.

Zobacz także `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Wyzwala się po usunięciu dziecka z tego `Class.Instance`.

Ten przykład wydrukuje nazwę obiektu, który zostanie dodany do
Workspace:


To zdarzenie wyzwala się po dodaniu potomka do `Class.Instance`.

Ponieważ wyzwala się dla każdego potomka, zamieszczenie obiektu jako dziecka w `Class.Instance`
wyzwoli wydarzenie dla tego obiektu i wszystkich jego potomków indywidualnie.

Jeśli interesują cię tylko **bezpośrednie dzieci** `Class.Instance`,
  użyj `Class.Instance.ChildAdded` zamiast tego.

Zobacz także `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Wyzwala się po dodaniu potomka do `Class.Instance`.

Poniższy przykład wypisuje nazwę każdego potomka w momencie, gdy jest usuwany
z Workspace:

To zdarzenie wyzwala się **natychmiast przed** zmianą rodzica `Class.Instance`
w taki sposób, że instancja **potomka** nie będzie już potomkiem. `Class.Instance:Destroy()|Destroy()`
zmienia rodzica instancji na `nil`, dlatego wywołanie tej metody na
potomku rodzica spowoduje wyzwolenie tego zdarzenia.

Ponieważ to zdarzenie wyzwala się **przed** usunięciem potomka,
rodzic potomka pozostanie niezmieniony w czasie wyzwalania tego zdarzenia. Jeśli
potomek jest również **bezpośrednim dzieckiem** rodzica, to zdarzenie wyzwoli
się przed `Class.Instance.ChildRemoved`.

Jeśli potomek ma dzieci, to zdarzenie wyzwala się najpierw dla potomka,
a potem dla jego dzieci.

#### Ostrzeżenie

To zdarzenie wyzwala się z obiektem potomka, który jest usuwany.
Próba ustawienia `Class.Instance.Parent|Parent` potomka na coś
innego zakończy się niepowodzeniem. Poniżej znajduje się przykład, który
demonstracyjnie to pokazuje:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Nie manipuluj rodzicem potomka w tej funkcji!
	-- To zdarzenie wyzwala się Z POWODU manipulacji rodzicem i zmiana jeszcze
	-- się nie zdarzyła, więc zmiana rodzica w ten sposób jest problematyczna:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Zobacz także `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

Wyzwala się natychmiast przed usunięciem potomka `Class.Instance`.

Ten przykład pokazuje, jak w przypadku używania zachowania sygnału natychmiastowego, obiekt
instancji, który jest niszczony, pozostaje w miejscu, aż połączona funkcja zrealizuje.


Ten przykład demonstruje, jak podczas używania zachowania sygnału opóźnionego, instancja
zostaje zniszczona przed wywołaniem sygnału.


`Class.Instance` nigdy nie zostanie usunięty z pamięci, gdy podłączona
funkcja wciąż go używa. Jednak jeśli funkcja w jakimkolwiek momencie
zablokuje działanie, `Class.Instance` i jego potomstwo zostaną
przypisane do `nil`.

Jeśli właściwość `Class.Workspace.SignalBehavior` jest ustawiona na
`Enum.SignalBehavior.Immediate`, to zdarzenie wyzwala się natychmiast przed tym,
jak `Class.Instance` lub którekolwiek z jego przodków zostaną
zniszczone za pomocą `Class.Instance:Destroy()`.

Jeśli właściwość `Class.Workspace.SignalBehavior` jest ustawiona na
`Enum.SignalBehavior.Deferred`, to zdarzenie wyzwala się w następnym punkcie
odnawiania, co będzie po tym, jak `Class.Instance` lub którekolwiek z jego
przodków zostaną zniszczone za pomocą `Class.Instance:Destroy()`.

Przy zachowaniu `Enum.SignalBehavior.Deferred|Deferred` połączenie skryptu
z własnym zdarzeniem `Class.Instance.Destroying` jest problematyczne,
ponieważ skrypt zostanie zniszczony przed wykonaniem wywołania zwrotnego
(co oznacza, że nie zostanie wykonane).

Podczas usuwania `Class.Instance` w Studio, np. ręcznie przez
Edycję w [Eksploratorze](/studio/explorer), `Class.Instance`
nigdy nie jest niszczony. Zamiast tego jego rodzic jest ustawiany na `nil`,
co można śledzić za pomocą `Class.Instance.AncestryChanged`.

Instance.Destroying

Wyzwala się natychmiast przed (lub jest opóźnione do po) zniszczenia instancji
dzięki `Class.Instance:Destroy()`. 

To zdarzenie wyzwala się, gdy jakakolwiek właściwość stylu jest zmieniana na instancji,
w tym kiedy właściwość jest ustawiana na `nil`.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Właściwości stylu zmienione")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```

Instance.StyledPropertiesChanged

Wyzwala się, gdy jakakolwiek właściwość stylu jest zmieniana na instancji,
 w tym kiedy właściwość jest ustawiana na `nil`.

Ta metoda przypisuje tag do instancji, bez efektu, jeśli tag
jest już przypisany. Pomyślne dodanie tagu spowoduje wywołanie sygnału stworzonego przez
`Class.CollectionService:GetInstanceAddedSignal()` dla danego tagu.

#### Ostrzeżenia

- Tag instancji, które zostały dodane po stronie klienta, zostanie usunięty,
  jeśli serwer później doda lub usunie tag dla tej instancji, ponieważ serwer
  replikuje wszystkie tagi razem i zastępuje poprzednie tagi.

- Podczas oznaczania instancji powszechne jest, że niektóre zasoby są używane do
  nadania tagowi jego funkcji, na przykład połączenia wydarzeń lub tabele.
  Aby zapobiec wyciekom pamięci, dobrze jest je oczyścić (rozłączyć,
  ustawić na `nil`, itp.) kiedy już nie są potrzebne dla tagu. Zrób to
  podczas wywoływania `Class.Instance:RemoveTag()`, wywołując
  `Class.Instance:Destroy()`, lub w funkcji podłączonej do sygnału
  zwróconego przez `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

Funkcja dzieci zwraca tablicę dzieci obiektu.

Instance:children

Ta metoda usuwa wszystkich potomków instancji oraz ich potomków.

```
local part = Instance.new("Part")

-- Dodaj trochę iskier
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Dzieci:", #part:GetChildren())  --> Dzieci: 3

part:ClearAllChildren()

print("Dzieci:", #part:GetChildren())  --> Dzieci: 0
```
Jeśli nie chcesz usunąć **wszystkich** dzieci i potomków, użyj albo
`Class.Instance:GetChildren()` albo `Class.Instance:GetDescendants()` by
przejść przez te dzieci/potomków i wybrać, co zniszczyć. Na przykład, poniższy
przykład kodu usunie wszystkie
`Class.BasePart|BaseParts` opadające z `Class.Model`:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

Ta metoda usuwa wszystkich potomków instancji.

Demonstracja klonowania modelu za pomocą `Class.Instance:Clone()`.


`Clone()` tworzy kopię instancji oraz wszystkich jej potomków,
ignorując wszystkie instancje, które nie są `Class.Instance.Archivable|Archivable`. Kopia
instancji głównej jest zwracana przez tę metodę, a jej `Class.Instance.Parent|Parent`
jest ustawiane na `nil`. Zauważ, że jeśli sama instancja ma
`Class.Instance.Archivable|Archivable` ustawione na `false`, ta metoda
zwróci `nil`.

Jeśli właściwość referencyjna, taka jak `Class.ObjectValue.Value`, jest ustawiona w
sklonowanej instancji, wartość właściwości kopii zależy od wartości oryginału:

- Jeśli właściwość referencyjna odnosi się do instancji, która również została
  sklonowana, kopia odniesie się do kopii.
- Jeśli właściwość referencyjna odnosi się do instancji, która **nie** została
  sklonowana, ta sama wartość jest utrzymywana w kopii.

Instance:Clone

Tworzy kopię instancji oraz wszystkich jej potomków, ignorując instancje,
które nie są `Class.Instance.Archivable|Archivable`.

Instance:clone

Demonstruje niszczenie elementu za pomocą funkcji `Class.Instance:Destroy()`.

Ta funkcja jest prawidłowym sposobem na pozbycie się obiektów, które nie są już
potrzebne.


Ustawia właściwość `Class.Instance.Parent` na `nil`, blokuje
właściwość `Class.Instance.Parent`, rozłącza wszystkie połączenia i wywołuje
`Destroy()` na wszystkich dzieciach. Ta metoda jest właściwym sposobem
na pozbycie się obiektów, które nie są już potrzebne.

Pozbywanie się niepotrzebnych obiektów jest ważne, ponieważ niepotrzebne obiekty i
połączenia w miejscu zużywają pamięć, co może prowadzić do poważnych problemów z wydajnością
z upływem czasu.

Jako najlepsza praktyka po wywołaniu `Destroy()` na obiekcie, ustaw wszelkie
zmienne odwołujące się do obiektu (lub jego potomków) na `nil`. To
zapobiega dostępowi Twojego kodu do czegokolwiek związanego z obiektem.

```lua
local part = Instance.new("Part")
part.Name = "Witaj, świecie"
part:Destroy()
-- Nie rób tego:
print(part.Name)  --> "Witaj, świecie"
-- Zrób to, aby zapobiec działaniu powyższej linii:
part = nil
```
Po zniszczeniu instancji `Class.Instance` tą metodą, nie można jej
ponownie użyć, ponieważ właściwość `Class.Instance.Parent` jest zablokowana. Aby
**tymczasowo** usunąć obiekt zamiast go zniszczyć, ustaw `Class.Instance.Parent|Parent`
na `nil`. Na przykład:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Aby zniszczyć obiekt po określonym czasie, użyj
`Class.Debris:AddItem()`.

Instance:Destroy

Ustawia właściwość `Class.Instance.Parent` na `nil`, blokuje
właściwość `Class.Instance.Parent`, rozłącza wszystkie połączenia i wywołuje
`Destroy()` na wszystkich dzieciach.

Instance:destroy

Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Instance.Name` jest równy podanej nazwie.

Ta metoda działa w górę, co oznacza, że zaczyna od natychmiastowego
`Class.Instance.Parent` instancji i pracuje w kierunku `Class.DataModel`. Jeśli nie
zostanie znaleziony dopasowany przodek, zwraca `nil`.

Poniższy fragment kodu znajdzie pierwszego przodka obiektu
nazywanego `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Dla wariantów tej metody, które znajdują przodków określonej klasy,
zobacz `Class.Instance:FindFirstAncestorOfClass()` oraz
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Nazwa `Class.Instance.Name`, której należy szukać.

Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Instance.Name` jest równy podanej nazwie.

Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Object.ClassName` jest równy podanemu className.

Ta metoda działa w górę, co oznacza, że zaczyna od natychmiastowego
`Class.Instance.Parent` instancji i pracuje w kierunku `Class.DataModel`. Jeśli nie
zostanie znaleziony dopasowany przodek, zwraca `nil`.

Powszechnym użyciem tej metody jest znalezienie `Class.Model`, do
której należy `Class.BasePart`. Na przykład:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Ta metoda jest wariantem `Class.Instance:FindFirstAncestor()`, która
sprawdza właściwość `Class.Object.ClassName`, a nie `Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` również
istnieje, używając metody `Class.Object:IsA()` w celu respektowania dziedziczenia klas.

Instance:FindFirstAncestorOfClass

className

Nazwa `Class.Object.ClassName`, której należy szukać.

Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Object.ClassName` jest równy podanemu className.

Zwraca pierwszego przodka `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla podanego className.

Ta metoda działa w górę, co oznacza, że zaczyna od natychmiastowego
`Class.Instance.Parent` instancji i pracuje w kierunku `Class.DataModel`. Jeśli nie
zostanie znaleziony dopasowany przodek, zwraca `nil`.

W przeciwieństwie do `Class.Instance:FindFirstAncestorOfClass()`, ta metoda
używa `Class.Object:IsA()`, co szanuje dziedziczenie klas. Na przykład:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Z tego powodu, poniższy przykład kodu zwróci pierwszego
przodka `Class.BasePart`, niezależnie od tego, czy jest to `Class.WedgePart`,
`Class.MeshPart` czy `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Zobacz także `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Zwraca pierwszego przodka `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla podanego className.

Poniższy kod będzie szukał obiektu o nazwie "Brick" w Workspace. Jeśli go znajdzie,
zamieni nazwę obiektu na "Foo".

Zwraca pierwsze dziecko `Class.Instance` z podaną nazwą, lub
`nil`, jeśli takie dziecko nie istnieje. Jeśli opcjonalny argument
`recursive` jest `true`, ta metoda przeszukuje wszystkich potomków, a nie tylko natychmiastowe dzieci
`Class.Instance`.

#### Sprawdzanie istnienia obiektu

`FindFirstChild()` jest konieczny, jeśli musisz zweryfikować, czy obiekt istnieje
przed kontynuowaniem. Próba indeksowania dziecka po nazwie za pomocą operatora kropki
zgłasza błąd, jeśli dziecko nie istnieje.

```lua
local Workspace = game:GetService("Workspace")

-- Poniższa linia zgłasza błąd, jeśli część nie istnieje w workspace
Workspace.Part.Transparency = 0.5
```
Lepszym podejściem jest użycie `FindFirstChild()`, aby najpierw sprawdzić
`Part`, a następnie użyć instrukcji `if`, aby uruchomić kod, który go potrzebuje.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Znalezienie dziecka, którego nazwa pasuje do właściwości

Czasami nazwa `Class.Instance.Name|Name` obiektu jest taka sama jak
właściwość jego `Class.Instance.Parent|Parent`. Podczas używania operatora kropki,
 właściwości mają pierwszeństwo przed dziećmi, jeśli mają tę samą nazwę.

W poniższym przykładzie, `Class.Folder` o nazwie `Color` jest dodawane do
`Class.Part`, który również ma właściwość `Class.Part.Color`. Zauważ, że
`part.Color` odnosi się do wartości właściwości `Datatype.Color3`, a nie do obiektu dziecka `Class.Folder`. Korzyścią z używania
`Class.Instance:FindFirstChild()|FindFirstChild()` jest to, że
wprowadzenie nowych właściwości nie stwarza ryzyka dla twojego kodu.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
f.folder.Name = "Color"
f.folder.Parent = part
local c1 = part.Color  -- Właściwość
local c2 = part:FindFirstChild("Color")  -- Obiekt folderu
```

#### Uwagi dotyczące wydajności

`Class.Instance:FindFirstChild()|FindFirstChild()` zajmuje około 20% więcej czasu
niż użycie operatora kropki i prawie 8 razy więcej niż po prostu przechowywanie
dostępu do obiektu. Z tego powodu warto unikać wywoływania go w kodzie
zależnym od wydajności, takim jak w ciasnych pętlach lub funkcjach podłączonych
do `Class.RunService.Heartbeat` oraz `Class.RunService.PreRender`. Zamiast tego,
przechowuj wynik w zmiennej lub rozważ użycie
`Class.Instance.ChildAdded|ChildAdded` lub
`Class.Instance:WaitForChild()|WaitForChild()` aby wykryć, kiedy dziecko o
podanej nazwie stanie się dostępne.

Instance:FindFirstChild

recursive

Czy przeszukiwać rekurencyjnie, czy nie.

Zwraca pierwsze dziecko `Class.Instance` znalezione o podanej nazwie.

Instance:findFirstChild

Zwraca pierwsze dziecko `Class.Instance`, którego
`Class.Object.ClassName|ClassName` jest równe podanemu `className`.
W przeciwieństwie do `Class.Instance:FindFirstChildWhichIsA()`, ta metoda zwraca
tylko obiekty, których klasa pasuje do `className`, ignorując dziedziczenie klas. Jeśli nie
zostanie znalezione dopasowane dziecko, ta metoda zwraca `nil`.

Instance:FindFirstChildOfClass

Zwraca pierwsze dziecko `Class.Instance`, którego
`Class.Object.ClassName|ClassName` jest równe podanej nazwie klasy.

Zwraca pierwsze dziecko `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla podanego className.

Jeśli nie zostanie znalezione dopasowane dziecko, ta metoda zwraca `nil`. Jeśli opcjonalny
argument rekurencyjny jest prawdziwy, ta metoda przeszukuje wszystkich potomków, a
nie tylko natychmiastowe dzieci `Class.Instance`.

W przeciwieństwie do `Class.Instance:FindFirstChildOfClass()`, ta metoda używa
`Class.Object:IsA()`, co respektuje dziedziczenie klas. Na przykład:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Z tego powodu, poniższy przykład kodu zwróci pierwsze
dziecko `Class.BasePart`, niezależnie od tego, czy jest to `Class.WedgePart`,
`Class.MeshPart` czy `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Deweloperzy szukający dziecka po nazwie, powinni używać
`Class.Instance:FindFirstChild()` zamiast tego.

Instance:FindFirstChildWhichIsA

Zwraca pierwsze dziecko `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla podanego className.

Zwraca pierwszego potomka znalezionego z podanym `Class.Instance.Name`.

Ta metoda jest wyłączona i nie może być używana. Aby znaleźć pierwszego potomka
instancji, rozważ użycie argumentu `recursive` w
`Class.Instance:FindFirstChild()` zamiast tego.

Instance:FindFirstDescendant

Zwraca pierwszego potomka znalezionego z podanym `Class.Instance.Name`.

Jeśli `Class.Instance` jest `Class.Actor`, zwracana jest sama `Class.Actor`. W przeciwnym razie
zwracany jest najbliższy przodek `Class.Actor`. Jeśli żaden przodek nie jest `Class.Actor`,
rezultatem jest `nil`.

Instance:GetActor

Zwraca `Class.Actor` powiązany z instancją, jeśli taki istnieje.

Ta metoda zwraca wartość, która została przypisana do danej
nazwy atrybutu. Jeśli żaden atrybut nie został przypisany, zostanie zwrócone `nil`.

Na przykład, poniższy fragment kodu ustawia a następnie uzyskuje wartość
atrybutu `InitialPosition` instancji:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### Zobacz także

- `Class.Instance:SetAttribute()`, który ustawia atrybut o danej
  nazwie na daną wartość.
- `Class.Instance:GetAttributes()`, który zwraca słownik par klucz-wartość
  dla każdego z atrybutów instancji.

Instance:GetAttribute

Wartość przypisana do danej nazwy atrybutu. Jeśli żaden
atrybut nie został przypisany, zostanie zwrócone `nil`.

Zwraca wartość przypisaną do danego nazwy atrybutu.

Ta metoda zwraca zdarzenie działa dokładnie jak
`Class.Object.Changed|Changed`, z tą różnicą, że wywołuje się tylko wtedy,
 gdy zmienia się dany atrybut; w efekcie jest podobne do
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`, ale
dla atrybutów.

Zazwyczaj dobrze jest używać tej metody zamiast łączenia z
`Class.Object.Changed|Changed` z funkcją, która sprawdza nazwę atrybutu. Kolejne wywołania tej metody na tym samym obiekcie z tą samą
nazwą atrybutu zwracają ten sam sygnał.

Poniższy przykład kodu zwraca sygnał, który wywołuje funkcję
`attributeChanged()` po tym, jak zmienia się atrybut `InitialPosition` obiektu:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Atrybut zmieniony")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Zobacz także `Class.Instance.AttributeChanged`, które wywołuje się,
gdy jakikolwiek atrybut zmienia się na instancji.

Instance:GetAttributeChangedSignal

Nazwa określonego atrybutu, dla którego zwracany jest sygnał o zmianie.

Zdarzenie, które uruchamia się, gdy dany atrybut się zmienia.

Zwraca zdarzenie, które występuje, gdy dany atrybut się zmienia.

Ta metoda zwraca słownik par klucz-wartość dla każdego atrybutu,
gdzie klucz to nazwa atrybutu, a wartość to wartość nie-`nil`.

Na przykład, poniższy fragment kodu wyświetla atrybuty instancji
i ich wartości:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Zobacz także `Class.Instance:GetAttribute()`, która zwraca wartość, która
została przypisana do danej nazwy atrybutu.

Instance:GetAttributes

Słownik par typ `string → variant` dla każdego atrybutu, gdzie
ciąg to nazwa atrybutu, a wariant to wartość nie-`nil`.

Poniżej znajduje się kod, który wydrukuje nazwę wszystkich obiektów znajdujących się obecnie w Workspace, gdy zostanie wykonany.

Zwraca tablicę (numerowo indeksowaną tabelę), zawierającą wszystkie
bezpośrednie dzieci instancji, lub każdego `Class.Instance`, którego
`Class.Instance.Parent|Parent` jest równy obiektowi. Tablicę można
iterować zarówno za pomocą pętli numerycznej, jak i ogólnej:

```lua
local Workspace = game:GetService("Workspace")

-- Przykład pętli numerycznej
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " jest dzieckiem numer " .. i)
end
```

```lua
local Workspace = game:GetService("Workspace")

-- Przykład pętli ogólnej
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " jest dzieckiem numer " .. i)
end
```
Zauważ, że zwrócona tablica **nie** jest posortowana w żadnej szczególnej kolejności,
specjalne sortowanie (na przykład przy użyciu `Library.table.sort()`) jest zalecane do
sortowania dzieci zwróconych przez tę metodę.

Zobacz także metodę `Class.Instance:GetDescendants()|GetDescendants()`.

Instance:GetChildren

Zwraca tablicę zawierającą wszystkie dzieci instancji.

Instance:getChildren

Zwraca zakodowany ciąg identyfikatora debugowania używanego wewnętrznie przez Roblox. Zauważ,
że:

- Ten element jest chroniony. Próba użycia go w `Class.Script` lub
  `Class.LocalScript` spowoduje błąd.
- Identyfikator debugowania jest identyfikatorem używanym w procesach debugowania. Umożliwia debuggerowi
  odczytanie każdej instrukcji przed przetworzeniem jej przez aplikację. Wszystkie obiekty w
  Roblox działają jak procesy, a każdy uruchamia instrukcje (lub 'kod'), które można
  debugować w razie potrzeby.
- Może to być pomocne dla wtyczek, które potrzebują odróżnić podobne
  obiekty od siebie nawzajem (takie jak obiekty, które dzielą tę samą nazwę).

Instance:GetDebugId

scopeLength

Zwraca zakodowany ciąg identyfikatora debugowania używanego wewnętrznie przez Roblox.

GetDescendants jest często używane, aby zrobić coś ze wszystkimi potomkami, które są
określonym rodzajem obiektu. Kod w tym przykładzie używa GetDescendants oraz
`Class.Instance:IsA()`, aby znaleźć wszystkie części w workspace i zmienia je
na zielone.

Ta metoda obiektu zwraca tablicę, która zawiera wszystkich potomków
tego obiektu. W przeciwieństwie do `Class.Instance:GetChildren()`, która zwraca tylko
bezpośrednie dzieci obiektu, ta metoda odnajduje każdego dziecka obiektu,
wielu dzieci tych dzieci itd.

Zauważ, że zwrócona tablica **nie** jest posortowana w żadnej szczególnej kolejności,
specjalne sortowanie (na przykład przy użyciu `Library.table.sort()`) jest zalecane do
sortowania potomków zwróconych przez tę metodę. Rozważ także
metodę `Class.Instance:QueryDescendants()|QueryDescendants()`, aby zapytać
otoczniki o potomków kombinowanych z selektorami i kombinatorami.

Instance:GetDescendants

Tablica zawierająca potomków instancji.

Zwraca tablicę zawierającą wszystkie potomków instancji.

Ten przykład kodu demonstruje działanie `Class.Instance:GetFullName()`.
Pokazuje, jak funkcja zachowuje się, gdy jest wywoływana na obiekcie, który nie znajduje się w
hierarchii `DataModel`, a także pokazuje, że wartość zwracana nie ucieka
znakom specjalnym.


Ten przykład kodu ponownie implementuje funkcję `Class.Instance:GetFullName()` w
Lua.

Zwraca ciąg opisujący rodowód instancji. Ciąg jest konkatenacją
`Class.Instance.Name|Name` obiektu i jego przodków, oddzielonych kropkami.
Model `Class.DataModel` (`game`) nie jest brany pod uwagę. Na przykład `Class.Part`
w `Class.Workspace` może zwrócić `Class.Workspace.Part`.

Kiedy jest wywoływana na `Class.Instance`, która nie jest potomkiem `Class.DataModel`,
metoda ta uznaje wszystkich przodków aż do najwyższego,
 który nie ma `Class.Instance.Parent|Parent`.

Ta metoda jest przydatna do logowania i debugowania. Nie powinieneś próbować
parsować zwróconego ciągu do jakiejkolwiek operacji użytkowej; ta metoda nie
escapuje kropek (ani żadnego innego symbolu) w nazwach obiektów. Innymi słowy,
chociaż jej wyjście często wydaje się być ważnym identyfikatorem Luau, nie jest to
zagwarantowane.

Instance:GetFullName

Zwraca ciąg opisujący rodowód instancji.

Ta metoda zwraca stylizowaną lub wyraźnie zmodyfikowaną wartość danéj
właściwości, lub domyślną wartość właściwości, jeśli nie została
stylizowana/zmodifikowana. Różni się to nieco od bezpośredniego dostępu do wartości właściwości,
jak na przykład `[GuiObject].Rotation`, który zwraca domyślną lub
zmodyfikowaną wartość właściwości.

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- Referencja do przycisku
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (wartość domyślna)
print(button.Rotation) --> 0 (wartość domyślna)

-- Zastosuj rotację przez właściwość reguły stylu
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (stylizowana wartość na podstawie reguły)
print(button.Rotation) --> 0 (wartość domyślna)

-- Wyraźnie zmodyfikuj/przysłoni stylizowaną właściwość
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (zmodyfikowana wartość)
print(button.Rotation) --> 45 (zmodyfikowana wartość)
```

Instance:GetStyled

selector

Opcjonalny selektor dla instancji pseudo, którą kierujesz na
instancji.

Stylizowana lub wyraźnie zmodyfikowana wartość danej właściwości, lub
 inna domyślna wartość właściwości, jeśli nie została stylizowana/zmodifikowana.

Zwraca stylizowaną lub wyraźnie zmodyfikowaną wartość podanej właściwości,
 lub domyślną wartość właściwości, jeśli nie została stylizowana/zmodifikowana.

Ta metoda zwraca zdarzenie, które działa dokładnie jak
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
z tą różnicą, że wywołuje się tylko wtedy, gdy zmienia się dany atrybut stylu. To
generally jest dobrą praktyką używać tej metody zamiast połączenia z
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` z funkcją, która
sprawdza nazwę właściwości. Kolejne wywołania tej metody na tym samym obiekcie z tą samą
nazwą właściwości zwracają ten sam sygnał.

Zauważ, że to zdarzenie nie przekaże żadnych argumentów do połączonej funkcji,
więc wartość zmienionej właściwości musi być odczytana bezpośrednio w skrypcie.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Właściwość stylu zmieniona!")
end

meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```

Instance:GetStyledPropertyChangedSignal

property

Nazwa właściwości stylu, dla której należy nasłuchiwać zmian.

Zdarzenie, które występuje, gdy zmienia się dana właściwość stylu.

Ta metoda zwraca tablicę tagów przypisanych do danej instancji w
formie ciągów. Możesz dodać tagi zarówno w Studio w oknie
[Właściwości](/studio/properties), jak i podczas działania z użyciem
`Class.Instance:AddTag()|AddTag()`.

Ta metoda jest przydatna, gdy chcesz coś zrobić z wieloma tagami na
instancji jednocześnie. Jednak nieefektywne jest używanie tej metody do
sprawdzania istnienia pojedynczego tagu; zamiast tego użyj
`Class.Instance:HasTag()|HasTag()`, aby sprawdzić konkretny tag.

Instance:GetTags

Uzyskuje tablicę wszystkich tagów przypisanych do instancji.

Ta metoda zwraca `true`, jeśli podany tag został dodany do
obiektu. Możesz dodać tagi zarówno w Studio w oknie
[Właściwości](/studio/properties), jak i podczas działania z użyciem
`Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Demonstruje określenie, czy jedna instancja jest przodkiem innej przy użyciu
`Class.Instance:IsAncestorOf()`

Workspace i SpawnLocation są przodkami dekalu SpawnLocation.
Workspace jest przodkiem SpawnLocation.

SpawnLocation i jego dekale są potomkami Workspace, a nie przodkami.
Dekal jest potomkiem SpawnLocation, a nie przodkiem.


Zwraca prawdę, jeśli `Class.Instance` jest przodkiem danego
potomka.

`Class.Instance` jest uważane za przodka obiektu, jeśli `Class.Instance.Parent`
obiektu lub któraś z jego rodziców `Class.Instance.Parent` jest ustawiona na `Class.Instance`.

Zobacz także, `Class.Instance:IsDescendantOf()`.

Instance:IsAncestorOf

Prawda, jeśli `Class.Instance` jest przodkiem danego potomka.

Zwraca prawdę, jeśli `Class.Instance` jest przodkiem danego
potomka.

Zwraca `true`, jeśli `Class.Instance` jest potomkiem danego
przodka.

Zauważ, że `IsDescendantOf()` nie może być używane z parametrem `nil`, aby
sprawdzić, czy obiekt został usunięty.

Zobacz także `Class.Instance:IsAncestorOf()`.

Instance:IsDescendantOf

ancestor

Prawda, jeśli `Class.Instance` jest potomkiem danego przodka.

Zwraca `true`, jeśli `Class.Instance` jest potomkiem
danego przodka.

Instance:isDescendantOf

Ta metoda wskazuje, czy konkretna właściwość została zmodyfikowana w porównaniu do
domyslnej wartości zainicjowanej w kodzie. Jeżeli zostanie wywołana na instancji nowo utworzonej
przez kod (`Datatype.Instance.new()`), ta metoda zwróci `false`. Jeśli
została wywołana na obiekcie nowo utworzonym za pomocą procesów w Studio, takich jak
wstawienie w oknie [Eksploratora](/studio/explorer), wynik może się różnić.

Na przykład, zapytanie wartości
dla `Class.TextLabel.BackgroundColor3|BackgroundColor3`
przycisku `Class.TextLabel` wstawionego przez
townywny katalog w [Eksploratorze](/studio/explorer)
zwróci `true`, ale zapytanie tej samej wartości `Class.TextLabel`
stworzona poprzez `Datatype.Instance.new()` zwróci `false`, zakładając że nie
zostały wprowadzone inne zmiany w `Class.TextLabel.BackgroundColor3|BackgroundColor3`.

Zauważ, że ta metoda zwraca użyteczne wyniki tylko dla usług i instancji stworzone
przez użytkowników. Wartości zwracane dla właściwości systemowych w instancjach,
 takich jak `Class.PackageLink`, to niezdefiniowane zachowanie.

Zauważ także, że jeśli ta metoda zwraca `true`, styling **nie** będzie wpływał
na tę właściwość, ponieważ modyfikacja właściwości ma pierwszeństwo przed stylizowaniem.
Aby zresetować właściwość do jej domyślnej wartości zainicjowanej w kodzie i
umożliwić stosowanie stylizacji na niej, użyj
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.

Instance:IsPropertyModified

Boolean wskazujący, czy właściwość została zmodyfikowana w porównaniu do
 jej domyślnej wartości zainicjowanej w kodzie.

Zwraca `true`, jeśli wartość przechowywana w określonej właściwości nie jest
równa domyślnej wartości zainicjowanej w kodzie.

Ta metoda obiektu zwraca tablicę, która zawiera wszystkie potomki obiektu,
które pasują do podanego ciągu `selector`. `selector` może zawierać
wielokrotne selektory i kombinatory, aby pasować do takich cech jak
nazwa klasy, nazwa instancji i relacje hierarchiczne, a także
konkretne wartości właściwości i atrybutów instancji. Gramatyka
`selector` jest podobna do tej używanej w `Class.StyleRule`, z tylko
kilkoma różnicami dotyczącymi tego, które części gramatyki są obsługiwane lub nie.

#### Selektry

- `ClassName` — Dopasowuje instancje określonej klasy w
  relacji `Class.Object:IsA()`.
- `.Tag` — Dopasowuje instancje oznaczone tagiem `Class.CollectionService`.
- `#Name` — Dopasowuje instancje o konkretnej nazwie `Class.Instance.Name`.
- `[property = value]` — Dopasowuje instancje, które mają określoną
  właściwość, a ta właściwość ma określoną wartość. Obsługiwane są
  wartości boolean, liczby i ciągi. Litery, liczby, `_` i `-` mogą być
  używane bez umieszczania wartości w cudzysłowach.
- `[$attribute]` — Dopasowuje instancje, które mają ustawiony
o określony [atrybut](/studio/properties#instance-attributes).
- `[$attribute = value]` — Dopasowuje instancje, które mają określony
a trybut **i** ten atrybut ma określoną wartość. Te same
  ograniczenia mają zastosowanie jak dla selektorów właściwości. Jeśli chcesz
  sprawdzić brak atrybutu, nie zapytuj o niego jako `nil`; zamiast tego użyj
  pseudo‑klasy `:not` jak w `:not([$attribute])`.

Selektory można również łączyć. Na przykład,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` będzie pasować do instancji, które są
klasą `Class.Model` oznaczoną jako `Apple` i które mają
atrybut `Variety` równy `Fuji` oraz atrybut `Flavor` równy `4`.

```lua
local Workspace = game:GetService("Workspace")

-- Pobierz wszystkich potomków typu MeshPart
print(Workspace:QueryDescendants("MeshPart"))

-- Pobierz wszystkich potomków oznaczonych jako "Fruit"
print(Workspace:QueryDescendants(".Fruit"))

-- Pobierz wszystkich potomków o nazwie "RedTree"
print(Workspace:QueryDescendants("#RedTree"))

-- Pobierz wszystkich potomków z ustawioną właściwością CanCollide na false
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- Pobierz wszystkich potomków z przypisanym atrybutem "FuelCapacity"
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- Pobierz wszystkich potomków z ustawionym atrybutem "FuelCapacity" na 75
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### Kombinatory

Kombinatory pozwalają na mieszanie podstawowych selektorów, aby pasować do
deep hierarchicznych relacji.

- `>` — Dopasowuje instancje, które są **bezpośrednimi dziećmi**
  pasujących poprzednich filtrów.

- `>>` — Dopasowuje instancje, które są **potomkami**
  pasujących poprzednich filtrów. To jest domyślny pierwszy filtr,
  co oznacza, że `SpotLight.Red` jest tym samym co `>> SpotLight.Red`.

- `,` — Określa listę wielu niezależnych selektorów dla zapytania o potomków.
  Tylko elementy pasujące do filtra są umieszczane w zwracanej tablicy;
  `nil` nie będzie inkludowane dla niepasujących elementów
  w liście zapytania.

```lua
local Workspace = game:GetService("Workspace")

-- Pobierz bezpośrednie dzieci dowolnego Modelu, które są oznaczone jako "SwordPart"
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Pobierz bezpośrednie dzieci, które są Part i są oznaczone jako "Apple"
print(Workspace:QueryDescendants("> Part.Apple"))

-- Pobierz potomków dowolnego Modelu z atrybutem "OnFire" ustawionym na true
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- Pobierz potomków typu MeshPart oznaczonych jako "SwordPart" LUB z atrybutem "OnFire" ustawionym na true
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### Selektry pseudo-klas

- `:not(complex-selector-list)` — Pozwala na wybieranie instancji,
  które **nie** pasują do żadnego z selektorów wewnątrz, skutecznie wykonując
  negację selektorów. Ponieważ wyrażenie wewnętrzne jest listą
  złożonych selektorów, możliwe jest filtrowanie na podstawie wielu warunków.

- `:has(relative-selector-list)` — Pozwala na wybieranie instancji
  w zależności od tego, które instancje zawierają wewnątrz. Lista selektorów jest
euwerana w odniesieniu do każdej instancji.

```lua
local Workspace = game:GetService("Workspace")

-- Pobierz wszystkich potomków, którzy NIE są klasy SpotLight
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- Pobierz wszystkich potomków, którzy NIE są klasy SpotLight LUB PointLight
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- Pobierz wszystkich potomków, którzy NIE mają atrybutu "OnFire"
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- Pobierz wszystkich potomków Z WYJĄTKIEM dzieci Modelu oznaczonego jako "SwordPart"
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Pobierz potomków, którzy zawierają instancję narzędzia jako swoje własne potomstwo
print(Workspace:QueryDescendants(":has(Tool)"))
-- Pobierz potomków typu MeshPart, którzy zawierają bezpośrednie dziecko oznaczone jako "SwordPart"
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- Pobierz potomków typu MeshPart z bezpośrednimi dziećmi, które NIE są klasy SurfaceAppearance ani Texture
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

Zwraca tablicę zawierającą wszystkie potomki instancji, które pasują do
ciągu `selector`.


Instance

`Instance` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox
które mogą być częścią drzewa `Class.DataModel`.

/reference/engine/classes/UIListLayout.yaml