FeatureRestrictionManager

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

Nie można bezpośrednio tworzyć obiektów `Instance` korzenia, 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 rodowodzie instancji poprzez połączenie z wydarzeniem `Class.Instance.AncestryChanged`.

Rodzic ChangingPart jest ustawiany na różne wartości w czasie. Rodzic części to przodek części, więc wydarzenie `Class.Instance.AncestryChanged` zostanie wywołane za każdym razem, gdy się zmieni.

Wyzwala zdarzenie, gdy właściwość `Class.Instance.Parent` obiektu lub jednego z
jego przodków jest zmieniana.

To zdarzenie zawiera dwa parametry: `child` odnosi się do `Class.Instance`,
którego `Class.Instance.Parent` faktycznie się zmienił, podczas gdy `parent` odnosi
się do nowego `Class.Instance.Parent` tej instancji.

Możesz użyć tego zdarzenia, aby śledzić usunięcie instancji w Studio,
na przykład podczas usuwania ręcznego w Eksploratorze lub przez wtyczkę. Jeśli potrzebujesz
detekcjonować, kiedy instancja jest niszczona przy użyciu `Class.Instance:Destroy()`,
zamiast tego użyj zdarzenia `Class.Instance.Destroying`.


Instance.AncestryChanged

child

Obiekt `Class.Instance`, którego `Class.Instance.Parent` został zmieniony.


parent

Nowy `Class.Instance.Parent` dla `Class.Instance`, którego
`Class.Instance.Parent` został zmieniony.


Wyzwala zdarzenie, gdy właściwość `Class.Instance.Parent` obiektu lub jednego z
jego przodków jest zmieniana.


To zdarzenie wyzwala, gdy jakikolwiek atrybut jest zmieniany na instancji,
w tym przypadku, gdy atrybut zostaje ustawiony na `nil`. Nazwa
zmienionego atrybutu jest przekazywana do podłączonej funkcji.

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

```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óry zwraca zdarzenie
yzszące, gdy dany atrybut się zmienia.


Instance.AttributeChanged

attribute

Nazwa atrybutu, który został zmieniony.


Wyzwala zdarzenie, gdy jakikolwiek atrybut jest zmieniany na `Class.Instance`.


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

Wyzwala zdarzenie, gdy obiekt zostaje dodany do tego `Class.Instance`.

Należy pamiętać, że podczas używania tej funkcji na kliencie w celu wykrycia obiektów utworzonych 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 być replikowani
	local head = child:WaitForChild("Head")
end)
```
Należy pamiętać, że ta funkcja działa tylko dla bezpośrednich dzieci `Class.Instance`.
Aby uzyskać funkcję, która łapie wszystkie potomków, użyj
`Class.Instance.DescendantAdded`.

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


Instance.ChildAdded

Obiekt `Class.Instance`, który został dodany.


Wyzwala zdarzenie, gdy obiekt zostaje dodany do tego `Class.Instance`.


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

