Sharing Menus

A menu can be shared across multiple pages and multiple forms; the Menu Controls (horizontal or vertical) then share their runtime state. In practice, this means that the correct menu item is marked as selected as the user moves between pages and forms.

To achieve this, you place the appropriate Menu Control on each page where you want it to appear, ensure that all menus have the same structure, and then set the sharing properties (Menu Sharing tab) as follows:

Sharable	check this box to indicate that the menu is shared
Share name	this is the name that identifies the shared menu and provides the link between the different Menu Controls. It can be any name, but care should be taken to ensure that menus are not shared unintentionally.

Note that the item name property for all menu items, whether static or dynamic, must be the same for equivalent menu items in each shared menu structure.

As noted above, all participating Menu Controls must have the same structure. One way to achieve this is to place the Menu Control in a part-page component then insert the component into form pages as required; another possibility is to copy/paste the Menu Control from one page to another.

When a menu is shared, the menu state can be accessed via any of the sharing Menu Controls. e.g. Menu Controls with ids MENU1 and MENU2 are marked as shared, MENU1.selected is equivalent to MENU2.selected.