QGraphicsRectItem Class
La classe `QGraphicsRectItem` fournit un élément rectangulaire que vous pouvez ajouter à un ` QGraphicsScene`. En savoir plus...
| En-tête : | #include <QGraphicsRectItem> |
| 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
| QGraphicsRectItem(QGraphicsItem *parent = nullptr) | |
| QGraphicsRectItem(const QRectF &rect, QGraphicsItem *parent = nullptr) | |
| QGraphicsRectItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent = nullptr) | |
| virtual | ~QGraphicsRectItem() |
| QRectF | rect() const |
| void | setRect(const QRectF &rectangle) |
| void | setRect(qreal x, qreal y, qreal width, qreal height) |
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 = nullptr) override |
| virtual QPainterPath | shape() const override |
| virtual int | type() const override |
Description détaillée
Pour définir le rectangle de l’élément, transmettez un objet ` QRectF ` au constructeur de `QGraphicsRectItem`, ou appelez la fonction ` setRect()`. La fonction ` rect()` renvoie le rectangle actuel.
QGraphicsRectItem utilise le rectangle et la largeur du stylo pour fournir une implémentation raisonnable des fonctions boundingRect(), shape() et contains(). La fonction paint() dessine le rectangle à l’aide du stylo et du pinceau associés à l’élément, que vous pouvez définir en appelant les fonctions setPen() et setBrush().
Remarque : le rendu des rectangles non valides, tels que ceux dont la largeur ou la hauteur est négative, n’est pas défini. Si vous n’êtes pas certain d’utiliser des rectangles valides (par exemple, si vous créez des rectangles à partir de données provenant d’une source non fiable), vous devez utiliser la fonction QRectF::normalized() pour créer des rectangles normalisés, et les utiliser à la place.
Voir également QGraphicsPathItem, QGraphicsEllipseItem, QGraphicsPolygonItem, QGraphicsTextItem, QGraphicsLineItem, QGraphicsPixmapItem et Graphics View Framework.
Documentation sur les types de membres
[anonymous] enum
Valeur renvoyée par la fonction virtuelle ` type()`.
| Constante | Valeur | Description |
|---|---|---|
QGraphicsRectItem::Type | 3 | Un élément rect graphique |
Documentation des fonctions membres
[explicit] QGraphicsRectItem::QGraphicsRectItem(QGraphicsItem *parent = nullptr)
Crée un objet `QGraphicsRectItem`. L'objet ` parent ` est transmis au constructeur de ` QAbstractGraphicsShapeItem`.
Voir aussi QGraphicsScene::addItem().
[explicit] QGraphicsRectItem::QGraphicsRectItem(const QRectF &rect, QGraphicsItem *parent = nullptr)
Crée un objet `QGraphicsRectItem` en utilisant ` rect ` comme rectangle par défaut. ` parent ` est transmis au constructeur de ` QAbstractGraphicsShapeItem`.
Voir aussi QGraphicsScene::addItem().
[explicit] QGraphicsRectItem::QGraphicsRectItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent = nullptr)
Crée un objet `QGraphicsRectItem` avec un rectangle par défaut défini par (x, y) et les valeurs fournies pour ` width ` et ` height`.
parent est transmis au constructeur de QAbstractGraphicsShapeItem.
Voir également QGraphicsScene::addItem().
[virtual noexcept] QGraphicsRectItem::~QGraphicsRectItem()
Supprime l'QGraphicsRectItem.
[override virtual] QRectF QGraphicsRectItem::boundingRect() const
Réimplémente : QGraphicsItem::boundingRect() const.
[override virtual] bool QGraphicsRectItem::contains(const QPointF &point) const
Réimplémente : QGraphicsItem::contains(const QPointF &point) const.
[override virtual] bool QGraphicsRectItem::isObscuredBy(const QGraphicsItem *item) const
Réimplémente : QAbstractGraphicsShapeItem::isObscuredBy(const QGraphicsItem *item) const.
[override virtual] QPainterPath QGraphicsRectItem::opaqueArea() const
Réimplémente : QAbstractGraphicsShapeItem::opaqueArea() const.
[override virtual] void QGraphicsRectItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)
Réimplémente : QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).
QRectF QGraphicsRectItem::rect() const
Renvoie le rectangle de l'élément.
Voir aussi setRect().
void QGraphicsRectItem::setRect(const QRectF &rectangle)
Définit le rectangle de l'élément sur l'rectangle spécifiée.
Voir également rect().
void QGraphicsRectItem::setRect(qreal x, qreal y, qreal width, qreal height)
Définit le rectangle de l'élément sur celui défini par (x, y) et les valeurs fournies width et height.
Cette fonction pratique équivaut à l'appel de setRect(QRectF(x, y, width, height))
Voir aussi rect().
[override virtual] QPainterPath QGraphicsRectItem::shape() const
Réimplémente : QGraphicsItem::shape() const.
[override virtual] int QGraphicsRectItem::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.
