`Class.GuiButton` adalah kelas abstrak yang mewarisi dari `Class.GuiObject`.
Ini adalah kelas dasar untuk `Class.ImageButton` dan `Class.TextButton` yang dapat diklik dan interaktif. Kelas ini juga mendefinisikan beberapa properti untuk perilaku interaktif, yaitu `Class.GuiButton.AutoButtonColor|AutoButtonColor` dan `Class.GuiButton.Modal|Modal`.

Peristiwa yang paling penting dari `Class.GuiButton` adalah
`Class.GuiButton.Activated|Activated`, yaitu **peristiwa multi-platform** yang terjadi
ketika tombol diaktifkan. Ketika menggunakan mouse, ini berarti mengklik tombol
 dan melepasnya dengan kursor masih berada di atas objek UI. Untuk sentuhan, hal yang sama berlaku tetapi dengan sentuhan alih-alih menekan tombol. Akhirnya, untuk gamepad,
`Class.GuiButton.Activated|Activated` terjadi jika `Class.GuiButton` dipilih
ketika tombol **A** ditekan dan dilepaskan. Singkatnya, peristiwa ini sangat
berguna untuk pemrograman antarmuka pengguna multi-platform karena menyediakan
antarmuka umum yang bagus untuk input pengguna tunggal.

Dihasilkan saat klik kiri ditekan dan dilepas terdeteksi di desktop, pelepasan sentuh terdeteksi di perangkat mobile, atau **A**/cross diaktifkan dalam mode navigasi UI di konsol.

Karena acara ini tidak dihasilkan di server, seharusnya hanya digunakan dalam
`Class.LocalScript`, atau dalam `Class.Script` dengan
`Class.Script.RunContext|RunContext` dari `Enum.RunContext.Client`.

GuiButton.Activated

inputObject

clickCount

Peristiwa ini terjadi ketika mouse pengguna mengklik penuh tombol `Class.GuiButton`.

Sehubungan dengan mengklik, mouse harus berada dalam batasan dari
`Class.GuiButton` dan tombol mouse harus ditekan ke bawah dan dilepaskan lagi
sebelum peristiwa ini terjadi. Jika mouse meninggalkan batasan `Class.GuiButton`
dan dilepaskan, peristiwa tidak akan terjadi. Jika Anda ingin
menghindari batasan ini, Anda dapat menggunakan
`Class.GuiButton.MouseButton1Down|MouseButton1Down` dan
`Class.GuiButton.MouseButton1Up|MouseButton1Up`; peristiwa ini mirip
 tetapi akan terjadi setiap kali pengguna menekan tombol mouse kiri mereka ke bawah atau
ke atas, masing-masing.

GuiButton.MouseButton1Click

Terjadi saat mouse pengguna mengklik penuh tombol `Class.GuiButton`.

Peristiwa ini terjadi ketika pengguna menekan tombol mouse kiri mereka ke bawah pada
`Class.GuiButton`.

Untuk peristiwa yang memerlukan pengguna untuk menekan **dan** melepaskan tombol mouse kiri
pada `Class.GuiButton` agar peristiwa tersebut terjadi, pertimbangkan untuk menggunakan
`Class.GuiButton.MouseButton1Click|MouseButton1Click`.

GuiButton.MouseButton1Down

Koordinat layar **X** mouse dalam piksel.

Koordinat layar **Y** mouse dalam piksel.

Terjadi saat pengguna menekan tombol mouse kiri mereka ke bawah pada
`Class.GuiButton`.

Peristiwa ini terjadi ketika pengguna melepaskan tombol mouse kiri mereka dari
`Class.GuiButton`.

Untuk peristiwa yang memerlukan pengguna untuk menekan **dan** melepaskan tombol mouse kiri
pada `Class.GuiButton` agar peristiwa tersebut terjadi, pertimbangkan untuk menggunakan
`Class.GuiButton.MouseButton1Click|MouseButton1Click`.

GuiButton.MouseButton1Up

Terjadi saat pengguna melepaskan tombol mouse kiri mereka dari
`Class.GuiButton`.

Peristiwa ini terjadi ketika mouse pengguna mengklik kanan penuh pada
`Class.GuiButton`.

Sehubungan dengan mengklik, mouse harus berada dalam batasan dari
`Class.GuiButton` dan tombol mouse harus ditekan ke bawah dan dilepaskan lagi
sebelum peristiwa ini terjadi. Jika mouse meninggalkan batasan `Class.GuiButton`
dan dilepaskan, peristiwa ini tidak akan terjadi. Jika Anda ingin
menghindari batasan ini, Anda dapat menggunakan
`Class.GuiButton.MouseButton2Down|MouseButton2Down` dan
`Class.GuiButton.MouseButton2Up|MouseButton2Up`; peristiwa ini mirip
 tetapi akan terjadi setiap kali pengguna menekan tombol mouse kanan mereka ke bawah atau
ke atas, masing-masing.

GuiButton.MouseButton2Click

Terjadi saat mouse pengguna mengklik kanan penuh tombol `Class.GuiButton`.

Peristiwa ini terjadi ketika pengguna menekan tombol mouse kanan mereka ke bawah pada
`Class.GuiButton`.

