Use the following properties to define initial characteristics
of an IMenuCascade* part.
- Part properties are displayed in the part property sheet.
- Style properties are displayed in the Part style
property sheet.
IMenuCascade properties
-
- Accelerator key
- Accelerator key definition for the cascade 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 |
- conditional
- Specifies whether this is a conditional cascade menu
item. If this property is true, the submenu is
opened only if the user selects the cascade arrow. If the
user selects the cascade menu item without opening the
submenu, the default choice in the submenu is selected.
- 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 cascade 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 cascade menu item. This is
defined as a style property. The individual styles are
described as IMenuCascade style properties.
- submenuHandle
- The window handle of the submenu opened by the cascade
menu item.
- text
- Text for the menu item.
IMenuCascade 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
IMenuCascade Parts
Editing Part Properties
Style Properties
Code Properties
Resource Properties
IMenuCascade
Portability -- IMenuCascade
VisualAge User Interface Part
Properties