`PlayerGui` konteyneri, oyuncunun GUI'sini oluşturan nesneleri saklar. Eğer bir
`Class.ScreenGui`, `PlayerGui`'nin bir alt öğesi ise, o `Class.ScreenGui` içindeki
herhangi bir `Class.GuiObject`, oyuncunun ekranında görüntülenir. Herhangi bir
`Class.LocalScript`, `PlayerGui`'ye yerleştirildiğinde de çalışır.

Bir oyuncu deneyime ilk katıldığında, `PlayerGui`'si otomatik olarak
`Class.Player` nesnesine eklenir. Oyuncunun
`Class.Player.Character`'ı ilk kez doğduğunda, `Class.StarterGui`'nin tüm içeriği
otomatik olarak oyuncunun `PlayerGui`'sine kopyalanır. Eğer
`Class.StarterGui.ResetPlayerGuiOnSpawn` `true` olarak ayarlandıysa, oyuncunun
`PlayerGui`'sinin tüm içeriği temizlenir ve her seferinde oyuncunun karakteri
yeniden doğduğunda `Class.StarterGui`'nin içeriği ile değiştirilir.

Eğer `Class.Players.CharacterAutoLoads` `false` olarak ayarlandıysa,
karakter doğmayacak ve `Class.StarterGui` içeriği, `Class.Player:LoadCharacterAsync()` çağrılana kadar kopyalanmayacaktır.

Eğer bir oyuncunun UI konteynerini oyun sırasında kontrol etmeniz gerekiyorsa,
örneğin belirli bir `Class.ScreenGui`'yi veya onun çocuklarını göstermek/gizlemek için,
bunu bir `Class.LocalScript`'ten şu şekilde erişebilirsiniz:

Aşağıdaki örnek, üst çubuğun saydamlık değeri değiştiğinde onu yazdırır.


Üst çubuğun `Class.CoreGui` saydamlığı değiştiğinde,
`Class.PlayerGui:SetTopbarTransparency()` çağrısından sonra olduğu gibi,
her zaman tetiklenir. Olay, yeni saydamlığı `transparency` argümanı olarak geçirir,
`[0, 1]` aralığında bir değerdir. Sınırlandırılmış saydamlık, önceki değerden farklı olduğunda yalnızca tetiklenir,
bu nedenle aynı değeri tekrar ayarlamak olayı yeniden tetiklemez.


PlayerGui.TopbarTransparencyChangedSignal

transparency

Değişimden sonraki yeni üst çubuk saydamlığı, 0
(tamamen opak) ve 1 (tamamen saydam) arasında bir sayı.


Topbar CoreGui'nin şeffaflığı değiştiğinde tetiklenir.

Aşağıdaki kod satırı üst çubuğun saydamlığını yazdırır.


Üst çubuğun mevcut saydamlığını `Class.CoreGui` döndürür, bu değer
`[0, 1]` aralığında olup `0` tamamen opak ve `1` tamamen
saydamdır. Bu, daha önce
`Class.PlayerGui:SetTopbarTransparency()` ile atanan değerdir ve varsayılan olarak `0.5`'dir. Bu
metod yalnızca bir `Class.LocalScript`'ten çağrılabilir; bir
sunucu betiğinden çağrılması bir hata oluşturur.


PlayerGui:GetTopbarTransparency

Mevcut üst çubuk saydamlığı, 0 (tamamen opak) ve 1 (tamamen
saydam) arasında bir sayı.


Topbar'ın şeffaflığını döndürür.

Aşağıdaki kod satırı, Üst çubuğun tamamen opak görünmesini sağlar.


Bu kod örneği, özel stilize edilmiş bir üst çubuk oluşturmanın nasıl yapılacağını gösterir. Bunu `Class.LocalScript` içine yapıştırın ve `Class.StarterPlayerScripts` içinde yerleştirin.


Bu yöntem, üst çubuk `Class.CoreGui`'nun şeffaflığını ayarlar. `0`
değeri tamamen opaktır ve `1` değeri tamamen saydamdır.
`[0, 1]` aralığının dışındaki değerler sıkıştırılır. Üst çubuğun varsayılan
şeffaflığı `0.5`'dir.

`Class.StarterGui:SetCore()` yöntemini `"TopbarEnabled"`
seçeneği ile kullanmak, tüm üst çubuğu ve tüm özelliklerini (oyuncu listesi,
sağlık, vb.) etkinleştirmeyi/devre dışı bırakmayı sağlar. Bu yöntem ise
sadece üst çubuğun nasıl görüntülendiğini etkiler.

PlayerGui:SetTopbarTransparency

0 (tamamen opak) ve 1 (tamamen saydam) arasında bir sayı.
Bu aralığın dışındaki değerler sınırlandırılır.


Üst çubuğun şeffaflığını ayarlar.

PlayerGui

Oyuncunun mevcut ekran yönünü bir
`Enum.ScreenOrientation` değeri olarak tanımlar. Yazılabilir
`Class.PlayerGui.ScreenOrientation` özelliğinin aksine, bu özellik bir _tercih edilen_
yön modunu talep eder, `Class.PlayerGui.CurrentScreenOrientation` yalnızca okunabilir
ve cihazın gerçekten gösterdiği yönü raporlar, oyuncu bir mobil cihazı fiziksel olarak döndürdüğünde güncellenir.


PlayerGui.CurrentScreenOrientation

Oyuncunun mevcut ekran yönünü tanımlar.

Bu oyuncu için bir mobil cihazda tercih edilen ekran yön modunu ayarlar,
bir `Enum.ScreenOrientation` değeri olarak ifade edilir. Bunu değiştirmek,
cihazın belirli bir yöne kilitlenmesini veya o yöne uymasını talep eder (örneğin
`Enum.ScreenOrientation|Portrait` veya
`Enum.ScreenOrientation|LandscapeSensor`). Cihazın gerçekten gösterdiği yön,
`Class.PlayerGui.CurrentScreenOrientation` özelliği tarafından ayrı olarak rapor edilir. Bu özellik
varsayılan olarak `Enum.ScreenOrientation|LandscapeSensor`'dır.


PlayerGui.ScreenOrientation

Mobil bir cihazda, bu oyuncu için tercih edilen ekran yönü modunu ayarlar.

Oyun kumandaları için kullanılan varsayılan seçim süslemelerini geçersiz kılar. En iyi
sonuçlar için, bunun bir `Class.GuiObject`'e işaret etmesi gerekir.

PlayerGui.SelectionImageObject

Oyun kumandaları için kullanılan varsayılan seçim süslemelerini geçersiz kılar.

Bir oyuncunun UI'sını tutan bir konteyner.