Untuk peristiwa yang memerlukan pengguna untuk menekan **dan** melepaskan tombol mouse kanan
pada `Class.GuiButton` agar peristiwa tersebut terjadi, pertimbangkan untuk menggunakan
`Class.GuiButton.MouseButton2Click|MouseButton2Click`.

GuiButton.MouseButton2Down

Terjadi saat pengguna menekan tombol mouse kanan mereka ke bawah pada
`Class.GuiButton`.

Peristiwa ini terjadi ketika pengguna melepaskan tombol mouse kanan mereka dari
`Class.GuiButton`.

Untuk peristiwa yang memerlukan pengguna untuk menekan **dan** melepaskan tombol mouse kanan
pada `Class.GuiButton` agar peristiwa tersebut terjadi, pertimbangkan untuk menggunakan
`Class.GuiButton.MouseButton2Click|MouseButton2Click`.

GuiButton.MouseButton2Up

Terjadi saat pengguna melepaskan tombol mouse kanan mereka dari
`Class.GuiButton`.

Dij_fire ketika deteksi tekan dan lepas klik kanan dari mouse, deteksi tekan lama pada input sentuh, `R3` terdeteksi dari gamepad, atau
<kbd>Alt</kbd><kbd>Enter</kbd> terdeteksi dalam mode navigasi UI menggunakan
keyboard.


GuiButton.SecondaryActivated

Objek input yang mewakili aksi aktivasi alternatif.

Ditembak saat input "sekunder" pada tombol diaktifkan.

GuiButton

Properti ini menentukan apakah tombol secara otomatis mengubah warna
ketika `Class.Mouse` pengguna melayang di atas atau mengkliknya. Jika `true`, tombol
akan secara otomatis mengubah warna saat mouse melayang di atas atau
mengkliknya. Jika `false`, tombol tidak akan berubah.

Jika Anda ingin menyesuaikan cara tombol berubah saat mouse pengguna
melayang di atas atau mengkliknya, pertimbangkan untuk menggunakan `Class.ImageButton` dan
mengubah `Class.ImageButton.HoverImage|HoverImage` dan
`Class.ImageButton.PressedImage|PressedImage`.

Harap dicatat bahwa properti ini tidak akan berpengaruh pada
`Class.ImageButton` jika properti `Class.ImageButton.Image|Image` diatur
to sebuah gambar. Selain itu, properti ini tidak akan mempengaruhi
`Class.ImageButton` saat mouse melayang ketika
`Class.ImageButton.HoverImage|HoverImage` tidak `nil`, atau saat mengklik mouse
jika `Class.ImageButton.PressedImage|PressedImage` tidak `nil`.

GuiButton.AutoButtonColor

Menentukan apakah tombol secara otomatis mengubah warna saat mouse
melayang di atasnya atau mengkliknya.

Sebuah instance `Class.HapticEffect` yang akan diputar saat `Class.GuiButton`
dilayangi.

GuiButton.HoverHapticEffect

Jika `true` saat elemen GUI terlihat, mouse tidak akan terkunci
kecuali tombol mouse kanan ditekan.

GuiButton.Modal

Sebuah instance `Class.HapticEffect` yang akan diputar saat `Class.GuiButton`
ditekan.

GuiButton.PressHapticEffect

Sebuah properti boolean yang menunjukkan apakah objek telah dipilih.

GuiButton.Selected

Mengatur gaya `Class.GuiButton` berdasarkan daftar gaya yang telah ditentukan.

GuiButton.Style

Kelas abstrak untuk elemen antarmuka pengguna 2D interaktif.

`Class.GuiObject` adalah kelas abstrak (seperti `Class.BasePart`) untuk objek
antarmuka pengguna 2D. Ini mendefinisikan semua properti yang terkait dengan
penampilan objek antarmuka pengguna grafis (GUI) seperti
`Class.GuiObject.Size|Size` dan `Class.GuiObject.Position|Position`. Ia juga
tidak memiliki beberapa properti hanya baca yang berguna seperti
`Class.GuiObject.AbsolutePosition|AbsolutePosition`, `Class.GuiObject.AbsoluteSize|AbsoluteSize`,
dan `Class.GuiObject.AbsoluteRotation|AbsoluteRotation`.

Untuk memanipulasi tata letak objek GUI dengan cara khusus, Anda
bisa menggunakan struktur tata letak seperti [list/flex](/ui/list-flex-layouts) atau
[grid](/ui/grid-table-layouts), dan Anda dapat menata mereka melampaui
properti inti mereka melalui
[modifikator penampilan](/ui/appearance-modifiers).

Meskipun mungkin untuk mendeteksi peristiwa tombol mouse pada objek GUI
mana pun menggunakan `Class.GuiObject.InputBegan|InputBegan` dan
`Class.GuiObject.InputEnded|InputEnded`, hanya `Class.ImageButton` dan
`Class.TextButton` yang memiliki peristiwa khusus yang nyaman seperti
`Class.TextButton.Activated|Activated` untuk mendeteksi klik/tekan.

Contoh di bawah ini mengasumsikan berada di dalam GuiObject seperti `TextButton`, dan
bahwa properti `Class.GuiObject.Draggable` diatur ke true. Ini akan mencetak
UDim2 dari tempat pemain mulai menarik objek.

