Sur cette page

QGraphicsSimpleTextItem Class

La classe QGraphicsSimpleTextItem fournit un élément de texte simple que vous pouvez ajouter à un site QGraphicsScene. Plus....

En-tête : #include <QGraphicsSimpleTextItem>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Héritages : QAbstractGraphicsShapeItem

Types publics

enum { Type }

Fonctions publiques

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

Fonctions publiques réimplémentées

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

Description détaillée

Pour définir le texte de l'élément, vous pouvez soit passer un QString au constructeur de QGraphicsSimpleTextItem, soit appeler setText() pour modifier le texte ultérieurement. Pour définir la couleur de remplissage du texte, appelez setBrush().

L'élément de texte simple peut avoir un remplissage et un contour ; setBrush() définit le remplissage du texte (c'est-à-dire la couleur du texte) et setPen() définit le stylo qui sera utilisé pour dessiner le contour du texte. (Cette dernière opération peut être lente, en particulier pour les stylos complexes et les éléments contenant un long texte). Si vous souhaitez simplement dessiner une ligne de texte, vous devez appeler setBrush() et ne pas définir le stylo ; le stylo de QGraphicsSimpleTextItem est par défaut Qt::NoPen.

QGraphicsSimpleTextItem utilise la taille formatée du texte et la police associée pour fournir une implémentation raisonnable de boundingRect(), shape() et contains(). Vous pouvez définir la police en appelant setFont().

QGraphicsSimpleText n'affiche pas de texte enrichi ; à la place, vous pouvez utiliser QGraphicsTextItem, qui offre des capacités complètes de contrôle du texte.

Texte "Qt" avec remplissage personnalisé et contour dessiné près de l'origine

Voir également QGraphicsTextItem, QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPixmapItem, QGraphicsPolygonItem, QGraphicsLineItem, et Graphics View Framework.

Documentation sur les types de membres

[anonymous] enum

Valeur renvoyée par la fonction virtuelle type().

ConstanteValeurDescription de l'élément
QGraphicsSimpleTextItem::Type9Un élément de texte graphique simple

Documentation des fonctions membres

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

Construit un élément QGraphicsSimpleTextItem.

parent est transmis au constructeur de QGraphicsItem.

Voir aussi QGraphicsScene::addItem().

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

Construit un élément QGraphicsSimpleTextItem, en utilisant text comme texte brut par défaut.

parent est transmis au constructeur de QGraphicsItem.

Voir aussi QGraphicsScene::addItem().

[virtual noexcept] QGraphicsSimpleTextItem::~QGraphicsSimpleTextItem()

Détruit le site QGraphicsSimpleTextItem.

[override virtual] QRectF QGraphicsSimpleTextItem::boundingRect() const

Réimplémente : QGraphicsItem::boundingRect() const.

[override virtual] bool QGraphicsSimpleTextItem::contains(const QPointF &point) const

Réimplémente : QGraphicsItem::contains(const QPointF &point) const.

QFont QGraphicsSimpleTextItem::font() const

Renvoie la police utilisée pour dessiner le texte de l'élément.

Voir aussi setFont().

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

Réimplémente : QAbstractGraphicsShapeItem::isObscuredBy(const QGraphicsItem *item) const.

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

Réimplémente : QAbstractGraphicsShapeItem::opaqueArea() const.

[override virtual] void QGraphicsSimpleTextItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)

Réimplémente : QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

void QGraphicsSimpleTextItem::setFont(const QFont &font)

Définit la police utilisée pour dessiner le texte de l'élément à font.

Voir aussi font().

void QGraphicsSimpleTextItem::setText(const QString &text)

Définit le texte de l'élément à text. Le texte sera affiché en clair. Les caractères de retour à la ligne ('\n') ainsi que les caractères de type QChar::LineSeparator amèneront item à couper le texte en plusieurs lignes.

Voir également text().

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

Réimplémente : QGraphicsItem::shape() const.

QString QGraphicsSimpleTextItem::text() const

Renvoie le texte de l'élément.

Voir aussi setText().

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

Réimplémente : 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.