`Class.BillboardGui` to kontener dla obiektów UI, które pojawiają się w przestrzeni 3D,
ale jednak zawsze zwracają się w stronę kamery. Położenie kontenera jest względne w stosunku do
rodzica `Class.BasePart` lub `Class.Attachment` (lub `Class.BillboardGui.Adornee|Adornee`). Dla `Class.BasePart|BaseParts`,
wykorzystywana jest właściwość `Class.BasePart.Position|Position`, natomiast dla
`Class.Attachment|Attachments` używana jest właściwość `Class.Attachment.WorldPosition|WorldPosition`.

<img src="/assets/ui/in-experience/BillboardGui-Diagram.jpg" width="800" alt="BillboardGui z TextLabel opisującym ekranowy konsolę, nad którą się unosi." />

Właściwość `Class.BillboardGui.Size|Size` działa nieco inaczej niż `Class.GuiObject.Size`. Podczas gdy komponenty **offset** działają w ten sam sposób,
komponenty **scale** są traktowane jako rozmiary studów w przestrzeni 3D.

Tworząc `Class.BillboardGui` z skalą rozmiaru, która zawiera `Class.TextLabel`, przydatne jest włączenie właściwości
`Class.TextLabel.TextScaled|TextScaled`, aby jego tekst skalował się wraz z płótnem billboardu w miarę zmiany odległości kamery.

Zauważ, że interaktywne elementy UI, takie jak `Class.ImageButton|ImageButtons` i
`Class.TextButton|TextButtons` wewnątrz `Class.BillboardGui` będą odbierać
wejścia użytkownika tylko wtedy, gdy są one przypięte do `Class.PlayerGui`, zazwyczaj poprzez
umieszczenie `Class.BillboardGui` wewnątrz `Class.StarterGui`. Właściwość
`Class.BillboardGui.Adornee|Adornee` może być używana do kierowania na część lub
przyłącze w 3D, podczas gdy sam `Class.BillboardGui` pozostaje w
`Class.PlayerGui`.

