Qt图形视图QGraphicsItem类

QGraphicsItem类是视图框架的一部分，是在一个QGraphicsScene中最基本的图形类，它为绘制你自己的item提供了一个轻量级的窗口，包括声明item的位置，碰撞检测，绘制重载和item之间的相互作用通过事件处理。

Qt提供了一系列标准的items对一些常见的图像，非常的方便，有下面这些：

QGraphicsEllipseItem 提供一个椭圆item

QGraphicsLineItem 提供一条线的item

QGraphicsPathItem 提供一个任意的路径item

QGraphicsPixmapItem 提供一个图形item

QGraphicsPolygonItem 提供一个多边形item

QGraphicsRectItem 提供一个矩形item

QGraphicsSimpleTextItem 提供一个简单的文本item

QGraphicsTextItem 提供一个文本浏览item

item的所有几何位置信息都建立在本地坐标系统上，item的位置，使用pos()获得，是唯一一个不再本地item中实现的。它返回的是item在父亲坐标系统中的位置，关于坐标系统可以详细参看 The Graphics View Coordinate System

通过调用哪个setVisible()，可以设置item是否可见，隐藏一个item同时也隐藏了他的孩子，相似的，你可以通过调用setEnabled()来是指item是否可用。如果禁用了item，那么它所有的孩子都不可用。默认的，items都是可见和可用的。来开关一个item是否被选择，首先通过设置itemsSelectable flag来使能选择。然后调用setSelect()，通常，是否可被选择的开关时打开的

写自己的item图形，首先应该继承QGraphicsItem,然后重写他的两个纯虚公共函数，

boundingRect()和paint()，第一个函数返回绘制item大概的区域，第二个函数用来绘制item内容

boundingRect()函数有很多用处，场景在boundingRect()来建立它的item的index，视图view使用它来剪切可见的item，在重新绘制item时候，来决定相互重叠的部分，此外，item的碰撞检测机制也使用的boundingRect()来提供一个高效的定点，在collidesWithItem()更好的碰撞算法建立在调用函数shape(),shape()函数以QpainterPath类型返回item的精准的轮廓。

一般的，场景不希望item的boundingRect()和shape()变化，除非该item被通告，如果想通过一些方法改变item的形状，首先应该调用QgraphicsScene()来允许场景QgraphicsScene来刷新它的item记录。

碰撞检测可以通过下面两种方法来完成

1、重写shape()函数来返回item的精准轮廓，依靠默认的collidesWithItem()来做外形交集。如果item轮廓和复杂时候，这个消耗是很大的

2、重写collidesWithItem()，提供一个自己的item和轮廓碰撞的算法

Contains（）函数可以调用，用来决定一个item是否包含一个点。这个函数也可以重写，contains()函数默认的方法是通过调用shape（）来完成的。

Items中也可以包含其他的items,也可以被别的items包含，所有的items可以有一个父亲item和一串孩子items,除非一个item没有父亲，否则它的位置是在父亲坐标中，父亲items遗传他的位置和转换给孩子item

转换

QgraphicsItem支持投射转换，有很多方法来改变item的转换，对于简单的转换，可以调用函数setRotation()或者setScale()，可以传递一个转换矩阵给函数setTransform(),对于一些更复杂的转换，可以通过调用函数setTransformations()来设置一系列组合的转换。

Item转换从父亲到孩子进行聚集，因此如果一个父亲和孩子item都旋转90度，那么孩子就旋转了180度，相似的，如果父亲item放大了2X倍，那么孩子item就被方法4X倍，一个item的转换不影响他的外观，所有和外观有关的函数（例如contains(),update()和所有的映射mapping函数）将会在本地坐标中操作，更方便的，QgraphicsItem提供函数sceneTransform()，将会返回item所有的转换矩阵，scenePos()将会返回item在场景坐标中的位置，重新设置item的矩阵，调用函数resetTransform()

一般的转换回产生一个不同的结果，这取决于转换应用的顺序，例如，如果你放大一个转换，然后再旋转它，可能和你先旋转它得到的结果不一样，你设置转换属性的顺序并不影响转换的结果，（也就是仍旧会按照你的转换命令去转换，只是最后得到的图形不一样而已），QgraphicsItem经常应用一个合适的顺序如下：

