PluginToolbarButton

ClickableWhenViewportHidden bestimmt, ob ein PluginToolbarButton gedient werden kann, während der Spiel-Ansichts-Button ausgeblendet ist, wie z. B. wenn ein Script in einer anderen Registerkarte bearbeitet wird.

In der Regel ist dieses Eigenschaft gut, wenn ein Aktion, die durch die Schaltfläche Click des Buttons eines Plugins ausgelöst wird, nicht in der Spielwelt (Arbeitsbereich) vorkommt. Zum Beispiel muss ein Button, der ein Widget öffnet, wahr sein, da das Spielview nicht sichtbar ist.

Aktiviert bestimmt, ob eine Schaltfläche Allgemeinklickbar ist. Wenn diese Eigenschaft falsch ist, wird die Schaltfläche ausgegraut und nicht klickbar, so dass der Benutzer nicht auf die Schaltfläche Click klicken kann. Schaltflächen sind standardmäßig aktiviert.

Wenn dieses Eigenschaftenerneut aktiviert wird, wird der Zustand der Schaltfläche nicht mehr vom vorherigen Zustand erinnert, in dem der Benutzer die Schaltfläche verlassen hat. Stattdessen wird standardmäßig auf den letzten Zustand gesetzt, der von SetActive() oder der Inaktivität gesetzt wurde, wenn SetActive() nie verwendet wurde.

Plugins sollten ihre Schaltflächen deaktivieren, wenn die Schaltflächenaktion nicht relevant ist im aktuellen Kontext. Zum Beispiel, ein Plugin-Schaltfläche, die zufällige Farben zu ausgewählten zuweist, sollte nicht aktiviert werden, wenn die Auswahl keine Teile enthält. Siehe die Code-Beispiele für weitere Informationen.

Siehe auch:

• ClickableWhenViewportHidden , was bestimmt, ob eine Schaltfläche klickbar ist, wenn die Spielansicht versteckt ist (und nicht nur Allgemein)

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 bestimmt, was icon für die Schaltfläche in der Plugin-Toolbar angezeigt werden soll. Wenn diese Eigenschaft nicht festlegenist, verwendet die Schaltfläche stattdessen den Text der Schaltfläche, der von PluginToolbar:CreateButton() gegeben wird.

Diese Methode kann verwendet werden, um den aktiven Zustand der Plugin-Schaltfläche manuell zu setzen.

Wenn die Enabled Eigenschaft zurückgesetzt wird, kehrt der Button entweder auf den letzten Zustand zurück, der von dieser Methode festgelegt wurde, oder auf Inaktiv, wenn diese Methode nicht vorher verwendet wurde.

Parameter

Rückgaben

Klicken Sie auf , wenn der PluginToolbarButton vom Benutzer gedrückt und freigelassen wird.

Wenn Sie auf einen PluginToolbarButton klicken, wird der Zustand der Schaltfläche umschalten. Rufen Sie SetActive auf, um den Zustand der Schaltfläche manuell zu setzen.

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)