Use the following properties to define initial characteristics
of an IMenuSeparator* part.
- Part properties are displayed in the part property sheet.
- Style properties are displayed in the Part style
property sheet.
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:
- a default action choice in a submenu
- a settings choice
- 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.
Working with
IMenuSeparator Parts
Editing Part Properties
Style Properties
Code Properties
Resource Properties
IMenuSeparator
Portability -- IMenuSeparator
VisualAge User Interface Part
Properties