PluginToolbarButton

ClickableWhenViewportHidden determina si se puede hacer clic en un botón de barra de plugins mientras el campo de visión del juego está oculto, como cuando se está editando un Script en una pestaña diferente.

Típicamente, esta propiedad es buena para habilitar si una acción desencadenada por el evento de un botón de plugin no ocurre en el mundo del juego (Espacio de trabajo).Por ejemplo, un botón que abre un widget debe tener esta propiedad como verdadera, ya que mostrar un widget es visible para el usuario incluso si la vista del juego no es visible.

Activado determina si un botón es clicable en general.Cuando esta propiedad es falsa, el botón se desactivará y no se podrá hacer clic, lo que impide que el usuario dispare el evento Click.Los botones se habilitan por defecto.

Al rehabilitar esta propiedad, el estado del botón del plugin no se recordará del estado anterior en el que el usuario dejó el botón.En cambio, se predeterminará el último estado establecido por SetActive() o el estado inactivo si SetActive() nunca se usó.

Los plugins deben desactivar sus botones cuando la acción de 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 habilitarse cuando la selección no contenga partes.Vea los ejemplos de código para obtener más información.

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

El 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á el texto del botón dado por PluginToolbar:CreateButton() en su lugar.

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

Cuando la propiedad Enabled se alterna de nuevo, el botón se revertirá al último estado establecido por este método o se volverá inactivo si este método no se ha utilizado previamente.

Parámetros

Devuelve

Haga clic se enciende cuando el botón PluginToolbar se presiona y se libera por el usuario.

Al hacer clic en un botón de la barra de plugins, se alternar/activarel estado del botón. Llama a SetActive para establecer el estado del botón de forma manual.

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)