PluginToolbarButton

ClickableWhenViewportHidden xác định whether a PluginToolbarButton có thể được nhấp vào khi viewport game đang ẩn, ví dụ như khi một Script đang được chỉnh sửa ở một tab khác.

Thông thường, thuộc tính này tốt để bật nếu sự kiện Click của nút mà nút mở một trang bị trong thế giới trò chơi (Workspace) không xảy ra. Ví dụ, một nút mở một trang bị thuộc về thuộc tính này, vì hiển thị một trang b

Đã bật xác định whether a button is clickable in phổ quát. When this property is false, the button will be greyed out and unclickable,防ing the user from firing the Click event. Buttons are enabled by default.

Khi bạn bật lại các cấu hình này, trạng thái nút của plugin sẽ không được lưu từ trạng thái trước đó mà người dùng đã rời nút. Thay vào đó, nó sẽ mặc định đến trạng thái cuối cùng được cài đặ

Các plugin nên tắt các nút của họ khi hành động nút không liên quan trong ngữ cảnh hiện tại. Ví dụ, một nút plugin mà giao cho các màu ngẫu nhiên để chọn không được bật khi lựa chọn không chứa các bộ phận. Xem mẫu code cho thêm thông tin.

Xem thêm:

• ClickableWhenViewportHidden , which determines whether a button is clickable when the game view is hidden (and not just in phổ quát)

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

Biểu tượng định nghĩa những gì icon nên được hiển thị cho nút ở thanh công cụ plugin. Khi thuộc tính này không được cài đặt, nút sẽ thay vào đó sử dụng văn bản của nút được cung cấp bởi PluginToolbar:CreateButton()

Phương pháp này có thể được sử dụng để thiết lập trạng thái chủ động của nút plugin.

Khi thuộc tính Enabled được bật lại, nút sẽ hoàn toàn quay lại trạng thái cuối cùng được cài đặt bởi phương thức này hoặc mặc định nếu phương thức này không được sử dụng trước đó.

Tham Số

Lợi Nhuận

Click lần khi PluginToolbarButton được nhấn và thả bởi người dùng.

Nhấp vào một nút bất kì khiến trạng thái của nút bất kì thay đổi. Gọi SetActive để thiết lập trạng thái của nút bất kì.

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)