PluginToolbarButton

KlikalnyWhenViewportHidden określa, czy PluginToolbarButton może być kliknięty, gdy widok gry jest ukryty, tak jak w przypadku edytowania Script w innym oknie.

Zazwyczaj, ta właściwość jest dobra do włączenia, jeśli zdarza się akcja wywołana przez przycisk Click ewentu w grze (Workspace). Na przykład, przycisk, który otwiera widget, powinien mieć tę właściwość, ponieważ pokazujący widok gry jest widoczny dla użytkownika, nawet jeśli widok gry nie jest widoczny.

Włączone określa, czy przycisk jest klikalny ogólne. Gdy ta właściwość jest fałszywa, przycisk zostanie zaznaczony i nie będzie można go klikać, zapobiegając wyprowadzaniu wydarzenia Click. Przyciski są włączone domyślnie.

Podczas ponownego włączenia właściwości ten stan przycisku nie zostanie zapamiętany z poprzedniego stanu, w którym użytkownik opuścił przycisk. Zamiast tego zostanie ustawiony na ostatnią dostępną wersję SetActive() lub na nieaktywny stan, jeśli SetActive() n

Plugins powinny wyłączyć swoje przyciski, gdy działanie przycisku nie jest odpowiednie w obecnym kontekście. Na przykład, przycisk button, który przydziela losowe kolory do wybranego, nie powinien być włączony, gdy selekcja nie zawiera części. Zobacz przykładowe wzory kodu dla więcej informacji.

Zobacz również:

• ClickableWhenViewportHidden , który określa, czy przycisk jest klikalny, gdy widok gry jest ukryty (i nie tylko ogólnie rzecz biorąc)

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

Ikonka określa, co icon powinno być wyświetlone dla przycisku w pasku narzędzi plugin. Gdy ta właściwość nie jest ustawiać, przycisk zostanie zamiast tego użyty przez tekst przyciska dany przez PluginToolbar:CreateButton() .

Ten metod można użyć do ręcznego ustawienia aktywnego stanu przycisku plugin'a.

Gdy właściwość Enabled jest ponownie włączona, przycisk zostanie ponownie ustawiony na poprzedni stan ustawiony przez ten metodę lub domyślnie niewystarczający, jeśli ten metodę nie użyto wcześniej.

Parametry

Zwroty

Kliknięcie uruchamia po naciśnięciu i uwolnieniu przycisku PluginToolbarButton przez użytkownika.

Kliknięcie przycisku PluginToolbarButton spowoduje, że stan przycisku będzie się zmieniać. Wezwij SetActive, aby ręcznie ustawić stan przycisku.

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)