`Class.BillboardGui`, UI nesnelerinin 3D alanda görünmesini sağlamak için bir konteynerdir ancak her zaman kameraya bakar. Konteynerin konumu, ana `Class.BasePart` veya `Class.Attachment` (ya da `Class.BillboardGui.Adornee|Adornee`) ile ilgilidir. `Class.BasePart|BaseParts` için `Class.BasePart.Position|Position` özelliği kullanılırken, `Class.Attachment|Attachments` için `Class.Attachment.WorldPosition|WorldPosition` özelliği kullanılmaktadır.

<img src="/assets/ui/in-experience/BillboardGui-Diagram.jpg" width="800" alt=" üzerine yüzen ekran konsolunu tanımlayan bir TextLabel ile birlikte BillboardGui." />

Bir billboard'un `Class.BillboardGui.Size|Size` özelliği, `Class.GuiObject.Size` özelliğinden biraz farklı çalışır. **offset** bileşenleri aynı şekilde çalışırken, **scale** bileşenleri 3D alandaki stud boyutları olarak kullanılır.

`Class.BillboardGui`'da bir `Class.TextLabel` içeren boyut ölçekli bir şey oluşturduğunuzda, etiketin `Class.TextLabel.TextScaled|TextScaled` özelliğini etkinleştirmek yararlıdır, böylece metni, kamera mesafesi değiştikçe billboard tuvali ile birlikte ölçeklenir.

`Class.BillboardGui` içinde `Class.ImageButton|ImageButtons` ve `Class.TextButton|TextButtons` gibi etkileşimli UI bileşenlerinin yalnızca `Class.PlayerGui`'ya bağlı olmaları durumunda kullanıcı girdisi alacağını unutmayın, genellikle `Class.BillboardGui`'yı `Class.StarterGui` içine yerleştirerek. `Class.BillboardGui.Adornee|Adornee` özelliği, 3D dünyadaki bir parçayı veya bağlantıyı hedeflemek için kullanılabilirken, `Class.BillboardGui` kendisi `Class.PlayerGui`'da kalmaktadır.

