`Class.GuiButton` `Class.GuiObject`'tan türetilen bir soyut sınıftır.
Etkileşimli, tıklanabilir `Class.ImageButton` ve
`Class.TextButton` nesneleri için temel sınıftır. Bu sınıf ayrıca
etkileşimli davranışlar için birkaç özellik tanımlar; bunlar
`Class.GuiButton.AutoButtonColor|AutoButtonColor` ve
`Class.GuiButton.Modal|Modal`'dır.

`Class.GuiButton`'ın en önemli olayı
`Class.GuiButton.Activated|Activated`'dır. Bu, düğmenin aktive
olduğunda ateş eden **çoklu platform olayı**dır. Fare kullanırken, bu,
düğmeye tıklamak ve imleç hala UI nesnesinin üzerinde olduğunda bırakmak
anlamına gelir. Dokunma için, bu aynı şekilde uygulanır ancak düğme
basılması yerine bir dokunuş ile. Son olarak, oyun kumandaları için,
`Class.GuiButton.Activated|Activated` eğer bir `Class.GuiButton`
seçilirse, **A** düğmesine basıldığında ve bırakıldığında yayılır.
Kısacası, bu olay çoklu platform kullanıcı arayüzü programlaması için
çok kullanışlıdır çünkü tek bir kullanıcı girişi için güzel bir genel
arayüz sağlar.

Masaüstünde sol tıklama basılı ve bırakma algılandığında, mobilde dokunmatik
bırakma algılandığında veya konsolda UI navigasyon modunda **A**/çarpı
aktif edildiğinde tetiklenir.

Bu olay sunucuda tetiklenmediği için yalnızca bir
`Class.LocalScript` içinde veya `Class.Script`'te
`Class.Script.RunContext|RunContext` değerinin `Enum.RunContext.Client` olduğu durumlarda kullanılmalıdır.

GuiButton.Activated

inputObject

clickCount

Bu olay, kullanıcının tam olarak farenin sol tuşuna tıkladığında
`Class.GuiButton`'a ateş eder.

Tıklama ile ilgili olarak, fare `Class.GuiButton` sınırları içinde
olmalı ve fare tuşu basılı olmalı ve bu olay ateş etmeden önce
tekrar kaldırılmalıdır. Eğer fare `Class.GuiButton` sınırlarını
terk ederse ve serbest bırakılırsa, olay ateş edilmeyecektir. Eğer
bu sınırlamalardan kaçınmak istiyorsanız,
`Class.GuiButton.MouseButton1Down|MouseButton1Down` ve
`Class.GuiButton.MouseButton1Up|MouseButton1Up` kullanabilirsiniz;
bu olaylar benzer ama kullanıcının sol fare düğmesine basması veya
kaldırması durumunda ateş eder.

GuiButton.MouseButton1Click

Kullanıcının farenin tam olarak `Class.GuiButton`'a sol tıkladığında
ateş eder.

Bu olay, kullanıcının `Class.GuiButton` üzerinde sol fare düğmesini
aşağıya bastığında ateş eder.

Kullanıcının `Class.GuiButton` üzerinde sol fare düğmesine **ve** salması
şartıyla bir olay için `Class.GuiButton.MouseButton1Click|MouseButton1Click`
kullanmayı düşünebilirsiniz.

GuiButton.MouseButton1Down

Fareni **X** ekranda piksel cinsinden koordinatı.

Fareni **Y** ekranda piksel cinsinden koordinatı.

Kullanıcının `Class.GuiButton` üzerinde sol fare düğmesini aşağıya
bastığında ateş eder.

Bu olay, kullanıcı farenin sol düğmesini `Class.GuiButton`
üzerinde bıraktığında ateş eder.

Kullanıcının `Class.GuiButton` üzerinde sol fare düğmesine **ve** salması
şartıyla bir olay için `Class.GuiButton.MouseButton1Click|MouseButton1Click`
kullanmayı düşünebilirsiniz.

GuiButton.MouseButton1Up

Kullanıcı farenin sol düğmesini `Class.GuiButton`
üzerinde bıraktığında ateş eder.

Bu olay, kullanıcının farenin tam olarak sağ tıkladığında
`Class.GuiButton`'a ateş eder.

Tıklama ile ilgili olarak, fare `Class.GuiButton` sınırları içinde
olmalı ve fare tuşu basılı olmalı ve bu olay ateş etmeden önce
tekrar kaldırılmalıdır. Eğer fare `Class.GuiButton` sınırlarını
terk ederse ve serbest bırakılırsa, olay ateş edilmeyecektir. Eğer
bu sınırlamalardan kaçınmak istiyorsanız,
`Class.GuiButton.MouseButton2Down|MouseButton2Down` ve
`Class.GuiButton.MouseButton2Up|MouseButton2Up` kullanabilirsiniz;
bu olaylar benzer ama kullanıcının sağ fare düğmesine basması veya
kaldırması durumunda ateş eder.

GuiButton.MouseButton2Click

Kullanıcının farenin tam olarak sağ tıkladığında `Class.GuiButton`
üzerinde ateş eder.

Bu olay, kullanıcının `Class.GuiButton` üzerinde sağ fare düğmesini
aşağıya bastığında ateş eder.

Kullanıcının `Class.GuiButton` üzerinde sağ fare düğmesine **ve**
serbest bırakması şartıyla bir olay için
`Class.GuiButton.MouseButton2Click|MouseButton2Click` kullanmayı
düşünebilirsiniz.

GuiButton.MouseButton2Down