绘图painting

paint()函数被QgrapicsView类调用来绘制item的内容，item默认是没有背景或者填充颜色的。在函数中没有被绘制的所有区域都将会发亮，可以调用update（）来重绘item，可以选择传递需要重绘的矩形区域（不是必须的）。取决于item在view中是否可见，item可能会也可能不会重绘，QgraphicsItem里面没有和Qwidget::repaint()函数等价的

item通过view来绘制，从父items开始，然后是自items，以上升的栈的顺序，可以通过调用setZValue()设置item的栈顺序，通过zValue()来测试，具有低z-values的item比具有高z-value的item先绘制，栈顺序应用于兄弟items，父items总是比子items更早绘制。

排序sort

所有的items都按照一个已经声明的，稳定的顺序来绘制，这个顺序也决定了当你在场景中点击鼠标时候，哪个items最先接受鼠标的输入。一般的，你不需要担心排序问题，因为所有的items都按照一个在场景中声明的自然的顺序

在一个栈中，子item在父item的上面，兄弟item按照插入场景的顺序来入栈，如果你先添加了item A ，然后是item B，然后是item C ，这样栈中的顺序从下往上就是A,B,C

Drag and Drop Robot例子中展示了该robot的栈顺序，躯干顺序是根item（其他所有的item都是躯干item的子item或者后代item），然后是头item被绘制，由于它是躯干item的子item列表中的第一个item，然后是左臂膀上面的那部分item，下面那个臂膀item是上面臂膀item的子item，所以会在和3号item同等级的兄弟item绘制完后被绘制，接着就是右边上面的的臂膀item，就是5号item。

。可以调用setZvalue()来设置一个item的相对亦另一个向上，向下或者兄弟栈顺序。默认的Z值是0，具有同样的Z值的item会按照插入的顺序来入栈。

。可以调用stackBefore()来备份孩子item的列表，这可以直接更正item的顺序。

。如果想让孩子item在父item的后面，也就是先绘制孩子item，然后在绘制父item，怎么办呢？可以设置ItemStacksBehindParent属性给这个item，利用函数setFlag();

两个兄弟item的顺序也决定了他们的子item 和后代item的顺序，如果一个父item的在两个父item的后面，那么他所有的孩子items都在另一个父item的孩子items后面。

事件Event

QgraphicsItem从场景中通过sceneEvent()函数来接受事件，这个函数通过一些方便的操作分散大部分事件

ContextMenuEvent()函数接受上下文菜单事件

FocusInEvent()和focusOutEvent()函数接受焦点进出事件

hoverEnterEvent(), hoverMoveEvent(), and hoverLeaveEvent() 接受鼠标悬浮移动和离开事件

inputMethodEvent()函数处理输入法事件，

keyPressEvent() and keyReleaseEvent()事件处理键盘按下和松开事件

mousePressEvent(), mouseMoveEvent(), mouseReleaseEvent(), and mouseDoubleClickEvent()处理鼠标按下，移动，松开，双击事件

也可以为一些item过滤一些事件通过安装过滤器，这个和QT一般的事件过滤器不一样，一般的过滤器只工作在Qobject和它的子类，通过调用installSceneEventFilter()为item安装了过滤器后，被过滤的事件将会被虚函数sceneEventFilter().捕捉到，可以通过调用函数removeSceneEventFilter().来去除掉事件过滤器

Custom Data数据
有些时候为item注册一些数值很有用，做一个普通的item或者标准的item，可以调用setData()来为任一个item设置值，这个值使用key-value对，（key是整形，value是变种数据Qvarient）来得到item的数据，通过调用data(),

1、QVariant QGraphicsItem::itemChange ( GraphicsItemChange change, const QVariant & value ) [virtual protected]

这个函数被QGraphicsItem调用用来标明items的一些状态改变了，通过重载这个函数，可以对自己定义事件响应，在一些情况下，可以做一些调整。

参数change是改变的那个item的改变状态参数，value是一个新的数据，他的类型取决于change，

