DropdownMenuAction
класс в UnityEngine.UIElements
Наследуется от:UIElements.DropdownMenuItem
Выполнено в:UnityEngine.UIElementsModule
Описание
Представляет элемент действия меню.
DropdownMenu содержит один или несколько экземпляров DropdownMenuAction. Каждый экземпляр DropdownMenuAction может иметь собственное состояние и обратный вызов.
В следующем примере показано, как создать раскрывающееся меню с действиями, действиями подменю и условными действиями.
using UnityEditor; using UnityEngine; using UnityEngine.UIElements; public class DropdownMenuExample: EditorWindow { public string[] playerNames = new string[] { "Alex", "Carol", "Ethan", "Jen" };
[MenuItem("Window/UI Toolkit/DropdownMenu Example")] public static void ShowExample() { DropdownMenuExample wnd = GetWindow<DropdownMenuExample>(); wnd.titleContent = new GUIContent("DropdownMenu Example"); }
public void CreateGUI() { var window = EditorWindow.GetWindow<EditorWindow>(); var root = window.rootVisualElement;
// Create a new dropdown menu var playersContainer = new VisualElement(); var instructionLabel = new Label("Right Click on the player to edit their details"); root.Add(instructionLabel); root.Add(playersContainer); for(int i = 0; i < playerNames.Length; i++) { var playerName = playerNames[i]; // Set an ID for each player label var id = i+1; var playerLabel = new Label { text = playerName, name = $"label{playerName}"}; playerLabel.AddManipulator(CreateDropdownMenu()); playersContainer.Add(playerLabel); } }
public IManipulator CreateDropdownMenu() { ContextualMenuManipulator menuManipulator = new ContextualMenuManipulator( menuEvent => { if (menuEvent.target is not Label playerLabel) return;
// Player Name Actions menuEvent.menu.AppendAction("Retire Player", a => { playerLabel.text = $"[RETIRED] {playerLabel.text}"; playerLabel.style.backgroundColor = Color.gray; playerLabel.style.color = Color.red; playerLabel.userData = "retired"; }, DropdownMenuAction.AlwaysEnabled, playerLabel.userData);
menuEvent.menu.AppendAction("Set Player To Gold Status", a => { playerLabel.style.color = Color.yellow; });
// Separate Team Actions from Player Name Actions menuEvent.menu.AppendSeparator();
// Create a sub menu containing both teams menuEvent.menu.AppendAction("Change Team/Lizards", a => { playerLabel.style.backgroundColor = Color.green; }, ChangeTeamActionStatus, playerLabel.userData); menuEvent.menu.AppendAction("Change Team/Sharks", a => { playerLabel.style.backgroundColor = Color.cyan; }, ChangeTeamActionStatus, playerLabel.userData); }); return menuManipulator; }
public DropdownMenuAction.Status ChangeTeamActionStatus(DropdownMenuAction a) { // If a player is retired, hide the team change options return a.userData is string and "retired" ? DropdownMenuAction.Status.Hidden : DropdownMenuAction.Status.Normal; } }
Свойства
| Свойство | Описание |
|---|---|
| eventInfo | Предоставляет сведения о событии, вызвавшем открытие раскрывающегося меню. |
| name | Название элемента. |
| status | Статус пункта. |
| userData | Объект userData, хранящийся конструктором. Вы можете использовать AppendAction для его установки и использования в обратных вызовах статуса. |
Конструкторы
| Конструктор | Описание |
|---|---|
| DropdownMenuAction | Инициализация действия меню с указанными параметрами. |
Открытые методы
| Метод | Описание |
|---|---|
| Execute | Выполняет обратный вызов, связанный с этим элементом. |
| UpdateActionStatus | Обновляет флаг состояния этого элемента путем вызова обратного вызова состояния элемента. |
Статические методы
| Метод | Описание |
|---|---|
| AlwaysDisabled | Создает обратный вызов состояния, который всегда возвращает состояние Status.Disabled. |
| AlwaysEnabled | Создает обратный вызов состояния, который всегда возвращает Status.Normal. |