=> Главная База Знаний Qt Переопределение обработчиков событий


Переопределение обработчиков событий

Переопределение обработчиков событий

В Qt событие (event) — это объект, производный от QEvent. Qt обрабатывает более сотни типов событий, каждое из которых идентифицируется определенным значением перечисления. Например, QEvent::type() возвращает QEvent::MouseButtonPress для событий нажатия кнопки мышки.

Для событий многих типов недостаточно тех данных, которые могут храниться в простом объекте QEvent: например, для событий нажатия кнопки мышки необходимо иметь информацию о том, какая кнопка мышки привела к возникновению данного события, а также о том, где находился курсор мышкй в момент возникновения события. Эта дополнительная информация хранится в определенных подклассах QEvent, например, в QMouseEvent.

События уведомляют объекты о себе при помощи своих функций event(), унаследованных от класса QObject. Реализация event() в QWidget передает большинство обычных событий конкретным обработчикам событий, например mousePressEvent(), keyPressEvent() и paintEvent().

Мы уже ознакомились в предыдущих главах со многими обработчиками событий при реализации MainWindow, IconEditor и Plotter. Существует много других типов событий, приводимых в справочной документации по QEvent, и можно также самому создавать и генерировать события. В данной главе мы рассмотрим два распространенных типа событий, заслуживающих более детального обсуждения, а именно события клавиатуры и события таймера.

События клавиатуры обрабатываются путем переопределения функций keyPressEvent() и keyReleaseEvent(). Виджет Plotter переопределяет keyPressEvent(). Обычно нам требуется переопределить только keyPressEvent(), поскольку отпускание клавиш важно только для клавиш—модификаторов, то есть для клавиш Ctrl, Shift и Alt, а их можно проконтролировать в keyPressEvent() при помощи функции QKeyEvent::modifiers(). Например, если бы нам пришлось реализовывать виджет CodeEditor (редактор программного кода), общий вид его функции keyPressEvent() с различной обработкой клавиш Home и Ctrl+Home был бы следующим:

01 void CodeEditor::keyPressEvent(QKeyEvent *event)

02 {

03 switch (event->key()) {

04 case Qt::Key_Home:

05 if (event->modifiers() & Qt::ControlModifier) {

06 goToBeginningOfDocument();

07 } else {

08 goToBeginningOfLine();

09 }

10 break;

11 case Qt::Key_End:

12 …

13 default:

14 QWidget::keyPressEvent(event);

15 }

16 }

Клавиши Tab и Backtab (Shift+Tab) представляют собой особый случай. Они обрабатываются функцией QWidget::event() до вызова keyPressEvent() c установкой фокуса на следующий или предыдущий виджет в фокусной цепочке. Обычно нам нужен именно такой режим работы, но в виджете CodeEditor мы, возможно, предпочтем использовать клавишу табуляции Tab для обеспечения отступа в начале строки. Переопределение функции event() выглядело бы следующим образом:

01 bool CodeEditor::event(QEvent *event)

02 {

03 if (event->type() == QEvent::KeyFress) {

04 QKeyEvent *keyEvent = static_cast<QKeyEvent *>event;

05 if (keyEvent->key() == Qt::Key_Tab) {

06 insertAtCurrentPosition('\t');

07 return true;

08 }

09 }

10 return QWidget::event(event);

11 }

Если событие сгенерировано нажатием клавиши клавиатуры, мы преобразуем объект типа QEvent в QKeyEvent и проверяем, какая клавиша была нажата. Если это клавиша Tab, мы выполняем некоторую обработку и возвращаем true, чтобы уведомить Qt об обработке нами события. Если бы мы вернули false, Qt передала бы cобытие родительскому виджету.

Высокоуровневый метод обработки клавиш клавиатуры заключается в применении класса QAction. Например, если goToBeginningOfLine() и goToBeginningOfDocument() являются открытыми слотами виджета CodeEditor и CodeEditor применяется в качестве центрального виджета класса MainWindow, мы могли бы обеспечить обработку клавиш при помощи следующего программного кода:

01 MainWindow::MainWindow()

