PluginToolbarButton
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Um Botão de Barra de Plugins é um objeto criado pela função PluginToolbar:CreateButton().Permite que o usuário inicie uma ação única e isolada no Roblox Studio através do evento Click.
Quando pressionado, o evento Click é acionado.Um botão também permanecerá no estado pressionado, que pode ser definido manualmente usando SetActive.Após a ativação do plugin ( Plugin:Activate() ), os botões em todos os outros PluginToolbars serão desativados.Se todos os botões em uma barra de ferramentas estiverem desligado, o plugin da barra de ferramentas é desativado ( Plugin:Deactivate() ).
Quando a janela de visualização do jogo não é visível, os botões serão desativados como se sua propriedade Enabled fosse falsa.Botões desativados são desaturados e não respondem a cliques do usuário.Ao definir ClickableWhenViewportHidden para verdadeiro, você pode permitir que os botões de plugin permaneçam clicáveis (como durante a edição de scripts).
Resumo
Propriedades
Determina se o botão pode ser clicado quando o campo de visão do jogo está oculto, como ao editar um script em uma aba diferente do Studio.
Determina se o botão é clicável em geral.
Determina qual ícone deve representar o botão.
Métodos
Define o estado do botão do plugin.
Eventos
Dispara quando o usuário pressiona e libera o cursor no botão.
Propriedades
ClickableWhenViewportHidden
Enabled
Amostras de código
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" -- Um arco-íris
)
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
Métodos
Eventos
Click
Amostras de código
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)