PluginMenu

사용되지 않는 항목 표시
만들 수 없음
복제되지 않음

A context menu that can be shown in Studio. It displays a list of PluginActions and supports submenus.

PluginMenus must be created using the Plugin:CreatePluginMenu() function in order to work as expected.

See also:

코드 샘플

Creating a PluginMenu and PluginMenuAction
-- This code can be pasted into the command bar, but only once.



local plugin = plugin or getfenv().PluginManager():CreatePlugin()

plugin.Name = "Plugin"

plugin.Parent = workspace



local pluginMenu = plugin:CreatePluginMenu(math.random(), "Test Menu")

pluginMenu.Name = "Test Menu"



pluginMenu:AddNewAction("ActionA", "A", "rbxasset://textures/loading/robloxTiltRed.png")

pluginMenu:AddNewAction("ActionB", "B", "rbxasset://textures/loading/robloxTilt.png")



local subMenu = plugin:CreatePluginMenu(math.random(), "C", "rbxasset://textures/explosion.png")

subMenu.Name = "Sub Menu"



subMenu:AddNewAction("ActionD", "D", "rbxasset://textures/whiteCircle.png")

subMenu:AddNewAction("ActionE", "E", "rbxasset://textures/icon_ROBUX.png")



pluginMenu:AddMenu(subMenu)

pluginMenu:AddSeparator()



pluginMenu:AddNewAction("ActionF", "F", "rbxasset://textures/sparkle.png")



local toggle = Instance.new("BoolValue")

toggle.Name = "TogglePluginMenu"

toggle.Parent = workspace



local function onToggled()

	if toggle.Value then

		toggle.Value = false



		local selectedAction = pluginMenu:ShowAsync()

		if selectedAction then

			print("Selected Action:", selectedAction.Text, "with ActionId:", selectedAction.ActionId)

		else

			print("User did not select an action!")

		end

	end

end



toggle.Changed:Connect(onToggled)

요약

속성

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

    The icon to be displayed when used as a sub menu.

  • Title:string
    복제되지 않음
    병렬 읽기

    The text to be displayed when used as a sub menu.

Instance에서 상속된 모든 항목 보기

메서드

  • AddAction(action : Instance):void
    플러그인 보안

    Adds the given action to the menu.

  • AddMenu(menu : Instance):void
    플러그인 보안

    Adds the given menu as a separator.

  • AddNewAction(actionId : string,text : string,icon : string):Instance
    플러그인 보안

    Creates a temporary action that is hidden from Studio's customize shortcuts window.

  • AddSeparator():void
    플러그인 보안

    Adds a separator between items in the menu.

  • Clear():void
    플러그인 보안

    Clears the menu.

  • ShowAsync():Instance
    생성
    플러그인 보안

    Shows the menu at the mouse cursor. Yields until either an item is selected or the menu is closed.

Instance에서 상속된 모든 항목 보기

속성

Icon

string
복제되지 않음
병렬 읽기

This property determines the icon to be displayed when used as a sub menu. It defaults to an empty string "".

코드 샘플

Creating a PluginMenu and PluginMenuAction
-- This code can be pasted into the command bar, but only once.



local plugin = plugin or getfenv().PluginManager():CreatePlugin()

plugin.Name = "Plugin"

plugin.Parent = workspace



local pluginMenu = plugin:CreatePluginMenu(math.random(), "Test Menu")

pluginMenu.Name = "Test Menu"



pluginMenu:AddNewAction("ActionA", "A", "rbxasset://textures/loading/robloxTiltRed.png")

pluginMenu:AddNewAction("ActionB", "B", "rbxasset://textures/loading/robloxTilt.png")



local subMenu = plugin:CreatePluginMenu(math.random(), "C", "rbxasset://textures/explosion.png")

subMenu.Name = "Sub Menu"



subMenu:AddNewAction("ActionD", "D", "rbxasset://textures/whiteCircle.png")

subMenu:AddNewAction("ActionE", "E", "rbxasset://textures/icon_ROBUX.png")



