=> Главная База Знаний Qt Реализация пользовательских делегатов


Реализация пользовательских делегатов

Воспроизведение и редактирование в представлениях отдельных элементов выполняются с помощью делегатов. В большинстве случаев возможности делегата, предоставляемого представлением по умолчанию, оказываются достаточными. Если нам требуется более тонкое управление воспроизведением элементов, мы сможем этого добиться, просто используя пользовательскую модель: при переопределении функции data() можем предусмотреть обработку ролей Qt::FontRole, Qt::TextAlignmentRole, Qt::TextColorRole и Qt::BackgroundColorRole, а также тех, которые используются делегатом по умолчанию. Например, в приведенных выше приложениях Города и Курсы валют мы применяли Qt::TextAlignmentRole для выравнивания чисел вправо.

Если нам требуется еще больший контроль, можем создать наш собственный класс делегата и связать его с нужными нам представлениями. В показанном ниже диалоговом окне Редактор фонограмм (Track Editor) используется пользовательский делегат. В этом окне отображаются названия музыкальных фонограмм и их длительность. Данные в модели будут представлены просто строками QString (названия) и значениями типа int (секунды), однако длительность будет разбита на минуты и секунды, а ее редактирование будет выполняться, используя QTimeEdit.

Рис. 10.15. Приложение Редактор фонограмм.

Диалоговое окно Редактор фонограмм использует QTableWidget — удобный подкласс отображения элементов, который работает с объектами QTableWidgetltem. Данные представлены в виде списка фонограмм Track:

01 class Track

02 {

03 public:

04 Track(const QString &title = "", int duration = 0);

05 QString title;

06 int duration;

07 };

Ниже приводится фрагмент конструктора, показывающий, как создается и пополняется табличный виджет:

01 TrackEditor::TrackEditor(QList<Track> *tracks, QWidget *parent)

02 : QDialog(parent)

03 {

04 this->tracks = tracks;

05 tableWidget = new QTableWidget(tracks->count(), 2);

06 tableWidget->setItemDelegate(new TrackDelegate(1));

07 tableWidget->setHorizontalHeaderLabels(

08 QStringList() << tr("Track") << tr("Duration"));

09 for (int row = 0; row < tracks->count(); ++row) {

10 Track track = tracks->at(row);

11 QTableWidgetltem *item0 = new QTableWidgetItem(track.titie);

12 tableWidget->setItem(row, 0, item0);

13 QTableWidgetltem *item1 = new QTableWidgetItem(

14 QString::number(track.duration));

15 item1->setTextAlignment(Qt::AlignRight);

16 tableWidget->setItem(row, 1, item1);

17 }

18 …

19 }

Конструктор создает табличный виджет и, вместо того чтобы просто использовать делегата по умолчанию, связывает виджет с нашим пользовательским делегатом TrackDelegate, передавая ему номер столбца, содержащего временные данные. Мы начинаем с установки заголовков столбцов и затем проходим в цикле по всем данным, устанавливая для каждой строки название фонограммы и ее длительность.

В остальной части конструктора и диалогового окна TrackEditor нет ничего необычного, поэтому теперь рассмотрим класс trackDelegate, который обеспечивает воспроизведение и редактирование данных фонограммы.

01 class TrackDelegate : public QItemDelegate

02 {

03 Q_OBJECT

04 public:

05 TrackDelegate(int durationColumn, QObject *parent = 0);

06 void paint(QPainter *painter, const

07 QStyleOptionViewItem &option,

08 const QModelIndex &index) const;

09 QWidget *createEditor(QWidget *parent,

10 const QStyleOptionViewItem &option,

11 const QModelIndex &index) const;

12 void setEditorData(QWidget *editor,

13 const QModelIndex &index) const;

14 void setModelData(QWidget *editor,

15 QAbstractItemModel *model,

16 const QModelIndex &index) const;

17 private slots:

18 void commitAndCloseEditor();

19 private:

20 int durationColumn;

21 };

Мы используем QItemDelegate в качестве нашего базового класса, чтобы можно было воспользоваться возможностями делегата по умолчанию. Так же мы могли бы использовать QAbstractItemDelegate, если бы хотели начать с чистого листа. Для обеспечения в делегате возможности редактирования данных мы должны реализовать функции createEditor(), setEditorData() и setModelData(). Кроме того, реализуем функцию paint() для изменения отображения столбца длительностей.

01 TrackDelegate::TrackDelegate(int durationColumn, QObject *parent)

02 : QItemDelegate(parent)

03 {

04 this->durationColumn = durationColumn;

05 }

Параметр конструктора durationColumn указывает делегату, какой номер столбца содержит длительность фонограммы.

01 void TrackDelegate::paint(QPainter *painter,

02 const QStyleOptionViewItem &option,

03 const QModelIndex &index) const

04 {

05 if (index.column() == durationColumn) {

06 int secs = index.model()->data(index, Qt::DisplayRole).toInt();

07 QString text= QString("%1:%2")

08 .arg(secs/60, 2, 10, QChar('0'))

09 .arg(secs % 60, 2, 10, QChar('0'));

10 QStyleOptionViewItem myOption = option;

11 myOption.displayAlignment = Qt::AlignRight | Qt::AlignVCenter;

12 drawDisplay(painter, myOption, myOption.rect, text);

13 drawFocus(painter, myOption, myOption.rect);

14 } else {

15 QItemDelegate::paint(painter, option, index);

16 }

17 }

Поскольку мы собираемся отображать длительность в виде «минуты : секунды», мы переопределили функцию paint(). Вызов arg() принимает целое число, выводимое в виде строки, допустимое количество символов в строке, основание целого числа (10 для десятичного числа) и символ—заполнитель.

