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

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

Properti yang diatur pada `Class.ChatWindowConfiguration` tidak berlaku untuk jendela ini.

Anak yang diterima: `Class.UICorner`, `Class.UIAspectRatioConstraint`,
`Class.UISizeConstraint`, dan skrip (`Class.LocalScript`, `Class.Script`,
`Class.ModuleScript`); jenis 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

TextChannel yang pesan-pesannya ditampilkan di jendela ini.


Menampilkan saluran RBXGeneral dalam jendela kustom dengan font yang tidak default. Tempel
ke dalam LocalScript.


Font yang digunakan untuk merender pesan jendela ini dan bilah inputnya. Diterapkan hanya
ketika `Class.TextChannelWindow.UseDefaultFont` adalah `false`.

TextChannelWindow.FontFace

Font yang digunakan untuk merender teks di jendela ini.

Ketika `true` (default), jendela menggunakan font default platform langsung.
Ketika `false`, jendela menggunakan `Class.TextChannelWindow.FontFace|FontFace`.

TextChannelWindow.UseDefaultFont

Apakah jendela ini menggunakan font default platform langsung.

Sebuah GuiObject yang menampilkan pesan obrolan dari TextChannel yang terkait.


`Class.GuiObject` adalah kelas abstrak (mirip dengan `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
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
tekan, 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
tekan, 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 diberikan oleh peristiwa ini sebagai cara yang
pasti untuk menentukan di mana mouse pengguna berada ketika memasuki GUI. Koordinat ini dapat bervariasi bahkan ketika mouse memasuki GUI melalui
tepi yang sama - terutama ketika mouse memasuki elemen dengan cepat. Ini
karena 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
bisa 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 diberikan oleh peristiwa ini sebagai cara yang
pasti untuk menentukan di mana mouse pengguna berada ketika meninggalkan GUI. Koordinat ini dapat bervariasi bahkan ketika mouse meninggalkan GUI melalui
tepi yang sama - terutama ketika mouse meninggalkan elemen dengan cepat. Ini
karena 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.

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

Perhatikan, bahwa peristiwa ini terjadi ketika posisi mouse diperbarui, oleh karena itu
akan terjadi 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
pada GUI, layar, dan delta sejak posisi mouse sebelumnya
jika dilacak dalam variabel global.

Kode di bawah ini menunjukkan cara menentukan offset `Datatype.Vector2`
dari mouse pengguna relatif terhadap elemen GUI.
`Class.GuiObject.AbsolutePosition|AbsolutePosition` diukur di dalam
inset GUI layar, sementara argumen `x` dan `y` dari peristiwa ini adalah
koordinat layar yang menyertakannya, jadi contoh memanggil
`Class.GuiService:GetGuiInset()|GetGuiInset()` untuk menyelaraskan kedua ruang
alih-alih mengasumsikan ukuran inset tetap.

```lua
local Players = game:GetService("Players")
local GuiService = game:GetService("GuiService")

local CustomScrollingFrame = script.Parent
local SubFrame = CustomScrollingFrame:FindFirstChild("SubFrame")

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	local topLeftInset = GuiService:GetGuiInset()

	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 - topLeftInset.Y))
	print(pos)
end