pluginMenu:AddMenu(subMenu)

pluginMenu:AddSeparator()



pluginMenu:AddNewAction("ActionF", "F", "rbxasset://textures/sparkle.png")



local toggle = Instance.new("BoolValue")

toggle.Name = "TogglePluginMenu"

toggle.Parent = workspace



local function onToggled()

	if toggle.Value then

		toggle.Value = false



		local selectedAction = pluginMenu:ShowAsync()

		if selectedAction then

			print("Selected Action:", selectedAction.Text, "with ActionId:", selectedAction.ActionId)

		else

			print("User did not select an action!")

		end

	end

end



toggle.Changed:Connect(onToggled)

Title

string
복제되지 않음
병렬 읽기

This property determines the text to be displayed when a PluginMenu is used as a sub menu. It defaults to an empty string "".

코드 샘플

Creating a PluginMenu and PluginMenuAction
-- This code can be pasted into the command bar, but only once.



local plugin = plugin or getfenv().PluginManager():CreatePlugin()

plugin.Name = "Plugin"

plugin.Parent = workspace



local pluginMenu = plugin:CreatePluginMenu(math.random(), "Test Menu")

pluginMenu.Name = "Test Menu"



pluginMenu:AddNewAction("ActionA", "A", "rbxasset://textures/loading/robloxTiltRed.png")

pluginMenu:AddNewAction("ActionB", "B", "rbxasset://textures/loading/robloxTilt.png")



local subMenu = plugin:CreatePluginMenu(math.random(), "C", "rbxasset://textures/explosion.png")

subMenu.Name = "Sub Menu"



subMenu:AddNewAction("ActionD", "D", "rbxasset://textures/whiteCircle.png")

subMenu:AddNewAction("ActionE", "E", "rbxasset://textures/icon_ROBUX.png")



pluginMenu:AddMenu(subMenu)

pluginMenu:AddSeparator()



pluginMenu:AddNewAction("ActionF", "F", "rbxasset://textures/sparkle.png")



local toggle = Instance.new("BoolValue")

toggle.Name = "TogglePluginMenu"

toggle.Parent = workspace



local function onToggled()

	if toggle.Value then

		toggle.Value = false



		local selectedAction = pluginMenu:ShowAsync()

		if selectedAction then

			print("Selected Action:", selectedAction.Text, "with ActionId:", selectedAction.ActionId)

		else

			print("User did not select an action!")

		end

	end

end



toggle.Changed:Connect(onToggled)
Instance에서 상속된 모든 항목 보기

메서드

AddAction

void
플러그인 보안

Adds the given action to the menu.

매개 변수

action: Instance

The action to add.


반환

void

코드 샘플

Creating a PluginMenu and PluginMenuAction
-- This code can be pasted into the command bar, but only once.



local plugin = plugin or getfenv().PluginManager():CreatePlugin()

plugin.Name = "Plugin"

plugin.Parent = workspace



local pluginMenu = plugin:CreatePluginMenu(math.random(), "Test Menu")

pluginMenu.Name = "Test Menu"



pluginMenu:AddNewAction("ActionA", "A", "rbxasset://textures/loading/robloxTiltRed.png")

pluginMenu:AddNewAction("ActionB", "B", "rbxasset://textures/loading/robloxTilt.png")



local subMenu = plugin:CreatePluginMenu(math.random(), "C", "rbxasset://textures/explosion.png")

subMenu.Name = "Sub Menu"



subMenu:AddNewAction("ActionD", "D", "rbxasset://textures/whiteCircle.png")

subMenu:AddNewAction("ActionE", "E", "rbxasset://textures/icon_ROBUX.png")



pluginMenu:AddMenu(subMenu)

pluginMenu:AddSeparator()



pluginMenu:AddNewAction("ActionF", "F", "rbxasset://textures/sparkle.png")



local toggle = Instance.new("BoolValue")

toggle.Name = "TogglePluginMenu"

toggle.Parent = workspace



