Setting Up a Menu Path (Magic xpa 3.x)
You can set up the menu path in the MnuAdd function. The menu path is defined by Entry Names, separated by a backslash (\). The backslash denotes a submenu in the menu structure. For example, let’s look at the following structure (the entry name is in brackets):
File (fle)
|
Edit
|
View
|
Help
|
New (nw)
|
Cut
|
|
|
Message (msg)
|
Copy
|
|
|
Fax
|
Paste
|
|
|
Open (opn)
|
|
|
|
Message
|
|
|
|
-
To add an entry to the “File” menu, called “Project”, that will appear after the “New” submenu but on the same level, you would enter: fle\nw. The "File" menu will now contain New Project Open.
-
To add an entry called “Close”, which will be the first entry of the “File” submenu, you would enter: fle\. In this case, the new entry will be the first entry because of the trailing slash. The "File" menu will now contain Close New Open.
-
To add an entry called “Contact” in the “New” submenu of File, you would enter: fle\nw\. In this case, the new entry will be added at the beginning of the “New” submenu, which will now contain Contact Message Fax.
-
To add an entry called “Contact” in the “New” submenu of File but after the Message entry, you would enter: fle\nw\msg. In this case, the new entry will be added after the message entry. The "New" submenu will now contain Message Contact Fax.
-
If the name does not exist, it will be added at the end of the last menu for which a path was found. For instance, if you want to add an entry called “Properties” that you want to place after the Print menu entry, you will enter: fle\prn. But, if “prn” does not exist, the “Properties” entry will be placed at the end of the “File” menu. The "File" menu will now contain Close New Open Properties.
-
If the path is blank, the menu will be added to the bottom (at the end) of the pulldown menu.
-
If the path does not exist, the function will return False and no menu entry will be added.
Menu Context in Runtime