13 QString IconEditorPlugin::group() const
14 {
15 return tr("Image Manipulation Widgets");
16 }
Функция group() возвращает имя группы на панели виджетов, к которой принадлежит пользовательский виджет. Если это имя еще не используется, Qt Designer coздаст новую группу для виджета.
17 QIcon IconEditorPlugin::icon() const
18 {
19 return QIcon(":/images/iconeditor.png");
20 }
Функция icon() возвращает пиктограмму которая будет использоваться для представления пользовательского виджета на панели виджетов Qt Designer. В нашем случае мы предполагаем, что IconEditorPlugin имеет ресурсный файл Qt, содержащий соответствующий элемент для изображения редактора пиктограмм.
21 QString IconEditorPlugin::toolTip() const
22 {
23 return tr("An icon editor widget");
24 }
Функция toolTip() возвращает всплывающую подсказку, которая появляется, когда мышка находится на пользовательском виджете в панели виджетов Qt Designer.
25 QString IconEditorPlugin::whatsThis() const
26 {
27 return tr("This widget is presented in Chapter 5 of <i>C++ GUI "
28 "Programming with Qt 4</i> as an example of a custom Qt "
29 "widget.");
30 }
Функция whatsThis() возвращает текст «What's This?» (что это?) для отображения в Qt Designer.
31 bool IconEditorPlugin::isContainer() const
32 {
33 return false;
34 }
Функция isContainer() возвращает true, если данный виджет может содержать другие виджеты; в противном случае он возвращает false. Например, QFrame представляет собой виджет, который может содержать другие виджеты. В целом любой виджет может содержать другие виджеты, но Qt Designer не позволяет это делать, если isContainer() возвращает false.
35 QWidget *IconEditorPlugin::createWidget(QWidget *parent)
36 {
37 return new IconEditor(parent);
38 }
Функция createWidget() вызывается Qt Designer для создания экземпляра класса виджета для указанного родительского виджета.
39 Q_EXPORT_PLUGIN2(iconeditorplugin, IconEditorPlugin)
В конце исходного файла реализации класса подключаемого модуля мы должны использовать макрос Q_EXPORT_PLUGIN2(), чтобы сделать его доступным для Qt Designer. Первый аргумент — назначаемое нами имя подключаемого модуля, второй аргумент — имя класса, который его реализует.
Используемый для построения подключаемого модуля файл .pго выглядит следующим образом:
TEMPLATE = lib
CONFIG += designer plugin release
HEADERS = ../iconeditor/iconeditor.h
iconeditorplugin.h
SOURCES = ../iconeditor/iconeditor.cpp
iconeditorplugin.cpp
RESOURCES = iconeditorplugin.qrc
DESTDIR = $(QTDIR)/plugins/designer
Файл .pro предполагает, что переменная окружения QTDIR установлена на каталог, где располагается Qt. Когда вы вводите команду make или nmake для построения подключаемого модуля, он автоматически устанавливается в каталог plugins Qt Designer. Поле построения подключаемого модуля виджет IconEditor мoжeт использоваться в Qt Designer таким же образом как, любые встроенные виджеты Qt.
Если требуется интегрировать в Qt Designer несколько пользовательских виджетов, вы можете либо создать отдельный подключаемый модуль для каждого из них, либо объединить все в один подключаемый модуль, реализуя интерфейс QDesignerCustomWidgetCollectionInterface.
Двойная буферизация
Двойная буферизация является методом программирования графического пользовательского интерфейса, при котором изображение виджета формируется вне экрана в виде пиксельной карты, и затем эта пиксельная карта выводится на экран. В ранних версиях Qt этот метод часто использовался для предотвращения мерцания изображения и для построения более быстрого пользовательского интерфейса.
В Qt 4 класс QWidget это делает автоматически, поэтому нам редко приходится беспокоиться о мерцании виджетов. Все же явная двойная буферизация оказывается полезной, если виджет воспроизводится сложным образом и это приходится делать постоянно. Мы можем постоянно хранить с виджетом пиксельную карту, которая всегда будет готова отреагировать на следующее событие рисования, и копировать пиксельную карту в виджет при получении нами любого события рисования. Она особенно полезна в тех случаях, когда мы хотим выполнить небольшие модификации, например начертить резиновую ленту без необходимости постоянной перерисовки виджета.
Мы закончим данную главу рассмотрением пользовательского виджета Plotter (построитель графиков). Этот виджет использует двойную буферизацию и также демонстрирует некоторые другие аспекты Qt—программирования, в том числе обработку событий клавиатуры, ручную компоновку виджетов и координатные системы.
Виджет Plotter выводит на экран одну или несколько кривых, задаваемых вектором ее координат. Пользователь может начертить на изображении резиновую ленту, и Plotter отобразит крупным планом заключенную в ней область. Пользователь вычерчивает резиновую ленту, делая сначала щелчок в некоторой точке изображения, перетаскивая затем мышку с нажатой левой кнопкой в другую позицию и освобождая клавишу мышки.
Рис. 5.7. Увеличение изображения виджета Plotter.
Пользователь может увеличивать изображение, несколько раз используя резиновую ленту, уменьшить изображение при помощи кнопки Zoom Out (уменьшить изображение) и затем вновь его увеличить с помощью кнопки Zoom In (увеличить изображение). Кнопки Zoom In и Zoom Out появляются при первом изменении масштаба изображения, и поэтому они не будут заслонять экран, если пользователь не изменяет масштаб представления диаграммы.
Виджет Plotter может содержать данные любого количества кривых. Он также содержит стек параметров графика PlotSettings, каждое значение которого соответствует конкретному масштабу изображения.
Давайте рассмотрим этот класс, начиная с заголовочного файла plotter.h:
01 #ifndef PLOTTER_H
02 #define PLOTTER_H
03 #include <QMap>
04 #include <QPixmap>
05 #include <QVector>
06 #include <QWidget>
07 class QToolButton;
08 class PlotSettings;
09 class Plotter : public QWidget
10 {
11 Q_OBJECT
12 public:
13 Plotter(QWidget *parent = 0);
14 void setPlotSettings(const PlotSettings &settings);
15 void setCurveData(int id, const QVector<QPointF> &data);
16 void clearCurve(int id);
17 QSize minimumSizeHint() const;
18 QSize sizeHint() const;
19 public slots:
20 void zoomIn();
21 void zoomOut();
Сначала мы включаем заголовочные файлы для Qt—классов, используемых в заголовочном файле построителя графиков, и предварительно объявляем классы, на которые имеются указатели или ссылки в заголовочном файле.
В классе Plotter мы предоставляем три открытые функции для настройки графика и два открытых слота для увеличения и уменьшения масштаба изображения. Мы также переопределяем функции minimumSizeHint() и sizeHint() класса QWidget. Мы храним точки кривой в векторе QVector<QPointF>, где QPointF — версия QPoint для значений с плавающей точкой.
22 protected:
23 void paintEvent(QPaintEvent *event);
24 void resizeEvent(QResizeEvent *event);
25 void mousePressEvent(QMouseEvent *event);
26 void mouseMoveEvent(QMouseEvent *event);
27 void mouseReleaseEvent(QMouseEvent *event);
28 void keyPressEvent(QKeyEvent *event);
29 void wheelEvent(QWheelEvent *event);
В защищенной секции класса мы объявляем все обработчики событий QWidget, которые хотим переопределить.
30 private:
31 void updateRubberBandRegion();
32 void refreshPixmap();
33 void drawGrid(QPainter *painter);
34 void drawCurves(QPainter *painter);
35 enum { Margin = 50 };
36 QToolButton *zoomInButton;
37 QToolButton *zoomOutButton;
38 QMap<int, QVector<QPointF> > curveMap;
39 QVector<PlotSettings> zoomStack;
40 int curZoom;
41 bool rubberBandIsShown;
42 QRect rubberBandRect;
43 QPixmap pixmap;
44 };
В закрытой секции класса мы объявляем несколько функций для рисования виджета, константу и несколько переменных—членов. Константа Margin применяется для обеспечения некоторого свободного пространства вокруг диаграммы.
Среди переменных—членов находится pixmap, которая имеет тип QPixmap. Эта переменная содержит копию всего виджета, идентичную его изображению на экране. График всегда сначала строится вне экрана на пиксельной карте, и затем пиксельная карта помещается на виджет.