local function onToggled()

	if toggle.Value then

		toggle.Value = false



		local selectedAction = pluginMenu:ShowAsync()

		if selectedAction then

			print("Selected Action:", selectedAction.Text, "with ActionId:", selectedAction.ActionId)

		else

			print("User did not select an action!")

		end

	end

end



toggle.Changed:Connect(onToggled)

AddMenu

void
플러그인 보안

Adds the given menu as a separator.

매개 변수

menu: Instance

The menu to add as a sub menu. Uses its PluginMenu.Title and PluginMenu.Icon to display.


반환

void

코드 샘플

Creating a PluginMenu and PluginMenuAction
-- This code can be pasted into the command bar, but only once.



local plugin = plugin or getfenv().PluginManager():CreatePlugin()

plugin.Name = "Plugin"

plugin.Parent = workspace



local pluginMenu = plugin:CreatePluginMenu(math.random(), "Test Menu")

pluginMenu.Name = "Test Menu"



pluginMenu:AddNewAction("ActionA", "A", "rbxasset://textures/loading/robloxTiltRed.png")

pluginMenu:AddNewAction("ActionB", "B", "rbxasset://textures/loading/robloxTilt.png")



local subMenu = plugin:CreatePluginMenu(math.random(), "C", "rbxasset://textures/explosion.png")

subMenu.Name = "Sub Menu"



subMenu:AddNewAction("ActionD", "D", "rbxasset://textures/whiteCircle.png")

subMenu:AddNewAction("ActionE", "E", "rbxasset://textures/icon_ROBUX.png")



pluginMenu:AddMenu(subMenu)

pluginMenu:AddSeparator()



pluginMenu:AddNewAction("ActionF", "F", "rbxasset://textures/sparkle.png")



local toggle = Instance.new("BoolValue")

toggle.Name = "TogglePluginMenu"

toggle.Parent = workspace



local function onToggled()

	if toggle.Value then

		toggle.Value = false



		local selectedAction = pluginMenu:ShowAsync()

		if selectedAction then

			print("Selected Action:", selectedAction.Text, "with ActionId:", selectedAction.ActionId)

		else

			print("User did not select an action!")

		end

	end

end



toggle.Changed:Connect(onToggled)

AddNewAction

Instance
플러그인 보안

Creates a temporary action that is hidden from Studio's customize shortcuts window.

매개 변수

actionId: string

Must be a unique string that identifies this PluginAction from others.

text: string

The text to be displayed.

icon: string

The icon to be displayed.

기본값: ""

반환

Instance

The created PluginAction.

코드 샘플

Creating a PluginMenu and PluginMenuAction
-- This code can be pasted into the command bar, but only once.



local plugin = plugin or getfenv().PluginManager():CreatePlugin()

plugin.Name = "Plugin"

plugin.Parent = workspace



local pluginMenu = plugin:CreatePluginMenu(math.random(), "Test Menu")

pluginMenu.Name = "Test Menu"



pluginMenu:AddNewAction("ActionA", "A", "rbxasset://textures/loading/robloxTiltRed.png")

pluginMenu:AddNewAction("ActionB", "B", "rbxasset://textures/loading/robloxTilt.png")



local subMenu = plugin:CreatePluginMenu(math.random(), "C", "rbxasset://textures/explosion.png")

subMenu.Name = "Sub Menu"



subMenu:AddNewAction("ActionD", "D", "rbxasset://textures/whiteCircle.png")

subMenu:AddNewAction("ActionE", "E", "rbxasset://textures/icon_ROBUX.png")



pluginMenu:AddMenu(subMenu)

pluginMenu:AddSeparator()



pluginMenu:AddNewAction("ActionF", "F", "rbxasset://textures/sparkle.png")



local toggle = Instance.new("BoolValue")

toggle.Name = "TogglePluginMenu"

toggle.Parent = workspace



local function onToggled()

	if toggle.Value then

		toggle.Value = false



		local selectedAction = pluginMenu:ShowAsync()

		if selectedAction then

			print("Selected Action:", selectedAction.Text, "with ActionId:", selectedAction.ActionId)

		else

			print("User did not select an action!")

		end

	end