Peristiwa ini ditrigger saat pemain mulai menarik objek.

Lihat juga `Class.GuiObject.DragStopped`.

GuiObject.DragBegin

initialPosition

Sebuah nilai `Datatype.UDim2` dari posisi `Class.GuiObject`
sebelum operasi seret dimulai.

Ditrigger saat pemain mulai menarik objek.

Contoh di bawah ini mengasumsikan ada dalam sebuah GuiObject seperti `TextButton`, dan
bahwa properti `Class.GuiObject.Draggable` diatur ke true. Ini akan mencetak
X dan Y di mana pemain berhenti menyeret GUI. Misalnya, jika pemain
berhenti menyeret objek pada 189, 180, maka di bawah ini akan mencetak Pemain
berhenti menyeret GuiObject di (189, 180)

Peristiwa ini ditrigger saat pemain berhenti menarik objek.

Lihat juga `Class.GuiObject.DragBegin`.

GuiObject.DragStopped

Lokasi **X** layar mouse dalam piksel, relatif terhadap sudut kiri atas
layar.

Lokasi **Y** layar mouse dalam piksel, relatif terhadap sudut kiri atas
layar.

Ditrigger saat pemain berhenti menarik objek.

Contoh berikut menunjukkan salah satu dari banyak contoh penggunaan untuk menangani input pengguna
input dari InputBegan tergantung pada tipe-nya.

Agar ini berfungsi seperti yang diharapkan, itu harus ditempatkan dalam `LocalScript`
dan sebagai anak dari _gui_.


Peristiwa ini ditrigger saat pengguna mulai berinteraksi dengan `Class.GuiObject`
melalui perangkat Antarmuka Manusia-Komputer (Tombol mouse ditekan, sentuhan mulai,
tombol keyboard ditekan, dll).

`Class.UserInputService` memiliki peristiwa dengan nama serupa yang tidak
terbatas pada elemen UI tertentu: `Class.UserInputService.InputBegan`.

Peristiwa ini akan selalu ditrigger terlepas dari status permainan.

Lihat juga `Class.GuiObject.InputEnded` dan `Class.GuiObject.InputChanged`.

GuiObject.InputBegan

input

Sebuah `Class.InputObject`, yang berisi data berguna untuk mengquery input pengguna
seperti `Enum.UserInputType|jenis input`,
`Enum.UserInputState|status input`, dan
`Class.InputObject.Position|koordinat layar dari input`.

Ditrigger saat pengguna mulai berinteraksi melalui perangkat Antarmuka Manusia-Komputer
(Tombol mouse ditekan, sentuhan mulai, tombol keyboard ditekan, dll).

Contoh berikut menunjukkan salah satu dari banyak contoh penggunaan dalam menangani
input pengguna dari InputChanged tergantung pada jenisnya.

Agar ini berfungsi seperti yang diharapkan, ini harus ditempatkan dalam `LocalScript`
dan sebagai anak dari _gui_.

Peristiwa ini ditrigger saat pengguna mengubah cara mereka berinteraksi melalui perangkat
Antarmuka Manusia-Komputer (Tombol mouse ditekan, sentuhan mulai, tombol keyboard ditekan, dll).

`Class.UserInputService` memiliki peristiwa dengan nama serupa yang tidak
terbatas pada elemen UI tertentu:
`Class.UserInputService.InputChanged`.

Peristiwa ini akan selalu ditrigger terlepas dari status permainan.

Lihat juga `Class.GuiObject.InputBegan` dan `Class.GuiObject.InputEnded`.

GuiObject.InputChanged

Ditrigger saat pengguna mengubah cara mereka berinteraksi melalui perangkat Antarmuka Manusia-Komputer
(Tombol mouse ditekan, sentuhan mulai, tombol keyboard ditekan, dll).

Contoh berikut menunjukkan salah satu dari banyak contoh penggunaan mengelola input pengguna
berasal dari InputEnded tergantung pada jenisnya.

Agar ini berfungsi seperti yang diharapkan, ia harus diletakkan dalam `LocalScript`
dan menjadi anak dari _gui_.

Peristiwa InputEnded ditrigger saat pengguna berhenti berinteraksi melalui
perangkat Antarmuka Manusia-Komputer (Tombol mouse ditekan, sentuhan mulai, tombol
keyboard ditekan, dll).

`Class.UserInputService` memiliki peristiwa dengan nama serupa yang tidak
terbatas pada elemen UI tertentu: `Class.UserInputService.InputEnded`.

Peristiwa ini akan selalu ditrigger terlepas dari status permainan.

Lihat juga `Class.GuiObject.InputBegan` dan `Class.GuiObject.InputChanged`.

GuiObject.InputEnded

Sebuah `Class.InputObject`, yang berisi data berguna untuk mengquery input pengguna
seperti `Enum.UserInputType`, `Enum.UserInputState`, dan
`Class.InputObject.Position`.

Ditrigger saat pengguna berhenti berinteraksi melalui perangkat Antarmuka Manusia-Komputer
(Tombol mouse ditekan, sentuhan mulai, tombol keyboard ditekan, dll).

