`InputActionLabel` is a drag-and-drop `Class.GuiObject` that automatically
shows the appropriate key or icon for an `Class.InputAction` based on the
player's current input device (keyboard/mouse, gamepad, touch, VR). When the
player switches devices or the binding is rebound, the label updates instantly
without scripting.

Rendering of the `InputActionLabel` depends on the `Class.InputAction` (linked
through `Class.InputActionLabel.InputAction`) and that action's child
`Class.InputBinding|InputBindings`. As the label resolves what to show, it
follows this order:

1. **Custom Images** — If child `Class.InputBinding|InputBindings` have their
   `Class.InputBinding.DisplayImage|DisplayImage` property set, the label
   renders those images directly, optionally modified by
   `Class.InputActionLabel.ImageColor3|ImageColor3` and
   `Class.InputActionLabel.ImageTransparency|ImageTransparency`.

2. **Platform Key Images** — Lacking custom images, the label renders
   platform-provided images for child `Class.InputBinding|InputBindings`
   through `Class.UserInputService:GetImageForKeyCode()`, if such images are
   available. Composite bindings with modifiers show multiple icons with `+`
   separators.

3. **Custom Names** — Lacking available images, if child
   `Class.InputBinding|InputBindings` have their
   `Class.InputBinding.DisplayName|DisplayName` property set, the label
   renders that text in a style defined by
   `Class.InputActionLabel.FontFace|FontFace`,
   `Class.InputActionLabel.TextColor3|TextColor3`,
   `Class.InputActionLabel.TextSize|TextSize`,
   `Class.InputActionLabel.TextTransparency|TextTransparency`,
   `Class.InputActionLabel.TextWrapped|TextWrapped`,
   `Class.InputActionLabel.TextXAlignment|TextXAlignment`, and
   `Class.InputActionLabel.TextYAlignment|TextYAlignment`.

4. **Platform Key Strings** — Lacking all of the above, the label renders
   platform-provided strings through
   `Class.UserInputService:GetStringForKeyCode()`.

5. If no `Class.InputAction` is assigned or no child `Class.InputBinding`
   exists, the label renders a placeholder icon.


InputActionLabel

This property is similar to `Class.TextLabel.FontFace` and determines the
font family, weight, and style used when the label renders in a text mode.


InputActionLabel.FontFace

Determines the font used to render text.


This property determines how label images are colorized. When set to
white, no colorization occurs. This property is useful for reusing image
assets; if the source images are completely white with transparency, you
can set the entire label color at once with this property.


InputActionLabel.ImageColor3

Determines how rendered label images will be colorized.


This property determines the alpha of rendered label images. A value of
`0` is completely opaque and a value of `1` is completely transparent
(invisible).


InputActionLabel.ImageTransparency

Determines the transparency of rendered label images.


The `Class.InputAction` instance for which to have the label automatically
resolve and display its preferred binding. When the binding changes (due
to rebinding or input device switching), the label updates automatically.

Setting this to `nil` clears the display and shows the placeholder.


InputActionLabel.InputAction

The `Class.InputAction` whose preferred binding this label displays.


Contains the `Datatype.Content` of the first resolved image when the label
renders in an image mode. Empty when in text or placeholder mode. This is
a read-only property set by the engine when the binding resolves.


InputActionLabel.ResolvedImageContent

Read-only. The resolved image content currently being displayed.


Contains the composed key name string such as `Ctrl + Shift + Space` when
the label renders in text mode. Empty when the label renders in image or
placeholder mode. This is a read-only property set by the engine when the
binding resolves.


InputActionLabel.ResolvedText

The resolved key name string currently being displayed.


This property determines the color of all text rendered by the label.


InputActionLabel.TextColor3

Controls the font size in pixels for text mode rendering. Value is clamped
between `1` and `200`.


InputActionLabel.TextSize

Determines the line height of text in offsets.


This property determines the transparency of all text rendered by the
label.


InputActionLabel.TextTransparency

Determines the transparency of rendered text.


When `true`, text renders on multiple lines within the label's space so
that `Class.InputActionLabel.TextSize|TextSize` lines never exceed the
`Class.GuiBase2d.AbsoluteSize` of the object. This is achieved by breaking
long lines of text into multiple lines.


InputActionLabel.TextWrapped

Determines if text wraps to multiple lines within the label's space.


This property determines the horizontal alignment of text rendered within
the label's space.


InputActionLabel.TextXAlignment

Determines the horizontal alignment of rendered text.


This property determines the vertical alignment of text rendered within
the label's space.


InputActionLabel.TextYAlignment

Determines the vertical alignment of rendered text.


A `Class.GuiObject` that automatically displays the keybinding for an action
as text or an image.


`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

Bu özellik, `Class.GuiObject` kenarlığının boyutlarına göre düzenlenme şeklini `Enum.BorderMode` enum'ı kullanarak belirler.

Not: `Class.UIStroke` bu özelliği geçersiz kılabilir ve daha karmaşık kenarlık efektleri sağlar.

GuiObject.BorderMode

`Class.GuiObject` kenarlığının boyutlarına göre nasıl yerleştirileceğini belirler.

`Class.GuiObject` kenarlığının piksel cinsinden ne kadar geniş render edileceğini belirler. Bunu `0` ayarlamak, kenarlığı tamamen devre dışı bırakır.

Not: `Class.UIStroke` bu özelliği geçersiz kılabilir ve daha karmaşık kenarlık efektleri sağlar.

GuiObject.BorderSizePixel

`Class.GuiObject` kenarlığının piksel genişliğini belirler.

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

/reference/engine/classes/InputActionLabel.yaml