PluginToolbarButton

ClickableWhenViewportHidden determina si un PluginToolbarButton se puede hacer clic mientras el viewport del juego está oculto, como cuando se está editando un Script en otra pestaña.

Por lo general, esta propiedad es buena para habilitar si el evento Class.PluginToolbarButton.Click|Click del botón de acción de un plugin no ocurre en el mundo de juegos (Workspace). Por ejemplo, un botón que abre un widget debería tener esta propiedad, ya que mostrar un widget es visible para el usuario incluso si la vista del juego no es visible.

Habilitado determina si un botón es clicable en general. Cuando esta propiedad es falsa, el botón se hará gris y no se podrá hacer clic, lo que impide que el usuario ejecute el evento Click . Los botones están habilitados por defecto.

Al reactivar esta propiedad, el estado del botón del plugin no se guardará del estado anterior en el que el usuario dejó el botón. En cambio, se restablecerá al estado actual establecido por SetActive() o al estado inactivo si SetActive() nunca se usó.

Los plugins deben desactivar sus botones cuando la acción del botón no es relevante en el contexto actual. Por ejemplo, un botón de plugin que asigna colores aleatorios a los seleccionados no debe estar habilitado cuando la selección no contiene partes. Vea los ejemplos de código para obtener más información.

Véase también:

• ClickableWhenViewportHidden , que determina si un botón es clicable cuando la vista del juego está oculta (y no solo en general)

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

Icono determina qué icon debe mostrarse para el botón en la barra de herramientas del plugin. Cuando esta propiedad no está establecer, el botón usará en su lugar el texto del botón dado por PluginToolbar:CreateButton() .

Este método se puede usar para establecer manualmente el estado activo del botón de plugin.

Cuando la propiedad Enabled se vuelve a activar, el botón se revertirá al estado final establecido por este método o por defecto si este método no ha sido usado anteriormente.

Parâmetros

Devolução

Click dispara cuando el PluginToolbarButton es presionado y liberado por el usuario.

Al hacer clic en un PluginToolbarButton, se alternar/activarel estado del botón. Llamar SetActive para establecer manualmente el estado del botón.

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)