PluginToolbarButton
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Tombol PluginToolbar adalah objek yang dibuat oleh fungsi PluginToolbar:CreateButton().Ini memungkinkan pengguna untuk memulai tindakan tunggal, satu kali di Roblox Studio melalui acara Click.
Ketika ditekan, acara Click terbakar.Tombol juga akan tetap dalam keadaan ditekan, yang dapat diatur secara manual menggunakan SetActive .Setelah aktivasi plugin ( Plugin:Activate() ), tombol di semua yang lain PluginToolbars akan dimatikan.Jika semua tombol di bilah alat dimatikan, plugin bilah alat dinonaktifkan ( Plugin:Deactivate() ).
Ketika jendela permainan tidak terlihat, tombol akan dinonaktifkan seolah-olah properti Enabled mereka palsu.Tombol yang dinonaktifkan tidak berwarna dan tidak merespon klik pengguna.Dengan mengatur ClickableWhenViewportHidden ke benar, Anda dapat mengizinkan tombol plugin tetap dapat diklik (seperti selama pengeditan skrip).
Rangkuman
Properti
Menentukan apakah tombol dapat diklik saat jendela permainan tersembunyi, seperti saat mengedit skrip di tab Studio yang berbeda.
Menentukan apakah tombol dapat diklik secara umum.
Menentukan ikon apa yang harus mewakili tombol.
Metode
Mengatur status tombol plugin.
Acara
Melepaskan api saat pengguna menekan dan melepaskan kursor mereka di tombol.
Properti
ClickableWhenViewportHidden
Klik Ketika Tersembunyi Viewport menentukan apakah Tombol PluginToolbar dapat diklik saat viewport permainan disembunyikan, seperti saat Script sedang diedit di tab lain.
Biasanya, properti ini baik untuk diaktifkan jika tindakan yang dipicu oleh acara tombol plugin Click tidak terjadi di dunia permainan (Ruang kerja).Sebagai contoh, tombol yang membuka widget harus memiliki properti ini benar, seperti menunjukkan widget terlihat oleh pengguna bahkan jika pandangan permainan tidak terlihat.
Enabled
Diaktifkan menentukan apakah tombol dapat diklik secara umum.Ketika properti ini palsu, tombol akan diberi abu-abu dan tidak dapat diklik, mencegah pengguna menembakkan peristiwa Click.Tombol diaktifkan secara default.
Saat menyalakan kembali properti ini, status tombol plugin tidak akan diingat dari status sebelumnya di mana pengguna meninggalkan tombol di dalamnyaSebagai gantinya, itu akan default ke negara terakhir yang ditetapkan oleh SetActive() atau ke negara nonaktif jika SetActive() tidak pernah digunakan.
Plugin harus menonaktifkan tombol mereka saat tindakan tombol tidak relevan dalam konteks saat ini.Sebagai contoh, tombol plugin yang menugaskan warna acak ke yang dipilih tidak boleh diaktifkan ketika seleksi tidak berisi bagian.Lihat sampel kode untuk informasi lebih lanjut.
Lihat juga:
- ClickableWhenViewportHidden , yang menentukan apakah tombol dapat diklik saat tampilan permainan tersembunyi (dan tidak hanya secara umum)
Contoh Kode
This code sample is for a studio Plugin. The plugin creates a PluginToolbarButton which randomizes the BrickColor() of each selected part using BrickColor.random(). Furthermore, the button is only enabled if at least one part is selected. It does this by detecting changes in the Selection using Selection.SelectionChanged.
assert(plugin, "This script must be run as a plugin")
local Selection = game:GetService("Selection")
local toolbar = plugin:CreateToolbar("Parts")
local pluginToolbarButton = toolbar:CreateButton(
"Randomize Colors",
"Click this button to assign random colors to selected parts",
"rbxassetid://5325741572" -- A rainbow
)
local function onClick()
local selection = Selection:Get()
for _, object in pairs(selection) do
if object:IsA("BasePart") then
object.BrickColor = BrickColor.random()
end
end
end
pluginToolbarButton.Click:Connect(onClick)
local function doesSelectionContainAPart()
local selection = Selection:Get()
for _, object in pairs(selection) do
if object:IsA("BasePart") then
return true
end
end
return false
end
local function onSelectionChanged()
pluginToolbarButton.Enabled = doesSelectionContainAPart()
end
Selection.SelectionChanged:Connect(onSelectionChanged)
onSelectionChanged()
Icon
Simbol menentukan apa yang icon untuk tombol di bilah alat plugin.Ketika properti ini tidak atur, tombol akan menggunakan teks tombol yang diberikan oleh PluginToolbar:CreateButton() .
Metode
SetActive
Metode ini dapat digunakan untuk menetapkan secara manual status aktif tombol plugin.
Ketika properti Enabled diaktifkan kembali, tombol akan kembali ke negara terakhir yang ditetapkan oleh metode ini atau default ke nonaktif jika metode ini belum digunakan sebelumnya.
Parameter
Memberikan nilai
Acara
Click
Klik terbakar saat PluginToolbarButton ditekan dan dilepaskan oleh pengguna.
Mengklik Tombol PluginToolbar menyebabkan status tombol beralih. Panggil SetActive untuk menetapkan status tombol secara manual.
Contoh Kode
This code sample demonstrates creating a PluginToolbar and a PluginToolbarButton on it, then connecting a function onClick to the PluginToolbarButton.Click event. When pressed, the button will print "Hello, world" to the output.
assert(plugin, "This script must be run as a plugin")
local toolbar = plugin:CreateToolbar("Hello World Plugin Toolbar")
local pluginToolbarButton =
toolbar:CreateButton("Print Hello World", "Click this button to print Hello World!", "rbxassetid://133293265")
local function onClick()
print("Hello, world")
end
pluginToolbarButton.Click:Connect(onClick)