Inserting Menus into a Bar

You can insert new fields into a menu bar using the InsertBefore() and InsertAfter() methods, which insert the new fields relative to existing named menus. The methods use named menus to determine the point where they should insert the new menu.

The general syntax is:

InsertBefore(<TargetMenuName>, <Dtext>, <MenuName>)

InsertAfter(<TargetMenuName>, <Dtext>, <MenuName>)

Where the fields have the following meanings:

For example:

setup form !!MyForm Dialog size 30 5

 bar

 -- adds a pulldown for menu1 labelled with <dtext>

 !this.bar.Add( ‘<dtext>’, ‘menu1’ )

 -- adds a window pulldown labelled with <dtext>

 !this.bar.Add( ‘<dtext>’, ‘Window’ )

 -- adds a help pulldown labelled with <dtext>

 !bar.InsertAfter( ‘Window’, ‘<dtext>’, ‘Help’ )

 ...

exit

If you use the identifier ‘Window’ or ‘Help’ as the name of the menu, the system will interpret them as system Window and Help menus, although they will still be displayed with the string given in <dtext>.

Named menus and the methods that create them are discussed in more detail in the rest of this section.