Product Logo

CNS Menu

Dynamic Menus


insertmenu Tag

Nameinsertmenu Tag

This tag allows you to insert any menu into another menu when that menu is displayed. The menu you are inserting does not have to be defined when you define the parent menu (the one you are inserting into), but it does need to be defined by the first time you display the parent menu. The items from the inserted menu are inserted directly into the parent menu. If you want to insert the menu as a sub menu, you must wrap the <insertmenu> tag in <submenu> and </submenu> tags. If none of the menu items from the menu you are inserting have databases and/or scripts defined, then the parent menu’s default database and default script will be used. You need to at least define the name attribute to have a valid <insertmenu> tag. This is an empty tag, so you can either use a forward-slash before the closing angled bracket (“/>”) or follow the tag immediately with a closing </insertmenu> tag. This tag has three attributes, one of which is required.

<insertmenu name="menu name to insert" groupid="abc" modifierkeys="ctrl+shift" />
Required Attributes
  • name
    Defines the name of the menu you want to insert. When you show the parent menu, this name must equal a name of another menu you have defined.
Optional Attributes
  • groupid
    Defines a user-supplied group identifier for this inserted menu. This is used in conjunction with the modifierkeys attribute to selectively show alternative menu items depending on which modifier keys are held down. See the Hidden Items Example in the CNS Menu example database for examples that use this attribute. Default value is "".
  • modifierkeys
    Defines the modifier keys that are required in order to insert this menu. Specify "none" or "shift", "ctrl", "opt", "cmd", or combinations using the plus sign ("shift+ctrl+cmd"). If the specified modifier keys are not held down when the parent menu is shown, this menu will not be inserted. If you are making a cross-platform solution, you will only want to use the "ctrl" and "shift" modifier keys because windows does not have the "opt" and "cmd" keys. Default value is "none".