Kullanıcının `Class.GuiButton` üzerinde sağ fare düğmesini aşağıya
bastığında ateş eder.

Bu olay, kullanıcının sağ fare düğmesini `Class.GuiButton`
üzerinden kaldırdığında ateş eder.

Kullanıcının `Class.GuiButton` üzerinde sağ fare düğmesine **ve**
serbest bırakması şartıyla bir olay için
`Class.GuiButton.MouseButton2Click|MouseButton2Click` kullanmayı
 düşünebilirsiniz.

GuiButton.MouseButton2Up

Kullanıcının sağ fare düğmesini `Class.GuiButton`
üzerinden kaldırdığında ateş eder.

Bir fareden sağ tıklama basılı ve bırakma algılandığında, bir dokunmatik girişte uzun
basma algılandığında, bir oyun kumandasından `R3` algılandığında veya
klavye kullanarak kullanıcı arayüzü gezinti modunda <kbd>Alt</kbd><kbd>Enter</kbd>
algılandığında tetiklenir.


GuiButton.SecondaryActivated

Alternatif etkinleştirme eylemini temsil eden giriş nesnesi.

Butonun "ikincil" girişi etkinleştirildiğinde tetiklenir.

GuiButton

Bu özellik, kullanıcının `Class.Mouse` düğmenin üzerine geldiğinde veya
üzerine tıkladığında düğmenin otomatik olarak renk değiştirip
değiştirmeyeceğini belirler. Eğer `true` ise, düğme fare teklif
üzerine geldiğinde veya tıklandığında otomatik olarak renk değiştirir.
Eğer `false` ise, düğme renk değiştirmez.

Kullanıcının farenin üzerine geldiğinde veya tıkladığında düğmenin nasıl
değiştiğini özelleştirmek isterseniz, `Class.ImageButton` kullanmayı
düşünebilirsiniz ve elemanın `Class.ImageButton.HoverImage|HoverImage`
vb. özelliklerini değiştirebilirsiniz.

Lütfen not edin ki, bu özellik bir `Class.ImageButton` üzerinde
`Class.ImageButton.Image|Image` özelliği bir resme ayarlandığında
eğer etkisi olmayacaktır. Ayrıca, bu özellik `Class.ImageButton`
un mouse üzerinde hareket ettiğinde `Class.ImageButton.HoverImage|HoverImage`
`nil` değilse etkili olmayacak, aynı şekilde fare tıklaması
şartlarında da `Class.ImageButton.PressedImage|PressedImage`
`nil` değilse etkili olmayacaktır.

GuiButton.AutoButtonColor

Düğmenin farenin üzerine geldiğinde veya tıklandığında otomatik olarak
renk değiştirip değiştirmeyeceğini belirler.

Düğmenin üzerine gelindiğinde çalacak bir `Class.HapticEffect`
örneği.

GuiButton.HoverHapticEffect

`Class.GuiButton` üzerine gelindiğinde çalacak bir `Class.HapticEffect`
örneği.

`true` ise GUI öğesi görünürken, farenin sağ tuşu aşağıda değilse
kilitlenmeyecek.

GuiButton.Modal

Düğmeye basıldığında çalacak bir `Class.HapticEffect` örneği.

GuiButton.PressHapticEffect

Nesnenin seçilip seçilmediğini belirten bir bool özelliği.

GuiButton.Selected

`Class.GuiButton`'ın, önceden belirlenmiş stiller listesine
göre stilini ayarlamak için kullanılır.

GuiButton.Style

Etkileşimli 2D kullanıcı arayüzü elemanları için soyut bir sınıf.

`Class.GuiObject` 2D kullanıcı arayüzü nesneleri için bir soyut sınıfdır (tıpkı `Class.BasePart` gibi). Bir grafik kullanıcı arayüzü (GUI) nesnesinin gösterimi ile ilgili tüm özellikleri tanımlar, örneğin, `Class.GuiObject.Size|Boyut` ve `Class.GuiObject.Position|Konum`. Ayrıca, `Class.GuiObject.AbsolutePosition|KesinKonum`, `Class.GuiObject.AbsoluteSize|KesinBoyut` ve `Class.GuiObject.AbsoluteRotation|KesinDönme` gibi bazı yararlı salt okunur özelliklere de sahiptir.

GUI nesnelerinin düzenini özel şekillerde manipüle etmek için, [list/flex](/ui/list-flex-layouts) veya [grid](/ui/grid-table-layouts) gibi bir düzen yapısı kullanabilir ve bunların temel özelliklerinin ötesinde stillerini ayarlayabilirsiniz [görünüm değiştiricileri](/ui/appearance-modifiers) aracılığıyla.

Hiçbir GUI nesnesinde fare düğmesi olaylarını algılamak mümkün olmakla birlikte, sadece `Class.ImageButton` ve `Class.TextButton` `Class.TextButton.Activated|Aktif` gibi tıklama/basım algılamak için uygun özel olaylara sahiptir.

Aşağıdaki örnek, bir `TextButton` gibi bir GuiObject'in içinde olduğunu varsayıyor ve
`Class.GuiObject.Draggable` özelliğinin true olarak ayarlandığını varsayıyor. Bu, oyuncunun nesneyi sürüklemeye başladığı yerin UDim2'sini yazdırır.

Bu olay, bir oyuncu nesneyi sürüklemeye başladığında tetiklenir.

Ayrıca bkz. `Class.GuiObject.DragStopped`.

GuiObject.DragBegin

initialPosition

`Class.GuiObject`'un sürükleme işlemi başlamadan önceki yerinin `Datatype.UDim2` değeri.