Contoh berikut mencetak lokasi mouse, dalam piksel, ketika mouse memasuki elemen GUI.

Peristiwa MouseEnter ditrigger saat pengguna memindahkan mouse mereka ke
`Class.GuiObject` elemen.

Silakan jangan mengandalkan argumen `x` dan `y` yang diteruskan oleh peristiwa ini sebagai cara
yang tidak dapat ditolak untuk menentukan di mana posisi mouse pengguna saat
masuk dalam GUI. Koordinat ini bisa bervariasi meskipun mouse masuk GUI melalui
tepi yang sama - terutama saat mouse masuk elemen dengan cepat. Ini
berasal dari fakta bahwa koordinat tersebut menunjukkan posisi mouse saat
peristiwa dipicu daripada saat pasti mouse masuk GUI.

Peristiwa ini ditrigger bahkan ketika elemen GUI dirender di bawah elemen lain.

Jika Anda ingin melacak saat mouse pengguna meninggalkan elemen GUI,
Anda dapat menggunakan peristiwa `Class.GuiObject.MouseLeave`.

##### Lihat Juga

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

GuiObject.MouseEnter

Koordinat layar **X** mouse dalam piksel, relatif terhadap sudut kiri
atas layar.

Koordinat layar **Y** mouse dalam piksel, relatif terhadap sudut kiri
atas layar.

Ditrigger saat pengguna memindahkan mouse mereka ke dalam elemen GUI.

Peristiwa MouseLeave ditrigger saat pengguna memindahkan mouse mereka keluar dari
`Class.GuiObject` elemen.

Silakan jangan mengandalkan argumen `x` dan `y` yang diteruskan oleh peristiwa ini sebagai cara
yang tidak dapat ditolak untuk menentukan di mana posisi mouse pengguna saat
keluar dari GUI. Koordinat ini bisa bervariasi meskipun mouse meninggalkan elemen GUI melalui
tepi yang sama - terutama saat mouse keluar elemen dengan cepat. Ini
berasal dari fakta bahwa koordinat tersebut menunjukkan posisi mouse saat
peristiwa dipicu daripada saat pasti mouse meninggalkan GUI.

Peristiwa ini ditrigger bahkan ketika elemen GUI dirender di bawah elemen lain.

##### Lihat Juga

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

GuiObject.MouseLeave

Ditrigger saat pengguna memindahkan mouse mereka keluar dari elemen GUI.

Ditrigger setiap kali pengguna memindahkan mouse mereka saat berada di dalam
`Class.GuiObject` elemen. Ini mirip dengan `Class.Mouse.Move`, yang
terpicu terlepas dari apakah mouse pengguna berada di atas elemen GUI.

Perhatikan, peristiwa ini akan dipicu saat posisi mouse diperbarui, sehingga
ini akan dipicu berulang kali saat sedang dipindahkan.

Argumen `x` dan `y` menunjukkan koordinat layar dari
mouse pengguna dalam piksel. Ini bisa berguna untuk menentukan lokasi mouse
pada GUI, layar, dan delta sejak posisi sebelumnya dari mouse
jika ada yang dilacak dalam variabel global.

Kode di bawah ini menunjukkan bagaimana menentukan offset `Datatype.Vector2`
dari mouse pengguna relatif terhadap elemen GUI:

```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)
```
Catatan bahwa peristiwa ini mungkin tidak dipicu persis saat mouse pengguna
masuk atau keluar dari elemen GUI. Oleh karena itu, argumen `x` dan `y`
mungkin tidak akan cocok dengan sempurna pada koordinat tepi GUI.

##### Lihat Juga

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

GuiObject.MouseMoved

Ditrigger setiap kali pengguna memindahkan mouse mereka saat berada di dalam elemen GUI.

Peristiwa WheelBackward ditrigger saat pengguna menggulir roda mouse mundur
saat mouse berada di atas elemen `Class.GuiObject`. Ini mirip dengan
`Class.Mouse.WheelBackward`, yang dipicu terlepas dari apakah mouse pengguna
berada di atas elemen GUI.

Peristiwa ini dipicu hanya sebagai indikator pergerakan mundur roda.
Ini berarti bahwa argumen koordinat mouse **x** dan **y** tidak berubah
sebagai akibat dari peristiwa ini. Koordinat ini hanya berubah ketika mouse
bergerak, yang bisa dilacak oleh peristiwa `Class.GuiObject.MouseMoved`.

##### Lihat Juga

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

GuiObject.MouseWheelBackward

Ditrigger saat pengguna menggulir roda mouse mereka mundur saat mouse berada di atas
elemen GUI.

Peristiwa WheelForward ditrigger saat pengguna menggulir roda mouse maju
saat mouse berada di atas elemen `Class.GuiObject`. Ini mirip dengan
`Class.Mouse.WheelForward`, yang dipicu terlepas dari apakah mouse pengguna
berada di atas elemen GUI.

Peristiwa ini dipicu hanya sebagai indikator pergerakan maju roda.
Ini berarti bahwa argumen koordinat mouse **X** dan **Y** tidak
berubah akibat dari peristiwa ini. Koordinat ini hanya berubah ketika mouse
bergerak, yang dapat dilacak oleh peristiwa `Class.GuiObject.MouseMoved`.

