Жасмин Бланшет - QT 4: программирование GUI на С++

События уведомляют объекты о себе при помощи своих функций 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_castevent;

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

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

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.)