Defines the keys to map from a {LogicalKey, KeyModifier} pair to a simple LogicalKey. More...
#include <kanzi/core.ui/input/event_source_properties.hpp>
Public Member Functions | |
| KeyMap (LogicalKey sourceKey, KeyModifier sourceModifier, LogicalKey targetKey) | |
| Constructor. More... | |
Public Attributes | |
| LogicalKey | sourceKey |
| The source logical key value. More... | |
| KeyModifier | sourceModifier |
| The source key modifier value. More... | |
| LogicalKey | targetKey |
| The target logical key value. More... | |
Defines the keys to map from a {LogicalKey, KeyModifier} pair to a simple LogicalKey.
KeyMapEventFilter uses this to translate key events.
Kanzi translates system key events to a platform-independent {LogicalKey, KeyModifier} pair. Input Manipulators translate these key events into key messages, passing the LogicalKey and KeyModifier as message arguments.
When Kanzi translates a key, the sourceKey and the sourceModifier must match with the translated key. When that happens, Kanzi translates the key so that the additional modifiers from the original key event are added to the translated key event.
For example, the {LogicalKey::Tab, KeyModifier::Shift} translation to LogicalKey::BackTab translates the {LogicalKey::Tab, KeyModifier::Shift + KeyModifier::Control} key event into {LogicalKey::BackTab, KeyModifier::Control}.
To create an application that is based on key messages with LogicalKey argument only, specify the key conversion map in the EventSourceProperties::keyMap by overriding the Application::onConfigure() method.
|
inlineexplicit |
Constructor.
| LogicalKey kanzi::KeyMap::sourceKey |
The source logical key value.
| KeyModifier kanzi::KeyMap::sourceModifier |
The source key modifier value.
| LogicalKey kanzi::KeyMap::targetKey |
The target logical key value.
