Bir `Class.ImageButton`, render ile ilgili olarak `Class.ImageLabel` ile benzer şekilde davranır,
udaki `Class.GuiButton`'ın ek davranışları ile birlikte.


ImageButton

`Class.ImageButton` üzerindeyken kullanılacak bir doku kimliği.


ImageButton.HoverImage

`Class.ImageButton` özelliği olarak ayarlanabilen bir görüntü tipi İçerik. Butona fareyle üstüne gelindiğinde, bu görüntü render edilecektir. Bu özellik için yalnızca varlık URI'leri desteklenmektedir.


ImageButton.HoverImageContent

`Class.ImageButton` üzerindeyken kullanılacak görüntü içeriği. Sadece varlık URI'lerini destekler.


Bu kod örneği, bir ImageLabel/ImageButton'ın kırmızı bir kilidi göstermesini sağlar.
Fare üzerine gelindiğinde, yeşil açılmış kilide dönüşür.

Bu özellik, Roblox'a yüklenmiş bir dekore veya görüntünün varlık kimliğini tutması gereken bir içerik türü özelliğidir. Roblox'tan görüntüyü yükleme açısından `Class.Decal.Texture` ile aynı şekilde çalışır. Render edilen görüntü, `Class.ImageButton.ImageColor3|ImageColor3` kullanılarak boyanacaktır.

Görüntünün döşeme, sığacak şekilde ölçeklenmesi veya 9 dilimlenmesi mümkün olduğunu unutmayın; bu, `Class.ImageButton.ScaleType|ScaleType` özelliğini ayarlayarak yapılabilir.


ImageButton.Image

`Class.ImageButton` öğesi tarafından görüntülenen görüntü içeriği. `Class.ImageButton.ImageContent|ImageContent`'a okunur ve yazılır.


Bu özellik, bir görüntünün nasıl boyanacağını belirler. Beyaz olarak ayarlandığında, hiç boyama gerçekleşmez. Bu özellik, görüntü varlıklarını yeniden kullanmak için oldukça yararlıdır: Kaynak görüntü tamamen beyaz ve şeffafsa, bu özellik ile görüntünün tamamının rengini birden ayarlayabilirsiniz.


ImageButton.ImageColor3

Render edilen görüntünün nasıl boyanacağını belirler.


