`Class.TextChannelWindow` adalah `Class.GuiObject` yang merender pesan
chat teks dalam pengalaman dari `Class.TextChannel` yang terhubung. Tempatkan di bawah
`Class.ScreenGui` atau keturunan `Class.LayerCollector` lainnya untuk menampilkan chat
pada lokasi dan tata letak yang kustom.

Atur `Class.TextChannelWindow.Target|Target` ke `Class.TextChannel` untuk memilih
pesan dari saluran mana yang ditampilkan di jendela. Jendela mendaftar dirinya sendiri ke
`Class.TextChatService` saat ditambahkan ke model data.

Anak yang diterima: `Class.UICorner`, `Class.UIAspectRatioConstraint`,
`Class.UISizeConstraint`, dan skrip (`Class.LocalScript`, `Class.Script`,
`Class.ModuleScript`); tipe anak lainnya ditolak.


TextChannelWindow

Referensi ke `Class.TextChannel` yang pesan-pesannya dirender oleh jendela ini.
Saat diatur, jendela menampilkan pesan dari saluran yang ditentukan. Mengatur
properti ini ke `nil` memutuskan jendela dari saluran mana pun sehingga tidak
ditampilkan pesan.

Nilai default adalah `nil` (tidak ada saluran yang terhubung).


TextChannelWindow.Target

`Class.GuiObject` adalah kelas abstrak (sama seperti `Class.BasePart`) untuk objek antarmuka pengguna 2D. Ini mendefinisikan semua properti yang berkaitan dengan tampilan objek antarmuka pengguna grafis (GUI) seperti `Class.GuiObject.Size|Size` dan `Class.GuiObject.Position|Position`. Ini juga memiliki beberapa properti baca-saja 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 dapat menggunakan struktur tata letak seperti [list/flex](/ui/list-flex-layouts) atau [grid](/ui/grid-table-layouts), dan Anda dapat menata mereka di luar properti inti mereka melalui [modifikasi 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 dipicu ketika pemain mulai menyeret objek.

Lihat juga `Class.GuiObject.DragStopped`.

GuiObject.DragBegin

initialPosition

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

Dipicu ketika pemain mulai menyeret 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 dipicu ketika pemain berhenti menyeret objek.

Lihat juga `Class.GuiObject.DragBegin`.

GuiObject.DragStopped

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

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

Dipicu ketika pemain berhenti menyeret objek.

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

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


Peristiwa ini dipicu ketika pengguna mulai berinteraksi dengan `Class.GuiObject` melalui perangkat Antarmuka Manusia-Komputer (tombol mouse ditekan, sentuhan dimulai, 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 dipicu terlepas dari status permainan.

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

GuiObject.InputBegan

input

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

Dipicu ketika pengguna mulai berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse ditekan, sentuhan dimulai, 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 dipicu ketika pengguna mengubah cara mereka berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse ditekan, sentuhan dimulai, 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 dipicu terlepas dari status permainan.

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

GuiObject.InputChanged

Dipicu ketika pengguna mengubah cara mereka berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse ditekan, sentuhan dimulai, tombol keyboard ditekan, dll).

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

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


Peristiwa InputEnded dipicu ketika pengguna berhenti berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse ditekan, sentuhan dimulai, 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 dipicu terlepas dari status permainan.

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

GuiObject.InputEnded

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

Dipicu ketika pengguna berhenti berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse ditekan, sentuhan dimulai, tombol keyboard ditekan, dll).

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

Peristiwa MouseEnter dipicu ketika pengguna menggerakkan mouse mereka ke dalam elemen `Class.GuiObject`.

Silakan jangan bergantung pada argumen `x` dan `y` yang diteruskan oleh peristiwa ini sebagai cara yang pasti untuk menentukan di mana mouse pengguna berada ketika memasuki GUI. Koordinat ini mungkin bervariasi bahkan ketika mouse memasuki GUI melalui tepi yang sama - terutama ketika mouse memasuki elemen dengan cepat. Ini disebabkan oleh fakta bahwa koordinat menunjukkan posisi mouse ketika peristiwa dipicu daripada momen tepat ketika mouse memasuki GUI.

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

Jika Anda ingin melacak ketika 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.

Dipicu ketika pengguna menggerakkan mouse mereka ke dalam elemen GUI.

