PluginToolbarButton

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

만들 수 없음

플러그인 도구 모음 버튼은 PluginToolbar:CreateButton() 함수에 의해 생성된 개체입니다.사용자가 이벤트 Click)를 통해 Roblox Studio에서 단일, 일회성 작업을 시작할 수 있습니다.

누르면 Click 이벤트가 발생합니다.버튼은 또한 누르기 상태에 남아 있으며, SetActive를 사용하여 수동으로 설정할 수 있습니다.플러그인 활성화 시( Plugin:Activate() ), 모든 다른 PluginToolbars 버튼이 끄기.도구 모음의 모든 버튼이 꺼져 있으면 도구 모음의 플러그인이 비활성화됩니다(Plugin:Deactivate()).

게임 뷰포트가 표시되지 않으면 버튼이 비활성화되어 마치 해당 Enabled 속성이 거짓인 것처럼 보입니다.비활성화된 버튼은 색이 바랜 상태이며 사용자 클릭에 반응하지 않습니다.ClickableWhenViewportHidden를 true로 설정하여 플러그인 버튼이 계속 클릭 가능하도록 할 수 있습니다(예: 스크립트 편집 중).

요약

속성

  • 복제되지 않음
    병렬 읽기

    게임 뷰포트가 숨겨져 있을 때 버튼을 클릭할 수 있는지 여부를 결정합니다(예: 다른 Studio 탭에서 스크립트를 편집하는 동안).

  • 복제되지 않음
    병렬 읽기

    버튼이 일반적으로 클릭할 수 있는지 여부를 결정합니다.

  • Icon:ContentId
    복제되지 않음
    병렬 읽기

    버튼을 나타내는 아이콘을 결정합니다.

메서드

  • SetActive(active : boolean):()
    플러그인 보안

    플러그인 버튼의 상태를 설정합니다.

이벤트

  • 플러그인 보안

    사용자가 버튼에 커서를 누르고 릴리스할 때 발생합니다.

속성

ClickableWhenViewportHidden

복제되지 않음
병렬 읽기

ClickableWhenViewportHidden 은 게임 뷰포트가 숨겨져 있는 동안 플러그인 툴바 버튼을 클릭할 수 있는지 여부를 결정합니다, 예를 들어 다른 탭에서 Script.

일반적으로 플러그인 버튼의 Click 이벤트에 의해 트리거된 액션이 게임 세계(작업 영역)에서 발생하지 않으면 이 속성을 활성화하는 것이 좋습니다.예를 들어, 위젯을 열는 버튼은 게임 뷰가 표시되지 않더라도 사용자에게 위젯이 표시된다는 점을 보여주므로 이 속성이 올바른 상태여야 합니다.

Enabled

복제되지 않음
병렬 읽기

활성화 는 일반적으로 버튼을 클릭할 수 있는지 여부를 결정합니다.이 속성이 false이면 버튼이 회색으로 변하고 클릭할 수 없어져서 사용자가 Click 이벤트를 발사하지 못하게 합니다.기본적으로 버튼이 활성화됩니다.

이 속성을 다시 활성화할 때 플러그인 버튼의 상태는 사용자가 버튼을 떠났던 이전 상태에서 기억되지 않습니다.대신, 마지막으로 설정된 상태인 SetActive() 또는 사용되지 않은 상태인 SetActive() 에 기본값이 지정됩니다.

플러그인은 버튼 작업이 현재 컨텍스트에서 관련이 없을 때 버튼을 비활성화해야 합니다.예를 들어, 선택한 부품에 랜덤 색상을 할당하는 플러그인 버튼은 선택에 부품이 없을 때 활성화되지 않아야 합니다.자세한 내용은 코드 샘플을 참조하십시오.

참조하세요:

  • ClickableWhenViewportHidden , 게임 뷰가 숨겨질 때 버튼을 클릭할 수 있는지 여부를 결정하는 것(일반적으로만 아니라)

코드 샘플

This code sample is for a studio Plugin. The plugin creates a PluginToolbarButton which randomizes the BrickColor() of each selected part using BrickColor.random(). Furthermore, the button is only enabled if at least one part is selected. It does this by detecting changes in the Selection using Selection.SelectionChanged.

BrickColor Randomizer Plugin

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

ContentId
복제되지 않음
병렬 읽기

아이콘 플러그인 도구 모음의 버튼에 표시할 내용을 결정합니다. what icon should be shown for the button in the plugin toolbar.이 속성이 설정되지 않으면 버튼은 대신 PluginToolbar:CreateButton()에서 제공하는 버튼 텍스트를 사용합니다.

메서드

SetActive

()
플러그인 보안

이 메서드를 사용하여 플러그인 버튼의 활성 상태를 수동으로 설정할 수 있습니다.

Enabled 속성이 다시 토글되면 버튼은 이 메서드에 의해 설정된 마지막 상태로 되돌아가거나 이 메서드가 이전에 사용되지 않았으면 비활성으로 설정됩니다.

매개 변수

active: boolean
기본값: ""

반환

()

이벤트

Click

플러그인 보안

클릭 은 사용자가 PluginToolbarButton을 누르고 릴리스할 때 발생합니다.

플러그인 툴바 버튼을 클릭하면 버튼의 상태가 전환됩니다. 버튼의 상태를 수동으로 설정하려면 SetActive.


코드 샘플

This code sample demonstrates creating a PluginToolbar and a PluginToolbarButton on it, then connecting a function onClick to the PluginToolbarButton.Click event. When pressed, the button will print "Hello, world" to the output.

PluginToolbarButton.Click

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)