Gets a constant that describes the behavior of this keyboard's modifier keys such as KeyEvent.KEYCODE_SHIFT_LEFT.

• Chorded behavior: When the modifier key is pressed together with one or more character keys, the keyboard inserts the modified keys and then resets the modifier state when the modifier key is released.
• Toggled behavior: When the modifier key is pressed and released on its own it first toggles into a latched state. When latched, the modifier will apply to next character key that is pressed and will then reset itself to the initial state. If the modifier is already latched and the modifier key is pressed and release on its own again, then it toggles into a locked state. When locked, the modifier will apply to all subsequent character keys that are pressed until unlocked by pressing the modifier key on its own one more time to reset it to the initial state. Toggled behavior is useful for small profile keyboards designed for thumb typing.

Currently there are two behaviors that may be combined:

This function currently returns KeyCharacterMap.MODIFIER_BEHAVIOR_CHORDED when the KeyCharacterMap.KeyboardType is KeyCharacterMap.FULL or KeyCharacterMap.SPECIAL_FUNCTION and KeyCharacterMap.MODIFIER_BEHAVIOR_CHORDED_OR_TOGGLED otherwise. In the future, the function may also take into account global keyboard accessibility settings, other user preferences, or new device capabilities.

[Android Documentation]