Version: 2023.2
LanguageEnglish
  • C#

DropdownMenu.AppendAction(string,Action<DropdownMenuAction>,Func<DropdownMenuAction, DropdownMenuAction.Status>,object)

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Parameters

actionName The name of the item. This name is displayed in the dropdown menu.
action The callback to execute when the user selects this item in the menu.
actionStatusCallback The callback to execute to determine the status of this item.
userData The object to store in the <b>userData</b> property of the <see cref="DropdownMenuAction" /> item.

Description

Adds an item that executes an action in the dropdown menu.

The item is added to the end of the current item list.

using UnityEditor;
using UnityEngine;
using UnityEngine.UIElements;

public class ContextMenuWindow : EditorWindow { [MenuItem("My/Context Menu Window")] static void ShowMe() => GetWindow<ContextMenuWindow>();

void CreateGUI() { var contextMenuContainer = new VisualElement(); contextMenuContainer.style.flexGrow = 1; contextMenuContainer.AddManipulator(new ContextualMenuManipulator(e => { e.menu.AppendAction("Submenu/My Action 1", a => Debug.Log("My Action 1 Works"), action => { action.tooltip = "Status dependent tooltip"; return DropdownMenuAction.Status.Normal; }, null); }));

rootVisualElement.Add(contextMenuContainer); } }

Parameters

actionName The name of the item. This name is displayed in the dropdown menu.
action The callback to execute when the user selects this item in the menu.
actionStatusCallback The callback to execute to determine the status of this item.
userData The object to store in the <b>userData</b> property of the <see cref="DropdownMenuAction" /> item.
icon The icon to display next to the item name.

Description

Adds an item that executes an action in the dropdown menu.

The item is added to the end of the current item list.

using UnityEditor;
using UnityEditor.UIElements;
using UnityEngine;
using UnityEngine.UIElements;

public class ContextMenuWindow : EditorWindow { [MenuItem("My/Context Menu Window")] static void ShowMe() => GetWindow<ContextMenuWindow>();

Texture2D icon;

void CreateGUI() { var contextMenuContainer = new VisualElement(); contextMenuContainer.style.flexGrow = 1; contextMenuContainer.AddManipulator(new ContextualMenuManipulator(e => { e.menu.AppendAction("Submenu/My Action 4", a => Debug.Log("My Action 4 Works"), action => { action.tooltip = "Status dependent tooltip"; return DropdownMenuAction.Status.Normal; }, null, icon); }));

var iconField = new ObjectField() { label = "Icon", objectType = typeof(Texture2D) };

iconField.RegisterValueChangedCallback(e => { icon = (Texture2D)e.newValue; });

contextMenuContainer.Add(iconField); rootVisualElement.Add(contextMenuContainer); } }

Parameters

actionName The name of the item. This name is displayed in the dropdown menu.
action The callback to execute when the user selects this item in the menu.
status The status of the item.

Description

Adds an item that executes an action in the dropdown menu.

The item is added to the end of the current item list.

using UnityEditor;
using UnityEngine;
using UnityEngine.UIElements;

public class ContextMenuWindow : EditorWindow { [MenuItem("My/Context Menu Window")] static void ShowMe() => GetWindow<ContextMenuWindow>();

void CreateGUI() { var contextMenuContainer = new VisualElement(); contextMenuContainer.style.flexGrow = 1; contextMenuContainer.AddManipulator(new ContextualMenuManipulator(e => { e.menu.AppendAction("My Action 1", a => Debug.Log("My Action 1 Works"), DropdownMenuAction.Status.Normal); }));

rootVisualElement.Add(contextMenuContainer); } }

Parameters

actionName The name of the item. This name is displayed in the dropdown menu.
action The callback to execute when the user selects this item in the menu.
status The status of the item.
icon The icon to display next to the item name.

Description

Adds an item that executes an action in the dropdown menu.

The item is added to the end of the current item list.

using UnityEditor;
using UnityEditor.UIElements;
using UnityEngine;
using UnityEngine.UIElements;

public class ContextMenuWindow : EditorWindow { [MenuItem("My/Context Menu Window")] static void ShowMe() => GetWindow<ContextMenuWindow>();

Texture2D icon;

void CreateGUI() { var contextMenuContainer = new VisualElement(); contextMenuContainer.style.flexGrow = 1; contextMenuContainer.AddManipulator(new ContextualMenuManipulator(e => { e.menu.AppendAction("My Action 1", a => Debug.Log("My Action 1 Works"), DropdownMenuAction.Status.Normal, icon); }));

var iconField = new ObjectField() { label = "Icon", objectType = typeof(Texture2D) };

iconField.RegisterValueChangedCallback(e => { icon = (Texture2D)e.newValue; });

contextMenuContainer.Add(iconField); rootVisualElement.Add(contextMenuContainer); } }