Sur cette page

QGraphicsRectItem Class

La classe QGraphicsRectItem fournit un élément rectangle que vous pouvez ajouter à un site QGraphicsScene. Plus....

En-tête : #include <QGraphicsRectItem>
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

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, passez une adresse QRectF au constructeur de QGraphicsRectItem ou appelez la fonction setRect(). La fonction rect() renvoie le rectangle actuel.

Rectangle dessiné près de l'origine

QGraphicsRectItem utilise le rectangle et la largeur du stylo pour fournir une implémentation raisonnable de boundingRect(), shape() et contains(). La fonction paint() dessine le rectangle en utilisant le stylo et le 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 ne pouvez pas être sûr d'utiliser des rectangles valides (par exemple, si vous créez des rectangles en utilisant des données provenant d'une source non fiable), vous devez utiliser QRectF::normalized() pour créer des rectangles normalisés et les utiliser à la place.

Voir aussi QGraphicsPathItem, QGraphicsEllipseItem, QGraphicsPolygonItem, QGraphicsTextItem, QGraphicsLineItem, QGraphicsPixmapItem, et Graphics View Framework.

Documentation des types de membres

[anonymous] enum

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

ConstanteValeurDescription
QGraphicsRectItem::Type3Un élément graphique rect

Documentation des fonctions membres

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

Construit un QGraphicsRectItem. parent est transmis au constructeur de QAbstractGraphicsShapeItem.

Voir aussi QGraphicsScene::addItem().

[explicit] QGraphicsRectItem::QGraphicsRectItem(const QRectF &rect, QGraphicsItem *parent = nullptr)

Construit un 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)

Construit un QGraphicsRectItem avec un rectangle par défaut défini par (x, y) et les données width et height.

parent est passé au constructeur de QAbstractGraphicsShapeItem.

Voir aussi QGraphicsScene::addItem().

[virtual noexcept] QGraphicsRectItem::~QGraphicsRectItem()

Détruit le site 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 également setRect().

void QGraphicsRectItem::setRect(const QRectF &rectangle)

Fixe le rectangle de l'élément à la valeur donnée rectangle.

Voir aussi rect().

void QGraphicsRectItem::setRect(qreal x, qreal y, qreal width, qreal height)

Fixe le rectangle de l'élément au rectangle défini par (x, y) et les données width et height.

Cette fonction de commodité équivaut à appeler 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.