##### Lihat Juga

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

GuiObject.MouseWheelForward

Ditrigger saat pengguna menggulir roda mouse mereka maju saat mouse berada di atas
sebuah elemen GUI.

Contoh berikut mencetak pesan ketika pengguna memilih objek dengan
controller game.

Agar ini berfungsi seperti yang diharapkan, ia harus ditempatkan dalam `LocalScript`
dan menjadi anak dari _gui_.

Peristiwa ini ditrigger saat pemilih Gamepad mulai fokus pada
`Class.GuiObject`.

Jika Anda ingin memeriksa dari pemilih Gamepad berhenti fokus pada elemen GUI,
Anda bisa menggunakan peristiwa `Class.GuiObject.SelectionLost`.

Ketika sebuah GUI mendapatkan fokus pemilihan, nilai dari
`Class.GuiService.SelectedObject|SelectedObject` juga berubah ke
elemen yang menerima fokus pemilihan. Untuk menentukan GUI mana yang mendapatkan pemilihan,
periksa nilai dari properti ini.

GuiObject.SelectionGained

Ditrigger saat GuiObject mendapat fokus dengan pemilih Gamepad.

Contoh berikut mencetak pesan ketika elemen kehilangan fokus pada
sebuah gamepad.

Agar ini berfungsi sesuai harapan, harus ditempatkan dalam `LocalScript`
dan menjadi anak dari _gui_.

Peristiwa ini ditrigger saat pemilih Gamepad berhenti fokus pada
`Class.GuiObject`.

Jika Anda ingin memeriksa dari pemilih Gamepad mulai fokus pada elemen GUI,
Anda bisa menggunakan peristiwa `Class.GuiObject.SelectionGained`.

Ketika sebuah GUI kehilangan fokus pemilihan, nilai dari
`Class.GuiService.SelectionObject|SelectionObject` properti berubah baik
ke `nil` atau ke elemen GUI yang mendapatkan fokus pemilihan. Untuk menentukan
GUI mana yang mendapatkan pemilihan, atau jika tidak ada GUI yang dipilih, periksa nilai dari
properti ini.

GuiObject.SelectionLost

Ditrigger saat pemilih Gamepad berhenti fokus pada GuiObject.

Contoh kode ini memungkinkan pemain untuk memanipulasi posisi layar dari beberapa
elemen UI, seperti `Frame`, dengan menekan elemen UI tersebut selama beberapa
saat. Kemudian, pemain menggerakkan jari mereka dan melepaskan. Selama
gerakan tersebut, Frame berwarna biru dengan garis luar putih.

Acara ini terjadi setelah sesaat ketika pemain menekan jari mereka
pada elemen UI menggunakan perangkat yang mendukung sentuhan. Acara ini terjadi dengan tabel
`Datatype.Vector2` yang menggambarkan posisi layar relatif dari
jari yang terlibat dalam gestur. Selain itu, acara ini terjadi beberapa kali:
`Enum.UserInputState.Begin` setelah penundaan singkat,
`Enum.UserInputState.Change` jika pemain menggerakkan jari mereka saat
melakukan gestur, dan akhirnya `Enum.UserInputState.End`. Penundaan ini bergantung pada platform;
di Studio, itu sedikit lebih dari satu detik.

GuiObject.TouchLongPress

touchPositions

Sebuah array dari `Datatype.Vector2` yang menggambarkan posisi **relatif**
dari jari yang terlibat dalam gerakan.

state

Sebuah `Enum.UserInputState` yang menggambarkan status dari gerakan:

- Begin dipicu sekali di awal gerakan (setelah penundaan singkat)
- Change dipicu jika pemain menggerakkan jari mereka saat ditekan
- End dipicu sekali di akhir gerakan saat mereka melepaskan
  jari mereka.

Ditrigger saat pemain mulai, melanjutkan, dan berhenti menekan lama elemen UI.

Contoh kode ini dimaksudkan untuk ditempatkan dalam `LocalScript` di dalam
`Frame` yang berada di dalam `Frame` luar, atau `GuiObject` lainnya. Ini memungkinkan
pemain untuk memanipulasi posisi frame dalam dengan menggerakkan jari mereka pada
frame luar.

Acara ini terjadi ketika pemain menggerakkan jari mereka pada elemen UI
menggunakan perangkat yang mendukung sentuhan. Acara ini terjadi sedikit sebelum
`Class.GuiObject.TouchSwipe` terjadi, dan tidak terjadi dengan
`Class.GuiObject.TouchTap`. Acara ini berguna untuk memungkinkan pemain
manipulasi posisi elemen UI di layar.

Acara ini terjadi dengan tabel `Datatype.Vector2` yang menggambarkan
posisi layar relatif dari jari yang terlibat dalam gestur. Selain itu,
acara ini terjadi beberapa kali: `Enum.UserInputState.Begin` setelah
penundaan singkat, `Enum.UserInputState.Change` ketika pemain menggerakkan jari mereka
selama gestur, dan akhirnya dengan `Enum.UserInputState.End`.

GuiObject.TouchPan

Sebuah array Luau dari objek `Datatype.Vector2`, masing-masing menunjukkan posisi dari
semua jari yang terlibat dalam gerakan.