Bir oyuncu nesneyi sürüklemeye başladığında tetiklenir.

Aşağıdaki örnek, bir `TextButton` gibi bir GuiObject içinde olduğunu varsayar ve
`Class.GuiObject.Draggable` özelliğinin true olarak ayarlandığını varsayar. Bu, oyuncunun
GUI'yi sürüklemeyi durdurduğu yerdeki X ve Y'yi yazdıracaktır. Örneğin, oyuncu
eğer nesneyi 189, 180'de durdurursa, aşağıdaki 'Oyuncu GuiObject'yi (189, 180)'de sürüklemeyi durdurdu' yazdıracaktır.

Bu olay, bir oyuncu nesneyi sürüklemeyi bıraktığında tetiklenir.

Ayrıca bkz. `Class.GuiObject.DragBegin`.

GuiObject.DragStopped

Fare işaretçisinin ekrandaki **X** konumu, ekranın sol üst köşesine göre, piksel cinsindendir.

Fare işaretçisinin ekrandaki **Y** konumu, ekranın sol üst köşesine göre, piksel cinsindendir.

Bir oyuncu nesneyi sürüklemeyi bıraktığında tetiklenir.

Aşağıdaki örnek, kullanıcı girişini InputBegan'dan türüne bağlı olarak
işlemenin birçok kullanım örneğinden birini göstermektedir.

Bu işlevin beklenildiği gibi çalışabilmesi için,
bir `LocalScript` içinde ve _gui_'nin bir çocuğu olarak yerleştirilmesi gerekir.

Bu olay, bir kullanıcının `Class.GuiObject` ile İnsan-Bilgisayar Arayüzü cihazı aracılığıyla etkileşime geçmeye başladığında tetiklenir (fare düğmesine basma, dokunma başlangıcı, klavye tuşuna basma vb.).

`Class.UserInputService`, belirli bir UI öğesi ile sınırlı olmayan benzer isimli bir olaya sahiptir: `Class.UserInputService.InputBegan`.

Bu olay, oyun durumu ne olursa olsun her zaman tetiklenir.

Ayrıca bkz. `Class.GuiObject.InputEnded` ve `Class.GuiObject.InputChanged`.

GuiObject.InputBegan

input

Bir `Class.InputObject`, kullanıcı girişini sorgulamak için yararlı veriler içeren bir nesne, örneğin `Enum.UserInputType|giriş türü`,
`Enum.UserInputState|giriş durumu` ve
`Class.InputObject.Position|girişin ekran koordinatları`.

Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla etkileşime geçmeye başladığında tetiklenir (fare düğmesine basma, dokunma başlangıcı, klavye tuşuna basma vb.).

Aşağıdaki örnek, InputChanged'den kullanıcının girdi alımının türüne bağlı olarak işlem yapmanın birçok kullanım örneğinden birini göstermektedir.

Bunun beklendiği gibi çalışması için, bir `LocalScript`
e ve _gui_ 'nin bir çocuğu olarak yerleştirilmesi gerekir.

Bu olay, bir kullanıcının İnsan-Bilgisayar Arayüzü cihazı (fare düğmesine basma, dokunma başlangıcı, klavye tuşuna basma vb.) aracılığıyla etkileşim şekli değiştiğinde tetiklenir.

`Class.UserInputService`, belirli bir UI öğesi ile sınırlı olmayan benzer isimli bir olaya sahiptir: `Class.UserInputService.InputChanged`.

Bu olay, oyun durumu ne olursa olsun her zaman tetiklenir.

Ayrıca bkz. `Class.GuiObject.InputBegan` ve `Class.GuiObject.InputEnded`.

GuiObject.InputChanged

Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazıyla etkileşim şekli değiştiğinde tetiklenir (fare düğmesine basma, dokunma başlangıcı, klavye tuşuna basma vb.).

Aşağıdaki örnek, InputEnded olayından kullanıcı girişini türüne bağlı olarak işleme konusunda birçok kullanım örneğinden birini göstermektedir.

Bunun beklenildiği gibi çalışması için bir `LocalScript` içinde ve _gui_'nin bir çocuğu olarak yerleştirilmesi gerekmektedir.

InputEnded olayı, bir kullanıcının İnsan-Bilgisayar Arayüzü cihazı (fare düğmesine basma, dokunma başlangıcı, klavye tuşuna basma vb.) aracılığıyla etkileşimi bıraktığında tetiklenir.

`Class.UserInputService`, belirli bir UI öğesi ile sınırlı olmayan benzer isimli bir olaya sahiptir: `Class.UserInputService.InputEnded`.

Bu olay, oyun durumu ne olursa olsun her zaman tetiklenir.

Ayrıca bkz. `Class.GuiObject.InputBegan` ve `Class.GuiObject.InputChanged`.

GuiObject.InputEnded

Bir `Class.InputObject`, kullanıcı girişini sorgulamak için yararlı veriler içeren bir nesne, örneğin `Enum.UserInputType`, `Enum.UserInputState` ve
`Class.InputObject.Position`.

Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla etkileşimi bıraktığında tetiklenir (fare düğmesine basma, dokunma başlangıcı, klavye tuşuna basma vb.).

Aşağıdaki örnek, fare GUI öğesine girdiğinde fare konumunu, piksel cinsinden, yazdırır.

MouseEnter olayı, bir kullanıcının mouse'unu bir `Class.GuiObject` öğesine hareket ettirdiğinde tetiklenir.