CustomScrollingFrame.MouseMoved:Connect(getPosition)
```
Perhatikan bahwa peristiwa ini mungkin tidak terjadi tepat ketika mouse pengguna masuk atau
keluar dari elemen GUI. Oleh karena itu, argumen `x` dan `y` mungkin tidak cocok
secara sempurna dengan koordinat tepi GUI.

##### 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 terpicu 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
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.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 terpicu 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 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

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
`Class.GuiService.SelectedObject|SelectedObject` juga berubah ke
objek yang mendapatkan pemilihan. Untuk menentukan GUI mana yang mendapatkan pemilihan, periksa
nilai dari properti ini.

GuiObject.SelectionGained

inputDirection

Arah navigasi yang memindahkan pemilihan ke objek ini, atau
`Enum.GuiNavigationDirection.None` jika pemilihan tidak berubah melalui
input navigasi.


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

Arah navigasi yang memindahkan pemilihan menjauh dari objek ini,
atau `Enum.GuiNavigationDirection.None` jika pemilihan tidak berubah
melalui input navigasi.


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 gerakan. Selain itu, ini dipicu beberapa kali:
`Enum.UserInputState.Begin` setelah penundaan singkat,
`Enum.UserInputState.Change` jika pemain menggerakkan jari mereka selama
gerakan, 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 gerakan.

state

Sebuah `Enum.UserInputState` yang menggambarkan status gerakan:

- Begin dipicu sekali di awal gerakan (setelah penundaan singkat)
- Change dipicu jika pemain menggerakkan jari mereka saat menekan
- End dipicu sekali di akhir gerakan 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 gerakan. Selain itu, ini dipicu beberapa kali:
`Enum.UserInputState.Begin` setelah penundaan singkat,
`Enum.UserInputState.Change` ketika pemain menggerakkan jari mereka selama
gerakan, dan akhirnya dengan `Enum.UserInputState.End`.

GuiObject.TouchPan

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

totalTranslation

Menunjukkan seberapa jauh gerakan pan telah pergi dari titik awalnya.

velocity

Menunjukkan seberapa cepat gerakan dilakukan di setiap
dimensi.

Menunjukkan `Enum.UserInputState` dari gerakan.

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.

Acara ini terjadi ketika pemain menggunakan dua jari untuk membuat gerakan 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 menjauh. Acara ini terjadi bersamaan dengan `Class.GuiObject.TouchPan`. Acara ini berguna untuk memungkinkan pemain memanipulasi 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-jari yang terlibat dalam gerakan. Selain itu, acara ini terjadi beberapa kali: `Enum.UserInputState.Begin` setelah jeda singkat, `Enum.UserInputState.Change` ketika pemain menggerakkan jari selama gerakan, 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 gerakan pinch.

scale

Sebuah float yang menunjukkan perbedaan dari awal gerakan pinch.

Sebuah float yang menunjukkan seberapa cepat gerakan pinch terjadi.

Menunjukkan `Enum.UserInputState` dari gerakan tersebut.

Dipicu ketika pemain melakukan gerakan pinch atau pull 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 gerakan rotasi 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 gerakan. Selain itu, acara ini terjadi beberapa kali: `Enum.UserInputState.Begin` setelah jeda singkat, `Enum.UserInputState.Change` ketika pemain menggerakkan jari selama gerakan, 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 tersebut dilakukan.

Terjadi ketika 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 gerakan swipe pada elemen UI menggunakan perangkat yang mendukung sentuhan. Acara ini terjadi dengan arah gerakan (Atas, Bawah, Kiri atau Kanan) dan jumlah titik sentuh yang terlibat dalam gerakan. Gerakan swipe sering digunakan untuk mengganti tab di UI seluler.

GuiObject.TouchSwipe

swipeDirection

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

numberOfTouches

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

Terjadi ketika pemain melakukan gerakan swipe 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 gerakan tap pada elemen UI menggunakan perangkat yang mendukung sentuhan. Tap 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 gerakan.

GuiObject.TouchTap

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

Terjadi ketika pemain melakukan gerakan tap 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.

Dengan halus memindahkan GUI ke posisi `Datatype.UDim2` baru dalam waktu yang ditentukan menggunakan `Enum.EasingDirection` dan `Enum.EasingStyle` yang ditentukan.
Metode ini akan menghasilkan kesalahan jika `easingStyle` adalah `Enum.EasingStyle.Bezier` atau `Enum.EasingStyle.Spring`.

Fungsi ini akan mengembalikan apakah tween akan diputar. Ini tidak akan diputar jika tween lain sedang beraksi 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).

Dengan halus mengubah ukuran `Class.GuiObject` ke `Datatype.UDim2` baru dalam waktu yang ditentukan menggunakan `Enum.EasingDirection` dan `Enum.EasingStyle` yang ditentukan. Metode ini akan menghasilkan kesalahan jika `easingStyle` adalah `Enum.EasingStyle.Bezier` atau `Enum.EasingStyle.Spring`.

Fungsi ini akan mengembalikan apakah tween akan diputar. Biasanya ini akan selalu mengembalikan `true`, tetapi akan mengembalikan `false` jika tween lain aktif dan override disetel 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.

Dengan halus mengubah ukuran dan memindahkan GUI ke ukuran dan posisi `Datatype.UDim2` baru dalam waktu yang ditentukan menggunakan `Enum.EasingDirection` dan `Enum.EasingStyle` yang ditentukan. Metode ini akan menghasilkan kesalahan jika `easingStyle` adalah `Enum.EasingStyle.Bezier` atau `Enum.EasingStyle.Spring`.

Fungsi ini akan mengembalikan apakah tween akan diputar. Biasanya ini akan selalu mengembalikan `true`, tetapi akan mengembalikan `false` jika tween lain aktif dan override disetel 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 dan mengubah ukuran 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
secara dinamis dan konten lainnya ke objek UI pada waktu edit atau waktu berjalan, dan ukuran akan
menyesuaikan 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
berkontras dengan warna teks.

Properti lain yang menentukan properti visual latar belakang
adalah `Class.GuiObject.BackgroundTransparency`; jika ini diatur ke `1`,
tidak ada latar belakang atau batas yang 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`, tidak ada latar belakang atau batas yang 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 tepi).
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
render di luar batas persegi panjang.

#### Perilaku Rotasi

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

Ketika `Class.StarterGui.ClipsDescendantsSupportsRotation` **tidak**
diaktifkan dan `Class.GuiObject` ini atau `Class.GuiObject` nenek mana pun 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`. Ini secara default diatur ke `Enum.InputSink.None`, kecuali pada
objek `Class.GuiButton` (`Class.ImageButton` dan `Class.TextButton`),
yang secara default diatur ke `Enum.InputSink.Activate`.

- `Enum.InputSink.None` — objek tidak menyerap input dengan sendirinya.
- `Enum.InputSink.Activate` — objek menyerap input tekan/touch
  mouse-button 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` 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
apakah `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
apakah `Enum.GuiState|GuiState` dari `Class.GuiObject` sedang berubah atau
tidak.

Properti ini mengontrol urutan sortir 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 sortir.

GuiObject.LayoutOrder

Mengontrol urutan sortir 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 dari properti dapat dipilih 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 dari properti dapat dipilih 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.

Kelas abstrak untuk semua objek antarmuka pengguna 2D.

/reference/engine/classes/TextChannelWindow.yaml

Ringkasan