Wyzwala zdarzenie, gdy dziecko jest usuwane 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`. Należy pamiętać, że to
zdarzenie wyzwoli się również, gdy dziecko zostanie zniszczone (przy użyciu
`Class.Instance:Destroy()`) ponieważ funkcja zniszczenia zmienia rodzica obiektu
na `nil`.

Ta funkcja działa tylko dla bezpośrednich dzieci `Class.Instance`.
Aby uzyskać funkcję, która łapie wszystkie potomków, użyj
`Class.Instance.DescendantRemoving`.

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


Instance.ChildRemoved

Obiekt `Class.Instance`, który został usunięty.


Wyzwala zdarzenie, gdy dziecko jest usuwane z tego `Class.Instance`.


Poniższy przykład wyświetli nazwę każdego obiektu, który zostanie dodany do
Workspace:

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

Zdarzenie to wyzwala się dla każdego potomka, więc dodanie obiektu do
`Class.Instance` spowoduje wyzwolenie zdarzenia dla tego obiektu oraz 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 zdarzenie 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** tym, jak rodzic `Class.Instance`
zmienia się, tak że instancja **potomka** nie będzie już potomkiem. `Class.Instance:Destroy()|Destroy()` zmienia rodzica instancji
`Class.Instance.Parent|Parent` na `nil`, więc 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 momencie wyzwolenia 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,
po którym następują jego potomkowie.

##### Ostrzeżenie

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

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Nie manipuluj rodzicem potomka w tej funkcji!
	-- To zdarzenie wyzwala się Z POWODU, że rodzic został
	-- złamany, a zmiana jeszcze nie nastąpiła
	-- Dlatego 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

Obiekt `Class.Instance`, który jest usuwany.


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


Ten przykład demonstruje, jak przy użyciu zachowania sygnałów natychmiastowych, instancja będąca niszczona pozostaje w miejscu aż do momentu, gdy podłączona funkcja wywoła yield.

Ten przykład demonstruje, jak, przy użyciu opóźnionego zachowania sygnałów,
instancja jest niszczona przed wywołaniem sygnału.

Obiekt `Class.Instance` nigdy nie zostanie usunięty z pamięci, gdy
połączona funkcja używa go nadal. Jednak jeśli funkcja wstrzyma w jakimkolwiek punkcie,
`Class.Instance` i jego potomkowie zostaną przypisani do `nil`.

Jeśli właściwość `Class.Workspace.SignalBehavior`
jest ustawiona na `Enum.SignalBehavior.Immediate`, to zdarzenie wyzwala się
natychmiast przed tym, kiedy `Class.Instance` lub jeden z jego przodków
zostanie zniszczony przy pomocy `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 wznawiania, co będzie po tym, jak `Class.Instance` lub jeden z jego przodków
zostanie zniszczony przy pomocy `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 wywołaniem zwrotnym (co oznacza, że nie
wykona się).

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


Instance.Destroying

Wyzwala zdarzenie natychmiast przed (lub jest opóźnione do po) obiekt jest
destrukcyjny przez `Class.Instance:Destroy()`.


To zdarzenie wyzwala się, gdy zmieniana jest jakakolwiek właściwość stylu na obiekcie,
w tym przypadku, gdy 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("Zmieniono właściwości stylu")
end

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


Instance.StyledPropertiesChanged

Wyzwala się za każdym razem, gdy zmieniana jest jakakolwiek właściwość stylu na obiekcie,
w tym przypadku, gdy właściwość jest ustawiana na `nil`.


Instance.childAdded

Ta metoda stosuje tag do instancji, nie mając wpływu, jeśli tag jest
już zastosowany. Skuteczne dodanie tagu spowoduje aktywację sygnału stworzonego
przez `Class.CollectionService:GetInstanceAddedSignal()` z danym tagiem.

##### Ostrzeżenia

- Tag instancji 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.

- Przy tagowaniu instancji, często wykorzystywane są pewne zasoby w
  celu nadania tagowi jego funkcjonalności, na przykład połączenia zdarzeń
  czy tabele. Aby zapobiec wyciekom pamięci, dobrze jest oczyścić je
  (rozłączyć, ustawić na `nil`, itp.) kiedy nie są już potrzebne dla tagu.
  Zrób to przy wywołaniu `Class.Instance:RemoveTag()`, wywołując
  `Class.Instance:Destroy()`, lub w funkcji podpiętej do sygnału
  zwróconego przez `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