Zobacz [In-Experience UI](/ui/in-experience-containers#billboard-ui)
aby uzyskać wskazówki dotyczące pracy z kontenerami `Class.BillboardGui`.

##### Zachowanie pamięci podręcznej

Aby poprawić wydajność, wygląd `Class.BillboardGui` jest
pamiętany do momentu, aż jedno z poniższych wystąpi, po czym jego wygląd zostanie
ponownie obliczony w następnej klatce renderowania.

- Zstępca został dodany lub usunięty z `Class.BillboardGui`.
- Właściwość zstępcy `Class.BillboardGui` ulega zmianie.
- Właściwość samej `Class.BillboardGui` ulega zmianie.


BillboardGui

Kontroluje, czy zstępcy będą odbierać zdarzenia wejściowe. Jeśli `Class.BillboardGui` zawiera `Class.GuiButton`, ten przycisk stanie się
klikany tylko wtedy, gdy `Class.BillboardGui.Active|Active` jest ustawione na `true` zarówno na
`Class.BillboardGui`, jak i przycisku.

Zauważ, że interaktywne elementy UI, takie jak `Class.ImageButton|ImageButtons`
i `Class.TextButton|TextButtons` wewnątrz `Class.BillboardGui` będą odbierać
wejścia użytkownika tylko wtedy, gdy są one przypięte do `Class.PlayerGui`,
zazwyczaj poprzez umieszczenie `Class.BillboardGui` wewnątrz `Class.StarterGui`.
Właściwość `Class.BillboardGui.Adornee|Adornee` może być używana do kierowania na
część lub przyłącze w 3D, podczas gdy sam `Class.BillboardGui`
pozostaje w `Class.PlayerGui`.


BillboardGui.Active

Kontroluje, czy zstępcy będą odbierać zdarzenia wejściowe.


Ustala docelowy `Class.BasePart` lub `Class.Attachment`, względem którego `Class.BillboardGui` jest położony, zastępując rodzica
lub przyłącze.


BillboardGui.Adornee

Ustala docelową część lub przyłącze, względem którego `Class.BillboardGui` jest
położony.


Właściwość ta określa, czy `Class.BillboardGui` zawsze
będzie renderowany na wierzchu innych obiektów 3D.

Gdy jest ustawiona na `false` (domyślnie), `Class.BillboardGui` renderuje się jak inne
3D i jest przesłaniany przez inne obiekty 3D. Gdy jest ustawiona na `true`, `Class.BillboardGui`
zawsze renderuje się na wierzchu treści 3D, a jego wygląd zmienia się znacznie:

- Kolory pasują do tego, jak wyglądają wewnątrz `Class.ScreenGui`.
- Tekst może wyglądać ostrzej na urządzeniach o wysokiej DPI.
- `Class.BillboardGui.LightInfluence|LightInfluence` traktowane jest tak,
  jakby było `0`.
- `Class.BillboardGui.Brightness|Brightness` nie ma wpływu.


BillboardGui.AlwaysOnTop

Określa, czy `Class.BillboardGui` zawsze będzie renderowany na wierzchu
innych obiektów 3D.


Właściwość ta określa czynnik, przez który światło kontenera `Class.BillboardGui`
jest skalowane, gdy `Class.BillboardGui.LightInfluence|LightInfluence` wynosi `0`. Domyślnie,
Ta właściwość wynosi `1` i może być ustawiona na dowolną liczbę między `0` a `1000`.
Poprzez modyfikację tej właściwości, jasność `Class.BillboardGui` może być lepiej dopasowana do jego otoczenia. Na przykład
billboard wideo można rozjaśnić w ciemnym pomieszczeniu, zwiększając `Class.BillboardGui.Brightness|Brightness` do `10`.

Zauważ, że `Class.BillboardGui.Brightness|Brightness` jest niedostępna w
Studio i nie ma wpływu, gdy `Class.BillboardGui.LightInfluence|LightInfluence` wynosi `1` lub
`Class.BillboardGui.AlwaysOnTop|AlwaysOnTop` wynosi `true`.


BillboardGui.Brightness

Określa czynnik, przez który światło kontenera `Class.BillboardGui`
jest skalowane, gdy `Class.BillboardGui.LightInfluence|LightInfluence` wynosi `0`.


Gdy jest ustawione na `true` (domyślnie), fragmenty `Class.GuiObject|GuiObjects`,
które wykraczają poza granice płótna `Class.BillboardGui`, nie będą rysowane.

Nawet gdy ta właściwość wynosi `false`, `Class.GuiObject|GuiObjects`, które są
**całkowicie** poza płótnem, nie będą renderowane.


BillboardGui.ClipsDescendants

Czy fragmenty `Class.GuiObject|GuiObjects`, które wypadają poza
granice płótna `Class.BillboardGui`, będą rysowane.


Aktualna odległość w studach, w jakiej `Class.BillboardGui` znajduje się od
kamery gracza. Zdarzenie zmiany nie wyzwala się dla tej właściwości, chyba że
`Class.BillboardGui.DistanceStep|DistanceStep` jest większe niż `0`.


BillboardGui.CurrentDistance

Aktualna odległość w studach, w jakiej `Class.BillboardGui` znajduje się od
kamery gracza.


Określa odległość w studach, w której `Class.BillboardGui` przestanie
skalować się w większy rozmiar w stosunku do aktualnej kamery gracza,
z domyślną wartością `0`. Jeśli
`Class.BillboardGui.CurrentDistance|CurrentDistance` wynosi poniżej tej wartości,
nigdy nie zwiększy się większy niż wynosiłby w tej odległości.


BillboardGui.DistanceLowerLimit

Określa odległość w studach, w której `Class.BillboardGui`
przestanie skalować się w większy rozmiar.


Określa przyrosty i zmniejszenia rozmiaru `Class.BillboardGui.CurrentDistance|CurrentDistance`
w studach, gdy kamera gracza zbliża się i oddala od `Class.BillboardGui`. Właściwość ma wartość domyślną `0`.


BillboardGui.DistanceStep

Określa przyrosty i zmniejszenia rozmiaru `Class.BillboardGui.CurrentDistance|CurrentDistance`
w studach, gdy kamera gracza zbliża się i oddala od `Class.BillboardGui`.


Określa odległość w studach, w której `Class.BillboardGui` przestanie
skalować się w mniejszy rozmiar w stosunku do aktualnej kamery gracza. Jeśli
`Class.BillboardGui.CurrentDistance|CurrentDistance` jest powyżej tej wartości,
nigdy nie zmniejszy się mniejszy niż wynosiłby w tej odległości.

Ta właściwość jest ignorowana, jeśli wartość jest mniejsza niż `0`. Domyślna wartość
wynosi `-1`, co oznacza, że właściwość jest domyślnie ignorowana.


BillboardGui.DistanceUpperLimit

Określa odległość w studach, w której `Class.BillboardGui`
przestanie skalować się w mniejszy rozmiar.


Właściwość ta określa, jak `Class.BillboardGui` jest przesunięty od swojego
`Class.BillboardGui.Adornee|Adornee`, w odniesieniu do orientacji `Class.Camera`, w
jednostkach równych połowie wymiarów obiektu modelu
`Class.Camera`-wyrównanej objętości.

Zobacz także `Class.BillboardGui.StudsOffset|StudsOffset`, który działa
w podobny sposób, ale używa jednostek studów, lub
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace`, który
działa w podobny sposób, z wyjątkiem orientacji przesunięcia w odniesieniu do globalnych
osi.


BillboardGui.ExtentsOffset

Określa, jak `Class.BillboardGui` jest przesunięty od swojego
`Class.BillboardGui.Adornee|Adornee`, w odniesieniu do orientacji `Class.Camera`, w
jednostkach równych połowie wymiarów obiektu modelu
`Class.Camera`-wyrównanej objętości.


Właściwość ta określa, jak `Class.BillboardGui` jest przesunięty od swojego
`Class.BillboardGui.Adornee|Adornee`, w odniesieniu do globalnych osi, w
jednostkach równych połowie wymiarów objętości obiektu modelu.

Zobacz także `Class.BillboardGui.StudsOffset|StudsOffset`, który działa
w podobny sposób, ale używa jednostek studów, lub
`Class.BillboardGui.ExtentsOffset|ExtentsOffset`, który działa w podobny sposób,
za wyjątkiem orientacji przesunięcia w odniesieniu do `Class.Camera`.


BillboardGui.ExtentsOffsetWorldSpace

Określa, jak `Class.BillboardGui` jest przesunięty od swojego
`Class.BillboardGui.Adornee|Adornee`, w odniesieniu do globalnych osi, w
jednostkach równych połowie wymiarów objętości obiektu modelu.


Kontroluje, jak bardzo `Class.BillboardGui` jest wpływany przez oświetlenie
środowiskowe, w zakresie od `0` do `1`. Ustawienie tej wartości na `1` oznacza,
że otaczające oświetlenie ma pełną kontrolę nad wyglądem, podczas gdy
ustawienie jej na `0` oznacza, że oświetlenie nie ma wpływu.


BillboardGui.LightInfluence

Kontroluje, jak bardzo `Class.BillboardGui` jest wpływany przez oświetlenie
środowiskowe.


Ta właściwość określa, jak daleko od kamery `Class.BillboardGui`
może być wyświetlane, zanim przestanie renderować. Wartość `0` lub `inf`
(domyslnie) oznacza, że nie ma limitu, a więc renderowanie odbywa się w nieskończoność.

Dla `Class.BillboardGui|BillboardGuis`, które pojawiają się na zewnątrz,
zaleca się, aby `Class.BillboardGui.MaxDistance|MaxDistance` była na tyle wysoka,
aby zapewnić, że UI kontenera jest wystarczająco małe na ekranie, gdy pojawia się lub znika,
minimalizując efekt nagłego włączenia/wyłączenia.


BillboardGui.MaxDistance

Kontroluje, jak daleko od kamery `Class.BillboardGui` może być wyświetlane, zanim
przestanie renderować.


Używane przez skrypty do ukrywania `Class.BillboardGui` przed konkretnym graczem.

Aby ukryć `Class.BillboardGui` przed więcej niż jednym graczem, umieść go w
`Class.StarterGui` i użyj skryptu, aby ustawić
`Class.BillboardGui.Enabled|Enabled` w zależności od tego, czy
`Class.Players.LocalPlayer|LocalPlayer` powinien go widzieć. Właściwość `Class.BillboardGui.Adornee|Adornee`
może być używana do przymocowania `Class.BillboardGui` do `Class.BasePart` lub `Class.Attachment`
w `Class.Workspace`, zamiast przypinać go.


BillboardGui.PlayerToHideFrom

Używane przez skrypty do ukrywania `Class.BillboardGui` przed konkretnym graczem.


Kontroluje rozmiar, który `Class.BillboardGui` będzie miał na ekranie.
W przeciwieństwie do `Class.GuiObject.Size`, komponenty
[scale](/ui/position-and-size#size) tej właściwości ustalają rozmiar billboardu w studach w
przestrzeni 3D.


BillboardGui.Size

Kontroluje rozmiar, który `Class.BillboardGui` będzie miał na ekranie.


2D offset w jednostkach zależnych od rozmiaru, który działa jak punkt kotwiczenia. Może być używane podobnie do właściwości
`Class.GuiObject.AnchorPoint`, ale wartości są inne.

<table size="small">
<thead>
<th>Offset rozmiaru</th>
<th>Wyjaśnienie</th>
</thead>
<tbody>
<tr>
<td><code>0, 0</code></td>
<td>Domyślne ustawienie, w którym UI jest zakotwiczone w swoim centrum.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>UI będzie zakotwiczone w lewym dolnym rogu.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>UI będzie zakotwiczone w lewym górnym rogu.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>UI będzie zakotwiczone w prawym górnym rogu.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>UI będzie zakotwiczone w prawym dolnym rogu.</td>
</tr>
</tbody>
</table>

Zobacz także `Class.BillboardGui.StudsOffset|StudsOffset`, `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`,
`Class.BillboardGui.ExtentsOffset|ExtentsOffset`, i `Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace`, które
są właściwościami przesunięcia działającymi w przestrzeni 3D.


BillboardGui.SizeOffset

2D offset w jednostkach zależnych od rozmiaru, który działa jak punkt kotwiczenia.


Właściwość ta określa, jak `Class.BillboardGui` jest przesunięty od swojego
`Class.BillboardGui.Adornee|Adornee` w studach, w odniesieniu do orientacji
`Class.Camera`.

Zobacz również `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`,
który działa w podobny sposób, z wyjątkiem, że orientacja przesunięcia jest względna do globalnych osi.


BillboardGui.StudsOffset

Określa, jak `Class.BillboardGui` jest przesunięty od swojego
`Class.BillboardGui.Adornee|Adornee` w studach, w odniesieniu do orientacji
`Class.Camera`.


Właściwość ta określa, jak `Class.BillboardGui` jest przesunięty od swojego
`Class.BillboardGui.Adornee|Adornee` w studach, w odniesieniu do globalnych osi.

Zobacz także `Class.BillboardGui.StudsOffset|StudsOffset`, który działa
w podobny sposób, z wyjątkiem, że orientacja przesunięcia jest względna do `Class.Camera`.


BillboardGui.StudsOffsetWorldSpace

Określa, jak `Class.BillboardGui` jest przesunięty od swojego
`Class.BillboardGui.Adornee|Adornee` w studach, w odniesieniu do globalnych
osi.


Kontener dla `Class.GuiObject|GuiObjects`, który renderuje się w przestrzeni 3D, zwrócony w stronę kamery.


**LayerCollector** to podstawowa klasa 2D UI kontenerów, które renderują
`Class.GuiObject` potomków, takich jak `Class.ScreenGui`.

Aby poprawić wydajność, wygląd `Class.LayerCollector` jest
cache'owany, aż do wystąpienia jednego z poniższych zdarzeń:

- Potomek zostaje dodany lub usunięty z niego.
- Właściwość potomka zmienia się.
- Właściwość samego `Class.LayerCollector` zmienia się.

LayerCollector:GetLayoutNodeTree

LayerCollector

Przełącza widoczność tego `Class.LayerCollector`. Gdy `false`, zawartość
UI nie będzie renderowana, przetwarzała wejścia użytkownika ani nie
generowała aktualizacji w odpowiedzi na zmiany.

LayerCollector.Enabled

Przełącza widoczność tego `Class.LayerCollector`.

Gdy ustawione na `false` i ten `Class.LayerCollector` jest bezpośrednim
potomkiem `Class.StarterGui`, zostanie sklonowany do `Class.PlayerGui`
każdego gracza tylko raz i nie zostanie usunięty, gdy postać
gracza odradza się.

Gdy ustawione na `true` (domyślnie), lub jeśli ten `Class.LayerCollector`
jest **pośrednim** potomkiem `Class.StarterGui`, zostanie sklonowany do
`Class.PlayerGui` każdego gracza, gdy ich postać się odradza, a on
zostanie usunięty, gdy postać gracza odradza się ponownie.

LayerCollector.ResetOnSpawn

Określa, czy `Class.LayerCollector` resetuje się (usuwa się i
klonuje do `Class.PlayerGui` gracza) za każdym razem, gdy postać
gracza odradza się.

Kontroluje, jak `Class.GuiObject.ZIndex` zachowuje się we wszystkich potomkach tego
`Class.LayerCollector`.

Przy `Enum.ZIndexBehavior.Sibling` (domyślnie) dzieci zawsze renderują się nad
swoimi rodzicami, a `Class.GuiObject.ZIndex|ZIndex` jest używane do decydowania
kolejności renderowania dzieci jednego obiektu UI względem siebie.

`Enum.ZIndexBehavior.Global` sortuje wszystkie potomki według
`Class.GuiObject.ZIndex|ZIndex`, a następnie rozstrzyga remisy przy użyciu
kolejności hierarchii. W rezultacie, potomkowie `Class.GuiObject` muszą mieć
wartość `Class.GuiObject.ZIndex|ZIndex`, która jest przynajmniej tak wysoka jak
rodzic, w przeciwnym razie będą renderować się pod swoim rodzicem.


LayerCollector.ZIndexBehavior

Kontroluje, jak `Class.GuiObject.ZIndex` zachowuje się we wszystkich potomkach tego
`Class.LayerCollector`.


Podstawowa klasa 2D UI kontenerów, które renderują `Class.GuiObject|GuiObjects`
w warstwach.

`Class.GuiBase2d` to abstrakcyjna klasa dziedziczona przez 2D
`Class.GuiObject|GuiObjects`.


To zdarzenie wyzwala się, gdy wybór gamepada przemieszcza się do, opuszcza, lub zmienia
w obrębie połączonego `Class.GuiBase2d` lub jakiegokolwiek potomka
`Class.GuiObject|GuiObjects`. Gdy wskaźnik wyboru przemieszcza się do
`Class.GuiObject`, zdarzenie przemieszcza się od tego `Class.GuiObject` do wszystkich
jego przodków, informując ich, że wybór
zmienił się/wejście/opuszczenie do `Class.GuiObject` w ich drzewie potomków.


GuiBase2d.SelectionChanged

amISelected

Prawda, jeśli nowy wybór pasuje do podłączonego GuiBase2d.


previousSelection

newSelection

Wyzwalane, gdy wybór gamepada przemieszcza się do, opuszcza, lub zmienia w
połączonym `Class.GuiBase2d` lub jakimkolwiek potomku
`Class.GuiObject|GuiObjects`.


GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` to właściwość tylko do odczytu,
która podaje pozycję ekranu elementu `Class.GuiBase2d`
w pikselach. Reprezentuje to rzeczywistą pozycję w pikselach, w której element
jest renderowany w wyniku rozmiarów i pozycji jego przodków. Zauważ, że
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` zawsze reprezentuje
lewy górny róg elementu `Class.GuiBase2d`.

Jeśli `Class.GuiBase2d` znajduje się w `Class.ScreenGui`,
właściwość `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` używa
systemu współrzędnych `Enum.ScreenInsets|CoreUISafeInsets`. Początek
tego systemu współrzędnych znajduje się w lewym dolnym rogu
paska górnego Roblox. Zauważ, że jest to ten sam system współrzędnych używany przez
właściwość `Class.InputObject.Position`.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="Diagram pokazujący początek systemu współrzędnych AbsolutePosition." />

Zobacz także `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` i
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsolutePosition

Opisuje rzeczywistą pozycję ekranu elementu `Class.GuiBase2d`, w
pikselach.


`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` to właściwość tylko do odczytu,
która opisuje rzeczywistą rotację ekranu elementu `Class.GuiBase2d`,
w stopniach. **Nie** wykonuje kontroli granic, więc jej wartość
może nie mieścić się w zakresie `0` do `360`.

Zobacz także `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` i
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsoluteRotation

Opisuje rzeczywistą rotację ekranu elementu `Class.GuiBase2d`, w
degrach.


`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` to właściwość tylko do odczytu, która
describes rzeczywisty rozmiar ekranu elementu `Class.GuiBase2d`, w
pikselach.

Zobacz także `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` i
`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`.


GuiBase2d.AbsoluteSize

Opisuje rzeczywisty rozmiar ekranu elementu `Class.GuiBase2d`, w
pikselach.


Gdy jest ustawione na `true`, lokalizacja będzie stosowana do tego `Class.GuiBase2d`
i jego potomków. Wpisy używane do lokalizacji są tym samym zestawem
wpisów, które zwraca `Class.LocalizationService:GetTableEntries()`. Wpisy
z `Class.GuiBase2d.AutoLocalize|AutoLocalize` włączone automatycznie
są ponownie tłumaczone po załadowaniu tabeli w chmurze, jeśli to wymagane.

Zobacz także `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`.


GuiBase2d.AutoLocalize

Gdy jest ustawione na `true`, lokalizacja będzie stosowana do tego `Class.GuiBase2d`
i jego potomków.


Ta właściwość jest automatycznie ustawiana na true, gdy tabela lokalizacji
`Class.LocalizationTable.Root` skierowuje się do tego obiektu lub przodka tego
obiektu. `Class.LocalizationTable|LocalizationTables` z ich
właściwością `Class.LocalizationTable.Root` wskazującą na instancję będą
lokalizować wszystkie `Class.TextLabel.TextButton`, które są potomkami instancji głównej.


GuiBase2d.Localize

Automatycznie ustawiane na true, gdy tabela lokalizacji
`Class.LocalizationTable.Root` skierowuje się do tego obiektu lub przodka tego
obiektu.


Odwołanie do `Class.LocalizationTable`, które ma być używane do zastosowania automatycznej
lokalizacji do tego `Class.GuiBase2d` i jego potomków.
`Class.GuiBase2d.AutoLocalize|AutoLocalize` musi być ustawione na `true` na
`Class.GuiBase2d` i jego przodkach, aby automatyczna lokalizacja mogła być
zastosowana.

Możesz ustawić to jako odwołanie do `Class.LocalizationTable` w dowolnym
miejscu w `Class.DataModel`. Obiekt `Class.GuiBase2d` i wszystkie jego dzieci
będą próbować używać tej konkretnej `Class.LocalizationTable` i jej przodków
w celu automatycznej wymiany tekstu przed użyciem tabel pod
`Class.LocalizationService` w nieokreślonej kolejności oraz tabeli w chmurze.

Jeśli brak tłumaczenia w wskazanej tabeli, poszuka tłumaczenia w rodzicu
tabeli, jeśli jest również `Class.LocalizationTable`, i tak dalej.

Zobacz także `Class.LocalizationService:GetTableEntries()`, które wyjaśnia jak
`Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` jest używane
w celu automatycznej lokalizacji.


GuiBase2d.RootLocalizationTable

Odwołanie do `Class.LocalizationTable`, które ma być używane do zastosowania automatycznej
lokalizacji do tego `Class.GuiBase2d` i jego potomków.


Dostosowuje zachowanie wyboru gamepada w kierunku w dół.


GuiBase2d.SelectionBehaviorDown

Dostosowuje zachowanie wyboru gamepada w kierunku w lewo.


GuiBase2d.SelectionBehaviorLeft

Dostosowuje zachowanie wyboru gamepada w kierunku w prawo.


GuiBase2d.SelectionBehaviorRight

Dostosowuje zachowanie wyboru gamepada w kierunku w górę.


GuiBase2d.SelectionBehaviorUp

Pozwala na dostosowanie tego, jak wybór gamepada może się poruszać
między przyciskami, które są potomkami grupy wyboru, opuszczać grupę,
i wybierać inne przyciski.

Ustawienie `Class.GuiBase2d.SelectionGroup|SelectionGroup` na `true`ujawnia
właściwości `Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`,
`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`,
`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft` oraz
`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`.
Dla tych zachowań selekcji, ustawienie
`Enum.SelectionBehavior.Escape` (domyślne) oznacza, że wybór gamepada
najpierw próbuje znaleźć wybór w obrębie grupy wyboru i tylko wychodzi
a zewnątrz, jeśli nie znajdzie odpowiedniego przycisku. Alternatywnie,
ustawienie `Enum.SelectionBehavior.Stop` oznacza, że wybór gamepada
patrzy tylko w obrębie grupy wyboru i nie opuszcza grupy w kierunku
tym zachowania selekcji.


GuiBase2d.SelectionGroup

Pozwala na dostosowanie ruchu wyboru gamepada.


Abstrakcyjna klasa dziedziczona przez 2D `Class.GuiObject|GuiObjects`.


GuiBase jest klasą abstrakcyjną, z której dziedziczy większość obiektów graficznego interfejsu użytkownika.


GuiBase

`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

Zwraca wartość przypisaną do danego nazwy atrybutu.

Instance

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

/reference/engine/classes/BillboardGui.yaml