Lütfen, bu olay tarafından geçirilen `x` ve `y` argümanlarına güvenmeyin, zira bu olayın tetiklenme anında fare üzerindeki konumu kesin bir şekilde belirlemek için güvenilir bir yöntem değildir. Bu koordinatlar, fare aynı kenardan GUI'ye girdiğinde bile değişebilir - özellikle fare çok hızlı bir şekilde nesneye girdiğinde. Bunun nedeni, koordinatların olay tetiklendiğinde fare konumunu göstermesi ve fare açısından tam olarak GUI'ye giriş anını yakalaması değil.

Bu olay, GUI öğesi başka bir öğenin altında render edilse bile tetiklenir.

Eğer bir kullanıcının farelerinin bir GUI öğesinden çıktığında izlemek istiyorsanız `Class.GuiObject.MouseLeave` olayını kullanabilirsiniz.

##### Ayrıca Bkz.

- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseEnter

Bir kullanıcı, farelerini bir GUI öğesine hareket ettirdiğinde tetiklenir.

MouseLeave olayı, bir kullanıcının farelerini bir `Class.GuiObject` öğesinin dışına hareket ettirdiğinde tetiklenir.

Lütfen, bu olay tarafından geçirilen `x` ve `y` argümanlarına güvenmeyin, zira bu olayın tetiklenme anında fare üzerindeki konumu kesin bir şekilde belirlemek için güvenilir bir yöntem değildir. Bu koordinatlar, fare aynı kenardan GUI'den çıkarken bile değişebilir - özellikle fare çok hızlı bir şekilde nesneden çıktığında. Bunun nedeni, koordinatların olay tetiklendiğinde fare konumunu göstermesi ve fare açısından tam olarak GUI'den çıkış anını yakalaması değil.

Bu olay, GUI öğesi başka bir öğenin altında render edilse bile tetiklenir.

##### Ayrıca Bkz.

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseLeave

Bir kullanıcı, farelerini bir GUI öğesinin dışına hareket ettirdiğinde tetiklenir.

Bir kullanıcı, fareyi bir `Class.GuiObject` öğesinin içinde hareket ettirdiğinde ateşlenir. Bu, kullanıcının faresinin bir GUI öğesinin üzerindeki olup olmadığına bakmadan ateşlenen `Class.Mouse.Move` olayına benzer.

Not, bu olay, farenin pozisyonu güncellendiğinde ateşlenir, bu nedenle hareket ederken tekrar tekrar ateşlenecektir.

`x` ve `y` argümanları, kullanıcının faresinin piksel cinsinden güncellenmiş ekran koordinatlarını gösterir. Bu, farenin, GUI üzerindeki yerini, ekranı ve eğer takip ediliyorsa farenin önceki konumuna göre delta'yı belirlemek için faydalı olabilir.

Aşağıdaki kod, kullanıcının faresinin GUI öğesine göre `Datatype.Vector2` ofsetini nasıl belirleyeceğini gösterir:

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

local CustomScrollingFrame = script.Parent
local SubFrame = CustomScrollingFrame:FindFirstChild("SubFrame")

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	local gui_X = CustomScrollingFrame.AbsolutePosition.X
	local gui_Y = CustomScrollingFrame.AbsolutePosition.Y


	local pos = Vector2.new(math.abs(X - gui_X), math.abs(Y - gui_Y - 36))
	print(pos)
end

CustomScrollingFrame.MouseMoved:Connect(getPosition)
```
Bu olay, kullanıcının faresinin bir GUI öğesine girdiği veya çıktığı anda tam olarak ateşlenmeyebilir. Bu nedenle, `x` ve `y` argümanları, GUI'nin kenarlarının koordinatlarıyla mükemmel bir şekilde eşleşmeyebilir.

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

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseMoved

Fare'nin **X** ekran koordinatı piksel cinsinden, ekranın sol üst köşesine göre.

Fare'nin **Y** ekran koordinatı piksel cinsinden, ekranın sol üst köşesine göre.

Bir kullanıcı farelerini bir GUI öğesi içinde hareket ettirdiğinde tetiklenir.

WheelBackward olayı, bir kullanıcı fare tekerleğini geri kaydırdığında ve fare bir `Class.GuiObject` öğesinin üzerindeyken ateşlenir. Bu, kullanıcının faresinin bir GUI öğesinin üzerindeki olup olmadığına bakmadan ateşlenen `Class.Mouse.WheelBackward` olayına benzer.

Bu olay, yalnızca tekerleğin geri hareketinin bir göstergesi olarak ateşlenir. Bu, `x` ve `y` fare koordinat argümanlarının bu olay sonucunda değişmediği anlamına gelir. Bu koordinatlar yalnızca fare hareket ettiğinde değişir, bu da `Class.GuiObject.MouseMoved` olayı ile takip edilebilir.

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

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`

GuiObject.MouseWheelBackward

Bir kullanıcı, fare GUI öğesinin üzerindeyken fare tekerleğini geri kaydırdığında ateşlenir.

WheelForward olayı, bir kullanıcı fare tekerleğini ileri kaydırdığında ve fare bir `Class.GuiObject` öğesinin üzerindeyken ateşlenir. Bu, kullanıcının faresinin bir GUI öğesinin üzerindeki olup olmadığına bakmadan ateşlenen `Class.Mouse.WheelForward` olayına benzer.

Bu olay, yalnızca tekerleğin ileri hareketinin bir göstergesi olarak ateşlenir. Bu, **X** ve **Y** fare koordinat argümanlarının bu olay sonucunda değişmediği anlamına gelir. Bu koordinatlar yalnızca fare hareket ettiğinde değişir, bu da `Class.GuiObject.MouseMoved` olayı ile takip edilebilir.

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

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseWheelForward

