The KeyEvent holds a pressed, released, or auto-repeated key event which occurs in the host operating system. More...

#include <kanzi/core.ui/platform/input/common/events.hpp>

Inheritance diagram for kanzi::KeyEvent:

Public Member Functions
LogicalKey	getKey () const
	Returns the LogicalKey value of the key event. More...

KeyModifier	getKeyAsModifier () const
	Returns the KeyModifier value of the key event LogicalKey value. More...

LogicalKey	getKeyDown () const
	Returns the logical key value of the key event if the event is in pressed state. More...

size_t	getKeyRepeatCount () const
	Returns the key-press repetition count. More...

LogicalKey	getKeyUp () const
	Returns the logical key value of the key event if the event is in released state. More...

KeyModifier	getModifiers () const
	Returns the modifiers bit fields of the key event. More...

size_t	getRawKey () const
	Returns the raw key code of the event, or 0 if the event was created with no raw key code. More...

KeyState	getState () const
	Returns the state of the key event. More...

bool	hasAltModifier () const
	Checks whether the key event has any of the Alt key modifiers set. More...

bool	hasCapsLock () const
	Returns whether the key event is created with the KeyModifier::CapsLock modifier. More...

bool	hasControlModifier () const
	Checks whether the key event has any of the Control key modifiers set. More...

bool	hasModifier (KeyModifier modifier) const
	Checks whether the given modifier is set on the key event. More...

bool	hasShiftModifier () const
	Checks whether the key event has any of the Shift key modifiers set. More...

bool	hasSuperModifier () const
	Checks whether the key event has any of the Super key modifiers set. More...

bool	isDown () const
	Returns true if the key event represents a key down status, meaning it has Pressed status. More...

bool	isKeyModifier () const
	Checks whether the key of the event is a modifier key. More...

bool	isTranslated () const
	Returns true if the key event holds a translated operating system key event. More...

bool	isUp () const
	Returns true if the key event represents a key released status. More...

bool	isValid () const
	Checks whether the key event is valid. More...

	KeyEvent (LogicalKey key, KeyModifier modifiers, KeyState state)
	Creates a key event with a logical key, modifiers and state. More...

	KeyEvent (size_t rawKeyCode, KeyState state)
	Creates a key event with a rawKeyCode and state. More...

	KeyEvent (LogicalKey key, KeyModifier modifiers, size_t repeatCount)
	Creates a key-press repetition event with a logical key, modifiers and repeatCount. More...

	KeyEvent (size_t rawKeyCode, size_t repeatCount)
	Creates a key-press repetition event with a logical rawKeyCode and repeatCount. More...

Public Member Functions inherited from kanzi::InputEvent
Type	getType () const
	Returns the type of the event. More...

	InputEvent (Type type)
	Constructs an event with a given type. More...

bool	isHandled () const
	Returns true if the event is handled, false if not. More...

void	markHandled ()
	Marks the event as handled. More...

virtual	~InputEvent ()
	Destructor. More...

Protected Member Functions
	KeyEvent ()
	Constructor. Creates an invalid key event. More...

Protected Attributes
bool	m_capsLock
	The Caps lock state. More...

LogicalKey	m_key
	The translated logical key code. More...

KeyModifier	m_modifiers
	The key modifier flags applied on the key stroke. More...

size_t	m_rawKeyCode
	The raw key code, an operating system specific value. More...

size_t	m_repeatCount
	The key-press repetition count. More...

KeyState	m_state
	The key event state. More...

Additional Inherited Members
Public Types inherited from kanzi::InputEvent
enum	Type { Key, Pointer, Touch, WindowResized, WindowResizeRequest, WindowFocusLost, WindowFocusGained, WindowHidden, WindowResourcesLost, WindowOrientationChanged, WindowRedrawRequest, WindowPlacement, WindowClosed, ApplicationPaused, ApplicationSleep, ApplicationWakeup, DebugToggleHud, DebugSetHud, UserEvent }
	InputEvent type enumeration. More...

Detailed Description

The KeyEvent holds a pressed, released, or auto-repeated key event which occurs in the host operating system.

Contains the logical key code translated from the raw operating system specific key code and the key modifiers of the key.

Operating system adaptations must map the raw key code into a LogicalKey value, set the applicable key modifiers, and, if possible, provide the key symbol that maps the raw key code to the current hardware keyboard layout.

If the application does not detect any key modifiers or the modifier presented by the operating system does not match any modifier defined by Kanzi, set KeyModifier::Undefined.

When the operating system key code does not match any logical key defined in Kanzi, create the key event with the raw key code set. When you create a KeyEvent in this way, you tell Kanzi that the raw key code is the only valid information when handling the event.

The type of the event is InputEvent::Key.

Constructor & Destructor Documentation

kanzi::KeyEvent::KeyEvent	(	LogicalKey	key,
		KeyModifier	modifiers,
		KeyState	state
	)

explicit

Creates a key event with a logical key, modifiers and state.

The raw key code of the key event created in this way is set to 0.

Parameters

key	The logical key code of the event.
modifiers	The key modifiers accompanying the key event.
state	The key state.

kanzi::KeyEvent::KeyEvent	(	size_t	rawKeyCode,
		KeyState	state
	)

explicit

Creates a key event with a rawKeyCode and state.

Use this constructor when the raw key code does not map to any logical key code defined in Kanzi.

Parameters

rawKeyCode	The operating system specific raw key code.
state	The key state.

