GuiButton
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
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
Menentukan apakah tombol secara otomatis berubah warna saat mouse mengarah ke atau mengkliknya.
Sebuah instansi HapticEffect yang akan dimainkan saat GuiButton di-hover.
Jika true saat elemen GUI terlihat, mouse tidak akan dikunci kecuali tombol mouse kanan turun.
Sebuah instansi HapticEffect yang akan dimainkan saat GuiButton ditekan.
Properti boolean yang menunjukkan apakah objek telah dipilih.
Mengatur gaya dari GuiButton berdasarkan daftar gaya yang telah ditentukan sebelumnya.
Menentukan apakah elemen UI ini menenggelamkan input.
Menentukan titik asal dari GuiObject , relatif terhadap ukuran absolutnya.
Menentukan apakah penyesuaian ulang terjadi berdasarkan konten anak.
Menentukan warna latar belakang GuiObject.
Menentukan transparansi latar belakang dan border GuiObject .
Menentukan warna border GuiObject .
Menentukan dengan cara apa perbatasan GuiObject diletakkan relatif terhadap dimensinya.
Menentukan lebar piksel dari batas GuiObject .
Menentukan apakah keturunan GuiObjects di luar batas elemen GUI orangtua harus ditampilkan.
Menentukan apakah mouse pemain ditekan secara aktif di GuiObject atau tidak.
Menentukan apakah GuiButton dapat berinteraksi atau tidak, atau apakah GuiState dari GuiObject berubah atau tidak.
Mengontrol urutan sortir dari GuiObject ketika digunakan dengan UIGridStyleLayout .
Tetapkan GuiObject yang akan dipilih saat pemilih gamepad dipindahkan ke bawah.
Tetapkan GuiObject yang akan dipilih saat pemilih gamepad dipindahkan ke kiri.
Tetapkan GuiObject yang akan dipilih saat pemilih gamepad dipindahkan ke kanan.
Tetapkan GuiObject yang akan dipilih saat pemilih gamepad dipindahkan ke atas.
Menentukan posisi piksel dan skalar dari GuiObject .
Menentukan jumlah derajat di mana GuiObject diputar.
Tentukan apakah GuiObject dapat dipilih oleh gamepad.
Menggantikan dekorasi seleksi default yang digunakan untuk gamepad.
Pesanan dari GuiObjects dipilih oleh pilihan UI gamepad.
Menentukan ukuran piksel dan skala dari GuiObject .
Mengatur sumbu yang akan didasarkan pada, relatif terhadap ukuran orang tuanya.
Properti campuran dari BackgroundTransparency dan TextTransparency.
Menentukan apakah GuiObject dan keturunannya akan ditampilkan.
Menentukan urutan di mana sebuah GuiObject ditampilkan relatif terhadap yang lain.
Menggambarkan posisi layar aktual dari elemen GuiBase2d , dalam piksel.
Menggambarkan rotasi layar aktual dari elemen GuiBase2d , dalam derajat.
Menggambarkan ukuran layar aktual dari elemen GuiBase2d , dalam piksel.
Ketika diatur ke true , lokalisasi akan diterapkan ke GuiBase2d dan keturunannnya.
Referensi ke LocalizationTable untuk digunakan untuk menerapkan lokalisasi otomatis ke GuiBase2d dan keturunannnya.
Sesuaikan perilaku pemilihan gamepad dalam arah turun.
Sesuaikan perilaku pemilihan gamepad di arah kiri.
Sesuaikan perilaku pemilihan gamepad di arah yang benar.
Sesuaikan perilaku pemilihan gamepad dalam arah atas.
Memungkinkan kustomisasi gerakan seleksi gamepad.
Metode
Metode diwarisi dari GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Dengan lancar memindahkan GUI ke baru UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Dengan lancar memindahkan GUI ke ukuran dan posisi baru.
Acara
Melepaskan api saat tombol diaktifkan.
Memicu ketika mouse pengguna sepenuhnya menekan klik GuiButton .
Melepaskan api saat pengguna menekan tombol mouse kiri mereka ke bawah pada GuiButton.
Melepaskan api saat pengguna melepaskan tombol mouse kiri mereka dari GuiButton .
Memicu ketika mouse pengguna sepenuhnya mengklik kanan pada GuiButton .
Melepaskan api saat pengguna menekan tombol mouse kanan mereka ke bawah pada GuiButton.
Melepaskan api saat pengguna melepaskan tombol mouse kanan mereka dari GuiButton .
Ditembak ketika pengguna mulai berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse turun, sentuhan mulai, tombol keyboard turun, dll).
Ditembak ketika pengguna mengubah cara mereka berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse turun, sentuhan mulai, tombol keyboard turun, dll).
Ditembak ketika pengguna berhenti berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse turun, sentuhan mulai, tombol keyboard turun, dll).
Melepaskan api saat pengguna memindahkan mouse ke elemen GUI.
Melepaskan api saat pengguna memindahkan mouse mereka keluar dari elemen GUI.
Melepaskan api setiap kali pengguna memindahkan mouse saat berada di dalam elemen GUI.
Melepaskan api saat pengguna menggulir roda mouse kembali saat mouse berada di atas elemen GUI.
Melepaskan api saat pengguna menggulir roda mouse ke depan saat mouse berada di atas elemen GUI.
Ditembak ketika GuiObject difokuskan dengan pemilih Gamepad.
Ditembak ketika pemilih Gamepad berhenti fokus pada GuiObject.
Melepaskan api saat pemain mulai, melanjutkan dan berhenti menekan tombol UI dalam waktu lama.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Melepaskan api saat pemain menggerakkan jari mereka di elemen UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Melepaskan api saat pemain melakukan gerakan pinch atau pull menggunakan dua jari di elemen UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Melepaskan api saat pemain melakukan gerakan rotasi menggunakan dua jari di elemen UI.
Melepaskan api saat pemain melakukan gerakan geser pada elemen UI.
Melepaskan api saat pemain melakukan gerakan geser di elemen UI.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Memicu ketika pemilihan gamepad bergerak ke, meninggalkan, atau berubah di dalam terhubung GuiBase2d atau keturunan mana pun GuiObjects .
Properti
AutoButtonColor
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 .
Modal
Jika true saat elemen GUI terlihat, mouse tidak akan dikunci kecuali tombol mouse kanan turun.
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
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
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
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
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.