PluginToolbarButton

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

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

  • Tidak Direplikasi
    Baca Paralel

    Menentukan apakah tombol dapat diklik saat jendela permainan tersembunyi, seperti saat mengedit skrip di tab Studio yang berbeda.

  • Tidak Direplikasi
    Baca Paralel

    Menentukan apakah tombol dapat diklik secara umum.

  • Icon:ContentId
    Tidak Direplikasi
    Baca Paralel

    Menentukan ikon apa yang harus mewakili tombol.

Metode

Acara

  • Keamanan Plugin

    Melepaskan api saat pengguna menekan dan melepaskan kursor mereka di tombol.

Properti

ClickableWhenViewportHidden

Tidak Direplikasi
Baca Paralel

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

Tidak Direplikasi
Baca Paralel

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.

BrickColor Randomizer Plugin

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

ContentId
Tidak Direplikasi
Baca Paralel

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

()
Keamanan Plugin

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

active: boolean
Nilai Default: ""

Memberikan nilai

()

Acara

Click

Keamanan Plugin

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.

PluginToolbarButton.Click

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)