kanzi::KeyEvent::KeyEvent	(	LogicalKey	key,
		KeyModifier	modifiers,
		size_t	repeatCount
	)

explicit

Creates a key-press repetition event with a logical key, modifiers and repeatCount.

Parameters

key	The logical key code of the event.
modifiers	The key modifiers accompanying the key event.
repeatCount	The key-press repetition count.

Since: Kanzi 3.9.0

kanzi::KeyEvent::KeyEvent	(	size_t	rawKeyCode,
		size_t	repeatCount
	)

explicit

Creates a key-press repetition event with a logical rawKeyCode and repeatCount.

Parameters

rawKeyCode	The operating system specific raw key code.
repeatCount	The key-press repetition count.

Since: Kanzi 3.9.0

kanzi::KeyEvent::KeyEvent ( )

explicitprotected

Constructor. Creates an invalid key event.

Member Function Documentation

bool kanzi::KeyEvent::isValid ( ) const

Checks whether the key event is valid.

A key event is valid if it has either the raw key value or the LogicalKey value set.

Returns: If the key event is valid, returns true, otherwise false.

Since: Kanzi 3.9.0

size_t kanzi::KeyEvent::getRawKey ( ) const

inline

Returns the raw key code of the event, or 0 if the event was created with no raw key code.

Note that this method returns the value that is specific to the operating system.

LogicalKey kanzi::KeyEvent::getKey ( ) const

inline

Returns the LogicalKey value of the key event.

KeyModifier kanzi::KeyEvent::getModifiers ( ) const

inline

Returns the modifiers bit fields of the key event.

Since: Kanzi 3.8.0 returns KeyModifier.

KeyState kanzi::KeyEvent::getState ( ) const

inline

Returns the state of the key event.

See also: State

bool kanzi::KeyEvent::isDown ( ) const

inline

Returns true if the key event represents a key down status, meaning it has Pressed status.

See also: State

bool kanzi::KeyEvent::isUp ( ) const

inline

Returns true if the key event represents a key released status.

bool kanzi::KeyEvent::hasModifier ( KeyModifier modifier ) const

inline

Checks whether the given modifier is set on the key event.

Returns: true if the modifier is set, false otherwise.

bool kanzi::KeyEvent::isKeyModifier ( ) const

Checks whether the key of the event is a modifier key.

Returns: If the key is a modifier key, returns true, otherwise false.

Since: Kanzi 3.9.0

KeyModifier kanzi::KeyEvent::getKeyAsModifier ( ) const

Returns the KeyModifier value of the key event LogicalKey value.

Returns: The KeyModifier value of the key event LogicalKey value. If the LogicalKey value is not a key modifier, returns KeyModifier::Undefined.

Since: Kanzi 3.9.4

LogicalKey kanzi::KeyEvent::getKeyDown ( ) const

inline

Returns the logical key value of the key event if the event is in pressed state.

Returns: The logical key value if pressed, KeyMax if the key is not pressed.

size_t kanzi::KeyEvent::getKeyRepeatCount ( ) const

inline

Returns the key-press repetition count.

Returns: The key-press repetition count. If the key is not pressed, returns 0u.

Since: Kanzi 3.9.0

LogicalKey kanzi::KeyEvent::getKeyUp ( ) const

inline

Returns the logical key value of the key event if the event is in released state.

Returns: The logical key value if released, KeyMax if the key is not in released state.

bool kanzi::KeyEvent::isTranslated ( ) const

inline

Returns true if the key event holds a translated operating system key event.

bool kanzi::KeyEvent::hasShiftModifier ( ) const

Checks whether the key event has any of the Shift key modifiers set.

Returns: If the key event has one of the Shift modifiers set, true, otherwise false.

See also: KeyModifier

bool kanzi::KeyEvent::hasAltModifier ( ) const

Checks whether the key event has any of the Alt key modifiers set.

Returns: If the key event has one of the Alt modifiers set, true, otherwise false.

See also: KeyModifier

bool kanzi::KeyEvent::hasControlModifier ( ) const

Checks whether the key event has any of the Control key modifiers set.

Returns: If the key event has one of the Control modifiers set, true, otherwise false.

See also: KeyModifier

bool kanzi::KeyEvent::hasSuperModifier ( ) const

Checks whether the key event has any of the Super key modifiers set.

Returns: If the key event has one of the Super modifiers set, true, otherwise false.

See also: KeyModifier

bool kanzi::KeyEvent::hasCapsLock ( ) const

inline

Returns whether the key event is created with the KeyModifier::CapsLock modifier.

Returns: If the key event is created with the KeyModifier::CapsLock modifier, true, otherwise false.

Since: Kanzi 3.9.0

Member Data Documentation

size_t kanzi::KeyEvent::m_rawKeyCode

protected

The raw key code, an operating system specific value.

If you create the event with no raw key code, this value is 0.

size_t kanzi::KeyEvent::m_repeatCount

protected

The key-press repetition count.

Since: Kanzi 3.9.0

KeyModifier kanzi::KeyEvent::m_modifiers

protected

The key modifier flags applied on the key stroke.

LogicalKey kanzi::KeyEvent::m_key

protected

The translated logical key code.

KeyState kanzi::KeyEvent::m_state

protected

The key event state.

bool kanzi::KeyEvent::m_capsLock

protected

The Caps lock state.

The documentation for this class was generated from the following file:

kanzi/core.ui/platform/input/common/events.hpp

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation