QGraphicsSimpleTextItem Class▲
-
Header: QGraphicsSimpleTextItem
-
CMake:
find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
-
qmake: QT += widgets
-
Inherits: QAbstractGraphicsShapeItem
-
Group: QGraphicsSimpleTextItem is part of graphicsview-api
Detailed Description▲
To set the item's text, you can either pass a QString to QGraphicsSimpleTextItem's constructor, or call setText() to change the text later. To set the text fill color, call setBrush().
The simple text item can have both a fill and an outline; setBrush() will set the text fill (i.e., text color), and setPen() sets the pen that will be used to draw the text outline. (The latter can be slow, especially for complex pens, and items with long text content.) If all you want is to draw a simple line of text, you should call setBrush() only, and leave the pen unset; QGraphicsSimpleTextItem's pen is by default Qt::NoPen.
QGraphicsSimpleTextItem uses the text's formatted size and the associated font to provide a reasonable implementation of boundingRect(), shape(), and contains(). You can set the font by calling setFont().
QGraphicsSimpleText does not display rich text; instead, you can use QGraphicsTextItem, which provides full text control capabilities.
See Also▲
Member Type Documentation▲
enum QGraphicsSimpleTextItem::anonymous▲
The value returned by the virtual type() function.
|
Constant |
Value |
Description |
|---|---|---|
|
QGraphicsSimpleTextItem::Type |
9 |
A graphics simple text item |
Member Function Documentation▲
[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(QGraphicsItem *parent = nullptr)▲
Constructs a QGraphicsSimpleTextItem.
parent is passed to QGraphicsItem's constructor.
See Also▲
See also QGraphicsScene::addItem()
[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(const QString &text, QGraphicsItem *parent = nullptr)▲
Constructs a QGraphicsSimpleTextItem, using text as the default plain text.
parent is passed to QGraphicsItem's constructor.
See Also▲
See also QGraphicsScene::addItem()
[virtual] QGraphicsSimpleTextItem::~QGraphicsSimpleTextItem()▲
Destroys the QGraphicsSimpleTextItem.
[override virtual] QRectF QGraphicsSimpleTextItem::boundingRect() const▲
Reimplements: QGraphicsItem::boundingRect() const.
[override virtual] bool QGraphicsSimpleTextItem::contains(const QPointF &point) const▲
Reimplements: QGraphicsItem::contains(const QPointF &point) const.
QFont QGraphicsSimpleTextItem::font() const▲
[override virtual] bool QGraphicsSimpleTextItem::isObscuredBy(const QGraphicsItem *item) const▲
[override virtual] QPainterPath QGraphicsSimpleTextItem::opaqueArea() const▲
Reimplements: QAbstractGraphicsShapeItem::opaqueArea() const.
[override virtual] void QGraphicsSimpleTextItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)▲
Reimplements: QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).
void QGraphicsSimpleTextItem::setFont(const QFont &font)▲
void QGraphicsSimpleTextItem::setText(const QString &text)▲
Sets the item's text to text. The text will be displayed as plain text. Newline characters ('\n') as well as characters of type QChar::LineSeparator will cause item to break the text into multiple lines.
See Also▲
See also text()
[override virtual] QPainterPath QGraphicsSimpleTextItem::shape() const▲
Reimplements: QGraphicsItem::shape() const.
QString QGraphicsSimpleTextItem::text() const▲
[override virtual] int QGraphicsSimpleTextItem::type() const▲
Reimplements: QGraphicsItem::type() const.