totalTranslation

Menunjukkan seberapa jauh gerakan panning berlangsung dari titik awalnya.

velocity

Indikasi seberapa cepat gerakan dilakukan di setiap dimensi.

Menunjukkan `Enum.UserInputState` dari gerakan.

Ditrigger saat pemain memindahkan jari mereka pada elemen UI.

Contoh kode ini ditujukan untuk `LocalScript` dalam `Frame` internal yang berada
di dalam `Frame` luar, atau objek `GuiObject` lainnya. Ini memungkinkan pemain untuk
mengubah ukuran frame dalam dengan melakukan gestur `Class.GuiObject.TouchPinch` pada
frame luar.

Acara ini terjadi ketika pemain menggunakan dua jari untuk membuat gestur pinch atau pull
pada elemen UI menggunakan perangkat yang mendukung sentuhan. **Pinch**
terjadi ketika dua atau lebih jari bergerak lebih dekat satu sama lain, dan **pull**
terjadi ketika mereka bergerak terpisah. Acara ini terjadi bersamaan dengan
`Class.GuiObject.TouchPan`. Acara ini berguna untuk memungkinkan pemain
manipulasi skala (ukuran) elemen UI di layar, dan paling sering
digunakan untuk fitur zoom.

Acara ini terjadi dengan tabel `Datatype.Vector2` yang menggambarkan
posisi layar relatif dari jari yang terlibat dalam gestur. Selain itu,
acara ini terjadi beberapa kali: `Enum.UserInputState.Begin` setelah
penundaan singkat, `Enum.UserInputState.Change` ketika pemain menggerakkan sebuah jari
durante gestur, dan akhirnya dengan `Enum.UserInputState.End`. Harus
dicatat bahwa skala harus digunakan **secara multiplicative**.

GuiObject.TouchPinch

Sebuah array Luau dari objek `Datatype.Vector2`, masing-masing menunjukkan posisi dari
semua jari yang terlibat dalam gerakan mencubit.

scale

Sebuah float yang menunjukkan perbedaan dari awal
gerakan mencubit.

Sebuah float yang menunjukkan seberapa cepat gerakan mencubit berlangsung.

Ditrigger saat pemain melakukan gerakan mencubit atau menarik menggunakan dua jari
pada elemen UI.

Contoh kode ini ditujukan untuk `LocalScript` di dalam `Frame` yang
terletak di dalam `Frame` luar, atau objek `GuiObject` lainnya. Ini memungkinkan pemain untuk memutar
frame dalam dengan melakukan gerakan `Class.GuiObject.TouchRotate` pada
frame luar.

Acara ini terjadi ketika pemain menggunakan dua jari untuk membuat gestur pinch atau pull
pada elemen UI menggunakan perangkat yang mendukung sentuhan. Rotasi terjadi
ketika sudut garis antara dua jari berubah. Acara ini terjadi
bersamaan dengan `Class.GuiObject.TouchPan`. Acara ini berguna untuk
memungkinkan pemain manipulasikan rotasi elemen UI di
layar.

Acara ini terjadi dengan tabel `Datatype.Vector2` yang menggambarkan
posisi layar relatif dari jari yang terlibat dalam gestur. Selain itu,
acara ini terjadi beberapa kali: `Enum.UserInputState.Begin` setelah
penundaan singkat, `Enum.UserInputState.Change` ketika pemain menggerakkan sebuah jari
selama gestur, dan akhirnya dengan `Enum.UserInputState.End`.

GuiObject.TouchRotate

Sebuah array Luau dari objek `Datatype.Vector2`, masing-masing menunjukkan posisi semua jari yang terlibat dalam gerakan.

rotation

Sebuah float yang menunjukkan seberapa banyak rotasi telah terjadi dari awal gerakan.

Sebuah float yang menunjukkan seberapa cepat gerakan dilakukan.

Ditembak saat pemain melakukan gerakan rotasi menggunakan dua jari pada elemen UI.

Contoh kode ini akan menyebabkan `Frame` (atau `GuiObject` lainnya) melambung ketika
gesture gesek dilakukan pada perangkat yang mendukung sentuhan (atau emulator Studio).
Gesekan horizontal akan mengubah hue dari
`Class.GuiObject.BackgroundColor3`, sementara gesekan vertikal akan mengubah
saturasinya.

Acara ini terjadi ketika pemain melakukan gestur swipe pada elemen UI
menggunakan perangkat yang mendukung sentuhan. Acara ini terjadi dengan arah
gestur (Atas, Bawah, Kiri atau Kanan) dan jumlah titik sentuh yang terlibat
dalam gestur. Gestur swipe sering digunakan untuk mengubah tab di UI mobile.

GuiObject.TouchSwipe

swipeDirection

Sebuah `Enum.SwipeDirection` yang menunjukkan arah gerakan sapuan (Atas, Bawah, Kiri atau Kanan).

numberOfTouches

Jumlah titik sentuh yang terlibat dalam gerakan (biasanya 1).

Ditembak saat pemain melakukan gerakan sapuan pada elemen UI.

