/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Copyright (C) 2013 Ivan Komissarov. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the QtWidgets module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qkeysequenceedit.h" #include "qkeysequenceedit_p.h" #include "qboxlayout.h" #include "qlineedit.h" #include QT_BEGIN_NAMESPACE #ifndef QT_NO_KEYSEQUENCEEDIT Q_STATIC_ASSERT(QKeySequencePrivate::MaxKeyCount == 4); // assumed by the code around here void QKeySequenceEditPrivate::init() { Q_Q(QKeySequenceEdit); lineEdit = new QLineEdit(q); lineEdit->setObjectName(QStringLiteral("qt_keysequenceedit_lineedit")); keyNum = 0; prevKey = -1; releaseTimer = 0; QVBoxLayout *layout = new QVBoxLayout(q); layout->setContentsMargins(0, 0, 0, 0); layout->addWidget(lineEdit); key[0] = key[1] = key[2] = key[3] = 0; lineEdit->setFocusProxy(q); lineEdit->installEventFilter(q); resetState(); q->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed); q->setFocusPolicy(Qt::StrongFocus); q->setAttribute(Qt::WA_MacShowFocusRect, true); q->setAttribute(Qt::WA_InputMethodEnabled, false); // TODO: add clear button } int QKeySequenceEditPrivate::translateModifiers(Qt::KeyboardModifiers state, const QString &text) { Q_UNUSED(text); int result = 0; if (state & Qt::ControlModifier) result |= Qt::CTRL; if (state & Qt::MetaModifier) result |= Qt::META; if (state & Qt::AltModifier) result |= Qt::ALT; return result; } void QKeySequenceEditPrivate::resetState() { Q_Q(QKeySequenceEdit); if (releaseTimer) { q->killTimer(releaseTimer); releaseTimer = 0; } prevKey = -1; lineEdit->setText(keySequence.toString(QKeySequence::NativeText)); lineEdit->setPlaceholderText(QKeySequenceEdit::tr("Press shortcut")); } void QKeySequenceEditPrivate::finishEditing() { Q_Q(QKeySequenceEdit); resetState(); emit q->keySequenceChanged(keySequence); emit q->editingFinished(); } /*! \class QKeySequenceEdit \brief The QKeySequenceEdit widget allows to input a QKeySequence. \inmodule QtWidgets \since 5.2 This widget lets the user choose a QKeySequence, which is usually used as a shortcut. The recording is initiated when the widget receives the focus and ends one second after the user releases the last key. \sa QKeySequenceEdit::keySequence */ /*! Constructs a QKeySequenceEdit widget with the given \a parent. */ QKeySequenceEdit::QKeySequenceEdit(QWidget *parent) : QKeySequenceEdit(*new QKeySequenceEditPrivate, parent, 0) { } /*! Constructs a QKeySequenceEdit widget with the given \a keySequence and \a parent. */ QKeySequenceEdit::QKeySequenceEdit(const QKeySequence &keySequence, QWidget *parent) : QKeySequenceEdit(parent) { setKeySequence(keySequence); } /*! \internal */ QKeySequenceEdit::QKeySequenceEdit(QKeySequenceEditPrivate &dd, QWidget *parent, Qt::WindowFlags f) : QWidget(dd, parent, f) { Q_D(QKeySequenceEdit); d->init(); } /*! Destroys the QKeySequenceEdit object. */ QKeySequenceEdit::~QKeySequenceEdit() { } /*! \property QKeySequenceEdit::keySequence \brief This property contains the currently chosen key sequence. The shortcut can be changed by the user or via setter function. */ QKeySequence QKeySequenceEdit::keySequence() const { Q_D(const QKeySequenceEdit); return d->keySequence; } void QKeySequenceEdit::setKeySequence(const QKeySequence &keySequence) { Q_D(QKeySequenceEdit); d->resetState(); if (d->keySequence == keySequence) return; d->keySequence = keySequence; d->key[0] = d->key[1] = d->key[2] = d->key[3] = 0; d->keyNum = keySequence.count(); for (int i = 0; i < d->keyNum; ++i) d->key[i] = keySequence[i]; d->lineEdit->setText(keySequence.toString(QKeySequence::NativeText)); emit keySequenceChanged(keySequence); } /*! \fn void QKeySequenceEdit::editingFinished() This signal is emitted when the user finishes entering the shortcut. \note there is a one second delay before releasing the last key and emitting this signal. */ /*! \brief Clears the current key sequence. */ void QKeySequenceEdit::clear() { setKeySequence(QKeySequence()); } /*! \reimp */ bool QKeySequenceEdit::event(QEvent *e) { switch (e->type()) { case QEvent::Shortcut: return true; case QEvent::ShortcutOverride: e->accept(); return true; default : break; } return QWidget::event(e); } /*! \reimp */ void QKeySequenceEdit::keyPressEvent(QKeyEvent *e) { Q_D(QKeySequenceEdit); int nextKey = e->key(); if (d->prevKey == -1) { clear(); d->prevKey = nextKey; } d->lineEdit->setPlaceholderText(QString()); if (nextKey == Qt::Key_Control || nextKey == Qt::Key_Shift || nextKey == Qt::Key_Meta || nextKey == Qt::Key_Alt || nextKey == Qt::Key_unknown) { return; } QString selectedText = d->lineEdit->selectedText(); if (!selectedText.isEmpty() && selectedText == d->lineEdit->text()) { clear(); if (nextKey == Qt::Key_Backspace) return; } if (d->keyNum >= QKeySequencePrivate::MaxKeyCount) return; if (e->modifiers() & Qt::ShiftModifier) { QList possibleKeys = QKeyMapper::possibleKeys(e); int pkTotal = possibleKeys.count(); if (!pkTotal) return; bool found = false; for (int i = 0; i < possibleKeys.size(); ++i) { if (possibleKeys.at(i) - nextKey == int(e->modifiers()) || (possibleKeys.at(i) == nextKey && e->modifiers() == Qt::ShiftModifier)) { nextKey = possibleKeys.at(i); found = true; break; } } // Use as fallback if (!found) nextKey = possibleKeys.first(); } else { nextKey |= d->translateModifiers(e->modifiers(), e->text()); } d->key[d->keyNum] = nextKey; d->keyNum++; QKeySequence key(d->key[0], d->key[1], d->key[2], d->key[3]); d->keySequence = key; QString text = key.toString(QKeySequence::NativeText); if (d->keyNum < QKeySequencePrivate::MaxKeyCount) { //: This text is an "unfinished" shortcut, expands like "Ctrl+A, ..." text = tr("%1, ...").arg(text); } d->lineEdit->setText(text); e->accept(); } /*! \reimp */ void QKeySequenceEdit::keyReleaseEvent(QKeyEvent *e) { Q_D(QKeySequenceEdit); if (d->prevKey == e->key()) { if (d->keyNum < QKeySequencePrivate::MaxKeyCount) d->releaseTimer = startTimer(1000); else d->finishEditing(); } e->accept(); } /*! \reimp */ void QKeySequenceEdit::timerEvent(QTimerEvent *e) { Q_D(QKeySequenceEdit); if (e->timerId() == d->releaseTimer) { d->finishEditing(); return; } QWidget::timerEvent(e); } #endif // QT_NO_KEYSEQUENCEEDIT QT_END_NAMESPACE #include "moc_qkeysequenceedit.cpp"