Rola Tłumacza polega na tworzeniu/zwracaniu ciągów tekstowych zlokalizowanych dla
widzającego gracza. Może być używana do pobierania gotowego do wyświetlenia zlokalizowanego tekstu z
`Class.LocalizationTable`. Źródło właściwości `Class.Translator.LocaleId`
, zestaw tabel, które będziesz przeszukiwać oraz kolejność, w jakiej będą przeszukiwane,
zależy od metody użytej do utworzenia instancji Tłumacza.

Dla Tłumacza wejściem jest oryginalny ciąg tekstowy w języku deweloperskim oraz
kontext, w którym całość lub część kontekstu może być użyta do znalezienia bardziej
precyzyjnego/sytuacyjnego tłumaczenia dla źródłowego ciągu tekstowego.

Tłumacz może być również używany do tworzenia przetłumaczonych ciągów z wstawkami
(zamianami danych), które mogą zmieniać kolejność w zależności od docelowego języka.

Zwraca zlokalizowany tekst w ciągu w `Class.LocalizationTable` na podstawie
jego lokalizacji `Class.Translator`, według klucza. Opcjonalna tabela **args** jest używana
 do wypełniania parametrów formatu w pasującym ciągu tekstowym.

Należy pamiętać, że ta metoda zgłosi błąd w następujących przypadkach:

- Jeśli żaden z dostępnych `Class.LocalizationTable|LocalizationTables` dla
  tego `Class.Translator` nie zawiera wartości dla danego klucza.
- Jeśli
  [ciąg formatu](/production/localization/translate-dynamic-content)
  dla klucza używa numerowanych parametrów i **args** nie jest tablicą.
- Jeśli
  [ciąg formatu](/production/localization/translate-dynamic-content)
  używa nazwanych parametrów i **args** nie jest tabelą par klucz-wartość.
- Jeśli **args** brakuje wartości dla parametrów, które są używane w
  pasującym
  [ciągu formatu](/production/localization/translate-dynamic-content).

Zobacz
[Lokalisacja z użyciem skryptów](/production/localization/localize-with-scripting)
po więcej szczegółów oraz przykładów użycia tej funkcji.

Translator:FormatByKey

Wartość **Key**, aby wyszukiwać i tłumaczyć.

args

Zostanie podana, jeśli tekst **Source** i tłumaczenia zawierają ciągi
formatu. Będzie tablicą Luau wartości **lub** par klucz-wartość,
w zależności od tego, czy ciągi formatu są numerowane, czy nazwane.

Zlokalizowany ciąg tekstowy związany z podanym **kluczem**, z wszelkimi
parametrami formatu wypełnionymi z **args**.


Zwraca zlokalizowany tekst w ciągu w `Class.LocalizationTable` na podstawie
jego lokalizacji `Class.Translator`, według klucza.

Demonstruje `Class.Translator:Translate()`.


Zwraca zlokalizowany ciąg tekstowy w `Class.LocalizationTable` na podstawie
jego lokalizacji `Class.Translator`. Ten ciąg będzie w kontekście
podanego obiektu, biorąc pod uwagę podany **Source** tekst.

Zobacz
[Lokalisacja z użyciem skryptów](/production/localization/localize-with-scripting)
po więcej szczegółów i przykładów użycia tej funkcji.

#### Nadpisania kontekstu

W niektórych przypadkach zduplikowane ciągi **Source** mogą mieć zupełnie różne
tłumaczenia w innych językach. Na przykład angielski rzeczownik "Screen"
może oznaczać zarówno ekran komputera, jak i ekran okna, ale hiszpańskie
tłumaczenia są zupełnie inne:

<table>
<tbody>
    <tr>
      <td width="12%">A</td>
      <td width="16%">B</td>
      <td width="18%">C</td>
      <td width="12%">D</td>
      <td width="18%">E</td>
    </tr>
    <tr>
      <td>Klucz</td>
      <td>Kontekst</td>
      <td><b>Source</b></td>
      <td>Przykład</td>
      <td><b>es</b></td>
    </tr>
    <tr>
      <td></td>
      <td></td>
      <td>Screen</td>
      <td></td>
      <td>Pantalla</td>
    </tr>
    <tr>
      <td></td>
      <td></td>
      <td>Screen</td>
      <td></td>
      <td>Mosquitero</td>
    </tr>
    <tr>
      <td> </td>
      <td></td>
      <td></td>
      <td></td>
      <td></td>
    </tr>
  </tbody>
