Property Settings -- IMenuSeparator

Use the following properties to define initial characteristics of an IMenuSeparator* part.

IMenuSeparator properties

Accelerator key
Accelerator key definition for the menu item. This is defined as a code property. Enter code to specify the accelerator.

bitmap
Specifies a bitmap for the menu item. This is defined as a resource property.

checked
Specifies whether the menu item is currently selected. If nothing is specified, false is assumed. This property is typically used for one of the following:

commandType
Sets styles to specify the system event type generated by the menu item. This property is typically used for action choices. Command styles are set as follows:
Value of commandType property Style settings
postHelp postSystemCommand
command off off
helpCommand on off
systemCommand off on

disabled
Specifies whether the menu item is enabled for selection. If this property is true, the user can move the cursor to the menu item, but cannot select it. If nothing is specified, false is assumed.

framed
Specifies whether a box is drawn around the menu item. If nothing is specified, false is assumed.

helpId
The ID of the help panel for the menu item. To display the help, you must add an IHelpWindow* part to the composite part for the primary application window.

highlighted
Specifies whether the menu item is highlighted for selected-state emphasis. If nothing is specified, false is assumed.

index
The 0-based index of menu item within a menu.

Info area text
Text that is displayed in a status area when the user selects the menu item. To display the text, you must add an IVBInfoArea* part to the window.

layoutType
Sets styles to specify the layout of the menu item. Layout styles are set as follows:
Value of layoutType property Style settings
buttonSeparator split splitWithSeparator
normalLayout off off off
splitLayout off on off
splitWithSeparatorLayout off off on

noDismiss
Specifies whether the menu is dismissed when the user selects the menu item. If this property is true, the menu is not dismissed. If nothing is specified, false is assumed.

partName
The composition name of the part. This name is used for the class instance in generated code.

selectable
Sets the unavailable style. If this property is true, the style is set to off.

style
The style settings for the menu item. This is defined as a style property. The individual styles are described as IMenuSeparator style properties.

submenuHandle
The window handle of the submenu opened by the cascade menu item.

IMenuSeparator style properties

add default bits
Specifies whether the default style settings are used as a base for part styles. The initial value is true. The default style is shipped with no styles on.

buttonSeparator
Specifies whether the menu item is a button at the end of the menu, after a separator line. Menu items with this style are selectable only with a mouse. This style is mutually exclusive with the split and splitWithSeparator styles.

drawItem
Specifies whether the menu item is drawn by the application, using an IMenuItemDrawHandler.

postHelp
Specifies whether the menu item generates an IHelpEvent for a help message when selected. This style is mutually exclusive with the postSystemCommand style.

postSystemCommand
Specifies whether the menu item generates an ICommandEvent for a system command when selected. This style is mutually exclusive with the postHelp style.

separator
Specifies whether the menu item is a separator line.

split
Specifies whether the menu item is displayed in a new row or column. This style is mutually exclusive with the buttonSeparator and splitWithSeparator styles.

splitWithSeparator
Specifies whether the menu item is displayed in a new row or column, preceded by a separator line. This style is mutually exclusive with the buttonSeparator and split styles.

unavailable
Specifies whether the user can move the cursor to the menu item or select it.


Related procedures
Working with IMenuSeparator Parts
Editing Part Properties

Related references
Style Properties
Code Properties
Resource Properties
IMenuSeparator
Portability -- IMenuSeparator
VisualAge User Interface Part Properties