Qt 常见的 QGraphicsItem


简述

QGraphicsItem 类是 QGraphicsScene 中所有 item 的基类。

它提供了一个轻量级的基础,用于编写自定义 item。其中包括:定义 item 的几何形状、碰撞检测、绘制实现、以及通过其事件处理程序进行 item 的交互,QGraphicsItem 是 Qt之图形视图框架 的一部分。

常见的 QGraphicsItem

为方便起见,Qt 为最常见的形状提供了一组典型的标准 item。它们是:

1 QGraphicsSimpleTextItem:提供了一个简单的文本标签项 2 QGraphicsTextItem:提供了一个格式化的文本项 3 QGraphicsLineItem:提供了一个直线项 4 QGraphicsPixmapItem:提供了一个图像项 5 QGraphicsRectItem:提供了一个矩形项 6 QGraphicsEllipseItem:提供了一个椭圆项 7 QGraphicsPathItem:提供了一个路径项 8 QGraphicsPolygonItem:提供了一个多边形项

QGraphicsSimpleTextItem

详细描述

QGraphicsSimpleTextItem 提供了一个简单的文本标签项,可以添加到 QGraphicsScene 中。

要设置 item 的文本,可以传递 QString 到 QGraphicsSimpleTextItem 的构造函数,或在之后调用 setText() 来更改文本。要设置文本填充色,调用 setBrush()。

QGraphicsSimpleTextItem 可以具有填充和轮廓,setBrush() 用于设置文本填充(即文本色),setPen() 用于设置绘制文本轮廓的画笔(后者可能很慢,特别是对于复杂的画笔,以及具有长文本内容的 item)。

如果只想绘制一行简单的文本,只需要调用 setBrush(),不需要设置画笔。QGraphicsSimpleTextItem 的画笔默认是 Qt::NoPen。

QGraphicsSimpleTextItem 使用文本的格式化大小和相关联的字体,为 boundingRect()、shape() 和 contains() 提供了一个合理的实现。可以通过调用 setFont() 设置字体。

QGraphicsSimpleText 不显示富文本,相反,可以使用 QGraphicsTextItem,它提供全文控制功能。

示例

 

代码

 1 void TOPIScanningGUI::My()  2 {  3     QGraphicsSimpleTextItem *pItem = new QGraphicsSimpleTextItem();  4     pItem->setText("这是一个QGraphicsSimpleTextItem");  5     QFont font = pItem->font();  6     font.setPixelSize(20);  // 像素大小
 7     font.setItalic(true);  // 斜体
 8     font.setUnderline(true);  // 下划线
 9     pItem->setFont(font); 10     pItem->setBrush(QBrush(QColor(0, 160, 230))); 11     scene1->addItem(pItem); 12 }

QGraphicsTextItem

详细描述

QGraphicsTextItem 类提供了一个格式化的文本项,可以添加到 QGraphicsScene 中。

要设置 item 的文本,可以传递 QString 到 QGraphicsTextItem 的构造函数,或调用 setHtml()/setPlainText()。

QGraphicsTextItem 使用文本的格式化大小和相关联的字体,为 boundingRect()、shape() 和 contains() 提供了一个合理的实现。可以通过调用 setFont() 设置字体。

可以通过使用 setTextInteractionFlags() 设置 Qt::TextEditorInteraction 标志来使 item 可编辑。

item 的首选文本宽度可以使用 setTextWidth() 设置,并使用 textWidth() 获取。

注意:为了在中心对齐 HTML 文本,必须设置 item 的文本宽度。否则,可以在设置 item 的文本后调用 adjustSize()。

 

注意: QGraphicsTextItem 默认接受 hover 事件,可以使用 setAcceptHoverEvents() 更改此值。

纯文本

 代码

 1 void TOPIScanningGUI::My()  2 {  3     QGraphicsTextItem *pItem = new QGraphicsTextItem();  4     pItem->setPlainText("这是一个QGraphicsTextItem");  // 纯文本
 5     pItem->setDefaultTextColor(QColor(0, 160, 230));  // 文本色
 6     QFont font = pItem->font();  7     font.setPixelSize(20);  // 像素大小
 8     font.setItalic(true);  // 斜体
 9     font.setUnderline(true);  // 下划线
10     pItem->setFont(font); 11     scene1->addItem(pItem); 12 }

