PluginToolbarButton

Można kliknąć, gdy widok okna jest ukryty określa, czy przycisk paska narzędzi może zostać kliknięty, gdy widok gry jest ukryty, na przykład, gdy Script jest edytowany w innym tablicy.

Zazwyczaj właściwość ta jest dobra do włączenia, jeśli akcja uruchomiona przez wydarzenie Click przycisku pluginowego nie wystąpi w świecie gry (Przestrzeni roboczej).Na przykład przycisk otwierający widget powinien mieć tę właściwość prawdziwą, ponieważ wyświetlanie widgetu jest widoczne 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 wyłączony i nieklikalny, uniemożliwiając użytkownikowi uruchomienie wydarzenia Click.Przyciski są włączone domyślnie.

Podczas ponownego włączania tej właściwości stan przycisku plugin nie zostanie zapamiętany z poprzedniego stanu, w którym użytkownik opuścił przycisk.Zamiast tego domyślnie zostanie ustawiony ostatni stan ustawiony przez SetActive() lub nieaktywny stan, jeśli SetActive() nigdy nie został użyty.

Wtyczki powinny wyłączyć swoje przyciski, gdy działanie przycisku nie jest odpowiednie w obecnym kontekście.Na przykład przycisk pluginu, który przypisuje losowe kolory do wybranych, nie powinien być włączony, gdy wybór nie zawiera części.Zobacz przykłady kodu dla więcej informacji.

Zobacz także:

• ClickableWhenViewportHidden , który określa, czy przycisk jest klikalny, gdy widok gry jest ukryty (a nie tylko ogólne)

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

Ikona określa, co icon powinno być wyświetlone dla przycisku w pasku narzędzi pluginów.Gdy ta właściwość nie jest ustawiać, przycisk zamiast tego użyje tekstu przycisku podanego przez PluginToolbar:CreateButton() .

Ta metoda może być użyta do ręcznego ustawienia aktywnego stanu przycisku pluginu.

Gdy właściwość Enabled zostanie ponownie włączona, przycisk zostanie przywrócony do ostatniego stanu ustawionego przez tę metodę lub zostanie ustawiony na nieaktywny, jeśli ta metoda nie została wcześniej użyta.

Parametry

Zwroty

Kliknij ogień wystrzeliwuje się, gdy PluginToolbarButton jest naciśnięty i uwolniony przez użytkownika.

Kliknięcie przycisku paska narzędzi spowoduje przełączenie stanu przycisku. Zadzwoń 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)