Kullanıcının faresinin **Y** koordinatı.

Bir kullanıcı, fare GUI öğesinin üzerindeyken fare tekerleğini ileri kaydırdığında ateşlenir.

Aşağıdaki örnek, kullanıcı bir nesneyi gamepad ile seçtiğinde bir mesaj yazdırır.

Bunun beklenildiği gibi çalışması için, bir `LocalScript` içinde
_ gui _'nin bir alt öğesi olarak yerleştirilmelidir.

Bu olay, Gamepad seçici `Class.GuiObject` üzerinde odaklanmaya başladığında ateşlenir.

Eğer Gamepad seçici GUI öğesinin üzerine odaklandığında kontrol etmek isterseniz, `Class.GuiObject.SelectionLost` olayını kullanabilirsiniz.

Bir GUI odaklandığında, `Class.GuiService.SelectedObject|SelectedObject` özelliğinin değeri de seçimi kazanan öğeye değişir. Hangi GUI'nin seçimi kazandığını belirlemek için bu özelliğin değerine bakın.

GuiObject.SelectionGained

Gamepad seçiciyle GuiObject'e odaklandığında ateşlenir.

Aşağıdaki örnek, bir oyun kolu üzerinde öğenin odaklanması kaybolduğunda bir mesaj yazdırır.

Bunun beklenildiği gibi çalışması için bir `LocalScript` içinde ve _gui_'nin bir çocuğu olarak yerleştirilmesi gerekir.

Bu olay, Gamepad seçici `Class.GuiObject` üzerinde odaklandığında ateşlenir.

Eğer Gamepad seçici GUI öğesinin üzerine odaklandığında kontrol etmek isterseniz, `Class.GuiObject.SelectionGained` olayını kullanabilirsiniz.

Bir GUI odak kaybettiğinde, `Class.GuiService.SelectionObject|SelectionObject` özelliğinin değeri ya `nil` ya da odak kazanan GUI öğesine değişir. Hangi GUI'nin seçimi kazandığını veya hiçbir GUI'nin seçilmediğini belirlemek için bu özelliğin değerine bakın.

GuiObject.SelectionLost

Gamepad seçici GuiObject'ten odaklandığında ateşlenir.

Bu kod örneği, oyuncunun bir UI elemanının, örneğin bir `Frame`in, ekran pozisyonunu kısa bir süre için üzerine basarak manipüle etmesine olanak tanır. Ardından, oyuncu parmağını hareket ettirir ve bırakır. Hareket sırasında Frame mavi renkte ve beyaz bir kenarlığa sahip olur.

Bu olay, oyuncunun dokunmatik özellikli bir cihaz kullanarak UI öğesi üzerinde parmağını tutmasının ardından kısa bir süre içinde tetiklenir. Olay, jestteki parmakların ilgili ekran konumlarını tanımlayan `Datatype.Vector2` tablosu ile tetiklenir. Ayrıca, birden fazla kez tetiklenir: `Enum.UserInputState.Begin` kısa bir gecikmeden sonra, `Enum.UserInputState.Change` eğer oyuncu jest sırasında parmağını hareket ettirirse ve nihayetinde `Enum.UserInputState.End`. Gecikme platforma bağlıdır; Studio'da bir saniyeden biraz daha uzun sürer.

GuiObject.TouchLongPress

touchPositions

Girişte yer alan parmakların **nispeten** pozisyonlarını tanımlayan `Datatype.Vector2` türünde bir dizi.

state

`Enum.UserInputState` girişi durumunu tanımlar:

- Begin, girişin başlangıcında bir kez ateşlenir (kısa bir gecikmeden sonra)
- Change, oyuncu basılı tutarken parmağını hareket ettirdiğinde ateşlenir
- End, oyuncu parmağını kaldırdığında girişin sonunda bir kez ateşlenir.

Oyuncu UI öğesine uzun basmaya başladığında, devam ettiğinde ve bıraktığında ateşlenir.

Bu kod örneği, dış bir `Frame` içinde yer alan bir iç `Frame`'de bir `LocalScript` içine yerleştirilmek üzere tasarlanmıştır. Oyuncunun, dış çerçevenin üzerinde parmağını hareket ettirerek iç çerçevenin konumunu manipüle etmesine olanak tanır.

Bu olay, oyuncunun dokunmatik özellikli bir cihaz kullanarak UI öğesi üzerinde parmağını hareket ettirmesi durumunda tetiklenir. Olay, `Class.GuiObject.TouchSwipe` olayından hemen önce tetiklenir ve `Class.GuiObject.TouchTap` ile tetiklenmez. Bu olay, oyuncunun ekran üzerindeki UI öğelerinin konumunu manipüle etmesine olanak sağlamak için faydalıdır.

Bu olay, jestteki parmakların ilgili ekran konumlarını tanımlayan `Datatype.Vector2` tablosu ile tetiklenir. Ayrıca, birden fazla kez tetiklenir: `Enum.UserInputState.Begin` kısa bir gecikmeden sonra, `Enum.UserInputState.Change` oyuncu jest sırasında parmağını hareket ettirdiğinde ve nihayetinde `Enum.UserInputState.End` ile.

GuiObject.TouchPan

Bir Luau dizisi olan `Datatype.Vector2` nesneleri, girişte yer alan parmakların her birinin konumunu belirtir.

totalTranslation