Contoh kode ini akan mengubah `Class.GuiObject.BackgroundTransparency` dari sebuah
elemen UI, seperti `Frame`, saat diketuk pada perangkat yang mendukung sentuhan.

Acara ini terjadi ketika pemain melakukan gestur tap pada elemen UI
menggunakan perangkat yang mendukung sentuhan. Tap adalah sentuhan cepat
singkat tanpa ada pergerakan yang terlibat (tekanan yang lebih lama akan
menghasilkan `Class.GuiObject.TouchLongPress`, dan bergerak selama sentuhan akan
menghasilkan `Class.GuiObject.TouchPan` dan/atau `Class.GuiObject.TouchSwipe`). Acara ini terjadi
Dengan tabel objek `Datatype.Vector2` yang menggambarkan posisi relatif
dari jari yang terlibat dalam gestur.

GuiObject.TouchTap

Sebuah array dari `Datatype.Vector2` yang menggambarkan posisi **relatif** dari jari-jari yang terlibat dalam gerakan.

Ditembak saat pemain melakukan gerakan ketukan pada elemen UI.

Contoh kode ini menunjukkan penggunaan TweenPosition yang lebih terlibat dengan
deteksi ketika tween selesai/yang dibatalkan dengan mendefinisikan fungsi callback. Ini
juga mencetak apakah tween akan diputar.

Memindahkan GUI dengan mulus ke posisi `Datatype.UDim2` baru dalam waktu yang ditentukan
menggunakan `Enum.EasingDirection` dan `Enum.EasingStyle` yang ditentukan.

Fungsi ini akan mengembalikan apakah tween akan bermain. Itu tidak akan bermain jika
ada tween lain yang sedang bertindak pada `Class.GuiObject` dan parameter override
adalah `false`.

Lihat juga `Class.GuiObject:TweenSize()` dan
`Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenPosition

endPosition

easingDirection

Arah mana yang harus memudahkan GUI ke _endPosition_.

easingStyle

Gaya di mana untuk memudahkan GUI ke _endPosition_.

time

Berapa lama, dalam detik, tween harus diselesaikan.

override

Apakah tween akan mengganti tween yang sedang berlangsung.

callback

Fungsi callback untuk dieksekusi ketika tween selesai.

Memindahkan GUI dengan mulus ke `Datatype.UDim2` baru.

Contoh kode ini menunjukkan penggunaan `Class.GuiObject:TweenSize()`
fungsi. Ini memulai animasi pada properti `Class.GuiObject.Size`
induk ke `UDim2.new(0.5, 0, 0.5, 0)`, yang merupakan setengah dari
ukuran `GuiObject` di kedua sumbu.

Selain itu, ini menunjukkan bagaimana parameter callback dapat digunakan
tuk mendeteksi kapan tween berhenti (apakah itu dibatalkan oleh tween lain
aatau selesai).

Mengubah ukuran `Class.GuiObject` dengan mulus menjadi `Datatype.UDim2` baru dalam waktu yang ditentukan
menggunakan `Enum.EasingDirection` dan `Enum.EasingStyle` yang ditentukan.

Fungsi ini akan mengembalikan apakah tween akan bermain. Biasanya ini akan
selalu mengembalikan `true`, tetapi akan mengembalikan `false` jika tween lain sedang
aktif dan override diatur ke `false`.

Lihat juga `Class.GuiObject:TweenSize()` dan
`Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSize

endSize

Arah mana yang harus memudahkan GUI ke _endSize_.

Gaya di mana untuk memudahkan GUI ke _endSize_.

Mengubah ukuran `Class.GuiObject` dengan mulus menjadi `Datatype.UDim2` baru.

Contoh di bawah ini akan tween sebuah `Class.Frame` ke pojok kiri atas ukuran orang tua
 dan mengubah ukuran menjadi 0.

Mengubah ukuran dan memindahkan GUI ke ukuran dan posisi baru `Datatype.UDim2` dengan
mulus dalam waktu yang ditentukan menggunakan `Enum.EasingDirection` dan
`Enum.EasingStyle` yang ditentukan.

Fungsi ini akan mengembalikan apakah tween akan bermain. Biasanya ini akan
selalu mengembalikan `true`, tetapi akan mengembalikan `false` jika tween lain yang sedang
aktif dan override diatur ke `false`.

