QT界面 使用QStyledItemDelegate QPainter QStyleOptionViewItem QModelIndex组合实现项的绘制

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。