XTPKeyboardCuesShow Enumeration

Description

Specifies when to underline the character in menu items that indicates a shortcut key is available. These are the underlined characters used for keyboard navigation, commonly called "Access Keys".

Members

xtpKeyboardCuesShowAlways
xtpKeyboardCuesShowNever
xtpKeyboardCuesShowWindowsDefault

Under Windows XP, this setting can be found by selecting "Display" from the control panel. Clicking on the "Effects" button on the "Appearance" tab page will display a dialog that shows the current setting. By default, using the Windows XP setting will only display the underlined character for menu navigation after the "Alt" key is pressed. The underline will then be hidden after an item is selected and the menu loses focus. This allows the underline to be hidden under normal use but still provides the functionality of menu navigation when the "Alt" key is pressed.

Member	Description
xtpKeyboardCuesShowAlways	Always display the underlined characters used for keyboard navigation.
xtpKeyboardCuesShowNever	Never display the underlined characters used for keyboard navigation.
xtpKeyboardCuesShowWindowsDefault	Uses the system defined setting to display the underlined characters used for keyboard navigation.

Remarks

The KeyboardCuesShow property is used to set one of the XTPKeyboardCuesShow flags. By default, the xtpKeyboardCuesShowAlways flag is used.

The XTPKeyboardCuesShow enumeration specifies when to underline the character used for keyboard navigation (characters in menu items that indicate an Access Key is available). This is the character that has an ampersand "&" placed in front of it in the menu item caption. These are the shortcut keys that are available when pressing the "Alt" key.

These settings are cosmetic only; they do not affect the execution of the keyboard shortcuts. The XTPKeyboardCuesUse enumeration specifies whether the shortcut keys actually execute.

Example

ShowKeyboardCues Sample (Visual Basic) This sample illustrates how to remove the underline from the character in menu items with an ampersand "&". This will not affect the behavior of the shortcut keys.

CommandBars.Options.KeyboardCuesShow = xtpKeyboardCuesShowNever