02 {

03 editor = new CodeEditor;

04 setCentralWidget(editor);

05 goToBeginningOfLineAction =

06 new QAction(tr("Go to Beginning of Line"), this);

07 goToBeginningOfLineAction->setShortcut(tr("Home"));

08 connect(goToBeginningOfLineAction, SIGNAL(activated()),

09 editor, SLOT(goToBeginningOfLine()));

10 goToBeginningOfDocumentAction =

11 new QAction(tr("Go to Beginning of Document"), this);

12 goToBeginningOfDocumentAction->setShortcut(tr("Ctrl+Home"));

13 connect(goToBeginningOfDocumentAction, SlGNAL(activated()),

14 editor, SLOT(goToBeginningOfDocument());

15 …

16 }

Это позволяет легко добавлять команды в меню или в панель инструментов, что мы видели в главе 3. Если команды не отображаются в интерфейсе пользователя, объект QAction можно заменить объектом QShortcut; этот класс используется в QAction для связывания клавиши клавиатуры со своим обработчиком.

По умолчанию связывание клавиши в виджете, выполненное с использованием QAction или QShortcut, будет постоянно действовать, пока активно окно, содержащее этот виджет. Это можно изменить с помощью вызова QAction::setShortcutContext() или QShortcut::setContext().

Другим распространенным типом события является событие таймера. Если большинство других событий возникают в результате действий пользователя, то события таймера позволяют приложениям выполнять какую-то обработку через определенные интервалы времени. События таймера могут использоваться для реализации мигающих курсоров и другой анимации или просто для обновления экрана.

Для демонстрации событий таймера мы реализуем виджет Ticker. Этот виджет отображает текстовый баннер, который сдвигается на один пиксель влево через каждые 30 миллисекунд. Если виджет шире текста, последний повторяется необходимое число раз и заполняет виджет по всей его ширине.

Рис. 7.1. Виджет Ticker.

Ниже приводится заголовочный файл:

01 #ifndef TICKER_H

02 #define TICKER_H

03 #include <QWidget>


04 class Ticker : public QWidget

05 {

06 Q_OBJECT

07 Q_PROPERTY(QString text READ text WRITE setText)


08 public:

09 Ticker(QWidget *parent = 0);

10 void setText(const QString &newText);

11 QString text() const { return myText; }

12 QSize sizeHint() const;


13 protected:

14 void paintEvent(QPaintEvent *event);

15 void timerEvent(QTimerEvent *event);

16 void showEvent(QShowEvent *event);

17 void hideEvent(QHideEvent *event);


18 private:

19 QString myText;

20 int offset;

21 int myTimerId;

22 };

23 #endif

Мы переопределяем в Ticker четыре обработчика событий, с тремя из которых мы до сих пор не встречались: timerEvent(), showEvent() и hideEvent().

Теперь давайте рассмотрим реализацию:

01 #include <QtGui>

02 #include "ticker.h"

03 Ticker::Ticker(QWidget *parent)

04 : QWidget(parent)

05 {

06 offset = 0;

07 myTimerId = 0;

08 }

Конструктор инициализирует смещение offset значением 0. Координата x начала вывода текста рассчитывается на основе значения offset. Таймер всегда имеет ненулевой идентификатор, поэтому мы используем 0, показывая, что таймер еще не запущен.

09 void Ticker::setText(const QString &newText)

10 {

11 myText = newText;

12 update();

13 updateGeometry();

14 }

Функция setText() ycтaнaвливaeт oтoбpaжaeмый тeкcт. Oнa вызывaeт update() для выдачи запроса на перерисовку и updateGeometry() для уведомления всех менеджеров компоновки, содержащих виджет Ticker, об изменении идеального размера.

15 QSizeTicker::sizeHint() const

16 {

17 return fontMetrics().size(0, text());

18 }

Функция sizeHint() возвращает в качестве идеального размера виджета размеры области, занимаемой текстом. Функция QWidget::fontMetrics() возвращает объект QFontMetrics, который можно использовать для получения информации относительно шрифта виджета. В данном случае мы определяем размер заданного текста. (В первом аргументе функции QFontMetrics::size() задается флажок, который не нужен для простых строк, поэтому мы просто передаем 0.)

19 void Ticker::paintEvent(QPaintEvent * /* event */)

20 {

21 QPainter painter(this);

22 int textWidth = fontMetrics().width(text());

23 if (textWidth < 1)

24 return;

25 int х= -offset;

26 while (x < width()) {

27 painter.drawText(x, 0, textWidth, height(),

28 Qt::AlignLeft | Qt::AlignVCenter, text());

29 x += textWidth;

30 }

31 }

Функция paintEvent() отображает текст при помощи функции QPainter::drawText(). Она использует функцию fontMetrics() для определения размера области, занимаемой текстом по горизонтали, и затем выводит текст столько раз, сколько необходимо для заполнения виджета по всей его ширине, учитывая значение смещения offset.

32 void Ticker::showEvent(QShowEvent * /* event */)

33 {

34 myTimerId = startTimer(30);

35 }

функция showEvent() запускает таймер. Вызов QObject::startTimer() возвращает число—идентификатор, которое мы можем использовать позже для идентификации таймера. QObject поддерживает несколько независимых таймеров, каждый из которых использует свой временной интервал. После вызова функции startTimer() Qt генерирует событие таймера приблизительно через каждые 30 миллисекунд, причем точность зависит от базовой операционной системы.

Мы могли бы функцию startTimer() вызвать в конструкторе Ticker, но мы экономим некоторые ресурсы за счет генерации Qt событий таймера только в тех случаях, когда виджет действительно видим.

36 void Ticker::timerEvent(QTimerEvent *event)

37 {

38 if (event->timerId() == myTimerId) {

39 ++offset;

40 if (offset >= fontMetrics().width(text()))

41 offset= 0;

42 scroll(-1, 0);

43 } else {

44 QWidget::timerEvent(event);

45 }

46 }

Функция timerEvent() вызывается системой в соответствующие моменты времени. Она увеличивает смещение offset на 1 для имитации движения по всей области вывода текста. Затем она перемещает содержимое виджета на один пиксель влево при помощи фyнкции QWidget::scroll(). Вполне достаточно было бы вызывать функцию update() вместо scroll(), но вызов функции scroll() более эффективен, потому что она просто перемещает существующие на экране пиксели и генерирует событие рисования для открывшейся области виджета (которая в данном случае представляет собой полосу шириной в один пиксель).

Если событие таймера не относится к нашему таймеру, мы передаем его дальше в наш базовый класс.

47 void Ticker::hideEvent(QHideEvent * /* event */)

48 {

49 killTimer(myTimerId);

50 }

Функция hideEvent() вызывает QObject::killTimer() для остановки таймера.

События таймера являются низкоуровневыми событиями, и если нам необходимо иметь несколько таймеров, это может усложнить отслеживание всех идентификаторов таймеров. В таких ситуациях обычно легче создавать для каждого таймера объект QTimer. QTimer генерирует через заданный временной интервал сигнал timeout(). QTimer также обеспечивает удобный интерфейс для однократных таймеров (то есть таймеров, которые срабатывают только один раз).