`BasePlayerGui` tüm GUI çizim depolama sınıflarının
miras aldığı soyut bir sınıftır.

`Class.BasePlayerGui:GetGuiObjectsAtPosition()` tarafından döndürülen tüm GUIs
`highlightAsFrame()` yerel fonksiyonu tarafından 'kopyalanır', bu fonksiyon belirtilen
GUI'nin üstünde konumlandırılmış yarı saydam bir `Frame` GUI oluşturur ve aynı
`Class.GuiBase2d.AbsoluteSize` ve `Class.GuiBase2d.AbsolutePosition` değerlerine sahiptir.

Bu vurgular, oyuncunun PlayerGui klasöründeki Highlight klasöründeki
HighlightsContainer `ScreenGui`'sine eklenir. Her ikisi de kod örneği tarafından
oluşturulur. Tüm vurgulama GUIs, `highlightGui()` her çalıştığında
`Class.Instance:Destroy()` edilir.

HighlightContainer'ın `Class.ScreenGui.DisplayOrder` değeri 99999'dır, bu
büyük bir sayıdır, böylece başka bir GUI'nin vurgulama GUIs'nin üstünde
render edilmesi olası değildir.


Bir ekran pozisyonu alır ve o ekran pozisyonunu kaplayan tüm `Class.GuiObject`
örneklerinin bir listesini döner. Bu nesneler, ekranda üstten alta doğru
sıralanır ve ilk ve son indeks olarak görünürler. Ana kullanım durumu,
seçim veya vurgulama yapmak için oyuncunun fare veya dokunma girdi
nesneleri altındaki GUI nesnelerini almaktır.

`Class.BasePlayerGui` sınıfının çocuk sınıfları bu işlevi miras aldığından,
`sınıf.PlayerGui` ve `Class.StarterGui` gibi kapsayıcı sınıflar tarafından
çalıştırılabilir.

BasePlayerGui:GetGuiObjectsAtPosition

**X** pozisyonu, GUI içeriği uygulandıktan sonra ekranın sol üst köşesine\göre (bkz. `Class.GuiService:GetGuiInset()`).

**Y** pozisyonu, GUI içeriği uygulandıktan sonra ekranın sol üst köşesine
göre (bkz. `Class.GuiService:GetGuiInset()`).

Verilen ekran alanını işgal eden `Class.GuiObject` örneklerinin tablosu.

Verilen alanı işgal eden tüm `Class.GuiObject` örneklerinin bir listesini döner


BasePlayerGui

`BasePlayerGui` soyut bir sınıftır ve GUI çizim depolama sınıfları
bunu miras alır.

`Instance`, Roblox sınıf hiyerarşisindeki tüm sınıflar için temel sınıftır
`Class.DataModel` ağacının bir parçası olabilir.

Kök `Instance` nesneleri doğrudan oluşturulamaz, ancak özel
`Datatype.Instance.new()` yapıcı, sınıfın adını bir parametre olarak alarak ve oluşturulan nesneyi döndürerek nesneleri kod aracılığıyla oluşturur.


Bir nesnenin soy ağacındaki değişiklikleri algılamayı, `Class.Instance.AncestryChanged` olayıyla bağlanarak gösterir.

ChangingPart'in Parent'ı zamanla farklı değerlere ayarlanır. Parçanın ebeveyni, parçanın atasıdır, bu yüzden `Class.Instance.AncestryChanged` olayı değiştiğinde tetiklenecektir.

Bu örnek yeniden ebeveyn yapıldığında veya herhangi bir atasının
yeniden ebeveyn yapıldığında ateşlenir.

Bu olayı, Studio'da bir örneğin silinmesini takip etmek için kullanabilirsiniz,
örneğin Explorer'da manuel silme veya bir eklenti aracılığıyla. Eğer
`Class.Instance:Destroy()` kullanarak bir örneğin yok edildiğini tespit etmeniz
gerekiyorsa, bunun yerine `Class.Instance.Destroying` olayını kullanın.


Instance.AncestryChanged

child

Değişen `Class.Instance.Parent|Parent` özelliğine sahip örnek,
bu örnek veya daha uzak bir ata olabilir, **mutlaka** işleyiciye bağlı
olan örnek değildir.


parent

Bu nesnenin veya bir atasının `Class.Instance.Parent` özelliği değiştiğinde
ateşlenir.


Bu olay, örnekte herhangi bir özellik değiştiğinde, `nil` olarak ayarlandığında
ateşlenir. Değiştirilen özelliğin adı bağlı fonksiyona iletilir.

Örneğin, aşağıdaki kod parçası, bir parçanın özelliklerinden biri değiştiğinde
`attributeChanged()` fonksiyonunu ateşlemek için bağlanır:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "değişti")
end

part.AttributeChanged:Connect(attributeChanged)
```
Ayrıca `Class.Instance:GetAttributeChangedSignal()`'ı da inceleyin,
bu belirli bir özelliğin değiştiğinde ateşlenen bir olayı döndürür.


Instance.AttributeChanged

attribute

Bir `Class.Instance` üzerinde herhangi bir özellik değiştiğinde ateşlenir.


Bu kod parçası, nesneler Workspace'e eklendikçe isimlerini yazdırır:

Bu `Class.Instance`'e bir nesne eklendikten sonra ateşlenir.

Not, bu yöntemi istemcide sunucu tarafından oluşturulan nesneleri tespit etmek için
kullanırken, bu nesnelerin alt nesnelerini dizinlerken `Class.Instance:WaitForChild()`
metodunu kullanmak gereklidir. Çünkü nesne ve alt nesnelerinin sunucudan
istemciye aynı anda çoğaltılacağı garanti edilmez. Örneğin:

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

Workspace.ChildAdded:Connect(function(child)
	-- Alt nesnelerin henüz çoğaltılmamış olabileceğinden WaitForChild() kullanın
	local head = child:WaitForChild("Head")
end)
```
Not, bu olay yalnızca `Class.Instance`'in doğrudan çocukları için çalışır.
Tüm alt nesneleri yakalayan bir olay için `Class.Instance.DescendantAdded`'ı
kullanın.

Ayrıca `Class.Instance.ChildRemoved`'ı da inceleyin.


Instance.ChildAdded

Bu `Class.Instance`'e bir nesne eklendikten sonra ateşlenir.


Instance.childAdded

Bu kesit, nesnelerin Workspace'ten kaldırıldıkça isimlerini yazdırır:

Bu `Class.Instance`'den bir çocuk kaldırıldıktan sonra ateşlenir.

Kaldırılan, bir nesnenin ebeveyninin bu `Class.Instance`'den başka bir
şeye değiştiği anlamına gelir. Not, bu olay bir çocuğun yok edildiğinde de
( `Class.Instance:Destroy()` kullanarak) ateşlenecektir, çünkü yok etme
fonksiyonu bir nesnenin ebeveynini `nil` olarak ayarlar.