Lihat juga `Class.GuiObject:TweenSize()` dan
`Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSizeAndPosition

Arah mana yang harus memudahkan GUI ke _endSize_ dan
_endPosition_.

Gaya di mana untuk memudahkan GUI ke _endSize_ dan _endPosition_.

Memindahkan sebuah GUI ke ukuran dan posisi baru dengan mulus.

GuiObject

Contoh kode ini menunjukkan penggunaan properti Aktif sebagai debounce
untuk acara Diaktifkan.

Properti ini menentukan apakah `Class.GuiObject` akan menyerap input ke
ruang 3D, seperti model bawah dengan kelas `Class.ClickDetector`
seperti `Class.DragDetector`.

Untuk objek `Class.GuiButton` (`Class.ImageButton` dan
`Class.TextButton`), properti ini menentukan apakah
`Class.GuiButton.Activated|Activated` akan terpicu
(`Class.GuiButton.AutoButtonColor|AutoButtonColor` masih akan bekerja pada
mereka juga). Peristiwa `Class.GuiObject.InputBegan|InputBegan`,
`Class.GuiObject.InputChanged|InputChanged`, dan
`Class.GuiObject.InputEnded|InputEnded` bekerja seperti biasa terlepas dari
nilai properti ini.

GuiObject.Active

Menentukan apakah elemen UI ini menyerap input.

Contoh kode ini memindahkan elemen UI ke sisi yang berbeda dari elemen induk.
Dimulai dari kiri atas dan berakhir di kanan bawah. Tempelkan ke dalam
LocalScript di dalam Frame, dalam ScreenGui.

Properti ini menentukan titik asal dari `Class.GuiObject`, relatif
terhadap ukurannya yang absolut. Titik asal menentukan dari mana elemen
diposisikan (melalui `Class.GuiObject.Position`) dan dari mana
`Class.GuiObject.Size` yang dirender meluas.

Lihat [di sini](/ui/position-and-size#anchorpoint) untuk diagram
ilustrasi dan detail.

GuiObject.AnchorPoint

Menentukan titik asal dari `Class.GuiObject`, relatif terhadap
ukuran absolutnya.

Skrip berikut membuat sebuah frame induk dengan ukuran otomatis dengan
a`UIListLayout`, kemudian menyisipkan beberapa objek `TextLabel`
yang ukurannya otomatis. Perhatikan bagaimana `UIListLayout` induk secara otomatis
diubah ukurannya untuk menyesuaikan konten anaknya dan label-label
secara otomatis menyesuaikan ukuran untuk konten teksnya.
Skrip ini dapat diparentasi ke `ScreenGui`.

Properti ini digunakan untuk secara otomatis mengukur objek UI induk berdasarkan
ukuran keturunannya. Anda dapat menggunakan properti ini untuk menambahkan teks
secara dinamis dan konten lain ke objek UI pada waktu edit atau run time,
dan ukurannya akan disesuaikan untuk menampung konten tersebut.

Ketika `Class.GuiObject.AutomaticSize|AutomaticSize` diatur ke
nilai `Enum.AutomaticSize` apa pun selain
`Enum.AutomaticSize|None`, objek UI ini dapat mengubah ukuran tergantung pada
konten anaknya.

Untuk informasi lebih lanjut tentang cara menggunakan properti ini dan cara kerja, silakan
lihat [di sini](/ui/size-modifiers#automatic-sizing).

GuiObject.AutomaticSize

Menentukan apakah perubahan ukuran terjadi berdasarkan konten anak.

Menentukan warna latar belakang `Class.GuiObject`.

GuiObject.BackgroundColor

Contoh kode ini membuat Frame induk berputar melalui semua warna pelangi menggunakan Color3.fromHSV.

Properti ini menentukan warna latar belakang objek `Class.GuiObject` (warna isi).
Jika elemen Anda berisi teks, seperti `Class.TextBox`, `Class.TextButton`,
atau `Class.TextLabel`, pastikan warna latar belakang Anda kontras dengan warna teks.

Properti lain yang menentukan sifat visual dari latar belakang adalah
`Class.GuiObject.BackgroundTransparency`; jika ini diatur ke `1`,
tidak ada latar belakang atau border yang akan dirender.

Lihat juga `Class.GuiObject.BorderColor3|BorderColor3`.

GuiObject.BackgroundColor3

Properti ini menentukan transparansi latar belakang dan border dari `Class.GuiObject`.
Namun, ini tidak menentukan transparansi teks jika GUI adalah `Class.TextBox`,
`Class.TextButton`, atau `Class.TextLabel`; transparansi teks ditentukan
`Class.TextBox.TextTransparency`, `Class.TextButton.TextTransparency`, dan
`Class.TextLabel.TextTransparency` masing-masing.

Jika properti ini diatur ke `1`, tidak ada latar belakang atau border yang akan
render dan latar belakang GUI akan sepenuhnya transparan.

GuiObject.BackgroundTransparency

Menentukan transparansi latar belakang dan border `Class.GuiObject`.

Menentukan warna border `Class.GuiObject`.

GuiObject.BorderColor

Contoh kode ini membuat batas dari GuiObject induk menjadi sorot saat pengguna mengarahkan mouse mereka ke elemen tersebut.

Menentukan warna border persegi panjang `Class.GuiObject` (juga
dikenal sebagai warna stroke). Ini terpisah dari `Class.GuiObject.BackgroundColor3`.
Anda tidak akan bisa melihat border objek jika properti
`Class.GuiObject.BorderSizePixel` diatur ke `0`.

Catatan bahwa komponen `Class.UIStroke` memungkinkan efek border yang lebih
canggih.

GuiObject.BorderColor3

Properti ini menentukan cara border `Class.GuiObject` disusun relatif terhadap dimensinya
dengan menggunakan enum dengan nama yang sama,
`Enum.BorderMode`.

Catatan bahwa `Class.UIStroke` dapat mengoverride properti ini dan memungkinkan efek
border yang lebih canggih.

GuiObject.BorderMode

Menentukan cara border `Class.GuiObject` disusun
relatif terhadap dimensinya.

Kelas abstrak untuk semua objek antarmuka pengguna 2D.