На этом шаге рассмотрим класс QKeyEvent.
Класс QKeyEvent содержит данные о событиях клавиатуры. С его помощью можно получить информацию о клавише, вызвавшей событие, а также ASCII-код отображенного символа (American Standard Code for Information Interchange — американский стандартный код для обмена информацией).
Объект события передается в методы QWidget::keyPressEvent() и QWidget::keyReleaseEvent(), определенные в классе QWidget. Событие может вызываться нажатием любой клавиши на клавиатуре, включая <Shift>, <Ctrl>, <Alt>, <Esc> и <F1> — <F12>. Исключение составляют клавиша табулятора <Tab> и ее совместное нажатие с клавишей <Shift>, которые используются методом обработки QWidget::event() для передачи фокуса следующему виджету.
Метод keyPressEvent() вызывается каждый раз при нажатии одной из клавиш на клавиатуре, а метод keyReleaseEvent() — при отпускании.
В методе обработки события с помощью метода QKeyEvent::key() можно определить, какая из клавиш инициировала его. Этот метод возвращает значение целого типа, которое можно сравнить с константами клавиш, определенными в классе Qt (см. табл. 1).
Разберем некоторые из кодов клавиш, приведенных в табл. 1:
- коды от 20 до 3F полностью совпадают со значениями ASCII-кодов;
- от 30 до 39 соответствуют цифровым клавишам, расположенным на клавиатуре в виде горизонтального ряда прямо над клавишами букв;
- от 41 до 5A являются идентификаторами букв. Обратите внимание на то, что они совпадают со значениями ASCII-кодов заглавных букв;
- от 1000030 до 1000052 являются функциональными. В общей сложности их 35, но в табл. 1 указано только 12, что соответствует обычной клавиатуре;
- от 1000006 до 100009, а также 1000025 и 1000026 являются кодами клавиш цифровой клавиатуры;
- от 1000010 до 1000017 являются кодами клавиш управления курсором;
- от 1000020 до 1000023 соответствуют клавишам модификаторов;
- 1000000, 1000001, 1000004 и 1000005 можно объединить в отдельную группу, т. к. они также генерируют коды символов.
Если необходимо узнать, были ли в момент наступления события совместно с клавишей нажаты клавиши модификаторов, например <Shift>, <Ctrl> или <Alt>, то это можно проверить с помощью метода modifiers().
С помощью метода text() можно узнать Unicode-текст, полученный вследствие нажатия клавиши. Этот метод может оказаться полезным в том случае, если в виджете потребуется обеспечить ввод с клавиатуры. Для клавиш модификаторов этот метод вернет пустую строку. В этом случае нужно воспользоваться методом key(), который будет содержать код клавиши (см. табл. 1).
Метод для обработки событий клавиатуры класса, унаследованного от класса QWidget, может выглядеть следующим образом:
void MyWidget::keyPressEvent(QKeyEvent* pe)
{
switch (pe->key()) {
case Qt::Key_Z:
if (pe->modifiers() & Qt::ShiftModifier) {
// Выполнить какие-либо действия
}
else {
// Выполнить какие-либо действия
}
break;
default:
QWidget::keyPressEvent(pe); // Передать событие дальше
}
}В данном примере проверяется, не нажаты ли совместно клавиши <Z> и <Shift>. Для проверки статуса значения, возвращаемого методом modifiers(), используются значения, указанные в табл. 1 шага 111.
На следующем шаге рассмотрим класс QFocusEvent.
