itemName | The itemName is the menu item represented like a pathname.
For example, the menu item could be "GameObject/Do Something" . |
isValidateFunction | If isValidateFunction is true, this is a validation
function and is called before the menu function with the same itemName is invoked. |
priority | メニューアイテムを表示する順番 |
Creates a menu item and invokes the static function that follows it when the menu item is selected.
MenuItem
is an attribute that precedes a script function. This makes the function appear in the Unity menu system. The menu location is specified by the itemName
argument.
isValidateFunction
is used to make a MenuItem
function as one is executed before a script function with the same itemName
argument. The second argument is boolean. If this argument is set to true
, it marks the associated function to be called before the execution of the second script function. This second script function with the same itemName
executes next.
priority
determines how the following script function is ordered in the menu system. The integer value is compared against values on other script functions. Parent menus derive their priority value from their first defined submenu. If the integer value is greater than the other values, then the MenuItem
script function is placed at the bottom of the list. The value of priority
can also be used to manage the list of script functions into groups. The example later in this page demonstrates more about this feature.
The following script example adds two functions into an Example menu system.
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"); } }
The following example shows how the Example
menu can have two entries divided by a separator line. When a priority
argument is separated by more than 10, a separator line is created between two entries.
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"); } }
Note: The understanding of ten or greater is considered to create a divider
in the menu. However, as per the example above, the difference between script
function need to have the priority
separated by 11 or more. This is why the
example before has a value of 100 and one of 111. Changing 111 to 110 does
not have a divider.