Bu olay yalnızca `Class.Instance`'in doğrudan çocukları için çalışır.
Tüm alt nesneleri yakalayan bir olay için `Class.Instance.DescendantRemoving`'i
kullanın.

Ayrıca `Class.Instance.ChildAdded`'ı da inceleyin.


Instance.ChildRemoved

Bu `Class.Instance`'den bir çocuk kaldırıldıktan sonra ateşlenir.


Aşağıdaki örnek, Workspace'e eklenen her nesnenin adını yazdıracaktır:

Bu olay, bir alt nesne bu `Class.Instance`'e eklendikten sonra ateşlenir.

Her alt nesne için ateşlendiğinden, bir nesneyi `Class.Instance`'e ebeveyn
olarak ayarlamak, bu nesne ve tüm alt nesneleri için bu olayı ayrı ayrı
ateşleyecektir.

Eğer yalnızca `Class.Instance`'in **doğrudan çocukları** ile ilgileniyorsanız,
`Class.Instance.ChildAdded`'ı kullanın.

Ayrıca `Class.Instance.DescendantRemoving`'i de inceleyin.


Instance.DescendantAdded

descendant

Bir alt nesne bu `Class.Instance`'e eklendikten sonra ateşlenir.


Aşağıdaki örnek, herhangi bir bebeğin adı Workspace'ten kaldırılırken yazdırılır:

Bu olay, ebeveyn `Class.Instance` değiştiğinde, böylece bir **alt nesne**
artık bir alt nesne olmayacak şekilde **hemen önce** ateşlenir. `Class.Instance:Destroy()|Destroy()`
bir nesnenin `Class.Instance.Parent|Parent` değerini `nil` olarak değiştirir,
bu nedenle ebeveynin bir alt nesnesi üzerinde bu yöntemi çağırmak, bu olayın
ateşlenmesine neden olacaktır.

Bu olay, alt nesnenin kaldırılmasından **önce** ateşlendiğinden, alt nesnenin
ebeveyni bu olay ateşlendiğinde değişmemiş olacaktır. Eğer alt nesne aynı zamanda
ebeveynin **doğrudan çocuğu** ise, bu olay `Class.Instance.ChildRemoved`'dan
önce ateşlenecektir.

Eğer bir alt nesnenin çocukları varsa, bu olay önce alt nesne ile,
bundan sonra alt nesneleri ile ateşlenir.

#### Uyarı

Bu olay, kaldırılan alt nesne nesnesi ile ateşlenir. Alt nesnenin
`Class.Instance.Parent|Parent` değerini başka bir şeye ayarlamaya çalışmak
başarısız olacaktır. Aşağıda bunu gösteren bir örnek bulunmaktadır:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Bu fonksiyonda alt nesnenin ebeveynini değiştirmeyin!
	-- Bu olay, ebeveyn değiştirildiği için ateşlenir ve değişiklik henüz gerçekleşmemiştir
	-- Bu nedenle, ebeveyni bu şekilde değiştirmek sorunludur:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Ayrıca `Class.Instance.DescendantAdded|DescendantAdded`'ı da inceleyin.


Instance.DescendantRemoving

Bir `Class.Instance`'in alt nesnesi kaldırılmadan hemen önce ateşlenir.


Bu örnek, Immediate sinyal davranışını kullanırken, bir
örneğin yok edildiğinde bağlı fonksiyonun beklemesine kadar yerinde kaldığını gösterir.

Bu örnek, Ertelenmiş sinyal davranışı kullanıldığında, bir Instance'ın
sinyal ateşlenmeden önce yok edildiğini göstermektedir.

Bağlı bir fonksiyon hala kullanıyorken `Class.Instance` asla bellekten silinmeyecektir.
Ancak, fonksiyon herhangi bir noktada beklerse, `Class.Instance` ve alt nesneleri
`nil`'e ebeveyn olarak ayarlanacaktır.

Eğer `Class.Workspace.SignalBehavior` özelliği `Enum.SignalBehavior.Immediate`
değerine ayarlandıysa, bu olay `Class.Instance` veya bir atasının
`Class.Instance:Destroy()` ile yok edilmeden hemen önce ateşlenir.

Eğer `Class.Workspace.SignalBehavior` özelliği `Enum.SignalBehavior.Deferred`
değerine ayarlandıysa, bu olay bir sonraki devam noktası olan,
`Class.Instance` veya bir atasının `Class.Instance:Destroy()` ile yok edilmesinden
sonra ateşlenecektir.

`Enum.SignalBehavior.Deferred|Deferred` davranışı ile, bir betiği kendi
`Class.Instance.Destroying` olayına bağlamak sorunludur, çünkü betik
geri çağırma çağrılmadan önce yok edilecektir (yani çalışmayacaktır).

Studio'da bir `Class.Instance`'i silerken, örneğin [Explorer](/studio/explorer)
üzerinden manuel silme veya bir eklenti aracılığıyla, `Class.Instance`
yok edilmez. Bunun yerine, ebeveyn `nil` olarak ayarlanır ve bunu
`Class.Instance.AncestryChanged` ile takip edebilirsiniz.


Instance.Destroying

`Class.Instance:Destroy()` aracılığıyla yok edilmeden hemen önce (veya
sonrasında ertelenmiş olarak) ateşlenir.


 `Class.Instance.StyledPropertiesChanged`'i gösterir.


Bu olay, örnekte herhangi bir stil özelliği değiştiğinde, bir özellik `nil`
olarak ayarlandığında da ateşlenir.


Instance.StyledPropertiesChanged

Örnekte herhangi bir stil özelliği değiştiğinde, bir özellik `nil`
olarak ayarlandığında da ateşlenir.


Bu yöntem, nesneye bir etiket uygular, etiket zaten uygulanmışsa etkisi yoktur. Başarıyla bir etiket eklemek, `Class.CollectionService:GetInstanceAddedSignal()` tarafından oluşturulan bir sinyali tetikler.

#### Uyarılar

- İstemci tarafında eklenen bir nesnenin etiketleri, sunucu daha sonra o nesneye bir etiket ekler veya kaldırırsa düşecektir çünkü sunucu tüm etiketleri birlikte çoğaltır ve önceki etiketleri üzerine yazar.

