UIElements 中内置了以下标准控件:
Contextual menus can present a set of choices or actions to the user, depending on the context. This context is usually the current selection, but the context can be anything.
本主题将说明如何添加上下文菜单,介绍其回调,并展示如何响应用户选择。
要启用上下文菜单,请将 ContextualMenuManipulator
操控器添加到视觉元素。此操控器会在发生鼠标右键按下事件或菜单键松开事件后显示上下文菜单。ContextualMenuManipulator
操控器还会添加一个对应于 ContextualMenuPopulateEvent
的回调。以下代码示例展示了如何执行此操作:
void InstallManipulator(VisualElement element)
{
ContextualMenuManipulator m = new ContextualMenuManipulator(MyDelegate);
m.target = element;
}
void MyDelegate(ContextualMenuPopulateEvent event)
{
// 修改 event.menu
event.menu.AppendAction("Properties", DisplayProperties, DropdownMenu.MenuAction.AlwaysEnabled);
}
void DisplayProperties(DropdownMenu.MenuAction menuItem)
{
// ...
}
The callback given to the ContextualMenuManipulator
constructor will be invoked last to allow children elements to populate the menu.
在内部,操控器会发送一个 ContextualMenuPopulateEvent
事件,此事件沿以下传播路径传播到目标元素层级视图:从视觉树的根到事件目标,再退回到视觉树的根。沿着传播路径,具有 ContextualMenuPopulateEvent
事件回调的元素可以在上下文菜单中添加、删除或修改菜单项。
一个元素收到 ContextualMenuPopulateEvent
时会通过调用 DropdownMenu.InsertAction()
或 DropdownMenu.AppendAction()
将菜单项添加到上下文菜单中。
这些函数中的每一个函数都采用两个回调作为参数。用户在菜单中选择菜单项时执行第一个回调。在显示菜单之前执行第二个回调。第二个回调还会检查菜单项是否已启用。
两个回调都接收一个 MenuAction
作为参数。MenuAction
代表菜单项,具有以下其他有用的属性:
MenuAction.userData
会引用可能已用于 AppendAction()
或 InsertAction()
的用户数据。MenuAction.eventInfo
包含触发上下文菜单显示的事件的
相关信息。应在响应事件的操作中使用 MenuAction.eventInfo
。例如,可以使用鼠标位置根据所选的上下文菜单项创建和放置对象。