Menu Property Editor

The Menu Property Editor is used to create menus. A menu, unlike most of the objects edited in the Revolving Property Editor, is a created object and is not available from the object palettes.

Only properties unique to a menu object are described here. See "Property Editor: Universal Properties" for descriptions of Object Type, Objects, Object Name, and Color. See "Property Editor: Common Properties" for descriptions of Items, Label, and Item State (Active).

Add New Menu

Adds a new menu to the list of menus.

Edit

Performs edit functions (Cut, Copy, Paste, Delete) on the selected item in the list of menu objects. Cut and Copy place the selected item in a buffer, ready for Paste. Delete removes the item, but does not place it in a buffer.

Tearoff

Specifies whether tearoff is Enabled or Disabled. If tearoff is enabled the selected menu will be "postable." That is, the menu will be displayed until you explicitly dismiss it if you click on the Tearoff indicator (a dotted line).

Item Label Type

Specifies the type of label (String, Graphic, or Separator) for the item selected in the Items list. If Graphic is chosen, Label becomes Graphic Filename. If Separator is chosen, Label or Graphic Filename becomes inactive and Line Style becomes active. A Separator menu item is used to create a visual division in a menu, such as that seen in the Editors menu of the App Builder primary window.

Item Mnemonic

Specifies one of the letters in the selected item as a keyboard shortcut for choosing the item when the menu is posted. The letter specified will be underlined. Pressing the mnemonic letter when the menu is posted causes that item to be chosen. Note that case is significant and that a particular letter can be used as a mnemonic only once within a menu.

Accelerator

Specifies a keyboard shortcut for choosing the selected item. An accelerator is comprised of a prefix (Ctrl, Alt, Meta, or Shift), <Key>, and a letter (uppercase or lowercase). To make Control-x an accelerator, for instance, type the following:

Ctrl<Key>x

When you display the menu in test mode or in the compiled application, Ctrl+x will be included to the right of the menu item label. If you press the Control key and type x with focus in the window that contains the menu, the action specified in the menu item will be performed.

You can combine the Shift key with one of the other keys to form a compound prefix, if you wish. To make Shift Control-x an accelerator, type the following:

Shift Ctrl<Key>x

Line Style

Specifies the type of line style for the selected separator item; active only when Item Label Type is Separator. Choices are None, Etched In, Etched Out, Etched In Dash, Etched Out Dash, Single Line, Double Line, Single Dashed Line, and Double Dashed Line. A separator of the chosen line style will be displayed in the menu instead of a graphic or text label.

Item SubMenu

A menu button and a text field for attaching, de-attaching, creating, or editing a submenu for the selected item in the Items list. If a submenu is attached to the selected item, the name of the submenu will be displayed in the text field. Not valid for separator item type.