QStyledItemDelegate类为来自模型的数据项提供了显示和编辑工具。
当在Qt项视图(例如QTableView)中显示来自模型的数据时,各个项由委托(delegate)绘制。此外,当编辑一个项目时,它提供一个编辑器小部件,当编辑发生时,该小部件放在项目视图的顶部。QStyledItemDelegate是所有Qt项视图的默认委托,在创建时安装在它们上。 QStyledItemDelegate类是模型/视图类之一,是Qt模型/视图框架的一部分。委托允许独立于模型和视图开发项目的显示和编辑。
项目的数据在模型中被分配一个ItemDataRole;每个项目可以为每个角色存储QVariant。QStyledItemDelegate实现显示和编辑用户所期望的最常见的数据类型,包括布尔值、整数、字符串。根据数据在模型中所扮演的角色,数据的绘制将会有所不同。通常需要确保模型为每个角色返回适当的数据,以确定视图中的项的外观。
这里有以下几个要点要记住:
1.QStyledItemDelegate是专门用于项的(item)的视图委托!不能作为其他非项的委托使用。
2.委托用于实现个性化设置的项显示,他的数据来源于模型(model),控制view显示的方式。
3.QStyledItemDelegate是作为默认项委托使用的。如果不独立实现并制定项的委托,则在自定义view和自定义的model中使用默认的委托(delegate)。
4.使用默认委托时,从模型中读取的数据都是按照默认规则来的。默认规则就是通过itemDataRole角色标志的数据在view中显示的。因此需要在model中未每个定义的角色返回合适的数据,这样在使用默认委托时才能显示出自己想要的效果。当然,如果想要其他个性化效果最好是使用自定义的委托。
模型中角色可接受的数据类型
角色描述
角色
可接受的数据类型
用于呈现的项目的背景刷(使用默认委托)
Qt::BackgroundRole
QBrush
这个角色已经过时了。使用BackgroundRole
Qt::BackgroundColorRole
QColor (不再推荐; 可以使用 Qt::BackgroundRole 替代这个角色)
此角色用于获取项的检查状态
Qt::CheckStateRole
Qt::CheckState
以图标的形式作为装饰的数据
Qt::DecorationRole
QIcon, QPixmap, QImage 和 QColor
以文本形式呈现的关键数据
Qt::DisplayRole
QString 或可以返回字符串表示的类型
适合编辑器中编辑的格式中的数据
Qt::EditRole
详情请看QItemEditorFactory
项目使用的字体渲染(使用默认委托)
Qt::FontRole
QFont
将提供给视图的项的大小提示
Qt::SizeHintRole
QSize
呈现的项的文本对齐方式(使用默认委托)
Qt::TextAlignmentRole
Qt::Alignment
前景画笔(通常是文本颜色),(用于使用默认委托呈现的项目)
Qt::ForegroundRole
QBrush
这个角色已经过时了。使用ForegroundRol
Qt::TextColorRole
QColor (不再推荐; 可以使用 Qt::ForegroundRole 替代这个角色)
这里注意一下几点:
1.角色的数据大多数在默认委托中有专门的用途(在view中什么以model的什么数据呈现)
2.对于Qt::EditRole我们要特别注意,编辑器是悬浮在item上的一个特别的可编辑按钮,他不属于view视图本身:
编辑器是用QItemEditorFactory创建的;QItemEditorFactory提供的默认静态实例安装在所有项委托上。您可以使用setItemEditorFactory()设置自定义工厂,或者使用QItemEditorFactory::setDefaultFactory()设置一个新的默认工厂。使用编辑的EditRole存储在项目模型中的数据。请参阅QItemEditorFactory类,了解项目编辑器工厂的更高级介绍。
使用QStyledItemDelegate的子类实现自定义项的委托
如果委托不支持绘制所需的数据类型,或者希望定制项目的绘制,则需要子类化QStyledItemDelegate,并重新实现paint()和sizeHint()。**paint()**函数为每个项目分别调用,使用sizeHint(),可以为每个项目指定提示。
当重新实现paint()时,通常会处理要绘制的数据类型,并对其他类型使用超类实现(一般使用QStyledItemDelegate)。
复选框指示符的绘制按当前样式执行。样式还指定用于绘制不同数据角色的数据的大小和边框。项目本身的边框也由样式计算。当绘制已经支持的数据类型时,最好询问这些边框的样式。QStyle类描述更详细地描述了这一点。
如果您希望更改按样式或复选框指示符绘制的任何边框,您可以对QStyle进行子类化。但是,请注意,重新实现sizeHint()也会影响项目的大小。
自定义委托可以在不使用编辑器项目工厂的情况下提供编辑器。在这种情况下,必须重新实现以下虚拟功能:
createEditor()返回用于从模型中更改数据的小部件,并可以重新实现以自定义编辑行为。
setEditorData()为小部件提供了操作数据。
updateEditorGeometry()确保对项视图正确显示编辑器。
setModelData()将更新后的数据返回给模型。
注意:从Qt 4.4开始,有两个委托类:QItemDelegate和QStyledItemDelegate。但是,默认的委托是QStyledItemDelegate。这两个类是绘制和为视图中的项目提供编辑器的独立替代。它们之间的区别在于,QStyledItemDelegate使用当前样式来绘制其项目。因此,我们建议在实现自定义委托或使用Qt样式表时使用QStyledItemDelegate作为基类。这两个类所需的代码应该是相等的,除非自定义委托需要使用绘图的样式。如果您希望定制项目视图的绘画,您应该实现自定义样式。即QStyle类。
下面就通常需要覆写的方法进行说明
void QStyledItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const;
重新实现从QAbstractItemDelegate:paint()。使用给定的painter和style选项为索引指定的项呈现委托。这个函数使用视图的QStyle绘制项。在子类中重新实现绘制时。使用initStyleOption()以与QStyledItemDelegate相同的方式设置该选项。只要有可能,在绘画的时候使用这个选项。特别是它的rect变量决定在何处绘制和它的状态,以确定是否启用或选择了它。paint绘画完成后,你应该确保paint回到使用前的状态。例如,在绘制之前调用QPainter::save(),然后调用QPainter: restore()。
注意:
1.QPainter类:QPainter提供了高度优化的函数来完成大多数GUI绘图程序所需的工作。它可以画出从简单的线条到复杂的形状,比如派和和弦。它还可以绘制对齐的文本和像素地图。通常,它画一个“自然”的坐标系统,但它也可以做视图和世界变换。QPainter可以对任何继承QPaintDevice类的对象进行操作。QPainter的常见用法是在小部件的绘图事件中:构造和定制(例如,设置钢笔或画笔)。然后画。记住在画完后要毁掉QPainter对象。
2.QStyleOptionViewItem类:QStyleOptionViewItem类用于描述用于在视图小部件中绘制项的参数。 QStyleOptionViewItem包含QStyle函数绘制Qt模型/视图类项所需的所有信息。由于性能原因,对成员变量的访问是直接的(即。,使用。或- >操作符,都定义为public公有类型)。这种低级的感觉使结构易于使用,并强调这些只是样式函数使用的参数。
3.QModelIndex类:QModelIndex类用于定位数据模型中的数据。这个类被用作从QAbstractItemModel派生的项目模型的索引。项视图、委托和选择模型使用索引来定位模型中的项。
QStyleOptionViewItem类公有区域属性的说明
QModelIndex类的说明
QModelIndex类用于定位数据模型中的数据。这个类被用作从QAbstractItemModel派生的项目模型的索引。项视图、委托和选择模型使用索引来定位模型中的项。新的QModelIndex对象由模型使用QAbstractItemModel::createIndex()函数创建。可以使用QModelIndex构造函数构造无效的模型索引。当引用模型中的顶级项时,无效索引通常用作父索引。
模型索引引用模型中的项目,并包含在这些模型中指定它们的位置所需的所有信息。每个索引位于给定的行和列中,并且可能具有父索引;使用row()、列()和父()来获取这些信息。模型中的每个顶级项都由没有父索引的模型索引表示——在本情况下:parent()将返回一个无效的模型索引,相当于使用QModelIndex()构造函数的零参数形式构造的索引。
为了获得一个模型索引,它引用模型中的现有项目,调用QAbstractItemModel::索引(),其中包含所需的行和列值,以及父类的模型索引。当在模型中引用顶级项时,供应QModelIndex()作为父索引。
注意:应该立即使用模型索引,然后丢弃。在调用修改模型结构的模型函数或删除项之后,不应该依赖索引来保持有效。如果需要长期保持模型索引,请使用QPersistentModelIndex。