Pan girişinin başlangıç noktasından ne kadar ilerlediğini gösterir.

velocity

Girişin her boyutta ne kadar hızlı yapıldığını gösterir.

`Enum.UserInputState` girişin durumunu belirtir.

Oyuncu UI öğesi üzerinde parmağını hareket ettirdiğinde ateşlenir.

Bu kod örneği, içteki bir `Frame` içinde ve dıştaki bir `Frame` veya diğer `GuiObject` içinde yer alan bir `LocalScript` için tasarlanmıştır. Oyuncunun dış çerçeve üzerinde bir `Class.GuiObject.TouchPinch` hareketi gerçekleştirerek iç çerçeveyi ölçeklendirmesine olanak tanır.

Bu olay, oyuncunun dokunmatik özellikli bir cihaz kullanarak UI öğesi üzerinde iki parmakla sıkıştırma veya çekme jesti yapması durumunda tetiklenir. **Sıkıştırma**, iki veya daha fazla parmağın daha yakın hareket etmesiyle gerçekleşir ve **çekme**, parmakların uzaklaşması durumunda gerçekleşir. Bu olay, `Class.GuiObject.TouchPan` ile birlikte tetiklenir. Bu olay, oyuncunun ekran üzerindeki UI öğelerinin ölçeğini (boyutunu) manipüle etmesine olanak sağlamak için faydalıdır ve en sık yakınlaştırma özellikleri için kullanılır.

Bu olay, jestteki parmakların ilgili ekran konumlarını tanımlayan `Datatype.Vector2` tablosu ile tetiklenir. Ayrıca, birden fazla kez tetiklenir: `Enum.UserInputState.Begin` kısa bir gecikmeden sonra, `Enum.UserInputState.Change` oyuncu jest sırasında bir parmağını hareket ettirdiğinde ve nihayetinde `Enum.UserInputState.End` ile. Ölçeklemenin **çarpan** olarak kullanılması gerektiği belirtilmelidir.

GuiObject.TouchPinch

Bir Luau dizisi olan `Datatype.Vector2` nesneleri, sıkıştırma hareketine dahil olan parmakların her birinin konumunu belirtir.

scale

Sıkıştırma hareketinin başlangıcından bu yana farkı gösteren bir float.

Sıkıştırma hareketinin ne kadar hızlı yapıldığını gösteren bir float.

Oyuncu, UI öğesi üzerinde iki parmakla bir sıkıştırma veya çekme hareketi yaptığında ateşlenir.

Bu kod örneği, bir iç `Frame` içinde bulunan bir `LocalScript` için tasarlanmıştır
ve dış bir `Frame` veya başka bir `GuiObject` içindedir. Bu, oyuncunun dış çerçeve üzerinde
`Class.GuiObject.TouchRotate` hareketi yaparak iç çerçeveyi döndürmesine olanak tanır.


Bu olay, oyuncunun dokunmatik özellikli bir cihaz kullanarak UI öğesi üzerinde iki parmakla sıkıştırma veya çekme jesti yapması durumunda tetiklenir. İki parmak arasındaki çizginin açısının değişmesi durumda döndürme gerçekleşir. Bu olay, `Class.GuiObject.TouchPan` ile birlikte tetiklenir. Bu olay, oyuncunun ekran üzerindeki UI öğelerinin döndürülmesini manipüle etmesine olanak sağlamak için faydalıdır.

Bu olay, jestteki parmakların ilgili ekran konumlarını tanımlayan `Datatype.Vector2` tablosu ile tetiklenir. Ayrıca, birden fazla kez tetiklenir: `Enum.UserInputState.Begin` kısa bir gecikmeden sonra, `Enum.UserInputState.Change` oyuncu jest sırasında bir parmağını hareket ettirdiğinde ve nihayetinde `Enum.UserInputState.End` ile.

GuiObject.TouchRotate

rotation

Bir float, girişin başlangıcından bu yana ne kadar döndüğünü gösterir.

Bir float, hareketin ne kadar hızlı yapıldığını gösterir.

`Enum.UserInputState` hareketin durumunu belirtir.

Oyuncu, UI öğesi üzerinde iki parmak kullanarak bir döndürme hareketi yaptığında ateşlenir.

Bu kod örneği, dokunmatik özellikli bir cihazda (veya Studio'nun emülatöründe) bir
kaydırma hareketi yapıldığında bir `Frame`'in (veya diğer `GuiObject`'lerin) zıplamasına neden olacaktır.
Yatay kaydırmalar, `Class.GuiObject.BackgroundColor3`'ün rengini değiştirirken,
dikey kaydırmalar ise yoğunluğu değiştirecektir.

Bu olay, oyuncunun dokunmatik özellikli bir cihaz kullanarak UI öğesi üzerinde kaydırma jesti gerçekleştirmesi durumunda tetiklenir. Olay, jestin yönü (Yukarı, Aşağı, Sol veya Sağ) ve jestte yer alan dokunma noktalarının sayısıyla tetiklenir. Kaydırma jestleri, mobil kullanıcı arayüzlerinde sekmeleri değiştirmek için sık sık kullanılır.

GuiObject.TouchSwipe

swipeDirection

Kaydırma hareketinin yönünü gösteren bir `Enum.SwipeDirection` (Yukarı, Aşağı, Soldan veya Sağa).

numberOfTouches

Hareketle ilgili dokunma noktalarının sayısı (genellikle 1).

Oyuncu, UI öğesi üzerinde bir kaydırma hareketi yaptığında ateşlenir.

