PluginToolbarButton

ClickableWhenViewportHidden determina se un PluginToolbarButton può essere cliccato mentre la vista del gioco è nascosta, come quando si sta modificando un Script in un'altra scheda.

Tipicamente, questa proprietà è buona per abilitare se un evento Click avviene nel mondo di gioco (Area di lavoro). Ad esempio, un pulsante che apre un widget dovrebbe avere questa proprietà, poiché mostrare un widget è visibile all'utente anche se la vista del gioco non è visibile.

Abilitato determinare se un pulsante è cliccabile in Generale. Quando questa proprietà è falsa, il pulsante sarà disattivato e non cliccabile, impedendo all'utente di attivare l'evento Click . I pulsanti sono abilitati per impostazione predefinita.

Quando si riattiva questa Proprietà, lo stato del pulsante del plugin non verrà ricordato dallo stato precedente in cui l'utente ha lasciato il pulsante in. Invece, si prenderà il valore predefinito dello stato impostato da SetActive() o dallo stato inattivo se SetActive() non è mai stato utilizzato.

I plugin dovrebbero disabilitare i loro pulsanti quando l'azione del pulsante non è rilevante nel contesto attuale. Ad esempio, un pulsante di plugin che assegna colori casuali ai pulsanti selezionati non dovrebbe essere abilitato quando la selezione non contiene parti. Vedi gli esempi di codice per ulteriori informazioni.

Vedi anche:

• ClickableWhenViewportHidden , which determines whether a button is clickable when the game view is hidden (and not just in Generale)

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

Icona determinato ciò che icon dovrebbe essere mostrato per il pulsante nella barra degli strumenti del plugin. Quando questa proprietà non è Impostare, il pulsante utilizza invece il testo del pulsante fornito da PluginToolbar:CreateButton() .

Questo metodo può essere utilizzato per impostare manualmente lo stato attivo del pulsante del plugin.

Quando la proprietà Enabled viene riattivata, il pulsante tornerà allo stato predefinito impostato da questo metodo o allo stato inattivo se questo metodo non è stato precedentemente utilizzato.

Parametri

Restituzioni

Click izza quando il PluginToolbarButton viene premuto e rilasciato dall'utente.

Facendo clic su un PluginToolbarButton causa lo stato del pulsante per attivare / attivare/disattivare. Chiama SetActive per impostare manualmente lo stato del pulsante.

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)