PluginToolbarButton

KlikableWhenViewportHidden menentukan apakah PluginToolbarButton dapat diklik saat viewport game tersembunyi, seperti saat Script di편집 di tab lain.

Biasanya, property ini baik digunakan jika acara Click yang diaktifkan oleh tombol plugin terjadi di dunia game (Workspace). Misalnya, tombol yang membuka widget harus memiliki property ini, karena menunjukkan widget yang dapat dilihat oleh pengguna bahkan jika pandangan game tidak terlihat.

Diaktifkan menentukan apakah tombol dapat diklik secara umum. Saat property ini false, tombol akan menjadi hitam dan tidak dapat diklik, mencegah pengguna mengeklik acara Click . Tombol diaktifkan secara default.

Ketika mengaktifkan kembali property ini, status tombol plugin tidak akan diingat dari status sebelumnya di mana pengguna meninggalkan tombol di dalamnya. Sebaliknya, itu akan diatur ke status terakhir yang ditetapkan oleh SetActive() atau ke status tidak aktif jika Class.PluginToolbarButton:SetActive()|SetActive() tidak pernah dig

Plugin harus menonaktifkan tombol mereka saat tindakan tombol tidak relevan dalam konteks saat ini. Misalnya, tombol plugin yang menetapkan warna acak ke tombol yang dipilih tidak boleh diaktifkan saat pemilihan tidak berisi bagian. Lihat sampel kode untuk lebih banyak informasi.

Lihat juga:

• ClickableWhenViewportHidden , yang menentukan apakah tombol dapat diklik saat pandangan game tersembunyi (dan bukan hanya umum)

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()

Ikon menentukan apa yang harus ditunjukkan oleh icon untuk tombol di bilah alat plugin. Saat elemen ini tidak diatur, tombol akan menggunakan teks tombol yang diberikan oleh PluginToolbar:CreateButton() .

Metode ini dapat digunakan untuk secara manual menetapkan status aktif tombol plugin.

Ketika Enabled property diaktifkan kembali, tombol akan mengembalikan ke negara terakhir yang ditetapkan oleh metode ini atau default ke tidak aktif jika metode ini belum digunakan sebelumnya.

Parameter

Memberikan nilai

Klik menembak saat PluginToolbarButton ditekan dan dilepaskan oleh pengguna.

Mengklik PluginToolbarButton menyebabkan status tombol untuk beralih. Panggil SetActive untuk secara manual menetapkan status tombol.

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)