PluginToolbarButton
*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.
플러그인 도구 상자 버튼은 PluginToolbar:CreateButton() 함수로 만들어진 개체입니다. 이 함수를 통해 사용자는 Roblox Studio에서 Click 이벤트를 통해 단일, 일회성 작업을 시작할 수 있습니다.
누르면 Click 이벤트가 발생합니다. 버튼은 누르고 있는 상태에서 유지되며, SetActive 를 사용
게임 뷰포트가 표시되지 않으면 버튼은 Enabled 속성이 가짜인 것처럼 비활성화됩니다. 비활성화된 버튼은 디사티어되어 사용자 클릭을 응답하지 않습니다. 스크립트 편집 중에 플러그인 버튼을 클릭할
요약
속성
스크립트를 다른 Studio 탭에서 편집하는 동안 게임 뷰포트가 숨겨져 있는지 여부를 결정합니다.
버튼이 일반적으로 클릭 가능한지 여부를 결정합니다.
버튼을 나타내는 아이콘을 결정합니다.
이벤트
사용자가 버튼을 누르고 커서를 릴리스하면 화면에 표시됩니다.
속성
ClickableWhenViewportHidden
클릭 가능 한 경우 보기 포트가 숨겨져 있는지 여부를 결정합니다. 예를 들어, 다른 탭에서 Script 를 편집하는 경우에 플러그인 도구 상자가 클릭 가능한지 여부를 결정합니다. Korean: 클릭 가능 한 경우 보기 포트가 숨겨져 있는지 여부를 결정합니다. 예를 들어, 다른 ��
일반적으로 이 속성은 플러그인 버튼의 Click 이벤트가 게임 세계에서 발생하지 않는 경우에 활성화하는 것이 좋습니다. 예를 들어, 위젯을 열는 버튼이 게임 뷰가 표시되지 않더라도 사용자에게 위젯이 표시되는 것을 보여주므로 이 속
Enabled
활성화되었습니다 버튼이 일반적으로 클릭할 수 있는지 여부를 결정합니다. 이 속성이 거짓인 경우 버튼은 회색으로 표시되고 클릭하지 않을 수 있습니다. 버튼은 기본적으로 활성화됩니다.
이 속성을 다시 활성화하면 사용자가 버튼을 떠난 이전 상태에서 플러그인 버튼의 상태가 기억되지 않습니다. 대신, SetActive() 또는 SetActive() 를 사용하지 않았다면 비활동 상태로 설
버튼 작동이 현재 컨텍스트에서 유효하지 않을 때 플러그인 버튼을 비활성화해야 합니다. 예를 들어, 선택 항목에 부품이 없으면 랜덤 색을 할당하는 플러그인 버튼을 활성화하지 마십시오. 코드 샘플을 참조하십시오.
또한 참조하십시오.
- ClickableWhenViewportHidden 은 게임 뷰가 숨겨져 있을 때 버튼을 클릭할 수 있는지 여부를 결정합니다(그리고 일반적으로 그렇지 않은 경우)
코드 샘플
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
아이콘 은 플러그인 도구 모음의 버튼에 대해 표시할 icon 를 결정합니다. 이 속성이 설정되지 않으면 버튼은 대신 PluginToolbar:CreateButton() 에서 제공하는 버튼의 텍스트를 사용합니다.
메서드
SetActive
이 메서드를 사용하여 플러그인 버튼의 활성 상태를 수동으로 설정할 수 있습니다.
Class.PluginToolbarButton.Enabled|Enabled 속성이 다시 토글되면 버튼은 이 메서드의 마지막 상태 집합으로 다시 설정되거나 이 메서드를 이전에 사용하지 않았으면 비활성으로 유지됩니다.
매개 변수
반환
이벤트
Click
클릭하기 플러그인 토글 버튼을 사용자가 릴리스하고 누르면 화면에 나타납니다.
플러그인 상자 버튼을 클릭하면 버튼의 상태가 전환됩니다. SetActive 를 호출하여 버튼의 상태를 수동으로 설정합니다.
코드 샘플
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)