- Bir nesneyi etiketlerken, etiketin işlevselliğini sağlamak için bazı kaynakların kullanılması yaygındır, örneğin olay bağlantıları veya tablolar. Bellek sızıntılarını önlemek için, artık bir etiket için gerekli olmadığında bunları temizlemek iyi bir fikirdir (bağlantıyı kesmek, `nil` olarak ayarlamak vb.). Bunu `Class.Instance:RemoveTag()` çağrıldığında, `Class.Instance:Destroy()` çağrıldığında veya `Class.CollectionService:GetInstanceRemovedSignal()` tarafından döndürülen bir sinyale bağlı bir işlevde yapın.


Instance:AddTag

Çocuklar işlevi, nesnenin çocuklarının bir dizisini döner.


Instance:children

Nesnenin çocuklarının bir dizisini döner.


Bu yöntem, bir nesnenin tüm çocuklarını ve torunlarını yok eder.

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

-- Bazı parıltılar ekle
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())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Eğer **tüm** çocukları ve torunları yok etmek istemiyorsanız, `Class.Instance:GetChildren()` veya `Class.Instance:GetDescendants()` kullanarak o çocukları/torunları döngüye alıp neyi yok edeceğinizi seçin. Örneğin, aşağıdaki kod örneği, bir `Class.Model`'dan inen tüm `Class.BasePart|BaseParts`'ı yok edecektir:

```
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

Bu yöntem, bir nesnenin tüm çocuklarını yok eder.


Modeli `Class.Instance:Clone()` kullanarak klonlamayı gösterir.

`Clone()` bir nesnenin ve tüm torunlarının bir kopyasını oluşturur, `Class.Instance.Archivable|Archivable` olmayan tüm nesneleri göz ardı eder. Kök nesnenin kopyası bu yöntemle döner ve `Class.Instance.Parent|Parent` değeri `nil` olarak ayarlanır. Eğer nesnenin kendisi `Class.Instance.Archivable|Archivable` değeri `false` olarak ayarlanmışsa, bu yöntem `nil` döner.

Eğer `Class.ObjectValue.Value` gibi bir referans özelliği, kopyalanmış bir nesnede ayarlanırsa, kopyanın özelliğinin değeri orijinalin değerine bağlıdır:

- Eğer bir referans özelliği **aynı zamanda** kopyalanmış bir nesneye referans veriyorsa, kopya kopyaya referans verir.
- Eğer bir referans özelliği **kopyalanmamış** bir nesneye referans veriyorsa, kopyada aynı değer korunur.


Instance:Clone

Nesnenin bir kopyası veya nesne `Class.Instance.Archivable|Archivable` değilse `nil`.


Bir nesnenin ve tüm torunlarının bir kopyasını oluşturur, `Class.Instance.Archivable|Archivable` olmayan nesneleri göz ardı eder.


Instance:clone

Bir Parçayı `Class.Instance:Destroy()` fonksiyonunu kullanarak yok etmenin gösterimi.

Bu fonksiyon, artık gereksiz olan nesneleri imha etmenin doğru yoludur.

`Class.Instance.Parent` özelliğini `nil` olarak ayarlar, `Class.Instance.Parent` özelliğini kilitler, tüm bağlantıları keser ve tüm çocuklar üzerinde `Destroy()` çağrısı yapar. Bu yöntem, artık gerekli olmayan nesneleri atmanın doğru yoludur.

Gereksiz nesneleri atmak önemlidir, çünkü bir yerde gereksiz nesneler ve bağlantılar bellek kullanır ve zamanla ciddi performans sorunlarına yol açabilir.

Bir nesne üzerinde `Destroy()` çağrıldıktan sonra, o nesneye (veya torunlarına) referans veren herhangi bir değişkeni `nil` olarak ayarlamak en iyi uygulamadır. Bu, kodunuzun nesneyle ilgili herhangi bir şeye erişmesini engeller.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Bunu yapmayın:
print(part.Name)  --> "Hello, world"
-- Yukarıdaki satırın çalışmasını önlemek için bunu yapın:
part = nil
```
Bir `Class.Instance`, bu yöntemle yok edildikten sonra yeniden kullanılamaz çünkü `Class.Instance.Parent` özelliği kilitlenmiştir. Bir nesneyi yok etmek yerine **geçici olarak** kaldırmak için, `Class.Instance.Parent|Parent` değerini `nil` olarak ayarlayın. Örneğin:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Belirli bir süre sonra bir nesneyi yok etmek için `Class.Debris:AddItem()` kullanın.


Instance:Destroy

`Class.Instance.Parent` özelliğini `nil` olarak ayarlar, `Class.Instance.Parent` özelliğini kilitler, tüm bağlantıları keser ve tüm çocuklar üzerinde `Destroy()` çağrısı yapar.


Instance:destroy

`Class.Instance`'in `Class.Instance.Name`'inin verilen adla eşit olduğu ilk atasını döner.

Bu yöntem yukarı doğru çalışır, yani nesnenin hemen `Class.Instance.Parent`'ından başlar ve `Class.DataModel`'a doğru çalışır. Eğer eşleşen bir ata bulunamazsa, `nil` döner.

Aşağıdaki kod parçası, `Car` adındaki nesnenin ilk atasını bulacaktır.

```
local car = object:FindFirstAncestor("Car")
```
Belirli bir sınıfın atalarını bulan bu yöntemin varyantları için, `Class.Instance:FindFirstAncestorOfClass()` ve `Class.Instance:FindFirstAncestorWhichIsA()`'ya bakın.


Instance:FindFirstAncestor

name

`Class.Instance`'in `Class.Instance.Name`'inin verilen adla eşit olduğu ilk atasını döner.


`Class.Instance`'in `Class.Object.ClassName`'inin verilen className ile eşit olduğu ilk atasını döner.

Bu yöntem yukarı doğru çalışır, yani nesnenin hemen `Class.Instance.Parent`'ından başlar ve `Class.DataModel`'a doğru çalışır. Eğer eşleşen bir ata bulunamazsa, `nil` döner.

Bu yöntemin yaygın bir kullanımı, bir `Class.BasePart`'ın ait olduğu `Class.Model`'ı bulmaktır. Örneğin:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Bu yöntem, `Class.Instance:FindFirstAncestor()`'nın bir varyantıdır ve `Class.Object.ClassName` özelliğini kontrol eder, `Class.Instance.Name` yerine. `Class.Instance:FindFirstAncestorWhichIsA()` da mevcuttur, sınıf mirasını dikkate almak için `Class.Object:IsA()` yöntemini kullanır.


Instance:FindFirstAncestorOfClass

className

`Class.Instance`'in `Class.Object.ClassName`'inin verilen className ile eşit olduğu ilk atasını döner.


`Class.Instance`'in `Class.Object:IsA()`'sının verilen className için `true` döndüğü ilk atasını döner.

Bu yöntem yukarı doğru çalışır, yani nesnenin hemen `Class.Instance.Parent`'ından başlar ve `Class.DataModel`'a doğru çalışır. Eğer eşleşen bir ata bulunamazsa, `nil` döner.

