GuiButton

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat
Tidak Dapat Dijelajahi

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

Peristiwa paling penting dari GuiButton adalah Activated , sebuah acara multi-platform yang menyala saat tombol diaktifkan.Saat menggunakan mouse, ini berarti mengklik tombol dan melepaskan dengan kursor masih di atas objek UI.Untuk sentuhan, hal yang sama berlaku tetapi dengan sentuhan alih-alih menekan tombol.Akhirnya, untuk gamepad, Activated terbakar jika GuiButton dipilih saat tombol A ditekan dan dilepaskan.Singkatnya, acara ini sangat berguna untuk pemrograman antarmuka pengguna multi-platform karena memberikan antarmuka umum yang bagus untuk input pengguna tunggal.

Rangkuman

Properti

Properti diwarisi dari GuiObjectProperti diwarisi dari GuiBase2d

Metode

Metode diwarisi dari GuiObject

Acara

Acara diwarisi dari GuiObjectAcara diwarisi dari GuiBase2d

Properti

AutoButtonColor

Baca Paralel

Properti ini menentukan apakah tombol secara otomatis berubah warna saat pengguna menyorot atau mengkliknya Mouse.Jika true , tombol akan secara otomatis berubah warna saat mouse mengarah ke atau mengkliknya.Jika false , tombol tidak akan berubah.

Jika Anda ingin menyesuaikan bagaimana tombol berubah saat mouse pengguna mengarah ke atau mengkliknya, pertimbangkan untuk menggunakan ImageButton dan mengubah elemen HoverImage dan PressedImage.

Harap dicatat bahwa properti ini tidak akan memiliki efek pada ImageButton jika properti Image diatur ke gambar.Selain itu, properti ini tidak akan memengaruhi ImageButton pada hover mouse saat HoverImage tidak nil , atau pada klik mouse jika PressedImage tidak nil .

HoverHapticEffect

Baca Paralel

Sebuah instansi HapticEffect yang akan dimainkan saat GuiButton di-hover.

Baca Paralel

Jika true saat elemen GUI terlihat, mouse tidak akan dikunci kecuali tombol mouse kanan turun.

PressHapticEffect

Baca Paralel

Sebuah instansi HapticEffect yang akan dimainkan saat GuiButton ditekan.

Selected

Baca Paralel

Properti boolean yang menunjukkan apakah objek telah dipilih.

Baca Paralel

Mengatur gaya dari GuiButton berdasarkan daftar gaya yang telah ditentukan sebelumnya.

Metode

Acara

Activated

Melepaskan api saat tombol diaktifkan.Karena acara ini tidak menembak di server, itu harus digunakan hanya di LocalScript , atau di Script dengan RunContext dari Enum.RunContext.Client .

Parameter

inputObject: InputObject
clickCount: number

MouseButton1Click

Peristiwa ini terjadi ketika mouse pengguna sepenuhnya menekan klik GuiButton .

Mengenai klik, mouse harus berada dalam batas GuiButton dan tombol mouse harus ditekan ke bawah dan ke atas lagi sebelum peristiwa ini terjadi.Jika mouse meninggalkan batas GuiButton dan dilepaskan, acara tidak akan ditembak.Jika Anda ingin menghindari batasan ini, Anda dapat menggunakan MouseButton1Down dan MouseButton1Up ; peristiwa ini mirip tetapi akan menembak setiap kali pengguna menekan tombol mouse kiri atau kanan mereka, masing-masing.


MouseButton1Down

Peristiwa ini terjadi ketika pengguna menekan tombol mouse kiri mereka ke bawah di GuiButton .

Untuk acara yang memerlukan pengguna untuk menekan dan melepaskan mouse kiri mereka di GuiButton agar acara dapat ditembakkan, pertimbangkan untuk menggunakan MouseButton1Click.

Parameter

Koordinat layar mouse X dalam piksel.

Koordinat layar mouse Y dalam piksel.


MouseButton1Up

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

Untuk acara yang memerlukan pengguna untuk menekan dan melepaskan mouse kiri mereka di GuiButton agar acara dapat ditembakkan, pertimbangkan untuk menggunakan MouseButton1Click.

Parameter

Koordinat layar mouse X dalam piksel.

Koordinat layar mouse Y dalam piksel.


MouseButton2Click

Peristiwa ini terjadi ketika mouse pengguna sepenuhnya mengklik kanan pada GuiButton.

Mengenai klik, mouse harus berada dalam batas GuiButton dan tombol mouse harus ditekan ke bawah dan ke atas lagi sebelum peristiwa ini terjadi.Jika mouse meninggalkan batas GuiButton dan dilepaskan, acara tidak akan ditembak.Jika Anda ingin menghindari batasan ini, Anda dapat menggunakan MouseButton2Down dan MouseButton2Up ; peristiwa ini mirip tetapi akan menembak setiap kali pengguna menekan tombol mouse kanan atau atas, masing-masing.


MouseButton2Down

Peristiwa ini terjadi ketika pengguna menekan tombol mouse kanan mereka ke bawah di GuiButton .

Untuk acara yang memerlukan pengguna untuk menekan dan melepaskan mouse kanan mereka di GuiButton agar acara dapat ditembakkan, pertimbangkan untuk menggunakan MouseButton2Click.

Parameter

Koordinat layar mouse X dalam piksel.

Koordinat layar mouse Y dalam piksel.


MouseButton2Up

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

Untuk acara yang memerlukan pengguna untuk menekan dan melepaskan mouse kanan mereka di GuiButton agar acara dapat ditembakkan, pertimbangkan untuk menggunakan MouseButton2Click.

Parameter

Koordinat layar mouse X dalam piksel.

Koordinat layar mouse Y dalam piksel.