QGraphicsSimpleTextItem Class
La classe `QGraphicsSimpleTextItem` fournit un élément de texte simple que vous pouvez ajouter à un ` QGraphicsScene`. En savoir plus...
| En-tête : | #include <QGraphicsSimpleTextItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | 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 objet ` QString ` au constructeur de `QGraphicsSimpleTextItem`, soit appeler la méthode ` setText()` pour modifier le texte ultérieurement. Pour définir la couleur de remplissage du texte, appelez la méthode ` setBrush()`.
L'élément de texte simple peut comporter à la fois un remplissage et un contour ; la méthode setBrush() définit le remplissage du texte (c'est-à-dire la couleur du texte), tandis que la méthode setPen() définit le stylo qui sera utilisé pour tracer 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 tracer une ligne de texte, vous devez appeler uniquement ` setBrush()` et ne pas définir de stylo ; le stylo par défaut de `QGraphicsSimpleTextItem` est ` Qt::NoPen`.
QGraphicsSimpleTextItem utilise la taille formatée du texte et la police associée pour fournir une implémentation raisonnable des méthodes 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 fonctionnalités complètes de contrôle du texte.
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()`.
| Constante | Valeur | Description |
|---|---|---|
QGraphicsSimpleTextItem::Type | 9 | Un élément graphique de texte simple |
Documentation des fonctions membres
[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(QGraphicsItem *parent = nullptr)
Crée un objet `QGraphicsSimpleTextItem`.
parent est transmis au constructeur de ` QGraphicsItem`.
Voir également QGraphicsScene::addItem().
[explicit] QGraphicsSimpleTextItem::QGraphicsSimpleTextItem(const QString &text, QGraphicsItem *parent = nullptr)
Crée un objet `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()
Supprime l'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 afficher 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 afficher le texte de l'élément sur font.
Voir aussi font().
void QGraphicsSimpleTextItem::setText(const QString &text)
Définit le texte de l'élément sur « text ». Le texte s'affichera en texte brut. Les caractères de nouvelle ligne («\n ») ainsi que les caractères de type QChar::LineSeparator entraîneront le fractionnement du 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.
