QWSKeyboardHandler Class Reference

Member Function Documentation

QWSKeyboardHandler::QWSKeyboardHandler ( const QString & device )

Constructs a keyboard driver. The device argument is passed by the QWS_KEYBOARD environment variable.

Call the QWSServer::setKeyboardHandler() function to make the newly created keyboard driver, the primary driver. Note that the primary driver is controlled by the system, i.e., the system will delete it upon exit.

QWSKeyboardHandler::QWSKeyboardHandler ()

This is an overloaded function.

QWSKeyboardHandler::~QWSKeyboardHandler () [virtual]

Destroys this keyboard driver.

Do not call this function if this driver is the primary keyboard handler, i.e., if QWSServer::setKeyboardHandler() function has been called passing this driver as argument. The primary keyboard driver is deleted by the system.

void QWSKeyboardHandler::beginAutoRepeat ( int unicode, int keycode, Qt::KeyboardModifiers modifier ) [protected]

Begins auto-repeating the specified key press; after a short delay the key press is sent periodically until the endAutoRepeat() function is called.

The key press is specified by its unicode, keycode and modifier state.

See also endAutoRepeat() and processKeyEvent().

void QWSKeyboardHandler::endAutoRepeat () [protected]

Stops auto-repeating a key press.

See also beginAutoRepeat() and processKeyEvent().

void QWSKeyboardHandler::processKeyEvent ( int unicode, int keycode, Qt::KeyboardModifiers modifiers, bool isPress, bool autoRepeat ) [virtual]

Sends a key event to the Qt for Embedded Linux server application.

The key event is identified by its unicode value and the keycode, modifiers, isPress and autoRepeat parameters.

The keycode parameter is the Qt keycode value as defined by the Qt::Key enum. The modifiers is an OR combination of Qt::KeyboardModifier values, indicating whether Shift/Alt/Ctrl keys are pressed. The isPress parameter is true if the event is a key press event and autoRepeat is true if the event is caused by an auto-repeat mechanism and not an actual key press.

Note that this function does not handle key mapping. Please use processKeycode() if you need that functionality.

See also processKeycode(), beginAutoRepeat(), endAutoRepeat(), and transformDirKey().

KeycodeAction QWSKeyboardHandler::processKeycode ( quint16 keycode, bool isPress, bool autoRepeat )

Maps keycode according to a keymap and sends that key event to the Qt for Embedded Linux server application.

Please see the Qt for Embedded Linux Character Input and the kmap2qmap documentations for a description on how to create and use keymap files.

The key event is identified by its keycode value and the isPress and autoRepeat parameters.

The keycode parameter is NOT the Qt keycode value as defined by the Qt::Key enum. This functions expects a standard Linux 16 bit kernel keycode as it is used in the Linux Input Event sub-system. This keycode is transformed to a Qt::Key code by using either a compiled-in US keyboard layout or by dynamically loading a keymap at startup which can be specified via the QWS_KEYBOARD environment variable.

The isPress parameter is true if the event is a key press event and autoRepeat is true if the event is caused by an auto-repeat mechanism and not an actual key press.

The return value indicates if the actual QWSKeyboardHandler implementation needs to take care of a special action, like console switching or LED handling.

If standard Linux console keymaps are used, keycode must be one of the standardized values defined in /usr/include/linux/input.h

This function was introduced in Qt 4.6.

See also processKeyEvent() and KeycodeAction.

int QWSKeyboardHandler::transformDirKey ( int keycode ) [protected]

Transforms the arrow key specified by the given keycode, to the orientation of the display and returns the transformed keycode.

The keycode is a Qt::Key value. The values identifying arrow keys are:

• Qt::Key_Left
• Qt::Key_Up
• Qt::Key_Right
• Qt::Key_Down

See also processKeyEvent().