KisExtendedModifiersMapper Class Reference

#include <kis_extended_modifiers_mapper.h>

Classes
struct	Private

Public Types
typedef QVector< Qt::Key >	ExtendedModifiers

Public Member Functions
	KisExtendedModifiersMapper ()
ExtendedModifiers	queryExtendedModifiers ()
Qt::KeyboardModifiers	queryStandardModifiers ()
	~KisExtendedModifiersMapper ()

Static Public Member Functions
static ExtendedModifiers	qtModifiersToQtKeys (Qt::KeyboardModifiers standardModifiers)
static Qt::Key	workaroundShiftAltMetaHell (const QKeyEvent *keyEvent)

Private Attributes
QScopedPointer< Private >	m_d

Detailed Description

Definition at line 19 of file kis_extended_modifiers_mapper.h.

Member Typedef Documentation

ExtendedModifiers

typedef QVector<Qt::Key> KisExtendedModifiersMapper::ExtendedModifiers

Definition at line 25 of file kis_extended_modifiers_mapper.h.

Constructor & Destructor Documentation

KisExtendedModifiersMapper()

KisExtendedModifiersMapper::KisExtendedModifiersMapper

(

)

Definition at line 77 of file kis_extended_modifiers_mapper.cpp.

    : m_d(new Private)
{
}

~KisExtendedModifiersMapper()

KisExtendedModifiersMapper::~KisExtendedModifiersMapper

(

)

Definition at line 82 of file kis_extended_modifiers_mapper.cpp.

{
}

Member Function Documentation

qtModifiersToQtKeys()

KisExtendedModifiersMapper::ExtendedModifiers KisExtendedModifiersMapper::qtModifiersToQtKeys ( Qt::KeyboardModifiers standardModifiers )

static

Definition at line 135 of file kis_extended_modifiers_mapper.cpp.

{
    ExtendedModifiers modifiers;
 
    if (standardModifiers & Qt::ShiftModifier) {
        modifiers << Qt::Key_Shift;
    }
 
    if (standardModifiers & Qt::ControlModifier) {
        modifiers << Qt::Key_Control;
    }
 
    if (standardModifiers & Qt::AltModifier) {
        modifiers << Qt::Key_Alt;
    }
 
    if (standardModifiers & Qt::MetaModifier) {
        modifiers << Qt::Key_Meta;
    }
 
    return modifiers;
}

queryExtendedModifiers()

KisExtendedModifiersMapper::ExtendedModifiers KisExtendedModifiersMapper::queryExtendedModifiers

(

)

Query the native platform API for keys.

A word of caution: using the result of this to modify KisShortcutMatcher's state (directly or indirectly) can result in keys becoming "stuck" whenever we observe key status through this function, especially when the application does not have focus. On Windows in particular, [Windows Key]+D or [Windows Key]+[0~9] are prone to this behavior.

See also

KisInputManager::Private::fixShortcutMatcherModifiersState

Definition at line 95 of file kis_extended_modifiers_mapper.cpp.

{
    KisExtendedModifiersMapperPluginInterface *plugin =
        static_cast<KisApplication*>(qApp)->extendedModifiersPluginInterface();
 
    if (plugin) {
        return plugin->queryExtendedModifiers();
    }
 
    ExtendedModifiers modifiers;
 
#if defined Q_OS_WIN
    modifiers = queryPressedKeysWin();
#elif defined Q_OS_MACOS
    modifiers = queryPressedKeysMac();
#else
    modifiers = qtModifiersToQtKeys(queryStandardModifiers());
#endif
 
    return modifiers;
}

References qtModifiersToQtKeys(), KisExtendedModifiersMapperPluginInterface::queryExtendedModifiers(), queryPressedKeysMac(), and queryStandardModifiers().

queryStandardModifiers()

Qt::KeyboardModifiers KisExtendedModifiersMapper::queryStandardModifiers

(

)

Definition at line 117 of file kis_extended_modifiers_mapper.cpp.

{
    return QApplication::queryKeyboardModifiers();
}

workaroundShiftAltMetaHell()

Qt::Key KisExtendedModifiersMapper::workaroundShiftAltMetaHell ( const QKeyEvent * keyEvent )

static

Definition at line 122 of file kis_extended_modifiers_mapper.cpp.

{
    Qt::Key key = (Qt::Key)keyEvent->key();
 
    if (keyEvent->key() == Qt::Key_Meta &&
        keyEvent->modifiers().testFlag(Qt::ShiftModifier)) {
 
        key = Qt::Key_Alt;
    }
 
    return key;
}

Member Data Documentation

m_d

QScopedPointer<Private> KisExtendedModifiersMapper::m_d

private

Definition at line 48 of file kis_extended_modifiers_mapper.h.

---

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

• libs/ui/input/kis_extended_modifiers_mapper.h
• libs/ui/input/kis_extended_modifiers_mapper.cpp