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 Class.ImageButton</
Acara paling penting dari GuiButton adalah GuiButton.Activated, acara multi-platform yang diaktifkan saat tombol diaktifkan. Saat menggunakan mouse, ini berarti mengklik tombol dan melepaskan d
Rangkuman
Properti
Menentukan apakah tombol secara otomatis berubah warna saat mouse mengambilnya atau mengkliknya.
Jika benar saat elemen GUI terlihat, mouse tidak akan terkunci kecuali tombol mouse yang benar adalah turun.
Propinsi booleh yang menunjukkan apakah objek telah dipilih.
Tetapkan gaya GuiButton berdasarkan daftar gaya pra-determinasi.
Mengukur apakah elemen UI ini menyinkronkan input.
Menentukan titik asal dari GuiObject , relatif ke ukurannya yang relatif.
Mengukur apakah resizing terjadi berdasarkan konten anak.
Menentukan warna latar belakang GuiObject .
Mengukur transparansi latar belakang dan batas Class.GuiObject .
Mengubah warna batas GuiObject .
Menentukan cara apa GuiObject batas diletakkan relatif terhadap dimensinya.
Mengukur lebar pixel dari batas GuiObject .
Menentukan apakah turunan GuiObjects di luar batas-batas elemen GUI orang tua harus rendah.
Menentukan apakah mouse pemain diaktif ditekan di GuiObject atau tidak.
Mengesok apakah GuiButton dapat diinteraksikan dengan atau tidak, atau apakah GuiState dari GuiObject berubah atau tidak.
Mengontrol urutan sortiran GuiObject saat digunakan dengan UIGridStyleLayout.
Tetapkan GuiObject yang akan dipilih saat penyeleksi gamepad di geser ke bawah.
Tetapkan GuiObject yang akan dipilih ketika pemilih gamepad di pindahkan ke kiri.
Tetapkan GuiObject yang akan dipilih ketika pemilih gamepad ditempatkan ke kanan.
Tetapkan GuiObject yang akan dipilih saat pemilih gamepad digerakkan ke atas.
Mengukur posisi pixel dan skala dari GuiObject .
Mengukur jumlah derajat di mana GuiObject berputar.
Tentukan apakah GUI dapat dipilih oleh gamepad.
Menggeser ornamen pilihan default yang digunakan untuk gamepad.
Urutan dari GuiObjects yang dipilih oleh pemilihan UI gamepad.
Mengukur ukuran pixel dan skala Class.GuiObject .
Tetapkan Size sumbu yang akan diperhitungkan berdasarkan ukuran GuiObject .
Propinsi bercampur dari BackgroundTransparency dan TextTransparency .
Menentukan apakah GuiObject dan nenek moyangnya akan di render.
Mengesepakati urutan di mana GuiObject menyajikan relatif terhadap yang lain.
Menggambarkan posisi layar sebenarnya dari elemen UI, dalam pixel.
Menggambarkan rotasi layar sebenarnya dari elemen UI, dalam derajat.
Menggambarkan ukuran layar sebenarnya dari elemen UI, dalam pixel.
Ketika diatur ke benar, lokalisasi akan diterapkan ke GuiBase2d dan pendahulunya.
Sebuah referensi ke Class.LocalizationTable untuk digunakan untuk menerapkan lokalisasi otomatis ke GuiBase2d dan pendahulunya.
Mengubah perilaku pemilihan gamepad ke arah bawah.
Mengubah perilaku pemilihan gamepad di arah kiri.
Mengubah perilaku pemilihan gamepad ke arah yang benar.
Mengubah perilaku pemilihan gamepad ke arah atas.
Memungkinkan kustomisasi gerakan pemilihan gamepad.
Metode
Metode diwarisi dari GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Dengan mudah pindahkan GUI ke Datatype.UDim2 baru.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Mendeteksi ukuran GUI secara halus ke ukuran baru UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Dengan mudah pindahkan GUI ke ukuran dan posisi baru.
Acara
Dibakar saat tombol diaktifkan.
Diaktifkan ketika mouse telah sepenuhnya meninggalkan tombol GUI.
Diaktifkan saat mouse berada dalam status tengah tulang kiri pada objek GUI.
Diaktifkan saat mouse kiri telah melepaskan objek GUI.
Diaktifkan saat mouse telah benar-benar menekan tombol GUI.
Diaktifkan saat mouse berada dalam posisi tepat mouse ke bawah pada objek GUI.
Diaktifkan saat tombol kanan tikus telah dilepaskan pada GUI Object.
Diaktifkan saat seorang pengguna mulai berinteraksi melalui perangkat Human-Computer Interface (Tombol pemutar, sentuh mulai, tombol keyboard, dll).
Diaktifkan ketika pengguna mengubah cara mereka berinteraksi melalui perangkat Human-Computer Interface (Tombol pengguna, sentuh dimulai, tombol keyboard, dll).
Diaktifkan saat seorang pengguna berhenti berinteraksi melalui perangkat Human-Computer Interface (Tombol pemutar, sentuh dimulai, tombol keyboard, dll).
Mengaktifkan saat pengguna menggerakkan mouse mereka ke elemen GUI.
Mengaktifkan saat pengguna menyesuaikan mouse mereka keluar dari elemen GUI.
Mengaktifkan setiap kali seorang pengguna menggerakkan mouse mereka saat berada di dalam elemen GUI.
Tembak ketika pengguna menggulir roda mouse mereka kembali saat mouse berada di atas elemen GUI.
Menembak ketika seorang pengguna menggulir roda mouse mereka ke depan ketika mouse berada di atas elemen GUI.
Diaktifkan saat GuiObject fokus dengan Gamepad selektor.
Diaktifkan saat Gamepad selektor berhenti fokus pada GuiObject.
Berdasarkan ketika pemain memulai, lanjutkan dan berhenti menggunakan elemen UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Dibakar saat pemain menyeret jari mereka di elemen UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Menembak ketika pemain melakukan gerakan gesek atau tarikan menggunakan dua jari pada elemen UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Dibakar saat pemain melakukan gerakan rotasi menggunakan dua jari di elemen UI.
Dibakar saat pemain melakukan gerakan geser di elemen UI.
Dibakar saat pemain melakukan gerakan gesek pada elemen UI.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Dibakar saat pemilihan gamepad bergerak ke, pergi, atau berganti di dalam GuiBase2d atau GuiObjek Descendant apa pun.
Properti
AutoButtonColor
Tombol OtomatisColor menentukan apakah tombol secara otomatis berubah warna ketika tombol di atas atau diklik pengguna.
Jika benar, tombol akan secara otomatis berubah warna saat mouse mengambilnya atau mengkliknya. Jika benar, tombol tidak akan berubah.
Jika Anda ingin menyesuaikan cara tombol berubah saat mouse pengguna mengambang di atas atau mengklik tombol, pertimbangkan menggunakan GUI ImageButton dan mengubah elemen ImageButton.HoverImage dan ImageButton.PressedImage.
Harap perhatikan bahwa properti ini tidak akan memiliki efek pada sebuah ImageButton jika itu adalah properti ImageButton.Image dan ditetapkan ke dalam gambar dan bukan nol. Selain itu, properti ini tidak akan mempengaruhi elemen ImageButton pada sa
Contoh Kode
The code below enables a button's GuiButton.AutoButtonColor as long as it it not a ImageButton with ImageButton.HoverImage and ImageButton.PressedImage properties set to images.
In order for the code to work as expected, it must be placed in a LocalScript that is a child of the button.
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = trueModal
Jika benar saat elemen GUI terlihat, mouse tidak akan terkunci kecuali tombol mouse yang benar adalah turun.
Metode
Acara
Activated
Diaktifkan ketika tombol diaktifkan. Karena acara ini tidak diaktifkan di server, itu hanya boleh digunakan dalam LocalScript , atau di Script dengan RunContext dari 2> Ennum.RunContext.Client2>.
Parameter
MouseButton1Click
Acara MouseButton1Click diaktifkan saat Mouse pengguna sepenuhnya meninggalkan klik tombol GUI.
Dengan mengklik, mouse harus berada dalam batas tombol dan harus ditekan ke bawah dan ke atas lagi sebelum acara ini menyetir. Jika mouse meninggalkan batas tombol dan dilepaskan, acara ini tidak akan menyetir. Jika Anda ingin menghindari batasan ini, Anda dapat menggunakan Class.GuiButton.MouseButton
Acara ini mirip dengan GuiButton.MouseButton2Click, yang bersikap sama kecuali bahwa itu terhubung dengan tombol kanan pengguna.
Catat bahwa acara ini hanya akan menghasilkan untuk tombol GUI, termasuk TextButtons dan ImageButton. Ini tidak akan menghasilkan untuk GuiObjects lainnya.
Contoh Kode
The code sample below demonstrates how to use the GuiButton.MouseButton1Click and GuiButton.MouseButton2Click events to handle user left and right mouse button input on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local button = script.Parent
local function leftClick()
print("Left mouse click")
end
local function rightClick()
print("Right mouse click")
end
button.MouseButton1Click:Connect(leftClick)
button.MouseButton2Click:Connect(rightClick)MouseButton1Down
Acara MouseButton1Down terjadi ketika pengguna menekan tombol kiri mereka di GUI objek.
Acara ini mirip dengan GuiButton.MouseButton2Down, yang bersikap sama kecuali bahwa itu terhubung dengan tombol kanan pengguna.
Jika Anda mencari acara yang mengharuskan pengguna untuk menekan dan melepaskan mouse kiri mereka di GUI agar acara tersebut berakhir, pertimbangkan menggunakan GuiButton.MouseButton1Click .
Catat bahwa acara ini hanya akan menghasilkan untuk tombol GUI, termasuk TextButtons dan ImageButton. Ini tidak akan menghasilkan untuk GuiObjects lainnya.
Parameter
Contoh Kode
The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton1Up
Acara MouseButton1Up menyebabkan ketika pengguna melepaskan mouse mereka kiri Mouse dari objek GUI.
Acara ini mirip dengan GuiButton.MouseButton2Up, yang bersikap sama kecuali bahwa itu terhubung dengan tombol kanan pengguna.
Jika Anda mencari acara yang mengharuskan pengguna untuk menekan dan melepaskan mouse kiri mereka di GUI agar acara tersebut berakhir, pertimbangkan menggunakan GuiButton.MouseButton1Click .
Catat bahwa acara ini hanya akan menghasilkan untuk tombol GUI, termasuk TextButtons dan ImageButton. Ini tidak akan menghasilkan untuk GuiObjects lainnya.
Parameter
Contoh Kode
The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton2Click
Acara MouseButton2Click diaktifkan saat Mouse pengguna benar-benar mengklik tombol GUI.
Dengan mengklik, mouse harus berada dalam batas tombol dan harus ditekan ke bawah dan ke atas lagi sebelum acara ini menyetir. Jika mouse meninggalkan batas tombol dan dilepaskan, acara ini tidak akan menyetir. Jika Anda ingin menghindari batasan ini, Anda dapat menggunakan Class.GuiButton.MouseButton
Acara ini mirip dengan GuiButton.MouseButton1Click, yang bersikap sama kecuali bahwa itu terhubung ke tombol kiri mouse pengguna.
Catat bahwa acara ini hanya akan menghasilkan untuk tombol GUI, termasuk TextButtons dan ImageButton. Ini tidak akan menghasilkan untuk GuiObjects lainnya.
Contoh Kode
Demonstrates how to use the GuiButton.MouseButton2Click event to detect when a user right clicks a GuiButton.
The mouse has to be in bounds of the button and has to be pressed down and up again before this event fires.
Note: place the "RightClickScreenGui" within StarterGui for this sample to work properly.
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
Acara MouseButton2Down menyetel saat pengguna menekan tombol kanan mereka di objek GUI.
Acara ini mirip dengan GuiButton.MouseButton1Down, yang bersikap sama kecuali bahwa itu terhubung ke tombol kiri mouse pengguna.
Jika Anda mencari acara yang mengharuskan pengguna untuk menekan dan melepaskan mouse kanan mereka di GUI agar acara tersebut berjalan, pertimbangkan menggunakan GuiButton.MouseButton2Click .
Catat bahwa acara ini hanya akan menghasilkan untuk tombol GUI, termasuk TextButtons dan ImageButton. Ini tidak akan menghasilkan untuk GuiObjects lainnya.
Parameter
Contoh Kode
The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)
MouseButton2Up
Acara MouseButton2Up diaktifkan saat pengguna melepaskan tombol kanan mereka Mouse di luar objek GUI.
Acara ini mirip dengan GuiButton.MouseButton1Up, yang bersikap sama kecuali bahwa itu terhubung ke tombol kiri mouse pengguna.
Jika Anda mencari acara yang mengharuskan pengguna untuk menekan dan melepaskan mouse kanan mereka di GUI agar acara tersebut berjalan, pertimbangkan menggunakan GuiButton.MouseButton2Click .
Catat bahwa acara ini hanya akan menghasilkan untuk tombol GUI, termasuk TextButtons dan ImageButton. Ini tidak akan menghasilkan untuk GuiObjects lainnya.
Parameter
Contoh Kode
The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)