QGraphicsRectItem Class

The QGraphicsRectItem class provides a rectangle item that you can add to a QGraphicsScene. More...

Header: #include <QGraphicsRectItem>
qmake: QT += widgets
Since: Qt 4.2
Inherits: QAbstractGraphicsShapeItem

This class was introduced in Qt 4.2.

Public Types

enum anonymous { Type }

Detailed Description

To set the item's rectangle, pass a QRectF to QGraphicsRectItem's constructor, or call the setRect() function. The rect() function returns the current rectangle.

QGraphicsRectItem uses the rectangle and the pen width to provide a reasonable implementation of boundingRect(), shape(), and contains(). The paint() function draws the rectangle using the item's associated pen and brush, which you can set by calling the setPen() and setBrush() functions.

Note: The rendering of invalid rectangles, such as those with negative widths or heights, is undefined. If you cannot be sure that you are using valid rectangles (for example, if you are creating rectangles using data from an unreliable source) then you should use QRectF::normalized() to create normalized rectangles, and use those instead.

See also QGraphicsPathItem, QGraphicsEllipseItem, QGraphicsPolygonItem, QGraphicsTextItem, QGraphicsLineItem, QGraphicsPixmapItem, and Graphics View Framework.

Member Type Documentation

enum QGraphicsRectItem::anonymous

The value returned by the virtual type() function.

ConstantValueDescription
QGraphicsRectItem::Type3A graphics rect item