Для выравнивания текста вправо копируем текущие опции стиля и заменяем установленное по умолчанию выравнивание. После этого вызываем QItemDelegate::drawDisplay() для вывода текста, затем вызываем QItemDelegate::drawFocus() для прорисовки фокусного прямоугольника в том случае, если данный элемент получил фокус, и ничего не делая в противном случае. Функцией drawDisplay() очень удобно пользоваться, особенно совместно с нашими собственными опциями стиля. Мы могли бы также рисовать, используя рисовальщик непосредственно.

01 QWidget *TrackDelegate::createEditor(QWidget *parent,

02 const QStyleOptionViewItem &option,

03 const QModelIndex &index) const

04 {

05 if (index.column() == durationColumn) {

06 QTimeEdit *timeEdit = new QTimeEdit(parent);

07 timeEdit->setDisplayFormat("mm:ss");

08 connect(timeEdit, SIGNAL(editingFinished()),

09 this, SLOT(commitAndCloseEditor()));

10 return timeEdit;

11 } else {

12 return QItemDelegate::createEditor(parent, option, index);

13 }

14 }

Мы собираемся управлять редактированием только длительностей фонограмм, предоставляя делегату по умолчанию управление редактированием названий фонограмм. Это обеспечивается проверкой столбца, для которого запрашивается редактирование. Если это столбец длительности, создаем объект QTimeEdit, устанавливаем соответствующий формат отображения и соединяем его сигнал editingFinished() с нашим слотом commitAndCloseEditor(). Для других столбцов передаем управление редактированием делегату по умолчанию.

01 void TrackDelegate::commitAndCloseEditor()

02 {

03 QTimeEdit *editor = qobject_cast<QTimeEdit *>(sender());

04 emit commitData(editor);

05 emit closeEditor(editor);

06 }

Если пользователь нажимает клавишу Enter или убирает фокус из QTimeEdit (но не путем нажатия клавиши Esc), генерируется сигнал editingFinished() и вызывается слот commitAndCloseEditor(). Этот слот генерирует сигнал commitData() для уведомления представления о том, что имеются новые данные для замены существующих. Он также генерирует сигнал closeEditor() для уведомления представления о том, что редактор больше не нужен, и модель его удалит. Получить доступ к редактоpy можно с помощью функции QObject::sender(), которая возвращает объект, выдавший сигнал, запустивший данный слот. Если пользователь отказывается от работы с редактором (нажимая клавишу Esc), представление просто удалит этот редактор.

01 void TrackDeIegate::setEditorData(QWidget *editor,

02 const QModelindex &index) const

03 {

04 if (index.column() == durationColumn) {

05 int secs = index.model()->data(index, Qt::DisplayRole).toInt();

06 QTimeEdit *timeEdit = qobject_cast<QTimeEdit *>(editor);

07 timeEdit->setTime(QTime(0, secs / 60, secs % 60));

08 } else {

09 QItemDelegate::setEditorData(editor, index);

10 }

11 }

Когда пользователь инициирует редактирование, представление вызывает createEditor() для создания редактора и затем setEditorData() для инициализации редактора текущими данными элемента. Если редактор вызывается для столбца длительности, получаем из данных элемента длительность фонограммы в секундах и устанавливаем значение QTimeEdit на соответствующее количество минут и секунд; в противном случае мы позволяем делегату по умолчанию выполнить инициализацию.

01 void TrackDelegate::setModelData(QWidget *editor,

02 QAbstractItemModel *model, const QModelIndex &index) const

03 {

04 if (index.column() == durationColumn) {

05 QTimeEdit *timeEdit = qobject_cast<QTimeEdit *>(editor);

06 QTime time = timeEdit->time();

07 int secs = (time.minute() * 60) + time.second();

08 model->setData(index, secs);

09 } else {

10 QItemDelegate::setModelData(editor, model, index);

11 }

12 }

Если пользователь прекращает редактирование (например, щелкнув левой кнопкой мышки за пределами виджета редактора или нажав клавишу Enter или Tab), а не отменяет его, модель должна быть обновлена данными редактора. Если редактировалась длительность, извлекаем минуты и секунды из QTimeEdit и устанавливаем поле данных на соответствующее значение секунд.

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

В данной главе мы представили достаточно подробный обзор архитектуры Qt модель/представление. Мы показали, как можно использовать удобные подклассы отображения элементов, как применять заранее определенные в Qt модели и как создавать пользовательские модели и пользовательские делегаты. Однако архитектура модель/представление настолько богата, что мы не смогли раскрыть все ее возможности из-за ограниченности объема книги. Например, мы могли бы создать пользовательское представление, которое отображает свои элементы не в виде списка, таблицы или дерева. Это делается в примере Диаграмма (Chart), который находится в каталоге Qt examples/itemviews/chart; этот пример содержит пользовательское представление, которое воспроизводит модель данных в виде круговой диаграммы.

Кррме того, для одной модели можно использовать несколько представлений, и это не потребует особых усилий. Любое редактирование одного представления автоматически и немедленно отразится на других представлениях. Такие возможности особенно полезны при просмотре больших наборов данных, когда пользователь может захотеть увидеть блоки данных, расположенные далеко друг от друга. Эта архитектура поддерживает также выделения областей: когда два или более представления используются одной моделью, каждому представлению может быть предоставлена возможность иметь свою собственную независимую выделенную область или такие области могут совместно использоваться разными представлениями.

В онлайновой документации Qt всесторонне рассматриваются вопросы программирования классов по отображению элементов. См. http://doc.trolltech.com/4.1/model-view.html, где приводится список всех таких классов, и http://doc.trolltech.com/4.1/model-view-programming.html, где даются дополнительная информация и ссылки на соответствующие примеры, включенные в Qt.