`UIGradient`, bir renk ve şeffaflık gradyanı `Class.GuiObject`'a uygular. Gradyanın görünümü, `Class.UIGradient.Color|Color`, `Class.UIGradient.Transparency|Transparency`, `Class.UIGradient.Offset|Offset`, `Class.UIGradient.Rotation|Rotation`, `Class.UIGradient.Scale|Scale`, `Class.UIGradient.TileMode|TileMode` ve `Class.UIGradient.Type|Type` aracılığıyla yapılandırılabilir.

`UIGradient`, çocuk veya torun `Class.GuiObject|GuiObjects`'a uygulanmaz. Birden fazla nesneye aynı gradyanı uygulamak için birden fazla gradyan örneğine ihtiyacınız olacaktır.

Daha fazla bilgi için `UIGradient` modifikatörü ve nasıl çalıştığı hakkında [görünüm modifikatörleri](/ui/appearance-modifiers#gradient) bölümüne bakın.

#### Desteklenen Nesneler

`UIGradient` modifikatörlerini `Class.Frame`, `Class.TextLabel`, `Class.TextButton`, `Class.ImageLabel`, `Class.ImageButton`, `Class.Path2D` ve `Class.ViewportFrame`'e uygulayabilirsiniz. Ancak, `Class.ScrollingFrame` ve `Class.TextBox` şu anda desteklenmemektedir.

#### Performans Dikkatleri

`UIGradient`'i verimli bir şekilde kullanmak için bu ilkelere uyun:

- `Class.UIGradient.Color|Color` dizisinde 6'dan fazla renk durakları kullanmaktan kaçının.

- Gradyanın bir metin stroke'u uygulayan herhangi bir nesneye (`Class.TextLabel.TextStrokeColor3|TextStrokeColor3`) uygulanmasından kaçının, çünkü gradyan stroke'lar ve kenarlarla karışmaya çalışacak ve performans sorunlarına neden olabilir.

- `Class.UIGradient.Color|Color` ve `Class.UIGradient.Transparency|Transparency`'yi sık sık ayarlamaktan kaçının: bu, renk dizisinin sık sık yeniden inşa edilmesine neden olur, bu da maliyetlidir. Mümkünse, bu özellikleri yalnızca bir kez ayarlayın ve benzer bir etki elde etmek için `Class.UIGradient.Offset|Offset` veya `Class.UIGradient.Rotation|Rotation` özelliklerini animasyonlayın. Alternatif olarak, `Class.GuiObject`'ın arka plan rengini `Class.GuiObject.BackgroundColor3|BackgroundColor3`, `Class.ImageLabel.ImageColor3|ImageColor3` veya `Class.TextLabel.TextColor3|TextColor3` gibi özelliklerle değiştirebilirsiniz.

- Durumu sık sık değişen bir UI öğesinde değişmeyen bir gradyan uygularken, bir `UIGradient` (işlem süresi) ve statik bir gradyan resmi (bellek) kullanma arasında bir denge vardır.


UIGradient

Bu özellik, sağlanan `Datatype.ColorSequence` boyunca ana `Class.GuiObject` ile karıştırılacak rengi tanımlar. Bu özellik, `Class.Beam.Color` veya `Class.Trail.Color` ile benzer bir şekilde çalışır, ancak `Class.UIGradient.Offset|Offset` ve `Class.UIGradient.Rotation|Rotation` tarafından belirlenen bir mesafe boyunca uygulanır.


UIGradient.Color

Gradyanın uzunluğu boyunca ana `Class.GuiObject` ile karıştırılan rengi belirler.


Gradient'in etkin olup olmadığını belirler.

UIGradient.Enabled

Bu özellik, gradyanın ana `Class.GuiObject`'un merkezinden olan ölçekli çevirisini belirler. Bu, gerçek piksel kaydırmasının ana `Class.GuiObject`'un `Class.GuiBase2d.AbsoluteSize|AbsoluteSize` ile belirlendiği anlamına gelir. Örneğin, `(1, 0)` değeri gradyanı ana nesnenin boyutuna eşit bir mesafe kadar sağa kaydırır. `Class.UIGradient.Rotation|Rotation`'a bağlı olarak, bu gradyanın kısmen görünür olmasına veya hiç görünmemesine neden olabilir.

Ayrıca, uygulanan gradyanın geometrisini etkileyen `Class.UIGradient.Rotation|Rotation`'a da bakın.


UIGradient.Offset

Gradyanın ana `Class.GuiObject`'un merkezinden olan ölçekli çevirisini belirler.


Bu özellik, `UIGradient`'in soldan sağa doğru derece cinsinden **saat yönünde** döndürülmesini belirler. Başlangıç ve bitiş kontrol noktaları ana `Class.GuiObject`'un kenarlarına yapışır, ancak sağlanan döndürmeyi korur.

Ayrıca, uygulanan gradyanın geometrisini etkileyen `Class.UIGradient.Offset|Offset`'a da bakın.


UIGradient.Rotation

Gradient'in soldan sağa doğru saat yönünde derece cinsinden döndürülmesini belirler.

Bu özellik, gradyanın kapsamını çarpar, ana `Class.GuiObject` içinde rengin/şeffaflık dizisinin ne kadar görünür olduğunu kontrol eder.

- `1` (varsayılan) değeri, tam dizinin elementi tam olarak bir kez kapsadığı anlamına gelir.

- `1`'den **küçük** değerler, gradyanı sıkıştırarak tam dizinin daha küçük bir alana sığmasını sağlar. Kalan alan, `Class.UIGradient.TileMode|TileMode` tarafından belirlenir. `Scale`'in, bozulmuş gradyanları önlemek için `0.001`'lik bir minimuma sıkıştırıldığını unutmayın.

- `1`'den **büyük** değerler, gradyanı element sınırlarının ötesine uzatarak dizinin yalnızca bir kısmının görünmesini sağlar.

`Scale`'in etkisi ayrıca gradyanın `Class.UIGradient.Type|Type`'ına bağlıdır:

- `Enum.GradientType.Linear` — `Scale`, başlangıç ve bitiş kontrol noktaları arasındaki mesafeyi etkiler.

- `Enum.GradientType.Radial` — `Scale`, radial gradyanın çapını etkiler.

- `Enum.GradientType.Conical` — `Scale`, açısal taramayı etkiler, böylece taramanın tam bir devri aşmaması sağlanır.

Ayrıca, `Scale`'in tüm elementi doldurmadığında gradyanın nasıl tekrarlandığını belirleyen `Class.UIGradient.TileMode|TileMode`'a da bakın.


UIGradient.Scale

Gradyanın kapsamını çarpar, rengin/şeffaflık dizisinin element içinde ne kadar görünür olduğunu kontrol eder.


Bu özellik, gradyan `Class.UIGradient.Scale|Scale`'in `1`'den küçük olduğu veya `Class.UIGradient.Offset|Offset` gradyanı kaydırarak elementi tam olarak kaplamadığı durumlarda ne olacağını belirler. Olası değerler ve etkileri için `Enum.GradientTileMode`'a bakın.

Ayrıca, rengin/şeffaflık dizisinin ne kadar görünür olduğunu kontrol eden `Class.UIGradient.Scale|Scale`'e de bakın.


UIGradient.TileMode

Gradyanın nasıl tekrarlandığını belirler.


Bu özellik, sağlanan `Datatype.NumberSequence` boyunca ana UI öğesinin ne kadar opak olacağını tanımlar. Bu özellik, `Class.Beam.Transparency` veya `Class.Trail.Transparency` ile benzer bir şekilde çalışır, ancak `Class.UIGradient.Offset|Offset` ve `Class.UIGradient.Rotation|Rotation` tarafından belirlenen bir mesafe boyunca uygulanır.

`Datatype.NumberSequenceKeypoint|NumberSequenceKeypoints`'in zarf değerlerinin göz ardı edildiğini unutmayın.


UIGradient.Transparency

Gradyanın uzunluğu boyunca ana `Class.GuiObject`'un ne kadar görülebileceğini belirler.


Bu özellik, gradyanın ana `Class.GuiObject` boyunca nasıl değiştiğini belirler. Olası değerler ve etkileri için `Enum.GradientType`'e bakın.

Ayrıca, rengin/şeffaflık dizisinin ne kadar görünür olduğunu kontrol eden `Class.UIGradient.Scale|Scale`'e ve tekrar davranışını belirleyen `Class.UIGradient.TileMode|TileMode`'a da bakın.


UIGradient.Type

Gradyanın şeklinin lineer, radial veya konik olduğunu belirler.


Bir renk ve şeffaflık gradyanı `Class.GuiObject`'a uygular.


UI kısıtlamaları ve düzen sınıfları için bir temel sınıf; `Class.UIBase`'den miras alır.


UIComponent

UI kısıtlamaları ve düzen sınıfları için bir temel sınıf.


`Class.UIBase`, UI düzeni ve kısıtlama sınıfları için temel sınıftır.


UIBase

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

Bu olayı, bir örneğin Studio'da silinmesini takip etmek için kullanabilirsiniz,
örneğin Explorer'da manuel silme veya bir eklenti aracılığıyla. Eğer bir
örneğin `Class.Instance:Destroy()` kullanılarak 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, **bağlayıcının bağlı olduğu**
örnek olmayabilir.


parent

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


Bu olay, örnekte herhangi bir özellik değiştiğinde tetiklenir,
özellikle bir özellik `nil` olarak ayarlandığında. 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 tetikler:

```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 tetiklenen bir olayı döndürür.


Instance.AttributeChanged

attribute

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


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

Bu `Class.Instance`'e bir nesne eklendikten sonra tetiklenir.

Not, bu yöntemi istemcide sunucu tarafından oluşturulan nesneleri tespit etmek için
kullanırken, bu nesnelerin alt nesnelerini indekslerken `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 tetiklenir.


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

Kaldırma, bir nesnenin ebeveyninin bu `Class.Instance`'den başka bir
şeye değiştirilmesi anlamına gelir. Not, bu olay bir çocuğun yok edildiğinde
(`Class.Instance:Destroy()` kullanılarak) de tetiklenecektir, çü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 tetiklenir.


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

Her alt nesne için tetiklendiğinden, bir nesneyi `Class.Instance`'e ebeveyn
yapmak, bu nesne ve tüm alt nesneleri için olayı ayrı ayrı tetikler.

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


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

Bu olay, ebeveyn `Class.Instance`'in değiştiği **hemen önce** tetiklenir,
böylece bir **alt nesne** artık bir alt nesne olmayacaktır. `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 metodu çağırmak, bu olayın tetiklenmesine
neden olacaktır.

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

Eğer bir alt nesnenin çocukları varsa, bu olay önce alt nesne ile,
sonra onun alt nesneleri ile tetiklenir.

#### Uyarı

Bu olay, kaldırılan alt nesne ile tetiklenir. Alt nesnenin `Class.Instance.Parent|Parent`
özelliğini 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 tetiklenir 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 tetiklenir.


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 bekletilirse, `Class.Instance` ve alt nesneleri
`nil`'e ebeveyn yapılacaktır.

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

Eğer `Class.Workspace.SignalBehavior` özelliği `Enum.SignalBehavior.Deferred`\olarak ayarlandıysa, bu olay bir sonraki devam noktasında tetiklenecektir,
bu da `Class.Instance` veya bir atasının `Class.Instance:Destroy()` ile yok edilmesinden
sonra olacaktır.

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


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


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


Instance.StyledPropertiesChanged

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


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

- Bir nesnenin istemci tarafında eklenen 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, etiket için artık 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öndürür.


Instance:children

Nesnenin çocuklarının bir dizisini döndürür.


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 alabilir ve yok etmek istediğinizi seçebilirsiniz. Örneğin, aşağıdaki kod örneği, bir `Class.Model`'den 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 atıfta bulunuyorsa, kopya kopyaya atıfta bulunur.
- Eğer bir referans özelliği **kopyalanmamış** bir nesneye atıfta bulunuyorsa, 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 önler.

```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.Name`'i verilen adla eşit olan `Class.Instance`'nin ilk atasını döndürür.

Bu yöntem yukarı doğru çalışır, yani nesnenin hemen `Class.Instance.Parent`'ından başlayarak `Class.DataModel`'e 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.Name`'i verilen adla eşit olan `Class.Instance`'nin ilk atasını döndürür.


`Class.Instance`'nin ilk atasını döndürür, `Class.Object.ClassName`'i verilen className ile eşit olan.

Bu yöntem yukarı doğru çalışır, yani nesnenin hemen `Class.Instance.Parent`'ından başlayarak `Class.DataModel`'e 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 vardır, sınıf mirasını dikkate almak için `Class.Object:IsA()` yöntemini kullanır.


Instance:FindFirstAncestorOfClass

className

`Class.Instance`'nin ilk atasını döndürür, `Class.Object.ClassName`'i verilen className ile eşit olan.


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

Bu yöntem yukarı doğru çalışır, yani nesnenin hemen `Class.Instance.Parent`'ından başlayarak `Class.DataModel`'e 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`'nin ilk atasını döndürür, `Class.Object:IsA()` verilen className için `true` 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`'nin ilk çocuğunu döndürür 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`'nin 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 indekslemeye çalışmak, ç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`'ın bir özelliği ile 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 tanıtımının 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 bir çocuğun belirli bir adla mevcut olduğunda algılamak için `Class.Instance.ChildAdded|ChildAdded` veya `Class.Instance:WaitForChild()|WaitForChild()` kullanmayı düşünün.


Instance:FindFirstChild

recursive

Aramanın özyinelemeli olarak gerçekleştirilip gerçekleştirilmeyeceği.


Verilen adla bulunan `Class.Instance`'nin ilk çocuğunu döndürür.


Instance:findFirstChild

Verilen `className` ile eşit olan `Class.Instance`'nin ilk çocuğunu döndürür. `Class.Instance:FindFirstChildWhichIsA()`'dan farklı olarak, bu yöntem yalnızca `className` ile eşleşen nesneleri döndürür, 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 sınıf adıyla eşit olan `Class.Instance`'nin ilk çocuğunu döndürür.


Verilen sınıf adı için `Class.Object:IsA()` `true` dönen `Class.Instance`'nin ilk çocuğunu döndürür.

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`'nin 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 sınıf adı için `Class.Object:IsA()` `true` dönen `Class.Instance`'nin ilk çocuğunu döndürür.


Verilen `Class.Instance.Name` ile bulunan ilk torunu döndürür.

Bu yöntem devre dışı bırakılmıştı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öndürür.


Eğer `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

`Class.Instance` ile ilişkili `Class.Actor`'ı döndürür, varsa.


Bu yöntem, verilen özellik adında atanmış değeri döndürür. 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 özelliği verilen değere ayarlar.
- `Class.Instance:GetAttributes()` nesnenin her bir özelliği için anahtar-değer çiftlerini döndürür.


Instance:GetAttribute

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


Verilen özellik adında atanmış değeri döndürür.


Bu yöntem, `Class.Object.Changed|Changed` olayıyla aynı şekilde davranan bir olayı döndürür, ancak yalnızca belirli verilen özellik değiştiğinde tetiklenir; etkili olarak, `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` bağlantısı yerine kullanmak iyi bir fikirdir. Bu yöntemi aynı nesne üzerinde aynı özellik adıyla ardışık çağrılar, aynı olayı döndürür.

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

```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öndürüleceği belirtilen özelliğin adı.


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


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


Bu yöntem, her bir özelliğin adı anahtar ve değeri `nil` olmayan değerler için anahtar-değer çiftlerini içeren bir sözlük döndürür.

Ö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ında atanmış değeri döndüren `Class.Instance:GetAttribute()`'a da bakın.


Instance:GetAttributes

Her bir özelliğin adı ve değeri için bir sözlük.


Nesnenin özelliklerinin bir sözlüğünü döndürür.


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öndürür veya `Class.Instance`'nin `Class.Instance.Parent|Parent` değeri nesneye eşit olan her `Class.Instance`'yi döndürür. Dizi, sayısal veya genel bir `for` döngüsü kullanılarak yinelemeye tabi tutulabilir:

```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öndürülen dizi **belirli bir sırada** sıralanmamıştır, bu nedenle manuel sıralama (örneğin `Library.table.sort()` kullanarak) bu yöntemin döndürdüğü çocukları sıralamak için ö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öndürür.


Instance:getChildren

Roblox tarafından dahili olarak kullanılan hata ayıklama kimliğinin kodlanmış bir dizesini döndürür. 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öndürür.


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öndürür. `Class.Instance:GetChildren()`'den 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öndürülen dizi **belirli bir sırada** sıralanmamıştır, bu nedenle manuel sıralama (örneğin `Library.table.sort()` kullanarak) bu yöntemin döndürdüğü torunları sıralamak için önerilir. Ayrıca, belirli bir kombinasyon seçici ve kombinatorler ile 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öndürür.


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öndürür. 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`'in 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öndürür.


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


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


Instance:GetStyled

selector

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


Belirtilen özelliğin stilize edilmiş veya açıkça değiştirilmiş değeri, aksi takdirde stilize edilmemiş/değiştirilmemiş varsayılan özellik değeri.


Belirtilen özelliğin stilize edilmiş veya açıkça değiştirilmiş değerini döndürür, aksi takdirde stilize edilmemiş/değiştirilmemiş varsayılan özellik değerini döndürür.


Demonstrates `Class.Instance:GetStyledPropertyChangedSignal()`.


Bu yöntem, `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` olayıyla aynı şekilde davranan bir olayı döndürür, 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` bağlantısı yerine kullanmak iyi bir fikirdir. Bu yöntemi aynı nesne üzerinde aynı özellik adıyla ardışık çağrılar, aynı olayı döndürür.

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öndürür.


Bu yöntem, verilen nesneye uygulanan etiketlerin bir dizisini döndürür, 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 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 atası olup olmadığını kontrol eder.

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

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


Instance:IsAncestorOf

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


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

Dikkat edin ki `IsDescendantOf()` `nil` parametresi ile kullanılamaz, bu nedenle bir nesnenin kaldırılıp kaldırılmadığını kontrol edemezsiniz.

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


Instance:IsDescendantOf

ancestor

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


Instance:isDescendantOf

Bu yöntem, belirli bir özelliğin kodla oluşturulmuş 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 eklenmiş bir nesne üzerinde çağrıldığında, sonuç farklı olabilir.

Örneğin, [Explorer](/studio/explorer) penceresi 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şturulabilir nesneler için yararlı sonuçlar döndürür. `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 etkilemez** çünkü bir özelliği açıkça değiştirmek, stil uygulamaktan önce gelir. Bir özelliği kodla oluşturulmuş 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şturulmuş varsayılan değerinden değiştirilip değiştirilmediğini gösteren boolean.


Belirtilen özelliğin saklanan değeri, kodla oluşturulmuş 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öndürür. `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ç fark 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` olan ve `Flavor` niteliği `4` 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`, `>> SpotLight.Red` ile aynıdır.

- `,` — 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 edilmez.

```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)` — Hiçbir seçicinin içindeki seçicilerle **eşleşmeyen** nesneleri seçmenize olanak tanır, etkili olarak seçicilerin bir olumsuzluğunu gerçekleştirir. İçindeki ifade bir karmaşık seçici 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öndürür.


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:remove

Bu yöntem bir örnekten bir etiketi kaldırır. Nesne etiket yoksa bir hata
vermez. Başarıyla bir etiketi kaldırmak, `Class.CollectionService:GetInstanceRemovedSignal()`
metodu tarafından oluşturulan bir sinyali, verilen etiket ile tetikler.

Bir örneği 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, etiket için artık gerekli olmadıklarında bunları temizlemek iyi bir
fikir olacaktır (bağlantıyı kesmek, `nil` olarak ayarlamak vb.).


Instance:RemoveTag

Bir özelliği varsayılan değerine sıfırlar. Örneğin,
`ResetPropertyToDefault("Rotation")` çağrısı, `Class.TextLabel` üzerinde,
`Class.TextLabel.Rotation|Rotation` değerini `0` (özelliğin varsayılan değeri)
olarak ayarlamakla eşdeğerdir. Bu yöntem, stilin bu özelliğin varsayılan değerini
geçersiz kılmasını sağlamak için kullanılabilir.


Instance:ResetPropertyToDefault

Bir özelliği varsayılan değerine sıfırlar.


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.


/reference/engine/classes/UIGradient.yaml

Özet