Peristiwa MouseLeave dipicu ketika pengguna menggerakkan mouse mereka keluar dari elemen `Class.GuiObject`.

Silakan jangan bergantung pada argumen `x` dan `y` yang diteruskan oleh peristiwa ini sebagai cara yang pasti untuk menentukan di mana mouse pengguna berada ketika meninggalkan GUI. Koordinat ini mungkin bervariasi bahkan ketika mouse meninggalkan GUI melalui tepi yang sama - terutama ketika mouse meninggalkan elemen dengan cepat. Ini disebabkan oleh fakta bahwa koordinat menunjukkan posisi mouse ketika peristiwa dipicu daripada momen tepat ketika mouse meninggalkan GUI.

Peristiwa ini dipicu 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

Dipicu ketika pengguna menggerakkan mouse mereka keluar dari elemen GUI.

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

Perhatikan, peristiwa ini dipicu ketika posisi mouse diperbarui, oleh karena itu akan dipicu berulang kali saat digerakkan.

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

Kode di bawah ini menunjukkan cara 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)
```
Perhatikan bahwa peristiwa ini mungkin tidak dipicu tepat ketika mouse pengguna memasuki atau keluar dari elemen GUI. Oleh karena itu, argumen `x` dan `y` mungkin tidak cocok dengan koordinat tepi GUI dengan sempurna.

##### Lihat Juga

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

GuiObject.MouseMoved

Dipicu setiap kali pengguna menggerakkan mouse mereka saat berada di dalam elemen GUI.

Peristiwa WheelBackward dipicu ketika pengguna menggulir roda mouse mereka ke belakang 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 roda ke belakang. Ini berarti bahwa argumen koordinat mouse **x** dan **y** tidak berubah sebagai hasil 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.MouseWheelForward`

GuiObject.MouseWheelBackward

Dipicu ketika pengguna menggulir roda mouse mereka ke belakang saat mouse berada di atas elemen GUI.

Peristiwa WheelForward dipicu ketika pengguna menggulir roda mouse mereka ke depan 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 roda ke depan. Ini berarti bahwa argumen koordinat mouse **X** dan **Y** tidak berubah sebagai hasil 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

Dipicu ketika pengguna menggulir roda mouse mereka ke depan saat mouse berada di atas 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 dipicu ketika pemilih Gamepad mulai memfokuskan `Class.GuiObject`.

Jika Anda ingin memeriksa dari pemilih Gamepad berhenti memfokuskan elemen GUI, Anda dapat menggunakan peristiwa `Class.GuiObject.SelectionLost`.

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

GuiObject.SelectionGained

Dipicu ketika GuiObject difokuskan 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 dipicu ketika pemilih Gamepad berhenti memfokuskan `Class.GuiObject`.

Jika Anda ingin memeriksa dari pemilih Gamepad mulai memfokuskan elemen GUI, Anda dapat menggunakan peristiwa `Class.GuiObject.SelectionGained`.

