| title | CMFCAcceleratorKey Class | Microsoft Docs | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ms.custom | ||||||||||||||
| ms.date | 11/04/2016 | |||||||||||||
| ms.reviewer | ||||||||||||||
| ms.suite | ||||||||||||||
| ms.technology |
|
|||||||||||||
| ms.tgt_pltfrm | ||||||||||||||
| ms.topic | reference | |||||||||||||
| f1_keywords |
|
|||||||||||||
| dev_langs |
|
|||||||||||||
| helpviewer_keywords |
|
|||||||||||||
| ms.assetid | d140fbf7-23db-45ea-a63e-414a5ec7b3d5 | |||||||||||||
| caps.latest.revision | 36 | |||||||||||||
| author | mikeblome | |||||||||||||
| ms.author | mblome | |||||||||||||
| manager | ghogen | |||||||||||||
| translation.priority.ht |
|
A helper class that implements virtual key mapping and formatting.
class CMFCAcceleratorKey : public CObject
| Name | Description |
|---|---|
| CMFCAcceleratorKey::CMFCAcceleratorKey | Constructs a CMFCAcceleratorKey object. |
| Name | Description |
|---|---|
| CMFCAcceleratorKey::Format | Translates the ACCEL structure to its visual representation. |
| CMFCAcceleratorKey::SetAccelerator | Sets the shortcut key for the CMFCAcceleratorKey object. |
Accelerator keys are also known as shortcut keys. If you want to display keyboard shortcuts that a user enters, the CMFCAcceleratorKeyAssignCtrl Class maps keyboard shortcuts, such as Alt+Shift+S, to a custom text format, such as "Alt + Shift + S". Each CMFCAcceleratorKey object maps a single shortcut key to a text format.
For more information about how to use shortcut keys and accelerator tables, see CKeyboardManager Class.
The following example demonstrates how to construct a CMFCAcceleratorKey object and how to use its Format method.
[!code-cppNVC_MFC_RibbonApp#30]
CMFCAcceleratorKey
Header: afxacceleratorkey.h
Constructs a CMFCAcceleratorKey object.
CMFCAcceleratorKey();
CMFCAcceleratorKey(LPACCEL lpAccel);
[in] lpAccel
A pointer to a shortcut key.
If you do not provide a shortcut key when you create a CMFCAccleratorKey, use the CMFCAcceleratorKey::SetAccelerator method to associate a shortcut key with your CMFCAcceleratorKey object.
Translates the ACCEL structure to its associated string value.
void Format(CString& str) const;
[out] str
A reference to a CString object where the method writes the translated shortcut key.
This method retrieves the string format of the associated shortcut key. You can set the string format of a CMFCAcceleratorKey object using either the constructor or the method CMFCAcceleratorKey::SetAccelerator.
Sets the shortcut key for the CMFCAcceleratorKey object.
void SetAccelerator(LPACCEL lpAccel);
[in] lpAccel
A pointer to a shortcut key.
Use this method to set the shortcut key for a CMFCAcceleratorKey if you did not provide a shortcut key when you created the CMFCAcceleratorKey.