</table>

W takich przypadkach pierwszy argument tej funkcji &mdash; ważny
`Class.Instance` w grze &mdash; może być użyty jako "rozstrzyganie" w przypadku,
gdy wiele obiektów GUI używa tego samego ciągu źródłowego. Aby to zaimplementować,
określ "ścieżkę" do `Class.Instance`, które chcesz nadpisać jako
wartość **Context** danych tłumaczenia:

<table>
<tbody>
    <tr>
      <td width="12%">A</td>
      <td width="36%">B</td>
      <td width="18%">C</td>
      <td width="12%">D</td>
      <td width="18%">E</td>
    </tr>
    <tr>
      <td>Klucz</td>
      <td><b>Kontekst</b></td>
      <td>Source</td>
      <td>Przykład</td>
      <td>es</td>
    </tr>
    <tr>
      <td></td>
      <td>workspace.ComputerScreen.SurfaceGui.TextLabel</td>
      <td>Screen</td>
      <td></td>
      <td>Pantalla</td>
    </tr>
    <tr>
      <td></td>
      <td></td>
      <td>Screen</td>
      <td></td>
      <td>Mosquitero</td>
    </tr>
    <tr>
      <td> </td>
      <td></td>
      <td></td>
      <td></td>
      <td></td>
    </tr>
  </tbody>
</table>

Następnie, wywołując tę funkcję w skrypcie, przekaż ten sam
`Class.Instance` jako pierwszy argument, a następnie tekst wyszukiwania **Source**
jako drugi argument:

Translator:Translate

context

Ważny w grze `Class.Instance`, który ma być użyty do nadpisania kontekstu jak
zaznaczono powyżej. Należy pamiętać, że ten argument może być dowolny, na przykład
`game`, jeśli nie potrzebujesz nadpisania kontekstu.

text

Tekst **Source** do wyszukiwania i tłumaczenia.

Zwraca zlokalizowany tekst w ciągu w `Class.LocalizationTable` na podstawie
jego lokalizacji `Class.Translator`, według wyszukiwania źródłowego.

Translator

Lokalizacja Roblox dla wyjściowych przetłumaczonych ciągów tekstowych z tej tabeli, na
przykład "en-us" lub "es-es." Domyślnie "en-us".

Translator.LocaleId

Lokalizacja przetłumaczonych ciągów tekstowych.

Rola Tłumacza polega na tworzeniu/zwracaniu ciągów tekstowych zlokalizowanych dla
widzającego gracza.

`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 korzeni, ale specjalny
konstruktor `Datatype.Instance.new()` tworzy obiekty za pomocą kodu, przyjmując
nazwę klasy jako parametr i zwracając utworzony 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.

Wywołuje się, gdy ta instancja jest przenoszona lub gdy którykolwiek z jej przodków jest przenoszony.

Możesz użyć tego zdarzenia, aby śledzić usunięcie instancji w Studio, na przykład ręczne usunięcie w Eksploratorze lub za pomocą wtyczki. Jeśli potrzebujesz wykryć, kiedy instancja jest niszczona za pomocą `Class.Instance:Destroy()`, użyj zdarzenia `Class.Instance.Destroying` zamiast tego.

Instance.AncestryChanged

child

Instancja, której właściwość `Class.Instance.Parent|Parent` została zmieniona, która może być tą instancją lub bardziej odległym przodkiem, **nie**koniecznie instancją, do której podłączony jest handler.

parent

Wywołuje się, gdy właściwość `Class.Instance.Parent` tego obiektu lub jednego z jego przodków zostaje zmieniona.

To zdarzenie wywołuje się, gdy jakikolwiek atrybut jest zmieniany na instancji, w tym gdy atrybut jest ustawiany na `nil`. Nazwa zmienionego atrybutu jest przekazywana do podłączonej funkcji.

Na przykład, poniższy fragment kodu łączy funkcję `attributeChanged()` do wywołania za każdym razem, gdy jeden z atrybutów części się zmienia:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Zobacz także `Class.Instance:GetAttributeChangedSignal()`, które zwraca zdarzenie, które wywołuje się, gdy zmienia się dany atrybut.

Instance.AttributeChanged

attribute

Nazwa atrybutu, który został zmieniony.

Wywołuje się, gdy jakikolwiek atrybut jest zmieniany na `Class.Instance`.

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

Wywołuje się po dodaniu obiektu do tego `Class.Instance`.

Uwaga, używając tej metody na kliencie do wykrywania obiektów tworzonych przez serwer, konieczne jest użycie `Class.Instance:WaitForChild()` podczas indeksowania potomków tych obiektów. Dzieje się tak, ponieważ obiekt i jego potomkowie nie są gwarantowani 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ć zreplikowani
	local head = child:WaitForChild("Head")
end)
```
Uwaga, to zdarzenie działa tylko dla bezpośrednich dzieci `Class.Instance`. Aby uzyskać zdarzenie, które obejmuje wszystkich potomków, użyj `Class.Instance.DescendantAdded`.

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

