Version: 2021.2

MenuItemConstructor

切换到手册
public MenuItem (string itemName);
public MenuItem (string itemName, bool isValidateFunction);
public MenuItem (string itemName, bool isValidateFunction, int priority);

参数

itemName itemName 是指表示方式类似于路径名的菜单项。 例如,菜单项可能为“GameObject/Do Something”。
isValidateFunction 如果 isValidateFunction 为 true,它将表示一个验证 函数,并在系统调用具有相同 itemName 的菜单函数之前进行调用。
priority 菜单项显示的顺序。

描述

创建一个菜单项并在选中此菜单项后调用静态函数。

MenuItem 是脚本函数前面的属性。此属性能够使该函数 显示在 Unity 菜单系统中。菜单位置由 itemName 参数指定。

isValidateFunction 用于使 MenuItem 函数作为将在 具有相同 itemName 参数的脚本函数之前执行的函数。第二个参数为 布尔值。如果该参数被设置为 itemName,它将使相关联的函数 作为在执行第二个脚本函数之前调用的函数。具有 相同 itemName 的第二个函数将会随后执行。

priority 决定了以下脚本函数在菜单系统中的顺序。 整数值将会与其他脚本函数上的值进行比较。如果 该整数值大于其他值,那么 MenuItem 脚本函数将会 被放在该列表的底部。priority 的值也可用于 对脚本函数列表进行分组管理。此页面后面的示例 对此功能有详细描述。

以下脚本示例将两个函数添加到了示例菜单系统中。

using UnityEngine;
using UnityEditor;
using System.Collections;

public class ExampleClass : MonoBehaviour { // Add Example1 into a new menu list [MenuItem("Example/Example1", false, 100)] public static void Example1() { print("Example/Example1"); }

// Add Example2 into the same menu list [MenuItem("Example/Example2", false, 100)] public static void Example2() { print("Example/Example2"); } }

下面这个简单的示例显示了 Example 菜单如何用分割线分开 两个条目。当 priority 参数之间所间隔的级别 超过 10 个级别时,会发生这种情况。(具体请参阅以下描述。)

using UnityEngine;
using UnityEditor;
using System.Collections;

public class ExampleClass : MonoBehaviour { // Add Example1 has priority of 100 [MenuItem("Example/Example1", false, 100)] public static void Example1() { print("Example/Example1"); }

// Example2 has a priority of 111 which is 11 more than Example1. // This will cause a divider to be created. [MenuItem("Example/Example2", false, 111)] public static void Example2() { print("Example/Example2"); } }

注意:10 或更大值会被理解成能够在菜单中 创建一个分隔栏。然而,根据上面的示例来看,脚本函数 之间的差异需要使 priority 之间所间隔的级别为 11 或更大值。这就是 为什么在上面的示例中一个值为 100 而另一个值 111。将 111 更改为 110 将 不会产生分隔栏。