Bu kod örneği, bir UI öğesinin, örneğin bir `Frame`'in, bir dokunmatik cihazda üzerine tıklanıldığında `Class.GuiObject.BackgroundTransparency` değerini değiştirir.

Bu olay, oyuncunun dokunmatik özellikli bir cihaz kullanarak UI öğesi üzerinde dokunma jesti gerçekleştirmesi durumunda tetiklenir. Dokunma, herhangi bir hareket olmaksızın hızlı bir tek dokunuş (daha uzun bir basma, `Class.GuiObject.TouchLongPress` olayını tetikler ve dokunma sırasında hareket etmek, `Class.GuiObject.TouchPan` ve/veya `Class.GuiObject.TouchSwipe` olaylarını tetikler) şeklinde gerçekleşir. Olay, jestteki parmakların ilgili konumlarını tanımlayan `Datatype.Vector2` nesneleri ile tetiklenir.

GuiObject.TouchTap

Girişte yer alan parmakların **nispeten** pozisyonlarını tanımlayan `Datatype.Vector2` dizisi.

Oyuncu, UI öğesi üzerinde bir dokunma hareketi yaptığında ateşlenir.

Bu kod örneği, bir geri çağırma fonksiyonu tanımlayarak tween'in tamamlandığını/iptal edildiğini tespit eden
TweenPosition kullanımının daha karmaşık bir örneğini göstermektedir. Ayrıca tween'in oynatılıp oynatılmayacağını yazdırır.

Bir GUI'yi belirtilen zaman içinde belirtilen `Enum.EasingDirection` ve `Enum.EasingStyle` kullanılarak yeni bir `Datatype.UDim2` konumuna düzgün bir şekilde taşır.

Bu işlev, tween'in oynayıp oynamayacağını döndürür. `false` ayarlandığında ve başka bir tween `Class.GuiObject` üzerinde işlem yapıyorsa çalışmayacaktır.

Ayrıca `Class.GuiObject:TweenSize()` ve `Class.GuiObject:TweenSizeAndPosition()`'ı inceleyin.

GuiObject:TweenPosition

endPosition

easingDirection

GUI'yi _endPosition_'a doğru kolaylaştırma yönü.

easingStyle

GUI'yi _endPosition_'a doğru kolaylaştırma tarzı.

time

Tween'in tamamlanması için gereken süre, saniye cinsinden.

override

Tween, devam eden bir tweeni geçersiz kılacak mı.

callback

Tween tamamlandığında çalıştırılacak bir geri çağırma işlevi.

Bir GUI'yi yeni bir `Datatype.UDim2` konumuna düzgün bir şekilde taşır.

Bu kod örneği, `Class.GuiObject:TweenSize()`
fonksiyonunun kullanımını göstermektedir. Bu, ebeveynin `Class.GuiObject.Size`
özelliğinde `UDim2.new(0.5, 0, 0.5, 0)` animasyonunu başlatır; bu, `GuiObject`
un ebeveyni üzerindeki her iki eksende yarım boyuttur.

Ayrıca, tweenin durduğunu (başka bir tween tarafından iptal edilip edilmediğini ya da tamamlanıp tamamlanmadığını) tespit etmek için callback parametresinin nasıl kullanılacağını da göstermektedir.

`Class.GuiObject`'u belirtilen zaman içinde belirlenen `Enum.EasingDirection` ve `Enum.EasingStyle` kullanarak yeni bir `Datatype.UDim2` ile düzgün bir şekilde boyutlandırır.

Bu işlev, tween'in oynayıp oynamayacağını döndürür. Genellikle bu her zaman `true` döndürür, ancak başka bir tween aktif olduğunda ve geçersiz kılma `false` olarak ayarlandığında `false` döndürür.

Ayrıca `Class.GuiObject:TweenSize()` ve `Class.GuiObject:TweenSizeAndPosition()`'ı inceleyin.

GuiObject:TweenSize

endSize

GUI'nin yeniden boyutlandırması gereken boyut.

GUI'yi _endSize_'a doğru kolaylaştırma yönü.

GUI'yi _endSize_'a doğru kolaylaştırma tarzı.

`Class.GuiObject`'u yeni bir `Datatype.UDim2` ile düzgün bir şekilde yeniden boyutlandırır.

Aşağıdaki örnek, bir `Class.Frame`'i ebeveynin
boyutunun sol üstüne tween edecektir ve boyutunu 0'a küçültecektir.

Bir GUI'yi belirli süre içinde belirtilen `Enum.EasingDirection` ve `Enum.EasingStyle` kullanarak yeni bir `Datatype.UDim2` boyut ve konumuna düzgün bir şekilde taşır.

Bu işlev, tween'in oynayıp oynamayacağını döndürür. Genellikle bu her zaman `true` döndürür, ancak başka bir tween aktif olduğunda ve geçersiz kılma `false` olarak ayarlandığında `false` döndürür.

Ayrıca `Class.GuiObject:TweenSize()` ve `Class.GuiObject:TweenSizeAndPosition()`'ı inceleyin.

GuiObject:TweenSizeAndPosition

GUI'yi _endSize_ ve _endPosition_'a doğru kolaylaştırma yönü.

GUI'yi _endSize_ ve _endPosition_'a doğru kolaylaştırma tarzı.

Bir GUI'yi yeni bir boyut ve konuma düzgün bir şekilde taşır.

GuiObject

Bu kod örneği, Activated olayının debounce olarak Active özelliğinin kullanımını göstermektedir.

Bu özellik, `Class.GuiObject`'un 3D alanına, örneğin arka plandaki `Class.ClickDetector` sınıfına ait modellere giriş yapıp yapmayacağını belirler.