Bu özellik, bir [varlık URI'si](/projects/assets#asset-uris) veya `Class.EditableImage` nesnesine referans tutmalıdır. Varlık URI'si, Roblox'a yüklenmiş bir dekore veya görüntüyü referans alabilir. Görüntü yüklemede, `Class.Decal.Texture` ile aynı şekilde çalışır.

Render edilen görüntü, `Class.ImageButton.ImageColor3|ImageColor3` kullanılarak boyanacaktır. Görüntüyü döşeme, sığacak şekilde ölçeklenmesi veya 9 dilimlenmesi mümkündür; bu, `Class.ImageButton.ScaleType|ScaleType` özelliğini ayarlayarak yapılabilir.


ImageButton.ImageContent

Kullanıcı arayüzü öğesi tarafından görüntülenen görüntü içeriği. Varlık URI'lerini ve `Class.EditableImage` nesnelerini destekler.


Bu kod örneği, bir adamın yumruk attığı bir animasyonu oynamak için ImageRectOffset/ImageRectSize kullanır.

Bu özellik, görüntü alanının gösterilecek piksel kaymasını (sol üstten) belirler ve `Class.ImageButton.ImageRectSize|ImageRectSize` ile birlikte bir görüntünün kısmi gösterimine olanak tanır.


ImageButton.ImageRectOffset

Görüntüde gösterilecek alt alanın piksel cinsinden kayması.


Bu özellik, gösterilecek görüntü alanının piksel boyutunu belirler ve `Class.ImageButton.ImageRectOffset|ImageRectOffset` ile birlikte bir görüntünün kısmi gösterimine olanak tanır. Herhangi bir boyut `0`'a ayarlanırsa, tüm görüntü gösterilir.


ImageButton.ImageRectSize

Gösterilecek görüntü alt alanının piksel cinsinden boyutunu belirler.


Bu özellik, öğenin render edilen görüntüsünün alfa değerini belirler. `0` değeri tamamen opak, `1` değeri tamamen şeffaf (görünmez) anlamına gelir. Bu özellik, `Class.GuiObject.BackgroundTransparency` veya `Class.BasePart.Transparency` ile benzer şekilde davranır.

Eğer `Class.ImageButton.ImageTransparency|ImageTransparency` değerini `1` yaparak görüntü render etmeyi devre dışı bırakırsanız, bu, bir düğme olarak kullanılabilen düz bir dikdörtgenle sonuçlanır. Ancak, boş bir `Class.TextButton` kullanmak daha iyi olabilir.


ImageButton.ImageTransparency

Render edilen görüntünün şeffaflığını belirler.


Bu kod örneği, bir ImageLabel veya ImageButton'ın
bir görüntüyü yüklemesi için ne kadar sürdüğünü ölçer. Görüntü zaten yüklüyse, bu 0 olacaktır.

Bu özellik, `Class.ImageButton.Image|Image` özelliğinin Roblox'tan yüklemeyi tamamlayıp tamamlamadığını gösterir. Moderasyon tarafından reddedilen görüntüler asla yüklenmeyecektir.


ImageButton.IsLoaded

Görüntü, Roblox web sitesinden yüklemeyi tamamlayıp tamamlamadığını gösterir.


Bir `Class.ImageButton` özelliği olarak ayarlanabilen bir doku kimliği. Buton basıldığında, bu görüntü render edilecektir.


ImageButton.PressedImage

`Class.ImageButton` üzerine basıldığında kullanılacak bir doku kimliği.


`Class.ImageButton` özelliği olarak ayarlanabilen bir görüntü tipi İçerik. Buton basıldığında, bu görüntü render edilecektir. Bu özellik için yalnızca varlık URI'leri desteklenmektedir.


ImageButton.PressedImageContent

`Class.ImageButton` basıldığında kullanılacak görüntü içeriği. Sadece varlık URI'lerini destekler.


Görüntünün nasıl görüneceğini belirler. Varsayılan olarak, görüntü, teknik hafızadaki boyutundan daha büyük veya daha küçük gösterildiğinde dokuyu yumuşatır. Aksine, `Enum.ResamplerMode.Pixelated|Enum.ResamplerMode.Pixelated` görüntü piksellerinin keskin kenarlarını korur.


ImageButton.ResampleMode

Buton için görüntü yeniden örnekleme modunu seçer.


Bu özellik, UI öğesinin mutlak boyutu kaynak görüntünün boyutundan farklı olduğunda `Class.ImageButton.Image|Image` özelliğinin nasıl render edileceğini belirler.

Varsayılan olarak, bu özellik `Enum.ScaleType.Stretch|Enum.ScaleType.Stretch`'dir, bu da görüntü boyutlarının tam olarak UI öğesinin alanına uyması için gerileceği veya sıkıştırılacağı anlamına gelir. Şeffaf pikseller Roblox'a yüklenirken siyah olarak ayarlandığından, şeffaf görüntüler ölçeklendirilmiş görüntüler etrafında siyahımsı bir kenar olmaması için alfa karışımını uygulamalıdır.

`Enum.ScaleType.Slice` için, ölçeklendirme yapıldığında köşelerin kaynak görüntü boyutunu koruyacaktır. Görüntünün kenarları, görüntü genişliğine/yüksekliğine uzatılacaktır. Son olarak, görüntünün merkezi görüntünün merkez alanını doldurmak için uzatılacaktır. 9 dilimlenmiş görüntüler hakkında daha fazla bilgi edinmek için [UI 9 Dilim Tasarımı](/ui/9-slice) sayfasına bakın.

`Enum.ScaleType.Tile` için, her görüntü karosunun boyutu `Class.ImageButton.TileSize|TileSize` özelliği tarafından belirlenir.


ImageButton.ScaleType

Görüntünün, kaynak görüntüden farklı bir boyuta sahip UI öğesinde gösterildiğinde, nasıl ölçeklendirileceğini belirler.


Bu özellik, `Class.ImageButton.ScaleType|ScaleType` 9 dilimlenmiş bir görüntüye ayarlandığında 9 dilimlenmiş görüntünün dilim sınırlarını belirler.

9 dilimlenmiş görüntüler hakkında daha fazla bilgi edinmek için [UI 9 Dilim Tasarımı](/ui/9-slice) sayfasına bakın.


ImageButton.SliceCenter

9 dilimlenmiş bir görüntünün dilim sınırlarını ayarlar.


9 dilim kenarlarını belirtilen oranla ölçeklendirir. Bu, 9 dilimin etrafındaki kenarların, yeni bir sürümünü yüklemişsiniz gibi büyüyeceği anlamına gelir. Varsayılan değeri `1.0`'dır.

9 dilim kenarları için bir çarpan olarak, birden fazla yarı çapı için tek bir yuvarlatılmış köşe görüntüsünün yeniden kullanılmasına yardımcı olabilir.

Ayrıca, kaynak görüntüden farklı bir boyuta sahip bir UI öğesinde görüntünün nasıl ölçeklendirileceğini belirleyen `Class.ImageButton.ScaleType|ScaleType` ile ilişkili olduğuna dikkat edin.


ImageButton.SliceScale

9 dilim kenarlarını belirtilen oranla ölçeklendirir.


`Class.ImageButton`'un döşeme boyutunu, görüntünün sol üst köşesinden başlayarak ayarlar. Varsayılan `Datatype.UDim2` değerleri <Typography
noWrap>`1, 0, 1, 0`</Typography>; `Datatype.UDim2`'nin ölçek bileşenleri `Class.ImageButton`'un boyutuna bağlı olarak döşemeyi ölçeklendirecektir, offset bileşenleri ise ham pikseldir. Örneğin, `0.5` ölçeği, karonun, ilgili eksende `Class.ImageButton`'un yarısı kadar büyük olacağı anlamına gelir.

Bu özellik, yalnızca `Class.ImageButton.ScaleType|ScaleType` özelliği `Enum.ScaleType.Tile` olarak ayarlanmışsa aktiftir.


ImageButton.TileSize

ImageButton'un döşeme ölçeğini ayarlar.


Etkileşimli bir görüntü gösteren 2D kullanıcı arayüzü öğesi.


`Class.GuiButton`, `Class.GuiObject`'tan miras alan 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ış için birkaç özellik tanımlar, yani
`Class.GuiButton.AutoButtonColor|AutoButtonColor`
vve `Class.GuiButton.Modal|Modal`.

Bir `Class.GuiButton`'ın en önemli olayı
`Class.GuiButton.Activated|Activated`'dır, bu, **çoklu platform olayıdır**
buton aktif edildiğinde tetiklenir. Bir fare kullanırken, bu kazanılanın
ok işaretinin hala UI nesnesinin üzerinde olduğu durumda butona tıklamak ve
serbest bırakmak anlamına gelir. Dokunma için, aynı şey geçerlidir fakat
buton basılması yerine dokunma gereklidir. Son olarak, oyun kumandaları için,
`Class.GuiButton.Activated|Activated`, **A** tuşuna basıldığında ve
serbest bırakıldığında seçilen `Class.GuiButton` için tetiklenir. Kısacası,
bu olay, tek bir kullanıcı girdisi için hoş bir genel arayüz sağladığı için
çoklu platform kullanıcı arayüzü programlama için çok yararlıdır.


Buton aktif edildiğinde tetiklenir. Bu olay sunucuda tetiklenmediği için,
bir `Class.LocalScript` içinde veya `Class.Script`
in `Class.Script.RunContext|RunContext`
`Enum.RunContext.Client` olduğunda kullanılmalıdır.


GuiButton.Activated

inputObject

clickCount

Bu olay, kullanıcının farenin tam sol tıklaması yaptığında
`Class.GuiButton` üzerinde tetiklenir.

Tıklama ile ilgili olarak, fare `Class.GuiButton` sınırları içinde olmalı
ve fare tuşu basılıp bırakılmadan önce bu olayın tetiklenmesi gerekir.
Eğer fare, `Class.GuiButton` sınırları dışına çıkarsa ve bırakılırsa,
ovay tetiklenmeyecektir. Bu sınırlamadan kaçınmak istiyorsanız,
`Class.GuiButton.MouseButton1Down|MouseButton1Down`
vaf `Class.GuiButton.MouseButton1Up|MouseButton1Up` kullanabilirsiniz; bu olaylar
benzer ancak kullanıcının sol fare tuşuna basılı veya bırakıldığında tetiklenecektir.


GuiButton.MouseButton1Click

Kullanıcının farenin tam sol tıklaması yaptığında tetiklenir
`Class.GuiButton` üzerinde.


Bu olay, kullanıcı sol fare tuşuna bastığında tetiklenir
`Class.GuiButton` üzerinde.

Bir olayın tetiklenmesi için kullanıcının **ve** sol fare tuşuna basıp
bırakması gerekiyorsa, `Class.GuiButton.MouseButton1Click|MouseButton1Click`
kullanmayı düşünebilirsiniz.


GuiButton.MouseButton1Down

Fareniin **X** ekran koordinatı piksel cinsinden.


Fareniin **Y** ekran koordinatı piksel cinsinden.


Kullanıcı sol fare tuşuna basıldığında tetiklenir
`Class.GuiButton` üzerinde.


Bu olay, kullanıcı sağ fare tuşunu `Class.GuiButton`
üstünde bıraktığında tetiklenir.

Bir olayın tetiklenmesi için kullanıcının **ve** sağ fare tuşuna basılıp
bırakması gerekiyorsa, `Class.GuiButton.MouseButton2Click|MouseButton2Click`
kullanmayı düşünebilirsiniz.


GuiButton.MouseButton1Up

Kullanıcı sağ fare tuşunu `Class.GuiButton`
üstünde bıraktığında tetiklenir.


Bu olay, kullanıcının farenin tam sağ tıklaması yaptığında
`Class.GuiButton` üzerinde tetiklenir.

Tıklama ile ilgili olarak, fare `Class.GuiButton` sınırları içinde olmalı
ve fare tuşu basılıp bırakılmadan önce bu olayın tetiklenmesi gerekir.
Eğer fare `Class.GuiButton` sınırları dışına çıkarsa ve bırakılırsa,
ovay tetiklenmeyecektir. Bu sınırlamadan kaçınmak istiyorsanız,
`Class.GuiButton.MouseButton2Down|MouseButton2Down`
vaf `Class.GuiButton.MouseButton2Up|MouseButton2Up` kullanabilirsiniz; bu olaylar
benzer ancak kullanıcının sağ fare tuşuna basılı veya bırakıldığında tetiklenecektir.


GuiButton.MouseButton2Click

Kullanıcının farenin tam sağ tıklaması yaptığında tetiklenir
`Class.GuiButton` üzerinde.


Bu olay, kullanıcı sağ fare tuşuna bastığında tetiklenir
`Class.GuiButton` üzerinde.

Bir olayın tetiklenmesi için kullanıcının **ve** sağ fare tuşuna basıp
bırakması gerekiyorsa, `Class.GuiButton.MouseButton2Click|MouseButton2Click`
kullanmayı düşünebilirsiniz.


GuiButton.MouseButton2Down

Kullanıcı sağ fare tuşuna basıldığında tetiklenir
`Class.GuiButton` üzerinde.


GuiButton.MouseButton2Up

GuiButton

Bu özellik, kullanıcının `Class.Mouse` fare hareketi ile
butonun üzerine geldiğinde veya tıkladığında otomatik olarak renk
değiştirip değiştirmediğini belirler. `true` ise, buton fare üzerine
geldiğinde veya tıkladığında otomatik olarak renk değiştirecektir. `false`
ise, buton değişmeyecektir.

Eğer kullanıcının farenin butonunun üzerine geldiği veya tıkladığında
butonun nasıl değişeceğini özelleştirmek istiyorsanız, bir
`Class.ImageButton` kullanmayı ve öğenin `Class.ImageButton.HoverImage|HoverImage`
vve `Class.ImageButton.PressedImage|PressedImage`'ini değiştirmeyi
düşünebilirsiniz.

Lütfen bu özelliğin, bir `Class.ImageButton` üzerinde, `Class.ImageButton.Image|Image`
özelliği bir resim olarak ayarlandığında etkili olmayacağını unutmayın.
Ayrıca, bu özellik bir `Class.ImageButton` üzerinde, `Class.ImageButton.HoverImage|HoverImage`
`nil` değilse fare üzerine geldiğinde veya `Class.ImageButton.PressedImage|PressedImage`
`nil` değilse fare tıklamasında etki etmeyecektir.


GuiButton.AutoButtonColor

Fare üzerine geldiğinde veya tıkladığında butonun otomatik olarak renk
değiştirip değiştirmediğini belirler.


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


GuiButton.HoverHapticEffect

`true` ise ve GUI öğesi görünüyorsa, fare kilitlenmeyecek
sağ fare tuşu basılmadıkça.


GuiButton.Modal

`true` ise ve GUI öğesi görünüyorsa, sağ fare tuşu basılmadıkça,
fare kilitlenmeyecek.


Basılıyken çalacak bir `Class.HapticEffect`
örneği.


GuiButton.PressHapticEffect

Nesnenin seçilip seçilmediğini gösteren bir boolean özelliği.


GuiButton.Selected

`Class.GuiButton`'ın belirlenmiş bir stil listesini temel alarak
stilini ayarlar.


GuiButton.Style

Etkileşimli 2D kullanıcı arayüzü öğeleri 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

Kullanıcı girişinin sorgulanması için yararlı veriler içeren bir `Class.InputObject`, `Enum.UserInputType|giriş türü`, `Enum.UserInputState|giriş durumu`, ve `Class.InputObject.Position|girişin ekran koordinatları` gibi bilgileri içerir.


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

Kullanıcı girişinin sorgulanması için yararlı veriler içeren bir `Class.InputObject`, `Enum.UserInputType`, `Enum.UserInputState`, ve `Class.InputObject.Position` gibi bilgileri içerir.


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, oyuncu bir dokunmatik cihaz kullanarak UI öğesine parmağını tuttuğunda kısa bir süre sonra ateşlenir. Bu, girişi kapsayan `Datatype.Vector2` tablosu ile birlikte ateşlenir. Ayrıca, birkaç kez ateşlenir: `Enum.UserInputState.Begin` kısa bir gecikmeden sonra,
`Enum.UserInputState.Change` oyuncu hareket ettiğinde ve nihayet `Enum.UserInputState.End`. Gecikme platforma bağlıdır; Studio'da bir dakikadan bir saniye kadar biraz daha uzun sürer.

Bu olay sadece bir parmak gerektirir, bu nedenle, bu olayı Studio'da emulator ve mouse ile simüle etmek mümkündür.


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, oyuncu bir dokunmatik cihaz kullanarak UI öğesi üzerinde parmağını hareket ettirdiğinde ateşlenir. Bu, `Class.GuiObject.TouchSwipe` olayından hemen önce ateşlenir ve `Class.GuiObject.TouchTap` ile ateşlenmez. Bu olay, oyuncunun ekran üzerindeki UI öğelerinin konumunu değiştirmesine izin vermek için faydalıdır.

Bu olay, girişte yer alan parmakların **nispeten** pozisyonlarını tahsil eden `Datatype.Vector2` tablosu ile birlikte ateşlenir. Ayrıca, birkaç kez ateşlenir: `Enum.UserInputState.Begin` kısa bir gecikmeden sonra, `Enum.UserInputState.Change` oyuncu hareket ettiğinde ve nihayet `Enum.UserInputState.End` ile.

Bu olay, Studio'da emulator ve mouse kullanılarak simüle edilemez; gerçek bir dokunmatik cihazınız olması gerekir.


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, oyuncu bir dokunmatik cihaz kullanarak UI öğesi üzerinde iki parmakla sıkıştırma veya çekme hareketi yaptığında ateşlenir. **Sıkıştırma**, iki veya daha fazla parmak daha yakınlaştığında meydana gelir, ve **çekme** parmaklar ayrıldığında meydana gelir. Bu olay, `Class.GuiObject.TouchPan` ile birlikte ateşlenir. Bu olay, oyuncunun ekran üzerindeki UI öğelerinin ölçeğini (boyutunu) manipüle etmesine izin vermek için faydalıdır ve çoğu zaman zoom özellikleri için kullanılır.

Bu olay, girişte yer alan parmakların **nispeten** pozisyonlarını tahsil eden `Datatype.Vector2` tablosu ile birlikte ateşlenir. Ayrıca, birkaç kez ateşlenir: `Enum.UserInputState.Begin` kısa bir gecikmeden sonra, `Enum.UserInputState.Change` oyuncu parmağını hareket ettirdiğinde ve sonunda `Enum.UserInputState.End` ile. Ölçeğin **çarpan** olarak kullanılması gerektiği belirtilmelidir.

Bu olay en az iki parmak gerektirdiğinden, bunu Studio'da emulator ve mouse ile simüle etmek mümkün değildir; gerçek bir dokunmatik cihazınız olması gerekir.


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, içteki bir `Frame` içinde bulunan bir `LocalScript` içindir
ve dıştaki bir `Frame` veya başka bir `GuiObject` içinde olmalıdır. Bu, oyuncunun iç çerçeveyi
çerçeveyi döndürmesine olanak tanır `Class.GuiObject.TouchRotate` jestiyle
ışık çerçevesi.

Bu olay, oyuncu bir dokunmatik cihaz kullanarak UI öğesi üzerinde iki parmakla bir döndürme hareketi yaptığında ateşlenir. İki parmak arasındaki doğru açısı değiştiğinde döndürme meydana gelir. Bu olay, `Class.GuiObject.TouchPan` ile birlikte ateşlenir. Bu olay, oyuncunun ekran üzerindeki UI öğelerinin döndürülmesini manipüle etmesine izin vermek için faydalıdır.

Bu olay, girişte yer alan parmakların **nispeten** pozisyonlarını tahsil eden `Datatype.Vector2` tablosu ile birlikte ateşlenir. Ayrıca, birkaç kez ateşlenir: `Enum.UserInputState.Begin` kısa bir gecikmeden sonra, `Enum.UserInputState.Change` oyuncu parmağını hareket ettirdiğinde ve nihayet `Enum.UserInputState.End` ile.

Bu olay en az iki parmak gerektirdiğinden, bunu Studio'da emulator ve mouse ile simüle etmek mümkün değildir; gerçek bir dokunmatik cihazınız olması gerekir.


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, oyuncu bir dokunmatik cihaz kullanarak UI öğesi üzerinde kaydırma hareketi yaptığında ateşlenir. Bu olay, hareketin yönünü (Yukarı, Aşağı, Soldan veya Sağa) ve hareketle ilgili dokunma noktalarının sayısını içeren bilgilerle birlikte ateşlenir. Kaydırma hareketleri genellikle mobil UI'lerde sekmeleri değiştirmek için kullanılır.

Bu olay yalnızca bir parmak gerektirdiğinden, Studio'da emulator ve mouse ile simüle edilebilir.


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, oyuncu bir dokunmatik cihaz kullanarak UI öğesi üzerinde bir dokunma hareketi yaptığında ateşlenir. Dokunma, hareket olmaksızın hızlı bir tek dokunuştur (uzun bir basma `Class.GuiObject.TouchLongPress` olayını ateşler, dokunma sırasında hareket `Class.GuiObject.TouchPan` ve/veya `Class.GuiObject.TouchSwipe` olayını ateşler). Bu olay, parmakların **nispeten** pozisyonlarını tanımlayan `Datatype.Vector2` nesneleri tablosu ile birlikte ateşlenir.

Bu olay yalnızca bir parmak gerektirdiğinden, Studio'da emulator ve mouse ile simüle edilebilir.


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


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


GuiObject

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


/reference/engine/classes/ImageButton.yaml