QGraphicsSimpleTextItem Class
QGraphicsSimpleTextItem 类提供了一个简单的文本路径项，您可以将其添加到QGraphicsScene... 更多
| 头文件： | #include <QGraphicsSimpleTextItem> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 继承： | QAbstractGraphicsShapeItem |
公共类型
| enum | anonymous { Type } |
公共函数
| QGraphicsSimpleTextItem(QGraphicsItem *parent = nullptr) | |
| QGraphicsSimpleTextItem(const QString &text, QGraphicsItem *parent = nullptr) | |
| virtual | ~QGraphicsSimpleTextItem() |
| QFont | font() const |
| void | setFont(const QFont &font) |
| void | setText(const QString &text) |
| QString | text() const |
重新实现的公共函数
| virtual QRectF | boundingRect() const override |
| virtual bool | contains(const QPointF &point) const override |
| virtual bool | isObscuredBy(const QGraphicsItem *item) const override |
| virtual QPainterPath | opaqueArea() const override |
| virtual void | paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override |
| virtual QPainterPath | shape() const override |
| virtual int | type() const override |
详细说明
要设置项目的文本，您可以向 QGraphicsSimpleTextItem 的构造函数传递QString ，或者调用setText() 稍后更改文本。要设置文本填充颜色，请调用setBrush() 。
简单文本项可以有填充和轮廓；setBrush() 将设置文本填充（即文本颜色），setPen() 将设置用于绘制文本轮廓的笔。(后者可能会比较慢，尤其是对于复杂的笔和文本内容较长的项目）。如果您只想绘制一行简单的文本，则应只调用setBrush() 而不设置笔；QGraphicsSimpleTextItem 的笔默认为Qt::NoPen 。
QGraphicsSimpleTextItem 使用文本的格式化大小和相关字体来合理地实现boundingRect(),shape(), 和contains().您可以调用setFont() 设置字体。
QGraphicsSimpleText 不显示富文本；相反，您可以使用QGraphicsTextItem ，它提供了完整的文本控制功能。
另请参阅 QGraphicsTextItem,QGraphicsPathItem,QGraphicsRectItem,QGraphicsEllipseItem,QGraphicsPixmapItem,QGraphicsPolygonItem,QGraphicsLineItem 和图形视图框架。
成员类型文档
enum QGraphicsSimpleTextItem::anonymous
虚拟type() 函数返回的值。
| 常量 | 值 | 说明 |
|---|---|---|
QGraphicsSimpleTextItem::Type | 9 | 图形简文本项 |
成员函数文档
[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(QGraphicsItem *parent = nullptr)
构造一个 QGraphicsSimpleTextItem。
parent 传递给 的构造函数。QGraphicsItem
另请参阅 QGraphicsScene::addItem().
[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(const QString &text, QGraphicsItem *parent = nullptr)
构造一个 QGraphicsSimpleTextItem，使用text 作为默认纯文本。
parent 传递给 的构造函数。QGraphicsItem
另请参阅 QGraphicsScene::addItem().
[virtual noexcept] QGraphicsSimpleTextItem::~QGraphicsSimpleTextItem()
[override virtual] QRectF QGraphicsSimpleTextItem::boundingRect() const
重实现：QGraphicsItem::boundingRect() const.
[override virtual] bool QGraphicsSimpleTextItem::contains(const QPointF &point) const
重实现：QGraphicsItem::contains(const QPointF &point) const.
QFont QGraphicsSimpleTextItem::font() const
返回用于绘制项目文本的字体。
另请参阅 setFont()。
[override virtual] bool QGraphicsSimpleTextItem::isObscuredBy(const QGraphicsItem *item) const
重实现：QAbstractGraphicsShapeItem::isObscuredBy(const QGraphicsItem *item) const.
[override virtual] QPainterPath QGraphicsSimpleTextItem::opaqueArea() const
重实现：QAbstractGraphicsShapeItem::opaqueArea() const.
[override virtual] void QGraphicsSimpleTextItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
重实现：QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)。
void QGraphicsSimpleTextItem::setFont(const QFont &font)
将用于绘制项目文本的字体设置为font 。
另请参阅 font()。
void QGraphicsSimpleTextItem::setText(const QString &text)
将项目文本设置为text 。文本将以纯文本形式显示。换行符（'\n'）以及QChar::LineSeparator 类型的字符会导致 item 将文本分成多行。
另请参阅 text()。
[override virtual] QPainterPath QGraphicsSimpleTextItem::shape() const
重实现：QGraphicsItem::shape() const.
QString QGraphicsSimpleTextItem::text() const
返回项目的文本。
另请参阅 setText()。
[override virtual] int QGraphicsSimpleTextItem::type() const
重实现：QGraphicsItem::type() const.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