`Class.GuiButton` nesneleri (`Class.ImageButton` ve `Class.TextButton`), bu özellik `Class.GuiButton.Activated|Aktif` olayının tetiklenip tetiklenmeyeceğini belirler (`Class.GuiButton.AutoButtonColor|OtomatikButonRengi` hala çalışacaktır). Bu özelliğin değeri ne olursa olsun, `Class.GuiObject.InputBegan|GirişBaşladı`, `Class.GuiObject.InputChanged|GirişDeğişti`, ve `Class.GuiObject.InputEnded|GirişBitti` olayları normal şekilde çalışır.

GuiObject.Active

Bu UI öğesinin giriş alıp almadığını belirler.

Bu kod örneği bir UI öğesini ebeveyn öğesinin farklı kenarlarına taşır.
Sol üstte başlar ve sağ alt köşede biter. Bir
LocalScript'e, bir Frame içinde, bir ScreenGui'de yapıştırın.

Bu özellik, `Class.GuiObject`'un kesin boyutuna göre kök noktasını belirler. Kök noktası, öğenin nasıl konumlandırıldığını (yani, `Class.GuiObject.Position` ile) ve hangi noktadan itibaren `Class.GuiObject.Size` genişleyeceğini belirler.

Ayrıntılı diyagramlar ve bilgiler için [burayı](/ui/position-and-size#anchorpoint) ziyaret edin.

GuiObject.AnchorPoint

`Class.GuiObject`'un, kesin boyutuna göre kök noktasını belirler.

Aşağıdaki betik, otomatik boyutlandırılan bir ana çerçeve oluşturur ve
a`UIListLayout` içerir, ardından birkaç otomatik boyutlandırılan `TextLabel`
nesnesi ekler. Ana `UIListLayout`'ın alt öğe içeriğine uyacak şekilde
otomatik olarak boyutlandığını ve etiketlerin metin içeriğine uyacak şekilde otomatik
yeniden boyutlandığını not edin. Bu betik bir `ScreenGui`'ye eklenebilir.

Bu özellik, üstteki UI nesnelerinin boyutunu, çocuklarının boyutuna göre otomatik olarak ayarlamak için kullanılır. Bu özelliği, bir UI nesnesine düzenleme veya çalışma zamanında dinamik olarak tekst ve diğer içerikler eklemek için kullanabilirsiniz, boyut buna göre ayarlanacaktır.

`Class.GuiObject.AutomaticSize|OtomatikBoyut` değeri `Enum.AutomaticSize`'da `Enum.AutomaticSize|Yok` dışında bir değer olduğunda, bu UI nesnesi çocuk içeriğine bağlı olarak yeniden boyutlandırılabilir.

Bu özelliği nasıl kullanabileceğiniz ve nasıl çalıştığı hakkında daha fazla bilgi için lütfen [burayı](/ui/size-modifiers#automatic-sizing) inceleyin.

GuiObject.AutomaticSize

Çocuk içeriğine göre yeniden boyutlandırma olup olmayacağını belirler.

`Class.GuiObject` arka plan rengini belirler.

GuiObject.BackgroundColor

Bu kod örneği, bir ana Çerçevenin Rainbow'un tüm renkleri arasında döngü oluşturmasını sağlar
Color3.fromHSV kullanarak.

`Class.GuiObject` arka plan rengini (doldurma rengi) belirler. Eğer öğeniz bir `Class.TextBox`, `Class.TextButton` veya `Class.TextLabel` içeriyorsa, arka plan renginizin metin renginizle kontrast oluşturduğundan emin olun.

Arka planın görsel özelliklerini belirleyen diğer bir özellik ise `Class.GuiObject.BackgroundTransparency`; eğer bu değer `1` olursa, ne arka plan ne de kenarlık render edilir.

Ayrıca `Class.GuiObject.BorderColor3|KenarRengi3` özelliklerini de inceleyin.

GuiObject.BackgroundColor3

`Class.GuiObject` arka plan ve kenarlık saydamlığını belirler. Ancak, bu özellik `Class.TextBox`, `Class.TextButton`, veya `Class.TextLabel` gibi GUI nesnelerindeki metnin saydamlığını belirlemez; metin saydamlığı sırasıyla `Class.TextBox.TextTransparency`, `Class.TextButton.TextTransparency`, ve `Class.TextLabel.TextTransparency` ile belirlenir.

Eğer bu özellik `1` olarak ayarlanırsa, ne arka plan ne de kenarlık render edilir ve GUI arka planı tamamen saydam olur.

GuiObject.BackgroundTransparency

`Class.GuiObject` arka plan ve kenarlık saydamlığını belirler.

`Class.GuiObject` kenarlık rengini belirler.

GuiObject.BorderColor

Bu kod örneği, bir ana GuiObject'in kenarlığının, kullanıcı fareyle öğenin üzerine geldiğinde vurgulanmasını sağlar.

`Class.GuiObject` dikdörtgen kenarlık rengini (strok rengi olarak da bilinir) belirler. Bu, nesnenin `Class.GuiObject.BackgroundColor3`'ünden farklıdır. Eğer `Class.GuiObject.BorderSizePixel` özelliği `0` olarak ayarlanırsa, nesnenin kenarlığını göremezsiniz.

Not: `Class.UIStroke` bileşeni daha karmaşık kenarlık efektleri sağlar.

GuiObject.BorderColor3

Tüm 2D kullanıcı arayüzü nesneleri için soyut bir sınıf.