На этом шаге мы рассмотрим методы, используемые для обработки этих событий.
При нажатии и отпускании клавиши вызываются следующие методы:
- keyPressEvent (self, <event>) - вызывается при нажатии клавиши на клавиатуре. Если клавишу удерживать нажатой, то метод станет многократно вызываться, пока клавиша не будет отпущена;
- keyReleaseEvent (self, <event>) - вызывается при отпускании нажатой ранее клавиши.
Через параметр <event> доступен экземпляр класса QKeyEvent, хранящий дополнительную информацию о событии. Он поддерживает следующие полезные для нас методы (полный их список приведен в документации по классу QKeyEvent на странице https://doc.qt.io/qt-5/qkeyevent.html):
- key () - возвращает код нажатой клавиши. Пример определения клавиши:
if e.key() == QtCore.Qt.Кеу_В: print ("Нажата клавиша <В>")
- text () - возвращает текстовое представление введенного символа в кодировке Unicode или пустую строку, если была нажата специальная клавиша;
- modifiers () - позволяет определить, какие клавиши-модификаторы (Shift, Ctrl, Alt и др.) были нажаты вместе с клавишей. Может содержать значения следующих атрибутов из
класса QtCore.Qt или их комбинацию:
- NoModifier - модификаторы не были нажаты;
- ShiftModifier - была нажата клавиша Shift;
- ControlModifier - была нажата клавиша Ctrl;
- AltModifier - была нажата клавиша Alt;
- MetaModifier - была нажата клавиша Meta;
- KeypadModifier - была нажата любая клавиша на дополнительной клавиатуре;
- GroupSwitchModifier - была нажата клавиша Mode_switch (только в X11).
Пример определения, была ли нажата клавиша-модификатор Shift:
if e.modifiers() & QtCore.Qt.ShiftModifier: print("Нажата клавиша-модификатор <Shift>")
- isAutoRepeat () - возвращает True, если событие было вызвано удержанием клавиши нажатой, и False - в противном случае;
- matches (<QKeySequence.StandardKey>) - возвращает значение True, если была нажата специальная комбинация клавиш, соответствующая указанному значению, и False -
в противном случае. В качестве значения указываются атрибуты из класса QKeySequence - например, QKeySequence.Copy для комбинации клавиш Ctrl+C (Koпировать).
Полный список атрибутов содержится в документации по классу QKeySequence
(см. https://doc.qt.io/qt-5/qkeysequence.html#StandardKey-enum). Пример:
if e.matches (QtGui.QKeySequence.Copy): print("Нажата комбинация <Ctrl>+<C>")
При обработке нажатия клавиш следует учитывать, что:
- компонент должен иметь возможность принимать фокус ввода. Некоторые компоненты по умолчанию не могут принимать фокус ввода - например, надпись. Чтобы изменить способ получения фокуса, следует воспользоваться методом setFocusPolicy(<Способ>), который мы рассматривали на 61 шаге;
- чтобы захватить эксклюзивный ввод с клавиатуры, следует воспользоваться методом grabKeyboard(), а чтобы освободить ввод - методом releaseKeyboard();
- можно перехватить нажатие любых клавиш, кроме клавиши Tab и комбинации Shift+Tab. Эти клавиши используются для передачи фокуса следующему и предыдущему компоненту соответственно. Перехватить нажатие этих клавиш можно только в методе event(self, <event>);
- если событие обработано, следует вызвать метод accept() объекта события. Чтобы родительский компонент смог получить событие, вместо метода accept() необходимо вызвать метод ignore().
Со следующего шага мы начнем рассматривать события мыши.