Ta funkcja 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("Children:", #part:GetChildren())  --> Dzieci: 3

part:ClearAllChildren()

print("Children:", #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
przejrzeć te dzieci/potomków i wybrać co zniszczyć. Na przykład,
poniższy fragment 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 funkcja 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 głównej jest
zwracana przez tę metodę, a jej `Class.Instance.Parent|Parent` jest ustawiane na
`nil`. Należy pamiętać, że jeśli sama instancja ma
`Class.Instance.Archivable|Archivable` ustawione na `false`, ta funkcja
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ść utrzymywana jest w kopii.


Instance:Clone

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


Demonstracja zniszczenia Części przy użyciu funkcji `Class.Instance:Destroy()`.

Ta funkcja jest poprawnym sposobem usuwania 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
y wywołuje `Destroy()` na wszystkich dzieciach. Ta funkcja jest
poprawnym sposobem zwolnienia obiektów, które nie są już wymagane.

Zwalnianie niepotrzebnych obiektów jest ważne, ponieważ niepotrzebne obiekty i
połączenia w miejscu wykorzystują 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 odnoszące się do obiektu (lub jego potomków) na `nil`.
Zapobiega to 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
```
Kiedy `Class.Instance` zostanie zniszczony przez tę metodę, nie można go
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 ustalonej ilości czasu, 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.


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

Ta funkcja działa w górę, co oznacza, że zaczyna od najbliższego
`Class.Instance.Parent` instancji i idzie w górę w kierunku `Class.DataModel`. Jeśli żaden
pasujący przodek nie zostanie znaleziony, zwraca `nil`.

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

```
local car = object:FindFirstAncestor("Car")
```
Dla wariantów tej funkcji, które znajdują przodków określonej klasy,
patrz `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 danej nazwie.


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

Ta funkcja działa w górę, to znaczy, że zaczyna od najbliższego
`Class.Instance.Parent` instancji i idzie w górę w kierunku `Class.DataModel`. Jeśli żaden
matching ancestor is found, it returns `nil`.

Powszechnym użyciem tej funkcji jest znajdowanie `Class.Model`, do którego
należy `Class.BasePart`. Na przykład:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Ta funkcja 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()` zamiast,
aby uszanować 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 podanej nazwie klasy.


Zwraca pierwszego przodka `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawda dla danej nazwy klasy.

Ta funkcja działa w górę, co oznacza, że zaczyna od najbliższego
`Class.Instance.Parent` instancji i idzie w górę w kierunku `Class.DataModel`. Jeśli żaden
pasujący przodek nie zostanie znaleziony, zwraca `nil`.

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

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Dlatego poniższy fragment 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 prawda dla danej nazwy klasy.


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` o podanej nazwie, lub
`nil`, jeśli takie dziecko nie istnieje. Jeśli opcjonalny argument `recursive`
jest `true`, ta funkcja przeszukuje wszystkich potomków, a nie tylko
bezpośrednich dzieci `Class.Instance`.

##### Sprawdzanie istnienia obiektu

`FindFirstChild()` jest konieczne, jeśli potrzebujesz
zweryfikować, czy obiekt istnieje przed kontynuowaniem. Próbując indeksować
dziecko 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 przestrzeni roboczej
Workspace.Part.Transparency = 0.5
```
Lepszym podejściem jest użycie `FindFirstChild()`, aby najpierw sprawdzić,
czy `Part` istnieje, a następnie użycie 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 odpowiada właściwości

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

W poniższym przykładzie, `Class.Folder` nazywana `Color` jest dodawana 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
dzieci `Class.Folder`. Korzyścią z używania
`Class.Instance:FindFirstChild()|FindFirstChild()` jest to, że
dodanie nowych właściwości nie stanowi 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")  -- folder dziecka
```

##### Uwagi dotyczące wydajności

`Class.Instance:FindFirstChild()|FindFirstChild()` trwa około 20% dłużej
niż użycie operatora kropki i prawie 8 razy dłużej niż po prostu przechowywanie
odwołania do obiektu. Dlatego należy unikać wywoływania go w kodzie
zależnym od wydajności, takim jak w wąskich 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 stanie się dostępne.


Instance:FindFirstChild

recursive

Czy wyszukiwanie powinno być przeprowadzone rekurencyjnie.


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


Zwraca pierwsze dziecko `Class.Instance`, którego
`Class.Object.ClassName|ClassName` jest równy podanemu `className`.
W przeciwieństwie do `Class.Instance:FindFirstChildWhichIsA()`, ta funkcja
zwraca tylko obiekty, których klasa odpowiada `className`, ignorując
dziedziczenie klas. Jeśli nie znaleziono pasującego dziecka, ta funkcja
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 prawda dla danej nazwy klasy.

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

W przeciwieństwie do `Class.Instance:FindFirstChildOfClass()`, ta funkcja
używa `Class.Object:IsA()`, które 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 fragment 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, którzy szukają dziecka po nazwie, powinni zamiast tego używać
`Class.Instance:FindFirstChild()`.


Instance:FindFirstChildWhichIsA

Zwraca pierwsze dziecko `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawda dla danej nazwy klasy.


Zwraca pierwszego potomka znalezionego z danym
`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

Nazwa `Class.Instance.Name`, którą należy wyszukiwać.


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


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


Instance:GetActor

Zwraca `Class.Actor` zwią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 dostęp do wartości
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 danej
  nazwie na daną 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 funkcja zwraca zdarzenie, które działa dokładnie jak zdarzenie
`Class.Object.Changed|Changed`, z tą różnicą, że wywołuje się tylko,
gdy dany atrybut się zmienia; efektywnie jest podobne do
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`, ale
dla atrybutów.

Ogólnie rzecz biorąc, dobrze jest używać tej metody zamiast połączenia z
`Class.Object.Changed|Changed` z funkcją, która sprawdza nazwę atrybutu.
Subsequent calls to this method on the same object with the same
atrybut name return the same event.

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 zmieni się na instancji.


Instance:GetAttributeChangedSignal

Nazwa wskazanego 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ść różna od `nil`.

Na przykład, poniższy fragment kodu wyświetla atrybuty instancji
oraz 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ść różna od 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ą lub 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
```
Dzieci są sortowane według kolejności, w jakiej ich
właściwość `Class.Instance.Parent|Parent` została ustawiona na obiekt.

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


Instance:GetChildren

Zwraca tablicę zawierającą wszystkie dzieci instancji.


Zwraca zakodowany ciąg identyfikatora debugowania używanego wewnętrznie przez Roblox. Należy pamiętać,
ż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 to debuggerowi odczytać każdą instrukcję zanim aplikacja ją
  przetworzy. Wszystkie obiekty w
  Roblox działają jak procesy i każda uruchamia instrukcje (lub 'kod'), które mogą być
  debugowane w razie potrzeby.
- To może być pomocne dla wtyczek, które muszą
  odróżniać 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 odróżnieniu od `Class.Instance:GetChildren()`, który zwraca tylko
bezpośrednie dzieci obiektu, ta metoda znajduje każde dziecko obiektu,
każde dziecko tych dzieci i tak dalej.


Instance:GetDescendants

Tablica zawierająca potomków instancji.


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


Ten przykład kodu demonstruje działanie `Class.Instance:GetFullName()`.
Pokazuje, jak funkcja działa, gdy jest wywoływana na obiekcie niebędącym w
hierarchii `DataModel`, a także pokazuje, jak wartość zwracana nie ucieka
od specjalnych znaków.

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

Returns a string describing the instance's ancestry. The string is a
concatenation of the `Class.Instance.Name|Name` of the object and its
ancestors, separated by periods. The `Class.DataModel` (`game`) is not
considered. For example, a `Class.Part` in the `Class.Workspace` may
return `Class.Workspace.Part`.

When called on an `Class.Instance` that is not a descendant of the
`Class.DataModel`, this function considers all ancestors up to and
including the topmost one without a `Class.Instance.Parent|Parent`.

This function is useful for logging and debugging. You shouldn't attempt
to parse the returned string for any useful operation; this function does
not escape periods (or any other symbol) in object names. In other words,
although its output often appears to be a valid Luau identifier, it is not
guaranteed.


Instance:GetFullName

Zwraca ciąg opisujący pochodzenie instancji.


This method returns the styled or explicitly modified value of the
specified property, or else the default property value if it hasn't been
styled/modified. This differs slightly from accessing the property value
directly, such as `[GuiObject].Rotation`, which returns the default or
modified value of the property.

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

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

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

-- Reference to a button
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (default value)
print(button.Rotation) --> 0 (default value)

-- Apply rotation through style rule property
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (styled value based on rule)
print(button.Rotation) --> 0 (default value)

-- Explicitly modify/override styled property
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (modified value)
print(button.Rotation) --> 45 (modified value)
```


Instance:GetStyled

The styled or explicitly modified value of the specified property, or
else the default property value if it hasn't been styled/modified.


Returns the styled or explicitly modified value of the specified property,
or else the default property value if it hasn't been styled/modified.


This method returns an event that behaves exactly like the
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` event,
except that it only fires when the given style property changes. It's
generally a good idea to use this method instead of a connection to
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` with a
function that checks the property name. Subsequent calls to this method on
the same object with the same property name return the same event.

Note that this event will not pass any arguments to a connected function,
so the value of the changed property must be read directly within a
script.

```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("Style property changed!")
end

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


Instance:GetStyledPropertyChangedSignal

property

Name of the style property for which to listen for changes.


Event that fires when the given style property changes.


This method returns an array of the tags applied to the given instance, as
strings. You can add tags either in Studio in the
[Properties](/studio/properties) window or at runtime with
`Class.Instance:AddTag()|AddTag()`.

This method is useful when you want to do something with multiple tags on
an instance at once. However, it is inefficient to use this method to
check for the existence of a single tag; instead, use
`Class.Instance:HasTag()|HasTag()` to check for a specific tag.


Instance:GetTags

Gets an array of all tags applied to the instance.


This method returns `true` if the provided tag has been added to the
object. You can add tags either in Studio in the
[Properties](/studio/properties) window or at runtime with
`Class.Instance:AddTag()|AddTag()`.


Instance:HasTag

Check whether the instance has a given tag.


Demonstruje, jak ustalić, czy jedna instancja jest przodkiem drugiej, używając `Class.Instance:IsAncestorOf()`

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

SpawnLocation i jego dekalkizacja są potomkami Workspace, a nie przodkami.
Dekalizacja jest potomkiem SpawnLocation, a nie przodkiem.

Returns true if an `Class.Instance` is an ancestor of the given
descendant.

An `Class.Instance` is considered the ancestor of an object if the
object's `Class.Instance.Parent` or one of it's parent's
`Class.Instance.Parent` is set to the `Class.Instance`.

See also, `Class.Instance:IsDescendantOf()`.


Instance:IsAncestorOf

True if the `Class.Instance` is an ancestor of the given descendant.


Returns true if an `Class.Instance` is an ancestor of the given
descendant.


Returns `true` if an `Class.Instance` is a descendant of the given
ancestor.

Note that `IsDescendantOf()` cannot be used with a parameter of `nil` to
check if an object has been removed.

See also `Class.Instance:IsAncestorOf()`.


Instance:IsDescendantOf

ancestor

True if the `Class.Instance` is a descendant of the given ancestor.


Returns `true` if an `Class.Instance` is a descendant of the given
ancestor.


Zwraca `true`, jeśli wartość zapisana w danym polu jest równa
domysłowemu kodowanemu domyślnemu. Na przykład, jeśli wypisanie
właściwości `Class.TextLabel.TextSize|TextSize` obiektu `Class.TextLabel`
wskazuje `8`, to wywołanie `IsPropertyModified("TextSize")` na etykiecie
zwróci `false`, ponieważ `8` jest domyślną wartością dla
`Class.TextLabel.TextSize`, gdy etykieta jest tworzona przez
`Instance.new("TextLabel")`, a nie wstawiana przez
przepływy pracy w Studio.

Należy pamiętać, ż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.


Instance:IsPropertyModified

Wartość logiczna wskazująca, czy właściwość jest zmodyfikowana.


Zwraca `true`, jeśli wartość zapisana w danym polu jest równa
domysłowemu kodowanemu domyślnemu.


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

Ta funkcja ustawia `Class.Instance.Parent` obiektu na `nil`, a to samo
dla wszystkich jego descendentów.

Jeśli obiekt jest odniesiony przed usunięciem, możliwe jest
tymczasowe odzyskanie obiektu.


Instance:Remove

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


Ta metoda usuwa etykietę z instancji. Nie spowoduje błędu, jeśli
obiekt nie ma tej etykiety. Pomyślne usunięcie etykiety wyzwoli sygnał
utworzony przez `Class.CollectionService:GetInstanceRemovedSignal()`
z określoną etykietą.

Należy pamiętać, że podczas etykietowania instancji często używane są
pewne zasoby, aby nadać etykiecie jej funkcjonalność, na przykład połączenia wydarzeń lub
tabele. Aby zapobiec wyciekom pamięci, dobrze jest wydobyć te zasoby
(rozłączyć, ustawić na `nil` itp.), gdy już nie są potrzebne do etykiety.


Instance:RemoveTag

Resetuje właściwość do jej wartości domyślnej. Na przykład, wywołanie
`ResetPropertyToDefault("Rotation")` na obiekcie `Class.TextLabel` odpowiada
temu, aby ustawić jego `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 zastępuje
wartość domyślną tej właściwości.


Instance:ResetPropertyToDefault

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


Ta metoda ustawia atrybut o podanej nazwie na podaną wartość. Jeśli
dana wartość to `nil`, atrybut zostanie usunięty, ponieważ `nil` jest
zwracana 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 dotyczące nazewnictwa i ograniczenia:

- Nazwy muszą używać tylko znaków alfanumerycznych.
  - Można także używać kropek, myślników, ukośników i podkreśleń.
- Nie są dozwolone spacje ani unikalne symbole (takie jak @, ~, !) .
- Łańcuchy 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).

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

##### Zobacz także

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


Instance:SetAttribute

value

Wartość, na którą ma zostać ustawiony wskazany atrybut.


Ustawia atrybut o podanej nazwie na podaną wartość.


Następujący kod czeka na dodanie instancji o nazwie "Part" do
Workspace.

Zwraca dziecko obiektu `Class.Instance` o podanej nazwie. Jeśli
dziecko nie istnieje, wstrzyma bieżący wątek, aż się pojawi. Jeśli
parametr `timeOut` jest określony, ta metoda zakończy się po
określonej liczbie sekund i zwróci `nil`.

##### Główne zastosowanie

`Class.Instance:WaitForChild()|WaitForChild()` jest niezwykle ważne w
pracy z kodem wykonywanym przez klienta w `Class.LocalScript`. Silnik Roblox
nie gwarantuje czasu ani kolejności replikacji obiektów 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 potencjalnie spowoduje awarie skryptów podczas
indeksowania obiektów, które jeszcze nie istnieją na kliencie.

##### Uwagi

- Ta funkcja nie wstrzyma się, jeśli dziecko o podanej 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, że istnieją.
- Jeśli wywołanie tej metody przekroczy 5 sekund bez zwrócenia, a żaden
  parametr `timeOut` nie został określony, w konsoli zostanie wydrukowane
  ostrzeżenie, że wątek może wstrzymywać się w nieskończoność.


Instance:WaitForChild

childName

timeOut

Zwraca dziecko obiektu `Class.Instance` o podanej nazwie. Jeśli
dziecko nie istnieje, wstrzyma bieżący wątek, aż się pojawi.


Funkcja dzieci zwraca tablicę dzieci obiektu.


Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

Ta właściwość określa, czy instancja powinna być uwzględniona podczas
publikowania lub zapisywania doświadczenia, lub kiedy `Class.Instance:Clone()|Clone()`
jest wywoływana na jednym z przodków instancji. Bezpośrednie wywołanie
`Class.Instance:Clone()|Clone()` na instancji zwróci `nil`
jeśli ta instancja **nie** jest `Class.Instance.Archivable|Archivable`.

Kopiowanie obiektu w Studio za pomocą opcji **Duplikuj** lub **Kopiuj**/**Wklej**
zignoruje własną właściwość `Class.Instance.Archivable|Archivable`
i ustawi `Class.Instance.Archivable|Archivable` na `true` dla
kopii.

```
local part = Instance.new("Part")
print(part:Clone())  --> Part
part.Archivable = false
print(part:Clone())  --> nil
```


Instance.Archivable

Określa, czy `Class.Instance` i jego potomstwo mogą być klonowane za pomocą
`Class.Instance:Clone()`, oraz mogą być zapisywane/publikowane.


Zestaw możliwości, które można używać dla skryptów wewnątrz tej
instancji. Aby możliwości miały efekt, właściwość `Class.Instance.Sandboxed`
musi być włączona.

Ta właściwość jest używana przez funkcję eksperymentalną. Zobacz
[możliwości skryptów](/scripting/capabilities) dla dalszych
detalów.


Instance.Capabilities

Zestaw możliwości, które można używać dla skryptów wewnątrz tego
pojemnika.


Nieunikatowy identyfikator `Class.Instance`. Nazwy są używane do utrzymania
organizacji hierarchii obiektów, umożliwiając skryptom dostęp do
konkretnych obiektów. Nazwa instancji nie może przekraczać 100 znaków
w rozmiarze.

Nazwa obiektu jest często używana do uzyskiwania dostępu do obiektu przez hierarchię
danych przy użyciu następujących metod:

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

local baseplate = Workspace.Baseplate
local baseplate = Workspace["Baseplate"]
local baseplate = Workspace:FindFirstChild("BasePlate")
```
Aby obiekt był dostępny przy użyciu operatora kropki (`.`), jego
nazwa musi zaczynać się od podkreślenia lub litery, a reszta nazwy
może zawierać tylko litery, cyfry lub podkreślenia (żadne inne znaki
specjalne). Jeśli nazwa obiektu nie przestrzega tej składni, nie będzie
możliwe uzyskanie do niego dostępu przy użyciu operatora kropki a Luau nie zinterpretuje jego nazwy
jako identyfikatora.

Jeśli więcej niż jeden obiekt o tej samej nazwie jest rodzeństwem, każda próba
indeksowania obiektu według tej nazwy zwróci tylko jeden z obiektów, podobnie
jak w `Class.Instance:FindFirstChild()`, ale nie zawsze żądany obiekt.
Jeśli konkretnego obiektu trzeba uzyskać dostęp przez kod, zaleca się
dania mu unikalnej nazwy lub zapewnienie, że żadne z jego rodzeństwa nie dzieli się
taką samą nazwą.

Zobacz także `Class.Instance:GetFullName()`, aby uzyskać pełną nazwę w tym
łącznie z hierarchią obiektu.


Instance.Name

Nieunikatowy identyfikator `Class.Instance`.


Właściwość `Parent` określa hierarchicznego rodzica
`Class.Instance`. Poniższa terminologia jest powszechnie używana, gdy mówimy
o tym, jak ta właściwość jest ustawiana:

- Obiekt jest **dzieckiem** innego obiektu, gdy jego `Parent`
  jest ustawione na ten obiekt.

- **Potomkowie** `Class.Instance` to dzieci tego
  obiektu, a także potomkowie dzieci.

- **Przodkowie** `Class.Instance` to wszystkie obiekty, z którymi
  instancja jest potomkiem.

To z właściwości `Parent` wiele innych elementów API pobiera swoją
nazwę, takich jak `Class.Instance:GetChildren()|GetChildren()` oraz
`Class.Instance:FindFirstChild()|FindFirstChild()`. Ta właściwość jest również
używana do zarządzania tym, czy obiekt istnieje w doświadczeniu, czy
musi być usunięty. Tak długo, jak rodzic obiektu jest w
`Class.DataModel`, jest przechowywany w zmiennej lub jest
odwoływany przez właściwość innego obiektu, obiekt pozostaje w
doświadczeniu; w przeciwnym razie obiekt zostanie automatycznie
usunięty.

Wywołanie `Class.Instance:Destroy()|Destroy()` ustawi `Parent`
`Class.Instance` oraz wszystkie jego potomki na `nil`, a także **zablokuje**
właściwość `Parent`. W przypadku próby ustawienia `Parent` usuniętego obiektu
wyświetli się błąd.

Nowo utworzone obiekty za pomocą `Datatype.Instance.new()` nie będą miały
rodzica i zazwyczaj nie będą widoczne ani funkcjonować, dopóki nie został
taki ustawiony.

##### Replikacja obiektów

Obiekt utworzony przez serwer nie zostanie zreplikowany do klientów,
chyba że zostanie przypisany do jakiegoś obiektu, który jest
zreplikowany. Przy tworzeniu obiektu i ustawianiu wielu właściwości,
zwykle zaleca się ustawienie właściwości `Parent`
**na końcu**. Zapewnia to, że obiekt replikowany jest raz, zamiast replikować
wiele zmian właściwości.

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

-- Ustaw ostatnio rodzica nowej instancji (zalecane)
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Parent = Workspace
```
Jednak jeśli części mają być dzieci `Class.Model`, którego rodzic
nie został jeszcze ustawiony, przypisanie każdej części do tego modelu
jest akceptowalne, ponieważ model nie zostałby zreplikowany.


Instance.Parent

Określa hierarchicznego rodzica `Class.Instance`.


Ta właściwość używana była do chronienia obiektów w serwisie `Class.CoreGui`
przed nieautoryzowanymi zmianami przez użytkowników. Została
przestarzała i nie robi nic.


Instance.RobloxLocked

Przestarzała właściwość, która kiedyś chroniła obiekty `Class.CoreGui`.


Przekształca instancję w **piaskownicę**, funkcję eksperymentalną,
która ogranicza działania, które skrypty wewnątrz danego
pojemnika mogą wykonywać. Zobacz
[możliwości skryptów](/scripting/capabilities) dla dalszych
detalów.


Instance.Sandboxed

Przekształca instancję w piaskownicę.


Unikatowy identyfikator dla instancji, odmienny od `Class.Instance.Name`
który nie jest koniecznie unikatowy.


Instance.UniqueId

Instance.archivable

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


Obiekt jest klasą bazową dla wszystkich klas w hierarchii klas Roblox. Każda
inna klasa definiowana przez silnik Roblox dziedziczy wszystkie człony
Obiektu. Nie można bezpośrednio stworzyć Obiektu.


Ten przykład demonstruje subtelności zdarzenia Zmiany na normalnych obiektach
oraz obiektach "-Value".

To zdarzenie wyzwala się natychmiast po zmianie właściwości obiektu i
działa w większości przypadków użycia (zobacz ograniczenia poniżej). Nowa wartość
zmienionej właściwości **nie** jest przekazywana jako parametr, więc musi być
dostępna poprzez użycie `object[property]`. Na przykład:

```
object.Changed:Connect(function(property)
	print("Nowa wartość właściwości to", object[property])
end)
```
Jeśli interesuje cię tylko nasłuchiwanie zmiany jednej konkretnej
właściwości, rozważ użycie metody
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` zamiast.

Dla obiektów `Class.ValueBase`, takich jak `Class.IntValue`
i `Class.StringValue`, to zdarzenie wyzwala się tylko wtedy, gdy zmienia się właściwość
`Value` obiektu. Aby wykrywać inne zmiany w obiektach `Class.ValueBase`,
zastosuj zamiast tego `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`.

#### Ograniczenia

To zdarzenie **nie** wyzwala się w przypadku zmian związanych z fizyką, takich jak gdy
gdy
właściwości `Class.BasePart.CFrame|CFrame`,
`Class.BasePart.AssemblyLinearVelocity|AssemblyLinearVelocity`,
`Class.BasePart.AssemblyAngularVelocity|AssemblyAngularVelocity`,
`Class.BasePart.Position|Position`, lub
`Class.BasePart.Orientation|Orientation` obiektu `Class.BasePart`
zmieniają się z powodu grawitacji. Aby wykrywać zmiany w tych właściwościach,
rozważ użycie zdarzenia opartego na fizyce, takiego jak
`Class.RunService.PreSimulation`.

Dodatkowo, to zdarzenie może nie wyzwalać się przy każdej modyfikacji
właściwości, które zmieniają się bardzo często, i/lub może nie wyzwalać się dla takich
właściwości wcale. Zaleca się dokładne testowanie zmian właściwości, które
wpływają na logikę gry.


Object.Changed

Wyzwala się natychmiast po zmianie właściwości obiektu, z pewnymi
ograniczeniami.


Object

Obiekt jest klasą bazową dla wszystkich klas w hierarchii klas Roblox.


/reference/engine/classes/FeatureRestrictionManager.yaml

FeatureRestrictionManager

Podsumowanie

Właściwości

Metody

Zdarzenia

Właściwości

Metody

Zdarzenia

Na tej stronie