`Class.Instance:FindFirstAncestorOfClass()`'dan farklı olarak, bu yöntem `Class.Object:IsA()` kullanır ve sınıf mirasını dikkate alır. Örneğin:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Bu nedenle, aşağıdaki kod örneği, ilk `Class.BasePart` atasını döndürecektir, ister `Class.WedgePart`, `Class.MeshPart` veya `Class.Part` olsun.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Ayrıca `Class.Instance:FindFirstAncestor()`'ya da bakın.


Instance:FindFirstAncestorWhichIsA

`Class.Instance`'in `Class.Object:IsA()`'sının verilen className için `true` döndüğü ilk atasını döner.


Aşağıdakiler, Workspace içinde "Brick" adlı bir nesne arayacaktır. Eğer bulunursa, bu
nesnenin adını "Foo" olarak değiştirecektir.

Verilen adla bulunan `Class.Instance`'in ilk çocuğunu döner veya böyle bir çocuk yoksa `nil` döner. İsteğe bağlı `recursive` argümanı `true` ise, bu yöntem yalnızca `Class.Instance`'in hemen çocukları yerine tüm torunları arar.

#### Bir Nesnenin Varlığını Kontrol Etme

`FindFirstChild()` bir nesnenin var olup olmadığını doğrulamak için gereklidir. Nokta operatörü kullanarak bir çocuğu adla indeksleme girişimi, çocuk yoksa bir hata fırlatır.

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

-- Aşağıdaki satır, parça workspace'de yoksa hata verir
Workspace.Part.Transparency = 0.5
```
Daha iyi bir yaklaşım, önce `Part`'ı kontrol etmek için `FindFirstChild()` kullanmak ve ardından ihtiyaç duyan kodu çalıştırmak için bir `if` ifadesi kullanmaktır.

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

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

#### Bir Özelliği Eşleşen Bir Çocuğu Bulma

Bazen bir nesnenin `Class.Instance.Name|Name`'i, `Class.Instance.Parent|Parent`'inin bir özelliğiyle aynı olabilir. Nokta operatörü kullanıldığında, özellikler aynı adı paylaşırlarsa çocuklardan önce gelir.

Aşağıdaki örnekte, `Color` adında bir `Class.Folder`, `Class.Part`'a eklenmiştir, bu da `Class.Part.Color` özelliğine sahiptir. Dikkat edin ki `part.Color`, çocuk `Class.Folder` örneği değil, `Datatype.Color3` özellik değerine atıfta bulunur. `Class.Instance:FindFirstChild()|FindFirstChild()` kullanmanın bir avantajı, yeni özelliklerin kodunuza risk getirmemesidir.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Özellik
local c2 = part:FindFirstChild("Color")  -- Çocuk klasörü
```

#### Performans Notları

`Class.Instance:FindFirstChild()|FindFirstChild()` kullanmak, nokta operatörü kullanmaktan yaklaşık %20 daha uzun sürer ve bir nesneye referans saklamaktan neredeyse 8 kat daha uzun sürer. Bu nedenle, sıkı döngüler veya `Class.RunService.Heartbeat` ve `Class.RunService.PreRender` ile bağlantılı işlevler gibi performansa bağlı kodda çağrılmaktan kaçınmalısınız. Bunun yerine, sonucu bir değişkende saklayın veya belirli bir adı olan bir çocuğun mevcut olup olmadığını tespit etmek için `Class.Instance.ChildAdded|ChildAdded` veya `Class.Instance:WaitForChild()|WaitForChild()` kullanmayı düşünün.


Instance:FindFirstChild

recursive

Aramanın özyinelemeli olarak yapılıp yapılmayacağı.


Verilen adla bulunan `Class.Instance`'in ilk çocuğunu döner.


Instance:findFirstChild

Verilen `Class.Object.ClassName|ClassName`'e eşit olan `Class.Instance`'in ilk çocuğunu döner. `Class.Instance:FindFirstChildWhichIsA()`'dan farklı olarak, bu yöntem yalnızca `className` ile eşleşen nesneleri döner, sınıf mirasını göz ardı eder. Eğer eşleşen bir çocuk bulunamazsa, bu yöntem `nil` döner.


Instance:FindFirstChildOfClass

Verilen `Class.Object.ClassName|ClassName`'e eşit olan `Class.Instance`'in ilk çocuğunu döner.


Verilen `Class.Object:IsA()`'sının `true` döndüğü `Class.Instance`'in ilk çocuğunu döner.

Eğer eşleşen bir çocuk bulunamazsa, bu yöntem `nil` döner. İsteğe bağlı `recursive` argümanı `true` ise, bu yöntem yalnızca `Class.Instance`'in hemen çocukları yerine tüm torunları arar.

`Class.Instance:FindFirstChildOfClass()`'dan farklı olarak, bu yöntem `Class.Object:IsA()` kullanır ve sınıf mirasını dikkate alır. Örneğin:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Bu nedenle, aşağıdaki kod örneği, ilk `Class.BasePart` çocuğunu döndürecektir, ister `Class.WedgePart`, `Class.MeshPart` veya `Class.Part` olsun.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Adla bir çocuğu arayan geliştiricilerin, bunun yerine `Class.Instance:FindFirstChild()` kullanmaları önerilir.


Instance:FindFirstChildWhichIsA

Verilen `Class.Object:IsA()`'sının `true` döndüğü `Class.Instance`'in ilk çocuğunu döner.


Verilen `Class.Instance.Name` ile bulunan ilk torunu döner.

Bu yöntem devre dışıdır ve kullanılamaz. Bir nesnenin ilk torununu bulmak için, bunun yerine `Class.Instance:FindFirstChild()` üzerinde `recursive` parametresini kullanmayı düşünün.


Instance:FindFirstDescendant

Verilen `Class.Instance.Name` ile bulunan ilk torunu döner.


`Class.Instance` bir `Class.Actor` ise, `Class.Actor` kendisi döner. Aksi takdirde, en yakın atası `Class.Actor` döner. Eğer hiçbir ata `Class.Actor` değilse, sonuç `nil` olur.


Instance:GetActor

`Instance` ile ilişkili `Class.Actor`'ı döner, varsa.


Bu yöntem, verilen özellik adına atanmış değeri döner. Eğer hiçbir özellik atanmadıysa, `nil` döner.

Örneğin, aşağıdaki kod parçası, nesnenin `InitialPosition` özelliğinin değerini ayarlar ve ardından alır:

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

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

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

#### Ayrıca Bakınız

- `Class.Instance:SetAttribute()` verilen adla verilen değeri ayarlayan bir yöntemdir.
- `Class.Instance:GetAttributes()` nesnenin her bir özelliği için anahtar-değer çiftlerini döner.


