Bir `Class.VideoDisplay`, bir `Class.Wire` aracılığıyla bağlı bir `Class.VideoPlayer`'dan video içeriği görüntüleyen bir GUI nesnesidir. Bir `Class.ImageLabel` gibi çalışır, ancak video oynatma için tasarlanmıştır.


`Class.Wire` bağlandı veya bağlantısı kesildiğinde tetiklenir ve o `Class.Wire`
bir pin'e bağlıdır veya daha önce bağlantılıydı.


VideoDisplay.WiringChanged

connected

Örneğin bağlandığı veya bağlantısının kesildiği.


`Class.Wire`'ın hedeflediği `Class.VideoDisplay` üzerindeki pin.


wire

`Class.VideoDisplay` ile diğer örnek arasında bulunan `Class.Wire`.


instance

`Class.Wire` aracılığıyla bağlı olan veya daha önce bağlı olan diğer örnek.


Başka bir örnek `Class.VideoDisplay`'ye bağlı veya bağlantısı kesildiğinde tetiklenir.


Belirtilen pine bağlı olan `Class.Wire|Wires` dizisini döndürür. `Class.VideoDisplay`
bir "Giriş" pini vardır.


VideoDisplay:GetConnectedWires

Belirtilen pine bağlı olan `Class.Wire|Wires` dizisini döndürür.


VideoDisplay:GetInputPins

VideoDisplay:GetOutputPins

VideoDisplay

Videonun ölçeklendiğinde nasıl göründüğünü belirler. Varsayılan olarak, video
ekranda, doku belleğindeki boyutundan daha büyük veya daha küçük olduğunda
doku bozulmasını düzeltir. `Enum.ResamplerMode.Pixelated|Enum.ResamplerMode.Pixelated` olarak ayarlandığında,
videonun piksellerinin keskin kenarlarını korur.


VideoDisplay.ResampleMode

`Class.VideoDisplay` için doku yeniden örnekleme modunu seçer.


UI öğesinin en-boy oranı kaynak videonun en-boy oranından farklı olduğunda
bir video dokusunun nasıl görüntüleneceğini belirler.

Varsayılan olarak, bu özellik `Enum.ScaleType.Stretch` şeklindedir ve video
dokusunun boyutlarını UI öğesinin alanına tam olarak uyması için
destekler.


VideoDisplay.ScaleType

Bir video kaynak videosunun en-boy oranı farklı olduğunda bir UI öğesinde
nasıl ölçekleneceğini belirler.


VideoDisplay.TileSize

Bir videonun nasıl renklendirileceğini belirler. Beyaz olarak ayarlandığında,
hiçbir renklendirme gerçekleşmez. Bu özellik, video varlıklarının yeniden
kullanımı için faydalıdır.


VideoDisplay.VideoColor3

Render edilen videonun nasıl renklendirileceğini belirler.


Bir videoyu `Class.VideoDisplay.VideoRectSize|VideoRectSize` ile birlikte parça
görüntüleme imkanı tanır. Bu özellik, görüntülenecek video alanının piksel
tabanlı kaymasını (sol üstten) belirler.


VideoDisplay.VideoRectOffset

Görüntülenecek videonun alt alanının piksel cinsinden kayması.


Bir videoyu `Class.VideoDisplay.VideoRectOffset|VideoRectOffset` ile birlikte parça
görüntüleme imkanı tanır. Bu özellik, görüntülenecek video alanının piksel
boyutunu belirler. Bir boyut `0` olarak ayarlanmışsa, bunun yerine tüm video
görüntülenir.


VideoDisplay.VideoRectSize

Görüntülenecek videonun alt alanının piksel cinsinden boyutunu belirler.


Bir UI öğesinin render edilen video dokusunun alfa değerini belirler. `0` değeri
tamamen opaktır, ve `1` değeri tamamen şeffaftır (görünmez).


VideoDisplay.VideoTransparency

Render edilen videonun saydamlığını belirler.


Bağlı bir `Class.VideoPlayer`'dan video içeriği görüntüleyen bir GUI nesnesi.


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


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.


`Class.GuiObject`'un, dikdörtgenin sınırlarının dışına render edilmeyecek kısımlarını kesip kesmeyeceğini belirler.

Not: `Class.GuiObject.Rotation|Dönme` bu özellik tarafından desteklenmez. Eğer bu veya herhangi bir ataları **sıfır olmayan** bir `Class.GuiObject.Rotation|Dönme` değerine sahipse, bu özellik **yoksayılarak** alt nesne GUI öğeleri render edilir.


GuiObject.ClipsDescendants

Üst GUI öğesi sınırlarının dışındaki `Class.GuiObject|GuiObjects`'in render edilip edilmeyeceğini belirler.


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


/reference/engine/classes/VideoDisplay.yaml