【转载】10.4实现自定义代表（Implementing Custom Delegates）

最新推荐文章于 2023-07-31 10:06:06 发布

原创最新推荐文章于 2023-07-31 10:06:06 发布 · 427 阅读

0 ·

CC 4.0 BY-SA版权

本文介绍如何使用自定义代表来增强视图中的数据编辑和显示功能。通过创建TrackDelegate类，实现了对音乐带持续时间的特定格式化和编辑。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

使用代表来显示并编辑视图中的各个项。大多数情况下，视图所提供的代表就足够了。如果我们想更好控制显示项，我们通常只用一个自定义模型就可以实现：在我们的data()重新实现中我们处理Qt::FontRole, Qt::TextAlignmentRole, Qt::TextColorRole, 及 Qt::BackgroundColorRole,这些都被默认的代表使用。如，在前面的Cities 和 Currencies例子中，我们处理Qt::TextAlignmentRole来获得右对齐的数字。

如果我们想进一步控制，我们要创建自己的代表类，并把它设置在想使用它的视图上。Track Editor对话框就使用了自定义代表。它显示了音乐带的标题及持续时间。模型中保存的数据只是QStrings (标题) and ints (秒),但持续时间被分成分和秒并用QTimeEdit来编辑。

Figure 10.15. The Track Editor dialog

Track Editor对话框使用了一个QTableWidget，它是简单的项目视图子类，可以操作QTableWidgetItem。

class Track

{

public:

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

QString title;

int duration;

};

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

: QDialog(parent)

{

this->tracks = tracks;

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

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

tableWidget->setHorizontalHeaderLabels(

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

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

Track track = tracks->at(row);

QTableWidgetItem *item0 = new QTableWidgetItem(track.title);

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

QTableWidgetItem *item1

= new QTableWidgetItem(QString::number(track.duration));

item1->setTextAlignment(Qt::AlignRight);

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

}

...

}

构造函数创建了一个表控件，并没有只用默认代表，我们设置了自定义的TRackDelegate，把它传给保存时间数据的列。我们开始设置列头，然后遍历数据，生成每个track的行：名字和持续时间。

class TrackDelegate : public QItemDelegate

{

Q_OBJECT

public:

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

void paint(QPainter *painter, const QStyleOptionViewItem &option,

const QModelIndex &index) const;

QWidget *createEditor(QWidget *parent,

const QStyleOptionViewItem &option,

const QModelIndex &index) const;

void setEditorData(QWidget *editor, const QModelIndex &index) const;

void setModelData(QWidget *editor, QAbstractItemModel *model,

const QModelIndex &index) const;

private slots:

void commitAndCloseEditor();

private:

int durationColumn;

};

用QItemDelegate作为基类，这样可以用默认代表的实现。如果想从头开始设计我们就可以使用QAbstractItemDelegate作基类。为了提供一个可以编辑数据的代表，我们必须实现createEditor(), setEditorData(), 及 setModelData().也要实现paint()来改变duration列的显示。

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

: QItemDelegate(parent)

{

this->durationColumn = durationColumn;

}

durationColumn参数是告诉代表哪列会保存磁带的持续时间。

void TrackDelegate::paint(QPainter *painter,

const QStyleOptionViewItem &option,

const QModelIndex &index) const

{

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

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

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

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

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

QStyleOptionViewItem myOption = option;

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

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

drawFocus(painter, myOption, myOption.rect);

} else{

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

}

由于想以"minutes :seconds"格式显示持续时间，我们在paint()函数中重新实现。arg()调用接收的参数是：一个整数来作为显示的串，然后是串的字符数，底数及填充符。

为了文本右对齐，我们拷贝当前样式选项覆盖了默认对齐方式。然后调用QItemDelegate::drawDisplay()来绘制文本，接着调用QItemDelegate::drawFocus()，其功能是当一个项有焦点时绘制焦点矩形。我们也可以直接使用painter来绘制。

QWidget *TrackDelegate::createEditor(QWidget *parent,

const QStyleOptionViewItem &option,

const QModelIndex &index) const

{

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

QTimeEdit *timeEdit = new QTimeEdit(parent);

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

connect(timeEdit, SIGNAL(editingFinished()),

this, SLOT(commitAndCloseEditor()));

return timeEdit;

} else {

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

}

我们只想编辑磁带持续时间，磁带名的编辑由默认代表来处理。如果是duration列，就创建一个QTimeEdit，设置恰当的显示格式，连接editingFinished()信号与commitAndCloseEditor()槽。对其它列，传递编辑处理句柄给默认代表。

void TrackDelegate::commitAndCloseEditor()

{

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

emit commitData(editor);

emit closeEditor(editor);

}

如果用户按回车键或把焦点移到QTimeEdit外了（但如果按Esc不会），将发送editingFinished()信号，commitAndCloseEditor()槽会被调用。这个槽发出commitData()信号通知视图有已经编辑好的数据要替换现存数据，也发出closeEditor()信号通知视图不再需要该编辑器，这时模型会删除它。可以用QObject::sender()来获得编辑器，它返回一个对象，该对象发送了信号来触发该槽。如果用户按Esc来取消，视图只是删除编辑器。

void TrackDelegate::setEditorData(QWidget *editor,

const QModelIndex &index) const

{

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

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

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

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

} else {

QItemDelegate::setEditorData(editor, index);

}

当用户开始编辑时，视图调用createEditor()来创建一个编辑器，然后setEditorData()用项的当前数据来初始化编辑器。如果编辑器是用于duration列，我们取出以秒为单位的持续时间，设置QTimeEdit的时间为相应的分秒，其它就交给默认代表来初始化。

void TrackDelegate::setModelData(QWidget *editor,