Ketika GUI kehilangan fokus pemilihan, nilai dari properti `Class.GuiService.SelectionObject|SelectionObject` berubah menjadi `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

Dipicu ketika pemilih Gamepad berhenti memfokuskan 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.

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

GuiObject.TouchLongPress

touchPositions

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

state

Sebuah `Enum.UserInputState` yang menggambarkan status gestur:

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

Dipicu ketika 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 objek `GuiObject` lainnya. Ini memungkinkan
pemain untuk memanipulasi posisi frame dalam dengan menggerakkan jari mereka di
frame luar.


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

Peristiwa ini dipicu dengan tabel `Datatype.Vector2` yang menggambarkan posisi layar relatif dari jari yang terlibat dalam gestur. Selain itu, ini dipicu 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 semua jari yang terlibat dalam gestur.

totalTranslation

Menunjukkan seberapa jauh gestur pan telah pergi dari titik awalnya.

velocity

Menunjukkan seberapa cepat gestur dilakukan di setiap dimensi.

Menunjukkan `Enum.UserInputState` dari gestur.

Dipicu ketika pemain menggerakkan 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.

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

Peristiwa ini dipicu dengan tabel `Datatype.Vector2` yang menggambarkan posisi layar relatif dari jari yang terlibat dalam gestur. Selain itu, ini dipicu beberapa kali: `Enum.UserInputState.Begin` setelah penundaan singkat, `Enum.UserInputState.Change` ketika pemain menggerakkan jari selama gestur, dan akhirnya dengan `Enum.UserInputState.End`. Perlu dicatat bahwa skala harus digunakan **secara multiplikatif**.

GuiObject.TouchPinch

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

scale

Sebuah float yang menunjukkan perbedaan dari awal gestur cubitan.

Sebuah float yang menunjukkan seberapa cepat gestur cubitan terjadi.

Dipicu ketika pemain melakukan gestur cubitan atau tarik menggunakan dua jari pada elemen UI.

Contoh kode ini ditujukan untuk `LocalScript` di dalam `Frame` yang
berada 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 mencubit atau menarik 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 memanipulasi rotasi elemen UI di layar.

Acara ini terjadi dengan tabel `Datatype.Vector2` yang menggambarkan posisi layar relatif dari jari-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 selama gestur, dan akhirnya dengan `Enum.UserInputState.End`.

GuiObject.TouchRotate

rotation

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

Sebuah float yang menunjukkan seberapa cepat gestur dilakukan.

Ditembak ketika pemain melakukan gestur 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 sapuan 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 sapuan sering digunakan untuk mengganti tab di UI seluler.

GuiObject.TouchSwipe

swipeDirection

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

numberOfTouches

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

Ditembak ketika pemain melakukan gestur 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 ketukan pada elemen UI menggunakan perangkat yang mendukung sentuhan. Ketukan adalah sentuhan cepat tunggal tanpa gerakan yang terlibat (tekanan yang lebih lama akan memicu `Class.GuiObject.TouchLongPress`, dan bergerak selama sentuhan akan memicu `Class.GuiObject.TouchPan` dan/atau `Class.GuiObject.TouchSwipe`). Acara ini terjadi dengan tabel objek `Datatype.Vector2` yang menggambarkan posisi relatif dari jari-jari yang terlibat dalam gestur.

GuiObject.TouchTap

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

Ditembak ketika pemain melakukan gestur 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 halus ke posisi `Datatype.UDim2` baru dalam waktu yang ditentukan menggunakan `Enum.EasingDirection` dan `Enum.EasingStyle` yang ditentukan.

Fungsi ini akan mengembalikan apakah tween akan diputar. Ini tidak akan diputar jika tween lain sedang bertindak pada `Class.GuiObject` dan parameter override adalah `false`.

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

GuiObject:TweenPosition

endPosition

easingDirection

Arah di mana GUI harus dipindahkan ke _endPosition_.

easingStyle

Gaya di mana GUI harus dipindahkan ke _endPosition_.

time

Berapa lama, dalam detik, tween harus selesai.

override

Apakah tween akan menimpa tween yang sedang berlangsung.

callback

Fungsi callback untuk dieksekusi ketika tween selesai.

Memindahkan GUI dengan halus 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 halus ke `Datatype.UDim2` baru dalam waktu yang ditentukan menggunakan `Enum.EasingDirection` dan `Enum.EasingStyle` yang ditentukan.

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

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

GuiObject:TweenSize

endSize

Arah di mana GUI harus dipindahkan ke _endSize_.

Gaya di mana GUI harus dipindahkan ke _endSize_.

Mengubah ukuran `Class.GuiObject` dengan halus ke `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 dengan halus ke ukuran dan posisi `Datatype.UDim2` baru dalam waktu yang ditentukan menggunakan `Enum.EasingDirection` dan `Enum.EasingStyle` yang ditentukan.

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

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

GuiObject:TweenSizeAndPosition

Arah di mana GUI harus dipindahkan ke _endSize_ dan _endPosition_.

Gaya di mana GUI harus dipindahkan ke _endSize_ dan _endPosition_.

Memindahkan GUI dengan halus ke ukuran dan posisi baru.

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 yang mendasari 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 dipicu (`Class.GuiButton.AutoButtonColor|AutoButtonColor` juga akan berfungsi untuk mereka). Peristiwa `Class.GuiObject.InputBegan|InputBegan`, `Class.GuiObject.InputChanged|InputChanged`, dan `Class.GuiObject.InputEnded|InputEnded` berfungsi 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 ukuran absolutnya. Titik asal menentukan dari mana elemen diposisikan (melalui `Class.GuiObject.Position`) dan dari mana `Class.GuiObject.Size` yang dirender berkembang.

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

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 mengubah ukuran objek UI induk berdasarkan ukuran keturunannya. Anda dapat menggunakan properti ini untuk menambahkan teks dan konten lainnya secara dinamis ke objek UI pada waktu edit atau waktu berjalan, dan ukuran 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 mungkin mengubah ukuran tergantung pada konten anaknya.

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

