Untitled

Main label or alias

You can also insert a menu with the Pn= syntax. The following macro inserts

a menu after the P5 menu.

If you use this method to insert a menu, remember that you cannot rely on

its being inserted at the P6 menu location as you might expect. There are two

reasons that this may not be the case.

■ If the current menu bar has only three menus, inserting a menu after menu

P5 results in the new menu's location being P4.

■ If the user inserts or removes a customization file with the CUILOAD

command or when another application inserts or removes customization

files, menu numbering can get out of sync.

This is the syntax for removing a menu:

Gcustomizationgroup.menuname=-

The following shows how to remove the menu NEW3 that is a member of the

MyMenu group.

$Gmymenu.new3=-"

As you might expect, the preceding format is preferable to the Pn= format

because it removes only the specified menu. The following shows how to

remove the menu at the P4 location (whatever it is).

$P4=-

Control Toolbars Across Partial CUIx Files

To control toolbars across partial CUIx files, use the following syntax at the

Enter toolbar name or [ALL]: prompt of the -TOOLBAR command.

menugroup.subsection-name

This syntax accesses the toolbar identified by menugroup.menuname and allows

you to use the full spectrum of -TOOLBAR command options on that toolbar.

If the menu group is left out of any of these commands and functions, the

program defaults to the main CUIx file.

You should be aware of the following:

■ Image tile menus cannot be swapped from external customization files.

232 | Chapter 4 User Interface Customization