QGraphicsLineItem

详细描述

QGraphicsLineItem 类提供了一个直线项,可以添加到 QGraphicsScene 中。

要设置 item 的直线,可以传递 QLineF 到 QGraphicsLineItem 的构造函数,或调用 setLine() 函数。line() 返回当前直线。默认情况下,该直线为黑色,宽度为 0,可以通过调用 setPen() 进行更改。

 

QGraphicsLineItem 使用直线和画笔的宽度,为 boundingRect()、shape() 和 contains() 提供了一个合理的实现。paint() 函数使用 item 关联的画笔绘制直线。

 

 

QGraphicsPixmapItem

详细描述

QGraphicsPixmapItem 类提供了一个图像项,可以添加到 QGraphicsScene 中。

要设置 item 的图像,可以传递 QPixmap 到 QGraphicsPixmapItem 的构造函数,或调用 setPixmap() 函数,pixmap() 返回当前的图像。

QGraphicsPixmapItem 使用 pixmap 的可选 alpha 掩码,为 boundingRect()、shape() 和 contains() 提供了一个合理的实现。

图像在 item 的 (0, 0) 坐标处绘制,由 offset() 返回。可以通过调用 setOffset() 更改绘图偏移量。

可以通过调用 setTransformationMode() 设置图像的变换模式,默认情况下,使用 Qt::FastTransformation,它提供了快速、不平滑的缩放。Qt::SmoothTransformation 在 painter 上启用 QPainter::SmoothPixmapTransform,质量取决于平台和视口。结果通常不如调用 QPixmap::scale() 直接,调用 transformMode() 获取项目的当前转换模式。

示例

代码

 1 void TOPIScanningGUI::My()  2 {  3     // 定义一个 item
 4     QGraphicsPixmapItem *pItem = new QGraphicsPixmapItem();  5 
 6     QPixmap image("D://logo.png");  7     pItem->setPixmap(image.scaled(150, 150));  8 
 9     scene1->addItem(pItem); 10 }

QGraphicsRectItem

详细说明

QGraphicsRectItem 类提供了一个矩形项,可以添加到 QGraphicsScene 中。

要设置 item 的矩形,可以传递一个 QRectF 到 QGraphicsRectItem 的构造函数,或调用 setRect() 函数。rect() 返回当前矩形。

QGraphicsRectItem 使用矩形和画笔宽度,为 boundingRect()、shape() 和 contains() 提供了一个合理的实现。paint() 函数使用 item 关联的画笔和画刷绘制矩形,可以通过调用 setPen() 和 setBrush() 函数来设置。

注意:无效矩形(例如,宽度或高度为负)的呈现是未定义的。如果不能确定使用的是有效的矩形(例如,如果使用来自不可靠源的数据创建的矩形),那么应该使用 QRectF::normalized() 创建标准化的矩形,然后使用它们。

示例

代码

 1 void TOPIScanningGUI::My()  2 {  3     // 定义一个 item
 4     QGraphicsRectItem  *pItem = new QGraphicsRectItem();  5 
 6     // 设置画笔、画刷
 7     QPen pen = pItem->pen();  8     pen.setWidth(5);  9  pen.setColor(Qt::white); 10     pItem->setPen(pen); 11     pItem->setBrush(QBrush(QColor(0, 160, 230))); 12 
13     // 矩形区域 起点:(50, 50) 宽:100 高:100
14     pItem->setRect(QRectF(50, 50, 100, 100)); 15 
16     scene1->addItem(pItem); 17 }

QGraphicsEllipseItem

详细说明

QGraphicsEllipseItem 类提供了一个椭圆项,可以添加到 QGraphicsScene 中。

QGraphicsEllipseItem 表示一个带有填充和轮廓的椭圆,也可以使用它的椭圆段(见 startAngle()、spanAngle())。

要设置 item 的椭圆,可以传递一个 QRectF 到 QGraphicsEllipseItem 的构造函数,或调用 setRect()。rect() 返回当前椭圆的几何形状。