Instance.ChildAdded

Wywołuje się po dodaniu obiektu do tego `Class.Instance`.

Instance.childAdded

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

Wywołuje się po usunięciu dziecka z tego `Class.Instance`.

Usunięcie odnosi się do zmiany rodzica obiektu z tego `Class.Instance` na coś innego niż to `Class.Instance`. Uwaga, to zdarzenie również wywoła się, gdy dziecko zostanie zniszczone (używając `Class.Instance:Destroy()`), ponieważ funkcja zniszczenia ustawia rodzica obiektu na `nil`.

To zdarzenie działa tylko dla bezpośrednich dzieci `Class.Instance`. Aby uzyskać zdarzenie, które obejmuje wszystkich potomków, użyj `Class.Instance.DescendantRemoving`.

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

Instance.ChildRemoved

Wywołuje się po usunięciu dziecka z tego `Class.Instance`.

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

To zdarzenie wywołuje się po dodaniu potomka do `Class.Instance`.

Ponieważ wywołuje się dla każdego potomka, dodanie obiektu do `Class.Instance` wywoła zdarzenie 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

Wywołuje 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 wywołuje się **natychmiast przed** zmianą rodzica `Class.Instance`, tak że instancja **potomka** nie będzie już potomkiem. `Class.Instance:Destroy()|Destroy()` zmienia `Class.Instance.Parent|Parent` instancji na `nil`, więc wywołanie tej metody na potomku rodzica spowoduje wywołanie tego zdarzenia.

Ponieważ to zdarzenie wywołuje się **przed** usunięciem potomka, rodzic potomka pozostanie niezmieniony w momencie wywołania tego zdarzenia. Jeśli potomek jest również **bezpośrednim dzieckiem** rodzica, to zdarzenie wywoła się przed `Class.Instance.ChildRemoved`.

Jeśli potomek ma dzieci, to zdarzenie wywoła się najpierw dla potomka, a następnie dla jego potomków.

#### Ostrzeżenie

To zdarzenie wywołuje 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 to demonstruje:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Nie manipuluj rodzicem potomka w tej funkcji!
	-- To zdarzenie wywołuje się, PONIEWAŻ rodzic został zmieniony, a zmiana jeszcze się nie wydarzyła
	-- Dlatego problematyczne jest zmienianie rodzica w ten sposób:
	descendant.Parent = game
end)

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

Instance.DescendantRemoving

Instancja `Class.Instance`, która jest usuwana.

Wywołuje się natychmiast przed usunięciem potomka z `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.

Instancja `Class.Instance` nigdy nie zostanie usunięta z pamięci, gdy podłączona funkcja nadal jej używa. Jednak jeśli funkcja wstrzyma się w jakimkolwiek momencie, `Class.Instance` i jego potomkowie zostaną przeniesieni do `nil`.

Jeśli właściwość `Class.Workspace.SignalBehavior` jest ustawiona na `Enum.SignalBehavior.Immediate`, to zdarzenie wywołuje się natychmiast przed zniszczeniem `Class.Instance` lub jednego z jego przodków za pomocą `Class.Instance:Destroy()`.

Jeśli właściwość `Class.Workspace.SignalBehavior` jest ustawiona na `Enum.SignalBehavior.Deferred`, to zdarzenie wywołuje się w następnym punkcie wznowienia, co będzie po zniszczeniu `Class.Instance` lub jednego z jego przodków za pomocą `Class.Instance:Destroy()`.

Przy zachowaniu `Enum.SignalBehavior.Deferred|Deferred`, podłączenie skryptu do własnego zdarzenia `Class.Instance.Destroying` jest problematyczne, ponieważ skrypt zostanie zniszczony przed wywołaniem zwrotnego (co oznacza, że nie zostanie wykonany).

Podczas usuwania `Class.Instance` w Studio, na przykład ręcznie usuwając przez [Eksplorator](/studio/explorer) lub przez wtyczkę, `Class.Instance` nie jest niszczony. Zamiast tego rodzic jest ustawiany na `nil`, co możesz śledzić za pomocą `Class.Instance.AncestryChanged`.

Instance.Destroying

Wywołuje się natychmiast przed (lub jest opóźnione do po) zniszczenia instancji za pomocą `Class.Instance:Destroy()`.

Demonstruje `Class.Instance.StyledPropertiesChanged`.


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

Instance.StyledPropertiesChanged

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

Ta metoda stosuje tag do instancji, nie mając wpływu, jeśli tag jest
już zastosowany. Pomyślne dodanie tagu wywoła sygnał utworzony przez
`Class.CollectionService:GetInstanceAddedSignal()` z danym tagiem.

#### Ostrzeżenia

- Tag instancji, który został dodany po stronie klienta, zostanie usunięty, jeśli
  serwer później doda lub usunie tag na tej instancji, ponieważ serwer
  replikuje wszystkie tagi razem i nadpisuje poprzednie tagi.

- Podczas tagowania instancji, powszechnie używane są pewne zasoby do
  nadania tagowi jego funkcjonalności, na przykład połączenia zdarzeń lub tabele.
  Aby zapobiec wyciekom pamięci, dobrym pomysłem jest ich oczyszczenie (rozłączenie,
  ustawienie na `nil`, itp.) gdy nie są już potrzebne dla tagu. Zrób to podczas
  wywoływania `Class.Instance:RemoveTag()`, wywołując
  `Class.Instance:Destroy()`, lub w funkcji połączonej z sygnałem
  zwróconym przez `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

Funkcja dzieci zwraca tablicę dzieci obiektu.

Instance:children

Ta metoda niszczy wszystkie dzieci i potomków instancji.

```
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 zniszczyć **wszystkich** dzieci i potomków, użyj albo
`Class.Instance:GetChildren()` albo `Class.Instance:GetDescendants()`, aby
przejść przez te dzieci/potomków i wybrać, co zniszczyć. Na przykład,
poniższy przykład kodu zniszczy wszystkie
`Class.BasePart|BaseParts` schodzą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 niszczy wszystkie dzieci instancji.

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

`Clone()` tworzy kopię instancji i wszystkich jej potomków,
ignorując wszystkie instancje, które nie są
`Class.Instance.Archivable|Archivable`. Kopia instancji korzenia 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 została **również** sklonowana,
  kopia będzie odnosić 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

Kopia instancji lub `nil`, jeśli instancja nie jest
`Class.Instance.Archivable|Archivable`.


Tworzy kopię instancji i 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 poprawnym sposobem na pozbycie się
obiektów, które nie są już potrzebne.

Pozbycie 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ą
w dłuższym czasie.

Jako najlepsza praktyka po wywołaniu `Destroy()` na obiekcie, ustaw wszelkie
zmienne odnoszą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 = "Hello, world"
part:Destroy()
-- Nie rób tego:
print(part.Name)  --> "Hello, world"
-- Zrób to, aby zapobiec działaniu powyższej linii:
part = nil
```
Gdy `Class.Instance` zostanie zniszczona przez tę metodę, nie może być
ponownie użyta, 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 bezpośredniego
`Class.Instance.Parent` instancji i działa w kierunku `Class.DataModel`. Jeśli nie
znaleziono pasującego przodka, 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 konkretnej klasy,
proszę zobaczyć `Class.Instance:FindFirstAncestorOfClass()` i
`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 bezpośredniego
`Class.Instance.Parent` instancji i działa w kierunku `Class.DataModel`. Jeśli nie
znaleziono pasującego przodka, zwraca `nil`.

Powszechnym użyciem tej metody jest znalezienie `Class.Model`, do
którego 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` zamiast
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` również
istnieje, używając metody `Class.Object:IsA()`, aby respektować dziedziczenie 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 bezpośredniego
`Class.Instance.Parent` instancji i działa w kierunku `Class.DataModel`. Jeśli nie
znaleziono pasującego przodka, zwraca `nil`.

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

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Dlatego 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
bezpośrednie dzieci `Class.Instance`.

#### Sprawdzanie istnienia obiektu

`FindFirstChild()` jest konieczne, jeśli musisz zweryfikować, że obiekt istnieje
przed kontynuowaniem. Próba indeksowania dziecka według nazwy za pomocą operatora kropkowego
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 przestrzeni roboczej
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
```

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