GuiObject.AutomaticSize

Menentukan apakah pengubahan 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 `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 properti visual latar belakang adalah `Class.GuiObject.BackgroundTransparency`; jika ini diatur ke `1`, baik latar belakang maupun batas tidak akan dirender.

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

GuiObject.BackgroundColor3

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

Jika properti ini diatur ke `1`, baik latar belakang maupun batas tidak akan dirender dan latar belakang GUI akan sepenuhnya transparan.

GuiObject.BackgroundTransparency

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

Menentukan warna batas `Class.GuiObject`.

GuiObject.BorderColor

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

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

Perhatikan bahwa komponen `Class.UIStroke` memungkinkan efek batas yang lebih canggih.

GuiObject.BorderColor3

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

Perhatikan bahwa `Class.UIStroke` dapat menimpa properti ini dan memungkinkan efek batas yang lebih canggih.

GuiObject.BorderMode

Menentukan cara batas `Class.GuiObject` diatur relatif terhadap dimensinya.

Properti ini menentukan seberapa lebar batas `Class.GuiObject` dirender, dalam piksel. Mengatur ini ke 0 menonaktifkan batas sepenuhnya.

Perhatikan bahwa `Class.UIStroke` dapat menimpa properti ini dan memungkinkan efek batas yang lebih canggih.

GuiObject.BorderSizePixel

Menentukan lebar piksel dari batas `Class.GuiObject`.

Properti ini menentukan apakah `Class.GuiObject` akan memotong (membuat tidak terlihat) bagian mana pun dari elemen GUI keturunan yang seharusnya dirender di luar batas persegi panjang.

#### Perilaku Rotasi

Ketika `Class.StarterGui.ClipsDescendantsSupportsRotation` diaktifkan, pemotongan berfungsi dengan benar untuk bentuk yang diputar. Namun, pemotongan **oleh** bentuk yang diputar (ketika induk pemotongan itu sendiri diputar) atau oleh sudut membulat (`Class.UICorner`) tidak didukung.

Ketika `Class.StarterGui.ClipsDescendantsSupportsRotation` **tidak** diaktifkan dan `Class.GuiObject` ini atau `Class.GuiObject` neneknya memiliki `Class.GuiObject.Rotation|Rotation` **non-nol**, properti ini akan **diabaikan** dan elemen GUI keturunan akan dirender terlepas dari nilai properti ini.

GuiObject.ClipsDescendants

Menentukan apakah keturunan `Class.GuiObject|GuiObjects` di luar batas elemen GUI induk harus dirender.

Ini menunjukkan apakah `Class.GuiObject` (dan keturunannya) dapat diseret di sekitar layar.

GuiObject.Draggable

Menentukan apakah `Class.GuiObject` (dan keturunannya) dapat diseret di sekitar layar.

Ketika jari pemain sedang diketuk dan ditahan pada `Class.GuiObject`, `Class.GuiObject.GuiState|GuiState` dari `Class.GuiObject` akan diatur ke `Enum.GuiState.Press|Press`. Demikian pula, ketika jari pemain dilepaskan dari `Class.GuiObject`, `Class.GuiObject.GuiState|GuiState` dari `Class.GuiObject` akan diatur ke `Enum.GuiState.Idle|Idle`, dan ketika `Class.GuiObject.Interactable|Interactable` dimatikan pada `Class.GuiObject`, `Class.GuiState` dari `Class.GuiObject` akan diatur ke `Enum.GuiState.NonInteractable|NonInteractable`.

GuiObject.GuiState

Menentukan apakah mouse pemain sedang ditekan aktif pada `Class.GuiObject` atau tidak.

Mengontrol apakah, dan sejauh mana, `Class.GuiObject` menyerap input
yang terjadi di atasnya, menggunakan `Enum.InputSink`. Menyerap input mencegahnya
melalui objek di belakang elemen, termasuk objek 3D
di dunia seperti yang memiliki `Class.ClickDetector` atau
`Class.DragDetector`. Secara default, ini adalah `Enum.InputSink.None`, kecuali pada
objek `Class.GuiButton` (`Class.ImageButton` dan `Class.TextButton`),
yang secara default adalah `Enum.InputSink.Activate`.

- `Enum.InputSink.None` — objek tidak menyerap input sendiri.
- `Enum.InputSink.Activate` — objek menyerap input tekan/lepaskan tombol mouse dan sentuhan
  yang digunakan untuk mengaktifkannya, tetapi membiarkan input lain (seperti
  gerakan mouse) lewat.
- `Enum.InputSink.All` — objek menyerap semua input yang terjadi di atasnya.

Properti ini adalah penerus yang lebih terperinci dari boolean
`Class.GuiObject.Active|Active` property, yang hanya dapat menyerap semua input atau
tidak ada. Peristiwa `Class.GuiObject.InputBegan|InputBegan`,
`Class.GuiObject.InputChanged|InputChanged`, dan
`Class.GuiObject.InputEnded|InputEnded` terjadi terlepas dari nilai properti ini.


GuiObject.InputSink

Mengontrol apakah, dan bagaimana, `Class.GuiObject` menyerap input yang terjadi
di atasnya.


Menentukan apakah `Class.GuiButton` dapat berinteraksi atau tidak, atau jika `Enum.GuiState|GuiState` dari `Class.GuiObject` sedang berubah atau tidak.

Pada `Class.GuiButton`:

- Ketika pengaturan `Class.GuiObject.Interactable|Interactable` pada `Class.GuiButton` diatur ke `false`, `Class.GuiButton` tidak akan dapat ditekan atau diklik lagi, dan `Class.GuiObject.GuiState|GuiState` akan selalu diatur ke `Enum.GuiState.NonInteractable|NonInteractable`.
- Ketika pengaturan `Class.GuiObject.Interactable|Interactable` pada `Class.GuiButton` diatur ke `true`, `Class.GuiButton` akan berfungsi normal kembali dan `Class.GuiObject.GuiState|GuiState` akan berfungsi normal.

Pada `Class.GuiObject`:

- Ketika pengaturan `Class.GuiObject.Interactable|Interactable` pada `Class.GuiButton` diatur ke `false`, `Class.GuiObject.GuiState|GuiState` akan selalu diatur ke `Enum.GuiState.NonInteractable|NonInteractable`.
- Ketika pengaturan `Class.GuiObject.Interactable|Interactable` pada `Class.GuiButton` diatur ke `true`, `Class.GuiObject.GuiState|GuiState` akan berfungsi normal kembali.

GuiObject.Interactable

Menentukan apakah `Class.GuiButton` dapat berinteraksi atau tidak, atau jika `Enum.GuiState|GuiState` dari `Class.GuiObject` sedang berubah atau tidak.

Properti ini mengontrol urutan pengurutan dari `Class.GuiObject` saat menggunakan `Class.UIGridStyleLayout` (seperti `Class.UIListLayout` atau `Class.UIPageLayout`) dengan `Class.UIGridStyleLayout.SortOrder|SortOrder` diatur ke `Enum.SortOrder.LayoutOrder`. Ini tidak memiliki fungsionalitas jika objek tidak memiliki struktur tata letak UI saudara.

`Class.GuiObject|GuiObjects` diurutkan dalam urutan menaik di mana nilai yang lebih rendah memiliki prioritas lebih tinggi daripada nilai yang lebih tinggi. Objek dengan nilai yang sama kembali ke urutan mereka ditambahkan.

Jika Anda tidak yakin apakah Anda akan perlu menambahkan elemen di antara dua elemen yang ada di masa depan, adalah praktik yang baik untuk menggunakan kelipatan `100` (`0`, `100`, `200`, dll.). Ini memastikan celah besar dari nilai urutan tata letak yang dapat Anda gunakan untuk elemen yang diurutkan di antara elemen lainnya.

Lihat juga `Class.GuiObject.ZIndex|ZIndex` yang menentukan urutan **rendering** objek daripada urutan pengurutan.

GuiObject.LayoutOrder

Mengontrol urutan pengurutan dari `Class.GuiObject` saat digunakan dengan `Class.UIGridStyleLayout`.

Contoh ini menunjukkan cara mengaktifkan navigasi Gamepad melalui grid dari
`GuiObject|GUI` elemen tanpa harus menghubungkan secara manual
`Class.GuiObject.NextSelectionUp`, `Class.GuiObject.NextSelectionDown`, dan
`GuiObject|NextSelectionRight`, serta `Class.GuiObject.NextSelectionLeft`
properties untuk setiap elemen dalam grid.

Perhatikan bahwa contoh kode ini mengasumsikan `UIGridLayout` Anda diurutkan berdasarkan
`Class.UIGridLayout.SortOrder|name`, di mana elemen diberi nama dalam urutan
numerik yang berturut-turut.

Kode ini bergantung pada ini untuk mengatur properti NextSelection untuk semua
`GuiObjects` di level yang sama dengan UIGridLayout. Dalam contoh kami, 
UIGridLayoutObject dan elemen GUI dalam grid semuanya adalah anak dari
`Frame` bernama _"Container"_. Kode
`Class.Instance:GetChildren()|mengambil anak-anak` dari _"Container"_ dan mengulangi
setiap anak. Anak-anak yang bukan GuiObjects diabaikan. Untuk setiap elemen GUI,
kode mencoba mengatur properti NextSelection menggunakan logika berikut:

1. Dimulai dengan 1, nama semua elemen GUI cocok dengan posisi mereka dalam
   grid
2. Kiri: Item di sebelah kiri akan selalu diberi nomor 1 lebih rendah dari elemen
   saat ini
3. Kanan: Item di sebelah kanan akan selalu diberi nomor 1 lebih tinggi dari elemen
   saat ini
4. Atas: Item di atas (atas) akan selalu berjumlah jumlah GUIs dalam satu baris 1
   kurang dari elemen saat ini
5. Bawah: Item di bawah (bawah) akan selalu berjumlah jumlah GUIs dalam satu baris
   lebih banyak dari elemen saat ini Logika ini juga memungkinkan elemen GUI di
   awal dan akhir baris (tidak termasuk elemen pertama dan terakhir) untuk
   melingkar kembali ke baris berikutnya dan sebelumnya. Jika elemen tidak ada di
   sebelah kiri, kanan, atas, atau bawah, NextSelection akan tetap nil dan
   menggerakkan pemilih Gamepad ke arah tersebut tidak akan mengubah GUI yang
   terpilih.

Contoh ini juga berisi kode untuk menguji grid menggunakan tombol panah (Atas,
Bawah, Kiri, Kanan) dari keyboard Anda sebagai ganti gamepad, hanya untuk
mengantisipasi jika Anda tidak memiliki gamepad untuk diuji. Bagian kode ini
awalnya memilih elemen bernama _"1"_ dengan menetapkannya ke properti
`Class.GuiService.SelectedObject`.

Properti ini mengatur `Class.GuiObject` yang dipilih ketika pengguna menggerakkan pemilih [gamepad](/input/gamepad) ke bawah. Jika properti ini kosong, menggerakkan gamepad ke bawah tidak akan mengubah GUI yang dipilih.

Menggerakkan pemilih gamepad ke bawah mengatur `Class.GuiService.SelectedObject` ke objek ini kecuali GUI tidak `Class.GuiObject.Selectable|Selectable`. Perhatikan bahwa properti ini dapat diatur ke elemen GUI bahkan jika tidak `Class.GuiObject.Selectable|Selectable`, jadi Anda harus memastikan bahwa nilai properti yang dapat dipilih dari GUI sesuai dengan perilaku yang Anda harapkan.

Lihat juga `Class.GuiObject.NextSelectionUp|NextSelectionUp`, `Class.GuiObject.NextSelectionLeft|NextSelectionLeft`, dan `Class.GuiObject.NextSelectionRight|NextSelectionRight`.

GuiObject.NextSelectionDown

Mengatur `Class.GuiObject` yang akan dipilih ketika pemilih gamepad bergerak ke bawah.

Properti ini mengatur `Class.GuiObject` yang dipilih ketika pengguna menggerakkan pemilih [gamepad](/input/gamepad) ke kiri. Jika properti ini kosong, menggerakkan gamepad ke kiri tidak akan mengubah GUI yang dipilih.

Menggerakkan pemilih gamepad ke kiri mengatur `Class.GuiService.SelectedObject` ke objek ini kecuali GUI tidak `Class.GuiObject.Selectable|Selectable`. Perhatikan bahwa properti ini dapat diatur ke elemen GUI bahkan jika tidak `Class.GuiObject.Selectable|Selectable`, jadi Anda harus memastikan bahwa nilai properti yang dapat dipilih dari GUI sesuai dengan perilaku yang Anda harapkan.

Lihat juga `Class.GuiObject.NextSelectionUp|NextSelectionUp`, `Class.GuiObject.NextSelectionDown|NextSelectionDown`, dan `Class.GuiObject.NextSelectionRight|NextSelectionRight`.

GuiObject.NextSelectionLeft

Mengatur `Class.GuiObject` yang akan dipilih ketika pemilih gamepad bergerak ke kiri.

Properti ini mengatur `Class.GuiObject` yang dipilih ketika pengguna menggerakkan pemilih [gamepad](/input/gamepad) ke kanan. Jika properti ini kosong, menggerakkan gamepad ke kanan tidak akan mengubah GUI yang dipilih.

Menggerakkan pemilih gamepad ke kanan mengatur `Class.GuiService.SelectedObject` ke objek ini kecuali GUI tidak `Class.GuiObject.Selectable|Selectable`. Perhatikan bahwa properti ini dapat diatur ke elemen GUI bahkan jika tidak `Class.GuiObject.Selectable|Selectable`, jadi Anda harus memastikan bahwa nilai properti yang dapat dipilih dari GUI sesuai dengan perilaku yang Anda harapkan.

Lihat juga `Class.GuiObject.NextSelectionUp|NextSelectionUp`, `Class.GuiObject.NextSelectionDown|NextSelectionDown`, dan `Class.GuiObject.NextSelectionLeft|NextSelectionLeft`.

GuiObject.NextSelectionRight

Mengatur `Class.GuiObject` yang akan dipilih ketika pemilih gamepad bergerak ke kanan.

Properti ini mengatur `Class.GuiObject` yang dipilih ketika pengguna menggerakkan pemilih [gamepad](/input/gamepad) ke atas. Jika properti ini kosong, menggerakkan gamepad ke atas tidak akan mengubah GUI yang dipilih.

Menggerakkan pemilih gamepad ke atas mengatur `Class.GuiService.SelectedObject` ke objek ini kecuali GUI tidak `Class.GuiObject.Selectable|Selectable`. Perhatikan bahwa properti ini dapat diatur ke elemen GUI bahkan jika tidak `Class.GuiObject.Selectable|Selectable`, jadi Anda harus memastikan bahwa nilai properti yang dapat dipilih dari GUI sesuai dengan perilaku yang Anda harapkan.

Lihat juga `Class.GuiObject.NextSelectionDown|NextSelectionDown`, `Class.GuiObject.NextSelectionLeft|NextSelectionLeft`, `Class.GuiObject.NextSelectionRight|NextSelectionRight`.

GuiObject.NextSelectionUp

Mengatur `Class.GuiObject` yang akan dipilih ketika pemilih gamepad bergerak ke atas.

Properti ini menentukan posisi piksel dan skalar `Class.GuiObject` menggunakan `Datatype.UDim2`. Posisi terpusat di sekitar `Class.GuiObject.AnchorPoint` objek.

Posisi skalar relatif terhadap ukuran elemen GUI induk, jika ada.

Bagian piksel dari nilai `Datatype.UDim2` adalah sama terlepas dari ukuran GUI induk. Nilai-nilai tersebut mewakili posisi objek dalam piksel. Posisi piksel aktual dari objek dapat dibaca dari properti `Class.GuiBase2d.AbsolutePosition`.

GuiObject.Position

Menentukan posisi piksel dan skalar dari `Class.GuiObject`.

Properti ini menentukan jumlah derajat di mana `Class.GuiObject` diputar. Rotasi relatif terhadap **pusat** objek, **bukan** `Class.GuiObject.AnchorPoint|AnchorPoint`, yang berarti Anda tidak dapat mengubah titik rotasi. Selain itu, properti ini tidak kompatibel dengan `Class.GuiObject.ClipsDescendants|ClipsDescendants`.

GuiObject.Rotation

Menentukan jumlah derajat di mana `Class.GuiObject` diputar.

Kelas abstrak untuk semua objek antarmuka pengguna 2D.

/reference/engine/classes/TextChannelWindow.yaml