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.
Konstante | Wert | Beschreibung |
---|---|---|
QGraphicsRectItem::Type | 3 | Ein 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.