Instance:GetAttribute

Verilen özellik adına atanmış değer. Eğer hiçbir özellik atanmadıysa, `nil` döner.


Verilen özellik adında atanmış değeri döner.


Bu yöntem, `Class.Object.Changed|Changed` olayıyla aynı şekilde davranan bir olayı döner, ancak yalnızca belirli verilen özellik değiştiğinde tetiklenir; etkili bir şekilde, `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`'a benzer ancak özellikler için.

Genellikle, bu yöntemi, özellik adını kontrol eden bir işlevle `Class.Object.Changed|Changed`'e bağlantı kurmak yerine kullanmak iyi bir fikirdir. Bu yöntemi aynı nesne üzerinde aynı özellik adıyla ardışık çağrılar, aynı olayı döner.

Aşağıdaki kod örneği, parça `InitialPosition` özelliği değiştiğinde `attributeChanged()` işlevini tetikleyen bir sinyal döner:

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

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

local function attributeChanged()
	print("Attribute changed")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Ayrıca, nesne üzerinde herhangi bir özelliğin değiştiğinde tetiklenen `Class.Instance.AttributeChanged`'a da bakın.


Instance:GetAttributeChangedSignal

Değişiklik sinyalinin döneceği belirtilen özelliğin adı.


Verilen özelliğin değiştiğinde tetiklenen bir olay.


Verilen özelliğin değiştiğinde tetiklenen bir olayı döner.


Bu yöntem, anahtarın özelliğin adı ve değerin `nil` olmayan bir değer olduğu her özellik için anahtar-değer çiftlerini içeren bir sözlük döner.

Örneğin, aşağıdaki kod parçası, bir nesnenin özelliklerini ve değerlerini çıktılar:

```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
```
Ayrıca, verilen özellik adına atanmış değeri dönen `Class.Instance:GetAttribute()`'a da bakın.


Instance:GetAttributes

Her özelliğin adı ve `nil` olmayan bir değer için anahtar → varyant çiftlerinin bir sözlüğü.


Nesnenin özelliklerinin bir sözlüğünü döner.


Aşağıdakiler çalıştırıldığında Workspace'teki tüm nesnelerin adını yazdırır.

Nesnenin doğrudan çocuklarını içeren bir dizi (sayısal olarak indekslenmiş bir tablo) döner veya `Class.Instance`'in `Class.Instance.Parent|Parent`'inin nesneye eşit olduğu her nesneyi döner. Dizi, sayısal veya genel bir `for` döngüsü kullanılarak yineleyebilir:

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

-- Sayısal döngü örneği
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " is child number " .. i)
end
```

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

-- Genel döngü örneği
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " is child number " .. i)
end
```
Dikkat edin ki dönen dizi **belirli bir sırada** sıralanmamıştır, bu nedenle bu yöntemin döndürdüğü çocukları sıralamak için manuel sıralama (örneğin `Library.table.sort()` kullanarak) önerilir.

Ayrıca `Class.Instance:GetDescendants()|GetDescendants()` yöntemine de bakın.


Instance:GetChildren

Nesnenin çocuklarını içeren bir dizi.


Nesnenin tüm çocuklarını içeren bir dizi döner.


Instance:getChildren

Roblox tarafından dahili olarak kullanılan hata ayıklama kimliğinin kodlanmış bir dizesini döner. Dikkat edin ki:

- Bu öğe korumalıdır. `Class.Script` veya `Class.LocalScript` içinde kullanılmaya çalışılması bir hata oluşturur.
- Hata ayıklama kimliği, hata ayıklama süreçlerinde kullanılan bir kimliktir. Bir hata ayıklayıcının, bir uygulama işlemeden önce her talimatı okumasına olanak tanır. Roblox'taki tüm nesneler, gerektiğinde hata ayıklanabilen işlemler gibi davranır ve her çalıştırma talimatları (veya 'kod') içerir.
- Bu, benzer nesneleri birbirinden ayırması gereken eklentiler için yararlı olabilir (örneğin, aynı adı paylaşan nesneler).


Instance:GetDebugId

scopeLength

Roblox tarafından dahili olarak kullanılan hata ayıklama kimliğinin kodlanmış bir dizesini döner.


GetDescendants genellikle belirli bir tür objenin tüm soyundan gelenleri bir
şeyler yapmak için kullanılır. Bu örnekteki kod, GetDescendants ve
`Class.Instance:IsA()` kullanarak çalışma alanındaki tüm parçaları bulur ve
onları yeşil yapar.

Bu nesne yöntemi, o nesnenin tüm torunlarını içeren bir dizi döner. `Class.Instance:GetChildren()`'dan farklı olarak, bu yöntem yalnızca bir nesnenin doğrudan çocuklarını döndürmekle kalmaz, aynı zamanda o nesnenin her çocuğunu, o çocukların her çocuğunu ve daha fazlasını bulur.

Dikkat edin ki dönen dizi **belirli bir sırada** sıralanmamıştır, bu nedenle bu yöntemin döndürdüğü torunları sıralamak için manuel sıralama (örneğin `Library.table.sort()` kullanarak) önerilir. Ayrıca, belirli bir kombinasyon seçici ve kombinatorleri kullanarak torunları sorgulamak için `Class.Instance:QueryDescendants()|QueryDescendants()` yöntemini de düşünün.


Instance:GetDescendants

Nesnenin torunlarını içeren bir dizi.


Nesnenin tüm torunlarını içeren bir dizi döner.


Bu kod örneği, `Class.Instance:GetFullName()` fonksiyonunun davranışını göstermektedir.
Fonksiyonun `DataModel` hiyerarşisinde olmayan bir nesne üzerinde çağrıldığında nasıl davrandığını
ve dönüş değerinin özel karakterleri nasıl kaçırmadığını gösterir.

Bu kod örneği, `Class.Instance:GetFullName()` fonksiyonunu Lua'da yeniden uygular.


Nesnenin soyunu tanımlayan bir dize döner. Dize, nesnenin `Class.Instance.Name|Name`'i ve atalarının bir birleşimidir, noktalarla ayrılmıştır. `Class.DataModel` (`game`) dikkate alınmaz. Örneğin, `Class.Workspace` içindeki bir `Class.Part`, `Class.Workspace.Part` döndürebilir.

`Class.DataModel`'ın bir torunu olmayan bir `Class.Instance` üzerinde çağrıldığında, bu yöntem, `Class.Instance.Parent|Parent`'ı olmayan en üstteki ata dahil olmak üzere tüm ataları dikkate alır.