end



toggle.Changed:Connect(onToggled)

AddSeparator

void
플러그인 보안

Adds a separator between items in the menu.


반환

void

코드 샘플

Creating a PluginMenu and PluginMenuAction
-- This code can be pasted into the command bar, but only once.



local plugin = plugin or getfenv().PluginManager():CreatePlugin()

plugin.Name = "Plugin"

plugin.Parent = workspace



local pluginMenu = plugin:CreatePluginMenu(math.random(), "Test Menu")

pluginMenu.Name = "Test Menu"



pluginMenu:AddNewAction("ActionA", "A", "rbxasset://textures/loading/robloxTiltRed.png")

pluginMenu:AddNewAction("ActionB", "B", "rbxasset://textures/loading/robloxTilt.png")



local subMenu = plugin:CreatePluginMenu(math.random(), "C", "rbxasset://textures/explosion.png")

subMenu.Name = "Sub Menu"



subMenu:AddNewAction("ActionD", "D", "rbxasset://textures/whiteCircle.png")

subMenu:AddNewAction("ActionE", "E", "rbxasset://textures/icon_ROBUX.png")



pluginMenu:AddMenu(subMenu)

pluginMenu:AddSeparator()



pluginMenu:AddNewAction("ActionF", "F", "rbxasset://textures/sparkle.png")



local toggle = Instance.new("BoolValue")

toggle.Name = "TogglePluginMenu"

toggle.Parent = workspace



local function onToggled()

	if toggle.Value then

		toggle.Value = false



		local selectedAction = pluginMenu:ShowAsync()

		if selectedAction then

			print("Selected Action:", selectedAction.Text, "with ActionId:", selectedAction.ActionId)

		else

			print("User did not select an action!")

		end

	end

end



toggle.Changed:Connect(onToggled)

Clear

void
플러그인 보안

Clears the menu.


반환

void

ShowAsync

Instance
생성
플러그인 보안

Shows the menu at the mouse cursor. It yields until either an item is selected or the menu is closed. The selected action fires its PluginAction.Triggered event.


반환

Instance

The PluginAction item that was selected or nil.

코드 샘플

Creating a PluginMenu and PluginMenuAction
-- This code can be pasted into the command bar, but only once.



local plugin = plugin or getfenv().PluginManager():CreatePlugin()

plugin.Name = "Plugin"

plugin.Parent = workspace



local pluginMenu = plugin:CreatePluginMenu(math.random(), "Test Menu")

pluginMenu.Name = "Test Menu"



pluginMenu:AddNewAction("ActionA", "A", "rbxasset://textures/loading/robloxTiltRed.png")

pluginMenu:AddNewAction("ActionB", "B", "rbxasset://textures/loading/robloxTilt.png")



local subMenu = plugin:CreatePluginMenu(math.random(), "C", "rbxasset://textures/explosion.png")

subMenu.Name = "Sub Menu"



subMenu:AddNewAction("ActionD", "D", "rbxasset://textures/whiteCircle.png")

subMenu:AddNewAction("ActionE", "E", "rbxasset://textures/icon_ROBUX.png")



pluginMenu:AddMenu(subMenu)

pluginMenu:AddSeparator()



pluginMenu:AddNewAction("ActionF", "F", "rbxasset://textures/sparkle.png")



local toggle = Instance.new("BoolValue")

toggle.Name = "TogglePluginMenu"

toggle.Parent = workspace



local function onToggled()

	if toggle.Value then

		toggle.Value = false



		local selectedAction = pluginMenu:ShowAsync()

		if selectedAction then

			print("Selected Action:", selectedAction.Text, "with ActionId:", selectedAction.ActionId)

		else

			print("User did not select an action!")

		end

	end

end



toggle.Changed:Connect(onToggled)
Instance에서 상속된 모든 항목 보기

이벤트

Instance에서 상속된 모든 항목 보기