Czasami `Class.Instance.Name|Name` obiektu jest taka sama jak
właściwość jego `Class.Instance.Parent|Parent`. Podczas używania operatora kropkowego,
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 dodawany 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 instancji
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")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Właściwość
local c2 = part:FindFirstChild("Color")  -- Dziecko folderu
```

#### Uwagi dotyczące wydajności

`Class.Instance:FindFirstChild()|FindFirstChild()` zajmuje około 20% dłużej
niż użycie operatora kropkowego i prawie 8 razy dłużej niż po prostu przechowywanie
odniesienia do obiektu. Dlatego powinieneś unikać wywoływania go w
kodzie zależnym od wydajności, takim jak w ciasnych pętlach lub funkcjach połączonych
z `Class.RunService.Heartbeat` i `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 danej nazwie staje się dostępne.

Instance:FindFirstChild

recursive

Czy wyszukiwanie powinno być przeprowadzane rekurencyjnie.

Zwraca pierwsze dziecko `Class.Instance` znalezione z podaną nazwą.

Instance:findFirstChild

Zwraca pierwsze dziecko `Class.Instance`, którego
`Class.Object.ClassName|ClassName` jest równy 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
znaleziono pasującego dziecka, ta metoda zwraca `nil`.

Instance:FindFirstChildOfClass

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

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

Jeśli nie znaleziono pasującego dziecka, ta metoda zwraca `nil`. Jeśli opcjonalny
argument rekurencyjny jest prawdziwy, ta metoda przeszukuje wszystkich potomków,
a nie tylko bezpośrednie dzieci `Class.Instance`.

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

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Dlatego 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 według nazwy 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 parametru `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`, zwracany jest sam `Class.Actor`. W przeciwnym razie zwracany jest jego najbliższy przodek `Class.Actor`. Jeśli żaden
przodek nie jest `Class.Actor`, wynik to `nil`.

Instance:GetActor

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

Ta metoda zwraca wartość, która została przypisana do podanej
nazwy atrybutu. Jeśli żaden atrybut nie został przypisany, zwracane jest `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óra ustawia atrybut o podanej
  nazwie na podaną wartość.
- `Class.Instance:GetAttributes()`, która zwraca słownik par klucz-wartość
  dla każdego z atrybutów instancji.

Instance:GetAttribute

Wartość, która została przypisana do podanej nazwy atrybutu. Jeśli żaden
atrybut nie został przypisany, zwracane jest `nil`.

Zwraca wartość, która została przypisana do podanej nazwy atrybutu.

Ta metoda zwraca zdarzenie, które działa dokładnie jak
zdarzenie `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 dobrym pomysłem jest użycie tej metody zamiast połą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ą to samo zdarzenie.

Poniższy przykład kodu zwraca sygnał, który wywołuje funkcję
`attributeChanged()`, gdy atrybut `InitialPosition` części się zmienia:

```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 jest zmieniany na instancji.

Instance:GetAttributeChangedSignal

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

Zdarzenie, które wywołuje się, gdy dany atrybut się zmienia.

Zwraca zdarzenie, które wywołuje się, 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
oraz 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 podanej nazwy atrybutu.

Instance:GetAttributes

Słownik par string → wariant dla każdego atrybutu, gdzie
string 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żdą `Class.Instance`, której
`Class.Instance.Parent|Parent` jest równy obiektowi. Tablica może być
iterowana za pomocą pętli numerycznej lub 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 żadnym szczególnym porządku, więc
ręczne sortowanie (na przykład za pomocą `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 to identyfikator używany w procesach debugowania. Pozwala
  debuggerowi odczytać każdą instrukcję przed przetworzeniem jej przez aplikację. Wszystkie obiekty w
  Roblox działają jak procesy i każda uruchamia instrukcje (lub 'kod'), które mogą
  być debugowane w razie potrzeby.
