Diyalog nesnesi, oyuncuların bir seçim listesi kullanarak konuşabileceği, oyuncu olmayan karakterler (NPC'ler) oluşturmasına olanak tanır. Diyalog nesnesi bir parçaya, örneğin bir İnsan formunun kafasına yerleştirilebilir ve ardından bir oyuncu, bir konuşmaya başlamak için tıklayabileceği bir konuşma balonunu görecektir. Bir yerin yaratıcısı, oyuncunun ne söyleyebileceğini, diyaloğa `Class.DialogChoice` nesneleri ekleyerek seçebilir.

Bir oyuncu, bir `Class.Dialog` örneği aracılığıyla söylemek için bir şey seçtiğinde tetiklenir.

Bu olay yalnızca istemci tarafındadır ve sunucuda tetiklenmeyecektir. Ya `Class.LocalScript` ya da bir `Class.LocalScript` tarafından gereksinim duyulan bir `Class.ModuleScript` içinde bağlanmalıdır.

Dialog.DialogChoiceSelected

player

dialogChoice

Oyuncu tarafından seçilen `Class.DialogChoice`.


Bir oyuncu, bir `Class.Dialog` örneği aracılığıyla söylemek için bir şey seçtiğinde tetiklenir.

Bir Diyalogun GetCurrentPlayers fonksiyonu, şu anda Diyalog kullanan `Class.Player` nesnelerinin bir listesini döndürecektir. Eğer diyalogu kullanan oyuncu yoksa, döndürülen liste boş olacaktır.

Dialog:GetCurrentPlayers

`Class.Player` nesnelerinin bir listesi, şu anda Diyalogda yer alan.


Şu anda Diyalog kullanan oyuncuların bir listesini döndürür.

Dialog

 `Class.Dialog.BehaviorType`'ı gösterir.


Bir Dialog'un BehaviorType'ı, birden fazla oyuncunun aynı anda bir dialog ile etkileşimde bulunup bulunamayacağını belirler. Bu özelliğin varsayılan değeri SinglePlayer'dır.

#### SinglePlayer

Bir Dialog SinglePlayer olarak yapılandırıldığında, yalnızca bir oyuncu aynı anda onunla etkileşimde bulunabilir. Bir oyuncu bir dialog ile etkileşime girdiği anda, diğer oyuncular ilk oyuncu bitene kadar dialogu başlatamazlar.

Bir oyuncu bir dialog ile etkileşimdeyken, diğer oyuncular dialogu başlatan oyuncunun dialog seçimlerini ve yanıtlarını göreceklerdir.

#### MultiplePlayers

Bir Dialog MultiplePlayers olarak ayarlandığında, herhangi bir oyuncu istediği zaman bir dialog başlatabilir, başka bir oyuncu zaten dialogu başlatmış olsa bile. Ancak SinglePlayer'dan farklı olarak, MultiplePlayers olarak ayarlanan Dialoglar, konuşmadaki oyuncu dışında kimseye dialog seçimlerini ve yanıtlarını göstermez.

Dialog.BehaviorType

Diyalogun aynı anda birden fazla oyuncu tarafından kullanılıp kullanılamayacağını ayarlar.

Oyuncunun karakteri ile Dialog'un ana `Class.BasePart`'ı arasındaki maksimum mesafe. Oyuncu, konuşmayı başlatmak veya devam ettirmek için konuşma balonuna tıklayabilir. Oyuncu, ana parçadan daha uzak bir mesafeye hareket ederse, diyalog başlatamaz. Motor, birden fazla diyalog aralığında olduğunda en yakın mevcut Dialog'u seçmek için bu değeri kullanır.

Varsayılan 25'tir.


Dialog.ConversationDistance

Bir oyuncunun diyalogun ebeveyninden ne kadar uzakta olabileceğinin en uzak mesafesi, bir konuşma başlatmak için.

Hoşça kal seçeneğinin görüntülenip görüntülenmeyeceğini açıp kapatır. Eğer doğruysa, diyalog diğer diyalog seçeneklerinden sonra son seçenek olarak `Class.Dialog.GoodbyeDialog` içeriğini gösterecektir. Hoşça kal seçeneğine tıklamak diyalogdan çıkacaktır.

Dialog.GoodbyeChoiceActive

Hoşça kal seçeneğinin görüntülenip görüntülenmeyeceğini açıp kapatır.

Diyalog seçimleri listesinin altında görünen veda seçeneği olarak gösterilen metin. `Class.Dialog.GoodbyeChoiceActive` true olduğunda, bu dize son seçilebilir seçenek olarak görünür; tıklanması konuşmayı sonlandırır. `Class.Dialog.GoodbyeChoiceActive` false olduğunda, bu özelliğin görünür bir etkisi yoktur.

Varsayılan boş bir dizedir.


Dialog.GoodbyeDialog

Diyalogun sohbet sona erdiğinde oyuncuya göstereceği cümleyi ayarlar.

Bir oyuncu konuşmaya ilk başladığında NPC'nin konuşma balonunda gösterdiği metin. Bu, oyuncunun bu Dialog'un altında yer alan `Class.DialogChoice` seçeneklerinden birini seçmeden önce görünen açılış satırıdır.

Varsayılan boş bir dizedir.


Dialog.InitialPrompt

Oyuncuya, bir sohbet başlatıldığında gösterilecek olan ilk cümleyi ayarlar.

Bu diyalog konuşmasına şu anda en az bir oyuncunun katıldığı her zaman true olan yalnızca okunabilir bir çalışma zamanı göstergesidir. Motor, bir oyuncu konuşmaya başladığında bunu true olarak ayarlar ve tüm katılımcılar ayrıldığında false olarak sıfırlar. Bu özellik serileştirilmez ve yer yüklenirken her zaman false olarak başlar. Betikler bu özelliği okuyabilir ancak doğrudan ayarlayamaz.

Varsayılan false'tur.


Dialog.InUse

Eğer doğruysa, bu diyalog en az bir oyuncu tarafından kullanılmaktadır.

Diyalogun konuşma balonu göstergesinde hangi simgenin görüneceğini kontrol eder. `Enum.DialogPurpose` enum'undan bir değer alır:

- **Görev** -- bir ünlem işareti (!) gösterir
- **Yardım** -- bir soru işareti (?) gösterir
- **Dükkan** -- bir dolar işareti ($) gösterir

Varsayılan Yardım'dır.


Dialog.Purpose

İlk diyalogun görüntüleyeceği simgeyi ayarlar.

Diyalogun konuşma balonundaki renk vurgusunu kontrol eder. `Enum.DialogTone` enum'undan bir değer alır:

- **Nötr** -- mavi vurgulu çubuk
- **Dostça** -- yeşil vurgulu çubuk
- **Düşman** -- kırmızı vurgulu çubuk

Varsayılan Nötr'dür.


Dialog.Tone

NPC'nin konuşma balonunun rengini ayarlar.

Diyalogun ana `Class.BasePart`'ından maksimum mesafe. Bu mesafede, diyalogun tetikleyici göstergesi bir oyuncuya görünür hale gelir. Bir oyuncunun karakteri bu mesafede olduğunda, konuşma balonu simgesi ana parçanın üzerinde görünür ve etkileşim davet eder. Değer 0 ile 400 arasında sınırlıdır.

Varsayılan 0'dır, bu da mesafeye dayalı tetikleyici göstergesini etkili bir şekilde devre dışı bırakır; oyuncunun diyalogu görmek ve etkileşimde bulunmak için `Class.Dialog.ConversationDistance` içinde olması gerekir.


Dialog.TriggerDistance

Bir diyaloğun tetiklenebileceği maksimum mesafeyi ayarlar.

Diyalogun konuşma balonu göstergesinin konumunu, Dialog'un ana `Class.BasePart`'ına göre kaydıran bir `Datatype.Vector3` ofseti. Bu, göstergenin NPC'nin üzerinde veya yanında konumlandırılması için kullanılır, parçanın merkezinde değil. Bu özellik model ölçeklendirmesine katılır.

Varsayılan (0, 0, 0)'dır.


Dialog.TriggerOffset

Diyalogun ebeveynine göre ofseti ayarlar.

NPC reklam tarzı diyalog baloncukları oluşturur.

`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

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.