change是QGraphicsItem::GraphicsItemChange的枚举变量

enum GraphicsItemChange { ItemEnabledChange, ItemEnabledHasChanged,

ItemMatrixChange, ItemPositionChange, …, ItemScenePositionHasChanged }

例如：

QVariant Component::itemChange(GraphicsItemChange change, const QVariant &value)

{

if (change == ItemPositionChange && scene()) {

// value is the new position.

QPointF newPos = value.toPointF();

QRectF rect = scene()->sceneRect();

if (!rect.contains(newPos)) {

// Keep the item inside the scene rect.

newPos.setX(qMin(rect.right(), qMax(newPos.x(), rect.left())));

newPos.setY(qMin(rect.bottom(), qMax(newPos.y(), rect.top())));

return newPos;

}

return QGraphicsItem::itemChange(change, value);

}

默认的函数什么都不做，只返回value

注意：在使用这个函数时候，在函数内部调用函数时候要小心，因为这可能导致一些意想不到的结果，例如：你不能再这个函数里面调用setPos()在change是ItemPositionChange时候，由于setPos()函数将会再次调用itemChange(ItemPositionChange)，如此就一直循环下去了。

2、void QGraphicsItem::setFlag ( GraphicsItemFlag flag, bool enabled = true )

void QGraphicsItem::setFlags ( GraphicsItemFlags flags )

把flags设置为item的属性，如果item获得了光标，但是flags没有使能ItemsFocusable,这个item

将会丢失光标，同样的，当item被选择到，但是没有使能ItemsSelectable,这个item会自动的失去

选择。

默认的，所有的flags都是不可用的。（QGraphicsWidget 为了获得位置变化默认使能了

ItemSendsGeometryChanges）

相近的函数

GraphicsItemFlags QGraphicsItem::flags () const

返回item的所有使能的flags，例如，如果flags里面包含了ItemIsFocusable，这个item可以接受

输入光标

3、QPainterPath QGraphicsItem::shape () const [virtual]

以QPainterPath返回item在local坐标中的形状，这个形状可以用来做很多事情，包括碰撞侦测，

打击测试，还有用来 QGraphicsScene::items() 函数

默认的函数调用boundingRect()返回一个简单的矩形形状，但是子类可以重载这个函数，为非矩形

的item返回一个更加精准的形状，例如一个圆形的item可以选择返回一个椭圆形，用来获得更好的

碰撞侦测效果。代码：

QPainterPath RoundItem::shape() const

{

QPainterPath path;

path.addEllipse(boundingRect());

return path;

}

形状的轮廓线可以通过绘制时候的pen来变化

4、QRectF QGraphicsItem::boundingRect () const [pure virtual]

这个纯虚函数用矩形声明了item的边界轮廓，所有的绘制都必须限定在item的矩形边框内。

QGraphicsView使用这个方法来决定item是否需要重绘

尽管item的形状可以是任意的，但是边框一直都是矩形，不影响items的变换

如果想改变items的边框，应该首先调用prepareGeometryChange()，这将通知场景scene即将发生的变化，这样场景可以刷新item的位置下标。否则，场景将不会察觉到item的变化，结果也未知。

如果要重绘item时候，重载这个函数来让QGraphicsView来决定item的边界区域，

注意：由于绘制边界时候的边界轮廓线，在这个矩形区域内包含画笔pen宽度的一半很重要，不需

要补偿画图走样例如

QRectF CircleItem::boundingRect() const

{

qreal penWidth = 1;

return QRectF(-radius – penWidth / 2, -radius – penWidth / 2,

diameter + penWidth, diameter + penWidth);

}

同样的一个返回item轮廓的函数

QRegion QGraphicsItem::boundingRegion ( const QTransform & itemToDeviceTransform ) const

返回该item的轮廓区域，返回的区域的坐标系统依赖于参数itemToDeviceTransform，如果你传递一个Qtransform对象作为参数，那么函数将返回本地坐标系统区域

返回的区域是item内容可见的一个大概的轮廓，尽管计算起来很浪费空间和时间，但是比boundingRect（）更精准，而且当重绘时候，它还能避免不必要的重绘。对像线或者简单的多边形来说非常有效。

也可以调节轮廓区域的粒度通过调用setBoundingRegionGranularity()，默认的粒度是0，这时候item的区域和轮廓矩形一样的。

itemToDeviceTransform是从item坐标系统到设备坐标系统的一个转换。如果你想让这个函数返回一个场景坐标区域，可以用函数sceneTransform()作为参数。

相关函数qreal QGraphicsItem::boundingRegionGranularity () const

返回item的轮廓区域粒度

5、void QGraphicsItem::setPos ( const QPointF & pos )

在父对象坐标系统中设置item的位置为pos，对没有父对象的items,pos使用的场景的坐标系统，

6、QPointF QGraphicsItem::scenePos () const

返回该item在场景中的坐标点，等价于调用函数mapToScene(0, 0).

7、QPointF QGraphicsItem::pos () const

返回item在父坐标系中的位置，如果没有父坐标系，那么返回在场景坐标系中的位置，此时等价于调用scenePos ()，可以直接调用scenePos ()来获取该item在场景中的位置，从而忽略其父对象。

8、enum QGraphicsItem::CacheMode
设置绘图的缓冲模式，默认是没有缓冲，如果使用缓冲区的话，在重绘时候，非常快

设置缓冲模式使用函数QGraphicsItem::setCacheMode().

9、bool QGraphicsItem::acceptDrops () const

如果item能够接受拖拽事件，就返回真，否则返回假，默认的不能接受拖拽事件

Qt图形视图QGraphicsItem类相关推荐

Qt 图形视图框架中的事件处理和传播
目录名字 Qt 图形视图框架中的事件处理和传播要点: Qt 图形视图框架中的事件处理和传播图形视图框架在一些动画类的应用程序上经常会用到.该框架中的事件处理与传播机制也是经常会涉及. 程序设计核心 ...
Qt图形视图框架详解-安晓辉-专题视频课程
Qt图形视图框架详解-12227人已学习课程介绍介绍Qt中的Graphics View Framework,涉及View.Scene.Item的关系,如何自定义QGraphicsI ...
Qt 图形视图框架（Qt MVC）
什么是MVC MVC全名是Model View Controller,是模型(model)-视图(view)-控制器(controller)的缩写,一种软件设计典范,用一种业务逻辑.数据.界面显示分离 ...
201112阶段二qt图形视图框架
目录一.学习的知识点一)事件二)图形视图框架二.上课没有听懂或者没有理解的地方三.当天学习的收获一.学习的知识点一)事件鼠标事件的创建组合键二)图形视图框架场景类:坐标系以中心为 ...
Qt图形视图框架--图元总结
文章目录一.基类QGraphicsItem 二.内部图元 2.1.椭圆图元--QGraphicsEllipseItem 2.2.线段图元--QGraphicsLineItem 2.3.路径图元--Q ...
Qt图形视图框架：QGraphicsScene详解
一.描述 1.场景提供了一个用于管理大量2D图形项的平面.该类充当图形项的容器. 它与视图一起用于可视化2D曲面上的图形图形项. 2.场景没有自己的视觉外观,只负责管理图形项. 3.场景的最大优势之一 ...
Qt图形视图框架图片图元QGraphicsPixmapItem
文章可能被更新,最新地址:http://www.fearlazy.com/index.php/post/107.html 看这个标题还真有点拗口,一句话里出现了四个图字.这句话的关键词是图片,前面讲了 ...
Qt图形视图框架：将自定义图形项放入布局
只有继承布局项QGraphicsLayoutItem的对象才能放入布局.继承QGraphicsLayoutItem后需要重写setGeometry().sizeHint()这两个函数. 以自定义滑动条 ...
Qt图形视图框架：视图增加标尺
效果: 把视图.水平标尺.垂直标尺用网格布局放置. 每当拖动视图的滚动条时,更新标尺的偏移量: connect(deviceGraphicsView->horizontalScrollBar() ...

Qt图形视图QGraphicsItem类

Qt图形视图QGraphicsItem类相关推荐

最新文章

热门文章