- Może to być pomocne dla wtyczek, które muszą odróżnić podobne
  obiekty od siebie (na przykład obiekty, które mają 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 znajduje każde dziecko obiektu,
każde dziecko tych dzieci, i tak dalej.

Zauważ, że zwrócona tablica **nie** jest posortowana w żadnym szczególnym porządku, więc
ręczne sortowanie (na przykład za pomocą `Library.table.sort()`) jest zalecane do
sortowania potomków zwróconych przez tę metodę. Rozważ także metodę
`Class.Instance:QueryDescendants()|QueryDescendants()`, aby zapytać o potomków za pomocą
kombinacji selektorów i kombinatorów.

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 pochodzenie instancji. Ciąg jest konkatenacją
`Class.Instance.Name|Name` obiektu i jego przodków, oddzielonych kropkami. `Class.DataModel`
(`game`) nie jest brane pod uwagę. Na przykład, `Class.Part` w `Class.Workspace`
może zwrócić `Class.Workspace.Part`.

Gdy jest wywoływana na `Class.Instance`, która nie jest potomkiem
`Class.DataModel`, ta metoda uwzględnia 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ć
analizować zwróconego ciągu w celu jakiejkolwiek użytecznej operacji; ta metoda nie
ucieka kropek (ani żadnych innych symboli) w nazwach obiektów. Innymi słowy,
chociaż jej wynik często wydaje się być ważnym identyfikatorem Luau, nie jest to
gwarantowane.

Instance:GetFullName

Zwraca ciąg opisujący pochodzenie instancji.

Demonstruje `Class.Instance:GetStyled()`.


Ta metoda zwraca stylizowaną lub jawnie zmodyfikowaną wartość
określonej 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, takiej jak `[GuiObject].Rotation`, która zwraca domyślną lub
zmodyfikowaną wartość właściwości.

Instance:GetStyled

Nazwa właściwości, którą chcesz zapytać.

selector

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

Stylizowana lub jawnie zmodyfikowana wartość określonej właściwości, lub
domyślna wartość właściwości, jeśli nie została stylizowana/zmodifikowana.

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

Demonstruje `Class.Instance:GetStyledPropertyChangedSignal()`.


Ta metoda zwraca zdarzenie, które działa dokładnie jak
zdarzenie `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
z tą różnicą, że wywołuje się tylko wtedy, gdy zmienia się dany styl atrybutu. Zazwyczaj
jest to dobry pomysł, aby użyć 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ą to samo zdarzenie.

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.

Instance:GetStyledPropertyChangedSignal

property

Nazwa właściwości stylu, dla której chcesz nasłuchiwać zmiany.

Zdarzenie, które wywołuje się, gdy dany styl atrybutu się zmienia.

Zwraca zdarzenie, które wyzwala się, gdy dany styl właściwości zmienia się na
instancji.


Ta metoda zwraca tablicę tagów przypisanych do danej instancji, jako
ciągi. Możesz dodawać tagi zarówno w Studio w oknie
[Właściwości](/studio/properties), jak i w czasie działania za pomocą
`Class.Instance:AddTag()|AddTag()`.

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

Instance:GetTags

Tablica ciągów, z których każdy reprezentuje tag przypisany do instancji.


Pobiera tablicę wszystkich tagów przypisanych do instancji.

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

Instance:HasTag

`true`, jeśli instancja ma dany tag, `false` w przeciwnym razie.


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 jeden z jego rodziców
`Class.Instance.Parent` jest ustawiony 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 z
domyślnego, utworzonego przez kod. Jeśli wywołana na instancji nowo utworzonej za pomocą
`Datatype.Instance.new()`, ta metoda zwróci `false`. Jeśli
wywołana na obiekcie nowo utworzonym przez procesy Studio, takie jak
wstawienie w oknie [Eksplorator](/studio/explorer), wynik może
się różnić.

Na przykład, zapytanie o
`Class.TextLabel.BackgroundColor3|BackgroundColor3` właściwość
`Class.TextLabel` wstawione przez okno [Eksplorator](/studio/explorer)
zwróci `true`, ale zapytanie o tę samą właściwość `Class.TextLabel`
utworzone przez `Datatype.Instance.new()` zwróci `false`, zakładając, że nie
wprowadzono innych zmian do
`Class.TextLabel.BackgroundColor3|BackgroundColor3`.

Zauważ, że ta metoda zwraca użyteczne wyniki tylko dla usług i
instancji tworzonych przez użytkowników. Wartości zwracane dla właściwości
systemowych instancji, takich jak `Class.PackageLink`, są nieokreślonym zachowaniem.

Zauważ także, że jeśli ta metoda zwraca `true`, stylizacja **nie** wpłynie
na właściwość, ponieważ jawne modyfikowanie właściwości ma pierwszeństwo
przed stylizowaniem jej. Aby zresetować właściwość do jej domyślnego, utworzonego przez kod i
pozwolić na stylizację, użyj
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.

Instance:IsPropertyModified

Boolean wskazujący, czy właściwość została zmodyfikowana z jej
domyślnego, utworzonego przez kod.

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

Ta metoda obiektu zwraca tablicę, która zawiera wszystkich potomków obiektu,
którzy pasują do podanego ciągu `selector`. `selector` może zawierać
wiele selektorów i kombinatorów, aby dopasować cechy, takie jak nazwa klasy,
nazwa instancji i relacje hierarchiczne, a także
konkretne wartości właściwości instancji i atrybutów. 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ą wspierane lub nie.

#### Selektory

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

Selektory mogą być również łączone. Na przykład,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` dopasuje instancje, które są
`Class.Model` oznaczone jako `Apple` i które mają atrybut `Variety`
równy `Fuji`, a także atrybut `Flavor` równy `4`.

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

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

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

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

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

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

#### Kombinatory

Kombinatory pozwalają na mieszanie podstawowych selektorów, aby dopasować głębsze relacje hierarchiczne.

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

- `>>` — Dopasowuje instancje, które są **potomkami** poprzednich dopasowań 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 potomków. Tylko elementy pasujące do filtru są umieszczane w
  zwróconej tablicy; `nil` nie będzie uwzględnione dla niepasujących w liście zapytania.

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

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

-- Pobierz bezpośrednie dzieci, które są Częścią i są oznaczone jako "Jabłko"
print(Workspace:QueryDescendants("> Część.Jabłko"))

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

-- Pobierz potomków MeshPart oznaczonych jako "CzęśćMiecza" LUB z atrybutem "OnFire" ustawionym na prawdę
print(Workspace:QueryDescendants("MeshPart.CzęśćMiecza, MeshPart[$OnFire = true]"))
```

#### Selektory pseudo-klas

- `:not(lista złożonych selektorów)` — 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(lista selektorów względnych)` — Pozwala na wybieranie instancji na podstawie
  tego, które instancje zawierają wewnątrz. Lista selektorów jest oceniana
  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 "CzęśćMiecza"
print(Workspace:QueryDescendants(":not(Model > .CzęśćMiecza)"))

-- Pobierz potomków, którzy zawierają instancję Narzędzia jako swojego potomka
print(Workspace:QueryDescendants(":has(Narzędzie)"))
-- Pobierz potomków MeshPart, którzy zawierają bezpośrednie dziecko oznaczone jako "CzęśćMiecza"
print(Workspace:QueryDescendants("MeshPart:has(> .CzęśćMiecza)"))

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

Instance:QueryDescendants

Ciąg selektora używany do filtrowania elementów.

Tablica instancji (pusta, jeśli nic nie pasuje do selektora).

Zwraca tablicę zawierającą wszystkich potomków instancji, którzy pasują do
ciągu `selector`.

Poniższy kod demonstruje, jak część może zostać ponownie dodana do DataModel
dan po jej usunięciu:

Ta metoda ustawia `Class.Instance.Parent` obiektu na `nil`, a to samo robi
dla wszystkich jego potomków.

Jeśli obiekt jest referencjonowany przed usunięciem, możliwe jest
ponowne uzyskanie obiektu w późniejszym czasie.

Instance:Remove

Ustawia `Parent` obiektu na `nil`, a to samo robi dla wszystkich jego
potomków.

Instance:remove

Ta metoda usuwa tag z instancji. Nie zgłosi błędu, jeśli obiekt nie ma tagu. Pomyślne usunięcie tagu wywoła sygnał utworzony przez `Class.CollectionService:GetInstanceRemovedSignal()` z danym tagiem.

Należy pamiętać, że podczas tagowania instancji często używane są zasoby, aby nadać tagowi jego funkcjonalność, na przykład połączenia zdarzeń lub tabele. Aby zapobiec wyciekom pamięci, dobrze jest je oczyścić (rozłączyć, ustawić na `nil`, itp.) gdy nie są już potrzebne dla tagu.

Instance:RemoveTag

Resetuje właściwość do jej wartości domyślnej. Na przykład, wywołanie `ResetPropertyToDefault("Rotation")` na `Class.TextLabel` jest równoważne ustawieniu `Class.TextLabel.Rotation|Rotation` na `0` (domyślna wartość właściwości). Ta metoda może być używana, aby upewnić się, że stylizacja nadpisze domyślną wartość tej właściwości.

Instance:ResetPropertyToDefault

Resetuje właściwość do jej wartości domyślnej.

Ta metoda ustawia atrybut o danej nazwie na daną wartość. Jeśli podana wartość to `nil`, atrybut zostanie usunięty, ponieważ `nil` jest zwracane domyślnie.

Na przykład, poniższy fragment kodu ustawia atrybut `InitialPosition` instancji na `Datatype.Vector3|Vector3.new(0, 10, 0)`:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

#### Ograniczenia

Wymagania i ograniczenia dotyczące nazw:

- Nazwy mogą używać tylko znaków alfanumerycznych.
  - Możesz również używać kropek, myślników, ukośników i podkreśleń.
- Nie są dozwolone spacje ani unikalne symbole (takie jak @, ~, !).
- Ciągi muszą mieć 100 znaków lub mniej.
- Nazwy nie mogą zaczynać się od **RBX**, chyba że wywołujący jest skryptem rdzeniowym Roblox (zarezerwowane dla Roblox).

Przy próbie ustawienia atrybutu na nieobsługiwany typ, zostanie zgłoszony błąd.

#### Zobacz także

- `Class.Instance:GetAttribute()` który zwraca wartość przypisaną do danej nazwy atrybutu.
- `Class.Instance:GetAttributes()` który zwraca słownik par klucz-wartość dla każdego z atrybutów instancji.

Instance:SetAttribute

value

Wartość, którą należy ustawić dla określonego atrybutu.

Ustawia atrybut o danej nazwie na daną wartość.

Poniższy kod czeka na dodanie instancji o nazwie "Part" do
Workspace.


Zwraca dziecko `Class.Instance` o danej nazwie. Jeśli dziecko nie istnieje, wstrzyma bieżący wątek, aż do jego utworzenia. Jeśli parametr `timeOut` jest określony, ta metoda zakończy działanie po określonej liczbie sekund i zwróci `nil`.

#### Główne zastosowanie

`Class.Instance:WaitForChild()|WaitForChild()` jest niezwykle ważne podczas pracy z kodem uruchamianym przez klienta w `Class.LocalScript`. Silnik Roblox nie gwarantuje czasu ani kolejności, w jakiej obiekty są replikowane z serwera do klienta. Dodatkowo, jeśli doświadczenie ma ustawione `Class.Workspace.StreamingEnabled` na true, `Class.BasePart|BaseParts`, które są daleko od postaci gracza, mogą nie być przesyłane do klienta, co może spowodować awarie skryptów podczas indeksowania obiektów, które jeszcze nie istnieją na kliencie.

#### Uwagi

- Ta metoda nie wstrzymuje, jeśli dziecko o danej nazwie istnieje w momencie wywołania.
- `Class.Instance:FindFirstChild()` jest bardziej wydajną alternatywą dla `Class.Instance:WaitForChild()|WaitForChild()` dla obiektów, które są zakładane jako istniejące.
- Jeśli wywołanie tej metody przekroczy 5 sekund bez zwrócenia, a parametr `timeOut` nie został określony, w konsoli zostanie wydrukowane ostrzeżenie, że wątek może wstrzymać się na czas nieokreślony.

Instance:WaitForChild

Zwraca dziecko `Class.Instance` o danej nazwie. Jeśli dziecko nie istnieje, wstrzyma bieżący wątek, aż do jego utworzenia.

Instance

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

/reference/engine/classes/Translator.yaml