QGraphicsSimpleTextItem Class
Die Klasse „QGraphicsSimpleTextItem“ stellt ein einfaches Textelement bereit, das Sie zu einem „ QGraphicsScene “ hinzufügen können. Mehr...
| Header: | #include <QGraphicsSimpleTextItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QAbstractGraphicsShapeItem |
Öffentliche Typen
| enum { 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 |
Neu implementierte ö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 |
Ausführliche Beschreibung
Um den Text des Elements festzulegen, können Sie entweder ein ` QString ` an den Konstruktor von `QGraphicsSimpleTextItem` übergeben oder später die Funktion ` setText()` aufrufen, um den Text zu ändern. Um die Füllfarbe des Textes festzulegen, rufen Sie die Funktion ` setBrush()` auf.
Das einfache Textelement kann sowohl eine Füllung als auch einen Umriss haben; ` setBrush()` legt die Textfüllung (d. h. die Textfarbe) fest, und ` setPen()` legt den Stift fest, mit dem der Textumriss gezeichnet wird. (Letzteres kann langsam sein, insbesondere bei komplexen Stiften und Elementen mit langem Textinhalt.) Wenn Sie lediglich eine einfache Textzeile zeichnen möchten, sollten Sie nur setBrush() aufrufen und den Stift nicht festlegen; der Stift von QGraphicsSimpleTextItem ist standardmäßig Qt::NoPen.
`QGraphicsSimpleTextItem` verwendet die formatierte Größe des Textes und die zugehörige Schriftart, um eine sinnvolle Implementierung von ` boundingRect()`, ` shape()` und ` contains()` bereitzustellen. Sie können die Schriftart durch Aufruf von ` setFont()` festlegen.
QGraphicsSimpleText zeigt keinen Rich Text an; stattdessen können Sie QGraphicsTextItem verwenden, das umfassende Funktionen zur Textsteuerung bietet.
Siehe auch QGraphicsTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem und Graphics View Framework.
Dokumentation zu Mitgliedstypen
[anonymous] enum
Der von der virtuellen Funktion ` type()` zurückgegebene Wert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGraphicsSimpleTextItem::Type | 9 | Ein einfaches Grafikelement vom Typ „Text“ |
Dokumentation der Member-Funktionen
[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(QGraphicsItem *parent = nullptr)
Erstellt ein `QGraphicsSimpleTextItem`.
parent wird an den Konstruktor von ` QGraphicsItem` übergeben.
Siehe auch ` QGraphicsScene::addItem()`.
[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(const QString &text, QGraphicsItem *parent = nullptr)
Erstellt ein `QGraphicsSimpleTextItem` und verwendet dabei ` text ` als Standard-Klartext.
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
Implementiert: ` QGraphicsItem::boundingRect()` const.
[override virtual] bool QGraphicsSimpleTextItem::contains(const QPointF &point) const
Implementiert neu: ` 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
Implementiert erneut: ` QAbstractGraphicsShapeItem::isObscuredBy(const QGraphicsItem *item) const`.
[override virtual] QPainterPath QGraphicsSimpleTextItem::opaqueArea() const
Implementiert erneut: ` QAbstractGraphicsShapeItem::opaqueArea()` const.
[override virtual] void QGraphicsSimpleTextItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
Implementiert: ` QGraphicsItem::paint` (`QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget`).
void QGraphicsSimpleTextItem::setFont(const QFont &font)
Legt die Schriftart fest, die zum Zeichnen des Textes des Elements verwendet wird: font.
Siehe auch font().
void QGraphicsSimpleTextItem::setText(const QString &text)
Setzt den Text des Elements auf „ text “. Der Text wird als Klartext angezeigt. Zeilenumbruchzeichen („\n “) sowie Zeichen vom Typ „ QChar::LineSeparator “ bewirken, dass das Element den Text in mehrere Zeilen aufteilt.
Siehe auch text().
[override virtual] QPainterPath QGraphicsSimpleTextItem::shape() const
Implementiert: ` QGraphicsItem::shape()` const.
QString QGraphicsSimpleTextItem::text() const
Gibt den Text des Elements zurück.
Siehe auch „ setText()“.
[override virtual] int QGraphicsSimpleTextItem::type() const
Implementiert erneut: ` QGraphicsItem::type()` const.
© 2026 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.
