QGraphicsSimpleTextItem Class

Die Klasse QGraphicsSimpleTextItem stellt ein einfaches Textpfad-Element bereit, das Sie einem QGraphicsScene hinzufügen können. Mehr...

Kopfzeile: #include <QGraphicsSimpleTextItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Vererbungen: QAbstractGraphicsShapeItem

Öffentliche Typen

enum anonymous { Type }

Öffentliche Funktionen

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

Reimplementierte öffentliche Funktionen

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

Detaillierte Beschreibung

Um den Text des Elements zu setzen, können Sie entweder eine QString an den Konstruktor von QGraphicsSimpleTextItem übergeben, oder setText() aufrufen, um den Text später zu ändern. Um die Füllfarbe des Textes zu setzen, rufen Sie setBrush() auf.

Das einfache Textelement kann sowohl eine Füllung als auch einen Umriss haben; setBrush() setzt die Textfüllung (d.h. die Textfarbe), und setPen() setzt den Stift, der zum Zeichnen des Textumrisses verwendet wird. (Letzteres kann langsam sein, besonders bei komplexen Stiften und bei Objekten mit langem Textinhalt). Wenn Sie nur eine einfache Textzeile zeichnen wollen, sollten Sie nur setBrush() aufrufen und den Stift nicht setzen; der Stift von QGraphicsSimpleTextItem ist standardmäßig Qt::NoPen.

QGraphicsSimpleTextItem verwendet die formatierte Größe des Textes und die zugehörige Schriftart, um eine vernünftige Implementierung von boundingRect(), shape() und contains() zu ermöglichen. Sie können die Schriftart durch den Aufruf von setFont() einstellen.

QGraphicsSimpleText zeigt keinen Rich-Text an; stattdessen können Sie QGraphicsTextItem verwenden, das volle Textsteuerungsmöglichkeiten bietet.

Siehe auch QGraphicsTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem, und Graphics View Framework.

Dokumentation der Mitgliedstypen

enum QGraphicsSimpleTextItem::anonymous

Der Wert, der von der virtuellen Funktion type() zurückgegeben wird.

KonstanteWertBeschreibung
QGraphicsSimpleTextItem::Type9Ein einfaches grafisches Textelement

Dokumentation der Mitgliedsfunktionen

[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(QGraphicsItem *parent = nullptr)

Konstruiert ein QGraphicsSimpleTextItem.

parent wird an den Konstruktor von QGraphicsItem übergeben.

Siehe auch QGraphicsScene::addItem().

[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(const QString &text, QGraphicsItem *parent = nullptr)

Konstruiert ein QGraphicsSimpleTextItem, wobei text als Standard-Klartext verwendet wird.

parent wird an den Konstruktor von QGraphicsItem übergeben.

Siehe auch QGraphicsScene::addItem().

[virtual noexcept] QGraphicsSimpleTextItem::~QGraphicsSimpleTextItem()

Zerstört die 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

Gibt die Schriftart zurück, die zum Zeichnen des Textes des Elements verwendet wird.

Siehe auch setFont().

[override virtual] bool QGraphicsSimpleTextItem::isObscuredBy(const QGraphicsItem *item) const

Reimplements: QAbstractGraphicsShapeItem::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)

Setzt die Schriftart, die zum Zeichnen des Textes des Elements verwendet wird, auf font.

Siehe auch font().

void QGraphicsSimpleTextItem::setText(const QString &text)

Setzt den Text des Eintrags auf text. Der Text wird als reiner Text angezeigt. Zeilenumbrüche ('\n') sowie Zeichen des Typs QChar::LineSeparator führen dazu, dass item den Text in mehrere Zeilen umbricht.

Siehe auch text().

[override virtual] QPainterPath QGraphicsSimpleTextItem::shape() const

Reimplements: QGraphicsItem::shape() const.

QString QGraphicsSimpleTextItem::text() const

Gibt den Text des Artikels zurück.

Siehe auch setText().

[override virtual] int QGraphicsSimpleTextItem::type() const

Reimplements: 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.