`Class.BillboardGui` konteynerleri ile çalışmak için [In-Experience UI](/ui/in-experience-containers#billboard-ui) kılavuzuna bakın.

##### Önbellekleme Davranışı

Performansı artırmak için, bir `Class.BillboardGui` görünümü aşağıdaki durumlardan biri gerçekleşene kadar önbelleğe alınır, sonrasında görünümü bir sonraki render çerçevesinde yeniden hesaplanacaktır.

- `Class.BillboardGui`'ya bir alt öğe eklenir veya çıkarılır.
- `Class.BillboardGui`'nın bir alt öğesinin bir özelliği değişir.
- `Class.BillboardGui`'nın kendisinin bir özelliği değişir.


BillboardGui

Alt öğelerin giriş olaylarını alıp almayacağını kontrol eder. Eğer `Class.BillboardGui` bir `Class.GuiButton` içeriyorsa, o düğme yalnızca `Class.BillboardGui.Active|Active` 'nın hem `Class.BillboardGui`'da hem de düğmede `true` olarak ayarlanması durumunda tıklanabilir olacaktır.

`Class.BillboardGui` içinde bulunan `Class.ImageButton|ImageButtons` ve `Class.TextButton|TextButtons` gibi etkileşimli UI bileşenlerinin yalnızca `Class.PlayerGui`'ya bağlı olmaları durumunda kullanıcı girdisi alacaklarını unutmayın, genellikle `Class.BillboardGui`'yı `Class.StarterGui` içine yerleştirerek. `Class.BillboardGui.Adornee|Adornee` özelliği, `Class.Workspace` içindeki bir `Class.BasePart` veya `Class.Attachment`'a `Class.BillboardGui`'yı eklemekte kullanılabilir.


BillboardGui.Active

Alt öğelerin giriş olaylarını alıp almayacağını kontrol eder.


`Class.BillboardGui`'nın konumlandığı `Class.BasePart` veya `Class.Attachment`'ı ayarlar, ana parça veya bağlantıyı geçersiz kılar.


BillboardGui.Adornee

`Class.BillboardGui`'nın konumlandığı hedef parça veya bağlantıyı ayarlar.


Bu özellik, `Class.BillboardGui`'nın her zaman diğer 3D nesnelerin üstünde render edilip edilmeyeceğini belirler.

`false` (varsayılan) olarak ayarlandığında, `Class.BillboardGui`, diğer 3D içerikle aynı şekilde render edilir ve diğer 3D nesneler tarafından örtülür. `true` olarak ayarlandığında, `Class.BillboardGui` her zaman 3D içeriğin üstünde render edilir ve görünüm önemli ölçüde değişir:

- Renkler `Class.ScreenGui` içinde nasıl göründükleriyle eşleşir.
- Metin, yüksek DPI cihazlarında daha keskin görünebilir.
- `Class.BillboardGui.LightInfluence|LightInfluence` sanki `0`'dır.
- `Class.BillboardGui.Brightness|Brightness` hiç etkisi yoktur.


BillboardGui.AlwaysOnTop

`Class.BillboardGui`'nın diğer 3D nesnelerin üstünde her zaman render edilip edilmeyeceğini belirler.


Bu özellik, `Class.BillboardGui` konteynerinin ışığının `Class.BillboardGui.LightInfluence|LightInfluence` `0` olduğunda ne ölçüde ölçeklendiğini belirler. Varsayılan olarak bu özellik `1`'dir ve `0` ile `1000` arasında herhangi bir sayıya ayarlanabilir. Bu özelliği değiştirerek, `Class.BillboardGui`'nın görünür parlaklığı çevresiyle daha iyi eşleştirilebilir. Örneğin, bir video billboard, `Class.BillboardGui.Brightness|Brightness`'ı `10` yaparak karanlık bir odada aydınlatılabilir.

`Class.BillboardGui.Brightness|Brightness`'ın Studio'da kullanılamaz olduğunu ve ya `Class.BillboardGui.LightInfluence|LightInfluence` `1`'dir ya da `Class.BillboardGui.AlwaysOnTop|AlwaysOnTop` `true` olduğunda herhangi bir etkisi olmadığını unutmayın.


BillboardGui.Brightness

`Class.BillboardGui` konteynerinin ışığının ne ölçüde ölçeklendiğini belirler.


Bu `true` (varsayılan) olarak ayarlandığında, `Class.BillboardGui` tuvali sınırlarının dışına düşen `Class.GuiObject|GuiObjects` kısımları çizilmeyecektir.

Bu özellik `false` olsa bile, tuvalin **tamamen** dışında kalan `Class.GuiObject|GuiObjects` render edilmez.


BillboardGui.ClipsDescendants

`Class.GuiObject|GuiObjects`'un `Class.BillboardGui` tuvali sınırlarının dışına düşen kısımlarının çizilip çizilmeyeceğini belirler.


`Class.BillboardGui`'nın oyuncunun kameradan kaç stud uzakta olduğunu gösterir. Bu özellik için değişiklik olayı tetiklenmez, `Class.BillboardGui.DistanceStep|DistanceStep` `0`'dan fazla olmadığı sürece.


BillboardGui.CurrentDistance

`Class.BillboardGui`'nın oyuncunun kameradan kaç stud uzakta olduğunu gösterir.


`Class.BillboardGui`'nın oyuncunun mevcut kamerasına göre daha büyük boyut ölçeğini durduracağı stud mesafesini belirler. Varsayılan değeri `0`'dır. Eğer `Class.BillboardGui.CurrentDistance|CurrentDistance`'ı bu değerin altındaysa, bu mesafedeki büyüklüğünden daha büyük bir ölçeğe ulaşamayacaktır.


BillboardGui.DistanceLowerLimit

`Class.BillboardGui`'nın daha büyük boyut ölçeğini durduracağı stud mesafesini belirler.


Oyuncunun kamerası `Class.BillboardGui`'ya daha yakın ve daha uzak hareket ettikçe `Class.BillboardGui.CurrentDistance|CurrentDistance`'ın büyüklüğünü belirler. Özellik varsayılan olarak `0`'dır.


BillboardGui.DistanceStep

Oyuncunun kamerası `Class.BillboardGui`'ya daha yakın ve daha uzak hareket ettikçe `Class.BillboardGui.CurrentDistance|CurrentDistance`'ın büyüklüğünü belirler.


`Class.BillboardGui`'nın oyuncunun mevcut kamerasına göre daha küçük boyut ölçeğini durduracağı stud mesafesini belirler. Eğer `Class.BillboardGui.CurrentDistance|CurrentDistance` bu değerin üzerindeyse, bu mesafedeki küçüklüğünden daha küçük bir ölçeğe ulaşamayacaktır.

Bu özellik değeri `0`'dan daha azsa dikkate alınmaz. Varsayılan değer `-1`'dir; yani özellik varsayılan olarak görmezden gelinir.


BillboardGui.DistanceUpperLimit

`Class.BillboardGui`'nın daha küçük boyut ölçeğini durduracağı stud mesafesini belirler.


Bu özellik, `Class.BillboardGui`'nın `Class.BillboardGui.Adornee|Adornee`'dan, `Class.Camera` yönelimine göre nasıl kaydırılacağını belirler, modelin `Class.Camera`'ya göre hizalanmış sınırlayıcı kutusunun boyutlarının yarısı kadar birim cinsinden.

Ayrıca `Class.BillboardGui.StudsOffset|StudsOffset` ile de ilgilidir; bu benzer çalışır ancak stud birimlerini kullanır, veya `Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` ile de ilgilidir; bu benzer çalışır fakat kaydırma yönelimi global eksenelere göredir.


BillboardGui.ExtentsOffset

`Class.BillboardGui`'nın `Class.BillboardGui.Adornee|Adornee`'dan, `Class.Camera` yönelimine göre nasıl kaydırılacağını belirler, modelin `Class.Camera`'ya göre hizalanmış sınırlayıcı kutusunun boyutlarının yarısı kadar birim cinsinden.


Bu özellik, `Class.BillboardGui`'nın `Class.BillboardGui.Adornee|Adornee`'dan, global eksenelere göre nasıl kaydırılacağını belirler, modelin eksen hizalı sınırlayıcı kutusunun boyutlarının yarısı kadar birim cinsinden.

Ayrıca `Class.BillboardGui.StudsOffset|StudsOffset` ile de ilgilidir; bu benzer çalışır ancak stud birimlerini kullanır, veya `Class.BillboardGui.ExtentsOffset|ExtentsOffset` ile de ilgilidir; bu benzer çalışır fakat kaydırma yönelimi `Class.Camera`'ya göredir.


BillboardGui.ExtentsOffsetWorldSpace

`Class.BillboardGui`'nın `Class.BillboardGui.Adornee|Adornee`'dan, global eksenelere göre nasıl kaydırılacağını belirler, modelin eksen hizalı sınırlayıcı kutusunun boyutlarının yarısı kadar birim cinsinden.


`Class.BillboardGui`'nın çevresel aydınlatmadan ne kadar etkileneceğini kontrol eder, `0` ile `1` arasında bir aralıkta. Bu değeri `1` olarak ayarlamak çevredeki aydınlatmanın görünüm üzerinde tam kontrol sahibi olacağı anlamına gelirken, `0` olarak ayarlamak aydınlatmanın hiçbir etkisi olmayacağı anlamına gelir.


BillboardGui.LightInfluence

`Class.BillboardGui`'nın çevresel aydınlatmadan ne kadar etkileneceğini kontrol eder.


Bu özellik, `Class.BillboardGui`'nın render durmadan önce kameradan ne kadar uzakta olacağını kontrol eder. `0` veya `inf` (varsayılan) değeri sınırsız anlamına gelir ve sonsuz derecede uzakta render edilecektir.

Açık havada görünen `Class.BillboardGui|BillboardGuis` için, `Class.BillboardGui.MaxDistance|MaxDistance`'nin yeterince yüksek olması tavsiye edilir; böylece konteynerin UI'si göründüğünde veya kaybolduğunda ekranda yeterince küçük olacaktır, ani pop-in/out etkisini minimize edecektir.


BillboardGui.MaxDistance

`Class.BillboardGui`'nın görüntülenebileceği en uzak mesafeyi kontrol eder.


Belirli bir oyuncudan `Class.BillboardGui`'yı gizlemek için betikler tarafından kullanılır.

Birden fazla oyuncudan `Class.BillboardGui`'yı gizlemek için, `Class.StarterGui` içine yerleştirin ve `Class.Players.LocalPlayer|LocalPlayer`'ın bunu görüp görmeyeceğine göre `Class.BillboardGui.Enabled|Enabled` özelliğini ayarlamak için bir betik kullanın.  `Class.BillboardGui.Adornee|Adornee` özelliği, `Class.Workspace`'daki bir `Class.BasePart` veya `Class.Attachment`'a `Class.BillboardGui`'yı bağlamak için kullanılabilir, böylece ebeveynleme ihtiyacı kalmaz.


BillboardGui.PlayerToHideFrom

Belirli bir oyuncudan `Class.BillboardGui`'yı gizlemek için betikler tarafından kullanılır.


`Class.BillboardGui`'nın ekranda ne boyut alacağını kontrol eder. `Class.GuiObject.Size`'dan farklı olarak, bu özelliğin [ölçek](/ui/position-and-size#size) bileşenleri billboard'un 3D alandaki stud boyutunu ayarlar.


BillboardGui.Size

`Class.BillboardGui`'nın ekranda ne boyut alacağını kontrol eder.


Bir referans noktası gibi hareket eden boyutla ilgili bir 2D kaydırma. Bu, `Class.GuiObject.AnchorPoint` özelliği ile benzer şekilde kullanılabilir, ancak değerler farklıdır.

<table size="small">
<thead>
<th>Boyut Kaydırması</th>
<th>Açıklama</th>
</thead>
<tbody>
<tr>
<td><code>0, 0</code></td>
<td>UI'nin merkezinde sabitleneceği varsayılandır.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>UI sol alt kısımda sabitlenecektir.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>UI üst sol kısımda sabitlenecektir.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>UI üst sağ kısımda sabitlenecektir.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>UI alt sağ kısımda sabitlenecektir.</td>
</tr>
</tbody>
</table>

Ayrıca `Class.BillboardGui.StudsOffset|StudsOffset`, `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`, `Class.BillboardGui.ExtentsOffset|ExtentsOffset`, ve `Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` ile de ilgilidir; bunlar 3D alanda çalışan kaydırma özellikleridir.


BillboardGui.SizeOffset

Bir referans noktası gibi hareket eden boyutla ilgili bir 2D kaydırma.


Bu özellik, `Class.BillboardGui`'nın `Class.BillboardGui.Adornee|Adornee`'den stud'larda nasıl kaydırılacağını, `Class.Camera` yönelimine göre belirler.

Ayrıca `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace` ile de ilgilidir; bu benzer çalışır ancak kaydırma yönelimi global eksenelere göredir.


BillboardGui.StudsOffset

`Class.BillboardGui`'nın `Class.BillboardGui.Adornee|Adornee`'den stud'larda, `Class.Camera` yönelimine göre nasıl kaydırılacağını belirler.


Bu özellik, `Class.BillboardGui`'nın `Class.BillboardGui.Adornee|Adornee`'den stud'larda, global eksenelere göre nasıl kaydırılacağını belirler.

Ayrıca `Class.BillboardGui.StudsOffset|StudsOffset` ile de ilgilidir; bu benzer çalışır ancak kaydırma yönelimi `Class.Camera`'ya göredir.


BillboardGui.StudsOffsetWorldSpace

`Class.BillboardGui`'nın `Class.BillboardGui.Adornee|Adornee`'den stud'larda, global eksenelere göre nasıl kaydırılacağını belirler.


Kameraya bakan 3D alanında render edilen `Class.GuiObject|GuiObjects` için bir konteyner.


**LayerCollector** `Class.GuiObject` alt sınıflarını render eden 2D UI konteynerlerinin temel sınıfıdır, örneğin `Class.ScreenGui`.

Performans iyileştirmeleri için, bir `Class.LayerCollector`'ın görünümü aşağıdaki olaylardan biri gerçekleşene kadar önbelleğe alınır:

- Bir alt nesne buna eklenir veya bunun içinden kaldırılır.
- Bir alt nesnenin bir özelliği değişir.
- `Class.LayerCollector`'ın kendisinin bir özelliği değişir.

LayerCollector:GetLayoutNodeTree

LayerCollector

Bu `Class.LayerCollector`'ın görünürlüğünü açıp kapatır. `false` olduğunda, UI içeriği render edilmez, kullanıcı girişi işlenmez ve değişikliklere yanıt olarak güncellenmez.

LayerCollector.Enabled

Bu `Class.LayerCollector`'ın görünürlüğünü açıp kapatır.

`false` olarak ayarlandığında ve bu `Class.LayerCollector` `Class.StarterGui`'nin doğrudan çocuğuysa, her oyuncunun `Class.PlayerGui`'sine yalnızca bir kez kopyalanır ve oyuncunun karakteri yeniden doğduğunda silinmez.

`true` (varsayılan) olarak ayarlandığında veya bu `Class.LayerCollector` bir **dolaylı** `Class.StarterGui` alt nesnesiyse, her oyuncunun karakteri yeniden doğduğunda her oyuncunun `Class.PlayerGui`'sine kopyalanır ve oyuncunun karakteri yeniden doğduğunda kendini siler.

LayerCollector.ResetOnSpawn

Oyuncunun karakteri her yeniden doğduğunda `Class.LayerCollector`'ın sıfırlanıp sıfırlanmayacağını (kendini silip oyuncunun `Class.PlayerGui`'sine yeniden kopyalanmasını) belirler.

`Class.GuiObject.ZIndex` değerinin bu `Class.LayerCollector`'ın tüm alt nesnelerinde nasıl davranacağını kontrol eder.

`Enum.ZIndexBehavior.Sibling` (varsayılan) ile, çocuklar her zaman ebeveynlerinin üzerinde gelir ve `Class.GuiObject.ZIndex|ZIndex` değeri, tek bir UI nesnesinin çocuklarının hangi sırayla birbirinin üzerinde render edileceğini belirlemek için kullanılır.

`Enum.ZIndexBehavior.Global`, tüm alt nesneleri `Class.GuiObject.ZIndex|ZIndex` değerine göre sıralar ve ardından bağları hiyerarşi sırasına göre kırar. Sonuç olarak, bir `Class.GuiObject`'in alt nesneleri, ebeveynleriyle aynı yükseklikte veya daha yüksek bir `Class.GuiObject.ZIndex|ZIndex` değerine sahip olmalıdır, aksi takdirde ebeveynlerinin altında render olurlar.


LayerCollector.ZIndexBehavior

`Class.GuiObject.ZIndex` değerinin bu `Class.LayerCollector`'ın tüm alt nesnelerinde nasıl davranacağını kontrol eder.


2D UI konteynerlerinin temel sınıfı, `Class.GuiObject|GuiObjects`'u katmanlar halinde render eder.

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


Bu olay, gamepad seçiminin 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`'tan tüm atalarına doğru yönelir ve onlara seçimin bir `Class.GuiObject` içindeki değiştiğini/girdiğini/çıktığını bildirir.


GuiBase2d.SelectionChanged

amISelected

Yeni seçim mevcut GuiBase2d ile eşleşiyorsa true'dur.


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 salt okunur bir özelliktir. Bu, bir öğenin, atalarının boyutları ve konumları sonucunda nerede yer aldığını 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ünüm koordinat sistemi kullanır. Bu koordinat sisteminin başlangıcı Roblox üst çubuğunun sol alt köşesine yerleştirilmiştir. 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 başlangıcını gösteren diyagram." />

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


GuiBase2d.AbsolutePosition

`Class.GuiBase2d` öğesinin gerçek ekran konumunu, piksel cinsinden açıklar.


`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`, bir `Class.GuiBase2d` öğesinin gerçek ekran dönüşünü derece cinsinden tanımlayan salt okunur bir özelliktir. **Sınır kontrolü** yapmadığı için, değeri `0` ile `360` arasındaki değerlerde olmayabilir.

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


GuiBase2d.AbsoluteRotation

`Class.GuiBase2d` öğesinin gerçek ekran dönümünü, derece cinsinden açıklar.


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

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


GuiBase2d.AbsoluteSize

`Class.GuiBase2d` öğesinin gerçek ekran boyutunu, piksel cinsinden açıklar.


`true` olarak ayarlandığında, lokalizasyon bu `Class.GuiBase2d` ve onun alt öğelerine uygulanacaktır. Lokalizasyon için kullanılan girişler, `Class.LocalizationService:GetTableEntries()` tarafından döndürülen aynı set girişleridir. `Class.GuiBase2d.AutoLocalize|AutoLocalize` etkin olan girişlerin bulut tablosu yüklendiğinde gerekirse otomatik olarak yeniden çevrilecektir.

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


GuiBase2d.AutoLocalize

`true` olarak ayarlandığında, lokalizasyon bu `Class.GuiBase2d` ve onun alt öğelerine uygulanacaktır.


Bu özellik, bir lokalizasyon tablosunun `Class.LocalizationTable.Root` bu nesneyi veya bu nesnenin bir atalarını hedeflediğinde otomatik olarak true'ya ayarlanır. `Class.LocalizationTable|LocalizationTables`, `Class.LocalizationTable.Root` özelliği bir örneğe işaret ettiğinde, kök örneğin altındaki tüm `Class.TextLabel.TextButton`'ları lokalize edecektir.


GuiBase2d.Localize

Bir lokalizasyon tablosunun `Class.LocalizationTable.Root` bu nesneyi veya bu nesnenin bir atalarını hedeflediğinde otomatik olarak true'ya ayarlanır.


Bu `Class.GuiBase2d` ve onun alt öğelerine otomatik lokalizasyon uygulamak için kullanılacak bir `Class.LocalizationTable` referansı. Otomatik lokalizasyonun uygulanabilmesi için `Class.GuiBase2d.AutoLocalize|AutoLocalize`, `Class.GuiBase2d` ve atalarının üzerinde `true` olarak ayarlanmalıdır.

Bunu `Class.DataModel` içerisindeki herhangi bir `Class.LocalizationTable`'a referans olacak şekilde ayarlayabilirsiniz. `Class.GuiBase2d` nesnesi ve tüm çocukları, otomatik metin değiştirme için bu belirli `Class.LocalizationTable` ve atalarını kullanmaya çalışacaktır.

Eğer referans edilen tabloda çeviri mevcut değilse, bu tablonun üstündeki ebeveynde de (eğer o da bir `Class.LocalizationTable` ise) çeviri arayacaktır.

Otomatik lokalizasyon için `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`'ın nasıl kullanıldığını açıklayan `Class.LocalizationService:GetTableEntries()`'e de bakın.


GuiBase2d.RootLocalizationTable

Bu `Class.GuiBase2d` ve onun alt öğelerine otomatik lokalizasyon 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ı sol yönde özelleştirir.


GuiBase2d.SelectionBehaviorLeft

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


GuiBase2d.SelectionBehaviorRight

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


GuiBase2d.SelectionBehaviorUp

Gamepad seçimlerinin, seçim grubunun altındaki butonlar arasında nasıl hareket edebileceğini, gruptan çıkmasını ve diğer butonları seçmesini özelleştirmenize izin verir.

`Class.GuiBase2d.SelectionGroup|SelectionGroup` değerini `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 öncelikle seçim grubu içinde bir seçim bulmaya çalıştığını ve yalnızca uygun bir buton bulamazsa dışarıya hareket ettiğini belirtir. Alternatif olarak, `Enum.SelectionBehavior.Stop` ayarı, gamepad seçiminin yalnızca seçim grubunun içinde olduğunu ve seçim davranışı yönünden grubun dışına çıkmadığını belirtir.


GuiBase2d.SelectionGroup

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


2D `Class.GuiObject|GuiObjects` tarafından miras alınan soyut bir 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şturmak mümkün değildir, ancak özel
`Datatype.Instance.new()` yapılandırıcı, sınıf adını bir parametre olarak alarak, nesneleri kod aracılığıyla oluşturur ve oluşturulan nesneyi döndürür.

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 örneğin yeniden ebeveynlenmesi veya herhangi bir atanın yeniden ebeveynlenmesi durumunda tetiklenir.

Bu olayı, Stüdyo'da bir nesnenin 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()` ile yok olduğunda tespit etmeniz gerekiyorsa, `Class.Instance.Destroying` olayını kullanın.

Instance.AncestryChanged

child

`Class.Instance.Parent|Parent` özelliği değişen örnek,
bu örnek veya daha uzak bir atası, **değil**
biriken işleyiciye bağlıdır.

parent

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

Bu olay, örnekte herhangi bir özelliğin değiştiği her durumda tetiklenir,
özellikle bir özelliğin `nil` olarak ayarlandığı durumlarda. Değişen özelliğin adı,
bu bağlı fonksiyona iletilir.

Örneğin, aşağıdaki kod parçası, bir parçanın özellikleri her 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, belirli bir özelliğin değiştiğinde tetiklenen olayı döndüren `Class.Instance:GetAttributeChangedSignal()`'ı kontrol edin.

Instance.AttributeChanged

attribute

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

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

Bir nesne bu `Class.Instance`'ye ebeveynlendikten sonra tetiklenir.

Not, bu yöntemi istemci üzerinde sunucu tarafından oluşturulan nesneleri tespit etmek için kullanırken, bu nesnelerin alt nesnelerine indeksleme yaparken `Class.Instance:WaitForChild()`'i kullanmak gereklidir. Çünkü nesne ve alt nesneler sunucudan istemciye aynı anda kopyalanacağı garanti edilmemektedir. Örneğin:

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

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

Ayrıca, `Class.Instance.ChildRemoved`'ı kontrol edin.

Instance.ChildAdded

Bir nesne bu `Class.Instance`'ye ebeveynlendikten 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ırılan, bir nesnenin ebeveyninin bu `Class.Instance`'den başka bir şeye değişmesini ifade eder. Not, bu olay, bir çocuğun yok olduğu (kullanarak `Class.Instance:Destroy()`) durumunda da tetiklenir çünkü yok etme fonksiyonu bir nesnenin ebeveynini `nil` olarak ayarlar.

Bu olay yalnızca `Class.Instance`'nin hemen altındaki çocuklar için işler. Tüm alt nesneleri yakalayan bir olay için `Class.Instance.DescendantRemoving`'i kullanın.

Ayrıca, `Class.Instance.ChildAdded`'ı kontrol edin.

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 `Class.Instance`'ye eklendikten sonra tetiklenir.

Her alt nesne için tetiklendiğinden, bir nesneyi `Class.Instance`'ye ebeveynlendiğinizde bu nesne ve tüm alt nesneleri için olay tetiklenecektir.

Eğer yalnızca `Class.Instance`'nin **doğrudan çocuklarıyla** ilgileniyorsanız, bunun yerine `Class.Instance.ChildAdded`'i kullanın.

Ayrıca, `Class.Instance.DescendantRemoving`'i kontrol edin.

Instance.DescendantAdded

descendant

Bir alt nesne `Class.Instance`'ye eklendikten sonra tetiklenir.

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

Bu olay, bir ebeveyn `Class.Instance`'nin değişmesi üzere **hemen önce** tetiklenir, böylelikle bir **alt nesne** artık bir alt nesne olmayacaktır. `Class.Instance:Destroy()|Destroy()` bir örneğin `Class.Instance.Parent|Parent`'ini `nil` olarak değiştirir, bu nedenle ebeveynlerinden birinin alt nesnesinde bu yöntemi çağırmak bu olayı tetikleyecektir.

Bu olay, alt nesnenin kaldırılmadan önce tetiklendiğinden, bu olayın tetiklendiği sırada alt nesnenin ebeveyni değişmemiş olacaktır. Eğer alt nesne ayrıca ebeveynin **doğrudan çocuğu** ise, bu olay `Class.Instance.ChildRemoved`'den önce tetiklenecektir.

Bir alt nesnenin çocukları varsa, bu olay önce alt nesne ile, ardından onun alt nesneleri ile tetiklenir.

#### Uyarı

Bu olay, kaldırılan alt nesne ile tetiklenir.
Alt nesnenin `Class.Instance.Parent|Parent`'ini başka bir şeyle 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 manipüle edildiği için tetiklenir ve değişiklik henüz gerçekleşmemiştir
	-- Bu nedenle ebeveyni şu ş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`'ı kontrol edin.

Instance.DescendantRemoving

Bir `Class.Instance`'nin 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ılırken `Class.Instance` asla bellekten silinmeyecektir. Ancak, fonksiyon herhangi bir noktada bekleme yaparsa,
`Class.Instance` ve onun alt nesneleri `nil`'e ebeveynlendirilir.

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

Eğer `Class.Workspace.SignalBehavior` özelliği `Enum.SignalBehavior.Deferred` olarak ayarlandıysa,
bu olay bir sonraki yeniden başlatma noktasında tetiklenecektir, ki bu da `Class.Instance` veya bir atası `Class.Instance:Destroy()` ile yok edildikten sonraki zamandır.

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

Bir `Class.Instance` i Stüdyoda 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 ki bunu `Class.Instance.AncestryChanged` ile takip edebilirsiniz.

Instance.Destroying

Örnek, `Class.Instance:Destroy()` aracılığıyla yok edilmeden hemen önce (veya sonrasına ertelenerek) tetiklenir.

Bu olay, her zaman bir stil özelliği değiştirildiğinde tetiklenir,
özellikle bir özelliğin `nil` olarak ayarlandığı durumlarda.

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

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

local function stylePropertyChanged()
	print("Stil özellikleri değişti")
end

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

Instance.StyledPropertiesChanged

Herhangi bir stil özelliği değiştirildiğinde tetiklenir, özellikle bir özellik `nil` olarak ayarlandığında.

Bu yöntem, etiket uygulandığında etkisiz hale gelir, bir etiket uygular.
Bir etiket başarıyla eklenirse, sağlanan etiketle birlikte
`Class.CollectionService:GetInstanceAddedSignal()` tarafından oluşturulan bir sinyal tetiklenir.

#### Uyarılar

- İstemci tarafında eklenen bir nesnenin etiketleri, sunucu daha sonra o nesneye bir etiket ekler veya kaldırırsa
  silinecektir çünkü sunucu tüm etiketleri birlikte kopyalar ve önceki etiketleri geçersiz kılacaktır.

- 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, bir etikete artık ihtiyaç kalmadığında bunları temizlemek iyi bir fikirdir (koparıp,
  `nil` olarak ayarlamak vb.). Bunu `Class.Instance:RemoveTag()` çağrılırken, `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 soylarını yok eder.

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

-- Bazı ışıldaklar ekleyelim
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 soyları yok etmek istemiyorsanız, ya
`Class.Instance:GetChildren()` ya da `Class.Instance:GetDescendants()` kullanarak o çocuklar/soylar arasında döngüye girebilir ve hangi nesneleri yok etmeniz gerektiğini seçebilirsiniz. Ö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 soylarının bir kopyasını oluşturur,
`Class.Instance.Archivable|Archivable` olmayan tüm nesneleri yok sayar. Kök nesnenin kopyası
bu yöntemle döndürülür ve `Class.Instance.Parent|Parent`'ı `nil` olarak ayarlanır. Eğer nesne kendisi `Class.Instance.Archivable|Archivable` değeri `false` ise,
hesap bu yöntem `nil` döndürecektir.

Eğer bir referencia nesne, örneğin `Class.ObjectValue.Value`, kopyalanan bir nesnede ayarlanırsa,
kopyanın özelliklerinin değeri orijinalinin değerine bağlıdır:

- Eğer bir referans özelliği **aynı zamanda** kopyalandıysa,
kopya bu kopyaya işaret edecektir.
- Eğer bir referans özelliği **kopyalanmamış** bir nesneye işaret ediyorsa,
kopyada aynı değer korunacaktır.

Instance:Clone

Bir nesnenin ve tüm soylarının bir kopyasını oluşturur; `Class.Instance.Archivable|Archivable` olmayan nesneleri yok sayar.

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ı koparır ve tüm çocuklara `Destroy()` çağrısı yapar. Bu yöntem,
artık gerekli olmayan nesneleri atmanın doğru yoludur.

Artık gerekli olmayan nesneleri atmak önemlidir, çünkü gereksiz nesneler ve
yerlerdeki bağlantılar bellek kullanır ve zamanla ciddi performans sorunlarına yol açabilir.

`Destroy()` çağrıldıktan sonra bir nesneye referans veren değişkenleri `nil`
a 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 edildiğinde,
tekrar kullanılamaz çünkü `Class.Instance.Parent` özelliği kilitlenir. Nesneyi **geçici olarak** kaldırmak, yok etmek yerine,
`Class.Instance.Parent|Parent` değerini `nil` olarak ayarlayarak yapılabilir. Ö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ı koparır ve tüm çocuklara `Destroy()` çağrısı yapar.

Instance:destroy

Verilen isme eşit olan `Class.Instance`'nin ilk atasını döndürür.

Bu yöntem yukarıya doğru çalışır, yani nesnenin hemen üstündeki `Class.Instance.Parent`
dan başlar ve `Class.DataModel`'e kadar çıkar. Eşleşen bir ata bulunamazsa, `nil` döndürür.

Aşağıdaki kod parçacığı, `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 lütfen `Class.Instance:FindFirstAncestorOfClass()` ve `Class.Instance:FindFirstAncestorWhichIsA()`'ya bakın.

Instance:FindFirstAncestor

name

Verilen isme eşit olan `Class.Instance`'nin ilk atasını döndürür.

Verilen className'e eşit olan `Class.Object.ClassName`'in ilk atasını döndürür.

Bu yöntem yukarıya doğru çalışır; yani nesnenin hemen üstündeki `Class.Instance.Parent`
dan başlar ve `Class.DataModel`'e kadar çıkar. Eşleşen bir ata bulunamazsa, `nil` döndürür.

Bu yöntemin yaygın bir kullanım durumu, 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 bir varyantıdır ve `Class.Object.ClassName` özelliğini kontrol eder;
`Class.Instance:FindFirstAncestorWhichIsA()` ise sınıf mirasını dikkate almak için `Class.Object:IsA()` metodunu kullanır.

Instance:FindFirstAncestorOfClass

className

Verilen className'e eşit olan `Class.Object.ClassName`'in ilk atasını döndürür.

Verilen className için, `Class.Object:IsA()` değerinin true döndürdüğü `Class.Instance`'nin ilk atalarını döndürür.

Bu yöntem yukarıya doğru çalışır; yani nesnenin hemen üstündeki `Class.Instance.Parent`
dan başlar ve `Class.DataModel`'e kadar çıkar. Eşleşen bir ata bulunamazsa, `nil` döndürür.

`Class.Instance:FindFirstAncestorOfClass()`'dan farklı olarak, bu yöntem `Class.Object:IsA()` metodunu 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 parçacığı, ilk `Class.BasePart` ata ile sonuçlanır; bu, `Class.WedgePart`, `Class.MeshPart` veya `Class.Part` olsun.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```

`Class.Instance:FindFirstAncestor()`'a da bakın.

Instance:FindFirstAncestorWhichIsA

Verilen className için, `Class.Object:IsA()` değerinin true döndürdüğü `Class.Instance`'nin ilk atalarını döndürür.

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 isme sahip olan `Class.Instance` çocuklarından ilki döndürülür; eğer 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ına değil, tüm soylarına bakar.

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

`FindFirstChild()` bir nesnenin varlığını doğrulamanız gerektiğinde gereklidir.
Eğer çocuk ismiyle indekslenirse, çocuk mevcut değilse bir hata fırlatır.

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

-- Aşağıdaki satır parça yoksa hata verir.
Workspace.Part.Transparency = 0.5
```
Daha iyi bir yaklaşım, önce `Part`'ı kontrol etmek için `FindFirstChild()` kullanmak ve sonra gerekli olan 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 Özellik ile Eşleşen Bir Çocuğu Bulma

Bazen bir nesnenin `Class.Instance.Name|Name`'i, `Class.Instance.Parent|Parent`'nin bir özelliğiyle aynıdır. Noktalamayı kullanırken, isimleri aynı olan çocuklar üzerinde özellikler önceliklidir.

Aşağıdaki örnekte, `Color` adında bir `Class.Folder` eklenir, ayrıca bu `Class.Part`, `Class.Part.Color` özelliğine sahiptir. `part.Color` öğesi,
`Datatype.Color3` özelliğinin değerine atıfta bulunur, çocuk `Class.Folder` nesnesine değil. `Class.Instance:FindFirstChild()|FindFirstChild()` kullanmanın faydası, yeni özelliklerin tanıtılmasının kodunuza herhangi bir risk yüklememesi gerektiğidir.

```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")  -- Alt klasör
```

#### Performans Notları

`Class.Instance:FindFirstChild()|FindFirstChild()` kullanmak, noktalamayı kullanmaktan yaklaşık %20 daha uzun sürer ve bir nesneye referans tutmaktan neredeyse 8 kat daha uzun sürer. Bu yüzden, performansa bağlı kodda, örneğin sıkı döngülerde veya `Class.RunService.Heartbeat` ve `Class.RunService.PreRender` ile ilişkili işlevlerde kullanılmamalıdır. Bunun yerine, sonucu bir değişkende saklayın veya `Class.Instance.ChildAdded|ChildAdded` veya `Class.Instance:WaitForChild()|WaitForChild()` kullanmayı düşünün ve belirli bir isme sahip çocuğun ne zaman erişilebilir olduğunu tespit edin.

Instance:FindFirstChild

recursive

Aramanın yeniden işleme tabi olup olmayacağı.

Verilen isme sahip olan `Class.Instance` çocuklarından ilki döndürülür.

Instance:findFirstChild

Verilen `className`'e 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 ve sınıf mirasını görmezden gelir. Eğer eşleşen bir çocuk yoksa bu yöntem `nil` döndürür.

Instance:FindFirstChildOfClass

Verilen `className`'e eşit olan `Class.Instance`'nin ilk çocuğunu döndürür.

Verilen `className` için `Class.Object:IsA()` değerinin true döndürdüğü ilk `Class.Instance` çocuğunu döndürür.

Eğer eşleşen bir çocuk yoksa, bu yöntem `nil` döndürür. Eğer isteğe bağlı `recursive` argümanı true ise, bu yöntem tüm soyları arar; yalnızca `Class.Instance`'nin hemen çocuklarını değil.

`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 parçacığı ilk `Class.BasePart` çocuğunu döndürecektir; bu, `Class.WedgePart`, `Class.MeshPart` veya `Class.Part` olsun.

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

Instance:FindFirstChildWhichIsA

Verilen `className` için `Class.Object:IsA()` değerinin true döndürdüğü ilk `Class.Instance` çocuğunu döndürür.

Verilen `Class.Instance.Name`'e sahip ilk soy döndürülür.

Bu yöntem devre dışıdır ve kullanılamaz. Bir nesnenin ilk soyunu bulmak için,
`Class.Instance:FindFirstChild()` üzerindeki yeniden işlem parametresini kullanmayı düşünün.

Instance:FindFirstDescendant

Verilen `Class.Instance.Name`'e sahip ilk soy döndürülür.

Eğer `Class.Instance` bir `Class.Actor`'sa, `Class.Actor` nesnesini döndürür. Aksi takdirde, en yakın atası `Class.Actor` döndürülür. Eğer hiçbir atası `Class.Actor` değilse, sonuç `nil` olur.

Instance:GetActor

Nesneyle ilişkili `Class.Actor`'ı döndürür; varsa.

Bu yöntem, verilen özellik adına atanan değeri döndürür. Eğer hiçbir özellik atanmamışsa, `nil` döner.

Örneğin, aşağıdaki kod parçacığı, örneğin `InitialPosition` özelliğinin değerini ayarlayıp 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 isimle verilen değeri atar.
- `Class.Instance:GetAttributes()` her nesnenin özellikleri için anahtar-değer çiftlerini döndürür.

Instance:GetAttribute

Verilen özelliğin ismine atanmış değer. Eğer hiçbir özelliğe atanmadıysa, `nil` döner.

Verilen özellik adı için atanan değeri döndürür.

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/BillboardGui.yaml