Bu yöntem, günlük kaydı ve hata ayıklama için yararlıdır. Döndürülen dizeyi herhangi bir yararlı işlem için ayrıştırmaya çalışmamalısınız; bu yöntem, nesne adlarındaki noktaları (veya diğer sembolleri) kaçırmaz. Diğer bir deyişle, çıktısı genellikle geçerli bir Luau tanımlayıcısı gibi görünse de, garanti edilmez.


Instance:GetFullName

Nesnenin soyunu tanımlayan bir dize döner.


 `Class.Instance:GetStyled()`'i gösterir.


Bu yöntem, belirtilen özelliğin stillendirilmiş veya açıkça değiştirilmiş değerini döner, aksi takdirde stillendirilmemiş/değiştirilmemişse varsayılan özellik değerini döner. Bu, doğrudan özellik değerine erişmekten biraz farklıdır, örneğin `[GuiObject].Rotation`, özelliğin varsayılan veya değiştirilmiş değerini döner.


Instance:GetStyled

selector

Nesne üzerinde hedeflediğiniz sahte nesne için isteğe bağlı seçici.


Belirtilen özelliğin stillendirilmiş veya açıkça değiştirilmiş değeri veya aksi takdirde stillendirilmemiş/değiştirilmemişse varsayılan özellik değeri.


Belirtilen özelliğin stillendirilmiş veya açıkça değiştirilmiş değerini döner, aksi takdirde stillendirilmemiş/değiştirilmemişse varsayılan özellik değerini döner.


Demonstrates `Class.Instance:GetStyledPropertyChangedSignal()`.


Bu yöntem, `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` olayıyla aynı şekilde davranan bir olayı döner, ancak yalnızca belirtilen stil özelliği değiştiğinde tetiklenir. Genellikle, bu yöntemi, özellik adını kontrol eden bir işlevle `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`'e bağlantı kurmak yerine kullanmak iyi bir fikirdir. Bu yöntemi aynı nesne üzerinde aynı özellik adıyla ardışık çağrılar, aynı olayı döner.

Dikkat edin ki bu olay, bağlı bir işleve herhangi bir argüman geçmeyecektir, bu nedenle değişen özelliğin değeri bir betik içinde doğrudan okunmalıdır.


Instance:GetStyledPropertyChangedSignal

property

Değişiklikleri dinlemek için stil özelliğinin adı.


Verilen stil özelliği değiştiğinde tetiklenen olay.


Nesne üzerindeki belirtilen stil özelliği değiştiğinde tetiklenen bir olayı döner.


Bu yöntem, verilen nesneye uygulanan etiketlerin bir dizisini döner, dizeler olarak. Etiketleri, Studio'da [Properties](/studio/properties) penceresinde veya çalışma zamanında `Class.Instance:AddTag()|AddTag()` ile ekleyebilirsiniz.

Bu yöntem, bir nesne üzerindeki birden fazla etiketle bir şey yapmak istediğinizde yararlıdır. Ancak, tek bir etiketin varlığını kontrol etmek için bu yöntemi kullanmak verimsizdir; bunun yerine, belirli bir etiketi kontrol etmek için `Class.Instance:HasTag()|HasTag()` kullanın.


Instance:GetTags

Nesneye uygulanan her bir etiketi temsil eden dizelerden oluşan bir dizi.


Nesneye uygulanan tüm etiketlerin bir dizisini alır.


Bu yöntem, sağlanan etiketin nesneye eklenip eklenmediğini kontrol eder. Etiketleri, Studio'da [Properties](/studio/properties) penceresinde veya çalışma zamanında `Class.Instance:AddTag()|AddTag()` ile ekleyebilirsiniz.


Instance:HasTag

Nesne belirtilen etikete sahipse `true`, aksi takdirde `false`.


Nesnenin belirli bir etikete sahip olup olmadığını kontrol eder.


Bir örneğin başka birinin atası olup olmadığını belirlemeyi gösterir
`Class.Instance:IsAncestorOf()`

Workspace ve SpawnLocation, SpawnLocation'un decal'inin ataıdır.
Workspace, SpawnLocation'un atasınıdır.

SpawnLocation ve decal'i, Workspace'in torunlarıdır, atası değildir.
Decal, SpawnLocation'un torunudur, atası değildir.

Verilen torunun bir atası olup olmadığını kontrol eder.

Bir `Class.Instance`, bir nesnenin `Class.Instance.Parent`'inin veya ebeveyninin `Class.Instance.Parent`'inin `Class.Instance`'ye ayarlandığı durumlarda nesnenin atası olarak kabul edilir.

Ayrıca, `Class.Instance:IsDescendantOf()`'a da bakın.


Instance:IsAncestorOf

Verilen torunun bir atası olup olmadığını kontrol eder.


Verilen atanın bir torunu olup olmadığını kontrol eder.

Dikkat edin ki `IsDescendantOf()` bir nesnenin kaldırılıp kaldırılmadığını kontrol etmek için `nil` parametresi ile kullanılamaz.

Ayrıca `Class.Instance:IsAncestorOf()`'a da bakın.


Instance:IsDescendantOf

ancestor

Verilen atanın bir torunu olup olmadığını kontrol eder.


Instance:isDescendantOf

Bu yöntem, belirli bir özelliğin kodla oluşturulan varsayılan değerden değiştirilip değiştirilmediğini gösterir. `Datatype.Instance.new()` aracılığıyla yeni oluşturulmuş bir nesne üzerinde çağrıldığında, bu yöntem `false` döner. Studio iş akışları gibi [Explorer](/studio/explorer) penceresi ekleme ile yeni oluşturulmuş bir nesne üzerinde çağrıldığında, sonuç farklı olabilir.

Örneğin, [Explorer](/studio/explorer) aracılığıyla eklenmiş bir `Class.TextLabel`'ın `Class.TextLabel.BackgroundColor3|BackgroundColor3` özelliğini sorgulamak `true` döner, ancak `Datatype.Instance.new()` aracılığıyla oluşturulmuş bir `Class.TextLabel`'ın aynı özelliğini sorgulamak `false` döner, başka bir değişiklik yapılmadığı varsayılarak.

Dikkat edin ki bu yöntem yalnızca hizmetler ve kullanıcı tarafından oluşturulabilen nesneler için yararlı sonuçlar döner. `Class.PackageLink` gibi sistem tarafından doldurulan nesnelerin özellikleri için döndürme değerleri tanımsız davranıştır.

Ayrıca, bu yöntem `true` dönerse, stil uygulaması **özelliği** etkilemeyecektir çünkü bir özelliği açıkça değiştirmek, stil uygulamaktan önce gelir. Bir özelliği kodla oluşturulan varsayılan değerine sıfırlamak ve stil uygulamasına izin vermek için `Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()` kullanın.


Instance:IsPropertyModified

Özelliğin kodla oluşturulan varsayılan değerinden değiştirilip değiştirilmediğini gösteren bir boolean.


Belirtilen özelliğin saklanan değeri, kodla oluşturulan varsayılan değere eşit değilse `true` döner.


Bu nesne yöntemi, sağlanan `selector` dizesine uyan nesnenin tüm torunlarını içeren bir dizi döner. `selector`, sınıf adı, nesne adı ve hiyerarşi ilişkileri gibi özellikleri eşleştirmek için birden fazla seçici ve kombinator içerebilir, ayrıca nesne özelliklerinin ve niteliklerinin belirli değerlerini de içerebilir. `selector` dilbilgisi, `Class.StyleRule`'da kullanılanla benzer, yalnızca desteklenen veya desteklenmeyen dilbilgisi parçalarıyla ilgili birkaç farklılık vardır.

#### Seçiciler

- `ClassName` — Belirtilen sınıfın `Class.Object:IsA()` ilişkisiyle eşleşen nesneleri eşleştirir.
- `.Tag` — `Class.CollectionService` etiketi ile etiketlenmiş nesneleri eşleştirir.
- `#Name` — Belirli bir `Class.Instance.Name`'e sahip nesneleri eşleştirir.
- `[property = value]` — Belirtilen özelliğe sahip olan ve o özelliğin belirtilen değere sahip olduğu nesneleri eşleştirir. Boolean, sayı ve dize değerleri desteklenir. Harfler, sayılar, `_` ve `-` değerleri tırnak işareti olmadan kullanılabilir.
- `[$attribute]` — Belirtilen [özelliğe](/studio/properties#instance-attributes) sahip olan nesneleri eşleştirir.
- `[$attribute = value]` — Belirtilen özelliğe sahip olan **ve** o özelliğin belirtilen değere sahip olduğu nesneleri eşleştirir. Özellik seçicileri için aynı sınırlamalar geçerlidir. Bir niteliğin yokluğunu kontrol etmek istiyorsanız, onu `nil` olarak sorgulamayın; bunun yerine `:not` sahte sınıfını kullanın, örneğin `:not([$attribute])`.

Seçiciler de birleştirilebilir. Örneğin, `Model.Apple[$Variety = Fuji][$Flavor = 4]`, `Apple` olarak etiketlenmiş bir `Class.Model` olan ve `Variety` niteliği `Fuji` değerine ve `Flavor` niteliği `4` değerine eşit olan nesneleri eşleştirecektir.

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

-- Tüm MeshPart torunlarını al
print(Workspace:QueryDescendants("MeshPart"))

-- "Fruit" olarak etiketlenmiş tüm torunları al
print(Workspace:QueryDescendants(".Fruit"))

-- "RedTree" adındaki tüm torunları al
print(Workspace:QueryDescendants("#RedTree"))

-- CanCollide özelliği false olarak ayarlanmış tüm torunları al
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- "FuelCapacity" niteliği atanmış tüm torunları al
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- "FuelCapacity" niteliği 75 olarak ayarlanmış tüm torunları al
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### Kombinatörler

Kombinatörler, daha derin hiyerarşi ilişkilerini eşleştirmek için temel seçicileri karıştırmanıza olanak tanır.

- `>` — Önceki filtre eşleşmelerinin **doğrudan çocukları** olan nesneleri eşleştirir.

- `>>` — Önceki filtre eşleşmelerinin **torunları** olan nesneleri eşleştirir. Bu, varsayılan ilk filtredir, yani `SpotLight.Red` ile `>> SpotLight.Red` aynı şeydir.

- `,` — Torun sorgusu için birden fazla bağımsız seçici listesi belirtir. Yalnızca filtreyi eşleştiren öğeler döndürülen dizide yer alır; sorgu listesinde eşleşmeyenler için `nil` dahil edilmeyecektir.

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

-- "SwordPart" olarak etiketlenmiş herhangi bir Model'in doğrudan çocuklarını al
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Bir Parça olan ve "Apple" olarak etiketlenmiş doğrudan çocukları al
print(Workspace:QueryDescendants("> Part.Apple"))

-- "OnFire" niteliği true olarak ayarlanmış herhangi bir Model'in torunlarını al
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- "SwordPart" olarak etiketlenmiş MeshPart torunlarını veya "OnFire" niteliği true olarak ayarlanmış olanları al
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### Sahte sınıf seçicileri

- `:not(complex-selector-list)` — Seçicilerin içindeki hiçbirine uymayan nesneleri seçmenize olanak tanır, etkili bir şekilde seçicilerin bir olumsuzluğunu gerçekleştirir. İçerideki ifade, karmaşık seçicilerin bir listesi olduğundan, birden fazla koşula göre filtreleme yapmak mümkündür.

- `:has(relative-selector-list)` — İçinde hangi nesnelerin bulunduğuna göre nesneleri seçmenize olanak tanır. Seçici listesi, her nesneye göre değerlendirilir.

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

-- SpotLight sınıfına ait olmayan tüm torunları al
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- SpotLight veya PointLight sınıfına ait olmayan tüm torunları al
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- "OnFire" niteliğine sahip olmayan tüm torunları al
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- "SwordPart" olarak etiketlenmiş bir Model'in çocukları hariç tüm torunları al
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Kendi torunu olarak bir Tool örneği içeren torunları al
print(Workspace:QueryDescendants(":has(Tool)"))
-- "SwordPart" olarak etiketlenmiş doğrudan çocuğa sahip olan MeshPart torunlarını al
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- SurfaceAppearance veya Texture sınıfına ait olmayan doğrudan çocuklara sahip olan MeshPart torunlarını al
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

Öğeleri filtrelemek için kullanılan seçici dizesi.


Bir dizi nesne (seçiciyle eşleşen hiçbir şey yoksa boş).


Belirtilen `selector` dizesine uyan nesnenin tüm torunlarını içeren bir dizi döner.


Aşağıdaki kod, bir parçanın kaldırıldıktan sonra DataModel'e nasıl yeniden eklenebileceğini göstermektedir:

Bu yöntem nesnenin `Class.Instance.Parent` değerini `nil` olarak ayarlar ve
bütün alt nesneleri için de aynı işlemi yapar.

Eğer nesne kaldırılmadan önce referans alındıysa, nesneyi daha sonra
geri almak mümkündür.


Instance:Remove

Nesnenin `Parent`'ını `nil` olarak ayarlar ve tüm torunları için de aynı işlemi yapar.


Instance

`Instance`, Roblox sınıf hiyerarşisindeki tüm sınıflar için temel sınıftır
`Class.DataModel` ağacının bir parçası olabilir.
