`Class.GuiBase2d`, 2D `Class.GuiObject|GuiObjects` tarafından miras alınan bir soyut sınıftır.


Bu olay, gamepad seçimi bağlı `Class.GuiBase2d` veya herhangi bir alt `Class.GuiObject|GuiObjects` içinde hareket ettiğinde, ayrıldığında veya değiştiğinde tetiklenir. Seçim vurgusu bir `Class.GuiObject`'a geçtiğinde, olay o `Class.GuiObject`'dan tüm atalarına doğru yükselir ve onlara seçimin değiştiğini/girdiğini/çıktığını bildirir.


GuiBase2d.SelectionChanged

amISelected

Yeni seçim, bağlı GuiBase2d ile eşleşiyorsa doğru.


previousSelection

newSelection

Gamepad seçimi, bağlı `Class.GuiBase2d` veya herhangi bir alt `Class.GuiObject|GuiObjects` içinde hareket ettiğinde, ayrıldığında veya değiştiğinde tetiklenir.


GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition`, bir `Class.GuiBase2d` öğesinin ekran konumunu piksel cinsinden sağlayan, yalnızca okunabilir bir özelliktir. Bu, bir öğenin, atalarının boyutları ve konumları sonucunda render edildiği gerçek piksel konumunu temsil eder. `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` her zaman `Class.GuiBase2d` öğesinin sol üst köşesini temsil eder.

Eğer `Class.GuiBase2d`, bir `Class.ScreenGui` içindeyse, `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` özelliği `Enum.ScreenInsets|CoreUISafeInsets` görüntüleme koordinat sistemini kullanır. Bu koordinat sisteminin kökeni, Roblox üst çubuğunun sol alt köşesinde yer almaktadır. Bu, `Class.InputObject.Position` özelliği tarafından kullanılan aynı koordinat sistemidir.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="AbsolutePosition koordinat sisteminin kökenini gösteren diyagram." />

Ayrıca `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` ve `Class.GuiBase2d.AbsoluteSize|AbsoluteSize`'a bakın.


GuiBase2d.AbsolutePosition

Bir `Class.GuiBase2d` öğesinin gerçek ekran konumunu, piksel cinsinden tanımlar.


`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`, bir `Class.GuiBase2d` öğesinin gerçek ekran rotasını derece cinsinden tanımlayan, yalnızca okunabilir bir özelliktir. Sınır kontrolü yapmaz, bu nedenle değeri `0` ile `360` aralığında olmayabilir.

Ayrıca `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` ve `Class.GuiBase2d.AbsoluteSize|AbsoluteSize`'a bakın.


GuiBase2d.AbsoluteRotation

Bir `Class.GuiBase2d` öğesinin gerçek ekran rotasını, derece cinsinden tanımlar.


`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`, bir `Class.GuiBase2d` öğesinin gerçek ekran boyutunu piksel cinsinden tanımlayan, yalnızca okunabilir bir özelliktir.

Ayrıca `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` ve `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`'a bakın.


GuiBase2d.AbsoluteSize

Bir `Class.GuiBase2d` öğesinin gerçek ekran boyutunu, piksel cinsinden tanımlar.


`true` olarak ayarlandığında, bu `Class.GuiBase2d` ve onun alt öğelerine yerelleştirme uygulanır. Yerelleştirme için kullanılan girişler, `Class.LocalizationService:GetTableEntries()` tarafından döndürülen aynı giriş setidir. `Class.GuiBase2d.AutoLocalize|AutoLocalize` etkin olan girişler, bulut tablosu yüklendikten sonra otomatik olarak yeniden çevrilecektir.

Ayrıca `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`'a bakın.


GuiBase2d.AutoLocalize

`true` olarak ayarlandığında, bu `Class.GuiBase2d` ve onun alt öğelerine yerelleştirme uygulanır.


Bu özellik, bir yerelleştirme tablosunun `Class.LocalizationTable.Root` bu nesneyi veya bu nesnenin bir atasını hedeflediğinde otomatik olarak `true` olarak ayarlanır. `Class.LocalizationTable|LocalizationTables`'in `Class.LocalizationTable.Root` özelliği bir örneğe işaret ettiğinde, kök örneğin alt öğeleri olan tüm `Class.TextLabel.TextButton` öğeleri yerelleştirilecektir.


GuiBase2d.Localize

Bir yerelleştirme tablosunun `Class.LocalizationTable.Root` bu nesneyi veya bu nesnenin bir atasını hedeflediğinde otomatik olarak `true` olarak ayarlanır.


Bu `Class.GuiBase2d` ve onun alt öğelerine otomatik yerelleştirme uygulamak için kullanılacak bir `Class.LocalizationTable` referansı. `Class.GuiBase2d.AutoLocalize|AutoLocalize` özelliği, otomatik yerelleştirmenin uygulanabilmesi için `true` olarak ayarlanmalıdır.

Bunu, `Class.DataModel` içinde herhangi bir yerde bir `Class.LocalizationTable` referansına ayarlayabilirsiniz. `Class.GuiBase2d` nesnesi ve tüm çocukları, otomatik metin değiştirme için önce o belirli `Class.LocalizationTable` ve onun atalarını kullanmaya çalışacak, ardından `Class.LocalizationService` altındaki tabloları belirsiz bir sırayla ve bulut tablosunu kullanacaktır.

Referans alınan tabloda çeviri yoksa, o tablonun ebeveyninde, eğer o da bir `Class.LocalizationTable` ise, çeviri arayacaktır ve bu şekilde devam edecektir.

Ayrıca, otomatik yerelleştirme için `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`'ın nasıl kullanıldığını açıklayan `Class.LocalizationService:GetTableEntries()`'a bakın.


GuiBase2d.RootLocalizationTable

Bu `Class.GuiBase2d` ve onun alt öğelerine otomatik yerelleştirme uygulamak için kullanılacak bir `Class.LocalizationTable` referansı.


Gamepad seçim davranışını aşağı yönde özelleştirir.


GuiBase2d.SelectionBehaviorDown

Gamepad seçim davranışını sola yönde özelleştirir.


GuiBase2d.SelectionBehaviorLeft

Gamepad seçim davranışını sağa yönde özelleştirir.


GuiBase2d.SelectionBehaviorRight

Gamepad seçim davranışını yukarı yönde özelleştirir.


GuiBase2d.SelectionBehaviorUp

Gamepad seçim hareketinin, seçim grubunun alt öğeleri arasında nasıl hareket edebileceğini, gruptan nasıl çıkabileceğini ve diğer düğmeleri nasıl seçeceğini özelleştirmeye izin verir.

`Class.GuiBase2d.SelectionGroup|SelectionGroup`'u `true` olarak ayarlamak, `Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`, `Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`, `Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft` ve `Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight` özelliklerini açığa çıkarır. Bu seçim davranışları için, `Enum.SelectionBehavior.Escape` (varsayılan) ayarı, gamepad seçiminin önce seçim grubunda bir seçim bulmaya çalıştığı ve uygun bir düğme bulamazsa dışarıya hareket ettiği anlamına gelir. Alternatif olarak, `Enum.SelectionBehavior.Stop` ayarı, gamepad seçiminin yalnızca seçim grubunun içinde arama yaptığı ve seçim davranışı yönünden grubun dışına çıkmadığı anlamına gelir.


GuiBase2d.SelectionGroup

Gamepad seçim hareketinin özelleştirilmesine izin verir.


2D `Class.GuiObject|GuiObjects` tarafından miras alınan bir soyut sınıf.


GuiBase, çoğu grafik kullanıcı arayüzü nesnesinin miras aldığı soyut bir sınıftır.


GuiBase

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


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.
