QGraphicsRectItem Class

Die Klasse QGraphicsRectItem stellt ein Rechteck-Element zur Verfügung, das Sie einem QGraphicsScene hinzufügen können. Mehr...

Kopfzeile: #include <QGraphicsRectItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Vererbt: QAbstractGraphicsShapeItem

Öffentliche Typen

enum anonymous { Type }

Öffentliche Funktionen

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)

Reimplementierte öffentliche Funktionen

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

Detaillierte Beschreibung

Um das Rechteck des Elements zu setzen, übergeben Sie ein QRectF an den Konstruktor von QGraphicsRectItem, oder rufen Sie die Funktion setRect() auf. Die Funktion rect() gibt das aktuelle Rechteck zurück.

QGraphicsRectItem verwendet das Rechteck und die Stiftbreite, um eine sinnvolle Implementierung von boundingRect(), shape() und contains() zu ermöglichen. Die Funktion paint() zeichnet das Rechteck unter Verwendung des dem Element zugeordneten Stifts und Pinsels, die Sie durch Aufruf der Funktionen setPen() und setBrush() einstellen können.

Hinweis: Die Darstellung ungültiger Rechtecke, z. B. solcher mit negativer Breite oder Höhe, ist undefiniert. Wenn Sie nicht sicher sein können, dass Sie gültige Rechtecke verwenden (z. B. wenn Sie Rechtecke mit Daten aus einer unzuverlässigen Quelle erstellen), sollten Sie QRectF::normalized() verwenden, um normalisierte Rechtecke zu erstellen, und diese stattdessen verwenden.

Siehe auch QGraphicsPathItem, QGraphicsEllipseItem, QGraphicsPolygonItem, QGraphicsTextItem, QGraphicsLineItem, QGraphicsPixmapItem, und Graphics View Framework.

Dokumentation der Mitgliedstypen

enum QGraphicsRectItem::anonymous

Der Wert, der von der virtuellen Funktion type() zurückgegeben wird.

KonstanteWertBeschreibung
QGraphicsRectItem::Type3Ein Grafik-Rect-Element

Dokumentation der Mitgliedsfunktionen

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

Setzt das Rechteck des Objekts auf das Rechteck, das durch (x, y) und die angegebenen width und height definiert ist.

Diese Komfortfunktion entspricht dem Aufruf von setRect(QRectF(x, y, width, height))

Siehe auch rect().

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

Konstruiert ein QGraphicsRectItem. parent wird an den Konstruktor von QAbstractGraphicsShapeItem übergeben.

Siehe auch QGraphicsScene::addItem().

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

Konstruiert ein QGraphicsRectItem, wobei rect als Standardrechteck verwendet wird. parent wird an den Konstruktor von QAbstractGraphicsShapeItem übergeben.

Siehe auch QGraphicsScene::addItem().

[explicit] QGraphicsRectItem::QGraphicsRectItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent = nullptr)

Konstruiert ein QGraphicsRectItem mit einem durch (x, y) definierten Standardrechteck und den angegebenen width und height.

parent wird an den Konstruktor von QAbstractGraphicsShapeItem übergeben.

Siehe auch QGraphicsScene::addItem().

[virtual noexcept] QGraphicsRectItem::~QGraphicsRectItem()

Zerstört die QGraphicsRectItem.

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

Reimplements: QGraphicsItem::boundingRect() const.

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

Reimplements: QGraphicsItem::contains(const QPointF &point) const.

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

Reimplements: QAbstractGraphicsShapeItem::isObscuredBy(const QGraphicsItem *item) const.

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

Reimplements: QAbstractGraphicsShapeItem::opaqueArea() const.

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

Reimplements: QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

QRectF QGraphicsRectItem::rect() const

Gibt das Rechteck des Objekts zurück.

Siehe auch setRect().

void QGraphicsRectItem::setRect(const QRectF &rectangle)

Setzt das Rechteck des Objekts auf den angegebenen Wert rectangle.

Siehe auch rect().

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

Reimplements: QGraphicsItem::shape() const.

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

Reimplements: QGraphicsItem::type() const.

© 2025 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.