QGraphicsEllipseItem 使用 rect 和画笔宽度,为 boundingRect()、shape() 和 contains() 提供了一个合理的实现。paint() 函数使用 item 关联的画笔和画刷来绘制椭圆,可以通过调用 setPen() 和 setBrush() 来设置。

示例

代码

 1 void TOPIScanningGUI::My()  2 {  3     // 定义一个 item
 4     QGraphicsEllipseItem *pItem = new QGraphicsEllipseItem();  5 
 6     // 设置画笔、画刷
 7     QPen pen = pItem->pen();  8     pen.setWidth(5);  9  pen.setColor(Qt::white); 10     pItem->setPen(pen); 11     pItem->setBrush(QBrush(QColor(0, 160, 230))); 12 
13     // 矩形区域 起点:(50, 50) 宽:200 高:100
14     pItem->setRect(QRectF(50, 50, 200, 100)); 15     pItem->setStartAngle(16 * 90);  // 起始角度
16     pItem->setSpanAngle(16 * 270);  // 跨角
17 
18     scene1->addItem(pItem); 19 }

QGraphicsPathItem

详细描述

QGraphicsPathItem 类提供了一个路径项,可以添加到 QGraphicsScene 中。

要设置 item 的路径,可以传递 QPainterPath 到 QGraphicsPathItem 的构造函数,或调用 setPath() 函数,path() 返回当前路径。

 

QGraphicsPathItem 使用路径,为 boundingRect()、shape() 和 contains() 提供了一个合理的实现。paint() 函数使用 item 关联的画笔和画刷来绘制路径,可以通过调用 setPen() 和 setBrush() 函数来设置。

示例


代码

 1 void TOPIScanningGUI::My()  2 {  3     const float Pi = 3.14159f;  4 
 5     // 定义一个 item
 6     QGraphicsPathItem *pItem = new QGraphicsPathItem();  7 
 8     // 绘制星星
 9  QPainterPath starPath; 10     starPath.moveTo(90, 50); 11     for (int i = 1; i < 5; ++i) { 12         starPath.lineTo(50 + 40 * std::cos(0.8 * i * Pi), 50 + 40 * std::sin(0.8 * i * Pi)); 13  } 14  starPath.closeSubpath(); 15     pItem->setPath(starPath); 16 
17     // 设置画笔、画刷
18     QPen pen = pItem->pen(); 19     pen.setWidth(2); 20  pen.setColor(Qt::white); 21     pItem->setPen(pen); 22     pItem->setBrush(QBrush(QColor(0, 160, 230))); 23 
24     scene1->addItem(pItem); 25 }

QGraphicsPolygonItem

详细描述

QGraphicsPolygonItem 类提供了一个多边形项,可以添加到 QGraphicsScene 中。

要设置 item 的多边形,传递 QPolygonF 到 QGraphicsPolygonItem 的构造函数,或调用 setPolygon() 函数。polygon() 返回当前的多边形。

QGraphicsPolygonItem 使用多边形和画笔宽度,为 boundingRect()、shape() 和 contains() 提供了一个合理的实现。paint() 函数使用 item 关联的画笔和画刷绘制多边形,可以通过调用 setPen() 和 setBrush() 函数进行设置。

示例

 

代码:

 1 void TOPIScanningGUI::My()  2 {  3     // 定义一个 item
 4     QGraphicsPolygonItem *pItem = new QGraphicsPolygonItem();  5 
 6     // 绘制多边形
 7  QPolygonF polygon;  8     polygon << QPointF(200.0, 120.0) << QPointF(230.0, 130.0)  9         << QPointF(260.0, 180.0) << QPointF(200.0, 200.0); 10     pItem->setPolygon(polygon); 11 
12     // 设置画笔、画刷
13     QPen pen = pItem->pen(); 14     pen.setWidth(2); 15  pen.setColor(Qt::black); 16     pItem->setPen(pen); 17     pItem->setBrush(QBrush(QColor(0, 160, 230))); 18 
19 
20     scene1->addItem(pItem); 21 }

 


免责声明!

本站转载的文章为个人学习借鉴使用,本站对版权不负任何法律责任。如果侵犯了您的隐私权益,请联系本站邮箱yoyou2525@163.com删除。



 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM