Тип QML KeyEvent

Предоставляет информацию о событии нажатия клавиши. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• accepted : bool
• count : int
• isAutoRepeat : bool
• key : int
• modifiers : int
• nativeScanCode : quint32
• text : string

Методы

• bool matches(key)

Подробное описание

Например, следующие изменения свойства состояния Item при нажатии клавиши Enter:

Item {
    focus: true
    Keys.onPressed: { if (event.key == Qt.Key_Enter) state = 'ShowDetails'; }
}

Документация по свойствам

accepted : bool

Установка accepted в true предотвращает распространение события нажатия клавиши на родительский элемент.

Как правило, если элемент реагирует на событие нажатия клавиши, то оно должно быть принято, чтобы родительские элементы также не реагировали на то же событие.

count : int

Это свойство содержит количество клавиш, участвующих в данном событии. Если KeyEvent::text не пусто, это просто длина строки.

isAutoRepeat : bool

Это свойство содержит информацию о том, происходит ли данное событие от клавиши с автоповтором.

key : int

Это свойство содержит код нажатой или отпущенной клавиши.

См. Qt.Key для списка кодов клавиш. Эти коды независимы от базовой системы окон. Обратите внимание, что эта функция не различает заглавные и строчные буквы; используйте свойство text для этой цели.

Значение 0 или Qt.Key_Unknown означает, что событие не является результатом нажатия известной клавиши; например, это может быть результат последовательности ввода, макроса клавиатуры или сжатия событий нажатия клавиш.

modifiers : int

Это свойство содержит флаги модификаторов клавиатуры, которые существовали непосредственно перед возникновением события.

Он содержит побитовое сочетание:

• Qt.NoModifier - Ни одна клавиша-модификатор не нажата.
• Qt.ShiftModifier - Нажата клавиша Shift.
• Qt.ControlModifier - Нажата клавиша Ctrl.
• Qt.AltModifier - Нажата клавиша Alt.
• Qt.MetaModifier - Нажата клавиша Meta.
• Qt.KeypadModifier - Нажата клавиша на цифровой клавиатуре.
• Qt.GroupSwitchModifier - Только X11. Нажата клавиша переключения режимов.

Например, для реакции на сочетание клавиш Shift + Enter:

Item {
    focus: true
    Keys.onPressed: {
        if ((event.key == Qt.Key_Enter) && (event.modifiers & Qt.ShiftModifier))
            doSomething();
    }
}

nativeScanCode : quint32

Это свойство содержит родной код сканирования клавиши, которая была нажата. Он передается из QKeyEvent без изменений.

См. также QKeyEvent::nativeScanCode().

text : string

Это свойство содержит текстовое значение Юникода, сгенерированное нажатием клавиши. Возвращаемый текст может быть пустой строкой в случаях, когда нажаты или отпущены клавиши-модификаторы, такие как Shift, Control, Alt и Meta. В таких случаях key будет содержать допустимое значение.

Документация по методам

bool matches(key)

Возвращает true , если событие нажатия клавиши соответствует заданной стандартной клавише; в противном случае возвращает false.

Item {
    focus: true
    Keys.onPressed: {
        if (event.matches(StandardKey.Undo))
            myModel.undo();
        else if (event.matches(StandardKey.Redo))
            myModel.redo();
    }
}

Этот метод был введен в Qt 5.2.

См. также QKeySequence::StandardKey.